Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The Qpid scripts set the classpath and other flags required for the broker to run.

...

Configuration

We ship two example configuration files with the Java broker:

...

You can simply use one of these config files to get started, using the -c option to specify to the qpid-server script. See details next in the next section for more info on command line options.

Please visit our 3rd Party Libraries page to get more generic information on how to set up your chosen persistence implementation for Qpid.

...

  • First set the QPID_HOME variable to reflect the root of your installation. For example, if you have installed the broker package into a directory <homedir>/broker/qpid-xx then you should set the QPID_HOME variable to <homedir>/broker/qpid-xx.
  • You can also set the QPID_WORK variable in order to control the destination directory for the log dir into which broker logging is generated. For example, if you wish to set the working directory to be <homedir>/working you should set the QPID_WORK directory to be <homedir>/working.
  • Note that the QPID_WORK variable defaults to the current user's home directory if not set.
  • The config file One of the config files (persistent_config.xml or transient_config.xml) supplied in the etc directory one level below your root dir probably doesn't need modification and is automatically picked up by the startup scriptand should be passed in using -c and the path to your config file
  • Then run the qpid-server script from the root dir of your install. (The qpid-server script also supports cygwin environments.)

Command Line Arguments

You can get a list of all command line arguments by using the -h argument.In particular, -p overrides the port specified in the config file and -b overrides the bind interface (default is wildcard).

The following command line options are available:

Option

Long Option

Description

b

bind

Bind to the specified address overriding any value in the config file

c

config

Use the given configuration file

h

help

Prints list of options

l

logconfig

Use the specified log4j.xml file rather than that in the etc directory

p

port

Specify port to listen on. Overrides value in config file

v

version

Print version information and exit

w

logwatch

Specify interval for checking for logging config changes. Zero means no checking

For more detailed information on configuration, please see Qpid Design - Configuration

Checking the broker has started up

...