| <!-- |
| 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. |
| --> |
| <body> |
| |
| <p>This package contains a set of <code>JMX Task</code> implementations for |
| <em>Ant (version 1.6 or later)</em> 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 |
| <a href="http://jakarta.apache.org/tomcat/tomcat-5.5-doc/monitoring.html"> |
| http://jakarta.apache.org/tomcat/tomcat-5.5-doc/monitoring.html</a>.</p> |
| |
| <p>Each task element can open a new jmx connection or reference an |
| existing one. The following attribute are exists in every tasks: |
| </p> |
| |
| <table> |
| <tr> |
| <th align="center" width="15%">Attribute</th> |
| <th align="center" width="85%">Description</th> |
| </tr> |
| <tr> |
| <td align="center">url</td> |
| <td> |
| The JMX Connection URL of the remote Tomcat MBeansServer. |
| </td> |
| </tr> |
| <tr> |
| <td align="center">username</td> |
| <td> |
| The username of a MBeanServer auth, when configured. |
| </td> |
| </tr> |
| <tr> |
| <td align="center">password</td> |
| <td> |
| The password of a MBeanServer auth, when configured. |
| </td> |
| </tr> |
| <tr> |
| <td align="center">host</td> |
| <td> |
| The JMX Connection host. |
| </td> |
| </tr> |
| <tr> |
| <td align="center">port</td> |
| <td> |
| The JMX Connection port. |
| </td> |
| </tr> |
| <tr> |
| <td align="center">ref</td> |
| <td> |
| The name of the ant internal reference for a jmx connection. |
| </td> |
| </tr> |
| |
| </table> |
| |
| <p><strong>NOTE</strong> - This Tasks only work, |
| when JSR 160 MBean Adaptor as remote jvm is configured.</p> |
| |
| </body> |