Uploads all created webapps to an Apache Tomcat servlet container. More...
| Release-level Ant targets: | |
|---|---|
| tomcat-deploy |
Gathers all *.war files located in the "${antmod.release.dirs.dist}"
or "${antmod.war.dest}" directories of the release and uploads them
to a running Apache Tomcat servlet container.
Each webapp gets a context path equal to the file name of the webapp
without the ".war" suffix.
Make sure either:
- CATALINA_HOME (alternatively TOMCAT_HOME), or
- CATALINA_DEPLOYER_HOME (alternatively TOMCAT_DEPLOYER_HOME)
is set to your local tomcat installation or the standalone tomcat deployer directory (use forward slashes in the path). |
| Module-level Ant targets: | |
|---|---|
| none |
| Configurable properties: [...] | |
|---|---|
| antmod.tomcat.charset | The charset used for deploying to a running Tomcat servlet container.
Defaults to ISO-8859-1 |
| antmod.tomcat.deployerdir | If set, the Tomcat deployer task is assumed to be in the standalone deployer installation in this directory (use forward slashes, for example C:/Path/To/TomcatDeployer).
If unset, this plugin checks if the environment variables
CATALINA_DEPLOYER_HOME or TOMCAT_DEPLOYER_HOME have been set.
Defaults to being unset. |
| antmod.tomcat.homedir | If set, the Tomcat deployer task is assumed to be in a Tomcat installation in this directory (use foward slashes, for example C:/Path/To/TomcatHome).
If unset, this plugin checks if the environment variables
CATALINA_HOME or TOMCAT_HOME have been set.
Defaults to being unset. |
| antmod.tomcat.password | The password corresponding with the specified username. If not specified, the user will be prompted to enter the password. Defaults to being unset. |
| antmod.tomcat.update | Whether to update an existing WAR in a running Tomcat servlet container.
Defaults to true. |
| antmod.tomcat.url | The url of the Apache Tomcat Manager, e.g. http://localhost/manager. If not specified, the user will be prompted to enter the url. Defaults to being unset. |
| antmod.tomcat.username | The username of a user with privileges to use the Tomcat Manager. If not specified, the user will be prompted to enter a username. Defaults to being unset. |
Have a look at the Antmod War Plugin for information on how to create WAR files for your release.
Read more about Apache Tomcat here: http://jakarta.apache.org/tomcat/.
This plugin uses the tomcat deployer Ant task that Apache supplies with Tomcat.
You have to point this plugin to the Tomcat or TomcatDeployer libraries
on your local system, allowing you to use the version of Tomcat you desire.
Make sure either CATALINA_HOME (alternatively TOMCAT_HOME)
or CATALINA_DEPLOYER_HOME (alternatively TOMCAT_DEPLOYER_HOME)
is set to your local
tomcat installation or the
standalone tomcat deployer directory.
For downloading Tomcat or the Tomcat deployer, see http://jakarta.apache.org/site/downloads/downloads_tomcat-5.cgi.