qpid-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From rob...@apache.org
Subject svn commit: r1419155 [2/7] - in /qpid/site/docs/books/0.20: AMQP-Messaging-Broker-CPP-Book/pdf/ AMQP-Messaging-Broker-Java-Book/html/ AMQP-Messaging-Broker-Java-Book/html/images/ AMQP-Messaging-Broker-Java-Book/pdf/ Programming-In-Apache-Qpid/html/ Pro...
Date Sun, 09 Dec 2012 20:44:13 GMT
Modified: qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-High-Availability-TwoNodeCluster.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-High-Availability-TwoNodeCluster.html?rev=1419155&r1=1419154&r2=1419155&view=diff
==============================================================================
--- qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-High-Availability-TwoNodeCluster.html (original)
+++ qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-High-Availability-TwoNodeCluster.html Sun Dec  9 20:44:07 2012
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>12.3. Two Node Cluster</title><link rel="stylesheet" href="css/style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="up" href="Java-Broker-High-Availability.html" title="Chapter 12. High Availability"><link rel="prev" href="Java-Broker-High-Availability-OfferingsOfJavaBroker.html" title="12.2. HA offerings of the Java Broker"><link rel="next" href="Java-Broker-High-Availability-MultiNodeCluster.html" title="12.4. Multi Node Cluster"></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> &gt; <span class="breadcrumb-link"><a href="Java-Broker-High-Availability.html">High Availability</a></span> &gt; <span class="breadcrumb-node">Two Node Cluster</span></DIV><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-High-Availability-TwoNodeCluster"></a>12.3. Two Node Cluster</h2></div></div></div><div class="section" lang="en"><div class="titlepage"><div
 ><div><h3 class="title"><a name="id2495669"></a>12.3.1. Overview</h3></div></div></div><p>In this HA solution, a cluster is formed with two nodes. one node serves as
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>12.3. Two Node Cluster</title><link rel="stylesheet" href="css/style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="up" href="Java-Broker-High-Availability.html" title="Chapter 12. High Availability"><link rel="prev" href="Java-Broker-High-Availability-OfferingsOfJavaBroker.html" title="12.2. HA offerings of the Java Broker"><link rel="next" href="Java-Broker-High-Availability-MultiNodeCluster.html" title="12.4. Multi Node Cluster"></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> &gt; <span class="breadcrumb-link"><a href="Java-Broker-High-Availability.html">High Availability</a></span> &gt; <span class="breadcrumb-node">Two Node Cluster</span></DIV><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-High-Availability-TwoNodeCluster"></a>12.3. Two Node Cluster</h2></div></div></div><div class="section" lang="en"><div class="titlepage"><div
 ><div><h3 class="title"><a name="id2496556"></a>12.3.1. Overview</h3></div></div></div><p>In this HA solution, a cluster is formed with two nodes. one node serves as
         <span class="bold"><strong>master</strong></span> and the other is a <span class="bold"><strong>replica</strong></span>.
       </p><p>All data and state required for the operation of the virtual host is automatically sent from the
         master to the replica. This is called the replication stream. The master virtual host confirms each
@@ -16,11 +16,11 @@
         is described in more detail later.
       </p><p>Clients connect to the cluster using a <a class="link" href="Java-Broker-High-Availability-ClientFailover.html" title="12.7. Client failover configuration">failover url</a>.
         This allows the client to maintain a connection to the master in a way that is transparent
-        to the client application.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2495746"></a>12.3.2. Depictions of cluster operation</h3></div></div></div><p>In this section, the operation of the cluster is depicted through a series of figures
-        supported by explanatory text.</p><div class="figure"><a name="id2495761"></a><p class="title"><b>Figure 12.1. Key for figures</b></p><div class="figure-contents"><div class="mediaobject"><img src="images/HA-2N-Key.png" alt="Key to figures"></div></div></div><br class="figure-break"><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="Java-Broker-High-Availability-TwoNodeNormalOperation"></a>12.3.2.1. Normal Operation</h4></div></div></div><p>The figure below illustrates normal operation.  Clients connecting to the cluster by way
+        to the client application.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2496637"></a>12.3.2. Depictions of cluster operation</h3></div></div></div><p>In this section, the operation of the cluster is depicted through a series of figures
+        supported by explanatory text.</p><div class="figure"><a name="id2496652"></a><p class="title"><b>Figure 12.1. Key for figures</b></p><div class="figure-contents"><div class="mediaobject"><img src="images/HA-2N-Key.png" alt="Key to figures"></div></div></div><br class="figure-break"><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="Java-Broker-High-Availability-TwoNodeNormalOperation"></a>12.3.2.1. Normal Operation</h4></div></div></div><p>The figure below illustrates normal operation.  Clients connecting to the cluster by way
 	  of the failover URL achieve a connection to the master. As clients perform work (message
 	  production, consumption, queue creation etc), the master additionally sends this data to the
-	  replica over the network.</p><div class="figure"><a name="id2496558"></a><p class="title"><b>Figure 12.2. Normal operation of a two-node cluster</b></p><div class="figure-contents"><div class="mediaobject"><img src="images/HA-2N-Normal.png" alt="Normal operation"></div></div></div><br class="figure-break"></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="Java-Broker-High-Availability-TwoNodeMasterFailure"></a>12.3.2.2. Master Failure and Recovery</h4></div></div></div><p>The figure below illustrates a sequence of events whereby the master suffers a failure
+	  replica over the network.</p><div class="figure"><a name="id2495519"></a><p class="title"><b>Figure 12.2. Normal operation of a two-node cluster</b></p><div class="figure-contents"><div class="mediaobject"><img src="images/HA-2N-Normal.png" alt="Normal operation"></div></div></div><br class="figure-break"></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="Java-Broker-High-Availability-TwoNodeMasterFailure"></a>12.3.2.2. Master Failure and Recovery</h4></div></div></div><p>The figure below illustrates a sequence of events whereby the master suffers a failure
 	  and the replica is made the master to allow the clients to continue to work. Later the
 	  old master is repaired and comes back on-line in replica role.</p><p>The item numbers in this list apply to the numbered boxes in the figure below.</p><div class="orderedlist"><ol type="1"><li><p>System operating normally</p></li><li><p>Master suffers a failure and disconnects all clients. Replica realises that it is no
 	      longer in contact with master. Clients begin to try to reconnect to the cluster, although these
