This guide presents the different points of an installation of JOnAS (ith a web container already included) from scratch.
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 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%)
There are just a few setup points to do before you can use JOnAS :
CATALINA_HOME
or CATALINA_BASE
or
JETTY_HOME
environment variable, please unset these variables unless you know what you do.
JOnAS will set these variables for you without any modifications.
$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
If this variable
is not set, the default value is RMI.
<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
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
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.