Installing the packaging JOnAS with a web container
(JOnAS/Tomcat or JOnAS/Jetty) from scratch

This guide presents the different points of an installation of JOnAS (ith a web container already included) from scratch.

The different steps are

  1. Installation of the JDK 1.3 or 1.4
  2. Installation of ant 1.5
  3. Installation of JOnAS/ Web Container
  4. Setup
  5. Start JOnAS and run some examples

Installation of the JDK 1.3 or 1.4

Download the binary version of JDK 1.3 or JDK 1.4 from the java Sun web site in the directory into which you want to install it. Launch the executable file :

./j2sdk-1_<version number>-<system>.bin for Unix
./j2sdk-1_<version number>-<system>.sh for Linux
j2sdk-1_<version number>-windows-i586.exe for Windows

Set the JAVA_HOME environment variable and update the path :

export JAVA_HOME=<Installation Directory>
PATH=$JAVA_HOME/bin:$PATH (on Windows : PATH=%JAVA_HOME%/bin;%PATH%)

Installation of ant 1.5

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

tar -jxvf jakarta-ant-1.5-bin.tar.bz2
(or unzip jakarta-ant-1.5-bin.zip)

Set the ANT_HOME environment variable and update the path :

export ANT_HOME=<Installation Directory>
PATH=$PATH;$ANT_HOME/bin (on Windows : PATH=%ANT_HOME%/bin;%PATH%)

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

Installation of JOnAS/Web Container

Download the binary version of JOnAS with Tomcat or Jetty from the ObjectWeb forge 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 untaring the downloaded file.
To untar this file, just go where you want to install JOnAS, and untar it.
You can use tar -zxvf jonas.tgz command. Note that you can open this file with winzip on Windows.
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 (on Windows : PATH=%JONAS_ROOT%/bin/nt;%PATH%)

Setup

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

Start JOnAS and run some examples

Are you sure that you have follow the Setup process ? If you haven't follow this step, JOnAS may not work.
Use the command jonas check to see if your environment is correct.


If the environment is correct, you are now ready to use JOnAS.
Do a jonas start and go with your browser to the http://localhost:8080/ url after that you have launched JOnAS. (Modify this url with the right hostname).
You can execute the earsample, go the the jadmin console administration and more from the root context which was deployed.
For more information, consult the JOnAS Documentation
For your first EJB example follow the getting started guide
Note that the examples have been built for RMI. You don't have to compile them for the Getting Started guide.