@@ -29,7 +29,7 @@
            to designate the replica as primary, allowing it to assume the role of master despite the other node being down.
            This primary designation is performed using <a class="link" href="Java-Broker-High-Availability-JMXAPI.html" title="12.8. Qpid JMX API for HA">JMX</a>.</p></li><li><p>Client connections to the new master succeed and the <span class="bold"><strong>service is restored
 	      </strong></span>, albeit without a replica.</p></li><li><p>The old master is repaired and brought back on-line.  It automatically rejoins the cluster
-	       in the <span class="bold"><strong>replica</strong></span> role.</p></li></ol></div><div class="figure"><a name="id2496695"></a><p class="title"><b>Figure 12.3. Failure of master and recovery sequence</b></p><div class="figure-contents"><div class="mediaobject"><img src="images/HA-2N-MasterFail.png" alt="Failure of master and subsequent recovery sequence"></div></div></div><br class="figure-break"></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="Java-Broker-High-Availability-TwoNodeReplicaFailure"></a>12.3.2.3. Replica Failure and Recovery</h4></div></div></div><p>The figure that follows illustrates a sequence of events whereby the replica suffers a failure
+	       in the <span class="bold"><strong>replica</strong></span> role.</p></li></ol></div><div class="figure"><a name="id2495656"></a><p class="title"><b>Figure 12.3. Failure of master and recovery sequence</b></p><div class="figure-contents"><div class="mediaobject"><img src="images/HA-2N-MasterFail.png" alt="Failure of master and subsequent recovery sequence"></div></div></div><br class="figure-break"></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="Java-Broker-High-Availability-TwoNodeReplicaFailure"></a>12.3.2.3. Replica Failure and Recovery</h4></div></div></div><p>The figure that follows illustrates a sequence of events whereby the replica suffers a failure
 	   leaving the master to continue processing alone.  Later the replica is repaired and is restarted.
 	   It rejoins the cluster so that it is once again ready to take over in the event of master failure.</p><p>The behavior of the replica failure case is governed by the <code class="varname">designatedPrimary</code>
         configuration item. If set true on the master, the master will continue to operate solo without outside
@@ -38,14 +38,14 @@
 	   that <code class="varname">designatedPrimary</code> is true on the original master node.</p><div class="orderedlist"><ol type="1"><li><p>System operating normally</p></li><li><p>Replica suffers a failure. Master realises that replica longer in contact but as
 	      <code class="varname">designatedPrimary</code> is true, master continues processing solo and thus client
 	      connections are uninterrupted by the loss of the replica. System continues operating normally, albeit
-          with a single node.</p></li><li><p>Replica is repaired.</p></li><li><p>After catching up with missed work, replica is once again ready to take over in the event of master failure.</p></li></ol></div><div class="figure"><a name="id2501904"></a><p class="title"><b>Figure 12.4. Failure of replica and subsequent recovery sequence</b></p><div class="figure-contents"><div class="mediaobject"><img src="images/HA-2N-ReplicaFail.png" alt="Failure of replica and subsequent recovery sequence"></div></div></div><br class="figure-break"></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="Java-Broker-High-Availability-TwoNodeNetworkPartition"></a>12.3.2.4. Network Partition and Recovery</h4></div></div></div><p>The figure below illustrates the sequence of events that would occur if the network between
+          with a single node.</p></li><li><p>Replica is repaired.</p></li><li><p>After catching up with missed work, replica is once again ready to take over in the event of master failure.</p></li></ol></div><div class="figure"><a name="id2501945"></a><p class="title"><b>Figure 12.4. Failure of replica and subsequent recovery sequence</b></p><div class="figure-contents"><div class="mediaobject"><img src="images/HA-2N-ReplicaFail.png" alt="Failure of replica and subsequent recovery sequence"></div></div></div><br class="figure-break"></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="Java-Broker-High-Availability-TwoNodeNetworkPartition"></a>12.3.2.4. Network Partition and Recovery</h4></div></div></div><p>The figure below illustrates the sequence of events that would occur if the network between
 	  master and replica were to suffer a partition, and the nodes were out of contact with one and other.</p><p>As with <a class="link" href="Java-Broker-High-Availability-TwoNodeCluster.html#Java-Broker-High-Availability-TwoNodeReplicaFailure" title="12.3.2.3. Replica Failure and Recovery">Replica Failure and Recovery</a>, the
 	  behaviour is governed by the <code class="varname">designatedPrimary</code>.
 	  Only if <code class="varname">designatedPrimary</code> is true on the master, will the master continue solo.</p><p>The item numbers in this list apply to the numbered boxes in the figure below. This example assumes
 	   that <code class="varname">designatedPrimary</code> is true on the original master node.</p><div class="orderedlist"><ol type="1"><li><p>System operating normally</p></li><li><p>Network suffers a failure. Master realises that replica longer in contact but as
 	      <code class="varname">designatedPrimary</code> is true, master continues processing solo and thus client
 	      connections are uninterrupted by the network partition between master and replica.</p></li><li><p>Network is repaired.</p></li><li><p>After catching up with missed work, replica is once again ready to take over in the event of master failure.
-	    System operating normally again.</p></li></ol></div><div class="figure"><a name="id2502032"></a><p class="title"><b>Figure 12.5. Partition of the network separating master and replica</b></p><div class="figure-contents"><div class="mediaobject"><img src="images/HA-2N-NetworkPartition.png" alt="Network Partition and Recovery"></div></div></div><br class="figure-break"></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="Java-Broker-High-Availability-TwoNodeSplitBrain"></a>12.3.2.5. Split Brain</h4></div></div></div><p>A <a class="ulink" href="http://en.wikipedia.org/wiki/Split-brain_(computing)" target="_top">split-brain</a>
+	    System operating normally again.</p></li></ol></div><div class="figure"><a name="id2502073"></a><p class="title"><b>Figure 12.5. Partition of the network separating master and replica</b></p><div class="figure-contents"><div class="mediaobject"><img src="images/HA-2N-NetworkPartition.png" alt="Network Partition and Recovery"></div></div></div><br class="figure-break"></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="Java-Broker-High-Availability-TwoNodeSplitBrain"></a>12.3.2.5. Split Brain</h4></div></div></div><p>A <a class="ulink" href="http://en.wikipedia.org/wiki/Split-brain_(computing)" target="_top">split-brain</a>
           is a situation where the two node cluster has two masters. BDB normally strives to prevent
 	  this situation arising by preventing two nodes in a cluster being master at the same time.
 	  However, if the network suffers a partition, and the third-party intervenes incorrectly
