Add the following parameters to your Tomcat startup script: set CATALINA_OPTS="-Dcom.sun.management.jmxremote \ -Dcom.sun.management.jmxremote.port=%my.jmx.port% \ @@ -55,14 +55,14 @@

For simple tomcat ant task usage with ant 1.6.x we have integrate import and antlib support.

To simplify JMX usage with Ant 1.6.x, a set of tasks is provided that may + be used with antlib.

antlibCopy your catalina-ant.jar from $CATALINA_HOME/lib to $ANT_HOME/lib.

Following example show the JMX Accessor usage:

The following example shows the JMX Accessor usage:

 <project name="Catalina Ant JMX" 
@@ -145,7 +118,7 @@
             echo="false"
         />
         <!-- get current maxActiveSession from ClusterTest application
-             echo it to ant output and store at 
+             echo it to Ant output and store at 
              property <em>clustertest.maxActiveSessions.orginal</em>
         -->
        <jmx:get
@@ -163,7 +136,7 @@
             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].
+             access all session ids directly with Ant property sessions.[0..n].
         -->
         <jmx:invoke
             name="Catalina:type=Manager,path=/ClusterTest,host=localhost" 
@@ -184,7 +157,7 @@
           <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.
+             and bind all attributes from all found manager MBeans.
         -->
         <jmx:query
             name="Catalina:type=Manager,*" 
@@ -213,8 +186,8 @@

import: Import the JMX Accessor Projekt with - <import file="${CATALINA.HOME}/bin/jmxaccessor-tasks.xml" /> and +

import: Import the JMX Accessor Project with + <import file="${CATALINA.HOME}/bin/catalina-tasks.xml" /> and reference the tasks with jmxOpen, jmxSet, jmxGet, jmxQuery, jmxInvoke,jmxEquals and jmxCondition.

@@ -223,7 +196,7 @@ -

List of Attributes
@@ -236,14 +209,14 @@ - - @@ -257,22 +230,22 @@ - - - @@ -301,7 +274,7 @@
url Set jmx connection url - service:jmx:rmi:///jndi/rmi://localhost:8050/jmxrmi + Set JMX connection URL - service:jmx:rmi:///jndi/rmi://localhost:8050/jmxrmi

host Set the host, shortcut the very long url syntax. + Set the host, shortcut the very long URL syntax. localhost
username remote jmx connection user name. + remote JMX connection user name.

password remote jmx connection password. + remote JMX connection password.

ref Name of the internal connection referenz. With this attribute you can - configure more the one connection inside the same ant projekt. + Name of the internal connection reference. With this attribute you can + configure more the one connection inside the same Ant project. jmx.server

-Example to open a new jmx connection
+Example to open a new JMX connection
<jmx:open host="${jmx.server.name}" @@ -310,7 +283,7 @@

-Example to open a jmx connection from url, with authorisation and +Example to open a JMX connection from URL, with authorisation and store at other reference
<jmx:open @@ -323,7 +296,7 @@

-Example to open a jmx connection from url, with authorisation and +Example to open a JMX connection from URL, with authorisation and store at other reference, but only when property jmx.if exists and jmx.unless not exists
@@ -346,7 +319,7 @@ -

List of Attributes
@@ -366,7 +339,7 @@ - @@ -403,7 +376,7 @@ @@ -411,7 +384,7 @@
attribute Existing Mbean attribute (see Tomcat mbean description above) + Existing MBean attribute (see Tomcat MBean description above)
separatearrayresults When return value is an array, save result as property list - ($resultproperty.[0..N] and $resultproperty.lenght) + ($resultproperty.[0..N] and $resultproperty.length) true

-Example to get remote mbean attribute from default jmx connection
+Example to get remote MBean attribute from default JMX connection
<jmx:get name="Catalina:type=Manager,path=/servlets-examples,host=localhost" @@ -431,7 +404,7 @@ Access the senderObjectNames properties with: - ${senderObjectNames.lenght} give the number of returned sender list. + ${senderObjectNames.length} give the number of returned sender list. ${senderObjectNames.[0..N]} found all sender object names

