Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Feature name

Java

Ant

Maven2

Comment

Container Instantiation

(tick) ContainerFactory.createContainer("tomcat7x"...)

(tick) <cargo containerId="tomcat7x".../>

(tick) <containerId>tomcat7x</containerId>

 

Local Container

(tick)

(tick)

(tick)

 

  Container Classpath

(tick)

(tick)

(tick)

 

  Container Start

(tick)

(tick)

(tick)

 

  Container Stop

(tick)

(tick)

(tick)

 

  Container Timeout

(tick)

(tick)

(tick)

 

  Embedded Container

(error)

(error)

(error)(tick) o.c.c.c.tomcat.Tomcat7xEmbeddedLocalContainer

(tick)

(tick)

 

  Installed Container

(tick) o.c.c.c.tomcat.Tomcat7xInstalledLocalContainer

(tick)

(tick)

 

   Passing system properties

(tick)

(tick)

(tick)

 

   Installer

(tick)

(tick)

(tick)

 

Remote Container

(tick) o.c.c.c.tomcat.Tomcat7xRemoteContainer

(tick)

(tick)

 

Info
titleRunning multiple Tomcat 7.x / Tomcat 8.x embedded containers within the same JVM

Tomcat 7.x has introduced a class called TomcatURLStreamHandlerFactory where the singleton has a static instance field and a final registered attribute which are not always in sync and cause unexpected exceptions. Due to this, it is not possible to execute Tomcat 7.x and Tomcat 8.x embedded in the same JVM, in addition running one of these Tomcat embedded versions one after the other within the same JVM but different classpaths might also fail.

If you want to be safe, prefer using the Installed Container.

Configuration Features

Feature name

Java

Ant

Maven2

Comment

Standalone Local Configuration for installed container

(tick) o.c.c.c.tomcat.Tomcat7xStandaloneLocalConfiguration

(tick)

(tick)

 

Standalone Local Configuration for embedded container

(error)

(error)

(error)(tick) o.c.c.c.tomcat.Tomcat7xStandaloneLocalConfiguration

(tick)

(tick)

 

Existing Local Configuration for installed container

(tick) o.c.c.c.tomcat.TomcatExistingLocalConfiguration

(tick)

(tick)

 

Existing Local Configuration for embedded container

(error)

(error)

(error)(tick) o.c.c.c.tomcat.TomcatExistingLocalConfiguration

(tick)

(tick)

 

Runtime Configuration

(tick) o.c.c.c.tomcat.TomcatRuntimeConfiguration

(tick)

(tick)

 

Static deployment of WAR

(tick)

(tick)

(tick)

 

Static deployment of expanded WAR

(tick)

(tick)

(tick)

 

Static deployment of EJB

(error)

(error)

(error)

 

Static deployment of EAR

(error)

(error)

(error)

 

Static deployment of RAR

(error)

(error)

(error)

 

Static deployment of files

(error)

(error)

(error)

 

Static deployment of OSGi Bundles

(error)

(error)

(error)

 

...

Feature name

Java

Ant

Maven2

Comment

Installed Deployer

(tick) o.c.c.c.tomcat.TomcatCopyingInstalledLocalDeployer

(tick)

(tick)

 

Embedded Deployer

(error)

(error)

(error)(tick) o.c.c.c.tomcat.TomcatEmbeddedLocalDeployer

(tick)

(tick)

 

Remote Deployer

(tick) o.c.c.c.tomcat.Tomcat7xRemoteDeployer

(tick)

(tick)

 

...

Property name

Java Property

Supported?

Default value

Javadoc

cargo.hostname

GeneralPropertySet.HOSTNAME

(tick)

localhost

(green star)

cargo.java.home

GeneralPropertySet.JAVA_HOME

(tick)

JAVA_HOME version 6 or newer

(green star)

cargo.jvmargs

GeneralPropertySet.JVMARGS

(tick)

N/A

(green star)

cargo.logging

GeneralPropertySet.LOGGING

(tick)

medium

(green star)

cargo.port.offset

GeneralPropertySet.PORT_OFFSET

(tick)

0

(green star)

cargo.process.spawn

GeneralPropertySet.SPAWN_PROCESS

(tick)

false

(green star)

cargo.protocol

GeneralPropertySet.PROTOCOL

(tick)

http

(green star)

cargo.runtime.args

GeneralPropertySet.RUNTIME_ARGS

(tick)

N/A

(green star)

cargo.servlet.port

ServletPropertySet.PORT

(tick)

8080

(green star)

cargo.servlet.uriencoding

GeneralPropertySet.URI_ENCODING

(tick)

ISO-8859-1

(green star)

cargo.servlet.users

ServletPropertySet.USERS

(tick)

admin::manager-script

(green star)

cargo.standalone.ignoreNonExistingProperties

GeneralPropertySet.IGNORE_NON_EXISTING_PROPERTIES

(tick)

N/A

(green star)

cargo.tomcat.ajp.port

TomcatPropertySet.AJP_PORT

(tick)

8009

(green star)

cargo.tomcat.connector.clientAuth

TomcatPropertySet.CONNECTOR_CLIENT_AUTH

(tick)

N/A

(green star)

cargo.tomcat.connector.keyAlias

TomcatPropertySet.CONNECTOR_KEY_ALIAS

(tick)

N/A

(green star)

cargo.tomcat.connector.keystoreFile

TomcatPropertySet.CONNECTOR_KEY_STORE_FILE

(tick)

N/A

(green star)