@@ -56,4 +56,4 @@
 	      <code class="varname">designatedPrimary</code> is true, master continues processing solo.  Client
 	      connections are uninterrupted by the network partition.</p><p>A third-party <span class="bold"><strong>erroneously</strong></span> designates the replica as primary while the
             original master continues running (now solo).</p></li><li><p>As the nodes cannot see one and other, both behave as masters. Clients may perform work against
-	      both master nodes.</p></li></ol></div><div class="figure"><a name="id2502166"></a><p class="title"><b>Figure 12.6. Split Brain</b></p><div class="figure-contents"><div class="mediaobject"><img src="images/HA-2N-SplitBrain.png" alt="Split Brain"></div></div></div><br class="figure-break"></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-High-Availability-OfferingsOfJavaBroker.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="Java-Broker-High-Availability.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="Java-Broker-High-Availability-MultiNodeCluster.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">12.2. HA offerings of the Java Broker </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 12.4.Â
 Multi Node Cluster</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>
+	      both master nodes.</p></li></ol></div><div class="figure"><a name="id2502207"></a><p class="title"><b>Figure 12.6. Split Brain</b></p><div class="figure-contents"><div class="mediaobject"><img src="images/HA-2N-SplitBrain.png" alt="Split Brain"></div></div></div><br class="figure-break"></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-High-Availability-OfferingsOfJavaBroker.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="Java-Broker-High-Availability.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="Java-Broker-High-Availability-MultiNodeCluster.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">12.2. HA offerings of the Java Broker </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 12.4.Â
 Multi Node Cluster</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>

Modified: qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-High-Availability.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-High-Availability.html?rev=1419155&r1=1419154&r2=1419155&view=diff
==============================================================================
--- qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-High-Availability.html (original)
+++ qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-High-Availability.html Sun Dec  9 20:44:07 2012
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 12. High Availability</title><link rel="stylesheet" href="css/style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" 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-Runtime-Disk-Space-Management.html" title="11.3. Disk Space Management"><link rel="next" href="Java-Broker-High-Availability-OfferingsOfJavaBroker.html" title="12.2. HA offerings of the Java Broker"></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> &gt; <span class="breadcrumb-node">High Availability</span></DIV><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-High-Availability"></a>Chapter 12. High Availability</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="Java-Broker-High-Availability.html#Java-Broker-High-Availability-GeneralIntroduction">12.1. General Introdu
 ction</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-OfferingsOfJavaBroker.html">12.2. HA offerings of the Java Broker</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-TwoNodeCluster.html">12.3. Two Node Cluster</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-High-Availability-TwoNodeCluster.html#id2495669">12.3.1. Overview</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-TwoNodeCluster.html#id2495746">12.3.2. Depictions of cluster operation</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-High-Availability-MultiNodeCluster.html">12.4. Multi Node Cluster</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-Configuration.html">12.5. Configuring a Virtual Host to be a node</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-High-Availability-Configuration.html#Java-Broker-High-Availability-Confi
 guration_BDBEnvVars">12.5.1. Passing BDB environment and replication configuration options</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-High-Availability-DurabilityGuarantee.html">12.6. Durability Guarantees</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-High-Availability-DurabilityGuarantee.html#Java-Broker-High-Availability-DurabilityGuarantee_BDBControls">12.6.1. BDB Durability Controls</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-DurabilityGuarantee.html#Java-Broker-High-Availability-DurabilityGuarantee_CoalescingSync">12.6.2. Coalescing-sync</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-DurabilityGuarantee.html#Java-Broker-High-Availability-DurabilityGuarantee_Default">12.6.3. Default</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-DurabilityGuarantee.html#Java-Broker-High-Availability-DurabilityGuarantee_Examples">12.6.4
 . Examples</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-High-Availability-ClientFailover.html">12.7. Client failover configuration</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-JMXAPI.html">12.8. Qpid JMX API for HA</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-Monitoring-cluster.html">12.9. Monitoring cluster</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-DiskSpace.html">12.10. Disk space requirements</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-Network-Requirements.html">12.11. Network Requirements</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-Security.html">12.12. Security</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-Backup.html">12.13. Backups</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-MigrationFromNonHA.ht
 ml">12.14. Migration of a non-HA store to HA</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-DisasterRecovery.html">12.15. Disaster Recovery</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-Performance.html">12.16. Performance</a></span></dt></dl></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-High-Availability-GeneralIntroduction"></a>12.1. General Introduction</h2></div></div></div><p>The term High Availability (HA) usually refers to having a number of instances of a service such as a Message Broker
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 12. High Availability</title><link rel="stylesheet" href="css/style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" 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-Runtime-Disk-Space-Management.html" title="11.3. Disk Space Management"><link rel="next" href="Java-Broker-High-Availability-OfferingsOfJavaBroker.html" title="12.2. HA offerings of the Java Broker"></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> &gt; <span class="breadcrumb-node">High Availability</span></DIV><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-High-Availability"></a>Chapter 12. High Availability</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="Java-Broker-High-Availability.html#Java-Broker-High-Availability-GeneralIntroduction">12.1. General Introdu
 ction</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-OfferingsOfJavaBroker.html">12.2. HA offerings of the Java Broker</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-TwoNodeCluster.html">12.3. Two Node Cluster</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-High-Availability-TwoNodeCluster.html#id2496556">12.3.1. Overview</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-TwoNodeCluster.html#id2496637">12.3.2. Depictions of cluster operation</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-High-Availability-MultiNodeCluster.html">12.4. Multi Node Cluster</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-Configuration.html">12.5. Configuring a Virtual Host to be a node</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-High-Availability-Configuration.html#Java-Broker-High-Availability-Confi
 guration_BDBEnvVars">12.5.1. Passing BDB environment and replication configuration options</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-High-Availability-DurabilityGuarantee.html">12.6. Durability Guarantees</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-High-Availability-DurabilityGuarantee.html#Java-Broker-High-Availability-DurabilityGuarantee_BDBControls">12.6.1. BDB Durability Controls</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-DurabilityGuarantee.html#Java-Broker-High-Availability-DurabilityGuarantee_CoalescingSync">12.6.2. Coalescing-sync</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-DurabilityGuarantee.html#Java-Broker-High-Availability-DurabilityGuarantee_Default">12.6.3. Default</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-DurabilityGuarantee.html#Java-Broker-High-Availability-DurabilityGuarantee_Examples">12.6.4
 . Examples</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-High-Availability-ClientFailover.html">12.7. Client failover configuration</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-JMXAPI.html">12.8. Qpid JMX API for HA</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-Monitoring-cluster.html">12.9. Monitoring cluster</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-DiskSpace.html">12.10. Disk space requirements</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-Network-Requirements.html">12.11. Network Requirements</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-Security.html">12.12. Security</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-Backup.html">12.13. Backups</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-MigrationFromNonHA.ht
 ml">12.14. Migration of a non-HA store to HA</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-DisasterRecovery.html">12.15. Disaster Recovery</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-Performance.html">12.16. Performance</a></span></dt></dl></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-High-Availability-GeneralIntroduction"></a>12.1. General Introduction</h2></div></div></div><p>The term High Availability (HA) usually refers to having a number of instances of a service such as a Message Broker
       available so that should a service unexpectedly fail, or requires to be shutdown for maintenance, users may quickly connect
       to another instance and continue their work with minimal interuption. HA is one way to make a overall system more resilient
       by eliminating a single point of failure from a system.</p><p>HA offerings are usually categorised as <span class="bold"><strong>Active/Active</strong></span> or <span class="bold"><strong>Active/Passive</strong></span>.

