Red Hat DocumentationToggle FramesPrintFeedback

Setting up the Unix/Linux/OS X Environment

Overview

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.

Environment variables

Table 2 describes the environment variables used by the administration tool on Unix and Unix-like platforms.

Table 2. Unix Administration Tool Environment Variables

VariableDescription
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 ActiveMQ 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.

Startup scripts

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:

  1. /etc/default/activemq

  2. /home/User/.activemqrc

If both of these scripts exist, they will both be sourced by the administration tool, in the order shown.

Java environment

You must set the JAVA_HOME environment variable to the location of the Java installation you want to use for running Fuse Message Broker.

Comments powered by Disqus