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 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.
There are just a few setup points to do before you can use JOnAS :
$JONAS_ROOT/conf/jndi.properties
file (this file is already set if you want to use RMI with the default port). You also have
to initialize the following environment variable to the correct value :
export OBJECTWEB_ORB = RMI / JEREMIE / DAVID
<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
$CATALINA_HOME/conf/tomcat-users.xml
:
<user name="jadmin" password="jonas" roles="jadmin, tomcat" />
$CATALINA_HOME/conf/tomcat-users.xml
:
<user name="jps_admin" password="admin" roles="administrator" />
$CATALINA_HOME/conf/server.xml
:
<Realm className="org.apache.catalina.realm.UserDatabaseRealm"
debug="0" resourceName="UserDatabase"/>
<Realm className="org.objectweb.security.catalina41.realm.UserDatabaseRealm"
debug="0" resourceName="UserDatabase"/>
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