Static deployment of RAR

Definition

Deploy a Java EE resource adapter (RAR) that will be started when the container starts

DataSource and Resource Support

An alternative to using RARs is to use the DataSource and Resource Support provided by CARGO.

Example using the Java API

Starting JOnAS 5.x with a RAR to deploy:

InstalledLocalContainer container = new Jonas5xInstalledLocalContainer(
    new Jonas5xStandaloneLocalConfiguration("target/jonas5x"));
container.setHome("c:/jonas/jonas-5.1.2");

Deployable rar = new RAR("src/data/mysql-5.1-localhost.rar");
container.getConfiguration().addDeployable(rar);

container.start();

Example using the Ant tasks

Starting JOnAS 5.x with a RAR to deploy:

<cargo containerId="jonas5x" home="c:/jonas/jonas-5.1.2" action="start">
  <configuration>
    <deployable type="rar" file="src/data/src/data/mysql-5.1-localhost.rar"/>
  </configuration>
</cargo>

Example using the Maven 3 plugin

Here is the plugin configuration defining a JOnAS 5.x container with a RAR to deploy:

<dependencies>
  <dependency>
    <groupId>com.myProject</groupId>
    <artifactId>mysql-5.1-localhost</artifactId>
    <version>${rar.version}</version>
    <type>rar</type>
  </dependency>
</dependencies>

<plugins>
  <plugin>
    <groupId>org.codehaus.cargo</groupId>
    <artifactId>cargo-maven3-plugin</artifactId>
    <version>${cargo.version}</version>
    <configuration>
      <containerId>jonas5x</containerId>
      <artifactInstaller>
        <groupId>org.ow2.jonas.assemblies.profiles</groupId>
        <artifactId>jonas-full</artifactId>
        <version>5.2.1</version>
        <classifier>bin</classifier>
      </artifactInstaller>
      <deployables>
        <deployable>
          <groupId>com.myProject</groupId>
          <artifactId>mysql-5.1-localhost</artifactId>
          <type>rar</type>
        </deployable>
      </deployables>
    </configuration>
  </plugin>
</plugins>

For more information...

For more information about how deployment in Codehaus Cargo works, please read:

How deployables work, which explains how to instanciate and personalize deployables.
How deployers work, which explains how the different deployers work.

Codehaus Cargo