Dear customer,

we believe that the following information would help you using the application
server Jonas on SUSE.


Installation
------------

The entire server is in the package jonas. Examples are in the package
jonas-examples. See below for more information about examples.

The package is installed the following way to conform FHS:

/usr/share/jonas	      JONAS_ROOT
/srv/www/jonas/base	      default JONAS_BASE
/etc/jonas/base		      configuration for the default JONAS_BASE
/var/log/jonas/base           logs from the default JONAS_BASE
/usr/share/doc/packages/jonas documentation

Note the /src/www/jonas/base is not an extra created JONAS_BASE. There are
directories from JONAS_ROOT which can be changed at runtime, so they can not
be placed physically in /usr/share which should be mounted read-only.
Therefore these directories are physically placed in below /srv and are linked
from /usr/share/jonas.

Note that it is recommended to use a different location through the JONAS_BASE
environment variable for customizing configuration files. See the original
Jonas documentation for more details. There is also the demoserver as an
example of this approach in the package jonas-examples.


Configuration, init script
--------------------------

Next to the usual server configuration in /etc/jonas/<jonas_base> there
is also /etc/sysconfig/j2ee where the following variables can be configured:

    JONAS_ROOT
    JONAS_BASE
    CATALINA_HOME
    CATALINA_BASE_FOR_JONAS

All these variables are used by the init script /etc/init.d/jonas. It sets
the environment variable JONAS_BASE to the value of JONAS_ROOT if JONAS_BASE
is not set. It also sets the environment value CATALINA_BASE to the value
CATALINA_BASE_FOR_JONAS or it sets CATALINA_BASE to the value of JONAS_BASE
if CATALINA_BASE_FOR_JONAS is not set.

Be careful when you set different JONAS_BASE and CATALINA_BASE_FOR_JONAS,
please. Some sources may conflict in this case and the server need not
start correctly.


Security
--------

If the server is started by the init script, it is running on the user "jonas"
to improve the security. Please, make sure that all the files and directories
which can be changed at runtime are owned by the user and group jonas:jonas.

The init script tries to fix the user and group of all the problematic
directories and files. Though, be careful when you change JONAS_BASE or
CATALINA_BASE_FOR_JONAS, please. For example, you should not use the same
CATALINA_BASE_FOR_JONAS and the same CATALINA_BASE for a standalone running
tomcat server because the two running instances of the Tomcat server will
use the same work directory.


Examples
--------

There is the package jonas-examples which provides some precompiled
applications, a demoserver and the documentation for the examples.

The demo server is installed the following way:

/srv/www/jonas/demoserver - JONAS_BASE for the demoserver
/etc/jonas/demoserver	  - configuration for the demoserver
/var/log/jonas/demoserver - logs from the demoserver
/usr/share/doc/packages/jonas/examples - documentation

The following steps must be done to run the demoserver. Note that you must
be root to do it:

1. Install the package jonas-examples.

2. Make sure the server jonas is stopped. It can be done by YaST in the
   "Runlevel Editor" or by the command:
   
	rcjonas status

3. Change JONAS_BASE to "/srv/www/jonas/demoserver". It can be done by YaST
   in the "Editor for /etc/sysconfig Files" or by editing the file
   /etc/sysconfig/j2ee.
  
4. Make sure CATALINA_BASE is empty or is set to "/srv/www/jonas/demoserver".
   It can be done by YaST in the "Editor for /etc/sysconfig Files" or by
   editing the file /etc/sysconfig/j2ee.

4. Start the server Jonas. It can be done by YaST in the "Runlevel Editor" or
   by the command:

	rcjonas start

5. Browse the page http://localhost:8080 by your preferred web browser.

See the documentation in /usr/share/doc/packages/jonas/examples to
get more details about how to run all examples.


Have a lot of fun,                                                              
                                                                                
                                        Your SuSE Team                          
