How to use newjb command to create a new JOnAS base ?

newjb command builds a new JONAS_BASE directory.

The newjb utility builds a new JONAS_BASE directory that allows the conformance tests to be launched.

At the start, the user must choose : 

• the protocol among jrmp, iiop, irmi
• the database
• the web container among tomcat, jetty

The tool generates the configuration automatically.

The $JONAS_BASE variable must be set before launching the tool; it specifies the path to the new directory that will be built.

The $HOME/jb.config/lib directory must be created before launching the tool. It can contain some specific user configuration.

The tool relies on JOnAS 's ant tasks ($JONAS_ROOT/templates/newjb/build-jb.xml) and thus builds a configuration compatible with the JOnAS version.

Configuration for new JOnAS base

First, a JONAS_BASE with default values is built, and then the configuration files are modified with the values defined in the centralized configuration file of newjb.

A default configuration file is provided in $JONAS_ROOT/templates/newjb/build-jb.properties. It contains the variable parameters used by the tool, such as port number and database properties.

A user configuration can be set in the $HOME/jb.config/conf/jonas-newjb.properties file. If this file is present, the parameters it contains will override the default parameters.

By default, only the HSQL database can be configured with this tool. For other databases, the specific drivers must be stored in the $HOME/jb.config/lib directory before the run and the properties must be set in the $HOME/jb.config/conf/jonas-newjb.properties file.

The default script ($JONAS_ROOT/build-jb.xml) and its configuration ($JONAS_ROOT/templates/newjb/build-jb.properties) can be used as an example for creating a configuration tool corresponding to user's specific requirements.