qpidd(1) - Linux man page

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

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

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

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

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

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

Referenced By