1QPIDD(1) User Commands QPIDD(1)
2
6 qpidd - the Qpid AMQP Message Broker Daemon
7
10 qpidd [-p port] [--config config_file] [--data-dir directory]
11
14 An AMQP message broker daemon that stores, routes and forwards messages
15 using the Advanced Message Queueing Protocol (AMQP).
16
19 Options may be specified via command line, environment variable or con‐
20 figuration file. See FILES and ENVIRONMENT below for details.
21 Options
24 -h [ --help ]
25 Displays the help message
26 -v [ --version ]
28 Displays version information
29 --config FILE (/etc/qpidd.conf)
31 Reads configuration from FILE
32 Module options
35 --module-dir DIR (/usr/lib64/qpid/daemon) Load all shareable modules in
36 this directory
37 --load-module FILE
39 Specifies additional module(s) to be loaded
40 --no-module-dir
42 Don't load modules from module directory
43 Broker Options
46 --data-dir DIR (/builddir/.qpidd)
47 Directory to contain persistent data generated by the broker
48 --no-data-dir
50 Don't use a data directory. No persistent configuration will be
51 loaded or stored
52 -p [ --port ] PORT (5672)
54 Tells the broker to listen on PORT
55 --worker-threads N (17)
57 Sets the broker thread pool size
58 --max-connections N (500)
60 Sets the maximum allowed connections
61 --connection-backlog N (10)
63 Sets the connection backlog limit for the server socket
64 -m [ --mgmt-enable ] yes|no (1)
66 Enable Management
67 --mgmt-qmf2 yes|no (1)
69 Enable broadcast of management information over QMF v2
70 --mgmt-qmf1 yes|no (1)
72 Enable broadcast of management information over QMF v1
73 --mgmt-pub-interval SECONDS (10)
75 Management Publish Interval
76 --queue-purge-interval SECONDS (600)
78 Interval between attempts to purge any expired messages from
79 queues
80 --auth yes|no (1)
82 Enable authentication, if disabled all incoming connections will
83 be trusted
84 --realm REALM (QPID)
86 Use the given realm when performing authentication
87 --default-queue-limit BYTES (104857600) Default maximum size for
88 queues (in bytes)
89 --tcp-nodelay
91 Set TCP_NODELAY on TCP connections
92 --require-encryption
94 Only accept connections that are encrypted --known-hosts-url URL
95 or 'none' URL to send as 'known-hosts' to clients ('none'
96 implies empty list)
97 --sasl-config FILE
99 gets sasl config from nonstandard location
100 --max-session-rate MESSAGES/S (0)
102 Sets the maximum message rate per session (0=unlimited)
103 --async-queue-events yes|no (0)
105 Set Queue Events async, used for services like replication
106 --default-flow-stop-threshold %MESSAGES (80) Queue capacity
107 level at which flow control is activated.
108 --default-flow-resume-threshold %MESSAGES (70) Queue capacity
109 level at which flow control is de-activated.
110 --default-event-threshold-ratio %age of limit (80) The ratio of
111 any specified queue limit at which an event will be raised
112 Logging options
115 -t [ --trace ]
116 Enables all logging
117 --log-enable RULE (notice+)
119 Enables logging for selected levels and components. RULE is in
120 the form 'LEVEL[+][:PATTERN]' Levels are one of:
121 trace debug info notice warning error critical For example:
123 '--log-enable warning+' logs all warning, error and critical
124 messages. '--log-enable debug:framing' logs debug messages from
125 the framing namespace. This option can be used multiple times
126 --log-time yes|no (1)
128 Include time in log messages
129 --log-level yes|no (1)
131 Include severity level in log messages
132 --log-source yes|no (0)
134 Include source file:line in log messages
135 --log-thread yes|no (0)
137 Include thread ID in log messages
138 --log-function yes|no (0)
140 Include function signature in log messages
141 --log-prefix STRING
143 Prefix to append to all log messages
144 Logging sink options
147 --log-to-stderr yes|no (1)
148 Send logging output to stderr
149 --log-to-stdout yes|no (0)
151 Send logging output to stdout
152 --log-to-file FILE
154 Send log output to FILE.
155 --log-to-syslog yes|no (0)
157 Send logging output to syslog; customize using --syslog-name and
158 --syslog-facility
159 --syslog-name NAME (lt-qpidd)
161 Name to use in syslog messages --syslog-facility LOG_XXX
162 (LOG_DAEMON) Facility to use in syslog messages
163 Daemon options
166 -d [ --daemon ]
167 Run as a daemon. Logs to syslog by default in this mode.
168 --transport TRANSPORT (tcp)
170 The transport for which to return the port
171 --pid-dir DIR (/builddir/.qpidd)
173 Directory where port-specific PID file is stored
174 -w [ --wait ] SECONDS (600)
176 Sets the maximum wait time to initialize the daemon. If the dae‐
177 mon fails to initialize, prints an error and returns 1
178 -c [ --check ]
180 Prints the daemon's process ID to stdout and returns 0 if the
181 daemon is running, otherwise returns 1
182 -q [ --quit ]
184 Tells the daemon to shut down
185
188 /etc/qpidd.conf
189 Default configuration file.
190 Configuration file settings are over-ridden by command line or environ‐
192 ment variable settings. '--config <file>' or 'export QPID_CON‐
193 FIG=<file>' specifies an alternate file.
194 Each line is a name=value pair. Blank lines and lines beginning with #
196 are ignored. For example:
197 # My qpidd configuration file.
199 port=6000
200 max-connections=10
201 log-to-file=/tmp/qpidd.log
202
205 QPID_<option>
206 There is an environment variable for each option.
207 The environment variable is the option name in uppercase, prefixed with
209 QPID_ and '.' or '-' are replaced with '_'. Environment settings are
210 over-ridden by command line settings. For example:
211 export QPID_PORT=6000
213 export QPID_MAX_CONNECTIONS=10
214 export QPID_LOG_TO_FILE=/tmp/qpidd.log
215
218 The Apache Qpid Project, dev@qpid.apache.org
219
222 Please report bugs to users@qpid.apache.org
223qpidd (qpidc) version 0.10 May 2011 QPIDD(1)