Appendix A. Environment Variables

None

The variable used to tell the Broker its installation directory. It must be an absolute path. This is used to determine the location of Qpid's dependency JARs and some configuration files.

Typically the value of this variable will look similar to c:\qpid\qpid-broker\\9.0.0 (Windows) or /usr/local/qpid/qpid-broker/9.0.0 (Unix). The installation prefix will differ from installation to installation.

If not set, a value for QPID_HOME is derived from the location of the script itself.

User's home directory

Used as the default root directory for any data written by the Broker. This is the default location for any message data written to persistent stores and the Broker's log file.

For example, QPID_WORK=/var/qpidwork.

None

This is the preferred mechanism for passing Java system properties to the Broker. The value must be a list of system properties each separate by a space. -Dname1=value1 -Dname2=value2.

This is the preferred mechanism for customising garbage collection behaviour. The value should contain valid garbage collection options(s) for the target JVM.

Refer to the JVM's documentation for details.

This is the preferred mechanism for customising the size of the JVM's heap and direct memory. The value should contain valid memory option(s) for the target JVM. Oracle JVMs understand -Xmx to specify a maximum heap size, -Xms an initial size, and -XX:MaxDirectMemorySize for the maximum amount of direct memory.

For example, QPID_JAVA_MEM="-Xmx6g -XX:MaxDirectMemorySize=12g" would set a maximum heap size of 6GB and 12GB of direct memory.

Refer to the JVM's documentation for details.

This is the preferred mechanism for passing any other JVM options. This variable is commonly used to pass options for diagnostic purposes, for instance to turn on verbose GC. -verbose:gc.

Refer to the JVM's documentation for details.