This guide presents the different points of an installation of JOnAS from scratch on Unix-like systems.
The different steps are
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%)
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
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
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 jonas3.tgz
and tar -xvf jonas3.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
You need to do a ant install
in the JONAS_ROOT
directory in order to build jonas.jar
and client.jar
.
It builds these jars by unpacking some jars file.
There are just a few setup points to do before you can use JOnAS :
<data source>.properties
(you can find some templates in the directory
$JONAS_ROOT/conf
). Then add the data source file name (without the extension
.properties
) in the jonas.properties
file :
jonas.service.dbm.datasource <data source>
$JONAS_ROOT/bin/unix/config_env
, set the path to the JDBC driver
of the database used. CLASSPATH=/usr/lib/pgsql/jdbc7.0-1.2.jar:$CLASSPATH
export CATALINA_BASE=$JONAS_BASE
So it will used the JOnAS realms.
javax.mail.Session
and
javax.mail.internet.MimePartDataSource
. In the directory $JONAS_ROOT/conf
,
you can find two files : MailSession1.properties
and MailMimePartDS1.properties
that you can adapt to fit your installation. Then, in the jonas.properties
file,
define the jonas.service.mail.factories
property :
jonas.service.mail.factories MailSession1,MailMimePartDS1
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