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>Re-use an existing container installation</p></td></tr></table><h3>Explanations</h3><p>An existing configuration plugs itself onto an existing container installation that exists on your hard disk. This is by opposition to the <a class="confluence-link" href="/display/CARGO/Standalone+Local+Configuration" data-linked-resource-id="13087" data-linked-resource-type="page" data-linked-resource-default-alias="Standalone Local Configuration" data-base-url="http://docs.codehaus.org">Standalone Local Configuration</a> which creates a new container installation from scratch in a directory of your choice. Existing configurations require that the user creates a valid configuration directory and points Cargo to it.</p><p>Whenever you configure or start a container which uses an existing configuration, Cargo will:</p><ul><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>As a result, Cargo will not be configuring the <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> nor the <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> on your container; these need to be configured beforehand.</p><p>Please note that this method does not guarantee reproducibility, as the configuration is not &quot;cleaned&quot; at any point. If you want to keep a generated configuration you can ask Cargo to generate a <a class="confluence-link" href="/display/CARGO/Standalone+Local+Configuration" data-linked-resource-id="13087" data-linked-resource-type="page" data-linked-resource-default-alias="Standalone Local Configuration" data-base-url="http://docs.codehaus.org">standalone configuration</a> once and then consider it an <span class="confluence-link">existing configuration</span>.</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 an existing configuration:</p><ul><li>By directly instantiating the configuration matching your container. For example:</li></ul><table class="wysiwyg-macro" data-macro-name="code" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGV9&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>[...]
Configuration configuration = new ResinExistingLocalConfiguration("target/resin3x");
[...]
</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="code" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGV9&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>[...]
ConfigurationFactory factory = new DefaultConfigurationFactory();
Configuration configuration = factory.createConfiguration("resin3x", 
    ContainerType.INSTALLED, ConfigurationFactory.EXISTING, "c:/apps/resin-3.0.9");
[...]
</pre></td></tr></table><h3>Ant Task</h3><p>Example:</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;cargo containerId="resin3x" [...]&gt;
  &lt;configuration type="existing" home="c:/apps/resin-3.0.9"/>
  [...]
&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>existing&lt;/type>
  &lt;home>c:/apps/resin-3.0.9&lt;/home>
&lt;/configuration>
[...]
</pre></td></tr></table>