You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@avalon.apache.org by ni...@apache.org on 2004/04/03 12:46:45 UTC

cvs commit: avalon/merlin/platform/xdocs/extensions/facilities jmx.xml navigation.xml jmx.txt

niclas      2004/04/03 02:46:45

  Modified:    merlin/platform/xdocs/extensions/facilities navigation.xml
  Added:       merlin/platform/xdocs/extensions/facilities jmx.xml
  Removed:     merlin/platform/xdocs/extensions/facilities jmx.txt
  Log:
  Beginning of the JMX documentation.
  
  Revision  Changes    Path
  1.4       +1 -0      avalon/merlin/platform/xdocs/extensions/facilities/navigation.xml
  
  Index: navigation.xml
  ===================================================================
  RCS file: /home/cvs/avalon/merlin/platform/xdocs/extensions/facilities/navigation.xml,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- navigation.xml	3 Apr 2004 08:52:17 -0000	1.3
  +++ navigation.xml	3 Apr 2004 10:46:45 -0000	1.4
  @@ -40,6 +40,7 @@
           <item name="Facilities" href="/extensions/facilities/index.html">
             <item name="Avalon Finder" href="/extensions/facilities/finder.html"/>
             <item name="Avalon HTTP" href="/extensions/facilities/http.html"/>
  +          <item name="Avalon JMX" href="/extensions/facilities/jmx.html"/>
           </item>
         </item>
         <item name="Tools" href="/tools/index.html"/>
  
  
  
  1.1                  avalon/merlin/platform/xdocs/extensions/facilities/jmx.xml
  
  Index: jmx.xml
  ===================================================================
  <?xml version="1.0"?>
  
  <!-- 
   Copyright 2004 Apache Software Foundation
   Licensed  under the  Apache License,  Version 2.0  (the "License");
   you may not use  this file  except in  compliance with the License.
   You may obtain a copy of the License at 
   
     http://www.apache.org/licenses/LICENSE-2.0
   
   Unless required by applicable law or agreed to in writing, software
   distributed  under the  License is distributed on an "AS IS" BASIS,
   WITHOUT  WARRANTIES OR CONDITIONS  OF ANY KIND, either  express  or
   implied.
   
   See the License for the specific language governing permissions and
   limitations under the License.
  -->
  
  <document>
  
    <properties>
      <title>JMX Extension</title>
      <author email="dev@avalon.apache.org">Avalon Development Team</author>
    </properties>
  
    <body>
      <section name="JMX Extension">
        <p>
          <strong>Status: Under Development</strong>
        </p>
        <p>
          <strong>Since: Merlin 3.3</strong>
        </p>
        <p>
          The Merlin JMX Extension is an MX4J adapter and contains everything 
          needed to expose components as MBeans, as well as the JMX Agent and
          a couple of connectors, such as the HttpConnector and Remote JMX
          connector (JSR-160).
        </p>
        <p>
          To enable JMX, you will need to declare the JMX Facility, as well as
          enable the components to be MBeans. See the example below on how to
          enable the JMX Facility. To enable the components to become MBeans,
          you have a few ways to do so;
        </p>
        <ul>
          <li>
            Create a management interface which the component implements and
            declare the <code>@avalon.mx interface="com.mydomain.MyMxInterface"</code>
            in the component.
          </li>
          <li>
            Create a MBeanInfo class.
          </li>
        </ul>
      </section>
      <section name="Example" >
        <subsection name="Enabling the JMX Agent" >
          <p>
            This is done by including the JMX Agent block, typically in your 
            top level block.xml.
          </p>
  <source><![CDATA[
  
  ]]>
  </source>
        </subsection>
        <subsection name="Making a component an MBean" >
        </subsection>
      </section>
    </body>
  
    <footer>
      <legal>
        Copyright (c) @year@ The Avalon Apache Project All rights reserved.
        $Revision: 1.1 $ $Date: 2004/04/03 10:46:45 $
      </legal>
    </footer>
  </document>
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: cvs-unsubscribe@avalon.apache.org
For additional commands, e-mail: cvs-help@avalon.apache.org