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-9.0-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.