Links Docs Home Getting Started Introduction READ ME Install and Run Building from Source Configuration Reference Administrators CGI HOW-TO Class Loader HOW-TO Connectors List HTML Manager App HOW-TO JK Documentation JNDI DataSource HOW-TO JNDI Resources HOW-TO JSP Engine Config HOW-TO Manager App HOW-TO MBean Descriptor HOW-TO Proxy Support HOW-TO Realm HOW-TO Security Mgr. HOW-TO SSI Config HOW-TO SSL Config HOW-TO Application Developers App Developer Guide Servlet/JSP Javadocs Catalina Developers Functional Specs. Javadocs Jasper Developers Javadocs |
# The Tomcat 4 Servlet/JSP Container ## MBean Descriptor How To | print-friendly version
Introduction
Tomcat 4 uses JMX MBeans as the technology for implementing manageability of Tomcat. The descriptions of JMX MBeans for Catalina are in the org.apache.catalina.mbeans.mbeans-descriptor.xml file. You will need to add MBean descriptions for your custom components in order to avoid a "ManagedBean is not found" exception.
Including your own mbean-descriptor files
> You may configure custom components (e.g. Valves/Realms) by including your own mbean-descriptor file(s), and setting the "descriptors" attribute to point to a ';' separated list of paths (in the ClassLoader sense) of files to add to the default list under ServerLifecycleListener definition in server.xml.
>     <Listener className="org.apache.catalina.mbeans.ServerLifecycleListener"
>               debug="0"
>               descriptors="/com/myfirm/mypackage/mbean-descriptor.xml"/>
Adding MBean description to Catalina's mbean-descriptors.xml
> You may also add MBean descriptions for custom components in org.apache.catalina.mbeans.mbeans-descriptor.xml file.
>       <mbean         name="LDAPRealm"
>                 className="org.apache.catalina.mbeans.ClassNameMBean"
>               description="Custom LDAPRealm"
>                    domain="Catalina"
>                     group="Realm"
>                      type="com.myfirm.mypackage.LDAPRealm">

>         <attribute   name="className"
>               description="Fully qualified class name of the managed object"
>                      type="java.lang.String"
>                 writeable="false"/>

>         <attribute   name="debug"
>               description="The debugging detail level for this component"
>                      type="int"/>
>         .
>         .
>         .

>       </mbean>
Copyright © 1999-2002, Apache Software Foundation