Package org.apache.catalina.ant


package org.apache.catalina.ant

This package contains a set of Task implementations for Ant (version 1.6.x or later) that can be used to interact with the Manager application to deploy, undeploy, list, reload, start and stop web applications from a running instance of Tomcat. For more information, see https://tomcat.apache.org/tomcat-10.1-doc/manager-howto.html.

The attributes of each task element correspond exactly to the request parameters that are included with an HTTP request sent directly to the Manager application. They are summarized as follows:

Task attributes
Attribute Description
url The URL of the Manager web application you will use to perform the requested operations. If not specified, defaults to http://localhost:8080/manager/text (which corresponds to a standard installation of Tomcat 7).
username The username of a Tomcat user that has been configured with the manager-script role, as required to execute Manager application commands. This attribute is required.
password The password of a Tomcat user that has been configured with the manager-script role, as required to execute Manager application commands. This attribute is required.
config A URL pointing at the context configuration file (i.e. a file containing only the <Context> element, and its nested elements, from server.xml for a particular web application). This attribute is supported only on the install target, and is required only if you wish to install an application with non-default configuration characteristics.
path The context path (including the leading slash) of the web application this command is intended to manage, or a zero-length string for the ROOT web application. This attribute is valid for the install, reload, remove, start, and stop tasks only, and is required in all of those cases.
war A jar: URL that points at a web application archive (WAR) file, or a file: URL that points at an unpacked directory containing the web application. This attribute is supported only on the install target. You must specify at least one of the config and war attributes; if you specify both, the war attribute overrides the docBase attribute in the context configuration file.

NOTE - Commands executed through the Manager application are NOT reflected in updates to the Tomcat server.xml configuration file, so they do not persist past the next time you restart the entire Tomcat container.

  • Classes
    Class
    Description
     
    Abstract base class for Ant tasks that interact with the Manager web application for dynamically deploying and undeploying applications.
    Abstract base class to add output redirection support for Catalina Ant tasks.
    Ant task that implements the /deploy command, supported by the Tomcat manager application.
    Ant task that implements the /findleaks command, supported by the Tomcat manager application.
    Ant task that implements the /status command, supported by the mod_jk status (1.2.9) application.
    Ant task that implements the JMX Get command (/jmxproxy/?
    Ant task that implements the JMX Query command (/jmxproxy/?
    Ant task that implements the JMX Set command (/jmxproxy/?
    Ant task that implements the /list command, supported by the Tomcat manager application.
    Ant task that implements the /reload command, supported by the Tomcat manager application.
    Ant task that implements the /resources command, supported by the Tomcat manager application.
    Ant task that implements the /serverinfo command supported by the Tomcat manager application.
    Ant task that implements the /sessions command supported by the Tomcat manager application.
    Ant task that implements the /sslConnectorCiphers command supported by the Tomcat manager application.
    Ant task that implements the /start command, supported by the Tomcat manager application.
    Ant task that implements the /stop command, supported by the Tomcat manager application.
    Ant task that implements the /threaddump command supported by the Tomcat manager application.
    Ant task that implements the /undeploy command, supported by the Tomcat manager application.
    Task for validating a web application deployment descriptor, using XML schema validation.
    Ant task that implements the /vminfo command supported by the Tomcat manager application.