org.apache.catalina.ant.jmx

This package contains a set of JMX Task implementations for Ant (version 1.6 or later) that can be used to interact with the Remote JMX JSR 160 RMI Adaptor to get/set attributes, invoke MBean operations and query for Mbeans inside a running instance of Tomcat. For more information, see http://jakarta.apache.org/tomcat/tomcat-5.5-doc/monitoring.html.

Each task element can open a new jmx connection or reference an existing one. The following attribute are exists in every tasks:

NOTE - This Tasks only work, when JSR 160 MBean Adaptor as remote jvm is configured.

 
 <path id="catalina_ant">
 <fileset dir="${catalina.home}/server/lib">
 <include name="catalina-ant.jar"/>
 <include name="catalina-ant-jmx.jar"/>
 </fileset>
 </path>
 <typedef
 name="jmxCondition"
 classname="org.apache.catalina.ant.jmx.JMXAccessorCondition"
 classpathref="catalina_ant"/>
 <taskdef
 name="jmxOpen"
 classname="org.apache.catalina.ant.jmx.JMXAccessorTask"
 classpathref="catalina_ant"/>
 

 <target name="wait">
 <jmxOpen
 host="${jmx.host}" port="${jmx.port}" username="${jmx.username}" password="${jmx.password}" />
 <waitfor maxwait="${maxwait}" maxwaitunit="second" timeoutproperty="server.timeout" >
 <and>
 <socket server="${server.name}" port="${server.port}"/>
 <http url="${url}"/>
 <jmxCondition
 name="Catalina:type=IDataSender,host=localhost,senderAddress=192.168.111.1,senderPort=9025"
 operation="==" 
 attribute="connected" value="true"
 />
 <jmxCondition
 operation="&lt;"
 name="Catalina:j2eeType=WebModule,name=//${tomcat.application.host}${tomcat.application.path},J2EEApplication=none,J2EEServer=none"
 attribute="startupTime" value="250"
 />
 </and>
 </waitfor>
 <fail if="server.timeout" message="Server ${url} don't answer inside ${maxwait} sec" />
 <echo message="Server ${url} alive" />
 </target>
 

• == equals
• != not equals
• > greater than (>)
• >= greater than or equals (>=)
• < lesser than (&lt;)
• <= lesser than or equals (&lt;=)

 
 <path id="catalina_ant">
 <fileset dir="${catalina.home}/server/lib">
 <include name="catalina-ant.jar"/>
 <include name="catalina-ant-jmx.jar"/>
 </fileset>
 </path>
 <typedef
 name="jmxEquals"
 classname="org.apache.catalina.ant.jmx.JMXAccessorEqualsCondition"
 classpathref="catalina_ant"/>
 

 <target name="wait">
 <waitfor maxwait="${maxwait}" maxwaitunit="second" timeoutproperty="server.timeout" >
 <and>
 <socket server="${server.name}" port="${server.port}"/>
 <http url="${url}"/>
 <jmxEquals 
 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>
 

• open more then one JSR 160 rmi connection
• Get/Set Mbeans attributes
• Call Mbean Operation with arguments
• Argument values can be converted from string to int,long,float,double,boolean,ObjectName or InetAddress
• Query Mbeans
• Show Get, Call, Query result at Ant console log
• Bind Get, Call, Query result at Ant properties

 <jmxOpen
 host="127.0.0.1"
 port="9014"
 username="monitorRole"
 password="mysecret"
 ref="jmx.myserver" 
 />
 

First call to a remote MBeanserver save the JMXConnection a referenz jmx.server