Red Hat Application Server, Руководство пользователя

Страница: 30 / 296

22 Chapter 3. JOnAS Configuration
This copies all the required files and creates all the directories.
Note
The
build.xml
files provided with the JOnAS examples support
JONAS_BASE
. If this environment
variable is defined prior to building and installing the examples, the generated archives are installed
under the appropriate sub-directory of
$JONAS_BASE
. For example, the EJB-JAR files corresponding
to the sample examples of
$JONAS_ROOT/examples/src/
are installed in
$JONAS_BASE/ejbjars
.
3.2. Configuring the JOnAS Environment
3.2.1. The JOnAS Configuration File
The JOnAS server is configured via a configuration file named
jonas.properties
. It contains a list
of key/value pairs presented in the Java properties file format.
The default configuration is provided in
$JONAS_ROOT/conf/jonas.properties
(refer to
$JONAS_BASE/conf/jonas.properties
). This file, which holds all possible properties with
their default values, is mandatory. The JOnAS server looks for this file at start time in the
$JONAS_BASE/conf
directory (
$JONAS_ROOT/conf
if
$JONAS_BASE
is not defined).
Most of the properties are related to the JOnAS services that can be launched in the JOnAS server.
These properties are described in detail in Section 3.5 Configuring JOnAS Services .
The property
jonas.orb.port
is not related to any service. It identifies the port number on which
the remote objects receive calls. Its default value is
0
, which means that an anonymous port is chosen.
When the JOnAS server is behind a firewall, this property can be set to a specific port number.
When several JOnAS servers must run simultaneously, it is beneficial to set a different name for each
JOnAS server in order to administer these servers.
Also note that it is possible to define configuration properties on the command line:
java -D property=value
Use the
jonas check
command to review the JOnAS configuration state. (Refer to Section 6.1
jonas .)
3.2.2. Configuration Scripts
The JOnAS distribution contains the
$JONAS_ROOT/bin/unix/setenv
and
$JONAS_ROOT/bin/unix/config_env
configuration scripts.
These configuration scripts set useful environment variables for JAVA setup (
$JAVA
and
$JAVAC
).
They add
$JONAS_BASE/conf
to the
$CLASSPATH
if
$JONAS_BASE
is set, otherwise they add
$JONAS_ROOT/conf
. These scripts are called by almost all other scripts (
jclient
,
jonas
,
newbean
,
registry
,
GenIC
).
Therefore, when requiring the visibility of specific
.jar
files, the best practice is to update the
config_env
file. For example, to see some of the JDBC driver classes, one or more of the variables
IDB_CLASSES
,
ORACLE_CLASSES
, and
POSTGRE_CLASSES
must be updated.
Another way to place an additional
.jar
in the classpath of your JOnAS server is to insert it at the
end of the
config_env
file: