<?xml version="1.0"?> <!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to You 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. --> <!DOCTYPE document [ <!ENTITY project SYSTEM "project.xml"> ]> <document url="monitoring.html"> &project; <properties> <author email="pero@apache.org">Peter Rossbach</author> <author email="remm@apache.org">Remy Maucherat</author> <title>Monitoring and Managing Tomcat</title> </properties> <body> <section name="Table of Contents"> <toc/> </section> <section name="Introduction"> <p>Monitoring is a key aspect of system administration. Looking inside a running server, obtaining some statistics or reconfiguring some aspects of an application are all daily administration 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: <a href="http://docs.oracle.com/javase/1.5.0/docs/guide/management/agent.html"> http://docs.oracle.com/javase/1.5.0/docs/guide/management/agent.html</a>. </p> <p>The following is a quick configuration guide for Java 5:</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>If you require authorization, 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 authorization 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>Tip</b>: The password file should be read-only and only accessible by the operating system user Tomcat is running as. </li> </ol> <b>Note:</b>The JSR 160 JMX-Adaptor opens a second data channel on a random port. That is a problem when you have a local firewall installed.<br/> </p> </section> <section name="Manage Tomcat with JMX remote Ant Tasks"> <p>To simplify JMX usage with Ant 1.6.x, a set of tasks is provided that may be used with antlib.</p> <p><b>antlib</b>: Copy your catalina-ant.jar from $CATALINA_HOME/lib to $ANT_HOME/lib.</p> <p>The following example shows 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 Project with <em><import file="${CATALINA.HOME}/bin/catalina-tasks.xml" /></em> and reference the tasks with <em>jmxOpen</em>, <em>jmxSet</em>, <em>jmxGet</em>, <em>jmxQuery</em>, <em>jmxInvoke</em>, <em>jmxEquals</em> and <em>jmxCondition</em>.</p> </section> <!-- 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 reference. With this attribute you can configure more the one connection inside the same Ant project. </td> <td><code>jmx.server</code></td> </tr> <tr> <td>echo</td> <td>Echo the command usage (for access analysis or debugging) </td> <td><code>false</code></td> </tr> <tr> <td>if</td> <td>Only execute if a property of the given name <b>exists</b> in the current project. </td> <td></td> </tr> <tr> <td>unless</td> <td>Only execute if a property of the given name <b>not exists</b> in the current project. </td> <td></td> </tr> </table> </p> <p> Example to open a new JMX connection<br/> <source> <jmx:open host="${jmx.server.name}" port="${jmx.server.port}" /> </source> </p> <p> Example to open a JMX connection from URL, with authorization 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> <p> Example to open a JMX connection from URL, with authorization and store at other reference, but only when property <em>jmx.if</em> exists and <em>jmx.unless</em> not exists<br/> <source> <jmx:open url="service:jmx:rmi:///jndi/rmi://localhost:9024/jmxrmi" ref="jmx.server.9024" username="controlRole" password="tomcat" if="jmx.if" unless="jmx.unless" /> </source> </p> <p><b>Note</b>: All properties from <em>jmxOpen</em> task also exists at all other tasks and conditions. </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.length</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.length} give the number of returned sender list. ${senderObjectNames.[0..N]} found all sender object names </source> </p> <p> Example to get IDataSender attribute connected only when cluster is configured. <source> <jmx:query failonerror="false" name="Catalina:type=Cluster,host=${tomcat.application.host}" resultproperty="cluster" /> <jmx:get name="Catalina:type=IDataSender,host=${tomcat.application.host},senderAddress=${cluster.backup.address},senderPort=${cluster.backup.port}" attribute="connected" resultproperty="datasender.connected" if="cluster.0.name" /> </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="funcspecs/fs-admin-opers.html">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.length</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.length} 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.length} 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="createAccessLoggerValve" resultproperty="accessLoggerObjectName" > <arg value="Catalina:type=Host,host=localhost"/> </jmx:invoke> </source> Now you can find new MBean with name stored at <em>${accessLoggerObjectName}</em> property. </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.length</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> <!-- Create ######################################################################### --> <section name="JMXAccessorCreateTask: remote create 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>Full qualified JMX ObjectName -- <em>Catalina:type=MBeanFactory</em> </td> <td></td> </tr> <tr> <td>className</td> <td>Existing MBean full qualified class name (see Tomcat MBean description above) </td> <td></td> </tr> <tr> <td>classLoader</td> <td>ObjectName of server or web application classloader <br/> ( <em>Catalina:type=ServerClassLoader,name=[server,common,shared]</em> or<br/> <em>Catalina:type=WebappClassLoader,path=/myapps,host=localhost</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> </table> </p> <p> Example to create remote MBean<br/> <source> <jmx:create ref="${jmx.reference}" name="Catalina:type=MBeanFactory" className="org.apache.commons.modeler.BaseModelMBean" classLoader="Catalina:type=ServerClassLoader,name=server"> <Arg value="org.apache.catalina.mbeans.MBeanFactory" /> </jmx:create> </source> </p> <p> <b>Warning</b>: Many Tomcat MBeans can't be linked to their parent once<br/> created. The Valve, Cluster and Realm MBeans are not automatically<br/> connected with their parent. Use the <em>MBeanFacrory</em> create<br/> operation instead. </p> </section> <!-- Unregister ######################################################################### --> <section name="JMXAccessorUnregisterTask: remote unregister 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>Full qualified JMX ObjectName -- <em>Catalina:type=MBeanFactory</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> </table> </p> <p> Example to unregister remote MBean<br/> <source> <jmx:unregister name="Catalina:type=MBeanFactory" /> </source> </p> <p> <b>Warning</b>: A lot of Tomcat MBeans can't be unregister.<br/> The MBeans are not unlinked from their parent. Use <em>MBeanFacrory</em><br/> remove operation instead. </p> </section> <!-- condition ######################################################################### --> <section name="JMXAccessorCondition: express 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 reference. With this attribute you can configure more the one connection inside the same Ant project. </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> <tr> <td>if</td> <td>Only execute if a property of the given name <b>exists</b> in the current project. </td> <td></td> </tr> <tr> <td>unless</td> <td>Only execute if a property of the given name <b>not exists</b> in the current project. </td> <td></td> </tr> <tr> <td>value (requiered)</td> <td>Second arg for operation </td> <td></td> </tr> <tr> <td>type</td> <td>Value type to express operation (support <em>long</em> and <em>double</em>) </td> <td><code>long</code></td> </tr> <tr> <td>operation</td> <td> express one <ul> <li>== equals</li> <li>!= not equals</li> <li>> greater than (>)</li> <li>>= greater than or equals (>=)</li> <li>< lesser than (<)</li> <li><= lesser than or equals (<=)</li> </ul> </td> <td><code>==</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:condition operation="==" 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> <!-- 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 reference. With this attribute you can configure more the one connection inside the same Ant project. </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 accessible<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> </body> </document>