Modified: qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Installation-Download.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Installation-Download.html?rev=1419155&r1=1419154&r2=1419155&view=diff
==============================================================================
--- qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Installation-Download.html (original)
+++ qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Installation-Download.html Sun Dec  9 20:44:07 2012
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>2.3. Download</title><link rel="stylesheet" href="css/style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="up" href="Java-Broker-Installation.html" title="Chapter 2. Installation"><link rel="prev" href="Java-Broker-Installation-Prerequistes.html" title="2.2. Prerequisites"><link rel="next" href="Java-Broker-Installation-InstallationWindows.html" title="2.4. Installation on Windows"></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> &gt; <span class="breadcrumb-link"><a href="Java-Broker-Installation.html">Installation</a></span> &gt; <span class="breadcrumb-node">Download</span></DIV><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Installation-Download"></a>2.3. Download</h2></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Installation-Download-Release"></a>2.3.1.Â
 Broker Release</h3></div></div></div><p>You can download the latest qpid-java-broker-0.18.tar.gz package from the <a class="ulink" href="http://qpid.apache.org/download.html" target="_top">Download Page</a>.
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>2.3. Download</title><link rel="stylesheet" href="css/style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="up" href="Java-Broker-Installation.html" title="Chapter 2. Installation"><link rel="prev" href="Java-Broker-Installation-Prerequistes.html" title="2.2. Prerequisites"><link rel="next" href="Java-Broker-Installation-InstallationWindows.html" title="2.4. Installation on Windows"></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> &gt; <span class="breadcrumb-link"><a href="Java-Broker-Installation.html">Installation</a></span> &gt; <span class="breadcrumb-node">Download</span></DIV><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Installation-Download"></a>2.3. Download</h2></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Installation-Download-Release"></a>2.3.1.Â
 Broker Release</h3></div></div></div><p>You can download the latest qpid-java-broker-0.20.tar.gz package from the <a class="ulink" href="http://qpid.apache.org/download.html" target="_top">Download Page</a>.
       </p><p> It is recommended that you confirm the integrity of the download by verifying the PGP signature
         matches that available on the site. Instrutions are given on the download page.
       </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Installation-Download-OptionalDependencies"></a>2.3.2. Optional Dependencies</h3></div></div></div><p>The broker has an optional message store implementations backed by Oracle BDB JE. If you wish to use these

Modified: qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Installation-InstallationUnix.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Installation-InstallationUnix.html?rev=1419155&r1=1419154&r2=1419155&view=diff
==============================================================================
--- qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Installation-InstallationUnix.html (original)
+++ qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Installation-InstallationUnix.html Sun Dec  9 20:44:07 2012
@@ -3,9 +3,9 @@
       <a class="link" href="Java-Broker-Miscellaneous.html#Java-Broker-Miscellaneous-JVM-Verification-Unix" title="13.1.2. Verify JVM on Windows">these instructions.</a>
     </p><p>Now chose a directory for Qpid broker installation.  This directory will be used for the Qpid JARs and configuration files.
       It need not be the same location as the store used for the persistent messages or the log file (you will chose this
-      location later).   For the remainder this example we will assumed that location /usr/local/qpid has been chosen.</p><p>Extract the Qpid package qpid-java-broker-0.18.tar.gz into the directory.</p><pre class="programlisting">mkdir /usr/local/qpid
+      location later).   For the remainder this example we will assumed that location /usr/local/qpid has been chosen.</p><p>Extract the Qpid package qpid-java-broker-0.20.tar.gz into the directory.</p><pre class="programlisting">mkdir /usr/local/qpid
 cd /usr/local/qpid
-tar xvzf qpid-java-broker-0.18.tar.gz&gt;</pre><p>The extraction of the Qpid package will have created a directory qpid-broker-x.x</p><pre class="screen">ls -la qpid-broker-0.18/
+tar xvzf qpid-java-broker-0.20.tar.gz&gt;</pre><p>The extraction of the Qpid package will have created a directory qpid-broker-x.x</p><pre class="screen">ls -la qpid-broker-0.20/
 total 152
 drwxr-xr-x   8 qpid  qpid    272 25 Jul 23:22 .
 drwxr-xr-x  45 qpid  qpid   1530 30 Sep 10:51 ..

Modified: qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Installation-InstallationWindows.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Installation-InstallationWindows.html?rev=1419155&r1=1419154&r2=1419155&view=diff
==============================================================================
--- qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Installation-InstallationWindows.html (original)
+++ qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Installation-InstallationWindows.html Sun Dec  9 20:44:07 2012
@@ -4,9 +4,9 @@
     </p><p>Now chose a directory for Qpid broker installation.  This directory will be used for the Qpid JARs and configuration files.
       It need not be the same location as the store used for the persistent messages or the log file (you will chose this
       location later).   For the remainder this example we will assumed that location c:\qpid has been chosen.</p><p>Now using WinZip<sup>[<a name="id2494163" href="#ftn.id2494163" class="footnote">4</a>]</sup> (or similar)
-      extract the Qpid package qpid-java-broker-0.18.tar.gz into the directory.</p><p>The extraction of the Qpid package will have created a directory qpid-broker-0.18 within c:\qpid</p><pre class="screen">Volume in drive C has no label
+      extract the Qpid package qpid-java-broker-0.20.tar.gz into the directory.</p><p>The extraction of the Qpid package will have created a directory qpid-broker-0.20 within c:\qpid</p><pre class="screen">Volume in drive C has no label
 
- Directory of c:\qpid\qpid-broker-0.18
+ Directory of c:\qpid\qpid-broker-0.20
 
 07/25/2012  11:22 PM                   .
 09/30/2012  10:51 AM                   ..

