Setting up the Unix/Linux/OS X Environment
The Fuse Message Broker administrative tool on Unix and Unix-like platforms uses a number of
environment variables. The environment variables are used to configure the broker's runtime
environment and configure the behavior of the administration tool. The tool can also call
one or more start up scripts to effect its execution.
In addition, it requires that your Java environment is properly set up.
Optionally, you may also want to add the administrative tool to the shell's path so
that you can use the tool from anywhere.
Table 2 describes the environment variables
used by the administration tool on Unix and Unix-like platforms.
Table 2. Unix Administration Tool Environment Variables
| Variable | Description |
|---|
ACTIVEMQ_HOME
| Specifies the directory where Fuse Message Broker is installed. |
ACTIVEMQ_CLASSPATH
| Specifies the classpath used by the current broker instance. |
ACTIVEMQ_SSL_OPTS
| Specifies Java properties required to support SSL/TLS protocols. See
???? for details. |
ACTIVEMQ_CONFIG_DIR
| Specifies the location of the broker's configuration directory. Default is
$ACTIVEMQ_HOME/conf. |
ACTIVEMQ_DATA_DIR
| Specifies the location of the broker's data directory. Default is
$ACTIVEMQ_HOME/data. |
ACTIVEMQ_PIDFILE
| Specifies the location of the file that holds the broker's process
ID(PID). |
ACTIVEMQ_USER
| Specifies the user as which the broker daemon runs. The user should be a user
with non-root privileges. Default value is a blank string, which implies that the
broker does not change user. |
ACTIVEMQ_OPTS_MEMORY
| Specifies the JVM memory configuration. Default value is
-Xms256M -Xmx256M. |
ACTIVEMQ_QUEUEMANAGERURL
| Specifies the default connection URL that is used with the
browse task. Default value is
--amqurl tcp://localhost:61616. |
ACTIVEMQ_KILL_MAXSECONDS
| Specifies how many seconds the stop task will wait for an
orderly shutdown to complete before killing the broker using
SIGKILL. |
The default setting for ACTIVEMQ_OPTS_MEMORY is very low for
systems that run under a heavy load. You will want to change this value to provide the
broker with more memory.
On Unix, the administration tool can find and source a
startup script immediately before it executes the specified task.
The startup script is a shell script, which is normally used to set some environment
variables.
The administration tool looks for startup scripts in the following locations:
/etc/default/activemq
/home/User/.activemqrc
If both of these scripts exist, they will both be sourced by the
administration tool, in the order shown.
You must set the JAVA_HOME environment variable to the location of the
Java installation you want to use for running Fuse Message Broker.
