Tomcat 7.x

This page has been automatically generated by Cargo's build. Do not edit it directly as it'll be overwritten next time it's generated again.

Feature name	Java	Ant	Maven2
Container Instantiation	`ContainerFactory.createContainer("tomcat7x"...)`	`<cargo containerId="tomcat7x".../>`	`<containerId>tomcat7x</containerId>`
Local Container
Container Classpath
Container Start
Container Stop
Container Timeout
Embedded Container
Installed Container	`o.c.c.c.tomcat.Tomcat7xInstalledLocalContainer`
Passing system properties
Installer
Remote Container	`o.c.c.c.tomcat.Tomcat7xRemoteContainer`

Feature name	Java	Ant	Maven2	Comment
Standalone Local Configuration for installed container	`o.c.c.c.tomcat.Tomcat7xStandaloneLocalConfiguration`
Standalone Local Configuration for embedded container
Existing Local Configuration for installed container	`o.c.c.c.tomcat.TomcatExistingLocalConfiguration`
Existing Local Configuration for embedded container
Runtime Configuration	`o.c.c.c.tomcat.TomcatRuntimeConfiguration`
Static deployment of WAR
Static deployment of expanded WAR
Static deployment of EJB
Static deployment of EAR
Static deployment of RAR
Static deployment of files
Static deployment of OSGi Bundles

Feature name	Java	Ant	Maven2	Comment
Installed Deployer	`o.c.c.c.tomcat.TomcatCopyingInstalledLocalDeployer`
Embedded Deployer
Remote Deployer	`o.c.c.c.tomcat.Tomcat7xRemoteDeployer`

Feature name	Java	Ant	Maven2	Comment
Debugging

The tables below list both the general configuration properties as well as the container-specific ones.

Property name	Java Property	Default value
cargo.hostname	GeneralPropertySet.HOSTNAME	`localhost`
cargo.java.home	GeneralPropertySet.JAVA_HOME	JAVA_HOME version 1.6 or newer
cargo.jvmargs	GeneralPropertySet.JVMARGS	N/A
cargo.logging	GeneralPropertySet.LOGGING	`medium`
cargo.protocol	GeneralPropertySet.PROTOCOL	`http`
cargo.runtime.args	GeneralPropertySet.RUNTIME_ARGS	N/A
cargo.servlet.port	ServletPropertySet.PORT	`8080`
cargo.servlet.users	ServletPropertySet.USERS	`admin::manager`
cargo.tomcat.ajp.port	TomcatPropertySet.AJP_PORT	`8009`
cargo.tomcat.context.reloadable	TomcatPropertySet.CONTEXT_RELOADABLE	`false`
cargo.tomcat.copywars	TomcatPropertySet.COPY_WARS	`true`
cargo.tomcat.webappsDirectory	TomcatPropertySet.WEBAPPS_DIRECTORY	`webapps`

Datasource and Resource configuration

In addition to the forementioned properties, this container configuration can also set up datasources and/or resources.

For more details, please read: DataSource and Resource Support.

Property name	Java Property	Default value
cargo.hostname	GeneralPropertySet.HOSTNAME	`localhost`
cargo.java.home	GeneralPropertySet.JAVA_HOME	JAVA_HOME version 1.6 or newer
cargo.protocol	GeneralPropertySet.PROTOCOL	`http`
cargo.servlet.port	ServletPropertySet.PORT	`8080`

Property name	Java Property	Default value
cargo.hostname	GeneralPropertySet.HOSTNAME	`localhost`
cargo.protocol	GeneralPropertySet.PROTOCOL	`http`
cargo.remote.password	RemotePropertySet.PASSWORD	N/A
cargo.remote.uri	RemotePropertySet.URI	N/A
cargo.remote.username	RemotePropertySet.USERNAME	N/A
cargo.servlet.port	ServletPropertySet.PORT	`8080`

With Tomcat 7, the Tomcat manager has multiple aspects to be careful about:

Your browser by default accesses the HTML-based manager whereas CARGO needs to use the text-based manager. As a result, if you want to set the RemotePropertySet.URI manually, please make sure you set the URL for the text-based manager, for example http://production27:8080/manager/text
The text-based manager requires to be accessed by a user with the manager-script role; and by default no user has that role. As a result, please make sure you modify your tomcat-users.xml file to give that role to a user.
You can read more on the Tomcat documentation: http://tomcat.apache.org/tomcat-7.0-doc/manager-howto.html

This container is automatically tested on its server using the Codehaus Cargo Continous Integration System once a day.