Scroll to navigation

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 provides additional options. To see the full set of options available type "qpidd --help"

Options may be specified via command line, environment variable or configuration file. See FILES and ENVIRONMENT below for details.

Options

Displays the help message
Displays version information
Reads configuration from FILE
Reads client configuration from FILE (for cluster interconnect)

Module options

Load all shareable modules in this directory
Specifies additional module(s) to be loaded
Don't load modules from module directory

Broker Options

Directory to contain persistent data generated by the broker
Don't use a data directory. No persistent configuration will be loaded or stored
Tells the broker to listen on PORT
Sets the broker thread pool size
Sets the maximum allowed connections
Sets the connection backlog limit for the server socket
Enable Management
Enable broadcast of management information over QMF v2
Enable broadcast of management information over QMF v1
Management Publish Interval
Interval between attempts to purge any expired messages from queues
Enable authentication, if disabled all incoming connections will be trusted
Use the given realm when performing authentication
Default maximum size for queues (in bytes)
Set TCP_NODELAY on TCP connections
Only accept connections that are encrypted
URL to send as 'known-hosts' to clients ('none' implies empty list)
gets sasl config info from nonstandard location
Sets the maximum message rate per session (0=unlimited)
Set Queue Events async, used for services like replication
Percent of queue's maximum capacity at which flow control is activated.
Percent of queue's maximum capacity at which flow control is de-activated.
The ratio of any specified queue limit at which an event will be raised
Group identifier to assign to messages delivered to a message group queue that do not contain an identifier.
Add current time to each received message.
Heartbeat interval for a federation link
Maximum time a connection can take to send the initial protocol negotiation

Logging options

Enables all logging
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 framing namespace. This option can be used multiple times
Include time in log messages
Include severity level in log messages
Include source file:line in log messages
Include thread ID in log messages
Include function signature in log messages
Use unformatted hi-res timestamp in log messages
Prefix to append to all log messages

Logging sink options

Send logging output to stderr
Send logging output to stdout
Send log output to FILE.
Send logging output to syslog; customize using --syslog-name and --syslog-facility
Name to use in syslog messages
Facility to use in syslog messages

Daemon options

Run as a daemon. Logs to syslog by default in this mode.
The transport for which to return the port
Directory where port-specific PID file is stored
Sets the maximum wait time to initialize the daemon. If the daemon fails to initialize, prints an error and returns 1
Prints the daemon's process ID to stdout and returns 0 if the daemon is running, otherwise returns 1
Tells the daemon to shut down

ACL Options

The policy file to load from, loaded from data dir
The maximum number of connections allowed per user. 0 implies no limit.
The maximum number of connections allowed per host IP address. 0 implies no limit.

Queue Replication Options

Exchange to which events for other queues are routed
Type of exchange to use
Queue on which events for other queues are recorded
name by which to register the replicating event listener
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 environment variable settings. '--config <file>' or 'export QPID_CONFIG=<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

September 2012 qpidd (qpidc) version 0.14