Modified: qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Queues-OtherTypes.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Queues-OtherTypes.html?rev=1419155&r1=1419154&r2=1419155&view=diff
==============================================================================
--- qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Queues-OtherTypes.html (original)
+++ qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Queues-OtherTypes.html Sun Dec  9 20:44:07 2012
@@ -27,7 +27,7 @@
       define a queue which it both an LVQ and a priority-queue.</p><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="Java-Broker-Queues-OtherTypes-CreateUsingConfig"></a>7.2.5.1. Using configuration</h4></div></div></div><p>To create a priority, sorted or LVQ queue within configuration, add the appropriate xml
         to the virtualhost.xml configuration file within the <code class="varname">queues</code>
         element.</p><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="Java-Broker-Queues-OtherTypes-CreateUsingConfig-Priority"></a>Priority</h5></div></div></div><p> To defining a priority queue, add a &lt;priority&gt;true&lt;/priority&gt; element. By
-          default the queue will have 10 distinct priorities. </p><div class="example"><a name="id2492825"></a><p class="title"><b>Example 7.1. Configuring a priority queue</b></p><div class="example-contents"><pre class="programlisting">&lt;queue&gt;
+          default the queue will have 10 distinct priorities. </p><div class="example"><a name="id2495180"></a><p class="title"><b>Example 7.1. Configuring a priority queue</b></p><div class="example-contents"><pre class="programlisting">&lt;queue&gt;
     &lt;name&gt;myqueue&lt;/name&gt;
     &lt;myqueue&gt;
         &lt;exchange&gt;amq.direct&lt;/exchange&gt;
@@ -39,7 +39,7 @@
           sent to that queue, their effective priority will be calculated by partitioning the
           priority space. If the number of effective priorities is 2, then messages with priority
           0-4 are treated the same as "lower priority" and messages with priority 5-9 are treated
-          equivalently as "higher priority". </p><div class="example"><a name="id2495190"></a><p class="title"><b>Example 7.2. Configuring a priority queue with fewer priorities</b></p><div class="example-contents"><pre class="programlisting">&lt;queue&gt;
+          equivalently as "higher priority". </p><div class="example"><a name="id2495209"></a><p class="title"><b>Example 7.2. Configuring a priority queue with fewer priorities</b></p><div class="example-contents"><pre class="programlisting">&lt;queue&gt;
     &lt;name&gt;myqueue&lt;/name&gt;
     &lt;myqueue&gt;
         &lt;exchange&gt;amq.direct&lt;/exchange&gt;
@@ -48,7 +48,7 @@
     &lt;/myqueue&gt;
 &lt;/queue&gt;</pre></div></div><br class="example-break"></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="Java-Broker-Queues-OtherTypes-CreateUsingConfig-Sorted"></a>Sorted</h5></div></div></div><p> To define a sorted queue, add a <code class="varname">sortKey</code> element. The value of the
             <code class="varname">sortKey</code> element defines the message property to use the value of when
-          sorting the messages put onto the queue. </p><div class="example"><a name="id2495228"></a><p class="title"><b>Example 7.3. Configuring a sorted queue</b></p><div class="example-contents"><pre class="programlisting">&lt;queue&gt;
+          sorting the messages put onto the queue. </p><div class="example"><a name="id2495246"></a><p class="title"><b>Example 7.3. Configuring a sorted queue</b></p><div class="example-contents"><pre class="programlisting">&lt;queue&gt;
     &lt;name&gt;myqueue&lt;/name&gt;
     &lt;myqueue&gt;
         &lt;exchange&gt;amq.direct&lt;/exchange&gt;
@@ -57,14 +57,14 @@
 &lt;/queue&gt;</pre></div></div><br class="example-break"></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="Java-Broker-Queues-OtherTypes-CreateUsingConfig-LVQ"></a>LVQ</h5></div></div></div><p> To define a LVQ, add a <code class="varname">lvq</code> element with the value
             <code class="constant">true</code>. Without any further configuration this will define an LVQ
           which uses the JMS message property <code class="constant">qpid.LVQ_key</code> as the key for
-          replacement. </p><div class="example"><a name="id2495407"></a><p class="title"><b>Example 7.4. Configuring a LVQ queue</b></p><div class="example-contents"><pre class="programlisting">&lt;queue&gt;
+          replacement. </p><div class="example"><a name="id2495416"></a><p class="title"><b>Example 7.4. Configuring a LVQ queue</b></p><div class="example-contents"><pre class="programlisting">&lt;queue&gt;
     &lt;name&gt;myqueue&lt;/name&gt;
     &lt;myqueue&gt;
         &lt;exchange&gt;amq.direct&lt;/exchange&gt;
         &lt;lvq&gt;true&lt;/lvq&gt;
     &lt;/myqueue&gt;
 &lt;/queue&gt;</pre></div></div><br class="example-break"><p> If you wish to define your own property then you can do so using the
-            <code class="varname">lvqKey</code> element.</p><div class="example"><a name="id2495426"></a><p class="title"><b>Example 7.5. Configuring a LVQ queue with custom message property name</b></p><div class="example-contents"><pre class="programlisting">&lt;queue&gt;
+            <code class="varname">lvqKey</code> element.</p><div class="example"><a name="id2495436"></a><p class="title"><b>Example 7.5. Configuring a LVQ queue with custom message property name</b></p><div class="example-contents"><pre class="programlisting">&lt;queue&gt;
     &lt;name&gt;myqueue&lt;/name&gt;
     &lt;myqueue&gt;
         &lt;exchange&gt;amq.direct&lt;/exchange&gt;
@@ -72,14 +72,14 @@
         &lt;lvqKey&gt;ISIN&lt;/lvqKey&gt;
     &lt;/myqueue&gt;
 &lt;/queue&gt;</pre></div></div><br class="example-break"></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="Java-Broker-Queues-OtherTypes-CreateUsingJmsOrJmx"></a>7.2.5.2. Using JMX or AMQP</h4></div></div></div><p>To create a priority, sorted or LVQ queue programmatically from JMX or using a Qpid
