QPIDD(1) User Commands QPIDD(1)NAME
qpidd - the Qpid AMQP Message Broker Daemon
SYNOPSIS
qpidd [-p port] [--config config_file] [--data-dir directory]
DESCRIPTION
An AMQP message broker daemon that stores, routes and forwards messages
using the Advanced Message Queueing Protocol (AMQP).
OPTIONS
The options below are built-in to qpidd. Installing add-on modules pro‐
vides additional options. To see the full set of options available type
"qpidd --help"
Options may be specified via command line, environment variable or con‐
figuration file. See FILES and ENVIRONMENT below for details.
Options
-h [ --help ]
Displays the help message
-v [ --version ]
Displays version information
--config FILE
Reads configuration from FILE
--client-config FILE
Reads client configuration from FILE (for cluster interconnect)
Module options
--module-dir DIR
Load all shareable 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
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 (9)
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
-m [ --mgmt-enable ] yes|no (1)
Enable Management
--mgmt-qmf2 yes|no (1)
Enable broadcast of management information over QMF v2
--mgmt-qmf1 yes|no (1)
Enable broadcast of management information over QMF v1
--mgmt-pub-interval SECONDS (10)
Management Publish Interval
--queue-purge-interval SECONDS (600)
Interval between attempts to purge any expired messages from
queues
--auth yes|no (1)
Enable authentication, if disabled all incoming connections will
be trusted
--realm REALM (QPID)
Use the given realm when performing authentication
--default-queue-limit BYTES (104857600)
Default maximum size for queues (in bytes)
--tcp-nodelay
Set TCP_NODELAY on TCP connections
--require-encryption
Only accept connections that are encrypted
--known-hosts-url URL or 'none'
URL to send as 'known-hosts' to clients ('none' implies empty
list)
--sasl-config DIR
gets sasl config info from nonstandard location
--max-session-rate MESSAGES/S (0)
Sets the maximum message rate per session (0=unlimited)
--async-queue-events yes|no (0)
Set Queue Events async, used for services like replication
--default-flow-stop-threshold PERCENT (80)
Percent of queue's maximum capacity at which flow control is
activated.
--default-flow-resume-threshold PERCENT (70)
Percent of queue's maximum capacity at which flow control is
de-activated.
--default-event-threshold-ratio %age of limit (80)
The ratio of any specified queue limit at which an event will be
raised
--default-message-group GROUP-IDENTIFER (qpid.no-group)
Group identifier to assign to messages delivered to a message
group queue that do not contain an identifier.
--enable-timestamp yes|no (0)
Add current time to each received message.
--link-heartbeat-interval SECONDS (120)
Heartbeat interval for a federation link
--max-negotiate-time MILLISECONDS (10000)
Maximum time a connection can take to send the initial protocol
negotiation
Logging options
-t [ --trace ]
Enables all logging
--log-enable RULE (notice+)
Enables logging for selected levels and components. 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 fram‐
ing 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
--log-hires-timestamp yes|no (0)
Use unformatted hi-res timestamp in log messages
--log-prefix STRING
Prefix to append to all log messages
Logging sink options
--log-to-stderr yes|no (1)
Send logging output to stderr
--log-to-stdout yes|no (0)
Send logging output to stdout
--log-to-file FILE
Send log output to FILE.
--log-to-syslog yes|no (0)
Send logging output to syslog; customize using --syslog-name and
--syslog-facility
--syslog-name NAME (lt-qpidd)
Name to use in syslog messages
--syslog-facility LOG_XXX (LOG_DAEMON)
Facility to use in syslog messages
Daemon options
-d [ --daemon ]
Run as a daemon. Logs to syslog by default in this mode.
--transport TRANSPORT (tcp)
The transport for which to return the port
--pid-dir DIR
Directory where port-specific PID file is stored
-w [ --wait ] SECONDS (600)
Sets the maximum wait time to initialize the daemon. If the dae‐
mon 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
ACL Options
--acl-file FILE
The policy file to load from, loaded from data dir
--connection-limit-per-user N (0)
The maximum number of connections allowed per user. 0 implies no
limit.
--connection-limit-per-ip N (0)
The maximum number of connections allowed per host IP address. 0
implies no limit.
Queue Replication Options
--replication-exchange-name EXCHANGE
Exchange to which events for other queues are routed
--replication-exchange-type direct|topic etc (direct)
Type of exchange to use
--replication-queue QUEUE
Queue on which events for other queues are recorded
--replication-listener-name NAME (replicator)
name by which to register the replicating event listener
--create-replication-queue
if set, the replication will be created if it does not exist
FILES
/etc/qpidd.conf
Default configuration file.
Configuration file settings are over-ridden by command line or environ‐
ment variable settings. '--config <file>' or 'export QPID_CON‐
FIG=<file>' specifies an alternate file.
Each line is a name=value pair. Blank lines and lines beginning with #
are ignored. For example:
# My qpidd configuration file.
port=6000
max-connections=10
log-to-file=/tmp/qpidd.log
ENVIRONMENT
QPID_<option>
There is an environment variable for each option.
The environment variable is the option name in uppercase, prefixed with
QPID_ and '.' or '-' are replaced with '_'. Environment settings are
over-ridden by command line settings. For example:
export QPID_PORT=6000
export QPID_MAX_CONNECTIONS=10
export QPID_LOG_TO_FILE=/tmp/qpidd.log
AUTHOR
The Apache Qpid Project, dev@qpid.apache.org
REPORTING BUGS
Please report bugs to users@qpid.apache.org
qpidd (qpidc) version 0.14 September 2012 QPIDD(1)