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 1.2 describes the environment variables used by the administration tool on Unix and Unix-like platforms.
Table 1.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 Fuse Message Broker Security Guide 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 . |
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.