Installing JOnAS from scratch

This guide presents the different points of an installation of JOnAS from scratch on Unix-like systems.

The different steps are

  1. Installation of the JDK 1.4
  2. Installation of ant 1.5
  3. Installation of Tomcat 4.1.x
  4. Installation of JOnAS
  5. Setup

Installation of the JDK 1.4

Dowload the binary version of JDK 1.4 at the Sun web site in the directory into which you want to install it. Launch the executable file :

./j2sdk-1_4_0_<version number>-<system>.bin for Unix
./j2sdk-1_4_0_<version number>-<system>.sh for Linux

Set the JAVA_HOME environment variable and update the path :

export JAVA_HOME=<Installation Directory>
PATH=$JAVA_HOME/bin:$PATH

Installation of ant 1.5

Download the binary version of ant 1.5 at the Apache web site. Untar it in the directory into which you want to install it :

tar -xvf jakarta-ant-1.5.1-bin.tar.bz2

Set the ANT_HOME environment variable and update the path :

export ANT_HOME=<Installation Directory>
PATH=$PATH;$ANT_HOME/bin

Download bcel.jar from the Jakarta web site and install it in the directory $ANT_HOME/lib

Installation of Tomcat 4.1.x

Download the binary version of Tomcat 4.1.x at the Jakarta Tomcat web site. Untar it in the directory into which you want to install it :

tar -xvf jakarta-tomcat-4.1.x.tar.gz

Set the CATALINA_HOME environment variable :

export CATALINA_HOME=<Installation Directory>
JONAS_BASE directory can be used as CATALINA_BASE : export CATALINA_BASE=$JONAS_BASE
Don't forget to configure the Realm and users at the Setup process

Installation of JOnAS

Download the binary version of JOnAS from the ObjectWeb web site.
Choose a location for the JOnAS installation.
Beware that if you have already installed a previous version of JOnAS in this location the new installation will overload previous files and you may loose configuration files that you may have customized. So it is prudent to save these files before starting the installation process.
The installation process consists on unzipping the downloaded file.
To unzip this file, just go where you want to install JOnAS, and unzip it.
You can use gunzip jonas2.tgz and tar -xvf jonas2.tar.
After having installed the JOnAS product, all you have to do is to set this variable in your environment :

export JONAS_ROOT = <Installation Directory>
PATH = $JONAS_ROOT/bin/unix:$PATH

From the version 2.6.1 of JOnAS, you need to do a ant install in the JONAS_ROOT directory.
Note : This step has to be executed every time you want to use a new version of Tomcat or change the ORB.

Setup

There are just a few setup points to do before you can use JOnAS :

You can then compile the examples :
ant install in the directory $JONAS_ROOT/examples

You are now ready to use JOnAS. For more information, consult the JOnAS Documentation