@@ -457,7 +430,7 @@ -

List of Attributes
@@ -477,7 +450,7 @@ - @@ -513,7 +486,7 @@
attribute Existing Mbean attribute (see Tomcat mbean description above) + Existing MBean attribute (see Tomcat MBean description above)

-Example to set remote mbean attribute value
+Example to set remote MBean attribute value
<jmx:set name="Catalina:type=Manager,path=/servlets-examples,host=localhost" @@ -529,7 +502,7 @@ -

List of Attributes
@@ -549,8 +522,8 @@ - @@ -587,7 +560,7 @@ @@ -602,7 +575,7 @@ operation="stop"/> Now you can find the sessionid at ${sessions.[0..N} properties and access the count -with ${sessions.lenght} property. +with ${sessions.length} property.
Example to get all sessionids
@@ -615,10 +588,10 @@ /> Now you can find the sessionid at ${sessions.[0..N} properties and access the count -with ${sessions.lenght} property. +with ${sessions.length} property.
-Example to get remote mbean session attribute from session ${sessionid.0}
+Example to get remote MBean session attribute from session ${sessionid.0}
<jmx:invoke name="Catalina:type=Manager,path=/ClusterTest,host=localhost" @@ -640,8 +613,8 @@ <arg value="Catalina:type=Host,host=localhost"/> </jmx:invoke> -Now you can find new Mbean with name stored at ${acccesLoggerObjectName} -proeprty. +Now you can find new MBean with name stored at ${acccesLoggerObjectName} +property.
@@ -649,7 +622,7 @@ -
+

List of Attributes

operation Existing Mbean operation (see Tomcat - funcspecs/fs-admin-opers.html. + Existing MBean operation (see Tomcat + funcspecs/fs-admin-opers.html).
separatearrayresults When return value is an array, save result as property list - ($resultproperty.[0..N] and $resultproperty.lenght) + ($resultproperty.[0..N] and $resultproperty.length) true

@@ -683,7 +656,7 @@ - @@ -706,7 +679,7 @@ @@ -724,7 +697,7 @@ properties and access the result object counter with ${manager.length} property.
-Example to get the Manager from servlet-examples application an bind all mbean properties
+Example to get the Manager from servlet-examples application an bind all MBean properties
<jmx:query name="Catalina:type=Manager,path=/servlet-examples,host=localhost*" @@ -737,7 +710,7 @@
-Example to get all MBeans from a server and store inside an external xml property file
+Example to get all MBeans from a server and store inside an external XML property file
<project name="jmx.query" xmlns:jmx="antlib:org.apache.catalina.ant.jmx" @@ -780,7 +753,7 @@ -
+

List of Attributes

resultproperty Prefix project property name to all founded Mbeans (mbeans.[0..N].objectname) + Prefix project property name to all founded MBeans (mbeans.[0..N].objectname)
separatearrayresults When return value is an array, save result as property list - ($resultproperty.[0..N] and $resultproperty.lenght) + ($resultproperty.[0..N] and $resultproperty.length) true

@@ -800,7 +773,7 @@ - @@ -831,7 +804,7 @@
className Existing MBean full qualified classname (see Tomcat mbean description above) + Existing MBean full qualified class name (see Tomcat MBean description above)

-Example to create remote mbean
+Example to create remote MBean
<jmx:create ref="${jmx.reference}" @@ -843,9 +816,10 @@

- Warning: A lot of tomcat mbeans can't be really create and connect with
- the parent. The valve, cluster or realm Mbeans are not autconnect with there parent.
- Use MBeanFacrory create operation instead. + Warning: Many Tomcat MBeans can't be linked to their parent once
+ created. The Valve, Cluster and Realm MBeans are not automatically
+ connected with their parent. Use the MBeanFacrory create
+ operation instead.

@@ -853,7 +827,7 @@ -

List of Attributes
@@ -888,7 +862,7 @@

-Example to unregister remote mbean
+Example to unregister remote MBean
<jmx:unregister name="Catalina:type=MBeanFactory" @@ -896,8 +870,8 @@

- Warning: A lot of tomcat mbeans can't be really unregister.
- The Mbeans are not deregister from parent. Use MBeanFacrory
+ Warning: A lot of Tomcat MBeans can't be unregister.
+ The MBeans are not unlinked from their parent. Use MBeanFacrory
remove operation instead.

@@ -919,14 +893,14 @@ url - Set jmx connection url - service:jmx:rmi:///jndi/rmi://localhost:8050/jmxrmi + Set JMX connection URL - service:jmx:rmi:///jndi/rmi://localhost:8050/jmxrmi host - Set the host, shortcut the very long url syntax. + Set the host, shortcut the very long URL syntax. localhost @@ -940,14 +914,14 @@ username - remote jmx connection user name. + remote JMX connection user name. password - remote jmx connection password. + remote JMX connection password. @@ -955,7 +929,7 @@ ref Name of the internal connection reference. With this attribute you can - configure more the one connection inside the same ant projekt. + configure more the one connection inside the same Ant project. jmx.server @@ -1050,7 +1024,7 @@ -

List of Attributes
@@ -1063,14 +1037,14 @@ - - @@ -1084,22 +1058,22 @@ - - - @@ -1122,7 +1096,7 @@
url Set jmx connection url - service:jmx:rmi:///jndi/rmi://localhost:8050/jmxrmi + Set JMX connection URL - service:jmx:rmi:///jndi/rmi://localhost:8050/jmxrmi

host Set the host, shortcut the very long url syntax. + Set the host, shortcut the very long URL syntax. localhost
username remote jmx connection user name. + remote JMX connection user name.

password remote jmx connection password. + remote JMX connection password.

ref Name of the internal connection referenz. With this attribute you can - configure more the one connection inside the same ant projekt. + Name of the internal connection reference. With this attribute you can + configure more the one connection inside the same Ant project. jmx.server

-Wait for server connection and that cluster backup node is accessable
+Wait for server connection and that cluster backup node is accessible
<target name="wait"> <waitfor maxwait="${maxwait}" maxwaitunit="second" timeoutproperty="server.timeout" > --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org For additional commands, e-mail: dev-help@tomcat.apache.org

url	Set jmx connection url - service:jmx:rmi:///jndi/rmi://localhost:8050/jmxrmi +	Set JMX connection URL - service:jmx:rmi:///jndi/rmi://localhost:8050/jmxrmi
host	Set the host, shortcut the very long url syntax. +	Set the host, shortcut the very long URL syntax.	`localhost`
username	remote jmx connection user name. +	remote JMX connection user name.
password	remote jmx connection password. +	remote JMX connection password.
ref	Name of the internal connection referenz. With this attribute you can - configure more the one connection inside the same ant projekt. +	Name of the internal connection reference. With this attribute you can + configure more the one connection inside the same Ant project.	`jmx.server`

attribute	Existing Mbean attribute (see Tomcat mbean description above) +	Existing MBean attribute (see Tomcat MBean description above)
separatearrayresults	When return value is an array, save result as property list - ($resultproperty.[0..N] and $resultproperty.lenght) + ($resultproperty.[0..N] and $resultproperty.length)	`true`

operation	Existing Mbean operation (see Tomcat - funcspecs/fs-admin-opers.html. +	Existing MBean operation (see Tomcat + funcspecs/fs-admin-opers.html).
separatearrayresults	When return value is an array, save result as property list - ($resultproperty.[0..N] and $resultproperty.lenght) + ($resultproperty.[0..N] and $resultproperty.length)	`true`

resultproperty	Prefix project property name to all founded Mbeans (mbeans.[0..N].objectname) +	Prefix project property name to all founded MBeans (mbeans.[0..N].objectname)
separatearrayresults	When return value is an array, save result as property list - ($resultproperty.[0..N] and $resultproperty.lenght) + ($resultproperty.[0..N] and $resultproperty.length)	`true`