Requirements

OpenJMS will run on any platform where there is a suitable Java 2 runtime environment

Unpacking the install archive

The install archive contains everything required to run OpenJMS on your system. The archive has a single top-level directory named openjms-0.7.5 with all the OpenJMS related files beneath that.

Install archives with a .zip extension can be unpacked using winzip , or the jar tool (distributed with the Java 2 SDK). E.g.:

jar xvf openjms-0.7.5.zip
          

Install archives with a .tgz extension can be unpacked with gzip and tar . E.g.:

gzip -cd openjms-0.7.5.tgz | tar xvf -
          

Environment variables

The OpenJMS server requires that the following environment variables be set:

• JAVA_HOME - the Java 2 runtime environment installation directory.
• OPENJMS_HOME - the OpenJMS installation directory.

Directory structure

The bin directory contains Unix shell scripts and Windows batch files to:

• start, stop, and administer the OpenJMS server
• create the OpenJMS database
• run the sample programs

The doc directory contains the full set of OpenJMS documentation.

The lib directory contains:

• JARs required to run the OpenJMS server
• JARs required by client programs to use OpenJMS

The config directory contains:

• the default OpenJMS server configuration file, openjms.xml
• sample OpenJMS server configuration files
• SQL scripts to create the OpenJMS database

The src directory contains the sources to the sample programs.