cargo.tomcat.connector.keystorePass

TomcatPropertySet.CONNECTOR_KEY_STORE_PASSWORD

(tick)

N/A

(green star)

cargo.tomcat.connector.keystoreType

TomcatPropertySet.CONNECTOR_KEY_STORE_TYPE

(tick)

N/A

(green star)

cargo.tomcat.connector.sslProtocol

TomcatPropertySet.CONNECTOR_SSL_PROTOCOL

(tick)

N/A

(green star)

cargo.tomcat.connector.truststoreFile

TomcatPropertySet.CONNECTOR_TRUST_STORE_FILE

(tick)

N/A

(green star)

cargo.tomcat.connector.truststorePass

TomcatPropertySet.CONNECTOR_TRUST_STORE_PASSWORD

(tick)

N/A

(green star)

cargo.tomcat.connector.truststoreType

TomcatPropertySet.CONNECTOR_TRUST_STORE_TYPE

(tick)

N/A

(green star)

cargo.tomcat.context.reloadable

TomcatPropertySet.CONTEXT_RELOADABLE

(tick)

false

(green star)

cargo.tomcat.copywars

TomcatPropertySet.COPY_WARS

(tick)

true

(green star)

cargo.tomcat.httpSecure

TomcatPropertySet.HTTP_SECURE

(tick)

false

(green star)

cargo.tomcat.useHttpOnly

TomcatPropertySet.USE_HTTP_ONLY

(tick)

N/A

(green star)

cargo.tomcat.webappsDirectory

TomcatPropertySet.WEBAPPS_DIRECTORY

(tick)

webapps

(green star)

Info
titleDatasource 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.

For embedded container o.c.c.c.tomcat.Tomcat7xEmbeddedLocalContainer

Property name

Java Property

Supported?

Default value

Javadoc

cargo.hostname

GeneralPropertySet.HOSTNAME

(tick)

localhost

(green star)

cargo.java.home

GeneralPropertySet.JAVA_HOME

(tick)

JAVA_HOME version 6 or newer

(green star)

cargo.jvmargs

GeneralPropertySet.JVMARGS

(tick)

N/A

(green star)

cargo.logging

GeneralPropertySet.LOGGING

(tick)

medium

(green star)

cargo.port.offset

GeneralPropertySet.PORT_OFFSET

(tick)

0

(green star)

cargo.protocol

GeneralPropertySet.PROTOCOL

(tick)

http

(green star)

cargo.runtime.args

GeneralPropertySet.RUNTIME_ARGS

(tick)

N/A

(green star)

cargo.servlet.port

ServletPropertySet.PORT

(tick)

8080

(green star)

cargo.servlet.uriencoding

GeneralPropertySet.URI_ENCODING

(tick)

ISO-8859-1

(green star)

cargo.servlet.users

ServletPropertySet.USERS

(tick)

admin::manager-script

(green star)

cargo.standalone.ignoreNonExistingProperties

GeneralPropertySet.IGNORE_NON_EXISTING_PROPERTIES

(tick)

N/A

(green star)

cargo.tomcat.ajp.port

TomcatPropertySet.AJP_PORT

(tick)

8009

(green star)

cargo.tomcat.connector.clientAuth

TomcatPropertySet.CONNECTOR_CLIENT_AUTH

(tick)

N/A

(green star)

cargo.tomcat.connector.keyAlias

TomcatPropertySet.CONNECTOR_KEY_ALIAS

(tick)

N/A

(green star)

cargo.tomcat.connector.keystoreFile

TomcatPropertySet.CONNECTOR_KEY_STORE_FILE

(tick)

N/A

(green star)

cargo.tomcat.connector.keystorePass

TomcatPropertySet.CONNECTOR_KEY_STORE_PASSWORD

(tick)

N/A

(green star)

cargo.tomcat.connector.keystoreType

TomcatPropertySet.CONNECTOR_KEY_STORE_TYPE

(tick)

N/A

(green star)

cargo.tomcat.connector.sslProtocol

TomcatPropertySet.CONNECTOR_SSL_PROTOCOL

(tick)

N/A

(green star)

cargo.tomcat.connector.truststoreFile

TomcatPropertySet.CONNECTOR_TRUST_STORE_FILE

(tick)

N/A

(green star)

cargo.tomcat.connector.truststorePass

TomcatPropertySet.CONNECTOR_TRUST_STORE_PASSWORD

(tick)

N/A

(green star)

cargo.tomcat.connector.truststoreType

TomcatPropertySet.CONNECTOR_TRUST_STORE_TYPE

(tick)

N/A

(green star)

cargo.tomcat.context.reloadable

TomcatPropertySet.CONTEXT_RELOADABLE

(tick)

false

(green star)

cargo.tomcat.copywars

TomcatPropertySet.COPY_WARS

(tick)

true

(green star)

cargo.tomcat.httpSecure

TomcatPropertySet.HTTP_SECURE

(tick)

false

(green star)

cargo.tomcat.useHttpOnly

TomcatPropertySet.USE_HTTP_ONLY

(tick)

N/A

(green star)

cargo.tomcat.webappsDirectory

TomcatPropertySet.WEBAPPS_DIRECTORY

(tick)

webapps

(green star)

...

For embedded container o.c.c.c.tomcat.Tomcat7xEmbeddedLocalContainer

Runtime Configuration Properties

...

Info

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 in the Tomcat documentation: http://tomcat.apache.org/tomcat-7.0-doc/manager-howto.html

...

...