-        extension to JMS, pass the appropriate queue-declare arguments.</p><div class="table"><a name="id2495459"></a><p class="title"><b>Table 7.1. Queue-declare arguments understood for priority, sorted and LVQ queues</b></p><div class="table-contents"><table summary="Queue-declare arguments understood for priority, sorted and LVQ queues" border="1"><colgroup><col><col><col><col></colgroup><thead><tr><th>Queue type</th><th>Argument name</th><th>Argument name</th><th>Argument Description</th></tr></thead><tbody><tr><td>priority</td><td>priorities</td><td>java.lang.Integer</td><td>Specifies a priority queue with given number priorities</td></tr><tr><td>sorted</td><td>qpid.queue_sort_key</td><td>java.lang.String</td><td>Specifies sorted queue with given message property used to sort the
+        extension to JMS, pass the appropriate queue-declare arguments.</p><div class="table"><a name="id2495468"></a><p class="title"><b>Table 7.1. Queue-declare arguments understood for priority, sorted and LVQ queues</b></p><div class="table-contents"><table summary="Queue-declare arguments understood for priority, sorted and LVQ queues" border="1"><colgroup><col><col><col><col></colgroup><thead><tr><th>Queue type</th><th>Argument name</th><th>Argument name</th><th>Argument Description</th></tr></thead><tbody><tr><td>priority</td><td>priorities</td><td>java.lang.Integer</td><td>Specifies a priority queue with given number priorities</td></tr><tr><td>sorted</td><td>qpid.queue_sort_key</td><td>java.lang.String</td><td>Specifies sorted queue with given message property used to sort the
                 entries</td></tr><tr><td>lvq</td><td>qpid.last_value_queue_key</td><td>java.lang.String</td><td>Specifies lvq queue with given message property used to conflate the
                 entries</td></tr></tbody></table></div></div><br class="table-break"><p>The following example illustrates the creation of the a LVQ queue from a
         javax.jms.Session object. Note that this utilises a Qpid specific extension to JMS and
-        involves casting the session object back to its Qpid base-class.</p><div class="example"><a name="id2494793"></a><p class="title"><b>Example 7.6. Creation of an LVQ using the Qpid extension to JMS</b></p><div class="example-contents"><pre class="programlisting">Map&lt;String,Object&gt; arguments = new HashMap&lt;String, Object&gt;();
+        involves casting the session object back to its Qpid base-class.</p><div class="example"><a name="id2494802"></a><p class="title"><b>Example 7.6. Creation of an LVQ using the Qpid extension to JMS</b></p><div class="example-contents"><pre class="programlisting">Map&lt;String,Object&gt; arguments = new HashMap&lt;String, Object&gt;();
 arguments.put("qpid.last_value_queue_key","ISIN");
 ((AMQSession&lt;?,?&gt;) session).createQueue(queueName, autoDelete, durable, exclusive, arguments);</pre></div></div><br class="example-break"><p> The following example illustrates the creation of the sorted queue from a the JMX
-        interface using the ManagedBroker interface. </p><div class="example"><a name="id2494813"></a><p class="title"><b>Example 7.7. Creation of a sorted queue using JMX</b></p><div class="example-contents"><pre class="programlisting">Map&lt;String, Object&gt; environment = new HashMap&lt;String, Object&gt;();
+        interface using the ManagedBroker interface. </p><div class="example"><a name="id2494822"></a><p class="title"><b>Example 7.7. Creation of a sorted queue using JMX</b></p><div class="example-contents"><pre class="programlisting">Map&lt;String, Object&gt; environment = new HashMap&lt;String, Object&gt;();
 environment.put(JMXConnector.CREDENTIALS, new String[] {"admin","password"});
 // Connect to service
 JMXServiceURL url =  new JMXServiceURL("service:jmx:rmi:///jndi/rmi://localhost:8999/jmxrmi");

Modified: qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Runtime-Disk-Space-Management.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Runtime-Disk-Space-Management.html?rev=1419155&r1=1419154&r2=1419155&view=diff
==============================================================================
--- qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Runtime-Disk-Space-Management.html (original)
+++ qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Runtime-Disk-Space-Management.html Sun Dec  9 20:44:07 2012
@@ -3,7 +3,7 @@
             into the Java Messaging Broker, causing producers to be flow-controlled when they
             attempt to send messages to an overfull queue. Qpid 0.18 introduced a similar
             mechanism triggered by an overfull persistent message store on a virtual host.
-        </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="Java-Broker-Runtime-Disk-Space-Management-Producer-Flow-Control-ServerConfiguration"></a>11.3.1.2. Server Configuration</h4></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="id2492591"></a>Configuring a Queue to use flow control</h5></div></div></div><p>
+        </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="Java-Broker-Runtime-Disk-Space-Management-Producer-Flow-Control-ServerConfiguration"></a>11.3.1.2. Server Configuration</h4></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="id2496296"></a>Configuring a Queue to use flow control</h5></div></div></div><p>
                 Flow control is enabled on a producer when it sends a message to a Queue
                 which is "overfull". The producer flow control will be rescinded when all
                 Queues on which a producer is blocking become "underfull". A Queue is defined
@@ -12,7 +12,7 @@
                 less than the "flowResumeCapacity".
 
 
-             </p><div class="example"><a name="id2492610"></a><p class="title"><b>Example 11.1. Configuring a queue depth limit</b></p><div class="example-contents"><pre class="programlisting">
+             </p><div class="example"><a name="id2498101"></a><p class="title"><b>Example 11.1. Configuring a queue depth limit</b></p><div class="example-contents"><pre class="programlisting">
                 
 &lt;queue&gt;
     &lt;name&gt;test&lt;/name&gt;
@@ -27,7 +27,7 @@
 
                 The default for all queues on a virtual host can also be set
 
-             </p><div class="example"><a name="id2492627"></a><p class="title"><b>Example 11.2. Configuring a default queue depth limit on a virtualhost</b></p><div class="example-contents"><pre class="programlisting">
+             </p><div class="example"><a name="id2496326"></a><p class="title"><b>Example 11.2. Configuring a default queue depth limit on a virtualhost</b></p><div class="example-contents"><pre class="programlisting">
                 
 &lt;virtualhosts&gt;
     &lt;virtualhost&gt;
@@ -44,7 +44,7 @@
                 Where no flowResumeCapacity is set, the flowResumeCapacity is set to be equal
                 to the capacity. Where no capacity is set, capacity is defaulted to 0 meaning
                 there is no capacity limit.
-            </p><div class="section" lang="en"><div class="titlepage"><div><div><h6 class="title"><a name="id2492650"></a>Broker Log Messages</h6></div></div></div><p>
+            </p><div class="section" lang="en"><div class="titlepage"><div><div><h6 class="title"><a name="id2496350"></a>Broker Log Messages</h6></div></div></div><p>
                     There are four new Broker log messages that may occur if flow control through queue capacity limits is enabled.
                     Firstly, when a capacity limited queue becomes overfull, a log message similar to the following is produced
                 </p><pre class="programlisting">
