%entities; ]> This section describes how to start the Java Broker for the first time.

To start the Broker, use the qpid-server script (UNIX) or qpid-server.bat (Windows) provided within distribution.

Firstly change to the installation directory used during the installation and ensure that the QPID_WORK environment variable is set. Now use the qpid-server.bat to start the server Output similar to the following will be seen: [Broker] BRK-1006 : Using configuration : C:\qpid\qpid-broker-&qpidCurrentRelease;\etc\config.xml [Broker] BRK-1007 : Using logging configuration : C:\qpid\qpid-broker-&qpidCurrentRelease;\etc\log4j.xml [Broker] BRK-1001 : Startup : Version: &qpidCurrentRelease; Build: 1411386 [Broker] BRK-1010 : Platform : JVM : Sun Microsystems Inc. version: 1.6.0_24-b07 OS : Windows 7 version: 6.1 arch: amd64 [Broker] BRK-1011 : Maximum Memory : 1,069,416,448 bytes [Broker] MNG-1001 : Web Management Startup [Broker] MNG-1002 : Starting : HTTP : Listening on port 8080 [Broker] MNG-1004 : Web Management Ready [Broker] MNG-1001 : JMX Management Startup [Broker] MNG-1002 : Starting : RMI Registry : Listening on port 8999 [Broker] MNG-1002 : Starting : JMX RMIConnectorServer : Listening on port 9099 [Broker] MNG-1004 : JMX Management Ready [Broker] BRK-1002 : Starting : Listening on TCP port 5672 [Broker] BRK-1004 : Qpid Broker Ready The BRK-1004 message confirms that the Broker is ready for work. The MNG-1002 and BRK-1002 confirm the ports to which the Broker is listening (for HTTP/JMX management and AMQP respectively). To stop the Broker, use Control-C or use the Shutdown MBean made from the

Firstly change to the installation directory used during the installation and ensure that the QPID_WORK environment variable is set. Now use the qpid-server script to start the server: Output similar to the following will be seen: [Broker] BRK-1006 : Using configuration : /usr/local/qpid/qpid-broker-&qpidCurrentRelease;/etc/config.xml [Broker] BRK-1007 : Using logging configuration : /usr/local/qpid/qpid-broker-&qpidCurrentRelease;/etc/log4j.xml [Broker] BRK-1001 : Startup : Version: &qpidCurrentRelease; Build: 1411386 [Broker] BRK-1010 : Platform : JVM : Apple Inc. version: 1.6.0_35-b10-428-11M3811 OS : Mac OS X version: 10.8.2 arch: x86_64 [Broker] BRK-1011 : Maximum Memory : 1,070,399,488 bytes [Broker] MNG-1001 : Web Management Startup [Broker] MNG-1002 : Starting : HTTP : Listening on port 8080 [Broker] MNG-1004 : Web Management Ready [Broker] MNG-1001 : JMX Management Startup [Broker] MNG-1002 : Starting : RMI Registry : Listening on port 8999 [Broker] MNG-1002 : Starting : JMX RMIConnectorServer : Listening on port 9099 [Broker] MNG-1004 : JMX Management Ready [Broker] BRK-1002 : Starting : Listening on TCP port 5672 [Broker] BRK-1004 : Qpid Broker Ready The BRK-1004 message confirms that the Broker is ready for work. The MNG-1002 and BRK-1002 confirm the ports to which the Broker is listening (for HTTP/JMX management and AMQP respectively). To stop the Broker, use Control-C from the controlling shell, use the bin/qpid.stop script, or use kill -TERM <pid> or the Shutdown MBean from

The Java Broker writes a log file to record both details of its normal operation and any exceptional conditions. By default the log file is written within the log subdirectory beneath the work directory - $QPID_WORK/log/qpid.log (UNIX) and %QPID_WORK%\log\qpid.log (Windows). For details of how to control the logging, see

The Java Broker understands a number of command line options which may be used to override the configuration. To see usage information for all command line options, use the option --help ] [-c ] [--exclude-0-10 ] [--exclude-0-8 ] [--exclude-0-9 ] [--exclude-0-9-1 ] [--exclude-1-0 ] [-h] [--include-0-10 ] [--include-0-8 ] [--include-0-9 ] [--include-0-9-1 ] [--include-1-0 ] [--jmxconnectorport ] [-l ] [-m ] [-p ] [-s ] [-v] [-w ] -b,--bind

bind to the specified address. Overrides any value in the config file -c,--config use given configuration file --exclude-0-10 when listening on the specified port do not accept AMQP0-10 connections. The specified port must be one specified on the command line --exclude-0-8 when listening on the specified port do not accept AMQP0-8 connections. The specified port must be one specified on the command line --exclude-0-9 when listening on the specified port do not accept AMQP0-9 connections. The specified port must be one specified on the command line --exclude-0-9-1 when listening on the specified port do not accept AMQP0-9-1 connections. The specified port must be one specified on the command line --exclude-1-0 when listening on the specified port do not accept AMQP1-0 connections. The specified port must be one specified on the command line -h,--help print this message --include-0-10 accept AMQP0-10 connections on this port, overriding configuration to the contrary. The specified port must be one specified on the command line --include-0-8 accept AMQP0-8 connections on this port, overriding configuration to the contrary. The specified port must be one specified on the command line --include-0-9 accept AMQP0-9 connections on this port, overriding configuration to the contrary. The specified port must be one specified on the command line --include-0-9-1 accept AMQP0-9-1 connections on this port, overriding configuration to the contrary. The specified port must be one specified on the command line --include-1-0 accept AMQP1-0 connections on this port, overriding configuration to the contrary. The specified port must be one specified on the command line --jmxconnectorport listen on the specified management (connector server) port. Overrides any value in the config file -l,--logconfig use the specified log4j xml configuration file. By default looks for a file named etc/log4j.xml in the same directory as the configuration file -m,--jmxregistryport listen on the specified management (registry server) port. Overrides any value in the config file -p,--port listen on the specified port. Overrides any value in the config file -s,--sslport SSL port. Overrides any value in the config file -v,--version print the version information and exit -w,--logwatch monitor the log file configuration file for changes. Units are seconds. Zero means do not check for changes.]]>