1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
|
<?xml version="1.0"?>
<!DOCTYPE entities [
<!ENTITY % entities SYSTEM "commonEntities.xml">
%entities;
]>
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
-->
<chapter id="Java-Broker-Getting-Started">
<title>Getting Started</title>
<para>This section describes how to start the Java Broker for the first time.</para>
<section role="h2" id="Java-Broker-Getting-Started-Starting">
<title>Starting/Stopping the Broker</title>
<para>To start the Broker, use the <command>qpid-server</command> script (UNIX) or <command>qpid-server.bat</command> (Windows)
provided within distribution.</para>
</section>
<section role="h2" id="Java-Broker-Getting-Started-Starting-Stopping-Windows">
<title>Starting/Stopping on Windows</title>
<para>Firstly change to the installation directory used during the <link linkend="Java-Broker-Installation-InstallationWindows">installation</link>
and ensure that the <link linkend="Java-Broker-Installation-InstallationWindows-SettingQPIDWORK">QPID_WORK environment variable is set</link>.</para>
<para>Now use the <command>qpid-server.bat</command> to start the server</para>
<programlisting><![CDATA[bin\qpid-server.bat]]></programlisting>
<para>Output similar to the following will be seen:</para>
<screen>[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</screen>
<para>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).</para>
<para>To stop the Broker, use Control-C or use the Shutdown MBean made from the <xref
linkend="Java-Broker-Configuring-And-Managing-JMX"/></para>
</section>
<section role="h2" id="Java-Broker-Getting-Started-Starting-Stopping-Unix">
<title>Starting/Stopping on Unix</title>
<para>Firstly change to the installation directory used during the <link linkend="Java-Broker-Installation-InstallationUnix">installation</link>
and ensure that the <link linkend="Java-Broker-Installation-InstallationUnix-SettingQPIDWORK">QPID_WORK environment variable is set</link>.</para>
<para>Now use the <command>qpid-server</command> script to start the server:</para>
<programlisting><![CDATA[bin\qpid-server]]></programlisting>
<para>Output similar to the following will be seen:</para>
<screen>[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</screen>
<para>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).</para>
<para>To stop the Broker, use Control-C from the controlling shell, use the
<command>bin/qpid.stop</command> script, or use <command>kill -TERM <pid></command> or
the Shutdown MBean from <xref linkend="Java-Broker-Configuring-And-Managing-JMX"/></para>
</section>
<section role="h2" id="Java-Broker-Getting-Started-LogFile">
<title>Log file</title>
<para>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
- <computeroutput>$QPID_WORK/log/qpid.log</computeroutput> (UNIX) and
<computeroutput>%QPID_WORK%\log\qpid.log</computeroutput> (Windows).</para>
<para>For details of how to control the logging, see <xref linkend="Java-Broker-Runtime-Log-Files"/></para>
</section>
<section role="h2" id="Java-Broker-Getting-Started-CommandLine">
<title>Using the command line</title>
<para>The Java Broker understands a number of command line options which may be used to override the configuration.</para>
<para>To see usage information for all command line options, use the option <option>--help</option></para>
<programlisting><![CDATA[bin/qpid-server --help]]></programlisting>
<screen><![CDATA[usage: Qpid [-b address>] [-c <file>] [--exclude-0-10 <port>] [--exclude-0-8 <port>] [--exclude-0-9 <port>] [--exclude-0-9-1
<port>] [--exclude-1-0 <port>] [-h] [--include-0-10 <port>] [--include-0-8 <port>] [--include-0-9 <port>] [--include-0-9-1
<port>] [--include-1-0 <port>] [--jmxconnectorport <port>] [-l <file>] [-m <port>] [-p <port>] [-s <port>] [-v] [-w <period>]
-b,--bind <address> bind to the specified address. Overrides any value in the config file
-c,--config <file> use given configuration file
--exclude-0-10 <port> 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 <port> 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 <port> 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 <port> 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 <port> 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 <port> 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 <port> 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 <port> 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 <port> 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 <port> accept AMQP1-0 connections on this port, overriding configuration to the contrary.
The specified port must be one specified on the command line
--jmxconnectorport <port> listen on the specified management (connector server) port. Overrides any
value in the config file
-l,--logconfig <file> 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 <port> listen on the specified management (registry server) port. Overrides any
value in the config file
-p,--port <port> listen on the specified port. Overrides any value in the config file
-s,--sslport <port> SSL port. Overrides any value in the config file
-v,--version print the version information and exit
-w,--logwatch <period> monitor the log file configuration file for changes. Units are seconds. Zero means
do not check for changes.]]></screen>
</section>
</chapter>
|
