Quick Links

• Home
• Downloads
• Quick start
• How to contribute?
  • Adding a container

Documentation

• Overview
  • Architecture
  • Features
• Installation
• Usage
  • Java API
  • Functional testing with JUnit
  • Ant tasks
  • Maven2/Maven3 plugin
  • Cargo Daemon
• Articles
• License
• Credits

Containers

• Geronimo
  • Geronimo 1.x
  • Geronimo 2.x
  • Geronimo 3.x

• Glassfish
  • Glassfish 2.x
  • Glassfish 3.x
  • Glassfish 4.x

• JBoss
  • JBoss 3.x
  • JBoss 4.x
  • JBoss 4.2.x
  • JBoss 5.x
  • JBoss 5.1.x
  • JBoss 6.x
  • JBoss 6.1.x
  • JBoss 7.x
  • JBoss 7.1.x

• Jetty
  • Jetty 4.x
  • Jetty 5.x
  • Jetty 6.x
  • Jetty 7.x
  • Jetty 8.x
  • Jetty 9.x

• Jo!
  • jo 1.x

• JOnAS
  • JOnAS 4.x
  • JOnAS 5.x

• JRun
  • JRun 4.x

• Orion/OC4J
  • Oc4J 9.x
  • Oc4j 10.x

• Resin
  • Resin 2.x
  • Resin 3.x
  • Resin 3.1.x
  • Resin 4.x

• Tomcat
  • Tomcat 4.x
  • Tomcat 5.x
  • Tomcat 6.x
  • Tomcat 7.x

• WebLogic
  • WebLogic 8.x
  • WebLogic 9.x
  • WebLogic 10.x
  • WebLogic 10.3.x
  • WebLogic 12.x

• WebSphere
  • WebSphere 8.5.x

Extensions

• Ant
• Cargo Daemon
• Maven2/Maven3

Independent extensions:

• Gradle
• Mule container

Project Info

• Roadmap
• News
• Issues
• Change log
• SVN
• Mailing Lists
• License
• Credits

Get Involved

• Contributing
• Discussions

Development

• Cargo Code Style
• Project Structure
• Importing sources
• Building
• Release procedure
• CI status

Container Features

Feature name	Java	Ant	Maven2	Comment
Container Instantiation	ContainerFactory.createContainer("jonas5x"...)	<cargo containerId="jonas5x".../>	<containerId>jonas5x</containerId>
Local Container
Container Classpath
Container Start
Container Stop
Container Timeout
Embedded Container
Installed Container	o.c.c.c.jonas.Jonas5xInstalledLocalContainer
Passing system properties
Installer
Remote Container	o.c.c.c.jonas.Jonas5xRemoteContainer

Configuration Features

Feature name	Java	Ant	Maven2	Comment
Standalone Local Configuration for installed container	o.c.c.c.jonas.Jonas5xStandaloneLocalConfiguration
Standalone Local Configuration for embedded container
Existing Local Configuration for installed container	o.c.c.c.jonas.Jonas5xExistingLocalConfiguration
Existing Local Configuration for embedded container
Runtime Configuration	o.c.c.c.jonas.Jonas5xRuntimeConfiguration
Static deployment of WAR
Static deployment of expanded WAR
Static deployment of EJB
Static deployment of EAR
Static deployment of RAR
Static deployment of files
Static deployment of OSGi Bundles

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	Ant	Maven2	Comment
Installed Deployer	o.c.c.c.jonas.Jonas5xInstalledLocalDeployer
Embedded Deployer
Remote Deployer	o.c.c.c.jonas.Jonas5xJsr160RemoteDeployer

Other Features

Feature name	Java	Ant	Maven2	Comment
Debugging

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		localhost
cargo.java.home	GeneralPropertySet.JAVA_HOME		JAVA_HOME version 5 or newer
cargo.jonas.domain.name	JonasPropertySet.JONAS_DOMAIN_NAME		jonas
cargo.jonas.jms.port	JonasPropertySet.JONAS_JMS_PORT		16010
cargo.jonas.server.name	JonasPropertySet.JONAS_SERVER_NAME		jonas
cargo.jonas.services.list	JonasPropertySet.JONAS_SERVICES_LIST		registry,jmx,jtm,db,dbm,security,resource,ejb2,ejb3,jaxws,web,ear,depmonitor
cargo.jvmargs	GeneralPropertySet.JVMARGS		N/A
cargo.logging	GeneralPropertySet.LOGGING		medium
cargo.port.offset	GeneralPropertySet.PORT_OFFSET		0
cargo.process.spawn	GeneralPropertySet.SPAWN_PROCESS		false
cargo.rmi.port	GeneralPropertySet.RMI_PORT		1099
cargo.runtime.args	GeneralPropertySet.RUNTIME_ARGS		N/A
cargo.servlet.port	ServletPropertySet.PORT		9000
cargo.servlet.users	ServletPropertySet.USERS		N/A
cargo.standalone.ignoreNonExistingProperties	GeneralPropertySet.IGNORE_NON_EXISTING_PROPERTIES		false

Datasource and Resource configuration 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.

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		localhost
cargo.java.home	GeneralPropertySet.JAVA_HOME		JAVA_HOME version 5 or newer
cargo.jonas.domain.name	JonasPropertySet.JONAS_DOMAIN_NAME		jonas
cargo.jonas.server.name	JonasPropertySet.JONAS_SERVER_NAME		jonas
cargo.port.offset	GeneralPropertySet.PORT_OFFSET		0
cargo.process.spawn	GeneralPropertySet.SPAWN_PROCESS		false
cargo.rmi.port	GeneralPropertySet.RMI_PORT		1099
cargo.servlet.port	ServletPropertySet.PORT		9000

Runtime Configuration Properties

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

Property name	Java Property	Supported?	Default value	Javadoc
cargo.hostname	GeneralPropertySet.HOSTNAME		localhost
cargo.jonas.cluster.name	JonasPropertySet.JONAS_CLUSTER_NAME		N/A
cargo.jonas.deployable.identifier	JonasPropertySet.JONAS_DEPLOYABLE_IDENTIFIER		N/A
cargo.jonas.domain.name	JonasPropertySet.JONAS_DOMAIN_NAME		jonas
cargo.jonas.jndi.initial.context.factory	JonasPropertySet.JONAS_MEJB_JNDI_INIT_CTX_FACT		N/A
cargo.jonas.jndi.mejb.path	JonasPropertySet.JONAS_MEJB_JNDI_PATH		N/A
cargo.jonas.mejb.jaas.entry	JonasPropertySet.JONAS_MEJB_JAAS_ENTRY		N/A
cargo.jonas.mejb.jaas.file	JonasPropertySet.JONAS_MEJB_JAAS_FILE		N/A
cargo.jonas.server.name	JonasPropertySet.JONAS_SERVER_NAME		jonas
cargo.jonas.undeploy.ignoreVersion	JonasPropertySet.JONAS_UNDEPLOY_IGNORE_VERSION		false
cargo.remote.password	RemotePropertySet.PASSWORD		N/A
cargo.remote.uri	RemotePropertySet.URI		N/A
cargo.remote.username	RemotePropertySet.USERNAME		N/A
cargo.rmi.port	GeneralPropertySet.RMI_PORT		1099

Tested On

This container is automatically tested on its server using the Codehaus Cargo Continous Integration System once a day.

• The server used for tests is downloaded from: http://repo1.maven.org/maven2/org/ow2/jonas/assemblies/profiles/jonas-full/5.2.4/jonas-full-5.2.4-bin.tar.gz
• Link to the build plan: https://bamboo-ci.codehaus.org/browse/CARGO-SAMPLESJONAS5X