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