This page has been automatically generated by Cargo's build. Do not edit it directly as it'll be overwritten next time it's generated again.

Due to license conflicts, Codehaus Cargo versions 1.7.6 onwards do not contain the JOnAS Configurator in the Uberjar. If you plan to use the Codehaus Cargo JOnAS containers via Java API or ANT tasks, please download the JOnAS Configurator JARs separately and put them in your classpath.

This does not affect the Maven 3 plugin, as it will download the required dependencies automatically (and, since Maven downloads and stores the JOnAS Configurator JARs separately from Codehaus Cargo you won't run into license issues).

Container Features

Feature name

Java API

Ant tasks

Maven 3 plugin

Comment

Container Instantiation

(tick) ContainerFactory.createContainer("jonas5x"...)

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

(tick) <containerId>jonas5x</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)

 

  Installed Container

(tick) o.c.c.c.jonas.Jonas5xInstalledLocalContainer

(tick)

(tick)

 

   Passing system properties

(tick)

(tick)

(tick)

 

   Installer

(tick)

(tick)

(tick)

 

Remote Container

(tick) o.c.c.c.jonas.Jonas5xRemoteContainer

(tick)

(tick)

 

Configuration Features

Feature name

Java API

Ant tasks

Maven 3 plugin

Comment

Standalone Local Configuration for installed container

(tick) o.c.c.c.jonas.Jonas5xStandaloneLocalConfiguration

(tick)

(tick)

 

Standalone Local Configuration for embedded container

(error)

(error)

(error)

 

Existing Local Configuration for installed container

(tick) o.c.c.c.jonas.Jonas5xExistingLocalConfiguration

(tick)

(tick)

 

Existing Local Configuration for embedded container

(error)

(error)

(error)

 

Runtime Configuration

(tick) o.c.c.c.jonas.Jonas5xRuntimeConfiguration

(tick)

(tick)

 

Static deployment of WAR

(tick)

(tick)

(tick)

 

Static deployment of expanded WAR

(tick)

(tick)

(tick)

 

Static deployment of EJB

(tick)

(tick)

(tick)

 

Static deployment of EAR

(tick)

(tick)

(tick)

 

Static deployment of RAR

(tick)

(tick)

(tick)

 

Static deployment of files

(tick)

(tick)

(tick)

 

Static deployment of OSGi Bundles

(tick)

(tick)

(tick)

 

Deployer Features

The jonas5x local deployer requires the target JOnAS server to be in development mode.

If this is not the case, please use the jonas5x remote deployer.
Note that the jonas5x remote deployer can be used on a local server by setting the GeneralPropertySet.HOSTNAME parameter to localhost.

Feature name

Java API

Ant tasks

Maven 3 plugin

Comment

Installed Deployer

(tick) o.c.c.c.jonas.Jonas5xInstalledLocalDeployer

(tick)

(tick)

 

Embedded Deployer

(error)

(error)

(error)

 

Remote Deployer

(tick) o.c.c.c.jonas.Jonas5xJsr160RemoteDeployer

(tick)

(tick)

 

Other Features

Feature name

Java API

Ant tasks

Maven 3 plugin

Comment

Debugging

(tick)

(tick)

(tick)

 

Supported Configuration properties

The tables below list both the general configuration properties as well as the container-specific ones.

Standalone Local Configuration Properties

For installed container o.c.c.c.jonas.Jonas5xInstalledLocalContainer

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 5 (JOnAS 5.0.x, 5.1.x and 5.2.x) or 6 (JOnAS 5.3.x) or newer
 
Due to a bug parsing the Java version in the OW2 utilities, JOnAS 5.x doesn't run on Java 8 and above

(green star)

cargo.jonas.domain.name

JonasPropertySet.JONAS_DOMAIN_NAME

(tick)

jonas

(green star)

cargo.jonas.jms.port

JonasPropertySet.JONAS_JMS_PORT

(tick)

16010

(green star)

cargo.jonas.server.name

JonasPropertySet.JONAS_SERVER_NAME

(tick)

jonas

(green star)

cargo.jonas.services.list

JonasPropertySet.JONAS_SERVICES_LIST

(tick)

Will be loaded from the conf/jonas.properties file in the container home directory

