Red Hat Application Server, Manual

Page: 214 / 296

206 Chapter 26. JMS User’s Guide
In this case, the MOM will be launched automatically at server launching time (command
jonas
start
).
Note
To use the JMS resources from a distant host, the
hostname
property value in the default
a3servers.xml
configuration file must be changed from
localhost
to the actual host name. See
case 4 (Launching the MOM on another port number) for details on the JORAM configuration.
•
Launching the MOM in a separate JVM on the same host.
To launch JORAM MOM with its default options, use the command:
JmsServer
For other MOMs, use the proprietary command.
In this case, the JOnAS property
jonas.service.jms.collocated
must be set to
false
in the
jonas.properties
file:
jonas.service.jms.collocated false
•
Launching the MOM on another host.
The MOM can be launched on a separate host. In this case, the JOnAS server must be notified
that the MOM is running on another host via the JOnAS property
jonas.service.jms.url
in the
jonas.properties
file. For JORAM, its value should be the JORAM URL
joram:// host : port
where
host
is the host name, and
port
the default JORAM port number,
which is:
16010
jonas.service.jms.collocated false
jonas.service.jms.url
joram://host2:16010
For SwiftMQ, the value of the URL is similar to:
smqp://host:4001/timeout=10000
•
Launching the MOM on another port number (for JORAM)
Changing the default JORAM port number requires a JORAM-specific configuration operation
(modifying the
a3servers.xml
configuration file located in the directory where JORAM is ex-
plicitly launched). A default
a3servers.xml
file is provided in the
$JONAS_ROOT/conf
direc-
tory; this
a3servers.xml
file specifies that the MOM runs on the localhost using the JORAM
default port number.
To launch the MOM on another port number, change the args attribute of the service
fr.dyade.aaa.mom.ConnectionFactory
element in the
a3servers.xml
file and update the
jonas.service.jms.url
property in the
jonas.properties
file.
The default
a3servers.xml
file is located in
$JONAS_ROOT/conf
. To change the location of
this file, the system property
-Dfr.dyade.aaa.agent.A3CONF_DIR="your directory for
a3.xml
" must be passed.
To learn how to change other MOM configuration settings (distribution, multi-servers, and so on),
refer to the JORAM documentation on http://joram.objectweb.org.
Note
The MOM may be directly launched by the proprietary command. The command for JORAM is:
java -DTransaction=NullTransaction fr.dyade.aaa.agent.AgentServer 0 ./s0
This command corresponds to the default options used by the
JmsServer
command.
The JMS messages are not persistent when launching the MOM with this command. If persistent
messages are required, the
-DTransaction=NullTransaction
option should be replaced with
the
-DTransaction=ATransaction
option. Refer to the JORAM documentation for more details
about this command.