pero 2005/06/24 04:55:02
Modified: webapps/docs changelog.xml developers.xml monitoring.xml
Log:
Add new jmx remote ant support - documentation
Revision Changes Path
1.316 +10 -1 jakarta-tomcat-catalina/webapps/docs/changelog.xml
Index: changelog.xml
===================================================================
RCS file: /home/cvs/jakarta-tomcat-catalina/webapps/docs/changelog.xml,v
retrieving revision 1.315
retrieving revision 1.316
diff -u -r1.315 -r1.316
--- changelog.xml 9 Jun 2005 20:38:30 -0000 1.315
+++ changelog.xml 24 Jun 2005 11:55:02 -0000 1.316
@@ -29,6 +29,15 @@
<section name="Tomcat 5.5.10 (yoavs)">
<subsection name="General">
<changelog>
+ <add>
+ Add JMX remote ant task to control tomcat MBeanserver via ant
scripts.
+ Ant lib is included at "server/lib/catalina-ant-jmx.jar" and
documentation
+ is added to <a href="monitoring.html">Monitoring and Managing
Tomcat How-To</a> (pero)
+ </add>
+ <fix>
+ <bug>34361</bug>: Integrate better antlib and import support for
+ catalina manager tasks [Modified patch from Daniel Santos] (pero)
+ </fix>
<fix>
StoreConfig save now the Connector.sslProtocol attribute. (pero)
</fix>
@@ -58,7 +67,7 @@
ClusterListener
more than one Cluster Valves
- better subclass support
- - change a lot of existing API's (pero)
+ - change a lot of existing Cluster API's (pero)
</update>
<add>
Add Apache Portable Runtime JNI wrapper and helper API (mturk)
1.8 +1 -1 jakarta-tomcat-catalina/webapps/docs/developers.xml
Index: developers.xml
===================================================================
RCS file: /home/cvs/jakarta-tomcat-catalina/webapps/docs/developers.xml,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- developers.xml 22 Nov 2004 15:50:57 -0000 1.7
+++ developers.xml 24 Jun 2005 11:55:02 -0000 1.8
@@ -40,7 +40,7 @@
<li>Jean-Frederic Clere (jfclere): Connectors</li>
<li>Kin-Man Chung (kinman): Jasper</li>
<li>Mladen Turk (mturk): Connectors</li>
- <li>Peter Rossbach (pero): Catalina, Clustering</li>
+ <li>Peter Rossbach (pero): Catalina, Clustering, JMX</li>
<li>Remy Maucherat (remm): Catalina, Connectors, Docs</li>
<li>Tim Funk (funkman): Catalina, Docs</li>
<li>Yoav Shapira (yoavs): Docs, JMX, Catalina, balancer, Release
Manager</li>
1.2 +779 -10 jakarta-tomcat-catalina/webapps/docs/monitoring.xml
Index: monitoring.xml
===================================================================
RCS file: /home/cvs/jakarta-tomcat-catalina/webapps/docs/monitoring.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- monitoring.xml 7 Oct 2004 18:16:05 -0000 1.1
+++ monitoring.xml 24 Jun 2005 11:55:02 -0000 1.2
@@ -7,6 +7,7 @@
&project;
<properties>
+ <author email="[EMAIL PROTECTED]">Peter Rossbach</author>
<author email="[EMAIL PROTECTED]">Remy Maucherat</author>
<title>Monitoring and Managing Tomcat</title>
</properties>
@@ -15,30 +16,798 @@
<section name="Introduction">
-
-
+ <p>Monitoring is a very important question today. Looking inside the
running
+ server, grab some statistic data or reconfigure some aspects are
+ daliy adminstration tasks.</p>
+
</section>
<section name="Enabling JMX Remote">
- <p>The Sun website includes the list of options and how to configure
JMX Remote on Java 5:
+ <p>The Sun website includes the list of options and how to configure JMX
Remote on Java 5:
<a
href="http://java.sun.com/j2se/1.5.0/docs/guide/management/agent.html";>
http://java.sun.com/j2se/1.5.0/docs/guide/management/agent.html</a>.
- </p>
+ </p>
+ <p>For quick installation you find here a short installation guide:</p>
+ <p>Add the following parameters to your tomcat startup script:
+ <source>
+ set CATALINA_OPTS="-Dcom.sun.management.jmxremote \
+ -Dcom.sun.management.jmxremote.port=%my.jmx.port% \
+ -Dcom.sun.management.jmxremote.ssl=false \
+ -Dcom.sun.management.jmxremote.authenticate=false"
+ </source>
+ </p>
+ <p>
+ <ol>
+ <li>When you think authorisation is a good, add and change this :
+ <source>
+ -Dcom.sun.management.jmxremote.authenticate=true
+ -Dcom.sun.management.jmxremote.password.file=..\conf\jmxremote.password
+ -Dcom.sun.management.jmxremote.access.file=..\conf\jmxremote.access
+ </source>
+ </li>
+ <li>edit the access allow file
<em>$CATALINA_BASE/conf/jmxremote.access</em> :
+ <source>
+monitorRole readonly
+controlRole readwrite
+ </source>
+ </li>
+ <li>edit the password file
<em>$CATALINA_BASE/conf/jmxremote.password</em> :
+ <source>
+monitorRole tomcat
+controlRole tomcat
+ </source>
+ <b>Tipp</b>: Password File must be readonly and not accessable from
every
+ other user! Remove all other users under windows to access this file.
+ </li>
+ </ol>
+ </p>
+ <p>Activate JMX MX4J Http Adaptor with Java 1.4:
+ <ol>
+ <li>Install the tomcat compat package</li>
+ <li>Install the mx4j-tools.jar at common/lib. Please, use the same
MX4j
+ version as your tomcat release</li>
+ <li>Configure a MX4J JMX HTTP Adaptor at your AJP Connector
+ <p>
+ <source>
+ <Connector port="${AJP.PORT}"
+ handler.list="mx"
+ mx.enabled="true"
+ mx.httpHost="${JMX.HOST}"
+ mx.httpPort="${JMX.PORT}"
+ protocol="AJP/1.3" />
+ </source>
+ </p>
+ <p><b>Tipp</b>: With <em>${AJP.PORT}=0</em> no ajp connection where
started.
+ </p>
+ </li>
+ <li>Start your tomcat and look with a browser at
http://${JMX.HOST}:${JMX.PORT}</li>
+ <li>With the mx connector parameter <code>mx.authMode="basic"
mx.authUser="tomcat" mx.authPassword="strange"</code>
+ you can control the access!</li>
+ <li>A complete list of all tomcat core MBeans can you find at <a
href="http://jakarta.apache.org/tomcat/tomcat-5.5-doc/catalina/funcspecs/mbean-names.html";>
+
http://jakarta.apache.org/tomcat/tomcat-5.5-doc/catalina/funcspecs/mbean-names.html</a>.</li>
+ </ol>
+ </p>
</section>
- <section name="Monitoring">
-
-
+ <section name="Manage Tomcat with JMX remote Ant Tasks">
+ <p>For simple tomcat ant task usage with ant 1.6.x we have integrate
import and antlib support.</p>
+ <p><b>antlib</b>Copy your catalina-ant.jar from $CATALINA_HOME/server/lib
to $ANT_HOME/lib.</p>
+ <p>Following example show the JMX Accessor usage:</p>
+ <table border="1">
+ <tr><td><p><pre>
+<project name="Catalina Ant JMX"
+ xmlns:jmx="antlib:org.apache.catalina.ant.jmx"
+ default="state"
+ basedir=".">
+ <property name="jmx.server.name" value="localhost" />
+ <property name="jmx.server.port" value="9012" />
+ <property name="cluster.server.address" value="192.168.1.75" />
+ <property name="cluster.server.port" value="9025" />
+
+ <target name="state" description="Show JMX Cluster state">
+ <jmx:open
+ host="${jmx.server.name}"
+ port="${jmx.server.port}"
+ username="controlRole"
+ password="tomcat"/>
+ <jmx:get
+
name="Catalina:type=IDataSender,host=localhost,senderAddress=${cluster.server.address},senderPort=${cluster.server.port}"
+ attribute="connected"
+ resultproperty="IDataSender.backup.connected"
+ echo="false"
+ />
+ <jmx:get
+ name="Catalina:type=ClusterSender,host=localhost"
+ attribute="senderObjectNames"
+ resultproperty="senderObjectNames"
+ echo="false"
+ />
+ <!-- get current maxActiveSession from ClusterTest application
+ echo it to ant output and store at
+ property
<em>clustertest.maxActiveSessions.orginal</em>
+ -->
+ <jmx:get
+ name="Catalina:type=Manager,path=/ClusterTest,host=localhost"
+ attribute="maxActiveSessions"
+ resultproperty="clustertest.maxActiveSessions.orginal"
+ echo="true"
+ />
+ <!-- set maxActiveSession to 100
+ -->
+ <jmx:set
+ name="Catalina:type=Manager,path=/ClusterTest,host=localhost"
+ attribute="maxActiveSessions"
+ value="100"
+ type="int"
+ />
+ <!-- get all sessions and split result as delimiter
<em>SPACE</em> for easy
+ access all session ids directly with ant property
sessions.[0..n].
+ -->
+ <jmx:invoke
+ name="Catalina:type=Manager,path=/ClusterTest,host=localhost"
+ operation="listSessionIds"
+ resultproperty="sessions"
+ echo="false"
+ delimiter=" "
+ />
+ <!-- Access session attribute <em>Hello</em> from
first session.
+ -->
+ <jmx:invoke
+ name="Catalina:type=Manager,path=/ClusterTest,host=localhost"
+ operation="getSessionAttribute"
+ resultproperty="Hello"
+ echo="false"
+ >
+ <arg value="${sessions.0}"/>
+ <arg value="Hello"/>
+ </jmx:invoke>
+ <!-- Query for all application manager.of the server from all
hosts
+ and bind all attributes from all found manager mbeans.
+ -->
+ <jmx:query
+ name="Catalina:type=Manager,*"
+ resultproperty="manager"
+ echo="true"
+ attributebinding="true"
+ />
+ <!-- echo the create properties -->
+ <echo>
+ senderObjectNames: ${senderObjectNames.0}
+ IDataSender.backup.connected: ${IDataSender.backup.connected}
+ session: ${sessions.0}
+ manager.length: ${manager.length}
+ manager.0.name: ${manager.0.name}
+ manager.1.name: ${manager.1.name}
+ hello: ${Hello}
+ manager.ClusterTest.0.name: ${manager.ClusterTest.0.name}
+ manager.ClusterTest.0.activeSessions:
${manager.ClusterTest.0.activeSessions}
+ manager.ClusterTest.0.counterSend_EVT_SESSION_EXPIRED:
${manager.ClusterTest.0.counterSend_EVT_SESSION_EXPIRED}
+ manager.ClusterTest.0.counterSend_EVT_GET_ALL_SESSIONS:
${manager.ClusterTest.0.counterSend_EVT_GET_ALL_SESSIONS}
+ </echo>
+
+ </target>
+
+</project>
+ </pre></p>
+ </td></tr>
+</table>
+ <p><b>import:</b> Import the JMX Accessor Projekt with
+ <em><import file="${CATALINA.HOME}/bin/jxmaccessor.xml" /></em> and
+ reference the tasks with <em>jmxOpen</em>, <em>jmxSet</em>,
<em>jmxGet</em>,
+ <em>jmxQuery</em>, <em>jmxInvoke</em> and <em>jmxEquals</em>. </p>
</section>
- <section name="Management">
-
+<!-- Open
#########################################################################
+-->
+<section name="JMXAccessorOpenTask - jmx open connection task">
+<p>
+List of Attributes<br/>
+<table border="1" cellpadding="5">
+
+ <tr>
+ <th align="center" bgcolor="aqua">Attribute</th>
+ <th align="center" bgcolor="aqua">Description</th>
+ <th align="center" bgcolor="aqua">Default value</th>
+ </tr>
+
+ <tr>
+ <td>url</td>
+ <td>Set jmx connection url -
<em>service:jmx:rmi:///jndi/rmi://localhost:8050/jmxrmi</em>
+ </td>
+ <td></td>
+ </tr>
+
+ <tr>
+ <td>host</td>
+ <td>Set the host, shortcut the very long url syntax.
+ </td>
+ <td><code>localhost</code></td>
+ </tr>
+
+ <tr>
+ <td>port</td>
+ <td>Set the remote connection port
+ </td>
+ <td><code>8050</code></td>
+ </tr>
+
+ <tr>
+ <td>username</td>
+ <td>remote jmx connection user name.
+ </td>
+ <td></td>
+ </tr>
+
+ <tr>
+ <td>password</td>
+ <td>remote jmx connection password.
+ </td>
+ <td></td>
+ </tr>
+
+ <tr>
+ <td>ref</td>
+ <td>Name of the internal connection referenz. With this attribute you can
+ configure more the one connection inside the same ant projekt.
+ </td>
+ <td><code>jmx.server</code></td>
+ </tr>
+
+ <tr>
+ <td>echo</td>
+ <td>Echo the command usage (for analyse access or debugging)
+ </td>
+ <td><code>false</code></td>
+ </tr>
+
+</table>
+</p>
+<p>
+Example of open a new jmx connection<br/>
+<source>
+ <jmx:open
+ host="${jmx.server.name}"
+ port="${jmx.server.port}"
+ />
+</source>
+</p>
+<p>
+Example of open a jmx connection from url, with authorisation and
+store at other reference <br/>
+<source>
+ <jmx:open
+ url="service:jmx:rmi:///jndi/rmi://localhost:9024/jmxrmi";
+ ref="jmx.server.9024"
+ username="controlRole"
+ password="tomcat"
+ />
+</source>
+</p>
+</section>
+
+<!-- Get
#########################################################################
+-->
+
+<section name="JMXAccessorGetTask: get attribute value ant task">
+<p>
+List of Attributes<br/>
+<table border="1" cellpadding="5">
+
+ <tr>
+ <th align="center" bgcolor="aqua">Attribute</th>
+ <th align="center" bgcolor="aqua">Description</th>
+ <th align="center" bgcolor="aqua">Default value</th>
+ </tr>
+
+ <tr>
+ <td>name</td>
+ <td>Full qualified JMX ObjectName -- <em>Catalina:type=Server</em>
+ </td>
+ <td></td>
+ </tr>
+
+ <tr>
+ <td>attribute</td>
+ <td>Existing Mbean attribute (see Tomcat mbean description above)
+ </td>
+ <td></td>
+ </tr>
+
+ <tr>
+ <td>ref</td>
+ <td>JMX Connection reference
+ </td>
+ <td><code>jmx.server</code></td>
+ </tr>
+
+ <tr>
+ <td>echo</td>
+ <td>Echo command usage (access and result)
+ </td>
+ <td><code>false</code></td>
+ </tr>
+
+ <tr>
+ <td>resultproperty</td>
+ <td>Save result at this project property
+ </td>
+ <td></td>
+ </tr>
+
+ <tr>
+ <td>delimiter</td>
+ <td>Split result with delimiter (java.util.StringTokenizier)
+ and use resultproperty as prefix to store tokens.
+ </td>
+ <td></td>
+ </tr>
+
+ <tr>
+ <td>separatearrayresults</td>
+ <td>When return value is an array, save result as property list
+ (<em>$resultproperty.[0..N]</em> and <em>$resultproperty.lenght</em>)
+ </td>
+ <td><code>true</code></td>
+ </tr>
+
+</table>
+</p>
+<p>
+Example to get remote mbean attribute from default jmx connection <br/>
+<source>
+ <jmx:get
+ name="Catalina:type=Manager,path=/servlets-examples,host=localhost"
+ attribute="maxActiveSessions"
+ resultproperty="servlets-examples.maxActiveSessions"
+ />
+</source>
+</p>
+<p>
+Example to get and result array and split it at separate properties<br/>
+<source>
+ <jmx:get
+ name="Catalina:type=ClusterSender,host=localhost"
+ attribute="senderObjectNames"
+ resultproperty="senderObjectNames"
+ />
+</source>
+Access the senderObjectNames properties with:
+<source>
+ ${senderObjectNames.lenght} give the number of returned sender list.
+ ${senderObjectNames.[0..N]} found all sender object names
+</source>
+</p>
+
+</section>
+
+<!-- Set
#########################################################################
+-->
+
+<section name="JMXAccessorSetTask: set attribute value ant task">
+<p>
+List of Attributes<br/>
+<table border="1" cellpadding="5">
+
+ <tr>
+ <th align="center" bgcolor="aqua">Attribute</th>
+ <th align="center" bgcolor="aqua">Description</th>
+ <th align="center" bgcolor="aqua">Default value</th>
+ </tr>
+
+ <tr>
+ <td>name</td>
+ <td>Full qualified JMX ObjectName -- <em>Catalina:type=Server</em>
+ </td>
+ <td></td>
+ </tr>
+
+ <tr>
+ <td>attribute</td>
+ <td>Existing Mbean attribute (see Tomcat mbean description above)
+ </td>
+ <td></td>
+ </tr>
+
+ <tr>
+ <td>value</td>
+ <td>value that set to attribute
+ </td>
+ <td></td>
+ </tr>
+
+ <tr>
+ <td>type</td>
+ <td>type of the attribute.
+ </td>
+ <td>java.lang.String</td>
+ </tr>
+
+ <tr>
+ <td>ref</td>
+ <td>JMX Connection reference
+ </td>
+ <td><code>jmx.server</code></td>
+ </tr>
+
+ <tr>
+ <td>echo</td>
+ <td>Echo command usage (access and result)
+ </td>
+ <td><code>false</code></td>
+ </tr>
+
+</table>
+</p>
+<p>
+Example to set remote mbean attribute value<br/>
+<source>
+ <jmx:set
+ name="Catalina:type=Manager,path=/servlets-examples,host=localhost"
+ attribute="maxActiveSessions"
+ value="500"
+ type="int"
+ />
+</source>
+</p>
+
+</section>
+
+<!-- Invoke
#########################################################################
+-->
+
+<section name="JMXAccessorInvokeTask: invoke Mbean operation ant task">
+<p>
+List of Attributes<br/>
+<table border="1" cellpadding="5">
+
+ <tr>
+ <th align="center" bgcolor="aqua">Attribute</th>
+ <th align="center" bgcolor="aqua">Description</th>
+ <th align="center" bgcolor="aqua">Default value</th>
+ </tr>
+
+ <tr>
+ <td>name</td>
+ <td>Full qualified JMX ObjectName -- <em>Catalina:type=Server</em>
+ </td>
+ <td></td>
+ </tr>
+
+ <tr>
+ <td>operation</td>
+ <td>Existing Mbean operation (see Tomcat
+ <a
href="http://jakarta.apache.org/tomcat/tomcat-5.5-doc/catalina/funcspecs/fs-admin-opers.html";>
+
http://jakarta.apache.org/tomcat/tomcat-5.5-doc/catalina/funcspecs/fs-admin-opers.html</a>.
+ </td>
+ <td></td>
+ </tr>
+
+ <tr>
+ <td>ref</td>
+ <td>JMX Connection reference
+ </td>
+ <td><code>jmx.server</code></td>
+ </tr>
+
+ <tr>
+ <td>echo</td>
+ <td>Echo command usage (access and result)
+ </td>
+ <td><code>false</code></td>
+ </tr>
+
+ <tr>
+ <td>resultproperty</td>
+ <td>Save result at this project property
+ </td>
+ <td></td>
+ </tr>
+
+ <tr>
+ <td>delimiter</td>
+ <td>Split result with delimiter (java.util.StringTokenizier)
+ and use resultproperty as prefix to store tokens.
+ </td>
+ <td></td>
+ </tr>
+
+ <tr>
+ <td>separatearrayresults</td>
+ <td>When return value is an array, save result as property list
+ (<em>$resultproperty.[0..N]</em> and <em>$resultproperty.lenght</em>)
+ </td>
+ <td><code>true</code></td>
+ </tr>
+
+</table>
+</p>
+<p>
+stop an application <br/>
+<source>
+ <jmx:invoke
+ name="Catalina:type=Manager,path=/servlets-examples,host=localhost"
+ operation="stop"/>
+</source>
+Now you can find the sessionid at <em>${sessions.[0..N}</em> properties and
access the count
+with ${sessions.lenght} property.
+</p>
+<p>
+Example to get all sessionids <br/>
+<source>
+ <jmx:invoke
+ name="Catalina:type=Manager,path=/servlets-examples,host=localhost"
+ operation="listSessionIds"
+ resultproperty="sessions"
+ delimiter=" "
+ />
+</source>
+Now you can find the sessionid at <em>${sessions.[0..N}</em> properties and
access the count
+with ${sessions.lenght} property.
+</p>
+<p>
+Example to get remote mbean session attribute from session
${sessionid.0}<br/>
+<source>
+ <jmx:invoke
+ name="Catalina:type=Manager,path=/ClusterTest,host=localhost"
+ operation="getSessionAttribute"
+ resultproperty="hello">
+ <arg value="${sessionid.0}"/>
+ <arg value="Hello"/>
+ </jmx:invoke>
+</source>
+</p>
+<p>
+Example to create a new access logger valve at vhost <em>localhost</em>
+<source>
+ <jmx:invoke
+ name="Catalina:type=MBeanFactory"
+ operation="createAcccesLoggerValve"
+ resultproperty="acccesLoggerObjectName"
+ >
+ <arg value="Catalina:type=Host,host=localhost"/>
+ </jmx:invoke>
+</source>
+Now you can find new Mbean with name stored at
<em>${acccesLoggerObjectName}</em>
+proeprty.
+</p>
+
+</section>
+
+<!-- Query
#########################################################################
+-->
+
+<section name="JMXAccessorQueryTask: query Mbean ant task">
+<p>
+List of Attributes<br/>
+<table border="1" cellpadding="5">
+
+ <tr>
+ <th align="center" bgcolor="aqua">Attribute</th>
+ <th align="center" bgcolor="aqua">Description</th>
+ <th align="center" bgcolor="aqua">Default value</th>
+ </tr>
+
+ <tr>
+ <td>name</td>
+ <td>JMX ObjectName query string -- <em>Catalina:type=Manager,*</em>
+ </td>
+ <td></td>
+ </tr>
+
+ <tr>
+ <td>ref</td>
+ <td>JMX Connection reference
+ </td>
+ <td><code>jmx.server</code></td>
+ </tr>
+
+ <tr>
+ <td>echo</td>
+ <td>Echo command usage (access and result)
+ </td>
+ <td><code>false</code></td>
+ </tr>
+
+ <tr>
+ <td>resultproperty</td>
+ <td>Prefix project property name to all founded Mbeans
(<em>mbeans.[0..N].objectname</em>)
+ </td>
+ <td></td>
+ </tr>
+
+ <tr>
+ <td>attributebinduing</td>
+ <td>bind ALL MBean attributes in addition to <em>name</em>
+ </td>
+ <td><code>false</code></td>
+ </tr>
+
+ <tr>
+ <td>delimiter</td>
+ <td>Split result with delimiter (java.util.StringTokenizier)
+ and use resultproperty as prefix to store tokens.
+ </td>
+ <td></td>
+ </tr>
+
+ <tr>
+ <td>separatearrayresults</td>
+ <td>When return value is an array, save result as property list
+ (<em>$resultproperty.[0..N]</em> and <em>$resultproperty.lenght</em>)
+ </td>
+ <td><code>true</code></td>
+ </tr>
+
+</table>
+</p>
+<p>
+Get all Manager ObjectNames from all services and Hosts <br/>
+<source>
+ <jmx:query
+ name="Catalina:type=Manager,*
+ resultproperty="manager" />
+</source>
+Now you can find the Session Manager at <em>${manager.[0..N].name}</em>
+properties and access the result object counter with ${manager.length}
property.
+</p>
+<p>
+Example to get the Manager from <em>servlet-examples</em> application an
bind all mbean properties<br/>
+<source>
+ <jmx:query
+
name="Catalina:type=Manager,path=/servlet-examples,host=localhost*"
+ attributebinding="true"
+ resultproperty="manager.servletExamples" />
+</source>
+Now you can find the manager at <em>${manager.servletExamples.0.name}</em>
property
+and can access all properties from this manager with
<em>${manager.servletExamples.0.[manager attribute names]</em>}.
+The result object counter from MBeans is stored ad ${manager.length}
property.
+</p>
+
+<p>
+Example to get all MBeans from a server and store inside an external xml
property file<br/>
+<source>
+<project name="jmx.query"
+ xmlns:jmx="antlib:org.apache.catalina.ant.jmx"
+ default="query-all" basedir=".">
+<property name="jmx.host" value="localhost"/>
+<property name="jmx.port" value="8050"/>
+<property name="jmx.username" value="controlRole"/>
+<property name="jmx.password" value="tomcat"/>
+
+<target name="query-all" description="Query all MBeans of a server">
+<!-- Configure connection -->
+<jmx:open
+ host="${jmx.host}"
+ port="${jmx.port}"
+ ref="jmx.server"
+ username="${jmx.username}"
+ password="${jmx.password}"/>
+<!-- Query MBean list -->
+<jmx:query
+ name="*:*"
+ resultproperty="mbeans"
+ attributebinding="false"/>
+
+<echoproperties
+ destfile="mbeans.properties"
+ prefix="mbeans."
+ format="xml"/>
+
+<!-- Print results -->
+<echo
+ message="Number of MBeans in server ${jmx.host}:${jmx.port} is
${mbeans.length}"/>
+</target>
+</project>
+</source>
+Now you can find all MBeans inside the file <em>mbeans.properties</em>.
+</p>
+
+</section>
+
+<!-- Equals
#########################################################################
+-->
+
+<section name="JMXAccessorEqualsCondition: equals Mbean ant condition">
+<p>
+List of Attributes<br/>
+<table border="1" cellpadding="5">
+
+ <tr>
+ <th align="center" bgcolor="aqua">Attribute</th>
+ <th align="center" bgcolor="aqua">Description</th>
+ <th align="center" bgcolor="aqua">Default value</th>
+ </tr>
+
+ <tr>
+ <td>url</td>
+ <td>Set jmx connection url -
<em>service:jmx:rmi:///jndi/rmi://localhost:8050/jmxrmi</em>
+ </td>
+ <td></td>
+ </tr>
+
+ <tr>
+ <td>host</td>
+ <td>Set the host, shortcut the very long url syntax.
+ </td>
+ <td><code>localhost</code></td>
+ </tr>
+
+ <tr>
+ <td>port</td>
+ <td>Set the remote connection port
+ </td>
+ <td><code>8050</code></td>
+ </tr>
+
+ <tr>
+ <td>username</td>
+ <td>remote jmx connection user name.
+ </td>
+ <td></td>
+ </tr>
+
+ <tr>
+ <td>password</td>
+ <td>remote jmx connection password.
+ </td>
+ <td></td>
+ </tr>
+
+ <tr>
+ <td>ref</td>
+ <td>Name of the internal connection referenz. With this attribute you can
+ configure more the one connection inside the same ant projekt.
+ </td>
+ <td><code>jmx.server</code></td>
+ </tr>
+
+ <tr>
+ <td>name</td>
+ <td>Full qualified JMX ObjectName -- <em>Catalina:type=Server</em>
+ </td>
+ <td></td>
+ </tr>
+
+
+ <tr>
+ <td>echo</td>
+ <td>Echo condition usage (access and result)
+ </td>
+ <td><code>false</code></td>
+ </tr>
+
+</table>
+</p>
+<p>
+Wait for server connection and that cluster backup node is accessable<br/>
+<source>
+ <target name="wait">
+ <waitfor maxwait="${maxwait}" maxwaitunit="second"
timeoutproperty="server.timeout" >
+ <and>
+ <socket server="${server.name}" port="${server.port}"/>
+ <http url="${url}"/>
+ <jmx:equals
+ host="localhost"
+ port="9014"
+ username="controlRole"
+ password="tomcat"
+
name="Catalina:type=IDataSender,host=localhost,senderAddress=192.168.111.1,senderPort=9025"
+ attribute="connected"
+ value="true"
+ />
+ </and>
+ </waitfor>
+ <fail if="server.timeout" message="Server ${url} don't answer
inside ${maxwait} sec" />
+ <echo message="Server ${url} alive" />
+ </target>
+</source>
+</p>
- </section>
+</section>
</body>
</document>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
