This page last changed on Feb 26, 2006 by vmassol.

Definition

A configuration for a container that is already started

Explanation

The container could be executing on the same machine as where Cargo is executing or anywhere else. The important part is that Cargo is accessing that container using a remote access protocol and the container is considered as a black box.

Example using the Java API

There are different ways of using a runtime configuration:

  • By directly instantiating the configuration matching your container. For example:
[...]
Configuration configuration = new TomcatRuntimeConfiguration();
[...]
  • By using the DefaultConfigurationFactory which automatically maps the right implementation for the container you're using. For example:
[...]
ConfigurationFactory factory = new DefaultConfigurationFactory();
Configuration configuration = factory.createConfiguration("tomcat5x", 
    ConfigurationFactory.RUNTIME, "c:/apps/jakarta-tomcat-5.0.30");
[...]

Example using the Ant API

<cargo containerId="tomcat5x" [...]>
  <configuration hint="runtime"/>
  [...]
</cargo>

Example using the Maven 2 plugin

[...]
<container>
  <containerId>tomcat5x</containerId>
  [...]
</container>
<configuration>
  <type>runtime</type>
</configuration>
[...]
Document generated by Confluence on Mar 22, 2006 15:28