@@ -55,7 +55,7 @@ MESSAGE [con:2(guest@anonymous(713889609
 MESSAGE [vh(/test)/qu(MyQueue)] [vh(/test)/qu(MyQueue)] QUE-1004 : Underfull : Size : 600 bytes, Resume Capacity : 800
                 </pre><p>And for every channel which becomes unblocked you will see a message similar to: </p><pre class="programlisting">
 MESSAGE [con:2(guest@anonymous(713889609)/test)/ch:1] [con:2(guest@anonymous(713889609)/test)/ch:1] CHN-1006 : Flow Control Removed
-                </pre><p>Obviously the details of connection, virtual host, queue, size, capacity, etc would depend on the configuration in use.</p></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="id2494513"></a>Disk quota-based flow control</h5></div></div></div><p>
+                </pre><p>Obviously the details of connection, virtual host, queue, size, capacity, etc would depend on the configuration in use.</p></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="id2494499"></a>Disk quota-based flow control</h5></div></div></div><p>
                 Since version 0.18 of Qpid Broker, flow control can be triggered when a
                 configured disk quota is exceeded. This is supported by the BDB and Derby message stores.
             </p><p>
@@ -70,7 +70,7 @@ MESSAGE [con:2(guest@anonymous(713889609
                 underfull limit - when the space on disk drops below this limit, producers are allowed to resume publishing.
             </p><p>
                 An example of quota configuration for the BDB message store is provided below.
-            </p><div class="example"><a name="id2494559"></a><p class="title"><b>Example 11.3. Configuring a limit on a store</b></p><div class="example-contents"><pre class="programlisting">
+            </p><div class="example"><a name="id2494544"></a><p class="title"><b>Example 11.3. Configuring a limit on a store</b></p><div class="example-contents"><pre class="programlisting">
             
 &lt;store&gt;
    &lt;class&gt;org.apache.qpid.server.store.berkeleydb.BDBMessageStore&lt;/class&gt;
@@ -84,7 +84,7 @@ MESSAGE [con:2(guest@anonymous(713889609
                 cannot guarantee that the disk space limit will not be exceeded. If several concurrent
                 transactions are started before the limit is reached, which collectively cause the limit
                 to be exceeded, the broker may allow all of them to be committed.
-            </p><div class="section" lang="en"><div class="titlepage"><div><div><h6 class="title"><a name="id2494585"></a>Broker Log Messages for quota flow control</h6></div></div></div><p>
+            </p><div class="section" lang="en"><div class="titlepage"><div><div><h6 class="title"><a name="id2494571"></a>Broker Log Messages for quota flow control</h6></div></div></div><p>
                     There are 2 new broker log messages that may occur if flow control through disk quota limits is enabled.
                     When the virtual host is blocked due to exceeding of the disk quota limit the following message
                     appears in the broker log
@@ -127,6 +127,6 @@ WARN   Message send delayed by 10s due t
         </p><pre class="programlisting">
 -Dqpid.flow_control_wait_failure=60000
 -Dqpid.flow_control_wait_notify_period=10000
-        </pre><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="id2496151"></a>Older Clients</h5></div></div></div><p>
+        </pre><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="id2496096"></a>Older Clients</h5></div></div></div><p>
                 The flow control feature was first added to the Java broker/client in the 0.6 release. If an older client connects to the broker then the flow control commands will be ignored by it and it will not be blocked. So to fully benefit from this feature both Client and Broker need to be at least version 0.6.
             </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-Runtime-Alerts.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="Java-Broker-Runtime.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="Java-Broker-High-Availability.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">11.2. Alerts </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 12. High Availability</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>

Modified: qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Security-Authentication-Providers.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Security-Authentication-Providers.html?rev=1419155&r1=1419154&r2=1419155&view=diff
==============================================================================
--- qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Security-Authentication-Providers.html (original)
+++ qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Security-Authentication-Providers.html Sun Dec  9 20:44:07 2012
@@ -3,16 +3,38 @@
     authenticated. The Java Broker supports a number of different authentication schemes, each
     with its own "authentication manager". Each of these are outlined below, along with details
     of <a class="link" href="Java-Broker-Security-Authentication-Providers.html#MultipleAuthProviders" title="10.3.6. Configuring multiple Authentication Providers"> using more than one at a time</a>.
-  </p><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2496500"></a>10.3.1. Password File</h3></div></div></div><p>
+  </p><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2496961"></a>10.3.1. Password File</h3></div></div></div><p>
       TODO
-    </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2496511"></a>10.3.2. LDAP</h3></div></div></div><div class="example"><a name="id2496517"></a><p class="title"><b>Example 10.1. Configuring LDAP authentication</b></p><div class="example-contents"><pre class="programlisting">
+    </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="LDAPAuthManager"></a>10.3.2. LDAP</h3></div></div></div><p>
+    LDAP authentication can be configured using the &lt;simple-ldap-auth-manager&gt; element
+    within the &lt;security&gt; section. An example of how to configure this is shown below.
+    Please note this example also configures an unused &lt;pd-auth-manager&gt; to use an empty
+    password file, this is a workaround for an issue relating to registration of security providers.
+  </p><p>
+    <span class="emphasis"><em>NOTE: When using LDAP authentication, you must also use SSL on the brokers AMQP messaging and
+    JMX/HTTP management ports in order to protect passwords during transmission to the broker.</em></span>
+  </p><div class="example"><a name="id2497001"></a><p class="title"><b>Example 10.1. Configuring LDAP authentication</b></p><div class="example-contents"><pre class="programlisting">
 &lt;security&gt;
-    &lt;simple-ldap-auth-manager&gt;
-      &lt;provider-url&gt;ldaps://example.com:636/&lt;/provider-url&gt;
-      &lt;search-context&gt;dc=example\,dc=com&lt;/search-context&gt;
-      &lt;search-filter&gt;(uid={0})&lt;/search-filter&gt;
-    &lt;/simple-ldap-auth-manager&gt;
-    ...
+  &lt;default-auth-manager&gt;SimpleLDAPAuthenticationManager&lt;/default-auth-manager&gt;
+  &lt;simple-ldap-auth-manager&gt;
+    &lt;provider-url&gt;ldaps://example.com:636/&lt;/provider-url&gt;
+    &lt;search-context&gt;dc=example\,dc=com&lt;/search-context&gt;
+    &lt;search-filter&gt;(uid={0})&lt;/search-filter&gt;
+  &lt;/simple-ldap-auth-manager&gt;
+
+  &lt;!-- Unused pd-auth-manager, a workaround to register the necessary security providers --&gt;
+  &lt;pd-auth-manager&gt;
+    &lt;principal-database&gt;
+      &lt;class&gt;org.apache.qpid.server.security.auth.database.PlainPasswordFilePrincipalDatabase&lt;/class&gt;
+      &lt;attributes&gt;
+        &lt;attribute&gt;
+          &lt;name&gt;passwordFile&lt;/name&gt;
+          &lt;value&gt;${conf}/emptyPasswdFile&lt;/value&gt;
+        &lt;/attribute&gt;
+      &lt;/attributes&gt;
+    &lt;/principal-database&gt;
+  &lt;pd-auth-manager&gt;
+  ...
 &lt;/security&gt;</pre></div></div><br class="example-break"><p>
     The authentication manager first connects to the ldap server anonymously and searches for the
     ldap entity which is identified by the username provided over SASL. Essentially the
@@ -31,7 +53,7 @@
   </p><p>
     By default com.sun.jndi.ldap.LdapCtxFactory is used to create the context, however this can be
     overridden by specifying &lt;ldap-context-factory&gt; in the configuration.
-  </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2496994"></a>10.3.3. Kerberos</h3></div></div></div><p>
+  </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2497060"></a>10.3.3. Kerberos</h3></div></div></div><p>
     Kereberos Authentication is configured using the &lt;kerberos-auth-manager&gt; element within
     the &lt;security&gt; section. When referencing from the default-auth-manager or port-mapping
     sections, its name is KerberosAuthenticationManager.
@@ -39,7 +61,7 @@
     Since Kerberos support only works where SASL authentication is available (e.g. not for JMX
     authentication) you may wish to also include an alternative Authentication Manager
     configuration, and use this for other ports:
-  </p><div class="example"><a name="id2497015"></a><p class="title"><b>Example 10.2. Configuring Kerberos authentication</b></p><div class="example-contents"><pre class="programlisting">
+  </p><div class="example"><a name="id2497081"></a><p class="title"><b>Example 10.2. Configuring Kerberos authentication</b></p><div class="example-contents"><pre class="programlisting">
 &lt;security&gt;
   &lt;pd-auth-manager&gt;
     &lt;principal-database&gt;
@@ -102,7 +124,7 @@ com.sun.security.jgss.accept {
       <a class="link" href="Java-Broker-Security-Authentication-Providers.html#MultipleAuthProviders" title="10.3.6. Configuring multiple Authentication Providers">include another Authentication Manager for use on non-AMQP ports</a>,
       as is done in the example below. Perhaps the only exception to this would be where the broker is embedded in a
       container that is itself externally protecting the HTTP interface and then providing the remote users name.
-    </p><div class="example"><a name="id2497143"></a><p class="title"><b>Example 10.3. Configuring external authentication (SSL client auth)</b></p><div class="example-contents"><pre class="programlisting">
+    </p><div class="example"><a name="id2497206"></a><p class="title"><b>Example 10.3. Configuring external authentication (SSL client auth)</b></p><div class="example-contents"><pre class="programlisting">
 &lt;security&gt;
   &lt;pd-auth-manager&gt;
     &lt;principal-database&gt;
@@ -128,7 +150,7 @@ com.sun.security.jgss.accept {
       The AnonymousAuthenticationManager will allow users to connect with or without credentials and result
       in their identification on the broker as the user ANONYMOUS. It may be enabled by adding an empty
       anonymous-auth-manager element to the security configuration section, as shown below.
-    </p><div class="example"><a name="id2497184"></a><p class="title"><b>Example 10.4. Configuring anonymous authentication</b></p><div class="example-contents"><pre class="programlisting">
+    </p><div class="example"><a name="id2497248"></a><p class="title"><b>Example 10.4. Configuring anonymous authentication</b></p><div class="example-contents"><pre class="programlisting">
 &lt;security&gt;
   &lt;anonymous-auth-manager/&gt;
   ...
@@ -146,7 +168,7 @@ com.sun.security.jgss.accept {
       The following configuration sets up three authentication managers, using a password file as the
       default (e.g. for the JMX and HTTP ports), Kerberos on port 5672 (the regular AMQP port) and Anonymous
       on port 5673 (e.g a second AMQP port the broker could have been configured with).
-    </p><div class="example"><a name="id2497235"></a><p class="title"><b>Example 10.5. Configuring multiple (per-port) authentication schemes</b></p><div class="example-contents"><pre class="programlisting">
+    </p><div class="example"><a name="id2497298"></a><p class="title"><b>Example 10.5. Configuring multiple (per-port) authentication schemes</b></p><div class="example-contents"><pre class="programlisting">
 &lt;security&gt;
   &lt;pd-auth-manager&gt;
     &lt;principal-database&gt;

Modified: qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Security-SSL.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Security-SSL.html?rev=1419155&r1=1419154&r2=1419155&view=diff
==============================================================================
--- qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Security-SSL.html (original)
+++ qpid/site/docs/books/0.20/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Security-SSL.html Sun Dec  9 20:44:07 2012
@@ -4,7 +4,7 @@
     </p><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="SSL-Keystore"></a>10.5.1. Keystore Configuration</h3></div></div></div><p>
             The broker configuration file (config.xml) needs to be updated to include the required SSL keystore
             configuration, an example of which can be found below.
-        </p><div class="example"><a name="id2499619"></a><p class="title"><b>Example 10.6. Configuring an SSL Keystore</b></p><div class="example-contents"><pre class="programlisting">
+        </p><div class="example"><a name="id2499691"></a><p class="title"><b>Example 10.6. Configuring an SSL Keystore</b></p><div class="example-contents"><pre class="programlisting">
 &lt;connector&gt;
   ...
   &lt;ssl&gt;
@@ -27,7 +27,7 @@
             The SSL trustore and related Client Certificate Authentication behaviour can be configured with
             additional configuration as shown in the example below, in which the broker requires client
             certificate authentication.
-        </p><div class="example"><a name="id2499676"></a><p class="title"><b>Example 10.7. Configuring an SSL Truststore and client auth</b></p><div class="example-contents"><pre class="programlisting">
+        </p><div class="example"><a name="id2499748"></a><p class="title"><b>Example 10.7. Configuring an SSL Truststore and client auth</b></p><div class="example-contents"><pre class="programlisting">
 &lt;connector&gt;
   ...
   &lt;ssl&gt;



---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@qpid.apache.org
For additional commands, e-mail: commits-help@qpid.apache.org


Mime
View raw message