(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.remote.password

RemotePropertySet.PASSWORD

(tick)

N/A

(green star)

cargo.remote.username

RemotePropertySet.USERNAME

(tick)

N/A

(green star)

cargo.rmi.port

GeneralPropertySet.RMI_PORT

(tick)

1099

(green star)

cargo.runtime.args

GeneralPropertySet.RUNTIME_ARGS

(tick)

N/A

(green star)

cargo.servlet.port

ServletPropertySet.PORT

(tick)

9000

(green star)

cargo.servlet.users

ServletPropertySet.USERS

(error)

N/A

 

cargo.standalone.ignoreNonExistingProperties

GeneralPropertySet.IGNORE_NON_EXISTING_PROPERTIES

(tick)

N/A

(green star)

cargo.start.jvmargs

GeneralPropertySet.START_JVMARGS

(tick)

N/A

(green star)

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.

In addition to the forementioned properties, you can set any JOnAS configuration property that's configurable via the JOnAS configurator using the cargo.jonas.configurator prefix. For example, to set the Tomcat AJP port, use the the property cargo.jonas.configurator.ajpPort and give the value you like.

As the JOnAS base ANT tasks, used by the configurator, make explicit use of the java.endorsed.dirs property which got removed with Java 9, it is no more possible to create any JOnAS configurations with newer versions of Java. You will get errors similar to the below:

[JmsRa] Cannot make a resource adaptor on RAConfig:
    [...]
Caused by: Java returned: 1
    at org.apache.tools.ant.taskdefs.Java.execute(Java.java:113)
    at org.ow2.jonas.antmodular.jonasbase.jms.JmsRa.execute(JmsRa.java:222)

Existing Local Configuration Properties

For installed container o.c.c.c.jonas.Jonas5xInstalledLocalContainer

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 5 (JOnAS 5.0.x, 5.1.x and 5.2.x) or 6 (JOnAS 5.3.x) or newer
 
Due to a bug parsing the Java version in the OW2 utilities, JOnAS 5.x doesn't run on Java 8 and above

(green star)

cargo.jonas.domain.name

JonasPropertySet.JONAS_DOMAIN_NAME

(tick)

jonas

(green star)

cargo.jonas.server.name

JonasPropertySet.JONAS_SERVER_NAME

(tick)

jonas

(green star)

cargo.jvmargs

GeneralPropertySet.JVMARGS

(tick)

N/A

(green star)

cargo.port.offset

GeneralPropertySet.PORT_OFFSET

(tick)

0

(green star)

cargo.process.spawn

GeneralPropertySet.SPAWN_PROCESS

(tick)

false

(green star)

cargo.remote.password

RemotePropertySet.PASSWORD

(tick)

N/A

(green star)

cargo.remote.username

RemotePropertySet.USERNAME

(tick)

N/A

(green star)

cargo.rmi.port

GeneralPropertySet.RMI_PORT

(tick)

1099

(green star)

cargo.runtime.args

GeneralPropertySet.RUNTIME_ARGS

(tick)

N/A

(green star)

cargo.servlet.port

ServletPropertySet.PORT

(tick)

9000

(green star)

cargo.start.jvmargs

GeneralPropertySet.START_JVMARGS

(tick)

N/A

(green star)

Runtime Configuration Properties

For remote container o.c.c.c.jonas.Jonas5xRemoteContainer

Property name

Java Property

Supported?

Default value

Javadoc

cargo.hostname

GeneralPropertySet.HOSTNAME

(tick)

localhost

(green star)

cargo.jonas.cluster.name

JonasPropertySet.JONAS_CLUSTER_NAME

(tick)

N/A

(green star)

cargo.jonas.deployable.identifier

JonasPropertySet.JONAS_DEPLOYABLE_IDENTIFIER

(tick)

N/A

(green star)

cargo.jonas.domain.name

JonasPropertySet.JONAS_DOMAIN_NAME

(tick)

jonas

(green star)

cargo.jonas.jndi.initial.context.factory

JonasPropertySet.JONAS_MEJB_JNDI_INIT_CTX_FACT

(tick)

N/A

(green star)

cargo.jonas.jndi.mejb.path

JonasPropertySet.JONAS_MEJB_JNDI_PATH

(tick)

N/A

(green star)

cargo.jonas.mejb.jaas.entry

JonasPropertySet.JONAS_MEJB_JAAS_ENTRY

(tick)

N/A

(green star)

cargo.jonas.mejb.jaas.file

JonasPropertySet.JONAS_MEJB_JAAS_FILE

(tick)

N/A

(green star)

cargo.jonas.server.name

JonasPropertySet.JONAS_SERVER_NAME

(tick)

jonas

(green star)

cargo.jonas.undeploy.ignoreVersion

JonasPropertySet.JONAS_UNDEPLOY_IGNORE_VERSION

(tick)

false

(green star)

cargo.remote.password

RemotePropertySet.PASSWORD

(tick)

N/A

(green star)

cargo.remote.uri

RemotePropertySet.URI

(tick)

N/A

(green star)

cargo.remote.username

RemotePropertySet.USERNAME

(tick)

N/A

(green star)

cargo.rmi.port

GeneralPropertySet.RMI_PORT

(tick)

1099

(green star)

Tested On

This container is automatically tested by the Continous Integration system every time there is a code change.
The server used for tests is downloaded from: https://repo.maven.apache.org/maven2/org/ow2/jonas/assemblies/profiles/legacy/jonas-full/5.3.0/jonas-full-5.3.0-bin.tar.gz