tomcat-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From amy...@apache.org
Subject cvs commit: jakarta-tomcat-catalina/webapps/docs mbeans-descriptor-howto.xml index.xml project.xml
Date Mon, 03 Feb 2003 23:17:09 GMT
amyroh      2003/02/03 15:17:08

  Modified:    webapps/docs index.xml project.xml
  Added:       webapps/docs mbeans-descriptor-howto.xml
  Log:
  Port change.
  
  Revision  Changes    Path
  1.6       +2 -1      jakarta-tomcat-catalina/webapps/docs/index.xml
  
  Index: index.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-tomcat-catalina/webapps/docs/index.xml,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- index.xml	15 Jan 2003 03:40:43 -0000	1.5
  +++ index.xml	3 Feb 2003 23:17:08 -0000	1.6
  @@ -81,6 +81,8 @@
   <li><a href="manager-howto.html"><strong>Manager App HOW-TO</strong></a>
-
       Operating the <code>Manager</code> web app to deploy, undeploy, and
       redeploy applications while Tomcat is running.</li>
  +<li><a href="mbeans-descriptor-howto.html"><strong>MBean Descriptor HOW-TO</strong></a>
-
  +    Configuring MBean descriptors files for custom components.</li>   
   <li><a href="proxy-howto.html"><strong>Proxy Support HOW-TO</strong></a>
-
       Configuring Tomcat 5 to run behind a proxy server (or a web server
       functioning as a proxy server).</li>
  @@ -180,4 +182,3 @@
   
   </body>
   </document>
  -
  
  
  
  1.8       +2 -0      jakarta-tomcat-catalina/webapps/docs/project.xml
  
  Index: project.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-tomcat-catalina/webapps/docs/project.xml,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -r1.7 -r1.8
  --- project.xml	15 Jan 2003 03:40:43 -0000	1.7
  +++ project.xml	3 Feb 2003 23:17:08 -0000	1.8
  @@ -36,6 +36,8 @@
           <item name="JNDI Resources HOW-TO" href="jndi-resources-howto.html"/>
           <item name="JSP Engine Config HOW-TO" href="jasper-howto.html"/>
           <item name="Manager App HOW-TO"    href="manager-howto.html"/>
  +        <item name="MBean Descriptor HOW-TO" 
  +              href="mbeans-descriptor-howto.html"/>        
           <item name="Proxy Support HOW-TO"  href="proxy-howto.html"/>
           <item name="Realm HOW-TO"          href="realm-howto.html"/>
           <item name="Security Mgr. HOW-TO"  href="security-manager-howto.html"/>
  
  
  
  1.1                  jakarta-tomcat-catalina/webapps/docs/mbeans-descriptor-howto.xml
  
  Index: mbeans-descriptor-howto.xml
  ===================================================================
  <?xml version="1.0"?>
  <!DOCTYPE document [
    <!ENTITY project SYSTEM "project.xml">
  ]>
  <document url="mbean-descriptor-howto.html">
  
      &project;
  
      <properties>
          <author email="amyroh@apache.org">Amy Roh</author>
          <title>MBean Descriptor How To</title>
      </properties>
  
  <body>
  
  <section name="Introduction">
  
  <p>Tomcat 4 uses JMX MBeans as the technology for implementing 
  manageability of Tomcat.</p>
  
  <p>The descriptions of JMX MBeans for Catalina are in the 
  org.apache.catalina.mbeans.mbeans-descriptor.xml file.</p>
  
  <p>You will need to add MBean descriptions for your custom components 
  in order to avoid a "ManagedBean is not found" exception.</p>
  
  </section>
  
  <section name="Including your own mbean-descriptor files">
  
  <p>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.</p>
  
  <source>
  &lt;Listener className="org.apache.catalina.mbeans.ServerLifecycleListener"
            debug="0"
            descriptors="/com/myfirm/mypackage/mbean-descriptor.xml"/&gt;
  </source>          
  
  
  </section>
  
  <section name="Adding MBean description to Catalina's mbean-descriptors.xml">
  
  <p>You may also add MBean descriptions for custom components in 
  org.apache.catalina.mbeans.mbeans-descriptor.xml file.</p>
  
  <source>
    &lt;mbean         name="LDAPRealm"
              className="org.apache.catalina.mbeans.ClassNameMBean"
            description="Custom LDAPRealm"
                 domain="Catalina"
                  group="Realm"
                   type="com.myfirm.mypackage.LDAPRealm"&gt;
  
      &lt;attribute   name="className"
            description="Fully qualified class name of the managed object"
                   type="java.lang.String"
              writeable="false"/&gt;
  
      &lt;attribute   name="debug"
            description="The debugging detail level for this component"
                   type="int"/&gt;
      .
      .
      .
  
    &lt;/mbean&gt;
  </source>
  
  
  </section>
  
  </body>
  
  </document>
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: tomcat-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: tomcat-dev-help@jakarta.apache.org


Mime
View raw message