Author: kwall Date: Wed Oct 15 21:29:55 2014 New Revision: 1632181 URL: http://svn.apache.org/r1632181 Log: NO-JIRA: Republish trunk java-broker/jms-client-08 documentation
Added: qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Appendix-Queue-Alerts.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Backup-And-Recovery-Virtualhost-Node.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Backup-And-Recovery-Virtualhost.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Backup-And-Recovery.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Concepts-Broker.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Concepts-RemoteReplicationNodes.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Concepts-Virtualhost-Nodes.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Concepts-Virtualhosts.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Configuring-And-Managing-Configuration-Initial-Config-Example.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-High-Availability-Behaviour.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-High-Availability-CreatingGroup.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-High-Availability-NodeOperations.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-High-Availability-OverviewOfHA.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-High-Availability-Reset-Group-Infomational.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Initial-Configuration-Configuration-Properties.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Initial-Configuration-Create-Initial-Config.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Initial-Configuration-Initial-Config-Location.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Initial-Configuration-Location.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Initial-Configuration-Overwrite-Config-Store.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Initial-Configuration-Type.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Initial-Configuration.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Installation-OptionalDependencies.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Management-Channel-AMQP-Intrinstic.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Management-Channel-JMX.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Management-Channel-QMF.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Management-Channel-REST-API.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Management-Channel-Web-Console.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Management-Channel.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Management-Managing-Access-Control-Providers.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Management-Managing-Authentication-Providers.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Management-Managing-Broker.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Management-Managing-Entities-Matrix.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Management-Managing-Entities.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Management-Managing-Exchanges.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Management-Managing-Group-Providers.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Management-Managing-Keystores.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Management-Managing-Plugin-HTTP.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Management-Managing-Plugins-JMX.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Management-Managing-Ports.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Management-Managing-Queues.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Management-Managing-RemoteReplicationNodes.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Management-Managing-Truststores.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Management-Managing-Virtualhost-Nodes.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Management-Managing-Virtualhosts.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Miscellaneous-Installing-External-JDBC-Driver.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Miscellaneous-Installing-Oracle-BDB-JE.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Runtime-Background-Recovery.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Runtime-Flow-To-Disk.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Runtime-Message-Compression.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Security-Configuration-Encryption.html qpid/site/docs/releases/qpid-trunk/java-broker/book/images/Broker-MessageFlow.png (with props) qpid/site/docs/releases/qpid-trunk/java-broker/book/images/Broker-PortAuthFlow.png (with props) qpid/site/docs/releases/qpid-trunk/java-broker/book/images/HA-Create-1.png (with props) qpid/site/docs/releases/qpid-trunk/java-broker/book/images/HA-Create-2.png (with props) qpid/site/docs/releases/qpid-trunk/java-broker/book/images/HA-Create-3.png (with props) qpid/site/docs/releases/qpid-trunk/java-broker/book/images/HA-Overview.png (with props) qpid/site/docs/releases/qpid-trunk/java-broker/book/images/Management-Web-Add-Dialogue.png (with props) qpid/site/docs/releases/qpid-trunk/java-broker/book/images/Management-Web-Auth.png (with props) qpid/site/docs/releases/qpid-trunk/java-broker/book/images/Management-Web-ContextVar.png (with props) qpid/site/docs/releases/qpid-trunk/java-broker/book/images/Management-Web-Edit-Dialogue.png (with props) qpid/site/docs/releases/qpid-trunk/java-broker/book/images/Management-Web-Tab.png (with props) qpid/site/docs/releases/qpid-trunk/jms-client-0-8/book/JMS-Client-0-8-Appendix-JMS-Extensions-Binding.html qpid/site/docs/releases/qpid-trunk/jms-client-0-8/book/JMS-Client-0-8-Appendix-JMS-Extensions.html Modified: qpid/site/docs/releases/qpid-trunk/index.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Appendix-Environment-Variables.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Appendix-Operation-Logging.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Appendix-System-Properties.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Close-Connection-When-No-Route.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Concepts-Authentication-Providers.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Concepts-Exchanges.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Concepts-Other-Services.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Concepts-Ports.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Concepts-Queues.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Concepts.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Getting-Started-CommandLine.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Getting-Started-LogFile.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Getting-Started-Starting-Stopping-Unix.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Getting-Started-Starting-Stopping-Windows.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Getting-Started.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-High-Availability-Backup.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-High-Availability-ClientFailover.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-High-Availability-DiskSpace.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-High-Availability-JMXAPI.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-High-Availability-Network-Requirements.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-High-Availability-Security.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-High-Availability.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Installation-Download.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Installation-InstallationUnix.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Installation-InstallationWindows.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Installation-Prerequistes.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Installation.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Introduction.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Miscellaneous.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Runtime-Disk-Space-Management.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Runtime-Handling-Undeliverable-Messages.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Runtime-Producer-Transaction-Timeout.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Runtime.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Security-ACLs.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Security-Group-Providers.html qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Security.html qpid/site/docs/releases/qpid-trunk/java-broker/book/images/Broker-Model.png qpid/site/docs/releases/qpid-trunk/java-broker/book/images/Management-Web-Console.png qpid/site/docs/releases/qpid-trunk/java-broker/book/images/VirtualHost-Model.png qpid/site/docs/releases/qpid-trunk/java-broker/book/index.html qpid/site/docs/releases/qpid-trunk/java-broker/java-broker-book.pdf qpid/site/docs/releases/qpid-trunk/jms-client-0-8/book/JMS-Client-0-8-Appendix-Exceptions.html qpid/site/docs/releases/qpid-trunk/jms-client-0-8/book/JMS-Client-0-8-Appendix-Maven.html qpid/site/docs/releases/qpid-trunk/jms-client-0-8/book/JMS-Client-0-8-Binding-URL.html qpid/site/docs/releases/qpid-trunk/jms-client-0-8/book/JMS-Client-0-8-Client-Understanding-Connection.html qpid/site/docs/releases/qpid-trunk/jms-client-0-8/book/JMS-Client-0-8-Client-Understanding-ConnectionFactory.html qpid/site/docs/releases/qpid-trunk/jms-client-0-8/book/JMS-Client-0-8-Client-Understanding-MessageConsumer.html qpid/site/docs/releases/qpid-trunk/jms-client-0-8/book/JMS-Client-0-8-Client-Understanding-MessageProducer.html qpid/site/docs/releases/qpid-trunk/jms-client-0-8/book/JMS-Client-0-8-Client-Understanding-Session.html qpid/site/docs/releases/qpid-trunk/jms-client-0-8/book/JMS-Client-0-8-Client-Understanding.html qpid/site/docs/releases/qpid-trunk/jms-client-0-8/book/JMS-Client-0-8-Connection-URL.html qpid/site/docs/releases/qpid-trunk/jms-client-0-8/book/JMS-Client-0-8-Examples-PubSub.html qpid/site/docs/releases/qpid-trunk/jms-client-0-8/book/JMS-Client-0-8-Examples.html qpid/site/docs/releases/qpid-trunk/jms-client-0-8/book/JMS-Client-0-8-JMS-Getting-And-Dependencies.html qpid/site/docs/releases/qpid-trunk/jms-client-0-8/book/JMS-Client-0-8-System-Properties.html qpid/site/docs/releases/qpid-trunk/jms-client-0-8/book/index.html qpid/site/docs/releases/qpid-trunk/jms-client-0-8/jms_client08-book.pdf qpid/site/docs/releases/qpid-trunk/qpid-jms/examples/Hello.java qpid/site/docs/releases/qpid-trunk/qpid-jms/examples/Hello.java.html qpid/site/input/releases/qpid-trunk/index.md qpid/site/input/releases/qpid-trunk/qpid-jms/examples/Hello.java qpid/site/input/releases/qpid-trunk/qpid-jms/examples/Hello.java.html.in Modified: qpid/site/docs/releases/qpid-trunk/index.html URL: http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-trunk/index.html?rev=1632181&r1=1632180&r2=1632181&view=diff ============================================================================== --- qpid/site/docs/releases/qpid-trunk/index.html (original) +++ qpid/site/docs/releases/qpid-trunk/index.html Wed Oct 15 21:29:55 2014 @@ -117,7 +117,7 @@ incomplete. For a smoother experience, see the <a href="/releases/qpid-0.30/index.html">current stable release</a>.</p> -<p>This content was generated at 12:42 on Thursday, 10 July 2014.</p> +<p>This content was generated at 21:55 on Wednesday, 15 October 2014.</p> </div> @@ -166,8 +166,11 @@ incomplete. For a smoother experience, <ul> <li><a href="http://docs.oracle.com/javaee/1.4/api/javax/jms/package-summary.html">API reference</a></li> -<li>Using the Qpid JMS client with <a href="programming/book/QpidJMS.html">AMQP 0-10</a> (<a href="programming/programming-book.pdf">PDF</a>), or <a href="jms-client-0-8/book/index.html">AMQP 0-91..0-8</a> (<a href="jms-client-0-8/jms_client08-book.pdf">PDF</a>)</li> -<li>Examples for <a href="http://svn.apache.org/repos/asf/qpid/trunk/qpid/java/amqp-1-0-client-jms/example">AMQP 1.0</a>, <a href="qpid-jms/examples/index.html">AMQP 0-10</a>, or <a href="jms-client-0-8/book/JMS-Client-0-8-Examples.html">AMQP 0-91..0-8</a></li> +<li><a href="programming/book/QpidJMS.html">Using the Qpid JMS client (AMQP 0-10)</a> (<a href="programming/programming-book.pdf">PDF</a>)</li> +<li><a href="jms-client-0-8/book/index.html">Using the Qpid JMS client (AMQP 0-9-1, 0-9, 0-8)</a> (<a href="jms-client-0-8/jms_client08-book.pdf">PDF</a>)</li> +<li><a href="http://svn.apache.org/repos/asf/qpid/trunk/qpid/java/amqp-1-0-client-jms/example">Examples (AMQP 1.0)</a></li> +<li><a href="qpid-jms/examples/index.html">Examples (AMQP 0-10)</a> </li> +<li><a href="jms-client-0-8/book/JMS-Client-0-8-Examples.html">Examples (AMQP 0-9-1, 0-9, 0-8)</a></li> </ul> <h3 id="qpid-messaging-api">Qpid Messaging API</h3> Modified: qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Appendix-Environment-Variables.html URL: http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Appendix-Environment-Variables.html?rev=1632181&r1=1632180&r2=1632181&view=diff ============================================================================== --- qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Appendix-Environment-Variables.html (original) +++ qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Appendix-Environment-Variables.html Wed Oct 15 21:29:55 2014 @@ -107,17 +107,17 @@ <div id="-middle" class="panel"> <ul id="-path-navigation"><li><a href="/releases/index.html">Releases</a></li><li><a href="/releases/qpid-trunk/index.html">Qpid Trunk</a></li><li><a href="/releases/qpid-trunk/java-broker/book/index.html">AMQP Messaging Broker (Java)</a></li><li>Appendix A. Environment Variables</li></ul> - <div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">Appendix A. Environment Variables</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="Java-Broker-Miscellaneous.html">Prev</a> </td><th align="center" width="60%"> </th><td align="right" width="20%"> <a accesskey="n" href="Java-Broker-Appendix-System-Properties.html">Next</a></td></tr></table><hr /></div><div class="appendix"><div class="titlepage"><div><div><h1 class="title"><a id="Java-Broker-Appendix-Environment-Variables"></a>Appendix A. Environment Variables</h1></div></div></div><p>The following table describes the environment variables understood by the Qpid scripts + <div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">Appendix A. Environment Variables</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="Java-Broker-Backup-And-Recovery-Virtualhost.html">Prev</a> </td><th align="center" width="60%"> </th><td align="right" width="20%"> <a accesskey="n" href="Java-Broker-Appendix-System-Properties.html">Next</a></td></tr></table><hr /></div><div class="appendix"><div class="titlepage"><div><div><h1 class="title"><a id="Java-Broker-Appendix-Environment-Variables"></a>Appendix A. Environment Variables</h1></div></div></div><p>The following table describes the environment variables understood by the Qpid scripts contained within the <code class="literal">/bin</code> directory within the Broker distribution.</p><p>To take effect, these variables must be set within the shell (and exported - if using Unix) - before invoking the script.</p><div class="table"><a id="idm233114145008"></a><p class="title"><strong>Table A.1. Environment variables</strong></p><div class="table-contents"><table border="1" summary="Environment variables" width="100%"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Environment variable</th><th>Default</th><th>Purpose</th></tr></thead><tbody><tr><td><a id="Java-Broker-Appendix-Environment-Variables-Qpid-Home"></a>QPID_HOME</td><td> + before invoking the script.</p><div class="table"><a id="idp58720"></a><p class="title"><strong>Table A.1. Environment variables</strong></p><div class="table-contents"><table border="1" summary="Environment variables" width="100%"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Environment variable</th><th>Default</th><th>Purpose</th></tr></thead><tbody><tr><td><a id="Java-Broker-Appendix-Environment-Variables-Qpid-Home"></a>QPID_HOME</td><td> <p>None</p> </td><td> <p>The variable used to tell the Broker its installation directory. It must be an absolute path. This is used to determine the location of Qpid's dependency JARs and some configuration files.</p> <p>Typically the value of this variable will look similar to - <code class="literal">c:\qpid\qpid-broker-0.29</code> (Windows) or - <code class="literal">/usr/local/qpid/qpid-broker-0.29</code> (Unix). The + <code class="literal">c:\qpid\qpid-broker-0.32-SNAPSHOT</code> (Windows) or + <code class="literal">/usr/local/qpid/qpid-broker-0.32-SNAPSHOT</code> (Unix). The installation prefix will differ from installation to installation. </p> <p>If not set, a value for <code class="literal">QPID_HOME</code> is derived from the location of the script itself.</p> @@ -143,7 +143,7 @@ value should contain valid garbage collection options(s) for the target JVM.</p> <p>Refer to the JVM's documentation for details.</p> </td></tr><tr><td><a id="Java-Broker-Appendix-Environment-Variables-Qpid-Java-Mem"></a>QPID_JAVA_MEM</td><td> - <code class="literal">-Xmx1024m</code> + <code class="literal">-Xmx2g</code> </td><td> <p>This is the preferred mechanism for customising the size of the JVM's heap memory. The value should contain valid memory option(s) for the target JVM. Oracle JVMs @@ -157,7 +157,7 @@ commonly used to pass options for diagnostic purposes, for instance to turn on verbose GC. <code class="literal">-verbose:gc</code>.</p> <p>Refer to the JVM's documentation for details.</p> - </td></tr></tbody></table></div></div><br class="table-break" /></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="Java-Broker-Miscellaneous.html">Prev</a> </td><td align="center" width="20%"> </td><td align="right" width="40%"> <a accesskey="n" href="Java-Broker-Appendix-System-Properties.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Chapter 15. Miscellaneous </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td align="right" valign="top" width="40%"> Appendix B. System Properties</td></tr></table></div></div> + </td></tr></tbody></table></div></div><br class="table-break" /></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="Java-Broker-Backup-And-Recovery-Virtualhost.html">Prev</a> </td><td align="center" width="20%"> </td><td align="right" width="40%"> <a accesskey="n" href="Java-Broker-Appendix-System-Properties.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">11.3. Virtualhost </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td align="right" valign="top" width="40%"> Appendix B. System Properties</td></tr></table></div></div> <hr/> Modified: qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Appendix-Operation-Logging.html URL: http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Appendix-Operation-Logging.html?rev=1632181&r1=1632180&r2=1632181&view=diff ============================================================================== --- qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Appendix-Operation-Logging.html (original) +++ qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Appendix-Operation-Logging.html Wed Oct 15 21:29:55 2014 @@ -108,7 +108,7 @@ <div id="-middle" class="panel"> <ul id="-path-navigation"><li><a href="/releases/index.html">Releases</a></li><li><a href="/releases/qpid-trunk/index.html">Qpid Trunk</a></li><li><a href="/releases/qpid-trunk/java-broker/book/index.html">AMQP Messaging Broker (Java)</a></li><li>Appendix C. Operational Logging</li></ul> <div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">Appendix C. Operational Logging</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="Java-Broker-Appendix-System-Properties.html">Prev</a> </td><th align="center" width="60%"> </th><td align="right" width="20%"> <a accesskey="n" href="Java-Broker-Appendix-Queue-Alerts.html">Next</a></td></tr></table><hr /></div><div class="appendix"><div class="titlepage"><div><div><h1 class="title"><a id="Java-Broker-Appendix-Operation-Logging"></a>Appendix C. Operational Logging</h1></div></div></div><p>The Broker will, by default, produce structured log messages in response to key events in - the lives of objects within the Broker. These consise messages are designed to allow the user to + the lives of objects within the Broker. These concise messages are designed to allow the user to understand the actions of the Broker in retrospect. This is valuable for problem diagnosis and provides a useful audit trail.</p><p>Each log message includes details of the entity causing the action (e.g. a management user or messaging client connection), the entity receiving the action (e.g. a queue or connection) @@ -125,7 +125,7 @@ user id used by the client (myapp1), their IP, ephemeral port number and the name of the virtual host. The message text itself gives us further details about the connection: the client id, the protocol version in used, and details of the client's qpid library.</p><pre class="screen">[con:8(myapp1@/127.0.0.1:52851/default)] CON-1001 : Open : Client ID : clientid : - Protocol Version : 0-10 : Client Version : 0.29 : Client Product : qpid</pre><p><code class="literal"><a class="link" href="Java-Broker-Appendix-Operation-Logging.html#Java-Broker-Appendix-Operation-Logging-Message-QUE-1001">QUE-1001</a></code> is used when a queue is created. The connection actor + Protocol Version : 0-10 : Client Version : 0.32-SNAPSHOT : Client Product : qpid</pre><p><code class="literal"><a class="link" href="Java-Broker-Appendix-Operation-Logging.html#Java-Broker-Appendix-Operation-Logging-Message-QUE-1001">QUE-1001</a></code> is used when a queue is created. The connection actor <code class="literal">con</code> tells us details of the connection performing the queue creation: the user id used by the client (myapp1), the IP, ephemeral port number and the name of the virtual host. The queue subject tells use the queue's name (myqueue) and the virtualhost. The message @@ -145,6 +145,10 @@ <p>Used for operations performed by a client's channel (corresponds to the JMS concept of Session). Note that channels are numbered by a sequence number that is scoped by the owning connection.</p> + </td></tr><tr><td rowspan="2">Group</td><td> [grp(/<em class="replaceable"><code>groupname</code></em>)/vhn(/<em class="replaceable"><code>virtualhostnode + name</code></em>)]</td></tr><tr><td> + <p>Used for HA. Used for operations performed by the system itself often as a result + of actions performed on another node..</p> </td></tr></tbody></table></div></div><br class="table-break" /><div class="table"><a id="Java-Broker-Appendix-Operation-Logging-Subject-Format"></a><p class="title"><strong>Table C.2. Subject Entities</strong></p><div class="table-contents"><table border="1" summary="Subject Entities" width="100%"><colgroup><col /><col /></colgroup><thead><tr><th>Subject Type</th><th>Format and Purpose</th></tr></thead><tbody><tr><td rowspan="2">Connection</td><td> [con:<em class="replaceable"><code>connectionnumber</code></em>(<em class="replaceable"><code>userid</code></em>@/<em class="replaceable"><code>clientip</code></em>:<em class="replaceable"><code>ephemeralport</code></em>/<em class="replaceable"><code>virtualhostname</code></em>)]</td></tr><tr><td> <p>A connection to the Broker.</p> @@ -165,6 +169,8 @@ </td></tr><tr><td rowspan="2">Message Store</td><td> [vh(/<em class="replaceable"><code>virtualhostname</code></em>)/ms(<em class="replaceable"><code>messagestorename</code></em>)]</td></tr><tr><td> <p>A virtualhost/message store on the Broker.</p> + </td></tr><tr><td rowspan="2">HA Group</td><td> [grp(/<em class="replaceable"><code>group name</code></em>)]</td></tr><tr><td> + <p>A HA group</p> </td></tr></tbody></table></div></div><br class="table-break" /><p>The following tables lists all the operation log messages that can be produced by the Broker, and the describes the circumstances under which each may be seen.</p><div class="table"><a id="Java-Broker-Appendix-Operation-Logging-Message-List-Broker"></a><p class="title"><strong>Table C.3. Broker Log Messages</strong></p><div class="table-contents"><table border="1" summary="Broker Log Messages" width="100%"><colgroup><col /><col /></colgroup><thead><tr><th>Message Id</th><th>Message Text / Purpose</th></tr></thead><tbody><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-BRK-1001"></a>BRK-1001</td><td>Startup : Version: <em class="replaceable"><code>version</code></em> Build: <em class="replaceable"><code>build</code></em> @@ -194,6 +200,10 @@ </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-BRK-1009"></a>BRK-1009</td><td><em class="replaceable"><code>delivered|received</code></em> : <em class="replaceable"><code>size</code></em> msg/s peak : <em class="replaceable"><code>size</code></em> msgs total</td></tr><tr><td> <p>Statistic - messages delivered or received by the Broker.</p> + </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-BRK-1014"></a>BRK-1014</td><td>Message flow to disk active : Message memory use <em class="replaceable"><code>size of all messages</code></em> exceeds threshold <em class="replaceable"><code>threshold size</code></em></td></tr><tr><td> + <p>Indicates that the heap memory space occupied by messages has exceeded the threshold so the flow to disk feature has been activated.</p> + </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-BRK-1015"></a>BRK-1015</td><td>Message flow to disk inactive : Message memory use <em class="replaceable"><code>size of all messages</code></em> within threshold <em class="replaceable"><code>threshold size</code></em></td></tr><tr><td> + <p>Indicates that the heap memory space occupied by messages has fallen below the threshold so the flow to disk feature has been deactivated.</p> </td></tr></tbody></table></div></div><br class="table-break" /><div class="table"><a id="Java-Broker-Appendix-Operation-Logging-Message-List-Management"></a><p class="title"><strong>Table C.4. Management Log Messages</strong></p><div class="table-contents"><table border="1" summary="Management Log Messages" width="100%"><colgroup><col /><col /></colgroup><thead><tr><th>Message Id</th><th>Message Text / Purpose</th></tr></thead><tbody><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-MNG-1001"></a>MNG-1001</td><td><em class="replaceable"><code>type</code></em> Management Startup </td></tr><tr><td> <p>Indicates that a Management plugin is starting up. Currently supported management plugins are JMX and Web.</p> @@ -242,10 +252,10 @@ <p>Indicates that a queue has been deleted.</p> </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-QUE-1003"></a>QUE-1003</td><td>Overfull : Size : <em class="replaceable"><code>size</code></em> bytes, Capacity : <em class="replaceable"><code>maximumsize</code></em></td></tr><tr><td> - <p>Indicates that a queue has exceeded its permitted capacity. See <a class="xref" href="Java-Broker-Runtime-Disk-Space-Management.html#Qpid-Producer-Flow-Control" title="12.2.1. Producer Flow Control">Section 12.2.1, “Producer Flow Control”</a> for details.</p> + <p>Indicates that a queue has exceeded its permitted capacity. See <a class="xref" href="Java-Broker-Runtime-Disk-Space-Management.html#Qpid-Producer-Flow-Control" title="9.2.1. Producer Flow Control">Section 9.2.1, “Producer Flow Control”</a> for details.</p> </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-QUE-1004"></a>QUE-1004</td><td>Underfull : Size : <em class="replaceable"><code>size</code></em> bytes, Resume Capacity : <em class="replaceable"><code>resumesize</code></em></td></tr><tr><td> - <p>Indicates that a queue has fallen to its resume capacity. See <a class="xref" href="Java-Broker-Runtime-Disk-Space-Management.html#Qpid-Producer-Flow-Control" title="12.2.1. Producer Flow Control">Section 12.2.1, “Producer Flow Control”</a> for details.</p> + <p>Indicates that a queue has fallen to its resume capacity. See <a class="xref" href="Java-Broker-Runtime-Disk-Space-Management.html#Qpid-Producer-Flow-Control" title="9.2.1. Producer Flow Control">Section 9.2.1, “Producer Flow Control”</a> for details.</p> </td></tr></tbody></table></div></div><br class="table-break" /><div class="table"><a id="Java-Broker-Appendix-Operation-Logging-Message-List-Exchange"></a><p class="title"><strong>Table C.7. Exchange Log Messages</strong></p><div class="table-contents"><table border="1" summary="Exchange Log Messages" width="100%"><colgroup><col /><col /></colgroup><thead><tr><th>Message Id</th><th>Message Text / Purpose</th></tr></thead><tbody><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-EXH-1001"></a>EXH-1001</td><td>Create : [<em class="replaceable"><code>Durable</code></em>] Type: <em class="replaceable"><code>type</code></em> Name: <em class="replaceable"><code>exchange name</code></em></td></tr><tr><td> <p>Indicates that an exchange has been created.</p> @@ -254,7 +264,7 @@ </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-EXH-1003"></a>EXH-1003</td><td>Discarded Message : Name: <em class="replaceable"><code>exchange name</code></em> Routing Key: <em class="replaceable"><code>routing key</code></em></td></tr><tr><td> <p>Indicates that an exchange received a message that could not be routed to at least - one queue. queue has exceeded its permitted capacity. See <a class="xref" href="Java-Broker-Concepts-Exchanges.html#Java-Broker-Concepts-Exchanges-UnroutableMessage" title="4.3.4. Unrouteable Messages">Section 4.3.4, “Unrouteable Messages”</a> for details.</p> + one queue. queue has exceeded its permitted capacity. See <a class="xref" href="Java-Broker-Concepts-Exchanges.html#Java-Broker-Concepts-Exchanges-UnroutableMessage" title="4.6.4. Unrouteable Messages">Section 4.6.4, “Unrouteable Messages”</a> for details.</p> </td></tr></tbody></table></div></div><br class="table-break" /><div class="table"><a id="Java-Broker-Appendix-Operation-Logging-Message-List-Binding"></a><p class="title"><strong>Table C.8. Binding Log Messages</strong></p><div class="table-contents"><table border="1" summary="Binding Log Messages" width="100%"><colgroup><col /><col /></colgroup><thead><tr><th>Message Id</th><th>Message Text / Purpose</th></tr></thead><tbody><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-BND-1001"></a>BND-1001</td><td>Create : Arguments : <em class="replaceable"><code>arguments</code></em></td></tr><tr><td> <p>Indicates that a binding has been made between an exchange and a queue.</p> </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-BND-1002"></a>BND-1002</td><td>Deleted</td></tr><tr><td> @@ -285,27 +295,27 @@ </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-CHN-1005"></a>CHN-1005</td><td>Flow Control Enforced (Queue <em class="replaceable"><code>queue name</code></em>)</td></tr><tr><td> <p>Indicates that producer flow control has been imposed on a channel owning to excessive queue depth in the indicated queue. Produces using the channel will be - requested to pause the sending of messages. See <a class="xref" href="Java-Broker-Runtime-Disk-Space-Management.html#Qpid-Producer-Flow-Control" title="12.2.1. Producer Flow Control">Section 12.2.1, “Producer Flow Control”</a> for more details.</p> + requested to pause the sending of messages. See <a class="xref" href="Java-Broker-Runtime-Disk-Space-Management.html#Qpid-Producer-Flow-Control" title="9.2.1. Producer Flow Control">Section 9.2.1, “Producer Flow Control”</a> for more details.</p> </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-CHN-1006"></a>CHN-1006</td><td>Flow Control Removed</td></tr><tr><td> - <p>Indicates that producer flow control has been removed from a channel. See <a class="xref" href="Java-Broker-Runtime-Disk-Space-Management.html#Qpid-Producer-Flow-Control" title="12.2.1. Producer Flow Control">Section 12.2.1, “Producer Flow Control”</a> for more details.</p> + <p>Indicates that producer flow control has been removed from a channel. See <a class="xref" href="Java-Broker-Runtime-Disk-Space-Management.html#Qpid-Producer-Flow-Control" title="9.2.1. Producer Flow Control">Section 9.2.1, “Producer Flow Control”</a> for more details.</p> </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-CHN-1007"></a>CHN-1007</td><td>Open Transaction : <em class="replaceable"><code>time</code></em> ms</td></tr><tr><td> <p>Indicates that a producer transaction has been open for longer than that - permitted. See <a class="xref" href="Java-Broker-Runtime-Producer-Transaction-Timeout.html" title="12.3. Producer Transaction Timeout">Section 12.3, “Producer Transaction Timeout”</a> for + permitted. See <a class="xref" href="Java-Broker-Runtime-Producer-Transaction-Timeout.html" title="9.3. Producer Transaction Timeout">Section 9.3, “Producer Transaction Timeout”</a> for more details.</p> </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-CHN-1008"></a>CHN-1008</td><td>Idle Transaction : <em class="replaceable"><code>time</code></em> ms</td></tr><tr><td> <p>Indicates that a producer transaction has been idle for longer than that - permitted. See <a class="xref" href="Java-Broker-Runtime-Producer-Transaction-Timeout.html" title="12.3. Producer Transaction Timeout">Section 12.3, “Producer Transaction Timeout”</a> for + permitted. See <a class="xref" href="Java-Broker-Runtime-Producer-Transaction-Timeout.html" title="9.3. Producer Transaction Timeout">Section 9.3, “Producer Transaction Timeout”</a> for more details.</p> </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-CHN-1009"></a>CHN-1009</td><td>Discarded message : <em class="replaceable"><code>message number</code></em> as no alternate exchange configured for queue : <em class="replaceable"><code>queue name</code></em>{1} routing key : <em class="replaceable"><code>routing key</code></em></td></tr><tr><td> <p>Indicates that a channel has discarded a message as the maximum delivery count has - been exceeded but the queue defines no alternate exchange. See <a class="xref" href="Java-Broker-Runtime-Handling-Undeliverable-Messages.html#Java-Broker-Runtime-Handling-Undeliverable-Messages-Maximum-Delivery-Count" title="12.4.2. Maximum Delivery Count">Section 12.4.2, “Maximum Delivery Count”</a> for more details. Note that <em class="replaceable"><code>message number</code></em> is an + been exceeded but the queue defines no alternate exchange. See <a class="xref" href="Java-Broker-Runtime-Handling-Undeliverable-Messages.html#Java-Broker-Runtime-Handling-Undeliverable-Messages-Maximum-Delivery-Count" title="9.4.2. Maximum Delivery Count">Section 9.4.2, “Maximum Delivery Count”</a> for more details. Note that <em class="replaceable"><code>message number</code></em> is an internal message reference.</p> </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-CHN-1010"></a>CHN-1010</td><td>Discarded message : <em class="replaceable"><code>message number</code></em> as no binding on alternate exchange : <em class="replaceable"><code>exchange name</code></em></td></tr><tr><td> <p>Indicates that a channel has discarded a message as the maximum delivery count has - been exceeded but the queue's alternate exchange has no binding to a queue. See <a class="xref" href="Java-Broker-Runtime-Handling-Undeliverable-Messages.html#Java-Broker-Runtime-Handling-Undeliverable-Messages-Maximum-Delivery-Count" title="12.4.2. Maximum Delivery Count">Section 12.4.2, “Maximum Delivery Count”</a> for more details. Note that <em class="replaceable"><code>message number</code></em> is an + been exceeded but the queue's alternate exchange has no binding to a queue. See <a class="xref" href="Java-Broker-Runtime-Handling-Undeliverable-Messages.html#Java-Broker-Runtime-Handling-Undeliverable-Messages-Maximum-Delivery-Count" title="9.4.2. Maximum Delivery Count">Section 9.4.2, “Maximum Delivery Count”</a> for more details. Note that <em class="replaceable"><code>message number</code></em> is an internal message reference.</p> </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-CHN-1011"></a>CHN-1011</td><td>Message : <em class="replaceable"><code>message number</code></em> moved to dead letter queue : <em class="replaceable"><code>queue name</code></em></td></tr><tr><td> @@ -322,8 +332,9 @@ ready to receive more messages. As this happens frequently in normal operation, this log messages is disabled by default.</p> </td></tr></tbody></table></div></div><br class="table-break" /><div class="table"><a id="Java-Broker-Appendix-Operation-Logging-Message-List-MessageStore"></a><p class="title"><strong>Table C.12. Message Store Log Messages</strong></p><div class="table-contents"><table border="1" summary="Message Store Log Messages" width="100%"><colgroup><col /><col /></colgroup><thead><tr><th>Message Id</th><th>Message Text / Purpose</th></tr></thead><tbody><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-MST-1001"></a>MST-1001</td><td>Created</td></tr><tr><td> - <p>Indicates that a message store has been created. The message store is responsible for the storage - of the messages themselves, including the message body and any headers.</p> + <p>Indicates that a message store has been created. The message store is responsible + for the storage of the messages themselves, including the message body and any + headers.</p> </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-MST-1002"></a>MST-1002</td><td>Store location : <em class="replaceable"><code>path</code></em></td></tr><tr><td> <p>Indicates that the message store is using <em class="replaceable"><code>path</code></em> for the location of the message store.</p> @@ -341,37 +352,83 @@ operations. Currently this message is used by HA when the node is in replica state.</p> </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-MST-1008"></a>MST-1008</td><td>Store overfull, flow control will be enforced</td></tr><tr><td> - <p>The store has breached is maximum configured size. See <a class="xref" href="Java-Broker-Runtime-Disk-Space-Management.html#Qpid-Producer-Flow-Control" title="12.2.1. Producer Flow Control">Section 12.2.1, “Producer Flow Control”</a> for details.</p> + <p>The store has breached is maximum configured size. See <a class="xref" href="Java-Broker-Runtime-Disk-Space-Management.html#Qpid-Producer-Flow-Control" title="9.2.1. Producer Flow Control">Section 9.2.1, “Producer Flow Control”</a> for details.</p> </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-MST-1009"></a>MST-1009</td><td>Store overfull condition cleared</td></tr><tr><td> <p>The store size has fallen beneath its resume capacity and therefore flow control - has been rescinded. See <a class="xref" href="Java-Broker-Runtime-Disk-Space-Management.html#Qpid-Producer-Flow-Control" title="12.2.1. Producer Flow Control">Section 12.2.1, “Producer Flow Control”</a> for + has been rescinded. See <a class="xref" href="Java-Broker-Runtime-Disk-Space-Management.html#Qpid-Producer-Flow-Control" title="9.2.1. Producer Flow Control">Section 9.2.1, “Producer Flow Control”</a> for details.</p> </td></tr></tbody></table></div></div><br class="table-break" /><div class="table"><a id="Java-Broker-Appendix-Operation-Logging-Message-List-TransactionStore"></a><p class="title"><strong>Table C.13. Transaction Store Log Messages</strong></p><div class="table-contents"><table border="1" summary="Transaction Store Log Messages" width="100%"><colgroup><col /><col /></colgroup><thead><tr><th>Message Id</th><th>Message Text / Purpose</th></tr></thead><tbody><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-TXN-1001"></a>TXN-1001</td><td>Created</td></tr><tr><td> - <p>Indicates that a transaction store has been created. The transaction store is responsible for the storage - of messages instances, that is, the presence of a message on a queue.</p> + <p>Indicates that a transaction store has been created. The transaction store is + responsible for the storage of messages instances, that is, the presence of a message + on a queue.</p> </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-TXN-1002"></a>TXN-1002</td><td>Store location : <em class="replaceable"><code>path</code></em></td></tr><tr><td> - <p>Indicates that the transaction store is using <em class="replaceable"><code>path</code></em> for the - location of the store.</p> + <p>Indicates that the transaction store is using <em class="replaceable"><code>path</code></em> for + the location of the store.</p> </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-TXN-1003"></a>TXN-1003</td><td>Closed</td></tr><tr><td> <p>Indicates that the transaction store has been closed.</p> </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-TXN-1004"></a>TXN-1004</td><td>Recovery Start</td></tr><tr><td> <p>Indicates that transaction recovery has begun.</p> - </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-MST-TXN"></a>TXN-1005</td><td>Recovered <em class="replaceable"><code>number</code></em> messages for queue <em class="replaceable"><code>name</code></em>.</td></tr><tr><td> - <p>Indicates that recovery recovered the given number of message instances for the given queue.</p> + </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-MST-TXN"></a>TXN-1005</td><td>Recovered <em class="replaceable"><code>number</code></em> messages for queue + <em class="replaceable"><code>name</code></em>.</td></tr><tr><td> + <p>Indicates that recovery recovered the given number of message instances for the + given queue.</p> </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-TXN-1006"></a>TXN-1006</td><td>Recovered Complete</td></tr><tr><td> <p>Indicates that the message recovery is concluded.</p> </td></tr></tbody></table></div></div><br class="table-break" /><div class="table"><a id="Java-Broker-Appendix-Operation-Logging-Message-List-ConfigurationStore"></a><p class="title"><strong>Table C.14. Configuration Store Log Messages</strong></p><div class="table-contents"><table border="1" summary="Configuration Store Log Messages" width="100%"><colgroup><col /><col /></colgroup><thead><tr><th>Message Id</th><th>Message Text / Purpose</th></tr></thead><tbody><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-CFG-1001"></a>CFG-1001</td><td>Created</td></tr><tr><td> - <p>Indicates that a configuration store has been created. The configuration store is responsible - for the storage of the definition of objects such as queues, exchanges, and bindings.</p> + <p>Indicates that a configuration store has been created. The configuration store is + responsible for the storage of the definition of objects such as queues, exchanges, + and bindings.</p> </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-CFG-1002"></a>CFG-1002</td><td>Store location : <em class="replaceable"><code>path</code></em></td></tr><tr><td> - <p>Indicates that the configuration store is using <em class="replaceable"><code>path</code></em> for the - location of the store.</p> + <p>Indicates that the configuration store is using <em class="replaceable"><code>path</code></em> + for the location of the store.</p> </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-CFG-1003"></a>CFG-1003</td><td>Closed</td></tr><tr><td> <p>Indicates that the configuration store has been closed.</p> </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-CFG-1004"></a>CFG-1004</td><td>Recovery Start</td></tr><tr><td> <p>Indicates that configuration recovery has begun.</p> </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-CFG-1005"></a>CFG-1005</td><td>Recovered Complete</td></tr><tr><td> <p>Indicates that the configuration recovery is concluded.</p> + </td></tr></tbody></table></div></div><br class="table-break" /><div class="table"><a id="Java-Broker-Appendix-Operation-Logging-Message-List-HA"></a><p class="title"><strong>Table C.15. HA Log Messages</strong></p><div class="table-contents"><table border="1" summary="HA Log Messages" width="100%"><colgroup><col /><col /></colgroup><thead><tr><th>Message Id</th><th>Message Text / Purpose</th></tr></thead><tbody><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-HA-1001"></a>HA-1001</td><td>Created</td></tr><tr><td> + <p>This HA node has been created.</p> + </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-HA-1002"></a>HA-1002</td><td>Deleted</td></tr><tr><td> + <p>This HA node has been deleted</p> + </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-HA-1003"></a>HA-1003</td><td>Added : Node : '<em class="replaceable"><code>name</code></em>' + (<em class="replaceable"><code>host:port</code></em>)</td></tr><tr><td> + <p>A new node has been added to the group.</p> + </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-HA-1004"></a>HA-1004</td><td>Removed : Node : '<em class="replaceable"><code>name</code></em>' + (<em class="replaceable"><code>host:port</code></em>)</td></tr><tr><td> + <p>The node has been removed from the group. This removal is permanent.</p> + </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-HA-1005"></a>HA-1005</td><td>Joined : Node : '<em class="replaceable"><code>name</code></em>' + (<em class="replaceable"><code>host:port</code></em>)</td></tr><tr><td> + <p>The node has become reachable. This may be as a result of the node being + restarted, or a network problem may have been resolved.</p> + </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-HA-1006"></a>HA-1006</td><td>Left : Node : '<em class="replaceable"><code>name</code></em>' + (<em class="replaceable"><code>host:port</code></em>)</td></tr><tr><td> + <p>The node is no longer reachable. This may be as a result of the node being + stopped or a network partition may be preventing it from being connected. The node is + still a member of the group.</p> + </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-HA-1007"></a>HA-1007</td><td>HA-1007 : Master transfer requested : to '<em class="replaceable"><code>name</code></em>' + (<em class="replaceable"><code>host:port</code></em>)</td></tr><tr><td> + <p>Indicates that a master transfer operation has been requested.</p> + </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-HA-1008"></a>HA-1008</td><td>HA-1008 : Intruder detected : Node '<em class="replaceable"><code>name</code></em>' + (<em class="replaceable"><code>host:port</code></em>)</td></tr><tr><td> + <p>Indicates that an unexpected node has joined the group. The virtualhost node will + go into the ERROR state in response to the condition.</p> + </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-HA-1009"></a>HA-1009</td><td>HA-1009 : Insufficient replicas contactable</td></tr><tr><td> + <p>This node (which was in the master role) no longer has sufficient replica in + contact in order to complete transactions.</p> + </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-HA-1010"></a>HA-1010</td><td>HA-1010 : Role change reported: Node : '<em class="replaceable"><code>name</code></em>' + (<em class="replaceable"><code>host:port</code></em>) : from <em class="replaceable"><code>role</code></em> to + <em class="replaceable"><code>role</code></em></td></tr><tr><td> + <p>Indicates that the node has changed role within the group.</p> + </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-HA-1011"></a>HA-1011</td><td>HA-1011 : Minimum group size : <em class="replaceable"><code>new group size</code></em></td></tr><tr><td> + <p>The quorum requirements from completing elections or transactions has been + changed.</p> + </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-HA-1012"></a>HA-1012</td><td>HA-1012 : Priority : <em class="replaceable"><code>priority</code></em></td></tr><tr><td> + <p>The priority of the object node has been changed. Zero indicates that the node + cannot be elected master.</p> + </td></tr><tr><td rowspan="2"><a id="Java-Broker-Appendix-Operation-Logging-Message-HA-1013"></a>HA-1013</td><td>HA-1013 : Designated primary : <em class="replaceable"><code>true|false</code></em></td></tr><tr><td> + <p>This node has been designated primary and can now operate solo. Applies to two + node groups only.</p> </td></tr></tbody></table></div></div><br class="table-break" /></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="Java-Broker-Appendix-System-Properties.html">Prev</a> </td><td align="center" width="20%"> </td><td align="right" width="40%"> <a accesskey="n" href="Java-Broker-Appendix-Queue-Alerts.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Appendix B. System Properties </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td align="right" valign="top" width="40%"> Appendix D. Queue Alerts</td></tr></table></div></div> <hr/> Added: qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Appendix-Queue-Alerts.html URL: http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Appendix-Queue-Alerts.html?rev=1632181&view=auto ============================================================================== --- qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Appendix-Queue-Alerts.html (added) +++ qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Appendix-Queue-Alerts.html Wed Oct 15 21:29:55 2014 @@ -0,0 +1,163 @@ +<!DOCTYPE html> +<!-- + - + - 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. + - +--> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> + <head> + <title>Appendix D. Queue Alerts - Apache Qpid™</title> + <meta http-equiv="X-UA-Compatible" content="IE=edge"/> + <meta name="viewport" content="width=device-width, initial-scale=1.0"/> + <link rel="stylesheet" href="/site.css" type="text/css" async="async"/> + <link rel="stylesheet" href="/deferred.css" type="text/css" defer="defer"/> + <script type="text/javascript">var _deferredFunctions = [];</script> + <script type="text/javascript" src="/deferred.js" defer="defer"></script> + <!--[if lte IE 8]> + <link rel="stylesheet" href="/ie.css" type="text/css"/> + <script type="text/javascript" src="/html5shiv.js"></script> + <![endif]--> + </head> + <body> + <div id="-content"> + <div id="-top" class="panel"> + <a id="-menu-link"><img width="16" height="16" src="data:image/png;base64," alt="Menu"/></a> + + <a id="-search-link"><img width="22" height="16" src="data:image/png;base64," alt="Search"/></a> + + <ul id="-global-navigation"> + <li><a id="-logotype" href="/index.html">Apache Qpid<sup>™</sup></a></li> + <li><a href="/download.html">Download</a></li> + <li><a href="/documentation.html">Documentation</a></li> + <li><a href="/discussion.html">Discussion</a></li> + <li><a href="/issues.html">Issues</a></li> + <li><a href="/source-code.html">Source Code</a></li> + <li><a href="/resources.html">More Resources</a></li> + </ul> + </div> + + <div id="-menu" class="panel" style="display: none;"> + <section> + <h3>Project</h3> + + <ul> + <li><a href="/overview.html">Overview</a></li> + <li><a href="/proton/index.html">Qpid Proton</a></li> + <li><a href="/contributors.html">Contributors</a></li> + <li><a href="/get-involved.html">Get involved</a></li> + </ul> + </section> + + <section> + <h3>Software</h3> + + <ul> + <li><a href="/download.html">Download</a></li> + <li><a href="/documentation.html">Documentation</a></li> + <li><a href="/components/index.html">Components</a></li> + <li><a href="/releases/index.html">Releases</a></li> + </ul> + </section> + + <section> + <h3>Resources</h3> + + <ul> + <li><a href="/discussion.html">Discussion</a></li> + <li><a href="/issues.html">Issues</a></li> + <li><a href="/source-code.html">Source code</a></li> + <li><a href="/resources.html">More resources</a></li> + </ul> + </section> + + <section> + <h3>More</h3> + + <ul> + <li><a href="/amqp.html">AMQP</a></li> + <li><a href="/developer.html">Developer central</a></li> + <li><a href="https://cwiki.apache.org/confluence/display/qpid/">Wiki</a></li> + </ul> + </section> + </div> + + <div id="-search" class="panel" style="display: none;"> + <form action="http://www.google.com/search" method="get"> + <input type="hidden" name="sitesearch" value="qpid.apache.org"/> + <input type="text" name="q" maxlength="255" autofocus="autofocus" tabindex="1"/> + <button type="submit">Search</button> + <p><a href="/search.html">More ways to search</a></p> + </form> + </div> + + <div id="-middle" class="panel"> + <ul id="-path-navigation"><li><a href="/releases/index.html">Releases</a></li><li><a href="/releases/qpid-trunk/index.html">Qpid Trunk</a></li><li><a href="/releases/qpid-trunk/java-broker/book/index.html">AMQP Messaging Broker (Java)</a></li><li>Appendix D. Queue Alerts</li></ul> + <div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">Appendix D. Queue Alerts</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="Java-Broker-Appendix-Operation-Logging.html">Prev</a> </td><th align="center" width="60%"> </th><td align="right" width="20%"> <a accesskey="n" href="Java-Broker-Miscellaneous.html">Next</a></td></tr></table><hr /></div><div class="appendix"><div class="titlepage"><div><div><h1 class="title"><a id="Java-Broker-Appendix-Queue-Alerts"></a>Appendix D. Queue Alerts</h1></div></div></div><p>The Broker supports a variety of queue alerting thresholds. Once configured on a queue, + these limits will be periodically written to the log if these limits are breached, until the + condition is rectified.</p><p>For example, if queue <code class="literal">myqueue</code> is configured with a message count alert of + 1000, and then owing to a failure of a downstream system messages begin to accumulate on the + queue, the following alerts will be written periodically to the log. </p><pre class="screen"> +INFO [default:VirtualHostHouseKeepingTask] (queue.NotificationCheck) - MESSAGE_COUNT_ALERT + On Queue myqueue - 1272: Maximum count on queue threshold (1000) breached. + </pre><p>Note that queue alerts are <span class="emphasis"><em>soft</em></span> in nature; breaching the limit will + merely cause the alerts to be generated but messages will still be accepted to the queue.</p><div class="table"><a id="Java-Broker-Appendix-Queue-Alerts-Alerting-Messages"></a><p class="title"><strong>Table D.1. Queue Alerts</strong></p><div class="table-contents"><table border="1" summary="Queue Alerts" width="100%"><colgroup><col /><col /></colgroup><thead><tr><th>Alert Name</th><th>Alert Format and Purpose</th></tr></thead><tbody><tr><td rowspan="2">MESSAGE_COUNT_ALERT</td><td> MESSAGE_COUNT_ALERT On Queue <em class="replaceable"><code>queuename</code></em> - + <em class="replaceable"><code>number of messages</code></em>: Maximum count on queue threshold + (<em class="replaceable"><code>limit</code></em>) breached. </td></tr><tr><td> + <p>The number of messages on the given queue has breached its configured + limit.</p> + </td></tr><tr><td rowspan="2">MESSAGE_SIZE_ALERT</td><td> MESSAGE_SIZE_ALERT On Queue <em class="replaceable"><code>queuename</code></em> + -<em class="replaceable"><code>message size</code></em> : Maximum message size threshold + (<em class="replaceable"><code>limit</code></em>) breached. [Message ID=<em class="replaceable"><code>message + id</code></em>]</td></tr><tr><td> + <p>The size of an individual messages has breached its configured limit.</p> + </td></tr><tr><td rowspan="2">QUEUE_DEPTH_ALERT</td><td> QUEUE_DEPTH_ALERT On Queue <em class="replaceable"><code>queuename</code></em> - + <em class="replaceable"><code>total size of all messages on queue</code></em> : Maximum queue depth + threshold (<em class="replaceable"><code>limit</code></em>) breached.</td></tr><tr><td> + <p>The total size of all messages on the queue has breached its configured + limit.</p> + </td></tr><tr><td rowspan="2">MESSAGE_AGE_ALERT</td><td>MESSAGE_AGE_ALERT On Queue <em class="replaceable"><code>queuename</code></em> - <em class="replaceable"><code>age + of message</code></em> : Maximum age on queue threshold + (<em class="replaceable"><code>limit</code></em>) breached. </td></tr><tr><td> + <p>The age of a message on the given queue has breached its configured limit.</p> + </td></tr></tbody></table></div></div><br class="table-break" /></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="Java-Broker-Appendix-Operation-Logging.html">Prev</a> </td><td align="center" width="20%"> </td><td align="right" width="40%"> <a accesskey="n" href="Java-Broker-Miscellaneous.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Appendix C. Operational Logging </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td align="right" valign="top" width="40%"> Appendix E. Miscellaneous</td></tr></table></div></div> + + <hr/> + + <ul id="-apache-navigation"> + <li><a href="http://www.apache.org/">Apache</a></li> + <li><a href="http://www.apache.org/licenses/">License</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> + <li><a href="http://www.apache.org/"><img id="-apache-feather" width="48" height="14" src="data:image/png;base64," alt="Apache"/></a></li> + </ul> + + <p id="-legal"> + Apache Qpid, Messaging built on AMQP; Copyright © 2013 + The Apache Software Foundation; Licensed under + the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache + License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton, + Proton, Apache, the Apache feather logo, and the Apache Qpid + project logo are trademarks of The Apache Software + Foundation; All other marks mentioned may be trademarks or + registered trademarks of their respective owners + </p> + </div> + </div> + </body> +</html> Modified: qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Appendix-System-Properties.html URL: http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Appendix-System-Properties.html?rev=1632181&r1=1632180&r2=1632181&view=diff ============================================================================== --- qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Appendix-System-Properties.html (original) +++ qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Appendix-System-Properties.html Wed Oct 15 21:29:55 2014 @@ -109,16 +109,10 @@ <ul id="-path-navigation"><li><a href="/releases/index.html">Releases</a></li><li><a href="/releases/qpid-trunk/index.html">Qpid Trunk</a></li><li><a href="/releases/qpid-trunk/java-broker/book/index.html">AMQP Messaging Broker (Java)</a></li><li>Appendix B. System Properties</li></ul> <div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">Appendix B. System Properties</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="Java-Broker-Appendix-Environment-Variables.html">Prev</a> </td><th align="center" width="60%"> </th><td align="right" width="20%"> <a accesskey="n" href="Java-Broker-Appendix-Operation-Logging.html">Next</a></td></tr></table><hr /></div><div class="appendix"><div class="titlepage"><div><div><h1 class="title"><a id="Java-Broker-Appendix-System-Properties"></a>Appendix B. System Properties</h1></div></div></div><p>The following table describes the Java system properties used by the Broker to control various optional behaviours.</p><p>The preferred method of enabling these system properties is using the <a class="link" href="Java-Broker-Appendix-Environment-Variables.html#Java-Broker-Appendix-Environment-Variables-Qpid-Opts"><code class="literal">QPID_OPTS</code></a> environment variable described in the previous - section.</p><div class="table"><a id="idm233114450208"></a><p class="title"><strong>Table B.1. System properties</strong></p><div class="table-contents"><table border="1" summary="System properties" width="100%"><colgroup><col /><col /><col /></colgroup><thead><tr><th>System property</th><th>Default</th><th>Purpose</th></tr></thead><tbody><tr><td><a id="Java-Broker-Appendix-System-Properties-Shared-Msg-Group"></a>qpid.shared_msg_group</td><td> - <code class="literal">qpid.no-group</code> - </td><td> - <p>Controls the default group for groups operating in 'shared groups' mode. See <a class="xref" href="Java-Broker-Queues.html#Java-Broker-Queues-OtherTypes-Message-Grouping" title="9.1.7.  Messaging Grouping">Section 9.1.7, “ - Messaging Grouping - ”</a></p> - </td></tr><tr><td><a id="Java-Broker-Appendix-System-Properties-Broker-Heartbeat-Timeout-Factor"></a>qpid.broker_heartbeat_timeout_factor</td><td>2</td><td>Factor to determine the maximum length of that may elapse between heartbeats being - received from the peer before a connection is deemed to have been broken.</td></tr><tr><td><a id="Java-Broker-Appendix-System-Properties-Broker-Dead-Letter-Exchange-Suffix"></a>qpid.broker_dead_letter_exchange_suffix</td><td>_DLE</td><td>Used with the <a class="xref" href="Java-Broker-Runtime-Handling-Undeliverable-Messages.html#Java-Broker-Runtime-Handling-Undeliverable-Messages-Dead-Letter-Queues" title="12.4.3. Dead Letter Queues (DLQ)">Section 12.4.3, “Dead Letter Queues (DLQ)”</a> + section.</p><div class="table"><a id="idp1810384"></a><p class="title"><strong>Table B.1. System properties</strong></p><div class="table-contents"><table border="1" summary="System properties" width="100%"><colgroup><col /><col /><col /></colgroup><thead><tr><th>System property</th><th>Default</th><th>Purpose</th></tr></thead><tbody><tr><td><a id="Java-Broker-Appendix-System-Properties-Broker-Heartbeat-Timeout-Factor"></a>qpid.broker_heartbeat_timeout_factor</td><td>2</td><td>Factor to determine the maximum length of that may elapse between heartbeats being + received from the peer before a connection is deemed to have been broken.</td></tr><tr><td><a id="Java-Broker-Appendix-System-Properties-Broker-Dead-Letter-Exchange-Suffix"></a>qpid.broker_dead_letter_exchange_suffix</td><td>_DLE</td><td>Used with the <a class="xref" href="Java-Broker-Runtime-Handling-Undeliverable-Messages.html#Java-Broker-Runtime-Handling-Undeliverable-Messages-Dead-Letter-Queues" title="9.4.3. Dead Letter Queues (DLQ)">Section 9.4.3, “Dead Letter Queues (DLQ)”</a> feature. Governs the suffix used when generating a name for a Dead Letter - Exchange.</td></tr><tr><td><a id="Java-Broker-Appendix-System-Properties-Broker-Dead-Letter-Queue-Suffix"></a>qpid.broker_dead_letter_queue_suffix</td><td>_DLQ</td><td>Used with the <a class="xref" href="Java-Broker-Runtime-Handling-Undeliverable-Messages.html#Java-Broker-Runtime-Handling-Undeliverable-Messages-Dead-Letter-Queues" title="12.4.3. Dead Letter Queues (DLQ)">Section 12.4.3, “Dead Letter Queues (DLQ)”</a> + Exchange.</td></tr><tr><td><a id="Java-Broker-Appendix-System-Properties-Broker-Dead-Letter-Queue-Suffix"></a>qpid.broker_dead_letter_queue_suffix</td><td>_DLQ</td><td>Used with the <a class="xref" href="Java-Broker-Runtime-Handling-Undeliverable-Messages.html#Java-Broker-Runtime-Handling-Undeliverable-Messages-Dead-Letter-Queues" title="9.4.3. Dead Letter Queues (DLQ)">Section 9.4.3, “Dead Letter Queues (DLQ)”</a> feature. Governs the suffix used when generating a name for a Dead Letter Queue.</td></tr><tr><td>qpid.broker_msg_auth</td><td>false</td><td> <p>If set true, the Broker ensures that the user id of each received message matches the user id of the producing connection. If this check fails, the message is returned @@ -127,14 +121,6 @@ protocols.</p> </td></tr><tr><td><a id="Java-Broker-Appendix-System-Properties-Broker-Status-Updates"></a>qpid.broker_status_updates</td><td>true</td><td> <p>If set true, the Broker will produce operational logging messages.</p> - </td></tr><tr><td><a id="Java-Broker-Appendix-System-Properties-Broker-Amqp-Protocol-Excludes"></a>qpid.broker_default_amqp_protocol_excludes</td><td>none</td><td> - <p>Controls the AMQP protocol versions supported by the Broker. The value of this - property is a comma separated list of AMQP protocol versions whose support should be - disabled.</p> - </td></tr><tr><td><a id="Java-Broker-Appendix-System-Properties-Broker-Amqp-Protocol-Includes"></a>qpid.broker_default_amqp_protocol_includes</td><td>none</td><td> - <p>Controls the AMQP protocol versions supported by the Broker. The value of this - property is a comma separated list of AMQP protocol versions whose support should be - enabled.</p> </td></tr><tr><td><a id="Java-Broker-Appendix-System-Properties-Broker-Default-Supported-Protocol-Version-Reply"></a>qpid.broker_default_supported_protocol_version_reply</td><td>none</td><td> <p>Used during protocol negotiation. If set, the Broker will offer this AMQP version to a client requesting an AMQP protocol that is not supported by the Broker. If not set, the @@ -146,7 +132,7 @@ </td></tr><tr><td><a id="Java-Broker-Appendix-System-Properties-Broker-Frame-Size"></a>qpid.broker_frame_size</td><td>65536</td><td> <p>Maximum AMQP frame size supported by the Broker.</p> </td></tr><tr><td><a id="Java-Broker-Appendix-System-Properties-Jmx-Method-Rights"></a>qpid.broker_jmx_method_rights_infer_all_access</td><td>true</td><td> - <p>Used when using <a class="link" href="Java-Broker-Security-ACLs.html" title="11.3. Access Control Lists">ACLs</a> and the JMX + <p>Used when using <a class="link" href="Java-Broker-Security-ACLs.html" title="8.3. Access Control Lists">ACLs</a> and the JMX management interface.</p> <p>If set true, the METHOD object permission is sufficient to allow the user to perform the operation. If set false, the user will require both the METHOD object Added: qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Backup-And-Recovery-Virtualhost-Node.html URL: http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Backup-And-Recovery-Virtualhost-Node.html?rev=1632181&view=auto ============================================================================== --- qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Backup-And-Recovery-Virtualhost-Node.html (added) +++ qpid/site/docs/releases/qpid-trunk/java-broker/book/Java-Broker-Backup-And-Recovery-Virtualhost-Node.html Wed Oct 15 21:29:55 2014 @@ -0,0 +1,153 @@ +<!DOCTYPE html> +<!-- + - + - 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. + - +--> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> + <head> + <title>11.2. Virtualhost Node - Apache Qpid™</title> + <meta http-equiv="X-UA-Compatible" content="IE=edge"/> + <meta name="viewport" content="width=device-width, initial-scale=1.0"/> + <link rel="stylesheet" href="/site.css" type="text/css" async="async"/> + <link rel="stylesheet" href="/deferred.css" type="text/css" defer="defer"/> + <script type="text/javascript">var _deferredFunctions = [];</script> + <script type="text/javascript" src="/deferred.js" defer="defer"></script> + <!--[if lte IE 8]> + <link rel="stylesheet" href="/ie.css" type="text/css"/> + <script type="text/javascript" src="/html5shiv.js"></script> + <![endif]--> + </head> + <body> + <div id="-content"> + <div id="-top" class="panel"> + <a id="-menu-link"><img width="16" height="16" src="data:image/png;base64," alt="Menu"/></a> + + <a id="-search-link"><img width="22" height="16" src="data:image/png;base64," alt="Search"/></a> + + <ul id="-global-navigation"> + <li><a id="-logotype" href="/index.html">Apache Qpid<sup>™</sup></a></li> + <li><a href="/download.html">Download</a></li> + <li><a href="/documentation.html">Documentation</a></li> + <li><a href="/discussion.html">Discussion</a></li> + <li><a href="/issues.html">Issues</a></li> + <li><a href="/source-code.html">Source Code</a></li> + <li><a href="/resources.html">More Resources</a></li> + </ul> + </div> + + <div id="-menu" class="panel" style="display: none;"> + <section> + <h3>Project</h3> + + <ul> + <li><a href="/overview.html">Overview</a></li> + <li><a href="/proton/index.html">Qpid Proton</a></li> + <li><a href="/contributors.html">Contributors</a></li> + <li><a href="/get-involved.html">Get involved</a></li> + </ul> + </section> + + <section> + <h3>Software</h3> + + <ul> + <li><a href="/download.html">Download</a></li> + <li><a href="/documentation.html">Documentation</a></li> + <li><a href="/components/index.html">Components</a></li> + <li><a href="/releases/index.html">Releases</a></li> + </ul> + </section> + + <section> + <h3>Resources</h3> + + <ul> + <li><a href="/discussion.html">Discussion</a></li> + <li><a href="/issues.html">Issues</a></li> + <li><a href="/source-code.html">Source code</a></li> + <li><a href="/resources.html">More resources</a></li> + </ul> + </section> + + <section> + <h3>More</h3> + + <ul> + <li><a href="/amqp.html">AMQP</a></li> + <li><a href="/developer.html">Developer central</a></li> + <li><a href="https://cwiki.apache.org/confluence/display/qpid/">Wiki</a></li> + </ul> + </section> + </div> + + <div id="-search" class="panel" style="display: none;"> + <form action="http://www.google.com/search" method="get"> + <input type="hidden" name="sitesearch" value="qpid.apache.org"/> + <input type="text" name="q" maxlength="255" autofocus="autofocus" tabindex="1"/> + <button type="submit">Search</button> + <p><a href="/search.html">More ways to search</a></p> + </form> + </div> + + <div id="-middle" class="panel"> + <ul id="-path-navigation"><li><a href="/releases/index.html">Releases</a></li><li><a href="/releases/qpid-trunk/index.html">Qpid Trunk</a></li><li><a href="/releases/qpid-trunk/java-broker/book/index.html">AMQP Messaging Broker (Java)</a></li><li>11.2. Virtualhost Node</li></ul> + <div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">11.2. Virtualhost Node</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="Java-Broker-Backup-And-Recovery.html">Prev</a> </td><th align="center" width="60%">Chapter 11. Backup And Recovery</th><td align="right" width="20%"> <a accesskey="n" href="Java-Broker-Backup-And-Recovery-Virtualhost.html">Next</a></td></tr></table><hr /></div><div class="section"><div class="titlepage"><div><div><h2 class="title"><a id="Java-Broker-Backup-And-Recovery-Virtualhost-Node"></a>11.2. Virtualhost Node</h2></div></div></div><p>To perform a complete backup of a Virtualhost node whilst it is stopped (or Broker down), + simply copy all the files the exist beneath + <code class="literal">${QPID_WORK}/<nodename>/config</code>, assuming the virtualhost node is in + the standard location. This will copy all configuration that belongs to that virtualhost + node.</p><p>The technique for backing up a virtualhost node whilst it is running depends on its + type.</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="Java-Broker-Backup-And-Recovery-Virtualhost-Node-BDB"></a>11.2.1. BDB</h3></div></div></div><p>Qpid Broker distribution includes the "hot" backup utility <code class="literal">backup.sh</code> + which can be found at broker bin folder. This utility can perform the backup when broker is + running.</p><p><code class="literal">backup.sh</code> script invokes + <code class="classname">org.apache.qpid.server.store.berkeleydb.BDBBackup</code> to do the + job.</p><p>You can also run this class from command line like in an example below:</p><div class="example"><a id="idp1855408"></a><p class="title"><strong>Example 11.1. Performing store backup by using <code class="classname">BDBBackup</code> class + directly</strong></p><div class="example-contents"><div class="cmdsynopsis"><p><code class="command">java</code> -cp qpid-bdbstore-0.32-SNAPSHOT.jar org.apache.qpid.server.store.berkeleydb.BDBBackup <br /> -fromdir <em class="replaceable"><code>${QPID_WORK}/<nodename>/config</code></em> -todir <em class="replaceable"><code>path/to/backup/folder</code></em> </p></div></div></div><br class="example-break" /><p>In the example above BDBBackup utility is called from + qpid-bdbstore-0.32-SNAPSHOT.jar to backup the store at + <code class="literal">${QPID_WORK}/<nodename>/config</code> and copy store logs into + <code class="literal">path/to/backup/folder</code>.</p><p>Linux and Unix users can take advantage of <code class="literal">backup.sh</code> bash script by + running this script in a similar way.</p><div class="example"><a id="idp1127344"></a><p class="title"><strong>Example 11.2. Performing store backup by using <code class="classname">backup.sh</code> bash script</strong></p><div class="example-contents"><div class="cmdsynopsis"><p><code class="command">backup.sh</code> -fromdir <em class="replaceable"><code>${QPID_WORK}/<nodename>/config</code></em> -todir <em class="replaceable"><code>path/to/backup/folder</code></em> </p></div></div></div><br class="example-break" /></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="Java-Broker-Backup-And-Recovery-Virtualhost-Node-BDB-HA"></a>11.2.2. BDB-HA</h3></div></div></div><p>See <a class="xref" href="Java-Broker-Backup-And-Recovery-Virtualhost-Node.html#Java-Broker-Backup-And-Recovery-Virtualhost-Node-BDB" title="11.2.1. BDB">Section 11.2.1, “BDB”</a></p></div><div class="section"><div class="titlepage">< div><div><h3 class="title"><a id="Java-Broker-Backup-And-Recovery-Virtualhost-Node-Derby"></a>11.2.3. Derby</h3></div></div></div><p>Not yet supported</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="Java-Broker-Backup-And-Recovery-Virtualhost-Node-JDBC"></a>11.2.4. JDBC</h3></div></div></div><p>The responsibility for backup is delegated to the database server itself. See the + documentation accompanying it. Any technique that takes a consistent snapshot of the + database is acceptable.</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="Java-Broker-Backup-And-Recovery-Virtualhost-Node-JSON"></a>11.2.5. JSON</h3></div></div></div><p>JSON stores its config in a single text file. It can be safely backed up using standard + command line tools.</p></div></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="Java-Broker-Backup-And-Recovery.html">Prev</a> </td><td align="center" width="20%"><a accesskey="u" href="Java-Broker-Backup-And-Recovery.html">Up</a></td><td align="right" width="40%"> <a accesskey="n" href="Java-Broker-Backup-And-Recovery-Virtualhost.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Chapter 11. Backup And Recovery </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td align="right" valign="top" width="40%"> 11.3. Virtualhost</td></tr></table></div></div> + + <hr/> + + <ul id="-apache-navigation"> + <li><a href="http://www.apache.org/">Apache</a></li> + <li><a href="http://www.apache.org/licenses/">License</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> + <li><a href="http://www.apache.org/"><img id="-apache-feather" width="48" height="14" src="data:image/png;base64," alt="Apache"/></a></li> + </ul> + + <p id="-legal"> + Apache Qpid, Messaging built on AMQP; Copyright © 2013 + The Apache Software Foundation; Licensed under + the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache + License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton, + Proton, Apache, the Apache feather logo, and the Apache Qpid + project logo are trademarks of The Apache Software + Foundation; All other marks mentioned may be trademarks or + registered trademarks of their respective owners + </p> + </div> + </div> + </body> +</html> --------------------------------------------------------------------- To unsubscribe, e-mail: commits-unsubscr...@qpid.apache.org For additional commands, e-mail: commits-h...@qpid.apache.org