Copy Page

You are not logged in. Any changes you make will be marked as anonymous. You may want to Log In if you already have an account. You can also Sign Up for a new account.

<h3>Definition</h3><table class="wysiwyg-macro" data-macro-name="excerpt" data-macro-parameters="atlassian-macro-output-type=BLOCK" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2V4Y2VycHQ6YXRsYXNzaWFuLW1hY3JvLW91dHB1dC10eXBlPUJMT0NLfQ&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="RICH_TEXT"><tr><td class="wysiwyg-macro-body"><p>Configures your container in a specific directory</p></td></tr></table><h3>Explanation</h3><p>The <a class="confluence-link" href="#" data-linked-resource-default-alias="unnamed link" data-base-url="http://docs.codehaus.org">standalone configuration</a> allows configuring your container so that it is setup to start in a directory you choose (see the <a class="confluence-link" href="/display/CARGO/Configuration" data-linked-resource-id="13113" data-linked-resource-type="page" data-linked-resource-default-alias="Configuration" data-base-url="http://docs.codehaus.org">configuration page</a> for more general explanations).</p><p>Whenever you configure or start a container which uses a standalone configuration, Cargo will:</p><ul><li>Delete the configuration directory</li><li>Create a new configuration in that directory, with all <a class="confluence-link" href="/display/CARGO/Configuration+properties" data-linked-resource-id="13096" data-linked-resource-type="page" data-linked-resource-default-alias="Configuration properties" data-base-url="http://docs.codehaus.org">configuration properties</a> (including <a class="confluence-link" href="/display/CARGO/DataSource+and+Resource+Support" data-linked-resource-id="116359224" data-linked-resource-type="page" data-linked-resource-default-alias="DataSource and Resource Support" data-base-url="http://docs.codehaus.org">data sources and resources</a>)</li><li>Copy all <a class="confluence-link" href="/display/CARGO/Configuration+files+option" data-linked-resource-id="155877441" data-linked-resource-type="page" data-linked-resource-default-alias="Configuration files option" data-base-url="http://docs.codehaus.org">configuration files</a></li><li>Perform a <a class="confluence-link" href="/display/CARGO/Local+Deployer" data-linked-resource-id="47499" data-linked-resource-type="page" data-linked-resource-default-alias="Local Deployer" data-base-url="http://docs.codehaus.org">local deployment</a> of all deployables</li></ul><p>The reason for this behavior is reproducibility which is for example very useful for automated testing. If you wanted to keep a generated configuration you could ask Cargo to generate a standalone configuration once and then consider it an <a class="confluence-link" href="/display/CARGO/Existing+Local+Configuration" data-linked-resource-id="13089" data-linked-resource-type="page" data-linked-resource-default-alias="Existing Local Configuration" data-base-url="http://docs.codehaus.org">existing configuration</a>.</p><h3>Support Matrix</h3><table class="confluenceTable"><tbody><tr><th class="confluenceTh"><p>Java</p></th><th class="confluenceTh"><p>Ant</p></th><th class="confluenceTh"><p>Maven2</p></th></tr><tr><td class="confluenceTd"><p><img class="emoticon emoticon-tick" data-emoticon-name="tick" border="0" src="/s/en_GB/3278/15/_/images/icons/emoticons/check.png" alt="(tick)" title="(tick)" /></p></td><td class="confluenceTd"><p><img class="emoticon emoticon-tick" data-emoticon-name="tick" border="0" src="/s/en_GB/3278/15/_/images/icons/emoticons/check.png" alt="(tick)" title="(tick)" /></p></td><td class="confluenceTd"><p><img class="emoticon emoticon-tick" data-emoticon-name="tick" border="0" src="/s/en_GB/3278/15/_/images/icons/emoticons/check.png" alt="(tick)" title="(tick)" /></p></td></tr></tbody></table><h3>Java API</h3><p>There are different ways of using a standalone configuration:</p><ul><li>By directly instantiating the configuration matching your container. For example:</li></ul><table class="wysiwyg-macro" data-macro-name="unmigrated-inline-wiki-markup" data-macro-parameters="atlassian-macro-output-type=BLOCK" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e3VubWlncmF0ZWQtaW5saW5lLXdpa2ktbWFya3VwOmF0bGFzc2lhbi1tYWNyby1vdXRwdXQtdHlwZT1CTE9DS30&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>{snippet:lang=java|id=configuration-typed-resin3x|url=http://svn.codehaus.org/cargo/core/trunk/documentation/src/main/java/org/codehaus/cargo/documentation/Snippets.java}</pre></td></tr></table><ul><li>By using the <code>DefaultConfigurationFactory</code> which automatically maps the right implementation for the container you're using. For example:</li></ul><table class="wysiwyg-macro" data-macro-name="unmigrated-inline-wiki-markup" data-macro-parameters="atlassian-macro-output-type=BLOCK" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e3VubWlncmF0ZWQtaW5saW5lLXdpa2ktbWFya3VwOmF0bGFzc2lhbi1tYWNyby1vdXRwdXQtdHlwZT1CTE9DS30&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>{snippet:lang=java|id=configuration-untyped-resin3x|url=http://svn.codehaus.org/cargo/core/trunk/documentation/src/main/java/org/codehaus/cargo/documentation/Snippets.java}</pre></td></tr></table><h3>Ant Task</h3><table class="wysiwyg-macro" data-macro-name="code" data-macro-default-parameter="xml" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGU6eG1sfQ&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>&lt;cargo containerId="resin3x" [...]&gt;
  &lt;configuration type="standalone" home="target/resin3x"/>
  [...]
&lt;/cargo>
</pre></td></tr></table><h3>Maven2 Plugin</h3><table class="wysiwyg-macro" data-macro-name="code" data-macro-default-parameter="xml" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGU6eG1sfQ&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>[...]
&lt;container>
  &lt;containerId>resin3x&lt;/containerId>
  [...]
&lt;/container>
&lt;configuration>
  &lt;type>standalone&lt;/type>
  &lt;home>target/resin3x&lt;/home>
&lt;/configuration>
[...]
</pre></td></tr></table><p>Note that the standalone configuration is the default for the Maven 2 plugin so specifying only the following would also work:</p><table class="wysiwyg-macro" data-macro-name="code" data-macro-default-parameter="xml" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGU6eG1sfQ&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>[...]
&lt;container>
  &lt;containerId>resin3x&lt;/containerId>
  [...]
&lt;/container>
[...]
</pre></td></tr></table>