You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@qpid.apache.org by kw...@apache.org on 2013/10/09 00:56:29 UTC
svn commit: r1530457 [3/30] - in /qpid/site:
docs/components/java-broker/book/ docs/components/java-broker/book/images/
input/components/java-broker/book/ input/components/java-broker/book/images/
Modified: qpid/site/docs/components/java-broker/book/Java-Broker-Configuring-And-Managing.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/components/java-broker/book/Java-Broker-Configuring-And-Managing.html?rev=1530457&r1=1530456&r2=1530457&view=diff
==============================================================================
--- qpid/site/docs/components/java-broker/book/Java-Broker-Configuring-And-Managing.html (original)
+++ qpid/site/docs/components/java-broker/book/Java-Broker-Configuring-And-Managing.html Tue Oct 8 22:56:26 2013
@@ -1,80 +1,199 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 9. Configuring And Managing</title><link rel="stylesheet" type="text/css" href="css/style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="up" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="prev" href="Java-Broker-Stores-HA-BDB-Store.html" title="8.5. High Availability BDB Store"><link rel="next" href="Java-Broker-Configuring-And-Managing-Web-Console.html" title="9.2. Web Console"></head><body><div class="container" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><DIV class="header"><DIV class="logo"><H1>Apache Qpidâ¢</H1><H2>Open Source AMQP Messaging</H2></DIV></DIV><DIV class="menu_box"><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Apache Qpid</H3><UL><LI><A href="http://qpid.apache.org/index.html">Home</A>
</LI><LI><A href="http://qpid.apache.org/download.html">Download</A></LI><LI><A href="http://qpid.apache.org/getting_started.html">Getting Started</A></LI><LI><A href="http://www.apache.org/licenses/">License</A></LI><LI><A href="https://cwiki.apache.org/qpid/faq.html">FAQ</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Documentation</H3><UL><LI><A href="http://qpid.apache.org/documentation.html#doc-release">Latest Release</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-trunk">Trunk</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-archives">Archive</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Community</H3><UL><LI><A href="http://qpid.apache.org/getting_involved.html">Getting Involved</A></LI><LI><A href="http://qpid.apache.org/source_repository.html">Source Repository</A></LI><LI><A href="http://qpid.apache
.org/mailing_lists.html">Mailing Lists</A></LI><LI><A href="https://cwiki.apache.org/qpid/">Wiki</A></LI><LI><A href="https://issues.apache.org/jira/browse/qpid">Issue Reporting</A></LI><LI><A href="http://qpid.apache.org/people.html">People</A></LI><LI><A href="http://qpid.apache.org/acknowledgements.html">Acknowledgements</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Developers</H3><UL><LI><A href="https://cwiki.apache.org/qpid/building.html">Building Qpid</A></LI><LI><A href="https://cwiki.apache.org/qpid/developer-pages.html">Developer Pages</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About AMQP</H3><UL><LI><A href="http://qpid.apache.org/amqp.html">What is AMQP?</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About Apache</H3><UL><LI><A href="http://www.apache.org">Hom
e</A></LI><LI><A href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</A></LI><LI><A href="http://www.apache.org/foundation/thanks.html">Thanks</A></LI><LI><A href="http://www.apache.org/security/">Security</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV></DIV><div class="main_text_area"><div class="main_text_area_top"></div><div class="main_text_area_body"><DIV class="breadcrumbs"><span class="breadcrumb-link"><a href="index.html">AMQP Messaging Broker (Java)</a></span> > <span class="breadcrumb-node">Configuring And Managing</span></DIV><div class="chapter" title="Chapter 9. Configuring And Managing"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Configuring-And-Managing"></a>Chapter 9. Configuring And Managing</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Config-Files">9.1. Confi
g Files</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Config-Files-Configuration">9.1.1. Configuration file</a></span></dt><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Config-Files-Management">9.1.2. Management Configuration</a></span></dt><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Config-Files-JMX-Management">9.1.3. JMX Management Configuration</a></span></dt><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Config-Files-SSL-keystore-configuration">9.1.4. Management SSL key store configuration</a></span></dt><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Config-Files-Web-Management">9.1.5. Web Management Configuration</a></spa
n></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing-Web-Console.html">9.2. Web Console</a></span></dt><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing-REST-API.html">9.3. REST API</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing-REST-API.html#Java-Broker-Configuring-And-Managing-REST-API-Overview">9.3.1. REST API Overview</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing-JMX.html">9.4. JMX</a></span></dt><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing-Other-Tooling.html">9.5. Other Tooling</a></span></dt></dl></div><div class="section" title="9.1. Config Files"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Configuring-And-Managing-Config-Files"></a>9.1. Config Files</h2></div></div></div><p>
- This section shows how to configure and manage broker.
- </p><div class="section" title="9.1.1. Configuration file"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Configuring-And-Managing-Config-Files-Configuration"></a>9.1.1. Configuration file</h3></div></div></div><p>Broker can be configured using XML configuration files. By default, broker is looking for configuration file at ${QPID_HOME}/etc/config.xml. The default configuration location can be overridden by specifying command line option <span class="emphasis"><em>-c <path to configuration></em></span> on broker start up.</p></div><div class="section" title="9.1.2. Management Configuration"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Configuring-And-Managing-Config-Files-Management"></a>9.1.2. Management Configuration</h3></div></div></div><p>
- Management interfaces can be configured in <span class="emphasis"><em>management</em></span> section of broker configuration file. The example of the management section is provided below.
- </p><div class="example"><a name="idp209616"></a><p class="title"><b>Example 9.1. Management configuration</b></p><div class="example-contents"><pre class="programlisting">
- <broker>
- ...
- <management>
- <enabled>true</enabled>
- <jmxport>
- <registryServer>8999</registryServer>
- </jmxport>
- <ssl>
- <enabled>false</enabled>
- <keyStorePath>${conf}/qpid.keystore</keyStorePath>
- <keyStorePassword>password</keyStorePassword>
- </ssl>
- <http>
- <enabled>true</enabled>
- </http>
- <https>
- <enabled>false</enabled>
- </https>
- </management>
- ...
- </broker></pre></div></div><br class="example-break"></div><div class="section" title="9.1.3. JMX Management Configuration"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Configuring-And-Managing-Config-Files-JMX-Management"></a>9.1.3. JMX Management Configuration</h3></div></div></div><p>
- JMX management can be configured in <span class="emphasis"><em>management</em></span> section of broker configuration file.
- </p><p>An <span class="emphasis"><em>enabled</em></span> element in the <span class="emphasis"><em>management</em></span> section is used to enable or disable the JMX interfaces. Setting it to <span class="emphasis"><em>true</em></span> causes the broker to start the management plugin if such is available on the broker classpath.</p><p>JMX management requires two ports which can be configured in <span class="emphasis"><em>jmxport</em></span> sub-section of <span class="emphasis"><em>management</em></span>:
- </p><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p>RMI port (8999 by default) can be configured in an element <span class="emphasis"><em>jmxport/registryServer</em></span></p></li><li class="listitem"><p>Connector port can be configured in an element <span class="emphasis"><em>jmxport/connectorServer</em></span>. If configuration element <span class="emphasis"><em>connectorServer</em></span> is not provided than the connector port defaults to <span class="emphasis"><em>100 + registryServer port</em></span>.</p></li></ul></div><p>
- </p><div class="example"><a name="idp226928"></a><p class="title"><b>Example 9.2. Enabling JMX Management and configuring JMX ports</b></p><div class="example-contents"><pre class="programlisting">
-<broker>
-...
-<management>
- <span class="emphasis"><em><enabled>true</enabled></em></span> <a name="java-broker-example-jmx-management-0"></a>(1)
- <jmxport>
- <span class="emphasis"><em><registryServer>7999</registryServer></em></span> <a name="java-broker-example-jmx-management-1"></a>(2)
- <span class="emphasis"><em><connectorServer>7998</connectorServer></em></span> <a name="java-broker-example-jmx-management-2"></a>(3)
- </jmxport>
-<management>
-...
-</broker></pre></div></div><br class="example-break"><p>In the snippet above the following is configured:</p><div class="calloutlist"><table border="0" summary="Callout list"><tr><td width="5%" valign="top" align="left"><p><a href="#java-broker-example-jmx-management-0">(1)</a> </p></td><td valign="top" align="left"><p>Enable JMX management</p></td></tr><tr><td width="5%" valign="top" align="left"><p><a href="#java-broker-example-jmx-management-1">(2)</a> </p></td><td valign="top" align="left"><p>Set RMI port to 7999</p></td></tr><tr><td width="5%" valign="top" align="left"><p><a href="#java-broker-example-jmx-management-2">(3)</a> </p></td><td valign="top" align="left"><p>Set connector port to 7998</p></td></tr></table></div><p>SSL can be configured to use on the connector port in the sub-section <span class="emphasis"><em>ssl</em></span> of the <span class="emphasis"><em>management</em></span> section. See <a class="xref" href="Java-Broker-Configuring-And-Managing.html#Java-
Broker-Configuring-And-Managing-Config-Files-SSL-keystore-configuration" title="9.1.4. Management SSL key store configuration">Section 9.1.4, âManagement SSL key store configurationâ</a> for details.</p><p>In order to use SSL with JMX management an element <span class="emphasis"><em>ssl/enabled</em></span> needs to be set to <span class="emphasis"><em>true</em></span>.</p></div><div class="section" title="9.1.4. Management SSL key store configuration"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Configuring-And-Managing-Config-Files-SSL-keystore-configuration"></a>9.1.4. Management SSL key store configuration</h3></div></div></div><p>
- This section describes how to configure the key store to use in SSL connections in both JMX and Web management interfaces.
- </p><p>The following examples demonstrates how to configure keystore for management</p><div class="example"><a name="idp459904"></a><p class="title"><b>Example 9.3. Management key store configuration</b></p><div class="example-contents"><pre class="programlisting">
-<broker>
-...
-<management>
-...
- <ssl>
- <enabled>true</enabled> <a name="java-broker-example-management-keystore-0"></a>(1)
- <keyStorePath>${conf}/qpid.keystore</keyStorePath> <a name="java-broker-example-management-keystore-1"></a>(2)
- <keyStorePassword>password</keyStorePassword> <a name="java-broker-example-management-keystore-2"></a>(3)
- </ssl>
-...
-<management>
-...
-</broker></pre></div></div><br class="example-break"><div class="calloutlist"><table border="0" summary="Callout list"><tr><td width="5%" valign="top" align="left"><p><a href="#java-broker-example-management-keystore-0">(1)</a> </p></td><td valign="top" align="left"><p>Enable SSL on JMX connector port only. This setting does not effect the web management interfaces.</p></td></tr><tr><td width="5%" valign="top" align="left"><p><a href="#java-broker-example-management-keystore-1">(2)</a> </p></td><td valign="top" align="left"><p>Set path to the key store file</p></td></tr><tr><td width="5%" valign="top" align="left"><p><a href="#java-broker-example-management-keystore-2">(3)</a> </p></td><td valign="top" align="left"><p>Set keystore password</p></td></tr></table></div></div><div class="section" title="9.1.5. Web Management Configuration"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Configuring-And-Managing-Config-Files-Web-Management"></a>9.1.5.Â
Web Management Configuration</h3></div></div></div><p>
- Web management can be configured in <span class="emphasis"><em>management</em></span> section of broker configuration file.
- </p><p>Sub-section <span class="emphasis"><em>http</em></span> is used to enable web management on http port.</p><p>Sub-section <span class="emphasis"><em>https</em></span> is used to enable web management on https port.</p><p>The following example shows how to configure http and https ports</p><div class="example"><a name="idp470928"></a><p class="title"><b>Example 9.4. Enabling web management</b></p><div class="example-contents"><pre class="programlisting">
-<broker>
-...
-<management>
-...
- <http>
- <enabled>true</enabled> <a name="java-broker-example-management-web-0"></a>(1)
- <port>9090</keyStorePath> <a name="java-broker-example-management-web-1"></a>(2)
- <basic-auth>false</basic-auth> <a name="java-broker-example-management-web-2"></a>(3)
- <sasl-auth>true</sasl-auth> <a name="java-broker-example-management-web-3"></a>(4)
- <session-timeout>600</session-timeout> <a name="java-broker-example-management-web-4"></a>(5)
- </http>
-
- <https>
- <enabled>true</enabled> <a name="java-broker-example-management-web-5"></a>(6)
- <port>9443</keyStorePath> <a name="java-broker-example-management-web-6"></a>(7)
- <sasl-auth>true</sasl-auth> <a name="java-broker-example-management-web-7"></a>(8)
- <basic-auth>true</basic-auth> <a name="java-broker-example-management-web-8"></a>(9)
- </https>
-...
-<management>
-...
-</broker></pre></div></div><br class="example-break"><div class="calloutlist"><table border="0" summary="Callout list"><tr><td width="5%" valign="top" align="left"><p><a href="#java-broker-example-management-web-0">(1)</a> </p></td><td valign="top" align="left"><p>Enable web management on http port. Default is true.</p></td></tr><tr><td width="5%" valign="top" align="left"><p><a href="#java-broker-example-management-web-1">(2)</a> </p></td><td valign="top" align="left"><p>Set web management http port to 9090. Default is 8080.</p></td></tr><tr><td width="5%" valign="top" align="left"><p><a href="#java-broker-example-management-web-2">(3)</a> </p></td><td valign="top" align="left"><p>Disable basic authentication on http port for REST services only. Default is false.</p></td></tr><tr><td width="5%" valign="top" align="left"><p><a href="#java-broker-example-management-web-3">(4)</a> </p></td><td valign="top" align="left"><p>Enable SASL authentication on http port for REST services
and web console. Default is true.</p></td></tr><tr><td width="5%" valign="top" align="left"><p><a href="#java-broker-example-management-web-4">(5)</a> </p></td><td valign="top" align="left"><p>Set session timeout in seconds. Default is 15 minutes.</p></td></tr><tr><td width="5%" valign="top" align="left"><p><a href="#java-broker-example-management-web-5">(6)</a> </p></td><td valign="top" align="left"><p>Enable web management on https port. Default is false.</p></td></tr><tr><td width="5%" valign="top" align="left"><p><a href="#java-broker-example-management-web-6">(7)</a> </p></td><td valign="top" align="left"><p>Set web management https port to 9443. Default is 8443.</p></td></tr><tr><td width="5%" valign="top" align="left"><p><a href="#java-broker-example-management-web-7">(8)</a> </p></td><td valign="top" align="left"><p>Enable SASL authentication on https port for REST services and web console. Default is true.</p></td></tr><tr><td width="5%" valign="top" align="left"><p><a hre
f="#java-broker-example-management-web-8">(9)</a> </p></td><td valign="top" align="left"><p>Enable basic authentication on https port for REST services only. Default is true.</p></td></tr></table></div><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Please configure the keystore to use with the https web management port. See <a class="xref" href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Config-Files-SSL-keystore-configuration" title="9.1.4. Management SSL key store configuration">Section 9.1.4, âManagement SSL key store configurationâ</a> for details.</p></div></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="Java-Broker-Stores-HA-BDB-Store.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="Java-Br
oker-Configuring-And-Managing-Web-Console.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">8.5. High Availability BDB Store </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 9.2. Web Console</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 5. Configuring And Managing</title><link rel="stylesheet" type="text/css" href="css/style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="up" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="prev" href="Java-Broker-Concepts-Other-Services.html" title="4.7. Other Services"><link rel="next" href="Java-Broker-Configuring-And-Managing-HTTP-Management.html" title="5.2. HTTP Management"></head><body><div class="container" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><DIV class="header"><DIV class="logo"><H1>Apache Qpidâ¢</H1><H2>Open Source AMQP Messaging</H2></DIV></DIV><DIV class="menu_box"><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Apache Qpid</H3><UL><LI><A href="http://qpid.apache.org/index.html">Home</A><
/LI><LI><A href="http://qpid.apache.org/download.html">Download</A></LI><LI><A href="http://qpid.apache.org/getting_started.html">Getting Started</A></LI><LI><A href="http://www.apache.org/licenses/">License</A></LI><LI><A href="https://cwiki.apache.org/qpid/faq.html">FAQ</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Documentation</H3><UL><LI><A href="http://qpid.apache.org/documentation.html#doc-release">Latest Release</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-trunk">Trunk</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-archives">Archive</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Community</H3><UL><LI><A href="http://qpid.apache.org/getting_involved.html">Getting Involved</A></LI><LI><A href="http://qpid.apache.org/source_repository.html">Source Repository</A></LI><LI><A href="http://qpid.apache.
org/mailing_lists.html">Mailing Lists</A></LI><LI><A href="https://cwiki.apache.org/qpid/">Wiki</A></LI><LI><A href="https://issues.apache.org/jira/browse/qpid">Issue Reporting</A></LI><LI><A href="http://qpid.apache.org/people.html">People</A></LI><LI><A href="http://qpid.apache.org/acknowledgements.html">Acknowledgements</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Developers</H3><UL><LI><A href="https://cwiki.apache.org/qpid/building.html">Building Qpid</A></LI><LI><A href="https://cwiki.apache.org/qpid/developer-pages.html">Developer Pages</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About AMQP</H3><UL><LI><A href="http://qpid.apache.org/amqp.html">What is AMQP?</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About Apache</H3><UL><LI><A href="http://www.apache.org">Home
</A></LI><LI><A href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</A></LI><LI><A href="http://www.apache.org/foundation/thanks.html">Thanks</A></LI><LI><A href="http://www.apache.org/security/">Security</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV></DIV><div class="main_text_area"><div class="main_text_area_top"></div><div class="main_text_area_body"><DIV class="breadcrumbs"><span class="breadcrumb-link"><a href="index.html">AMQP Messaging Broker (Java)</a></span> > <span class="breadcrumb-node">Configuring And Managing</span></DIV><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a name="Java-Broker-Configuring-And-Managing"></a>Chapter 5. Configuring And Managing</h1></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Store">5.1. Broker Configuration Store</a></span>
</dt><dd><dl><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Store-Introduction">5.1.1. Introduction</a></span></dt><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Store-Location">5.1.2. Configuration Store Location</a></span></dt><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Store-Initial-Config-Location">5.1.3. 'Initial Configuration' Location</a></span></dt><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Store-Create-Initial-Config">5.1.4. Creating an 'Initial Configuration' JSON File</a></span></dt><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Store-Overwrite-Config-Store">5.1.5. Ov
erwriting An Existing Configuration Store</a></span></dt><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Store-Type">5.1.6. Configuration Store Type</a></span></dt><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Store-Configuration-Properties">5.1.7. Customising Configuration using Configuration Properties</a></span></dt><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Initial-Config-Example">5.1.8. Example of JSON 'Initial Configuration'</a></span></dt><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Attributes-Configuring">5.1.9. Configuring Broker Attributes</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing-HTTP-Management.html">5.2. HTTP Management</a></span>
</dt><dd><dl><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing-HTTP-Management.html#Java-Broker-Configuring-And-Managing-HTTP-Management-Introduction">5.2.1. Introduction</a></span></dt><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing-HTTP-Management.html#Java-Broker-Configuring-And-Managing-Web-Console">5.2.2. Web Management Console</a></span></dt><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing-HTTP-Management.html#Java-Broker-Configuring-And-Managing-HTTP-Management-Plugin-Configuration">5.2.3. HTTP Management Plugin Configuration</a></span></dt><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing-HTTP-Management.html#Java-Broker-Configuring-And-Managing-REST-API">5.2.4. REST API</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing-JMX-Management.html">5.3. JMX Management</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Configurin
g-And-Managing-JMX-Management.html#Java-Broker-Configuring-And-Managing-JMX-Management-Introduction">5.3.1. Introduction</a></span></dt><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing-JMX-Management.html#Java-Broker-Configuring-And-Managing-JMX-Management-Plugin-Configuration">5.3.2. JMX Management Plugin Configuration</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing-Other-Tooling.html">5.4. Other Tooling</a></span></dt></dl></div><div class="section"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Configuring-And-Managing-Configuration-Store"></a>5.1. Broker Configuration Store</h2></div></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Configuring-And-Managing-Configuration-Store-Introduction"></a>5.1.1. Introduction</h3></div></div></div><p>
+ The Broker supports configuration of all its primary components via its HTTP management interface, using
+ the <a class="link" href="Java-Broker-Configuring-And-Managing-HTTP-Management.html#Java-Broker-Configuring-And-Managing-Web-Console" title="5.2.2. Web Management Console">Web Management Console</a>.
+ </p><p>
+ The configuration for each component is stored as an entry in the broker configuration store, currently implemented as either a JSON file
+ which persists changes to disk, or an in-memory store which does not.
+ The following components configuration is stored there:
+ </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Broker</p></li><li class="listitem"><p>Virtual Host</p></li><li class="listitem"><p>Port</p></li><li class="listitem"><p>Authentication Provider</p></li><li class="listitem"><p>Access Control Provider</p></li><li class="listitem"><p>Group Provider</p></li><li class="listitem"><p>Key store</p></li><li class="listitem"><p>Trust store</p></li><li class="listitem"><p>Plugin</p></li></ul></div><p>
+ </p><p>
+ Broker startup involves two configuration related items, the 'Initial Configuration' and the Configuration Store. When the broker is started,
+ if a Configuration Store does not exist at the current <a class="link" href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Store-Location" title="5.1.2. Configuration Store Location">store location</a>
+ then one will be initialised with the current <a class="link" href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Store-Initial-Config-Location" title="5.1.3. 'Initial Configuration' Location">'Initial Configuration'</a>.
+ Unless otherwise requested to <a class="link" href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Store-Location" title="5.1.2. Configuration Store Location">overwrite the configuration store</a> then
+ subsequent broker restarts will use the existing configuration store and ignore the contents of the 'Initial Configuration'.
+ </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Configuring-And-Managing-Configuration-Store-Location"></a>5.1.2. Configuration Store Location</h3></div></div></div><p>
+ The broker will default to using <a class="link" href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Store-Configuration-Properties" title="5.1.7. Customising Configuration using Configuration Properties">${qpid.work_dir}</a>/config.json
+ as the path for its configuration store unless otherwise instructed.
+ </p><p>
+ The command line argument <span class="emphasis"><em>-sp</em></span> (or <span class="emphasis"><em>--store-path</em></span>) can optionally be used to specify a different
+ relative or absolute path to use for the broker configuration store:
+ </p><pre class="screen">
+$ ./qpid-server -sp ./my-broker-configuration.json
+ </pre><p>
+ If no configuration store exists at the specified/defaulted location when the broker starts then one will be initialised using the current
+ <a class="link" href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Store-Initial-Config-Location" title="5.1.3. 'Initial Configuration' Location">'Initial Configuration'</a>.
+ </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Configuring-And-Managing-Configuration-Store-Initial-Config-Location"></a>5.1.3. 'Initial Configuration' Location</h3></div></div></div><p>
+ The 'Initial Configuration' JSON file is used when initialiasing new broker configuration stores. The broker will default to using
+ an internal file within its jar unless otherwise instructed.
+ </p><p>
+ The command line argument <span class="emphasis"><em>-icp </em></span> (or <span class="emphasis"><em>--initial-config-path</em></span>) can be used to override the brokers
+ internal file and supply a <a class="link" href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Store-Create-Initial-Config" title="5.1.4. Creating an 'Initial Configuration' JSON File">user-created one</a>:</p><pre class="screen">
+$ ./qpid-server -icp ./my-initial-configuration.json
+ </pre><p>
+ If a Configuration Store already exists at the current <a class="link" href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Store-Location" title="5.1.2. Configuration Store Location">store location</a>
+ then the current 'Initial Configuration' will be ignored unless otherwise requested to <a class="link" href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Store-Location" title="5.1.2. Configuration Store Location">overwrite the configuration store</a>
+ </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Configuring-And-Managing-Configuration-Store-Create-Initial-Config"></a>5.1.4. Creating an 'Initial Configuration' JSON File</h3></div></div></div><p>
+ It is possible to have the broker output its default internal 'Initial Configuration' file to disk using the command line argument
+ <span class="emphasis"><em>-cic</em></span> (or <span class="emphasis"><em>--create-initial-config</em></span>). If the option is used without providing a path, a file called
+ <span class="emphasis"><em>initial-config.json</em></span> will be created in the current directory, or alternatively the file can be created at a specified location:
+ </p><pre class="screen">
+$ ./qpid-server -cic ./initial-config.json
+ </pre><p>
+ The 'Initial Configuration' JSON file shares a common format with the brokers JSON Configuration Store implementation, so it is
+ possible to use a brokers Configuration Store output as an initial configuration. Typically 'Initial Configuration' files would
+ not to contain IDs for the configured entities, so that IDs will be generated when the configuration store is initialised and
+ prevent use of the same IDs across multiple brokers, however it may prove useful to include IDs if using the Memory
+ <a class="link" href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Store-Type" title="5.1.6. Configuration Store Type">Configuration Store Type</a>.
+ </p><p>
+ It can be useful to use <a class="link" href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Store-Configuration-Properties" title="5.1.7. Customising Configuration using Configuration Properties">Configuration Properties</a>
+ within 'Initial Configuration' files to allow a degree of customisation with an otherwise fixed file.
+ </p><p>
+ For an example file, see <a class="xref" href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Initial-Config-Example" title="5.1.8. Example of JSON 'Initial Configuration'">Section 5.1.8, âExample of JSON 'Initial Configuration'â</a>
+ </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Configuring-And-Managing-Configuration-Store-Overwrite-Config-Store"></a>5.1.5. Overwriting An Existing Configuration Store</h3></div></div></div><p>
+ If a configuration store already exists at the configured <a class="link" href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Store-Location" title="5.1.2. Configuration Store Location">store location</a>
+ then it is used and the current <a class="link" href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Store-Initial-Config-Location" title="5.1.3. 'Initial Configuration' Location">'Initial Configuration'</a>
+ is ignored.
+ </p><p>
+ The command line argument <span class="emphasis"><em>-os</em></span> (or <span class="emphasis"><em>--overwrite-store</em></span>) can be used to
+ force a new broker configuration store to be initialised from the current 'Initial Configuration' even if one exists:
+ </p><pre class="screen">
+$ ./qpid-server -os -icp ./my-initial-configuration.json
+ </pre><p>
+ This can be useful to effectively play configuration into one or more broker to pre-configure them to a particular state, or alternatively
+ to ensure a broker is always started with a fixed configuration. In the latter case, use of the Memory
+ <a class="link" href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Store-Type" title="5.1.6. Configuration Store Type">Configuration Store Type</a> may also be useful.
+ </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Configuring-And-Managing-Configuration-Store-Type"></a>5.1.6. Configuration Store Type</h3></div></div></div><p>
+ There are currently two implementations of the pluggable Broker Configuration Store, the default one which persists content to disk
+ in a JSON file, and another which operates only in-memory and so does not retain changes across broker restarts and always relies on the current
+ <a class="link" href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Store-Initial-Config-Location" title="5.1.3. 'Initial Configuration' Location">'Initial Configuration'</a>
+ to provide the configuration to start the broker with.
+ </p><p>
+ The command line argument <span class="emphasis"><em>-st</em></span> (or <span class="emphasis"><em>--store-type</em></span>) can be used to override the
+ default <span class="emphasis"><em>json</em></span>)configuration store type and allow choosing an alterative, such as <span class="emphasis"><em>memory</em></span>)
+ </p><pre class="screen">
+$ ./qpid-server -st memory
+ </pre><p>
+ This can be useful when running tests, or always wishing to start the broker with the same
+ <a class="link" href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Store-Initial-Config-Location" title="5.1.3. 'Initial Configuration' Location">'Initial Configuration'</a>
+ </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Configuring-And-Managing-Configuration-Store-Configuration-Properties"></a>5.1.7. Customising Configuration using Configuration Properties</h3></div></div></div><p>
+ It is posible for 'Initial Configuration' (and Configuration Store) files to contain ${properties} that can be resolved to
+ String values at startup, allowing a degree of customisation using a fixed file. Configuration Property values can be set
+ either via Java System Properties, or by specifying ConfigurationPproperties on the broker command line.
+ If both are defined, System Property values take precedence.
+ </p><p>
+ The broker has the following set of core configuration properties, with the indicated default values if not otherwise configured by the user:
+ </p><div class="table"><a name="idp7233328"></a><p class="title"><b>Table 5.1. Base Configuration Properties</b></p><div class="table-contents"><table summary="Base Configuration Properties" border="1"><colgroup><col><col><col></colgroup><thead><tr><th>
+ Name
+ </th><th>
+ Description
+ </th><th>
+ Value
+ </th></tr></thead><tbody><tr><td>
+ qpid.amqp_port
+ </td><td>
+ Port number used for the brokers default AMQP messaging port
+ </td><td>
+ "5672"
+ </td></tr><tr><td>
+ qpid.http_port
+ </td><td>
+ Port number used for the brokers default HTTP management port
+ </td><td>
+ "8080"
+ </td></tr><tr><td>
+ qpid.rmi_port
+ </td><td>
+ Port number used for the brokers default RMI Registry port, to
+ advertise the JMX ConnectorServer.
+ </td><td>
+ "8999"
+ </td></tr><tr><td>
+ qpid.jmx_port
+ </td><td>
+ Port number used for the brokers default JMX port
+ </td><td>
+ "9099"
+ </td></tr><tr><td>
+ qpid.home_dir
+ </td><td>
+ Location of the broker installation directory, which contains
+ the 'lib' directory and the 'etc' directory often used to store
+ files such as group and ACL files.
+ </td><td>
+ Defaults to the value set into the QPID_HOME system property if it
+ is set, or remains unset otherwise unless configured by the user.
+ </td></tr><tr><td>
+ qpid.work_dir
+ </td><td>
+ Location of the broker working directory, which might contain
+ the persistent message store and broker configuration store files.
+ </td><td>
+ Defaults to the value set into the QPID_WORK system property if it
+ is set, or the 'work' subdirectory of the JVMs current working directory.
+ </td></tr></tbody></table></div></div><p><br class="table-break">
+ </p><p>
+ Use of these core properties can be seen in the <a class="link" href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Initial-Config-Example" title="5.1.8. Example of JSON 'Initial Configuration'">default 'Initial Configuration' example</a>.
+ </p><p>
+ Configuration Properties can be set on the command line using the <span class="emphasis"><em>-prop</em></span> (or <span class="emphasis"><em>--configuration-property</em></span>) command line argument:
+ </p><pre class="screen">
+$ ./qpid-server -prop "qpid.amqp_port=10000" -prop "qpid.http_port=10001"
+ </pre><p>
+ In the example above, property used to set the port number of the default AMQP port is specified with the value 10000, overriding the default value of 5672, and similarly the vlaue 10001 is used to override the default HTTP port number of 8080.
+ When using the 'Initial Configuration' to initialise a new Configuration Store (either at first broker startup, when requesting to
+ <a class="link" href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Store-Location" title="5.1.2. Configuration Store Location">overwrite the configuration store</a>) these new values will be used for the port numbers instead.
+ </p><p>
+ NOTE: when saving the broker Configuration Store, either during initialisation when generating any required IDs for the 'Initial Configuration', or when required following user-prompted change via the managmenet interface, values are
+ stored in their resolved state. As such, if a Configuration Store already exists when the broker is started, it is likely that setting a Configuration Property to a value different than it was previously set could have no effect.
+ </p><p>
+ NOTE: When running the broker on Windows and starting it via the qpid-server.bat file, the "name=value" argument MUST be quoted.
+ </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Configuring-And-Managing-Configuration-Initial-Config-Example"></a>5.1.8. Example of JSON 'Initial Configuration'</h3></div></div></div><p>
+ An example of the default 'Initial Configuration' JSON file the broker uses is provided below:</p><div class="example"><a name="idp7256368"></a><p class="title"><b>Example 5.1. JSON 'Initial configuration' File</b></p><div class="example-contents"><pre class="programlisting">
+{
+ "name" : "Broker",
+ "defaultVirtualHost" : "default",
+ "modelVersion" : "1.0",
+ "storeVersion" : 1,
+ "authenticationproviders" : [ {
+ "name" : "passwordFile",
+ "path" : "${qpid.work_dir}/etc/passwd",
+ "type" : "PlainPasswordFile"
+ } ],
+ "ports" : [ {
+ "authenticationProvider" : "passwordFile",
+ "name" : "HTTP",
+ "port" : "8080",
+ "protocols" : [ "HTTP" ]
+ }, {
+ "authenticationProvider" : "passwordFile",
+ "name" : "JMX_CONNECTOR",
+ "port" : "9099",
+ "protocols" : [ "JMX_RMI" ]
+ }, {
+ "name" : "RMI_REGISTRY",
+ "port" : "8999",
+ "protocols" : [ "RMI" ]
+ }, {
+ "name" : "AMQP",
+ "port" : "5672"
+ } ],
+ "virtualhosts" : [ {
+ "name" : "default",
+ "storePath" : "${qpid.work_dir}/derbystore/default",
+ "storeType" : "DERBY"
+ } ],
+ "plugins" : [ {
+ "name" : "jmxManagement",
+ "pluginType" : "MANAGEMENT-JMX"
+ }, {
+ "name" : "httpManagement",
+ "pluginType" : "MANAGEMENT-HTTP"
+ } ]
+}
+</pre><p>In the configuration above the following entries are stored:
+ </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Authentication Provider of type <span class="emphasis"><em>PlainPasswordFile</em></span> with name "passwordFile"</p></li><li class="listitem"><p>Four Port entries: "AMQP", "HTTP", "RMI_REGISTRY", "JMX_CONNECTOR"</p></li><li class="listitem"><p>Virtual Host with name "default" and DERBY message store type at location "${qpid.work_dir}/derbystore/default".</p></li><li class="listitem"><p>Two management plugins: "jmxManagement" of type "MANAGEMENT-JMX" and "httpManagement" of type "MANAGEMENT-HTTP".</p></li><li class="listitem"><p>Broker attributes are stored as a root entry.</p></li></ul></div><p>
+ </p></div></div><br class="example-break"></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Attributes-Configuring"></a>5.1.9. Configuring Broker Attributes</h3></div></div></div><p>The Broker Attributes can be configured using
+ <a class="link" href="Java-Broker-Configuring-And-Managing-HTTP-Management.html#Java-Broker-Configuring-And-Managing-REST-API" title="5.2.4. REST API">REST Management interfaces</a>
+ and <a class="link" href="Java-Broker-Configuring-And-Managing-HTTP-Management.html#Java-Broker-Configuring-And-Managing-Web-Console" title="5.2.2. Web Management Console">Web Management Console</a>.</p><p>The Broker attributes can be changed from Web Management Console by clicking on "Edit" button
+ on "Broker Attributes" panel from Broker tab.
+ </p></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="Java-Broker-Concepts-Other-Services.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="Java-Broker-Configuring-And-Managing-HTTP-Management.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">4.7. Other Services </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 5.2. HTTP Management</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>
Modified: qpid/site/docs/components/java-broker/book/Java-Broker-Exchanges.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/components/java-broker/book/Java-Broker-Exchanges.html?rev=1530457&r1=1530456&r2=1530457&view=diff
==============================================================================
--- qpid/site/docs/components/java-broker/book/Java-Broker-Exchanges.html (original)
+++ qpid/site/docs/components/java-broker/book/Java-Broker-Exchanges.html Tue Oct 8 22:56:26 2013
@@ -1 +1,10 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 6. Exchanges</title><link rel="stylesheet" type="text/css" href="css/style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="up" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="prev" href="Java-Broker-Virtual-Hosts.html" title="Chapter 5. Virtual Hosts"><link rel="next" href="Java-Broker-Queues.html" title="Chapter 7. Queues"></head><body><div class="container" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><DIV class="header"><DIV class="logo"><H1>Apache Qpidâ¢</H1><H2>Open Source AMQP Messaging</H2></DIV></DIV><DIV class="menu_box"><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Apache Qpid</H3><UL><LI><A href="http://qpid.apache.org/index.html">Home</A></LI><LI><A href="http://qpid.apache.org/download.ht
ml">Download</A></LI><LI><A href="http://qpid.apache.org/getting_started.html">Getting Started</A></LI><LI><A href="http://www.apache.org/licenses/">License</A></LI><LI><A href="https://cwiki.apache.org/qpid/faq.html">FAQ</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Documentation</H3><UL><LI><A href="http://qpid.apache.org/documentation.html#doc-release">Latest Release</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-trunk">Trunk</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-archives">Archive</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Community</H3><UL><LI><A href="http://qpid.apache.org/getting_involved.html">Getting Involved</A></LI><LI><A href="http://qpid.apache.org/source_repository.html">Source Repository</A></LI><LI><A href="http://qpid.apache.org/mailing_lists.html">Mailing Lists</A></LI><LI><
A href="https://cwiki.apache.org/qpid/">Wiki</A></LI><LI><A href="https://issues.apache.org/jira/browse/qpid">Issue Reporting</A></LI><LI><A href="http://qpid.apache.org/people.html">People</A></LI><LI><A href="http://qpid.apache.org/acknowledgements.html">Acknowledgements</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Developers</H3><UL><LI><A href="https://cwiki.apache.org/qpid/building.html">Building Qpid</A></LI><LI><A href="https://cwiki.apache.org/qpid/developer-pages.html">Developer Pages</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About AMQP</H3><UL><LI><A href="http://qpid.apache.org/amqp.html">What is AMQP?</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About Apache</H3><UL><LI><A href="http://www.apache.org">Home</A></LI><LI><A href="http://www.apache.org/foundat
ion/sponsorship.html">Sponsorship</A></LI><LI><A href="http://www.apache.org/foundation/thanks.html">Thanks</A></LI><LI><A href="http://www.apache.org/security/">Security</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV></DIV><div class="main_text_area"><div class="main_text_area_top"></div><div class="main_text_area_body"><DIV class="breadcrumbs"><span class="breadcrumb-link"><a href="index.html">AMQP Messaging Broker (Java)</a></span> > <span class="breadcrumb-node">Exchanges</span></DIV><div class="chapter" title="Chapter 6. Exchanges"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Exchanges"></a>Chapter 6. Exchanges</h2></div></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="Java-Broker-Virtual-Hosts.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="Java-Broker-Q
ueues.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 5. Virtual Hosts </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 7. Queues</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 8. Exchanges</title><link rel="stylesheet" type="text/css" href="css/style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="up" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="prev" href="Java-Broker-Virtual-Hosts.html" title="Chapter 7. Virtual Hosts"><link rel="next" href="Java-Broker-Queues.html" title="Chapter 9. Queues"></head><body><div class="container" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><DIV class="header"><DIV class="logo"><H1>Apache Qpidâ¢</H1><H2>Open Source AMQP Messaging</H2></DIV></DIV><DIV class="menu_box"><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Apache Qpid</H3><UL><LI><A href="http://qpid.apache.org/index.html">Home</A></LI><LI><A href="http://qpid.apache.org/download.ht
ml">Download</A></LI><LI><A href="http://qpid.apache.org/getting_started.html">Getting Started</A></LI><LI><A href="http://www.apache.org/licenses/">License</A></LI><LI><A href="https://cwiki.apache.org/qpid/faq.html">FAQ</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Documentation</H3><UL><LI><A href="http://qpid.apache.org/documentation.html#doc-release">Latest Release</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-trunk">Trunk</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-archives">Archive</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Community</H3><UL><LI><A href="http://qpid.apache.org/getting_involved.html">Getting Involved</A></LI><LI><A href="http://qpid.apache.org/source_repository.html">Source Repository</A></LI><LI><A href="http://qpid.apache.org/mailing_lists.html">Mailing Lists</A></LI><LI><
A href="https://cwiki.apache.org/qpid/">Wiki</A></LI><LI><A href="https://issues.apache.org/jira/browse/qpid">Issue Reporting</A></LI><LI><A href="http://qpid.apache.org/people.html">People</A></LI><LI><A href="http://qpid.apache.org/acknowledgements.html">Acknowledgements</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Developers</H3><UL><LI><A href="https://cwiki.apache.org/qpid/building.html">Building Qpid</A></LI><LI><A href="https://cwiki.apache.org/qpid/developer-pages.html">Developer Pages</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About AMQP</H3><UL><LI><A href="http://qpid.apache.org/amqp.html">What is AMQP?</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About Apache</H3><UL><LI><A href="http://www.apache.org">Home</A></LI><LI><A href="http://www.apache.org/foundat
ion/sponsorship.html">Sponsorship</A></LI><LI><A href="http://www.apache.org/foundation/thanks.html">Thanks</A></LI><LI><A href="http://www.apache.org/security/">Security</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV></DIV><div class="main_text_area"><div class="main_text_area_top"></div><div class="main_text_area_body"><DIV class="breadcrumbs"><span class="breadcrumb-link"><a href="index.html">AMQP Messaging Broker (Java)</a></span> > <span class="breadcrumb-node">Exchanges</span></DIV><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a name="Java-Broker-Exchanges"></a>Chapter 8. Exchanges</h1></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="section"><a href="Java-Broker-Exchanges.html#Java-Broker-Exchanges-Configuring">8.1. Configuring Virtual Host Exchanges</a></span></dt></dl></div><div class="section"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Exchanges-Configu
ring"></a>8.1. Configuring Virtual Host Exchanges</h2></div></div></div><p>The Virtual Host Exchanges can be configured using
+ <a class="link" href="Java-Broker-Configuring-And-Managing-HTTP-Management.html#Java-Broker-Configuring-And-Managing-REST-API" title="5.2.4. REST API">REST Management interfaces</a>,
+ <a class="link" href="Java-Broker-Configuring-And-Managing-HTTP-Management.html#Java-Broker-Configuring-And-Managing-Web-Console" title="5.2.2. Web Management Console">Web Management Console</a> and Virtual Host configuration file.</p><p>The following Exchange managing operations are available from Web Management Console:
+ </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>A new Exchange can be added by clicking on "Add Exchange" on the Virtual Host tab.</p></li><li class="listitem"><p>An existing Exchange details can be viewed the Exchange tab.
+ Exchange tab is shown after clicking on Exchange name in Broker object tree or by clicking on Exchange row in Exchanges grid on Virtual Host tab.</p></li><li class="listitem"><p>An existing Exchange can be deleted by clicking on "Delete Exchange" button
+ on Virtual Host tab or "Delete Exchange" button on the Exchange tab.</p></li><li class="listitem"><p>An existing Queue can be bound to the Exchange by clicking on "Add Binding" button
+ on the Exchange tab.</p></li><li class="listitem"><p>An existing Queue binding can be deleted from Exchange by clicking on "Delete Binding" button
+ on the Exchange tab.</p></li></ul></div><p>
+ </p><p>An example of configuring Exchanges in Virtual Host configuration file is provided
+ in <a class="xref" href="Java-Broker-Virtual-Host-Configuration-Exchange.html" title="14.8. Configuring Exchanges">Section 14.8, âConfiguring Exchangesâ</a>.</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="Java-Broker-Virtual-Hosts.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="Java-Broker-Queues.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 7. Virtual Hosts </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 9. Queues</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>
Modified: qpid/site/docs/components/java-broker/book/Java-Broker-Getting-Started-CommandLine.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/components/java-broker/book/Java-Broker-Getting-Started-CommandLine.html?rev=1530457&r1=1530456&r2=1530457&view=diff
==============================================================================
--- qpid/site/docs/components/java-broker/book/Java-Broker-Getting-Started-CommandLine.html (original)
+++ qpid/site/docs/components/java-broker/book/Java-Broker-Getting-Started-CommandLine.html Tue Oct 8 22:56:26 2013
@@ -1,37 +1,64 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>3.5. Using the command line</title><link rel="stylesheet" type="text/css" href="css/style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="up" href="Java-Broker-Getting-Started.html" title="Chapter 3. Getting Started"><link rel="prev" href="Java-Broker-Getting-Started-LogFile.html" title="3.4. Log file"><link rel="next" href="Java-Broker-Concepts.html" title="Chapter 4. Concepts"></head><body><div class="container" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><DIV class="header"><DIV class="logo"><H1>Apache Qpidâ¢</H1><H2>Open Source AMQP Messaging</H2></DIV></DIV><DIV class="menu_box"><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Apache Qpid</H3><UL><LI><A href="http://qpid.apache.org/index.html">Home</A></LI><LI><A href="http
://qpid.apache.org/download.html">Download</A></LI><LI><A href="http://qpid.apache.org/getting_started.html">Getting Started</A></LI><LI><A href="http://www.apache.org/licenses/">License</A></LI><LI><A href="https://cwiki.apache.org/qpid/faq.html">FAQ</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Documentation</H3><UL><LI><A href="http://qpid.apache.org/documentation.html#doc-release">Latest Release</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-trunk">Trunk</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-archives">Archive</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Community</H3><UL><LI><A href="http://qpid.apache.org/getting_involved.html">Getting Involved</A></LI><LI><A href="http://qpid.apache.org/source_repository.html">Source Repository</A></LI><LI><A href="http://qpid.apache.org/mailing_lists.htm
l">Mailing Lists</A></LI><LI><A href="https://cwiki.apache.org/qpid/">Wiki</A></LI><LI><A href="https://issues.apache.org/jira/browse/qpid">Issue Reporting</A></LI><LI><A href="http://qpid.apache.org/people.html">People</A></LI><LI><A href="http://qpid.apache.org/acknowledgements.html">Acknowledgements</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Developers</H3><UL><LI><A href="https://cwiki.apache.org/qpid/building.html">Building Qpid</A></LI><LI><A href="https://cwiki.apache.org/qpid/developer-pages.html">Developer Pages</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About AMQP</H3><UL><LI><A href="http://qpid.apache.org/amqp.html">What is AMQP?</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About Apache</H3><UL><LI><A href="http://www.apache.org">Home</A></LI><LI><A href=
"http://www.apache.org/foundation/sponsorship.html">Sponsorship</A></LI><LI><A href="http://www.apache.org/foundation/thanks.html">Thanks</A></LI><LI><A href="http://www.apache.org/security/">Security</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV></DIV><div class="main_text_area"><div class="main_text_area_top"></div><div class="main_text_area_body"><DIV class="breadcrumbs"><span class="breadcrumb-link"><a href="index.html">AMQP Messaging Broker (Java)</a></span> > <span class="breadcrumb-link"><a href="Java-Broker-Getting-Started.html">Getting Started</a></span> > <span class="breadcrumb-node">Using the command line</span></DIV><div class="section" title="3.5. Using the command line"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Getting-Started-CommandLine"></a>3.5. Using the command line</h2></div></div></div><p>The Java Broker understands a number of command line options which may be used to override the configuration.</p><p>To see us
age information for all command line options, use the option <code class="option">--help</code></p><pre class="programlisting">bin/qpid-server --help</pre><pre class="screen">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.</pre></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="Java-Broker-Getting-Started-LogFile.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="Java-Broker-Getting-Started.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="Java-Broker-Concepts.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">3.4. Log file </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 4. Concepts</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>3.5. Using the command line</title><link rel="stylesheet" type="text/css" href="css/style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="up" href="Java-Broker-Getting-Started.html" title="Chapter 3. Getting Started"><link rel="prev" href="Java-Broker-Getting-Started-LogFile.html" title="3.4. Log file"><link rel="next" href="Java-Broker-Concepts.html" title="Chapter 4. Concepts"></head><body><div class="container" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><DIV class="header"><DIV class="logo"><H1>Apache Qpidâ¢</H1><H2>Open Source AMQP Messaging</H2></DIV></DIV><DIV class="menu_box"><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Apache Qpid</H3><UL><LI><A href="http://qpid.apache.org/index.html">Home</A></LI><LI><A href="http
://qpid.apache.org/download.html">Download</A></LI><LI><A href="http://qpid.apache.org/getting_started.html">Getting Started</A></LI><LI><A href="http://www.apache.org/licenses/">License</A></LI><LI><A href="https://cwiki.apache.org/qpid/faq.html">FAQ</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Documentation</H3><UL><LI><A href="http://qpid.apache.org/documentation.html#doc-release">Latest Release</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-trunk">Trunk</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-archives">Archive</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Community</H3><UL><LI><A href="http://qpid.apache.org/getting_involved.html">Getting Involved</A></LI><LI><A href="http://qpid.apache.org/source_repository.html">Source Repository</A></LI><LI><A href="http://qpid.apache.org/mailing_lists.htm
l">Mailing Lists</A></LI><LI><A href="https://cwiki.apache.org/qpid/">Wiki</A></LI><LI><A href="https://issues.apache.org/jira/browse/qpid">Issue Reporting</A></LI><LI><A href="http://qpid.apache.org/people.html">People</A></LI><LI><A href="http://qpid.apache.org/acknowledgements.html">Acknowledgements</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Developers</H3><UL><LI><A href="https://cwiki.apache.org/qpid/building.html">Building Qpid</A></LI><LI><A href="https://cwiki.apache.org/qpid/developer-pages.html">Developer Pages</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About AMQP</H3><UL><LI><A href="http://qpid.apache.org/amqp.html">What is AMQP?</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About Apache</H3><UL><LI><A href="http://www.apache.org">Home</A></LI><LI><A href=
"http://www.apache.org/foundation/sponsorship.html">Sponsorship</A></LI><LI><A href="http://www.apache.org/foundation/thanks.html">Thanks</A></LI><LI><A href="http://www.apache.org/security/">Security</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV></DIV><div class="main_text_area"><div class="main_text_area_top"></div><div class="main_text_area_body"><DIV class="breadcrumbs"><span class="breadcrumb-link"><a href="index.html">AMQP Messaging Broker (Java)</a></span> > <span class="breadcrumb-link"><a href="Java-Broker-Getting-Started.html">Getting Started</a></span> > <span class="breadcrumb-node">Using the command line</span></DIV><div class="section"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Getting-Started-CommandLine"></a>3.5. Using the command line</h2></div></div></div><p>The Java Broker understands a number of command line options which may be used to customise the configuration.</p><p>
+ For additional details about the broker configuration and related command line arguments see
+ <a class="xref" href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Store" title="5.1. Broker Configuration Store">Section 5.1, âBroker Configuration Storeâ</a>.
+ The broker is fully configurable via its Web Management Console, for details of this see
+ <a class="xref" href="Java-Broker-Configuring-And-Managing-HTTP-Management.html#Java-Broker-Configuring-And-Managing-Web-Console" title="5.2.2. Web Management Console">Section 5.2.2, âWeb Management Consoleâ</a>.
+ </p><p>To see usage information for all command line options, use the <code class="option">--help</code> option</p><pre class="programlisting">bin/qpid-server --help</pre><pre class="screen">usage: Qpid [-cic <path>] [-h] [-icp <path>] [-l <file>] [-mm] [-mmhttp <port>]
+ [-mmjmx <port>] [-mmpass <password>] [-mmqv] [-mmrmi <port>] [-os]
+ [-sp <path>] [-st <type>] [-v] [-w <period>]
+ -cic <path> Create a copy of the initial config
+ --create-initial-config <path> file, either to an optionally specified
+ file path, or as initial-config.json
+ in the current directory
+
+ -h, Print this message
+ --help
+
+ -icp <path> Set the location of initial JSON config
+ --initial-config-path <path> to use when creating/overwriting a
+ broker configuration store
+
+ -l <file> Use the specified log4j xml configuration
+ --logconfig <file> file. By default looks for a file named
+ etc/log4j.xml in the same directory as
+ the configuration file
+
+ -mm Start broker in management mode,
+ --management-mode disabling the AMQP ports
+
+ -mmhttp <port> Override http management port in
+ --management-mode-http-port <port> management mode
+
+ -mmjmx Override jmx connector port in
+ --management-mode-jmx-connector-port <port> management mode
+
+ -mmpass <password> Set the password for the management
+ --management-mode-password <password> mode user mm_admin
+
+ -mmqv Make virtualhosts stay in the quiesced
+ --management-mode-quiesce-virtualhosts state during management mode.
+
+ -mmrmi <port> Override jmx rmi registry port in
+ --management-mode-rmi-registry-port <port> management mode
+
+ -os Overwrite the broker configuration store
+ --overwrite-store with the current initial configuration
+
+ -prop "<name=value>" Set a configuration property to use when
+ --config-property "<name=value>" resolving variables in the broker
+ configuration store, with format
+ "name=value"
+
+ -sp <path> Use given configuration store location
+ --store-path <path>
+
+ -st <type> Use given broker configuration store type
+ --store-type <type>
+
+ -v Print the version information and exit
+ --version
+
+ -w <period> Monitor the log file configuration file
+ --logwatch <period> for changes. Units are seconds. Zero
+ means do not check for changes.
+</pre></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="Java-Broker-Getting-Started-LogFile.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="Java-Broker-Getting-Started.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="Java-Broker-Concepts.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">3.4. Log file </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 4. Concepts</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>
Modified: qpid/site/docs/components/java-broker/book/Java-Broker-Getting-Started-LogFile.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/components/java-broker/book/Java-Broker-Getting-Started-LogFile.html?rev=1530457&r1=1530456&r2=1530457&view=diff
==============================================================================
--- qpid/site/docs/components/java-broker/book/Java-Broker-Getting-Started-LogFile.html (original)
+++ qpid/site/docs/components/java-broker/book/Java-Broker-Getting-Started-LogFile.html Tue Oct 8 22:56:26 2013
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>3.4. Log file</title><link rel="stylesheet" type="text/css" href="css/style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="up" href="Java-Broker-Getting-Started.html" title="Chapter 3. Getting Started"><link rel="prev" href="Java-Broker-Getting-Started-Starting-Stopping-Unix.html" title="3.3. Starting/Stopping on Unix"><link rel="next" href="Java-Broker-Getting-Started-CommandLine.html" title="3.5. Using the command line"></head><body><div class="container" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><DIV class="header"><DIV class="logo"><H1>Apache Qpidâ¢</H1><H2>Open Source AMQP Messaging</H2></DIV></DIV><DIV class="menu_box"><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Apache Qpid</H3><UL><LI><A href="http://qpid.apache.org/
index.html">Home</A></LI><LI><A href="http://qpid.apache.org/download.html">Download</A></LI><LI><A href="http://qpid.apache.org/getting_started.html">Getting Started</A></LI><LI><A href="http://www.apache.org/licenses/">License</A></LI><LI><A href="https://cwiki.apache.org/qpid/faq.html">FAQ</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Documentation</H3><UL><LI><A href="http://qpid.apache.org/documentation.html#doc-release">Latest Release</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-trunk">Trunk</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-archives">Archive</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Community</H3><UL><LI><A href="http://qpid.apache.org/getting_involved.html">Getting Involved</A></LI><LI><A href="http://qpid.apache.org/source_repository.html">Source Repository</A></LI><LI><A href
="http://qpid.apache.org/mailing_lists.html">Mailing Lists</A></LI><LI><A href="https://cwiki.apache.org/qpid/">Wiki</A></LI><LI><A href="https://issues.apache.org/jira/browse/qpid">Issue Reporting</A></LI><LI><A href="http://qpid.apache.org/people.html">People</A></LI><LI><A href="http://qpid.apache.org/acknowledgements.html">Acknowledgements</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Developers</H3><UL><LI><A href="https://cwiki.apache.org/qpid/building.html">Building Qpid</A></LI><LI><A href="https://cwiki.apache.org/qpid/developer-pages.html">Developer Pages</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About AMQP</H3><UL><LI><A href="http://qpid.apache.org/amqp.html">What is AMQP?</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About Apache</H3><UL><LI><A href="http:/
/www.apache.org">Home</A></LI><LI><A href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</A></LI><LI><A href="http://www.apache.org/foundation/thanks.html">Thanks</A></LI><LI><A href="http://www.apache.org/security/">Security</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV></DIV><div class="main_text_area"><div class="main_text_area_top"></div><div class="main_text_area_body"><DIV class="breadcrumbs"><span class="breadcrumb-link"><a href="index.html">AMQP Messaging Broker (Java)</a></span> > <span class="breadcrumb-link"><a href="Java-Broker-Getting-Started.html">Getting Started</a></span> > <span class="breadcrumb-node">Log file</span></DIV><div class="section" title="3.4. Log file"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Getting-Started-LogFile"></a>3.4. Log file</h2></div></div></div><p>The Java Broker writes a log file to record both details of its normal operation and any exceptional
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>3.4. Log file</title><link rel="stylesheet" type="text/css" href="css/style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="up" href="Java-Broker-Getting-Started.html" title="Chapter 3. Getting Started"><link rel="prev" href="Java-Broker-Getting-Started-Starting-Stopping-Unix.html" title="3.3. Starting/Stopping the broker on Unix"><link rel="next" href="Java-Broker-Getting-Started-CommandLine.html" title="3.5. Using the command line"></head><body><div class="container" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><DIV class="header"><DIV class="logo"><H1>Apache Qpidâ¢</H1><H2>Open Source AMQP Messaging</H2></DIV></DIV><DIV class="menu_box"><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Apache Qpid</H3><UL><LI><A href="http://qpid.
apache.org/index.html">Home</A></LI><LI><A href="http://qpid.apache.org/download.html">Download</A></LI><LI><A href="http://qpid.apache.org/getting_started.html">Getting Started</A></LI><LI><A href="http://www.apache.org/licenses/">License</A></LI><LI><A href="https://cwiki.apache.org/qpid/faq.html">FAQ</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Documentation</H3><UL><LI><A href="http://qpid.apache.org/documentation.html#doc-release">Latest Release</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-trunk">Trunk</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-archives">Archive</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Community</H3><UL><LI><A href="http://qpid.apache.org/getting_involved.html">Getting Involved</A></LI><LI><A href="http://qpid.apache.org/source_repository.html">Source Repository</A></LI>
<LI><A href="http://qpid.apache.org/mailing_lists.html">Mailing Lists</A></LI><LI><A href="https://cwiki.apache.org/qpid/">Wiki</A></LI><LI><A href="https://issues.apache.org/jira/browse/qpid">Issue Reporting</A></LI><LI><A href="http://qpid.apache.org/people.html">People</A></LI><LI><A href="http://qpid.apache.org/acknowledgements.html">Acknowledgements</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Developers</H3><UL><LI><A href="https://cwiki.apache.org/qpid/building.html">Building Qpid</A></LI><LI><A href="https://cwiki.apache.org/qpid/developer-pages.html">Developer Pages</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About AMQP</H3><UL><LI><A href="http://qpid.apache.org/amqp.html">What is AMQP?</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About Apache</H3><UL><LI><A h
ref="http://www.apache.org">Home</A></LI><LI><A href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</A></LI><LI><A href="http://www.apache.org/foundation/thanks.html">Thanks</A></LI><LI><A href="http://www.apache.org/security/">Security</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV></DIV><div class="main_text_area"><div class="main_text_area_top"></div><div class="main_text_area_body"><DIV class="breadcrumbs"><span class="breadcrumb-link"><a href="index.html">AMQP Messaging Broker (Java)</a></span> > <span class="breadcrumb-link"><a href="Java-Broker-Getting-Started.html">Getting Started</a></span> > <span class="breadcrumb-node">Log file</span></DIV><div class="section"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Getting-Started-LogFile"></a>3.4. Log file</h2></div></div></div><p>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
- <code class="computeroutput">$QPID_WORK/log/qpid.log</code> (UNIX) and
- <code class="computeroutput">%QPID_WORK%\log\qpid.log</code> (Windows).</p><p>For details of how to control the logging, see <a class="xref" href="Java-Broker-Runtime.html#Java-Broker-Runtime-Log-Files" title="11.1. Log Files">Section 11.1, âLog Filesâ</a></p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="Java-Broker-Getting-Started-Starting-Stopping-Unix.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="Java-Broker-Getting-Started.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="Java-Broker-Getting-Started-CommandLine.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">3.3. Starting/Stopping on Unix </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 3.5. Using the command line</td></tr></table></div><div class
="main_text_area_bottom"></div></div></div></body></html>
+ <code class="computeroutput">%QPID_WORK%\log\qpid.log</code> (Windows).</p><p>For details of how to control the logging, see <a class="xref" href="Java-Broker-Runtime.html#Java-Broker-Runtime-Log-Files" title="12.1. Log Files">Section 12.1, âLog Filesâ</a></p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="Java-Broker-Getting-Started-Starting-Stopping-Unix.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="Java-Broker-Getting-Started.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="Java-Broker-Getting-Started-CommandLine.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">3.3. Starting/Stopping the broker on Unix </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 3.5. Using the command line</td></tr></table></div
><div class="main_text_area_bottom"></div></div></div></body></html>
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@qpid.apache.org
For additional commands, e-mail: commits-help@qpid.apache.org