THIS IS A TEST INSTANCE. ALL YOUR CHANGES WILL BE LOST!!!!
Running the C++ Broker
It is really simple, to run cmd line
./qpidd
to run as a daemon process
./qpidd --daemon
stopping the daemon
./qpidd --quit
Most common questions getting qpidd running
No data directory
The qpidd broker requires you to setup a data directory or specify --no-data-dir (see help for more details). Best
is to make sure that you have create a data directory for qpidd that the process has permissions to write to.
The default location is
/lib/var/qpidd
An alternate location can be set with --data-dir
Starting qpidd and it says the that process is already locked
Note that when qpidd starts it creates a lock file is data directory are being used. If you have a un-controlled exit, please mail
the trace from the core to the qpid-dev@i.a.o mailing list. To clear the lock run
./qpidd -q
It should also be noted that multiple brokers can be run on the same host. To do so set alternate data directories for each qpidd instance.
Using the conf file
In order to use the conf file, use the same options that are on the command line
./qpidd --help
but formated in the following way.
a.) remove the '--' from the beginning of the option.
b.) place a '=' between the option and the value.
c.) place one option per line.
Can I use any Language client with the C++ Broker
Yes, all the clients work with the C++ broker. The only restriction is that the client that matches the AMQP version needed to be used. When running the C++ broker, it is highly recommended to run AMQP 0-10.
Note that JMS also works with the C++ broker. For more details on using the Java client refer to these pages:
Slightly more complex configuration
The easiest way to get a full listing of the broker's options are to use the --help command, run it locally for the latest set of options. These options can then be set in the conf file for convenience (see above)
./qpidd --help
Usage: qpidd OPTIONS
Options:
-h [ --help ] Displays the help message
-v [ --version ] Displays version information
--config FILE (/etc/qpidd.conf) Reads configuration from FILE
Module options:
--module-dir DIR (/usr/lib/qpidd) Load all .so modules in this directory
--load-module FILE Specifies additional module(s) to be loaded
--no-module-dir Don't load modules from module directory
Broker Options:
--data-dir DIR (/var/lib/qpidd) Directory to contain persistent data generated by the broker
--no-data-dir Don't use a data directory. No persistent
configuration will be loaded or stored
-p [ --port ] PORT (5672) Tells the broker to listen on PORT
--worker-threads N (3) Sets the broker thread pool size
--max-connections N (500) Sets the maximum allowed connections
--connection-backlog N (10) Sets the connection backlog limit for the
server socket
--staging-threshold N (5000000) Stages messages over N bytes to disk
-m [ --mgmt-enable ] yes|no (1) Enable Management
--mgmt-pub-interval SECONDS (10) Management Publish Interval
--ack N (0) Send session.ack/solicit-ack at least every
N frames. 0 disables voluntary ack/solitict
-ack
Daemon options:
-d [ --daemon ] Run as a daemon.
-w [ --wait ] SECONDS (10) Sets the maximum wait time to initialize the
daemon. If the daemon fails to initialize, prints
an error and returns 1
-c [ --check ] Prints the daemon's process ID to stdout and
returns 0 if the daemon is running, otherwise
returns 1
-q [ --quit ] Tells the daemon to shut down
Logging options:
--log-output FILE (stderr) Send log output to FILE. FILE can be a file name
or one of the special values:
stderr, stdout, syslog
-t [ --trace ] Enables all logging
--log-enable RULE (error+) Enables logging for selected levels and component
s. RULE is in the form 'LEVEL+:PATTERN'
Levels are one of:
trace debug info notice warning error critical
For example:
'--log-enable warning+' logs all warning, error
and critical messages.
'--log-enable debug:framing' logs debug messages
from the framing namespace. This option can be
used multiple times
--log-time yes|no (1) Include time in log messages
--log-level yes|no (1) Include severity level in log messages
--log-source yes|no (0) Include source file:line in log messages
--log-thread yes|no (0) Include thread ID in log messages
--log-function yes|no (0) Include function signature in log messages
Loading extra modules
By default the broker will load all the modules in the module directory, however it will NOT display options for modules that are not loaded. So to see the options for extra modules loaded you need to load the module and then add the help command like this:
./qpidd --load-module libbdbstore.so --help
Usage: qpidd OPTIONS
Options:
-h [ --help ] Displays the help message
-v [ --version ] Displays version information
--config FILE (/etc/qpidd.conf) Reads configuration from FILE
/ .... non module options would be here ... /
Store Options:
--store-directory DIR Store directory location for persistence (overrides
--data-dir)
--store-async yes|no (1) Use async persistence storage - if store supports
it, enables AIO O_DIRECT.
--store-force yes|no (0) Force changing modes of store, will delete all
existing data if mode is changed. Be SURE you want
to do this!
--num-jfiles N (8) Number of files in persistence journal
--jfile-size-pgs N (24) Size of each journal file in multiples of read
pages (1 read page = 64kiB)