You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@qpid.apache.org by jo...@apache.org on 2011/02/09 22:39:32 UTC
svn commit: r1069126 [3/24] - in /qpid/site/docs/books:
0.7/AMQP-Messaging-Broker-CPP-Book/html-single/
0.7/AMQP-Messaging-Broker-CPP-Book/html/
0.7/AMQP-Messaging-Broker-CPP-Book/pdf/
0.7/AMQP-Messaging-Broker-Java-Book/AMQP-Messaging-Broker-Java-Book...
Modified: qpid/site/docs/books/0.7/AMQP-Messaging-Broker-CPP-Book/html/ch01.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.7/AMQP-Messaging-Broker-CPP-Book/html/ch01.html?rev=1069126&r1=1069125&r2=1069126&view=diff
==============================================================================
--- qpid/site/docs/books/0.7/AMQP-Messaging-Broker-CPP-Book/html/ch01.html (original)
+++ qpid/site/docs/books/0.7/AMQP-Messaging-Broker-CPP-Book/html/ch01.html Wed Feb 9 21:39:27 2011
@@ -1,6 +1,6 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter 1. Running the AMQP Messaging Broker</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="AMQP Messaging Broker (Implemented in C++)"><link rel="up" href="index.html" title="AMQP Messaging Broker (Implemented in C++)"><link rel="prev" href="pr01.html" title="Introduction"><link rel="next" href="ch01s02.html" title="1.2. Cheat Sheet for configuring Queue Options"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 1.
Running the AMQP Messaging Broker
- </th></tr><tr><td width="20%" align="left"><a accesskey="p" href="pr01.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch01s02.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 1. Running the AMQP Messaging Broker"><div class="titlepage"><div><div><h2 class="title"><a name="id2897868"></a>Chapter 1.
+ </th></tr><tr><td width="20%" align="left"><a accesskey="p" href="pr01.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch01s02.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 1. Running the AMQP Messaging Broker"><div class="titlepage"><div><div><h2 class="title"><a name="id2896436"></a>Chapter 1.
Running the AMQP Messaging Broker
</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="ch01.html#section-Running-a-Qpid-CPP-Broker">1.1.
Running a Qpid C++ Broker
@@ -28,23 +28,7 @@
Cheat Sheet for configuring Exchange Options
</a></span></dt><dd><dl><dt><span class="section"><a href="ch01s03.html#CheatSheetforconfiguringExchangeOptions-ConfiguringExchangeOptions">1.3.1.
Configuring Exchange Options
- </a></span></dt></dl></dd><dt><span class="section"><a href="ch01s04.html">1.4.
- Using Broker Federation
- </a></span></dt><dd><dl><dt><span class="section"><a href="ch01s04.html#UsingBrokerFederation-Introduction">1.4.1.
- Introduction
- </a></span></dt><dt><span class="section"><a href="ch01s04.html#UsingBrokerFederation-WhatIsBrokerFederation-3F">1.4.2.
- What Is
- Broker Federation?
- </a></span></dt><dt><span class="section"><a href="ch01s04.html#UsingBrokerFederation-TheqpidrouteUtility">1.4.3.
- The
- qpid-route Utility
- </a></span></dt><dt><span class="section"><a href="ch01s04.html#UsingBrokerFederation-ExampleScenarios">1.4.4.
- Example
- Scenarios
- </a></span></dt><dt><span class="section"><a href="ch01s04.html#UsingBrokerFederation-AdvancedTopics">1.4.5.
- Advanced
- Topics
- </a></span></dt></dl></dd><dt><span class="section"><a href="ch01s05.html">1.5.
+ </a></span></dt></dl></dd><dt><span class="section"><a href="ch01s04.html">1.4. Broker Federation</a></span></dt><dd><dl><dt><span class="section"><a href="ch01s04.html#sect-Messaging_User_Guide-Broker_Federation-Message_Routes">1.4.1. Message Routes</a></span></dt><dt><span class="section"><a href="ch01s04.html#sect-Messaging_User_Guide-Broker_Federation-Federation_Topologies">1.4.2. Federation Topologies</a></span></dt><dt><span class="section"><a href="ch01s04.html#sect-Messaging_User_Guide-Broker_Federation-Federation_among_High_Availability_Message_Clusters">1.4.3. Federation among High Availability Message Clusters</a></span></dt><dt><span class="section"><a href="ch01s04.html#sect-Messaging_User_Guide-Broker_Federation-The_qpid_route_Utility">1.4.4. The qpid-route Utility</a></span></dt></dl></dd><dt><span class="section"><a href="ch01s05.html">1.5.
SSL
</a></span></dt><dd><dl><dt><span class="section"><a href="ch01s05.html#SSL-SSLHowto">1.5.1.
SSL How to
@@ -64,12 +48,7 @@
</a></span></dt><dd><dl><dt><span class="section"><a href="ch01s07.html#queuestatereplication-AsynchronousReplicationofQueueState">1.7.1.
Asynchronous
Replication of Queue State
- </a></span></dt></dl></dd><dt><span class="section"><a href="ch01s08.html">1.8.
- Starting a cluster
- </a></span></dt><dd><dl><dt><span class="section"><a href="ch01s08.html#Startingacluster-RunningaQpiddcluster">1.8.1.
- Running a
- Qpidd cluster
- </a></span></dt></dl></dd><dt><span class="section"><a href="ch01s09.html">1.9.
+ </a></span></dt></dl></dd><dt><span class="section"><a href="ch01s08.html">1.8. High Availability Messaging Clusters</a></span></dt><dd><dl><dt><span class="section"><a href="ch01s08.html#sect-Messaging_User_Guide-High_Availability_Messaging_Clusters-Starting_a_Broker_in_a_Cluster">1.8.1. Starting a Broker in a Cluster</a></span></dt><dt><span class="section"><a href="ch01s08.html#sect-Messaging_User_Guide-High_Availability_Messaging_Clusters-qpid_cluster">1.8.2. qpid-cluster</a></span></dt><dt><span class="section"><a href="ch01s08.html#sect-Messaging_User_Guide-High_Availability_Messaging_Clusters-Failover_in_Clients">1.8.3. Failover in Clients</a></span></dt><dt><span class="section"><a href="ch01s08.html#sect-Messaging_User_Guide-High_Availability_Messaging_Clusters-Error_handling_in_Clusters">1.8.4. Error handling in Clusters</a></span></dt><dt><span class="section"><a href="ch01s08.html#sect-Messaging_User_Guide-High_Availability_Messaging_Clusters-Persistence_in_H
igh_Availability_Message_Clusters">1.8.5. Persistence in High Availability Message Clusters</a></span></dt></dl></dd><dt><span class="section"><a href="ch01s09.html">1.9.
ACL
</a></span></dt><dd><dl><dt><span class="section"><a href="ch01s09.html#ACL-v2ACLfileformatforbrokers">1.9.1.
v2 ACL file format for brokers
@@ -85,10 +64,8 @@
</a></span></dt><dt><span class="section"><a href="ch01s10.html#AMQPcompatibility-InteroptablebyAMQPspecificationversion">1.10.2.
Interop
table by AMQP specification version
- </a></span></dt></dl></dd><dt><span class="section"><a href="ch01s11.html">1.11.
- Qpid Interoperability Documentation
- </a></span></dt><dd><dl><dt><span class="section"><a href="ch01s11.html#QpidInteroperabilityDocumentation-QpidInteroperabilityDocumentation">1.11.1.
- Qpid Interoperability Documentation
+ </a></span></dt></dl></dd><dt><span class="section"><a href="ch01s11.html">1.11. Qpid Interoperability Documentation</a></span></dt><dd><dl><dt><span class="section"><a href="ch01s11.html#QpidInteroperabilityDocumentation-SASL">1.11.1.
+ SASL
</a></span></dt></dl></dd></dl></div><div class="section" title="1.1. Running a Qpid C++ Broker"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="section-Running-a-Qpid-CPP-Broker"></a>1.1.
Running a Qpid C++ Broker
</h2></div></div></div><div class="section" title="1.1.1. Building the C++ Broker and Client Libraries"><div class="titlepage"><div><div><h3 class="title"><a name="RASC-BuildingtheCppBrokerandClientLibraries"></a>1.1.1.
Modified: qpid/site/docs/books/0.7/AMQP-Messaging-Broker-CPP-Book/html/ch01s02.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.7/AMQP-Messaging-Broker-CPP-Book/html/ch01s02.html?rev=1069126&r1=1069125&r2=1069126&view=diff
==============================================================================
--- qpid/site/docs/books/0.7/AMQP-Messaging-Broker-CPP-Book/html/ch01s02.html (original)
+++ qpid/site/docs/books/0.7/AMQP-Messaging-Broker-CPP-Book/html/ch01s02.html Wed Feb 9 21:39:27 2011
@@ -2,7 +2,7 @@
Cheat Sheet for configuring Queue Options
</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch01.html">Prev</a> </td><th width="60%" align="center">Chapter 1.
Running the AMQP Messaging Broker
- </th><td width="20%" align="right"> <a accesskey="n" href="ch01s03.html">Next</a></td></tr></table><hr></div><div class="section" title="1.2. Cheat Sheet for configuring Queue Options"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2897302"></a>1.2.
+ </th><td width="20%" align="right"> <a accesskey="n" href="ch01s03.html">Next</a></td></tr></table><hr></div><div class="section" title="1.2. Cheat Sheet for configuring Queue Options"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2896355"></a>1.2.
Cheat Sheet for configuring Queue Options
</h2></div></div></div><div class="section" title="1.2.1. Configuring Queue Options"><div class="titlepage"><div><div><h3 class="title"><a name="CheatSheetforconfiguringQueueOptions-ConfiguringQueueOptions"></a>1.2.1.
Configuring
Modified: qpid/site/docs/books/0.7/AMQP-Messaging-Broker-CPP-Book/html/ch01s03.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.7/AMQP-Messaging-Broker-CPP-Book/html/ch01s03.html?rev=1069126&r1=1069125&r2=1069126&view=diff
==============================================================================
--- qpid/site/docs/books/0.7/AMQP-Messaging-Broker-CPP-Book/html/ch01s03.html (original)
+++ qpid/site/docs/books/0.7/AMQP-Messaging-Broker-CPP-Book/html/ch01s03.html Wed Feb 9 21:39:27 2011
@@ -1,8 +1,8 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>1.3. Cheat Sheet for configuring Exchange Options</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="AMQP Messaging Broker (Implemented in C++)"><link rel="up" href="ch01.html" title="Chapter 1. Running the AMQP Messaging Broker"><link rel="prev" href="ch01s02.html" title="1.2. Cheat Sheet for configuring Queue Options"><link rel="next" href="ch01s04.html" title="1.4. Using Broker Federation"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">1.3.
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>1.3. Cheat Sheet for configuring Exchange Options</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="AMQP Messaging Broker (Implemented in C++)"><link rel="up" href="ch01.html" title="Chapter 1. Running the AMQP Messaging Broker"><link rel="prev" href="ch01s02.html" title="1.2. Cheat Sheet for configuring Queue Options"><link rel="next" href="ch01s04.html" title="1.4. Broker Federation"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">1.3.
Cheat Sheet for configuring Exchange Options
</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch01s02.html">Prev</a> </td><th width="60%" align="center">Chapter 1.
Running the AMQP Messaging Broker
- </th><td width="20%" align="right"> <a accesskey="n" href="ch01s04.html">Next</a></td></tr></table><hr></div><div class="section" title="1.3. Cheat Sheet for configuring Exchange Options"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2897616"></a>1.3.
+ </th><td width="20%" align="right"> <a accesskey="n" href="ch01s04.html">Next</a></td></tr></table><hr></div><div class="section" title="1.3. Cheat Sheet for configuring Exchange Options"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2895873"></a>1.3.
Cheat Sheet for configuring Exchange Options
</h2></div></div></div><div class="section" title="1.3.1. Configuring Exchange Options"><div class="titlepage"><div><div><h3 class="title"><a name="CheatSheetforconfiguringExchangeOptions-ConfiguringExchangeOptions"></a>1.3.1.
Configuring Exchange Options
@@ -95,6 +95,4 @@
...
</pre></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch01s02.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch01.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch01s04.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">1.2.
Cheat Sheet for configuring Queue Options
- </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 1.4.
- Using Broker Federation
- </td></tr></table></div></body></html>
+ </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 1.4. Broker Federation</td></tr></table></div></body></html>
Modified: qpid/site/docs/books/0.7/AMQP-Messaging-Broker-CPP-Book/html/ch01s04.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.7/AMQP-Messaging-Broker-CPP-Book/html/ch01s04.html?rev=1069126&r1=1069125&r2=1069126&view=diff
==============================================================================
--- qpid/site/docs/books/0.7/AMQP-Messaging-Broker-CPP-Book/html/ch01s04.html (original)
+++ qpid/site/docs/books/0.7/AMQP-Messaging-Broker-CPP-Book/html/ch01s04.html Wed Feb 9 21:39:27 2011
@@ -1,214 +1,218 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>1.4. Using Broker Federation</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="AMQP Messaging Broker (Implemented in C++)"><link rel="up" href="ch01.html" title="Chapter 1. Running the AMQP Messaging Broker"><link rel="prev" href="ch01s03.html" title="1.3. Cheat Sheet for configuring Exchange Options"><link rel="next" href="ch01s05.html" title="1.5. SSL"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">1.4.
- Using Broker Federation
- </th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch01s03.html">Prev</a> </td><th width="60%" align="center">Chapter 1.
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>1.4. Broker Federation</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="AMQP Messaging Broker (Implemented in C++)"><link rel="up" href="ch01.html" title="Chapter 1. Running the AMQP Messaging Broker"><link rel="prev" href="ch01s03.html" title="1.3. Cheat Sheet for configuring Exchange Options"><link rel="next" href="ch01s05.html" title="1.5. SSL"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">1.4. Broker Federation</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch01s03.html">Prev</a> </td><th width="60%" align="center">Chapter 1.
Running the AMQP Messaging Broker
- </th><td width="20%" align="right"> <a accesskey="n" href="ch01s05.html">Next</a></td></tr></table><hr></div><div class="section" title="1.4. Using Broker Federation"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2898330"></a>1.4.
- Using Broker Federation
- </h2></div></div></div><div class="section" title="1.4.1. Introduction"><div class="titlepage"><div><div><h3 class="title"><a name="UsingBrokerFederation-Introduction"></a>1.4.1.
- Introduction
- </h3></div></div></div><p>
- Please note: Whereas broker federation was introduced in the M3
- milestone release, the discussion in this document is based on
- the richer capabilities of federation in the M4 release.
- </p></div><div class="section" title="1.4.2. What Is Broker Federation?"><div class="titlepage"><div><div><h3 class="title"><a name="UsingBrokerFederation-WhatIsBrokerFederation-3F"></a>1.4.2.
- What Is
- Broker Federation?
- </h3></div></div></div><p>
- The Qpid C++ messaging broker supports broker federation, a
- mechanism by which large messaging networks can be built using
- multiple brokers. Some scenarios in which federation is useful:
- </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
- <span class="emphasis"><em>Connecting disparate locations across a wide area
- network.</em></span> In this case full connectivity across the
- enterprise can be achieved while keeping local message traffic
- isolated to a single location.
- </p></li><li class="listitem"><p>
- <span class="emphasis"><em>Departmental brokers</em></span> that have a policy which
- controls the flow of inter-departmental message traffic.
- </p></li><li class="listitem"><p>
- <span class="emphasis"><em>Scaling of capacity</em></span> for expensive broker operations.
- High-function exchanges like the XML exchange can be replicated
- to scale performance.
- </p></li><li class="listitem"><p>
- <span class="emphasis"><em>Co-Resident brokers</em></span> Some applications benefit from
- having a broker co-resident with the client. This is
- particularly true if the client produces data that must be
- delivered reliably but connectivity to the consumer(s) is
- non-reliable. In this case, a co-resident broker provides
- queueing and durablilty not available in the client alone.
- </p></li><li class="listitem"><p>
- <span class="emphasis"><em>Bridging disjoint IP networks.</em></span> Message brokers can
- be configured to allow message connectivity between networks
- where there is no IP connectivity. For example, an isolated,
- private IP network can have messaging connectivity to brokers
- in other outside IP networks.
- </p></li></ul></div></div><div class="section" title="1.4.3. The qpid-route Utility"><div class="titlepage"><div><div><h3 class="title"><a name="UsingBrokerFederation-TheqpidrouteUtility"></a>1.4.3.
- The
- qpid-route Utility
- </h3></div></div></div><p>
- The qpid-route command line utility is provided with the Qpid
- broker. This utility is used to configure federated networks of
- brokers and to view the status and topology of networks.
- </p><p>
- qpid-route accesses the managed brokers remotely. It does not
- need to be invoked from the same host on which the broker is
- running. If network connectivity permits, an entire enterprise
- can be configured from a single location.
- </p><p>
- In the following sections, federation concepts will be introduced
- and illustrated using qpid-route.
- </p><div class="section" title="1.4.3.1. Links and Routes"><div class="titlepage"><div><div><h4 class="title"><a name="UsingBrokerFederation-LinksandRoutes"></a>1.4.3.1.
- Links and
- Routes
- </h4></div></div></div><p>
- Federation occurs when a <span class="emphasis"><em>link</em></span> is established between two
- brokers and one or more <span class="emphasis"><em>routes</em></span> are created within that
- link. A <span class="emphasis"><em>link</em></span> is a transport level connection (tcp, rdma,
- ssl, etc.) initiated by one broker and accepted by another. The
- initiating broker assumes the role of <span class="emphasis"><em>client</em></span> with regard
- to the connection. The accepting broker annotates the connection
- as being for federation but otherwise treats it as a normal
- client connection.
- </p><p>
- A <span class="emphasis"><em>route</em></span> is associated with an AMQP session established
- over the link connection. There may be multiple routes sharing
- the same link. A route controls the flow of messages across the
- link between brokers. Routes always consist of a session and a
- subscription for consuming messages. Depending on the
- configuration, a route may have a private queue on the source
- broker with a binding to an exchange on that broker.
- </p><p>
- Routes are unidirectional. A single route provides for the flow
- of messages in one direction across a link. If bidirectional
- connectivity is required (and it almost always is), then a pair
- of routes must be created, one for each direction of message
- flow.
- </p><p>
- The qpid-route utility allows the administrator to configure and
- manage links and routes separately. However, when a route is
- created and a link does not already exist, qpid-route will
- automatically create the link. It is typically not necessary to
- create a link by itself. It is, however, useful to get a list of
- links and their connection status from a broker:
- </p><pre class="programlisting">
-$ qpid-route link list localhost:10001
-
-Host Port Transport Durable State Last Error
-=============================================================================
-localhost 10002 tcp N Operational
-localhost 10003 tcp N Operational
-localhost 10009 tcp N Waiting Connection refused
+ </th><td width="20%" align="right"> <a accesskey="n" href="ch01s05.html">Next</a></td></tr></table><hr></div><div class="section" title="1.4. Broker Federation"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="chap-Messaging_User_Guide-Broker_Federation"></a>1.4. Broker Federation</h2></div></div></div><p>
+ <em class="firstterm">Broker Federation</em> allows messaging networks to be defined by creating <em class="firstterm">message routes</em>, in which messages in one broker (the <em class="firstterm">source broker</em>) are automatically routed to another broker (the <em class="firstterm">destination broker</em>). These routes may be defined between exchanges in the two brokers (the <em class="firstterm">source exchange</em> and the <em class="firstterm">destination exchange</em>), or from a queue in the source broker (the <em class="firstterm">source queue</em>) to an exchange in the destination broker. Message routes are unidirectional; when bidirectional flow is needed, one route is created in each direction. Routes can be durable or transient. A durable route survives broker restarts, restoring a route as soon as both the source broker and the destination are available. If the connection to a destination is lost, messages associated with a durable route continue to accu
mulate on the source, so they can be retrieved when the connection is reestablished.
+ </p><p>
+ Broker Federation can be used to build large messaging networks, with many brokers, one route at a time. If network connectivity permits, an entire distributed messaging network can be configured from a single location. The rules used for routing can be changed dynamically as servers change, responsibilities change, at different times of day, or to reflect other changing conditions.
+ </p><p>
+ Broker Federation is useful in a wide variety of scenarios. Some of these have to do with functional organization; for instance, brokers may be organized by geography, service type, or priority. Here are some use cases for federation:
+ </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
+ Geography: Customer requests may be routed to a processing location close to the customer.
+ </p></li><li class="listitem"><p>
+ Service Type: High value customers may be routed to more responsive servers.
+ </p></li><li class="listitem"><p>
+ Load balancing: Routing among brokers may be changed dynamically to account for changes in actual or anticipated load.
+ </p></li><li class="listitem"><p>
+ High Availability: Routing may be changed to a new broker if an existing broker becomes unavailable.
+ </p></li><li class="listitem"><p>
+ WAN Connectivity: Federated routes may connect disparate locations across a wide area network, while clients connect to brokers on their own local area network. Each broker can provide persistent queues that can hold messages even if there are gaps in WAN connectivity.
+ </p></li><li class="listitem"><p>
+ Functional Organization: The flow of messages among software subsystems can be configured to mirror the logical structure of a distributed application.
+ </p></li><li class="listitem"><p>
+ Replicated Exchanges: High-function exchanges like the XML exchange can be replicated to scale performance.
+ </p></li><li class="listitem"><p>
+ Interdepartmental Workflow: The flow of messages among brokers can be configured to mirror interdepartmental workflow at an organization.
+ </p></li></ul></div><p>
+
+ </p><div class="section" title="1.4.1. Message Routes"><div class="titlepage"><div><div><h3 class="title"><a name="sect-Messaging_User_Guide-Broker_Federation-Message_Routes"></a>1.4.1. Message Routes</h3></div></div></div><p>
+ Broker Federation is done by creating message routes. The destination for a route is always an exchange on the destination broker. By default, a message route is created by configuring the destination broker, which then contacts the source broker to subscribe to the source queue. This is called a <em class="firstterm">pull route</em>. It is also possible to create a route by configuring the source broker, which then contacts the destination broker in order to send messages. This is called a <em class="firstterm">push route</em>, and is particularly useful when the destination broker may not be available at the time the messaging route is configured, or when a large number of routes are created with the same destination exchange.
+ </p><p>
+ The source for a route can be either an exchange or a queue on the source broker. If a route is between two exchanges, the routing criteria can be given explicitly, or the bindings of the destination exchange can be used to determine the routing criteria. To support this functionality, there are three kinds of message routes: queue routes, exchange routes, and dynamic exchange routes.
+ </p><div class="section" title="1.4.1.1. Queue Routes"><div class="titlepage"><div><div><h4 class="title"><a name="sect-Messaging_User_Guide-Message_Routes-Queue_Routes"></a>1.4.1.1. Queue Routes</h4></div></div></div><p>
+ <em class="firstterm">Queue Routes</em> route all messages from a source queue to a destination exchange. If message acknowledgement is enabled, messages are removed from the queue when they have been received by the destination exchange; if message acknowledgement is off, messages are removed from the queue when sent.
+ </p></div><div class="section" title="1.4.1.2. Exchange Routes"><div class="titlepage"><div><div><h4 class="title"><a name="sect-Messaging_User_Guide-Message_Routes-Exchange_Routes"></a>1.4.1.2. Exchange Routes</h4></div></div></div><p>
+ <em class="firstterm">Exchange routes</em> route messages from a source exchange to a destination exchange, using a binding key (which is optional for a fanout exchange).
+ </p><p>
+ Internally, creating an exchange route creates a private queue (auto-delete, exclusive) on the source broker to hold messages that are to be routed to the destination broker, binds this private queue to the source broker exchange, and subscribes the destination broker to the queue.
+ </p></div><div class="section" title="1.4.1.3. Dynamic Exchange Routes"><div class="titlepage"><div><div><h4 class="title"><a name="sect-Messaging_User_Guide-Message_Routes-Dynamic_Exchange_Routes"></a>1.4.1.3. Dynamic Exchange Routes</h4></div></div></div><p>
+ Dynamic exchange routes allow a client to create bindings to an exchange on one broker, and receive messages that satisfy the conditions of these bindings not only from the exchange to which the client created the binding, but also from other exchanges that are connected to it using dynamic exchange routes. If the client modifies the bindings for a given exchange, they are also modified for dynamic exchange routes associated with that exchange.
+ </p><p>
+ <em class="firstterm">Dynamic exchange routes</em> apply all the bindings of a destination exchange to a source exchange, so that any message that would match one of these bindings is routed to the destination exchange. If bindings are added or removed from the destination exchange, these changes are reflected in the dynamic exchange route -- when the destination broker creates a binding with a given binding key, this is reflected in the route, and when the destination broker drops a binding with a binding key, the route no longer incurs the overhead of transferring messages that match the binding key among brokers. If two exchanges have dynamic exchange routes to each other, then all bindings in each exchange are reflected in the dynamic exchange route of the other. In a dynamic exchange route, the source and destination exchanges must have the same exchange type, and they must have the same name; for instance, if the source exchange is a direct exchange, the destinatio
n exchange must also be a direct exchange, and the names must match.
+ </p><p>
+ Internally, dynamic exchange routes are implemented in the same way as exchange routes, except that the bindings used to implement dynamic exchange routes are modified if the bindings in the destination exchange change.
+ </p><p>
+ A dynamic exchange route is always a pull route. It can never be a push route.
+ </p></div></div><div class="section" title="1.4.2. Federation Topologies"><div class="titlepage"><div><div><h3 class="title"><a name="sect-Messaging_User_Guide-Broker_Federation-Federation_Topologies"></a>1.4.2. Federation Topologies</h3></div></div></div><p>
+ A federated network is generally a tree, star, or line, using bidirectional links (implemented as a pair of unidirectional links) between any two brokers. A ring topology is also possible, if only unidirectional links are used.
+ </p><p>
+ Every message transfer takes time. For better performance, you should minimize the number of brokers between the message origin and final destination. In most cases, tree or star topologies do this best.
+ </p><p>
+ For any pair of nodes A,B in a federated network, there should be only one path from A to B. If there is more than one path, message loops can cause duplicate message transmission and flood the federated network. The topologies discussed above do not have message loops. A ring topology with bidirectional links is one example of a topology that does cause this problem, because a given broker can receive the same message from two different brokers. Mesh topologies can also cause this problem.
+ </p></div><div class="section" title="1.4.3. Federation among High Availability Message Clusters"><div class="titlepage"><div><div><h3 class="title"><a name="sect-Messaging_User_Guide-Broker_Federation-Federation_among_High_Availability_Message_Clusters"></a>1.4.3. Federation among High Availability Message Clusters</h3></div></div></div><p>
+ Federation is generally used together with High Availability Message Clusters, using clusters to provide high availability on each LAN, and federation to route messages among the clusters. Because message state is replicated within a cluster, it makes little sense to define message routes between brokers in the same cluster.
+ </p><p>
+ To create a message route between two clusters, simply create a route between any one broker in the first cluster and any one broker in the second cluster. Each broker in a given cluster can use message routes defined for another broker in the same cluster. If the broker for which a message route is defined should fail, another broker in the same cluster can restore the message route.
+ </p></div><div class="section" title="1.4.4. The qpid-route Utility"><div class="titlepage"><div><div><h3 class="title"><a name="sect-Messaging_User_Guide-Broker_Federation-The_qpid_route_Utility"></a>1.4.4. The qpid-route Utility</h3></div></div></div><p>
+ <span class="command"><strong>qpid-route</strong></span> is a command line utility used to configure federated networks of brokers and to view the status and topology of networks. It can be used to configure routes among any brokers that <span class="command"><strong>qpid-route</strong></span> can connect to.
+ </p><p>
+ The syntax of <span class="command"><strong>qpid-route</strong></span> is as follows:
+ </p><pre class="screen">
+qpid-route [OPTIONS] dynamic add <dest-broker> <src-broker> <exchange>
+qpid-route [OPTIONS] dynamic del <dest-broker> <src-broker> <exchange>
+
+qpid-route [OPTIONS] route add <dest-broker> <src-broker> <exchange> <routing-key>
+qpid-route [OPTIONS] route del <dest-broker> <src-broker> <exchange> <routing-key>
+
+qpid-route [OPTIONS] queue add <dest-broker> <src-broker> <dest-exchange> <src-queue>
+qpid-route [OPTIONS] queue del <dest-broker> <src-broker> <dest-exchange> <src-queue>
+
+qpid-route [OPTIONS] list [<broker>]
+qpid-route [OPTIONS] flush [<broker>]
+qpid-route [OPTIONS] map [<broker>]
+
+
+qpid-route [OPTIONS] list connections [<broker>]
+</pre><p>
+ The syntax for <span class="command"><strong>broker</strong></span>, <span class="command"><strong>dest-broker</strong></span>, and <span class="command"><strong>src-broker</strong></span> is as follows:
+ </p><pre class="screen">
+[username/password@] hostname | ip-address [:<port>]
+</pre><p>
+ The following are all valid examples of the above syntax: <span class="command"><strong>localhost</strong></span>, <span class="command"><strong>10.1.1.7:10000</strong></span>, <span class="command"><strong>broker-host:10000</strong></span>, <span class="command"><strong>guest/guest@localhost</strong></span>.
+ </p><p>
+ These are the options for <span class="command"><strong>qpid-route</strong></span>:
+ </p><div class="table"><a name="tabl-Messaging_User_Guide-The_qpid_route_Utility-qpid_route_options"></a><p class="title"><b>Table 1.1. <span class="command">qpid-route</span> options</b></p><div class="table-contents"><table summary="qpid-route options" border="1"><colgroup><col align="left"><col align="left"></colgroup><tbody><tr><td align="left">
+ <span class="command"><strong>-v</strong></span>
+ </td><td align="left">
+ Verbose output.
+ </td></tr><tr><td align="left">
+ <span class="command"><strong>-q</strong></span>
+ </td><td align="left">
+ Quiet output, will not print duplicate warnings.
+ </td></tr><tr><td align="left">
+ <span class="command"><strong>-d</strong></span>
+ </td><td align="left">
+ Make the route durable.
+ </td></tr><tr><td align="left">
+ <span class="command"><strong> --timeout N</strong></span>
+ </td><td align="left">
+ Maximum time to wait when qpid-route connects to a broker, in seconds. Default is 10 seconds.
+ </td></tr><tr><td align="left">
+ <span class="command"><strong>--ack N</strong></span>
+ </td><td align="left">
+ Acknowledge transfers of routed messages in batches of N. Default is 0 (no acknowledgements). Setting to 1 or greater enables acknowledgements; when using acknowledgements, values of N greater than 1 can significnantly improve performance, especially if there is significant network latency between the two brokers.
+ </td></tr><tr><td align="left">
+ <span class="command"><strong>-s [ --src-local ]</strong></span>
+ </td><td align="left">
+ Configure the route in the source broker (create a push route).
+ </td></tr><tr><td align="left">
+ <span class="command"><strong>-t <transport> [ --transport <transport>]</strong></span>
+ </td><td align="left">
+ Transport protocol to be used for the route.
+ <div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
+ tcp (default)
+ </p></li><li class="listitem"><p>
+ ssl
+ </p></li><li class="listitem"><p>
+ rdma
+ </p></li></ul></div>
+
+ </td></tr></tbody></table></div></div><br class="table-break"><div class="section" title="1.4.4.1. Creating and Deleting Queue Routes"><div class="titlepage"><div><div><h4 class="title"><a name="sect-Messaging_User_Guide-The_qpid_route_Utility-Creating_and_Deleting_Queue_Routes"></a>1.4.4.1. Creating and Deleting Queue Routes</h4></div></div></div><p>
+ The syntax for creating and deleting queue routes is as follows:
+ </p><pre class="screen">
+qpid-route [OPTIONS] queue add <dest-broker> <src-broker> <dest-exchange> <src-queue>
+qpid-route [OPTIONS] queue del <dest-broker> <src-broker> <dest-exchange> <src-queue>
</pre><p>
- The example above shows a <span class="emphasis"><em>link list</em></span> query to the
- broker at "localhost:10001". In the example, this broker has
- three links to other brokers. Two are operational and the third
- is waiting to connect because there is not currently a broker
- listening at that address.
- </p><div class="section" title="1.4.3.1.1. The Life Cycle of a Link"><div class="titlepage"><div><div><h5 class="title"><a name="UsingBrokerFederation-TheLifeCycleofaLink"></a>1.4.3.1.1.
- The Life
- Cycle of a Link
- </h5></div></div></div><p>
- When a link is created on a broker, that broker attempts to
- establish a transport-level connection to the peer broker. If it
- fails to connect, it retries the connection at an increasing time
- interval. If the connection fails due to authentication failure,
- it will not continue to retry as administrative intervention is
- needed to fix the problem.
- </p><p>
- If an operational link is disconnected, the initiating broker
- will attempt to re-establish the connection with the same
- interval back-off.
- </p><p>
- The shortest retry-interval is 2 seconds and the longest is 64
- seconds. Once enough consecutive retries have occurred that the
- interval has grown to 64 seconds, the interval will then stay at
- 64 seconds.
- </p></div><div class="section" title="1.4.3.1.2. Durable Links and Routes"><div class="titlepage"><div><div><h5 class="title"><a name="UsingBrokerFederation-DurableLinksandRoutes"></a>1.4.3.1.2.
- Durable
- Links and Routes
- </h5></div></div></div><p>
- If, when a link or a route is created using qpid-route, the
- --durable option is used, it shall be durable. This
- means that its life cycle shall span restarts of the broker. If
- the broker is shut down, when it is restarted, the link will be
- restored and will begin establishing connectivity.
- </p><p>
- A non-durable route can be created for a durable link but a
- durable route cannot be created for a non-durable link.
- </p><pre class="programlisting">
-$ qpid-route dynamic add localhost:10003 localhost:10004 fed.topic
-$ qpid-route dynamic add localhost:10003 localhost:10004 fed.topic2 --durable
-Failed: Can't create a durable route on a non-durable link
+ For instance, the following creates a queue route that routes all messages from the queue named <span class="command"><strong>public</strong></span> on the source broker <span class="command"><strong>localhost:10002</strong></span> to the <span class="command"><strong>amq.fanout</strong></span> exchange on the destination broker <span class="command"><strong>localhost:10001</strong></span>:
+ </p><pre class="screen">
+$ qpid-route queue add localhost:10001 localhost:10002 amq.fanout public
</pre><p>
- In the above example, a transient (non-durable) dynamic route was
- created between localhost:10003 and localhost:10004. Because
- there was no link in place, a new transient link was created. The
- second command is attempting to create a durable route over the
- same link and is rejected as illegal.
- </p></div></div><div class="section" title="1.4.3.2. Dynamic Routing"><div class="titlepage"><div><div><h4 class="title"><a name="UsingBrokerFederation-DynamicRouting"></a>1.4.3.2.
- Dynamic
- Routing
- </h4></div></div></div><p>
- Dynamic routing provides the simplest configuration for a network
- of brokers. When configuring dynamic routing, the administrator
- need only express the logical topology of the network (i.e. which
- pairs of brokers are connected by a unidirectional route). Queue
- configuration and bindings are handled automatically by the
- brokers in the network.
- </p><p>
- Dynamic routing uses the <span class="emphasis"><em>Distributed Exchange</em></span> concept.
- From the client's point of view, all of the brokers in the
- network collectively offer a single logical exchange that behaves
- the same as a single exchange in a single broker. Each client
- connects to its local broker and can bind its queues to the
- distributed exchange and publish messages to the exchange.
- </p><p>
- When a consuming client binds a queue to the distributed
- exchange, information about that binding is propagated to the
- other brokers in the network to ensure that any messages matching
- the binding will be forwarded to the client's local broker.
- Messages published to the distributed exchange are forwarded to
- other brokers only if there are remote consumers to receive the
- messages. The dynamic binding protocol ensures that messages are
- routed only to brokers with eligible consumers. This includes
- topologies where messages must make multiple hops to reach the
- consumer.
- </p><p>
- When creating a dynamic routing network, The type and name of the
- exchange must be the same on each broker. It is <span class="emphasis"><em>strongly</em></span>
- recommended that dynamic routes <span class="emphasis"><em>NOT</em></span> be created using the
- standard exchanges (that is unless all messaging is intended to
- be federated).
- </p><p>
- A simple, two-broker network can be configured by creating an
- exchange on each broker then a pair of dynamic routes (one for
- each direction of message flow):
- </p><p>
- Create exchanges:
- </p><pre class="programlisting">
+ If the <span class="command"><strong>-d</strong></span> option is specified, this queue route is persistent, and will be restored if one or both of the brokers is restarted:
+ </p><pre class="screen">
+$ qpid-route -d queue add localhost:10001 localhost:10002 amq.fanout public
+</pre><p>
+ The <span class="command"><strong>del</strong></span> command takes the same arguments as the <span class="command"><strong>add</strong></span> command. The following command deletes the queue route described above:
+ </p><pre class="screen">
+$ qpid-route queue del localhost:10001 localhost:10002 amq.fanout public
+</pre></div><div class="section" title="1.4.4.2. Creating and Deleting Exchange Routes"><div class="titlepage"><div><div><h4 class="title"><a name="sect-Messaging_User_Guide-The_qpid_route_Utility-Creating_and_Deleting_Exchange_Routes"></a>1.4.4.2. Creating and Deleting Exchange Routes</h4></div></div></div><p>
+ The syntax for creating and deleting exchange routes is as follows:
+ </p><pre class="screen">
+qpid-route [OPTIONS] route add <dest-broker> <src-broker> <exchange> <routing-key>
+qpid-route [OPTIONS] route del <dest-broker> <src-broker> <exchange> <routing-key>
+qpid-route [OPTIONS] flush [<broker>]
+</pre><p>
+ For instance, the following creates an exchange route that routes messages that match the binding key <span class="command"><strong>global.#</strong></span> from the <span class="command"><strong>amq.topic</strong></span> exchange on the source broker <span class="command"><strong>localhost:10002</strong></span> to the <span class="command"><strong>amq.topic</strong></span> exchange on the destination broker <span class="command"><strong>localhost:10001</strong></span>:
+ </p><pre class="screen">
+$ qpid-route route add localhost:10001 localhost:10002 amq.topic global.#
+</pre><p>
+ In many applications, messages published to the destination exchange should also be routed to the source exchange. This is accomplished by creating a second exchange route, reversing the roles of the two exchanges:
+ </p><pre class="screen">
+$ qpid-route route add localhost:10002 localhost:10001 amq.topic global.#
+</pre><p>
+ If the <span class="command"><strong>-d</strong></span> option is specified, the exchange route is persistent, and will be restored if one or both of the brokers is restarted:
+ </p><pre class="screen">
+$ qpid-route -d route add localhost:10001 localhost:10002 amq.fanout public
+</pre><p>
+ The <span class="command"><strong>del</strong></span> command takes the same arguments as the <span class="command"><strong>add</strong></span> command. The following command deletes the first exchange route described above:
+ </p><pre class="screen">
+$ qpid-route route del localhost:10001 localhost:10002 amq.topic global.#
+</pre></div><div class="section" title="1.4.4.3. Deleting all routes for a broker"><div class="titlepage"><div><div><h4 class="title"><a name="sect-Messaging_User_Guide-The_qpid_route_Utility-Deleting_all_routes_for_a_broker"></a>1.4.4.3. Deleting all routes for a broker</h4></div></div></div><p>
+ Use the <span class="command"><strong>flush</strong></span> command to delete all routes for a given broker:
+ </p><pre class="screen">
+qpid-route [OPTIONS] flush [<broker>]
+</pre><p>
+ For instance, the following command deletes all routes for the broker <span class="command"><strong>localhost:10001</strong></span>:
+ </p><pre class="screen">
+$ qpid-route flush localhost:10001
+</pre></div><div class="section" title="1.4.4.4. Creating and Deleting Dynamic Exchange Routes"><div class="titlepage"><div><div><h4 class="title"><a name="sect-Messaging_User_Guide-The_qpid_route_Utility-Creating_and_Deleting_Dynamic_Exchange_Routes"></a>1.4.4.4. Creating and Deleting Dynamic Exchange Routes</h4></div></div></div><p>
+ The syntax for creating and deleting dynamic exchange routes is as follows:
+ </p><pre class="screen">
+qpid-route [OPTIONS] dynamic add <dest-broker> <src-broker> <exchange>
+qpid-route [OPTIONS] dynamic del <dest-broker> <src-broker> <exchange>
+</pre><p>
+ In the following examples, we will route messages from a topic exchange. We will create a new topic exchange and federate it so that we are not affected by other all clients that use the built-in <span class="command"><strong>amq.topic</strong></span> exchange. The following commands create a new topic exchange on each of two brokers:
+ </p><pre class="screen">
$ qpid-config -a localhost:10003 add exchange topic fed.topic
$ qpid-config -a localhost:10004 add exchange topic fed.topic
</pre><p>
- Create dynamic routes:
- </p><pre class="programlisting">
+ Now let's create a dynamic exchange route that routes messages from the <span class="command"><strong>fed.topic</strong></span> exchange on the source broker <span class="command"><strong>localhost:10004</strong></span> to the <span class="command"><strong>fed.topic</strong></span> exchange on the destination broker <span class="command"><strong>localhost:10003</strong></span> if they match any binding on the destination broker's <span class="command"><strong>fed.topic</strong></span> exchange:
+ </p><pre class="screen">
$ qpid-route dynamic add localhost:10003 localhost:10004 fed.topic
+</pre><p>
+ Internally, this creates a private autodelete queue on the source broker, and binds that queue to the <span class="command"><strong>fed.topic</strong></span> exchange on the source broker, using each binding associated with the <span class="command"><strong>fed.topic</strong></span> exchange on the destination broker.
+ </p><p>
+ In many applications, messages published to the destination exchange should also be routed to the source exchange. This is accomplished by creating a second dynamic exchange route, reversing the roles of the two exchanges:
+ </p><pre class="screen">
$ qpid-route dynamic add localhost:10004 localhost:10003 fed.topic
</pre><p>
- Information about existing routes can be gotten by querying each
- broker individually:
- </p><pre class="programlisting">
+ If the <span class="command"><strong>-d</strong></span> option is specified, the exchange route is persistent, and will be restored if one or both of the brokers is restarted:
+ </p><pre class="screen">
+$ qpid-route -d dynamic add localhost:10004 localhost:10003 fed.topic
+</pre><p>
+ When an exchange route is durable, the private queue used to store messages for the route on the source exchange is also durable. If the connection between the brokers is lost, messages for the destination exchange continue to accumulate until it can be restored.
+ </p><p>
+ The <span class="command"><strong>del</strong></span> command takes the same arguments as the <span class="command"><strong>add</strong></span> command. The following command deletes the first exchange route described above:
+ </p><pre class="screen">
+$ qpid-route dynamic del localhost:10004 localhost:10003 fed.topic
+</pre><p>
+ Internally, this deletes the bindings on the source exchange for the the private queues associated with the message route.
+ </p></div><div class="section" title="1.4.4.5. Viewing Routes"><div class="titlepage"><div><div><h4 class="title"><a name="sect-Messaging_User_Guide-The_qpid_route_Utility-Viewing_Routes"></a>1.4.4.5. Viewing Routes</h4></div></div></div><p>
+ The <span class="command"><strong>route list</strong></span> command shows the routes associated with an individual broker. For instance, suppose we have created the following two routes:
+ </p><pre class="screen">
+$ qpid-route dynamic add localhost:10003 localhost:10004 fed.topic
+$ qpid-route dynamic add localhost:10004 localhost:10003 fed.topic
+</pre><p>
+ We can now use <span class="command"><strong>route list</strong></span> to show all routes for the broker <span class="command"><strong>localhost:10003</strong></span>:
+ </p><pre class="screen">
$ qpid-route route list localhost:10003
localhost:10003 localhost:10004 fed.topic <dynamic>
+</pre><p>
+ Note that this shows only one of the two routes we created, the route for which <span class="command"><strong>localhost:10003</strong></span> is a destination. If we want to see the route for which <span class="command"><strong>localhost:10004</strong></span> is a destination, we need to do another route list:
+ </p><pre class="screen">
$ qpid-route route list localhost:10004
localhost:10004 localhost:10003 fed.topic <dynamic>
</pre><p>
- A nicer way to view the topology is to use <span class="emphasis"><em>qpid-route route
- map</em></span>. The argument to this command is a single broker that
- serves as an entry point. <span class="emphasis"><em>qpid-route</em></span> will attempt to
- recursively find all of the brokers involved in federation
- relationships with the starting broker and map all of the routes
- it finds.
- </p><pre class="programlisting">
+ The <span class="command"><strong>route map</strong></span> command shows all routes associated with a broker, and recursively displays all routes for brokers involved in federation relationships with the given broker. For instance, here is the output for the two brokers configured above:
+ </p><pre class="screen">
$ qpid-route route map localhost:10003
Finding Linked Brokers:
@@ -223,327 +227,95 @@ Dynamic Routes:
Static Routes:
none found
</pre><p>
- More extensive and realistic examples are supplied later in this
- document.
- </p></div><div class="section" title="1.4.3.3. Static Routing"><div class="titlepage"><div><div><h4 class="title"><a name="UsingBrokerFederation-StaticRouting"></a>1.4.3.3.
- Static Routing
- </h4></div></div></div><p>
- Dynamic routing provides simple, efficient, and automatic
- handling of the bindings that control routing as long as the
- configuration keeps within a set of constraints (i.e. exchanges
- of the same type and name, bidirectional traffic flow, etc.).
- However, there are scenarios where it is useful for the
- administrator to have a bit more control over the details. In
- these cases, static routing is appropriate.
- </p><div class="section" title="1.4.3.3.1. Exchange Routes"><div class="titlepage"><div><div><h5 class="title"><a name="UsingBrokerFederation-ExchangeRoutes"></a>1.4.3.3.1.
- Exchange
- Routes
- </h5></div></div></div><p>
- An exchange route is like a dynamic route except that the
- exchange binding is statically set at creation time instead of
- dynamically tracking changes in the network.
- </p><p>
- When an exchange route is created, a private queue (auto-delete,
- exclusive) is declared on the source broker. The queue is bound
- to the indicated exchange with the indicated key and the
- destination broker subscribes to the queue with a destination of
- the indicated exchange. Since only one exchange name is supplied,
- this means that exchange routes require that the source and
- destination exchanges have the same name.
- </p><p>
- Static exchange routes are added and deleted using <span class="emphasis"><em>qpid-route
- route add</em></span> and <span class="emphasis"><em>qpid-route route del</em></span> respectively. The
- following example creates a static exchange route with a binding
- key of "global.#" on the default topic exchange:
- </p><pre class="programlisting">
-$ qpid-route route add localhost:10001 localhost:10002 amq.topic global.#
+ Note that the two dynamic exchange links are displayed as though they were one bidirectional link. The <span class="command"><strong>route map</strong></span> command is particularly helpful for larger, more complex networks. Let's configure a somewhat more complex network with 16 dynamic exchange routes:
+ </p><pre class="screen">
+qpid-route dynamic add localhost:10001 localhost:10002 fed.topic
+qpid-route dynamic add localhost:10002 localhost:10001 fed.topic
+
+qpid-route dynamic add localhost:10003 localhost:10002 fed.topic
+qpid-route dynamic add localhost:10002 localhost:10003 fed.topic
+
+qpid-route dynamic add localhost:10004 localhost:10002 fed.topic
+qpid-route dynamic add localhost:10002 localhost:10004 fed.topic
+
+qpid-route dynamic add localhost:10002 localhost:10005 fed.topic
+qpid-route dynamic add localhost:10005 localhost:10002 fed.topic
+
+qpid-route dynamic add localhost:10005 localhost:10006 fed.topic
+qpid-route dynamic add localhost:10006 localhost:10005 fed.topic
+
+qpid-route dynamic add localhost:10006 localhost:10007 fed.topic
+qpid-route dynamic add localhost:10007 localhost:10006 fed.topic
+
+qpid-route dynamic add localhost:10006 localhost:10008 fed.topic
+qpid-route dynamic add localhost:10008 localhost:10006 fed.topic
</pre><p>
- The route can be viewed by querying the originating broker (the
- destination in this case, see discussion of push and pull routes
- for more on this):
- </p><pre class="programlisting">
-$ qpid-route route list localhost:10001
-localhost:10001 localhost:10002 amq.topic global.#
-</pre><p>
- Alternatively, the <span class="emphasis"><em>route map</em></span> feature can be used to view
- the topology:
- </p><pre class="programlisting">
-$ qpid-route route map localhost:10001
+ Now we can use <span class="command"><strong>route map</strong></span> starting with any one broker, and see the entire network:
+ </p><pre class="screen">
+$ ./qpid-route route map localhost:10001
Finding Linked Brokers:
localhost:10001... Ok
localhost:10002... Ok
+ localhost:10003... Ok
+ localhost:10004... Ok
+ localhost:10005... Ok
+ localhost:10006... Ok
+ localhost:10007... Ok
+ localhost:10008... Ok
Dynamic Routes:
- none found
+
+ Exchange fed.topic:
+ localhost:10002 <=> localhost:10001
+ localhost:10003 <=> localhost:10002
+ localhost:10004 <=> localhost:10002
+ localhost:10005 <=> localhost:10002
+ localhost:10006 <=> localhost:10005
+ localhost:10007 <=> localhost:10006
+ localhost:10008 <=> localhost:10006
Static Routes:
+ none found
+</pre></div><div class="section" title="1.4.4.6. Resilient Connections"><div class="titlepage"><div><div><h4 class="title"><a name="sect-Messaging_User_Guide-The_qpid_route_Utility-Resilient_Connections"></a>1.4.4.6. Resilient Connections</h4></div></div></div><p>
+ When a broker route is created, or when a durable broker route is restored after broker restart, a connection is created between the source broker and the destination broker. The connections used between brokers are called <em class="firstterm">resilient connections</em>; if the connection fails due to a communication error, it attempts to reconnect. The retry interval begins at 2 seconds and, as more attempts are made, grows to 64 seconds, and continues to retry every 64 seconds thereafter. If the connection fails due to an authentication problem, it will not continue to retry.
+ </p><p>
+ The command <span class="command"><strong>list connections</strong></span> can be used to show the resilient connections for a broker:
+ </p><pre class="screen">
+$ qpid-route list connections localhost:10001
- localhost:10001(ex=amq.topic) <= localhost:10002(ex=amq.topic) key=global.#
-</pre><p>
- This example causes messages delivered to the <span class="emphasis"><em>amq.topic</em></span>
- exchange on broker <span class="emphasis"><em>localhost:10002</em></span> that have a key that
- matches <span class="emphasis"><em>global.#</em></span> (i.e. starts with the string "global.")
- to be delivered to the <span class="emphasis"><em>amq.topic</em></span> exchange on broker
- <span class="emphasis"><em>localhost:10001</em></span>. This delivery will occur regardless of
- whether there are any consumers on <span class="emphasis"><em>localhost:10001</em></span> that
- will receive the messages.
- </p><p>
- Note that this is a uni-directional route. No messages will be
- forwarded in the opposite direction unless another static route
- is created in the other direction.
- </p><p>
- The following diagram illustrates the result, in terms of AMQP
- objects, of the example static exchange route. In this diagram,
- the exchanges, both named "amq.topic" exist prior to the creation
- of the route. The creation of the route causes the private queue,
- the binding, and the subscription of the queue to the destination
- to be created.
- </p><pre class="programlisting">
- -------------------------------------------------+ +------------------------
- localhost:10002 | | localhost:10001
- | |
- +-------------+ | | +-------------+
- | | | | | |
- | | global.# ---------------+ | | | |
- | amq.topic |-----------> private queue |--------------->| amq.topic |
- | | ---------------+ | | | |
- | | | | | |
- +-------------+ | | +-------------+
- | |
- | |
- -------------------------------------------------+ +------------------------
-</pre></div><div class="section" title="1.4.3.3.2. Queue Routes"><div class="titlepage"><div><div><h5 class="title"><a name="UsingBrokerFederation-QueueRoutes"></a>1.4.3.3.2.
- Queue Routes
- </h5></div></div></div><p>
- A queue route causes the destination broker to create a
- subscription to a pre-existing, possibly shared, queue on the
- source broker. There's no requirement that the queue be bound to
- any particular exchange. Queue routes can be used to connect
- exchanges of different names and/or types. They can also be used
- to distribute or balance traffic across multiple destination
- brokers.
- </p><p>
- Queue routes are created and deleted using the <span class="emphasis"><em>qpid-route
- queue add</em></span> and <span class="emphasis"><em>qpid-route queue del</em></span> commands
- respectively. The following example creates a static queue route
- to a public queue called "public" that feeds the amq.fanout
- exchange on the destination:
- </p><p>
- Create a queue on the source broker:
- </p><pre class="programlisting">
-$ qpid-config -a localhost:10002 add queue public
+Host Port Transport Durable State Last Error
+=============================================================================
+localhost 10002 tcp N Operational
+localhost 10003 tcp N Operational
+localhost 10009 tcp N Waiting Connection refused
</pre><p>
- Create a queue route to the new queue
- </p><pre class="programlisting">
-$ qpid-route queue add localhost:10001 localhost:10002 amq.fanout public
-</pre></div><div class="section" title="1.4.3.3.3. Pull vs. Push Routes"><div class="titlepage"><div><div><h5 class="title"><a name="UsingBrokerFederation-Pullvs.PushRoutes"></a>1.4.3.3.3.
- Pull vs.
- Push Routes
- </h5></div></div></div><p>
- When qpid-route creates or deletes a route, it establishes a
- connection to one of the brokers involved in the route and
- configures that broker. The configured broker then takes it upon
- itself to contact the other broker and exchange whatever
- information is needed to complete the setup of the route.
- </p><p>
- The notion of <span class="emphasis"><em>push</em></span> vs. <span class="emphasis"><em>pull</em></span> is concerned with
- whether the configured broker is the source or the destination.
- The normal case is the pull route, where qpid-route configures
- the destination to pull messages from the source. A push route
- occurs when qpid-route configures the source to push messages to
- the destination.
- </p><p>
- Dynamic routes are always pull routes. Static routes are normally
- pull routes but may be inverted by using the src-local
- option when creating (or deleting) a route. If src-local
- is specified, qpid-route will make its connection to the source
- broker rather than the destination and configure the route to
- push rather than pull.
- </p><p>
- Push routes are useful in applications where brokers are
- co-resident with data sources and are configured to send data to
- a central broker. Rather than configure the central broker for
- each source, the sources can be configured to send to the
- destination.
- </p></div></div><div class="section" title="1.4.3.4. qpid-route Summary and Options"><div class="titlepage"><div><div><h4 class="title"><a name="UsingBrokerFederation-qpidrouteSummaryandOptions"></a>1.4.3.4.
- qpid-route
- Summary and Options
- </h4></div></div></div><pre class="programlisting">
-$ qpid-route
-Usage: qpid-route [OPTIONS] dynamic add <dest-broker> <src-broker> <exchange> [tag] [exclude-list]
- qpid-route [OPTIONS] dynamic del <dest-broker> <src-broker> <exchange>
-
- qpid-route [OPTIONS] route add <dest-broker> <src-broker> <exchange> <routing-key> [tag] [exclude-list]
- qpid-route [OPTIONS] route del <dest-broker> <src-broker> <exchange> <routing-key>
- qpid-route [OPTIONS] queue add <dest-broker> <src-broker> <exchange> <queue>
- qpid-route [OPTIONS] queue del <dest-broker> <src-broker> <exchange> <queue>
- qpid-route [OPTIONS] route list [<dest-broker>]
- qpid-route [OPTIONS] route flush [<dest-broker>]
- qpid-route [OPTIONS] route map [<broker>]
-
- qpid-route [OPTIONS] link add <dest-broker> <src-broker>
- qpid-route [OPTIONS] link del <dest-broker> <src-broker>
- qpid-route [OPTIONS] link list [<dest-broker>]
-
-Options:
- --timeout seconds (10) Maximum time to wait for broker connection
- -v [ --verbose ] Verbose output
- -q [ --quiet ] Quiet output, don't print duplicate warnings
- -d [ --durable ] Added configuration shall be durable
- -e [ --del-empty-link ] Delete link after deleting last route on the link
- -s [ --src-local ] Make connection to source broker (push route)
- --ack N Acknowledge transfers over the bridge in batches of N
- -t <transport> [ --transport <transport>]
- Specify transport to use for links, defaults to tcp
-
- dest-broker and src-broker are in the form: [username/password@] hostname | ip-address [:<port>]
- ex: localhost, 10.1.1.7:10000, broker-host:10000, guest/guest@localhost
-</pre><p>
- There are several transport options available for the federation
- link:
- </p><div class="table"><a name="id2900564"></a><p class="title"><b>Table 1.1. Transport Options for Federation</b></p><div class="table-contents"><table summary="Transport Options for Federation" border="1"><colgroup><col><col></colgroup><tbody><tr><td>
- Transport
- </td><td>
- Description
- </td></tr><tr><td>
- tcp
- </td><td>
- (default) A cleartext TCP connection
- </td></tr><tr><td>
- ssl
- </td><td>
- A secure TLS/SSL over TCP connection
- </td></tr><tr><td>
- rdma
- </td><td>
- A Connection using the RDMA interface (typically for an
- Infiniband network)
- </td></tr></tbody></table></div></div><br class="table-break"><p>
- The <span class="emphasis"><em>tag</em></span> and <span class="emphasis"><em>exclude-list</em></span> arguments are not
- needed. They have been left in place for backward compatibility
- and for advanced users who might have very unusual requirements.
- If you're not sure if you need them, you don't. Leave them alone.
- If you must know, please refer to "Message Loop Prevention" in
- the advanced topics section below. The prevention of message
- looping is now automatic and requires no user action.
- </p><p>
- If the link between the two sites has network latency, this can
- be compensated for by increasing the ack frequency with --ack N
- to achieve better batching across the link between the two sites.
- </p></div><div class="section" title="1.4.3.5. Caveats, Limitations, and Things to Avoid"><div class="titlepage"><div><div><h4 class="title"><a name="UsingBrokerFederation-Caveats-2CLimitations-2CandThingstoAvoid"></a>1.4.3.5.
- Caveats,
- Limitations, and Things to Avoid
- </h4></div></div></div><div class="section" title="1.4.3.5.1. Redundant Paths"><div class="titlepage"><div><div><h5 class="title"><a name="UsingBrokerFederation-RedundantPaths"></a>1.4.3.5.1.
- Redundant
- Paths
- </h5></div></div></div><p>
- The current implementation of federation in the M4 broker imposes
- constraints on redundancy in the topology. If there are parallel
- paths from a producer to a consumer, multiple copies of messages
- may be received.
- </p><p>
- A future release of Qpid will solve this problem by allowing
- redundant paths with cost metrics. This will allow the deployment
- of networks that are tolerant of connection or broker loss.
- </p></div><div class="section" title="1.4.3.5.2. Lack of Flow Control"><div class="titlepage"><div><div><h5 class="title"><a name="UsingBrokerFederation-LackofFlowControl"></a>1.4.3.5.2.
- Lack of
- Flow Control
- </h5></div></div></div><p>
- M4 broker federation uses unlimited flow control on the
- federation sessions. Flow control back-pressure will not be
- applied on inter-broker subscriptions.
- </p></div><div class="section" title="1.4.3.5.3. Lack of Cluster Failover Support"><div class="titlepage"><div><div><h5 class="title"><a name="UsingBrokerFederation-LackofClusterFailoverSupport"></a>1.4.3.5.3.
- Lack of
- Cluster Failover Support
- </h5></div></div></div><p>
- The client functionality embedded in the broker for inter-broker
- links does not currently support cluster fail-over. This will be
- added in a subsequent release.
- </p></div></div></div><div class="section" title="1.4.4. Example Scenarios"><div class="titlepage"><div><div><h3 class="title"><a name="UsingBrokerFederation-ExampleScenarios"></a>1.4.4.
- Example
- Scenarios
- </h3></div></div></div><div class="section" title="1.4.4.1. Using QPID to bridge disjoint IP networks"><div class="titlepage"><div><div><h4 class="title"><a name="UsingBrokerFederation-UsingQPIDtobridgedisjointIPnetworks"></a>1.4.4.1.
- Using
- QPID to bridge disjoint IP networks
- </h4></div></div></div><div class="section" title="1.4.4.1.1. Multi-tiered topology"><div class="titlepage"><div><div><h5 class="title"><a name="UsingBrokerFederation-Multitieredtopology"></a>1.4.4.1.1.
- Multi-tiered
- topology
- </h5></div></div></div><pre class="programlisting">
- +-----+
- | 5 |
- +-----+
- / \
- +-----+ +-----+
- | 2 | | 6 |
- +-----+ +-----+
- / | \ | \
- +-----+ +-----+ +-----+ +-----+ +-----+
- | 1 | | 3 | | 4 | | 7 | | 8 |
- +-----+ +-----+ +-----+ +-----+ +-----+
-</pre><p>
- This topology can be configured using the following script.
- </p><pre class="programlisting">
-##
-## Define URLs for the brokers
-##
-broker1=localhost:10001
-broker2=localhost:10002
-broker3=localhost:10003
-broker4=localhost:10004
-broker5=localhost:10005
-broker6=localhost:10006
-broker7=localhost:10007
-broker8=localhost:10008
-
-##
-## Create Topic Exchanges
-##
-qpid-config -a $broker1 add exchange topic fed.topic
-qpid-config -a $broker2 add exchange topic fed.topic
-qpid-config -a $broker3 add exchange topic fed.topic
-qpid-config -a $broker4 add exchange topic fed.topic
-qpid-config -a $broker5 add exchange topic fed.topic
-qpid-config -a $broker6 add exchange topic fed.topic
-qpid-config -a $broker7 add exchange topic fed.topic
-qpid-config -a $broker8 add exchange topic fed.topic
-
-##
-## Create Topic Routes
-##
-qpid-route dynamic add $broker1 $broker2 fed.topic
-qpid-route dynamic add $broker2 $broker1 fed.topic
-
-qpid-route dynamic add $broker3 $broker2 fed.topic
-qpid-route dynamic add $broker2 $broker3 fed.topic
-
-qpid-route dynamic add $broker4 $broker2 fed.topic
-qpid-route dynamic add $broker2 $broker4 fed.topic
-
-qpid-route dynamic add $broker2 $broker5 fed.topic
-qpid-route dynamic add $broker5 $broker2 fed.topic
-
-qpid-route dynamic add $broker5 $broker6 fed.topic
-qpid-route dynamic add $broker6 $broker5 fed.topic
-
-qpid-route dynamic add $broker6 $broker7 fed.topic
-qpid-route dynamic add $broker7 $broker6 fed.topic
-
-qpid-route dynamic add $broker6 $broker8 fed.topic
-qpid-route dynamic add $broker8 $broker6 fed.topic
-</pre></div><div class="section" title="1.4.4.1.2. Load-sharing across brokers"><div class="titlepage"><div><div><h5 class="title"><a name="UsingBrokerFederation-Loadsharingacrossbrokers"></a>1.4.4.1.2.
- Load-sharing
- across brokers
- </h5></div></div></div><p></p></div></div></div><div class="section" title="1.4.5. Advanced Topics"><div class="titlepage"><div><div><h3 class="title"><a name="UsingBrokerFederation-AdvancedTopics"></a>1.4.5.
- Advanced
- Topics
- </h3></div></div></div><div class="section" title="1.4.5.1. Federation Queue Naming"><div class="titlepage"><div><div><h4 class="title"><a name="UsingBrokerFederation-FederationQueueNaming"></a>1.4.5.1.
- Federation
- Queue Naming
- </h4></div></div></div><p></p></div><div class="section" title="1.4.5.2. Message Loop Prevention"><div class="titlepage"><div><div><h4 class="title"><a name="UsingBrokerFederation-MessageLoopPrevention"></a>1.4.5.2.
- Message
- Loop Prevention
- </h4></div></div></div><p></p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch01s03.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch01.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch01s05.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">1.3.
+ In the above output, <span class="command"><strong>Last Error</strong></span> contains the string representation of the last connection error received for the connection. <span class="command"><strong>State</strong></span> represents the state of the connection, and may be one of the following values:
+ </p><div class="table"><a name="tabl-Messaging_User_Guide-Resilient_Connections-State_values_in_qpid_route_list_connections"></a><p class="title"><b>Table 1.2. State values in <span class="command">$ qpid-route list connections</span></b></p><div class="table-contents"><table summary="State values in $ qpid-route list connections" border="1"><colgroup><col><col></colgroup><tbody><tr><td align="left">
+ Waiting
+ </td><td align="left">
+ Waiting before attempting to reconnect.
+ </td></tr><tr><td align="left">
+ Connecting
+ </td><td align="left">
+ Attempting to establish the connection.
+ </td></tr><tr><td align="left">
+ Operational
+ </td><td align="left">
+ The connection has been established and can be used.
+ </td></tr><tr><td align="left">
+ Failed
+ </td><td align="left">
+ The connection failed and will not retry (usually because authentication failed).
+ </td></tr><tr><td align="left">
+ Closed
+ </td><td align="left">
+ The connection has been closed and will soon be deleted.
+ </td></tr><tr><td align="left">
+ Passive
+ </td><td align="left">
+ If a cluster is federated to another cluster, only one of the nodes has an actual connection to remote node. Other nodes in the cluster have a passive connection.
+ </td></tr></tbody></table></div></div><br class="table-break"></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch01s03.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch01.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch01s05.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">1.3.
Cheat Sheet for configuring Exchange Options
</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 1.5.
SSL
Modified: qpid/site/docs/books/0.7/AMQP-Messaging-Broker-CPP-Book/html/ch01s05.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.7/AMQP-Messaging-Broker-CPP-Book/html/ch01s05.html?rev=1069126&r1=1069125&r2=1069126&view=diff
==============================================================================
--- qpid/site/docs/books/0.7/AMQP-Messaging-Broker-CPP-Book/html/ch01s05.html (original)
+++ qpid/site/docs/books/0.7/AMQP-Messaging-Broker-CPP-Book/html/ch01s05.html Wed Feb 9 21:39:27 2011
@@ -1,8 +1,8 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>1.5. SSL</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="AMQP Messaging Broker (Implemented in C++)"><link rel="up" href="ch01.html" title="Chapter 1. Running the AMQP Messaging Broker"><link rel="prev" href="ch01s04.html" title="1.4. Using Broker Federation"><link rel="next" href="ch01s06.html" title="1.6. LVQ"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">1.5.
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>1.5. SSL</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="AMQP Messaging Broker (Implemented in C++)"><link rel="up" href="ch01.html" title="Chapter 1. Running the AMQP Messaging Broker"><link rel="prev" href="ch01s04.html" title="1.4. Broker Federation"><link rel="next" href="ch01s06.html" title="1.6. LVQ"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">1.5.
SSL
</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch01s04.html">Prev</a> </td><th width="60%" align="center">Chapter 1.
Running the AMQP Messaging Broker
- </th><td width="20%" align="right"> <a accesskey="n" href="ch01s06.html">Next</a></td></tr></table><hr></div><div class="section" title="1.5. SSL"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2898157"></a>1.5.
+ </th><td width="20%" align="right"> <a accesskey="n" href="ch01s06.html">Next</a></td></tr></table><hr></div><div class="section" title="1.5. SSL"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2896362"></a>1.5.
SSL
</h2></div></div></div><div class="section" title="1.5.1. SSL How to"><div class="titlepage"><div><div><h3 class="title"><a name="SSL-SSLHowto"></a>1.5.1.
SSL How to
@@ -95,8 +95,6 @@ public void connectSSL(String host, int
Ruby Client (M4 and up)
</h4></div></div></div><p>
Simply use amqps:// in the URL string as defined above
- </p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch01s04.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch01.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch01s06.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">1.4.
- Using Broker Federation
- </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 1.6.
+ </p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch01s04.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch01.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch01s06.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">1.4. Broker Federation </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 1.6.
LVQ
</td></tr></table></div></body></html>
Modified: qpid/site/docs/books/0.7/AMQP-Messaging-Broker-CPP-Book/html/ch01s06.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.7/AMQP-Messaging-Broker-CPP-Book/html/ch01s06.html?rev=1069126&r1=1069125&r2=1069126&view=diff
==============================================================================
--- qpid/site/docs/books/0.7/AMQP-Messaging-Broker-CPP-Book/html/ch01s06.html (original)
+++ qpid/site/docs/books/0.7/AMQP-Messaging-Broker-CPP-Book/html/ch01s06.html Wed Feb 9 21:39:27 2011
@@ -2,7 +2,7 @@
LVQ
</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch01s05.html">Prev</a> </td><th width="60%" align="center">Chapter 1.
Running the AMQP Messaging Broker
- </th><td width="20%" align="right"> <a accesskey="n" href="ch01s07.html">Next</a></td></tr></table><hr></div><div class="section" title="1.6. LVQ"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2898696"></a>1.6.
+ </th><td width="20%" align="right"> <a accesskey="n" href="ch01s07.html">Next</a></td></tr></table><hr></div><div class="section" title="1.6. LVQ"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2896188"></a>1.6.
LVQ
</h2></div></div></div><div class="section" title="1.6.1. Understanding LVQ"><div class="titlepage"><div><div><h3 class="title"><a name="LVQ-UnderstandingLVQ"></a>1.6.1.
Understanding LVQ
Modified: qpid/site/docs/books/0.7/AMQP-Messaging-Broker-CPP-Book/html/ch01s07.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.7/AMQP-Messaging-Broker-CPP-Book/html/ch01s07.html?rev=1069126&r1=1069125&r2=1069126&view=diff
==============================================================================
--- qpid/site/docs/books/0.7/AMQP-Messaging-Broker-CPP-Book/html/ch01s07.html (original)
+++ qpid/site/docs/books/0.7/AMQP-Messaging-Broker-CPP-Book/html/ch01s07.html Wed Feb 9 21:39:27 2011
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>1.7. Queue State Replication</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="AMQP Messaging Broker (Implemented in C++)"><link rel="up" href="ch01.html" title="Chapter 1. Running the AMQP Messaging Broker"><link rel="prev" href="ch01s06.html" title="1.6. LVQ"><link rel="next" href="ch01s08.html" title="1.8. Starting a cluster"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">1.7.
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>1.7. Queue State Replication</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="AMQP Messaging Broker (Implemented in C++)"><link rel="up" href="ch01.html" title="Chapter 1. Running the AMQP Messaging Broker"><link rel="prev" href="ch01s06.html" title="1.6. LVQ"><link rel="next" href="ch01s08.html" title="1.8. High Availability Messaging Clusters"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">1.7.
Queue State Replication
</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch01s06.html">Prev</a> </td><th width="60%" align="center">Chapter 1.
Running the AMQP Messaging Broker
@@ -226,6 +226,4 @@ Queue Replication Options:
--load-module <path-to-qpid-dir>/src/.libs/replication_exchange.so
</pre></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch01s06.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch01.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch01s08.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">1.6.
LVQ
- </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 1.8.
- Starting a cluster
- </td></tr></table></div></body></html>
+ </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 1.8. High Availability Messaging Clusters</td></tr></table></div></body></html>
---------------------------------------------------------------------
Apache Qpid - AMQP Messaging Implementation
Project: http://qpid.apache.org
Use/Interact: mailto:commits-subscribe@qpid.apache.org