Installing OpenJMS

This document describes how to install OpenJMS from an install archive. Refer to the Downloads document for instructions on obtaining a copy.

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.6 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.6.zip
          

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

gzip -cd openjms-0.7.6.tar.gz | 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 docs 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.