You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@qpid.apache.org by jr...@apache.org on 2013/07/23 13:02:09 UTC

svn commit: r1505967 - in /qpid/site: docs/ docs/components/ docs/components/dispatch-router/ docs/components/dispatch/ input/ input/components/ input/components/dispatch-router/ input/components/dispatch/

Author: jross
Date: Tue Jul 23 11:02:08 2013
New Revision: 1505967

URL: http://svn.apache.org/r1505967
Log:
QPID-4990: Move dispatch router to a directory name that leaves room for other dispatch components

Added:
    qpid/site/docs/components/dispatch-router/
    qpid/site/docs/components/dispatch-router/addressing.html
    qpid/site/docs/components/dispatch-router/index.html
    qpid/site/input/components/dispatch-router/
      - copied from r1505965, qpid/site/input/components/dispatch/
Removed:
    qpid/site/docs/components/dispatch/
    qpid/site/input/components/dispatch/
Modified:
    qpid/site/docs/.htaccess
    qpid/site/docs/components/index.html
    qpid/site/docs/documentation.html
    qpid/site/input/.htaccess
    qpid/site/input/components/index.md
    qpid/site/input/documentation.md

Modified: qpid/site/docs/.htaccess
URL: http://svn.apache.org/viewvc/qpid/site/docs/.htaccess?rev=1505967&r1=1505966&r2=1505967&view=diff
==============================================================================
--- qpid/site/docs/.htaccess (original)
+++ qpid/site/docs/.htaccess Tue Jul 23 11:02:08 2013
@@ -45,6 +45,7 @@
 </IfModule>
 
 <IfModule mod_alias.c>
+  Redirect /components/dispatch/index.html http://qpid.apache.org/components/dispatch-router/index.html
   Redirect /download.cgi http://qpid.apache.org/download.html
   Redirect /licence.html http://www.apache.org/licenses/
 

Added: qpid/site/docs/components/dispatch-router/addressing.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/components/dispatch-router/addressing.html?rev=1505967&view=auto
==============================================================================
--- qpid/site/docs/components/dispatch-router/addressing.html (added)
+++ qpid/site/docs/components/dispatch-router/addressing.html Tue Jul 23 11:02:08 2013
@@ -0,0 +1,183 @@
+<!DOCTYPE html>
+<!--
+ -
+ - Licensed to the Apache Software Foundation (ASF) under one
+ - or more contributor license agreements.  See the NOTICE file
+ - distributed with this work for additional information
+ - regarding copyright ownership.  The ASF licenses this file
+ - to you under the Apache License, Version 2.0 (the
+ - "License"); you may not use this file except in compliance
+ - with the License.  You may obtain a copy of the License at
+ -
+ -   http://www.apache.org/licenses/LICENSE-2.0
+ -
+ - Unless required by applicable law or agreed to in writing,
+ - software distributed under the License is distributed on an
+ - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ - KIND, either express or implied.  See the License for the
+ - specific language governing permissions and limitations
+ - under the License.
+ -
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
+  <head>
+    <title>Dispatch Addressing - Apache Qpid&#153;</title>
+    <meta http-equiv="X-UA-Compatible" content="IE=edge"/>
+    <link rel="stylesheet" href="http://qpid.apache.org/site.css" type="text/css"/>
+    <link rel="stylesheet" href="http://qpid.apache.org/pygments.css" type="text/css"/>
+    <!--[if lte IE 8]>
+      <link rel="stylesheet" href="http://qpid.apache.org/ie.css" type="text/css"/>
+    <![endif]-->
+    <script type="text/javascript" src="http://qpid.apache.org/site.js"></script>
+  </head>
+  <body>
+    <div id="content">
+      <div id="top">
+        <a id="search-link" href="http://qpid.apache.org/search.html"><img width="22" height="16" src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABUAAAAQCAYAAAD52jQlAAABmklEQVQ4y2P4//8/A7UxpkBoAxtPaIMTb2hdKW9I/WLe0Pp2nrC6YO7IKnGyDOUObTAAGnIRiP9j4oZPQJxGkqF8YXWRQE2/oAY84Q1rmMETUpfOF9LQBBQ7jGTBaqIM5YyolgUq/gjWBDRMxK+MF10hX0hdNFwNAReDCaCidVBXbManGGowJCgCK4VxGgoEjDAX8IfWKBLyGlDdSajBfjgN5Q2tUYe68jExkQBMEd1g9SH1rTgN5Q+tc4UaepwYQ/lC6/Khhi7GaShPYIMY1NDPDA0NTARdGtYwD2JoXTGBiKp/DFIIdIU3PgOFohv4gOqegtQCM4QjXkOBOagOlj75QhuE8ETSfKT0+pontK5aMLScH6uhDGlprEDDzkENfsAdUueMrIgrokEKKLcRKg/KIKeRDP8IzsrAYMTMUcE1qgiDwfgtEO8H4tvIBgDVRIGzdFiDC9CCfUjZ+BtvSIMPRt4HuzisoQGo6CVa3v8O1LQJlPMwg6TWEpRpoOGcjbWUgmFw1g2r8+UOr9VncGhgIZjfQ0OZYWwAIBYjaUYze6wAAAAASUVORK5CYII="/></a>
+
+        <ul id="global-navigation">
+          <li><a id="logotype" href="http://qpid.apache.org/index.html">Apache Qpid<sup>&#153;</sup></a></li>
+          <li><a href="http://qpid.apache.org/download.html">Download</a></li>
+          <li><a href="http://qpid.apache.org/documentation.html">Documentation</a></li>
+          <li><a href="http://qpid.apache.org/discussion.html">Discussion</a></li>
+          <li><a href="http://qpid.apache.org/issues.html">Issues</a></li>
+          <li><a href="http://qpid.apache.org/source-code.html">Source Code</a></li>
+          <li><a href="http://qpid.apache.org/resources.html">More Resources</a></li>
+        </ul>
+      </div>
+      <div id="middle">
+        <ul id="path-navigation"><li><a href="http://qpid.apache.org/components/index.html">Components</a></li><li><a href="http://qpid.apache.org/components/dispatch-router/index.html">Dispatch Router</a></li><li>Dispatch Addressing</li></ul>
+        <h1 id="dispatch-addressing">Dispatch Addressing</h1>
+
+<p>AMQP addresses are used to control the flow of messages across a network of
+routers.  Addresses are used in a number of different places in the AMQP 1.0
+protocol.  They can be used in a specific message in the <code>to</code> and <code>reply-to</code>
+fields of a message's properties.  They are also used during the creation of
+links in the <code>address</code> field of a <code>source</code> or a <code>target</code>.</p>
+
+<p>Addresses designate various kinds of entities in a messaging network:</p>
+
+<ul>
+<li>Endpoint processes that consume data or offer a service</li>
+<li>Topics that match multiple consumers to multiple producers</li>
+<li>Entities within a messaging broker:
+<ul>
+<li>Queues</li>
+<li>Durable Topics</li>
+<li>Exchanges</li>
+</ul></li>
+</ul>
+
+<p>The syntax of an AMQP address is opaque as far as the router network is concerned.  A
+syntactical structure may be used by the administrator that creates addresses, but the router
+treats them as opaque strings.  Routers consider addresses to be mobile such that
+any address may be directly connected to any router in a network and may move around the topology.
+In cases where messages are broadcast to or balanced across multiple consumers, an address may
+be connected to multiple routers in the network.</p>
+
+<p>Addresses have semantics associated with them.  When an address is created in the network,
+it is assigned a set of semantics (and access rules) during a process called provisioning.
+The semantics of an address control how routers behave when they see the address being used.</p>
+
+<p>Address semantics include the following considerations:</p>
+
+<ul>
+<li><em>Routing pattern</em> - direct, multicast, balanced</li>
+<li><em>Routing mechanism</em> - message routed, link routed</li>
+<li><em>Undeliverable action</em> - drop, hold and retry, redirect</li>
+<li><em>Reliability</em> - N destinations, etc.</li>
+</ul>
+
+<h2 id="routing-patterns">Routing patterns</h2>
+
+<p>Routing patterns constrain the paths that a message can take across a network.</p>
+
+<table>
+<tbody>
+<tr><td><em>Pattern</em></td><td><em>Description</em></td></tr>
+<tr><td><em>Direct</em></td><td>Direct routing allows for only one consumer to use an address at a time.  Messages (or links) follow the lowest cost path across the network from the sender to the one receiver.</td></tr>
+<tr><td><em>Multicast</em></td><td>Multicast routing allows multiple consumers to use the same address at the same time.  Messages are routed such that each consumer receives a copy of the message.</td></tr>
+<tr><td><em>Balanced</em></td><td>Balanced routing also allows multiple consumers to use the same address.  In this case, messages (or links) are routed to exactly one of the consumers, and the network attempts to balance the traffic load across the set of consumers using the same address.</td></tr>
+</tbody>
+</table>
+
+<h2 id="routing-mechanisms">Routing mechanisms</h2>
+
+<p>The fact that addresses can be used in different ways suggests that message
+routing can be accomplished in different ways.  Before going into the specifics
+of the different routing mechanisms, it would be good to first define what is
+meant by the term <em>routing</em>:</p>
+
+<blockquote>
+  <p>In a network built of multiple routers connected by connections (i.e., nodes and
+  edges in a graph), <em>routing</em> determines which connection to use to send a message
+  directly to its destination or one step closer to its destination.</p>
+</blockquote>
+
+<p>Each router serves as the terminus of a collection of incoming and outgoing links.
+Some of the links are designated for message routing, and others are designated for
+link routing.  In both cases, the links either connect directly to endpoints that
+produce and consume messages, or they connect to other routers in the network along
+previously established connections.</p>
+
+<h3 id="message-routing">Message routing</h3>
+
+<p>Message routing occurs upon delivery of a message and is done based on the address
+in the message's <code>to</code> field.</p>
+
+<p>When a delivery arrives on an incoming message-routing link, the router extracts the
+address from the delivered message's <code>to</code> field and looks the address up in its
+routing table.  The lookup results in zero or more outgoing links onto which the message
+shall be resent.</p>
+
+<table>
+<tbody>
+<tr><td><em>Delivery</em></td><td><em>Handling</em></td></tr>
+<tr><td><em>pre-settled</em></td><td>If the arriving delivery is pre-settled (i.e., fire and forget), the incoming delivery shall be settled by the router, and the outgoing deliveries shall also be pre-settled. In other words, the pre-settled nature of the message delivery is propagated across the network to the message's destination.</td></tr>
+<tr><td><em>unsettled</em></td><td>Unsettled delivery is also propagated across the network.  Because unsettled delivery records cannot be discarded, the router tracks the incoming deliveries and keeps the association of the incoming deliveries to the resulting outgoing deliveries.  This kept association allows the router to continue to propagate changes in delivery state (settlement and disposition) back and forth along the path which the message traveled.</td></tr>
+</tbody>
+</table>
+
+<h3 id="link-routing">Link routing</h3>
+
+<p>Link routing occurs when a new link is attached to the router across one of its AMQP connections.
+It is done based on the <code>target.address</code> field of an inbound link and the <code>source.address</code> field
+of an outbound link.</p>
+
+<p>Link routing uses the same routing table that message routing uses.  The difference is that the
+routing occurs during the link-attach operation, and link attaches are propagated along the appropriate
+path to the destination.  What results is a chain of links, connected end-to-end, from source to
+destination.  It is similar to a <em>virtual circuit</em> in a telecom system.</p>
+
+<p>Each router in the chain holds pairs of link termini that are tied together.  The router then simply
+exchanges all deliveries, delivery state changes, and link state changes between the two termini.</p>
+
+<p>The endpoints that use the link chain do not see any difference in behavior between a link chain and
+a single point-to-point link.  All of the features available in the link protocol (flow control,
+transactional delivery, etc.) are available over a routed link-chain.</p>
+
+      </div>
+      <div id="bottom">
+        <ul id="apache-navigation">
+          <li><a href="http://www.apache.org/">Apache</a></li>
+          <li><a href="http://www.apache.org/licenses/">License</a></li>
+          <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+          <li><a href="http://www.apache.org/foundation/thanks.html">Thanks!</a></li>
+          <li><a href="http://www.apache.org/security/">Security</a></li>
+          <li><a href="http://www.apache.org/"><img id="apache-feather" width="48" height="14" src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAC4AAAAOCAYAAABQFS4BAAAFnElEQVRIx83S22ukdx3H8e/v8Pyew5xnsrMJSZNsmm4PW91uL5ZWhIK9EA/Fq8Uiite9EuzVFhbxoqvd7kWLVEWEuioqpQgVtmpFssZtabpR9xCb7uQwmexMspPM5JmZ5/w8v9/v64UtiCi2StX3X/CCz4fMz8w8vN5qLSGihnf7ypkzdw333Eeaq43f/G7xtRb8H0bOnz//+He/9cLjCHpZEfL9ZrN5+9wLL55GUJ/f2W7B3M+WnzZRfqmAukA0jgpVfu1NHF1dGHZ+abbnswVckP8T+Orq6tEwjJ5/9plvlv5wZflO1PriY6dOYcwKX6xWyli/uLUaRf2jdwRUTBGl+kL6PA5HlVGQ2zNVK7T0WlJhr1wW6hcvLizE/zU4IsLS0lKxVjv09dXVP3/5RxcuHNy4dn18/r77LCIKOBFN+XWds4uQcuEOCKOZOr6b8O6E0OV+AGUtVd+I99JS4ks3XWncgctqlv36qe+9dvVDh79Xo9E4ufzH61/b6e5/YnHxEvY7bYPGNs5Wj+s8q4GdY7TkR8gxFGNdATiZKifwyHTXBZnPqZR4EScq9aNQxfPkem8YvVPhxhu/Pch+9YM/LQw+NPgTp0/PVuzydxTwh6M4sk9gLrj51nZxhwWqPdwgeXFYVcQkpdqgRlbmDhI1z3sqsyjPp4GquSMSCIrTUUATJlJSSKMeCePJ7TTr5OTQrBsH7JAY9kDK3n504WK7/ebi2tr+fww/e/bcZ6rj489YljNj2zYUnv6x50VpXRoFFGmFL9QTKR2qtocbdDAI+HhlBkp0QumUkgckI/0q6OPuEHrlHFaTEea
 TGHUA3MwzXXB9Gtg69axcaoYBt+NwEN7N/L0idvsr2TtpPrnCHilcOn32lfUPDG82mx/dat366sR4XW9ttUz9k1c/LV5fLylb4DGX0x/OjeuwMh0DoKF9yg/EjhrpHu4MtlgYKFIvTslJo0oTXcGTI5f2ihVdFEBEGGhOJB3latqWrprrBwa3Ez0kDl5lR8jd5oZv0CAd21RsO99ruyet55e8Wy+/9NKK/77g7/78HinlpmmaH9Fan+ldfvVT8Po1VlpL2VVq60IM6TDTzIkOGe44xBEXYOuEbViCeSyRcerhXtBlu26blewxnTcPY44yQLRBgca52KYz6BMTDL1sztM7jU00MiWjxOEP8S5WICK7EtrJgcvg0ULXOZrnmxitdQ+it/3B8LlvfPv37j+E/33r6xvnR8POF8JOozh6e004FzehdluzQbFM0VRxzAUSRJIhwX6GlOdySgJhocH5fhqgb9kqIgAcQgiYAXE2Yv1gQJRCYMjJlEI5yh/GIzo05oNMdUSRTSovPTaMhHvqcBpMUmIWUMkMItRhZ9f1fvrEkz8/9y/hf12heZxz/KTS+nO3b63cG/VvOvLyBoOmr8enLOoveiT3MQfxUkC6JigClDAF1NAKUuFgGSg2c4bUjINODbZPJF3nd9H7RUdFQUgaloVjmYcDs05M1YWBClFUGZs8kqpqxQGDE0oBkHOiewM/VFl87X3B/7Zms/mYUvjZKPIe8lu7VSn2S8mVthGzgCIJCH2jD3yoSBpr4tQYhAQwvydJDYnuGEwxhcxWSPYYp9IXMCdivWMbmACiiRrUkLKyleq+JVBMC6ofFbpUNQEVAEpJGzsuuAMVfWD4e7XbbdtPknsp4oME8R4AOg2g61HgV73RIGdorr1GK+/vbrPEyuxiMyJwgsvkUo+jDgxdtzANU8PeylT+42PS24iQFBixcijkyInh/kqaBcpwWiM4eNAE7gjl5OuqUDsWT0zO7P7b8H/WjRs3
 Koh4qFwuZ1mWPYAIJwCwCAA5JKREEPJKqRnKmUcQbSCEESAeAqSISAmBKiKuEIAuALUQ9BglBBExopSuUkpfnp2dvfkX6a5m0ZqSUXAAAAAASUVORK5CYII="/></a></li>
+        </ul>
+
+        <p id="legal">
+          Apache Qpid, Messaging built on AMQP; Copyright &#169; 2013
+          The Apache Software Foundation; Licensed under
+          the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache
+          License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton,
+          Proton, Apache, the Apache feather logo, and the Apache Qpid
+          project logo are trademarks of The Apache Software
+          Foundation; All other marks mentioned may be trademarks or
+          registered trademarks of their respective owners
+        </p>
+      </div>
+    </div>
+  </body>
+</html>

Added: qpid/site/docs/components/dispatch-router/index.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/components/dispatch-router/index.html?rev=1505967&view=auto
==============================================================================
--- qpid/site/docs/components/dispatch-router/index.html (added)
+++ qpid/site/docs/components/dispatch-router/index.html Tue Jul 23 11:02:08 2013
@@ -0,0 +1,140 @@
+<!DOCTYPE html>
+<!--
+ -
+ - Licensed to the Apache Software Foundation (ASF) under one
+ - or more contributor license agreements.  See the NOTICE file
+ - distributed with this work for additional information
+ - regarding copyright ownership.  The ASF licenses this file
+ - to you under the Apache License, Version 2.0 (the
+ - "License"); you may not use this file except in compliance
+ - with the License.  You may obtain a copy of the License at
+ -
+ -   http://www.apache.org/licenses/LICENSE-2.0
+ -
+ - Unless required by applicable law or agreed to in writing,
+ - software distributed under the License is distributed on an
+ - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ - KIND, either express or implied.  See the License for the
+ - specific language governing permissions and limitations
+ - under the License.
+ -
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
+  <head>
+    <title>Dispatch Router - Apache Qpid&#153;</title>
+    <meta http-equiv="X-UA-Compatible" content="IE=edge"/>
+    <link rel="stylesheet" href="http://qpid.apache.org/site.css" type="text/css"/>
+    <link rel="stylesheet" href="http://qpid.apache.org/pygments.css" type="text/css"/>
+    <!--[if lte IE 8]>
+      <link rel="stylesheet" href="http://qpid.apache.org/ie.css" type="text/css"/>
+    <![endif]-->
+    <script type="text/javascript" src="http://qpid.apache.org/site.js"></script>
+  </head>
+  <body>
+    <div id="content">
+      <div id="top">
+        <a id="search-link" href="http://qpid.apache.org/search.html"><img width="22" height="16" src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABUAAAAQCAYAAAD52jQlAAABmklEQVQ4y2P4//8/A7UxpkBoAxtPaIMTb2hdKW9I/WLe0Pp2nrC6YO7IKnGyDOUObTAAGnIRiP9j4oZPQJxGkqF8YXWRQE2/oAY84Q1rmMETUpfOF9LQBBQ7jGTBaqIM5YyolgUq/gjWBDRMxK+MF10hX0hdNFwNAReDCaCidVBXbManGGowJCgCK4VxGgoEjDAX8IfWKBLyGlDdSajBfjgN5Q2tUYe68jExkQBMEd1g9SH1rTgN5Q+tc4UaepwYQ/lC6/Khhi7GaShPYIMY1NDPDA0NTARdGtYwD2JoXTGBiKp/DFIIdIU3PgOFohv4gOqegtQCM4QjXkOBOagOlj75QhuE8ETSfKT0+pontK5aMLScH6uhDGlprEDDzkENfsAdUueMrIgrokEKKLcRKg/KIKeRDP8IzsrAYMTMUcE1qgiDwfgtEO8H4tvIBgDVRIGzdFiDC9CCfUjZ+BtvSIMPRt4HuzisoQGo6CVa3v8O1LQJlPMwg6TWEpRpoOGcjbWUgmFw1g2r8+UOr9VncGhgIZjfQ0OZYWwAIBYjaUYze6wAAAAASUVORK5CYII="/></a>
+
+        <ul id="global-navigation">
+          <li><a id="logotype" href="http://qpid.apache.org/index.html">Apache Qpid<sup>&#153;</sup></a></li>
+          <li><a href="http://qpid.apache.org/download.html">Download</a></li>
+          <li><a href="http://qpid.apache.org/documentation.html">Documentation</a></li>
+          <li><a href="http://qpid.apache.org/discussion.html">Discussion</a></li>
+          <li><a href="http://qpid.apache.org/issues.html">Issues</a></li>
+          <li><a href="http://qpid.apache.org/source-code.html">Source Code</a></li>
+          <li><a href="http://qpid.apache.org/resources.html">More Resources</a></li>
+        </ul>
+      </div>
+      <div id="middle">
+        <ul id="path-navigation"><li><a href="http://qpid.apache.org/components/index.html">Components</a></li><li>Dispatch Router</li></ul>
+        <h1 id="dispatch-router">Dispatch Router</h1>
+
+<p>A lightweight message router, written in C and built on
+<a href="http://qpid.apache.org/proton/index.html">Qpid Proton</a>, that provides flexible
+and scalable interconnect between AMQP endpoints or between endpoints
+and brokers.</p>
+
+<table>
+<tbody>
+<tr><td><em>Platforms</em></td><td>Linux</td></tr>
+<tr><td><em>AMQP versions</em></td><td>1.0</td></tr>
+<tr><td><em>Download</em></td><td><em>Coming soon</em></td></tr>
+<tr><td><em>Source location</em></td><td><a href="http://svn.apache.org/repos/asf/qpid/trunk/qpid/extras/dispatch/">http://svn.apache.org/repos/asf/qpid/trunk/qpid/extras/dispatch/</a></td></tr>
+<tr><td><em>Issues</em></td><td><a href="https://issues.apache.org/jira/issues/?jql=project+%3D+%22Qpid%22+and+issuetype+%3D+%22Bug%22+and+status+in+%28%22Open%22%2C+%22Reopened%22%2C+%22In+Progress%22%2C+%22Ready+To+Review%22%29+and+component+%3D+%22Qpid+Dispatch%22">Open bugs</a>, <a href="https://issues.apache.org/jira/issues/?jql=project+%3D+%22Qpid%22+and+issuetype+in+%28%22New+Feature%22%2C+%22Improvement%22%29+and+status+in+%28%22Closed%22%2C+%22Resolved%22%29+and+resolution+%3D+%22Fixed%22+and+component+%3D+%22Qpid+Dispatch%22">Completed enhancements</a>, <a href="https://issues.apache.org/jira/issues/?jql=project+%3D+%22Qpid%22+and+issuetype+in+%28%22New+Feature%22%2C+%22Improvement%22%29+and+status+in+%28%22Open%22%2C+%22Reopened%22%2C+%22In+Progress%22%2C+%22Ready+To+Review%22%29+and+component+%3D+%22Qpid+Dispatch%22">Requested enhancements</a></td></tr>
+</tbody>
+</table>
+
+<h2 id="overview">Overview</h2>
+
+<p>The Dispatch router is an AMQP router that provides advanced interconnect for AMQP.
+It is <em>not</em> a broker.  It will never assume ownership of a message.  It will,
+however, propagate settlement and disposition across a network such that delivery
+guarantees are met.</p>
+
+<p>The router is meant to be deployed in topologies of multiple routers, preferably with
+redundant paths.  It uses link-state routing protocols and algorithms (similar to OSPF
+or IS-IS from the networking world) to calculate the best path from every point to
+every other point and to recover quickly from failures.  It does not need to use
+clustering for high availability; rather, it relies on redundant paths to provide
+continued connectivity in the face of system or network failure.</p>
+
+<p>A messaging client can make a single AMQP connection into a messaging bus built of
+Dispatch routers and, over that connection, exchange messages with one or more message
+brokers, and at the same time exchange messages directly with other endpoints without
+involving a broker at all.</p>
+
+<h2 id="benefits">Benefits</h2>
+
+<ul>
+<li>Simplifies connectivity
+<ul>
+<li>An endpoint can do all of its messaging through a single transport connection</li>
+<li>Avoid opening holes in firewalls for incoming connections</li>
+</ul></li>
+<li>Simplifies reliability
+<ul>
+<li>Reliability and availability are provided using redundant topology, not server clustering</li>
+<li>Reliable end-to-end messaging without persistent stores</li>
+<li>Use a message broker only when you need store-and-forward semantics</li>
+</ul></li>
+</ul>
+
+<h2 id="features">Features</h2>
+
+<ul>
+<li>Supports arbitrary topology - no restrictions on redundancy</li>
+<li>Automatic route computation - adjusts quickly to changes in topology</li>
+<li>Cost-based route computation</li>
+<li><a href="addressing.html">Rich addressing semantics</a></li>
+<li>Security</li>
+</ul>
+
+<h2 id="documentation">Documentation</h2>
+
+<p><em>Coming soon</em></p>
+
+      </div>
+      <div id="bottom">
+        <ul id="apache-navigation">
+          <li><a href="http://www.apache.org/">Apache</a></li>
+          <li><a href="http://www.apache.org/licenses/">License</a></li>
+          <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+          <li><a href="http://www.apache.org/foundation/thanks.html">Thanks!</a></li>
+          <li><a href="http://www.apache.org/security/">Security</a></li>
+          <li><a href="http://www.apache.org/"><img id="apache-feather" width="48" height="14" src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAC4AAAAOCAYAAABQFS4BAAAFnElEQVRIx83S22ukdx3H8e/v8Pyew5xnsrMJSZNsmm4PW91uL5ZWhIK9EA/Fq8Uiite9EuzVFhbxoqvd7kWLVEWEuioqpQgVtmpFssZtabpR9xCb7uQwmexMspPM5JmZ5/w8v9/v64UtiCi2StX3X/CCz4fMz8w8vN5qLSGihnf7ypkzdw333Eeaq43f/G7xtRb8H0bOnz//+He/9cLjCHpZEfL9ZrN5+9wLL55GUJ/f2W7B3M+WnzZRfqmAukA0jgpVfu1NHF1dGHZ+abbnswVckP8T+Orq6tEwjJ5/9plvlv5wZflO1PriY6dOYcwKX6xWyli/uLUaRf2jdwRUTBGl+kL6PA5HlVGQ2zNVK7T0WlJhr1wW6hcvLizE/zU4IsLS0lKxVjv09dXVP3/5RxcuHNy4dn18/r77LCIKOBFN+XWds4uQcuEOCKOZOr6b8O6E0OV+AGUtVd+I99JS4ks3XWncgctqlv36qe+9dvVDh79Xo9E4ufzH61/b6e5/YnHxEvY7bYPGNs5Wj+s8q4GdY7TkR8gxFGNdATiZKifwyHTXBZnPqZR4EScq9aNQxfPkem8YvVPhxhu/Pch+9YM/LQw+NPgTp0/PVuzydxTwh6M4sk9gLrj51nZxhwWqPdwgeXFYVcQkpdqgRlbmDhI1z3sqsyjPp4GquSMSCIrTUUATJlJSSKMeCePJ7TTr5OTQrBsH7JAY9kDK3n504WK7/ebi2tr+fww/e/bcZ6rj489YljNj2zYUnv6x50VpXRoFFGmFL9QTKR2qtocbdDAI+HhlBkp0QumUkgckI/0q6OPuEHrlHFaTEea
 TGHUA3MwzXXB9Gtg69axcaoYBt+NwEN7N/L0idvsr2TtpPrnCHilcOn32lfUPDG82mx/dat366sR4XW9ttUz9k1c/LV5fLylb4DGX0x/OjeuwMh0DoKF9yg/EjhrpHu4MtlgYKFIvTslJo0oTXcGTI5f2ihVdFEBEGGhOJB3latqWrprrBwa3Ez0kDl5lR8jd5oZv0CAd21RsO99ruyet55e8Wy+/9NKK/77g7/78HinlpmmaH9Fan+ldfvVT8Po1VlpL2VVq60IM6TDTzIkOGe44xBEXYOuEbViCeSyRcerhXtBlu26blewxnTcPY44yQLRBgca52KYz6BMTDL1sztM7jU00MiWjxOEP8S5WICK7EtrJgcvg0ULXOZrnmxitdQ+it/3B8LlvfPv37j+E/33r6xvnR8POF8JOozh6e004FzehdluzQbFM0VRxzAUSRJIhwX6GlOdySgJhocH5fhqgb9kqIgAcQgiYAXE2Yv1gQJRCYMjJlEI5yh/GIzo05oNMdUSRTSovPTaMhHvqcBpMUmIWUMkMItRhZ9f1fvrEkz8/9y/hf12heZxz/KTS+nO3b63cG/VvOvLyBoOmr8enLOoveiT3MQfxUkC6JigClDAF1NAKUuFgGSg2c4bUjINODbZPJF3nd9H7RUdFQUgaloVjmYcDs05M1YWBClFUGZs8kqpqxQGDE0oBkHOiewM/VFl87X3B/7Zms/mYUvjZKPIe8lu7VSn2S8mVthGzgCIJCH2jD3yoSBpr4tQYhAQwvydJDYnuGEwxhcxWSPYYp9IXMCdivWMbmACiiRrUkLKyleq+JVBMC6ofFbpUNQEVAEpJGzsuuAMVfWD4e7XbbdtPknsp4oME8R4AOg2g61HgV73RIGdorr1GK+/vbrPEyuxiMyJwgsvkUo+jDgxdtzANU8PeylT+42PS24iQFBixcijkyInh/kqaBcpwWiM4eNAE7gjl5OuqUDsWT0zO7P7b8H/WjRs3
 Koh4qFwuZ1mWPYAIJwCwCAA5JKREEPJKqRnKmUcQbSCEESAeAqSISAmBKiKuEIAuALUQ9BglBBExopSuUkpfnp2dvfkX6a5m0ZqSUXAAAAAASUVORK5CYII="/></a></li>
+        </ul>
+
+        <p id="legal">
+          Apache Qpid, Messaging built on AMQP; Copyright &#169; 2013
+          The Apache Software Foundation; Licensed under
+          the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache
+          License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton,
+          Proton, Apache, the Apache feather logo, and the Apache Qpid
+          project logo are trademarks of The Apache Software
+          Foundation; All other marks mentioned may be trademarks or
+          registered trademarks of their respective owners
+        </p>
+      </div>
+    </div>
+  </body>
+</html>

Modified: qpid/site/docs/components/index.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/components/index.html?rev=1505967&r1=1505966&r2=1505967&view=diff
==============================================================================
--- qpid/site/docs/components/index.html (original)
+++ qpid/site/docs/components/index.html Tue Jul 23 11:02:08 2013
@@ -75,7 +75,7 @@ persistence, and manageability.</p>
 <ul>
 <li><a href="cpp-broker/index.html">C++ broker</a> - A native-code AMQP message broker</li>
 <li><a href="cpp-broker-tools/index.html">C++ broker command-line tools</a> - Manage the C++ broker</li>
-<li><a href="dispatch/index.html">Dispatch router</a> - An AMQP router for scalable messaging interconnect</li>
+<li><a href="dispatch-router/index.html">Dispatch router</a> - An AMQP router for scalable messaging interconnect</li>
 <li><a href="java-broker/index.html">Java broker</a> - A pure-Java AMQP message broker</li>
 <li><a href="qmf/index.html">QMF</a> - Management built on Qpid messaging</li>
 </ul>
@@ -89,7 +89,7 @@ persistence, and manageability.</p>
 <tr><td><a href="http://qpid.apache.org/components/protocol-engine/index.html">AMQP Protocol Engine</a></td><td>C, Java, Perl, PHP, Python, Ruby</td><td>Linux, OS X, JVM</td><td>1.0</td></tr>
 <tr><td><a href="http://qpid.apache.org/components/cpp-broker/index.html">C++ broker</a></td><td>C++</td><td>Linux, Windows</td><td>1.0, 0-10</td></tr>
 <tr><td><a href="http://qpid.apache.org/components/cpp-broker-tools/index.html">C++ broker command-line tools</a></td><td>-</td><td>Linux</td><td>0-10</td></tr>
-<tr><td><a href="dispatch/index.html">Dispatch router</a></td><td>C</td><td>Linux</td><td>1.0</td></tr>
+<tr><td><a href="http://qpid.apache.org/components/dispatch-router/index.html">Dispatch router</a></td><td>C</td><td>Linux</td><td>1.0</td></tr>
 <tr><td><a href="http://qpid.apache.org/components/java-broker/index.html">Java broker</a></td><td>Java</td><td>JVM</td><td>1.0, 0-10, 0-91, 0-9, 0-8</td></tr>
 <tr><td><a href="http://qpid.apache.org/components/qpid-jca/index.html">Qpid JCA</a></td><td>Java</td><td>JVM</td><td>0-10</td></tr>
 <tr><td><a href="http://qpid.apache.org/components/qpid-jms/index.html">Qpid JMS</a></td><td>Java</td><td>JVM</td><td>1.0, 0-10, 0-91, 0-9, 0-8</td></tr>

Modified: qpid/site/docs/documentation.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/documentation.html?rev=1505967&r1=1505966&r2=1505967&view=diff
==============================================================================
--- qpid/site/docs/documentation.html (original)
+++ qpid/site/docs/documentation.html Tue Jul 23 11:02:08 2013
@@ -151,8 +151,8 @@ find older versions with our
 <h3 id="dispatch-router">Dispatch router</h3>
 
 <ul>
-<li><a href="http://qpid.apache.org/components/dispatch/index.html">Overview</a></li>
-<li><a href="http://qpid.apache.org/components/dispatch/addressing.html">Addressing</a></li>
+<li><a href="http://qpid.apache.org/components/dispatch-router/index.html">Overview</a></li>
+<li><a href="http://qpid.apache.org/components/dispatch-router/addressing.html">Addressing</a></li>
 </ul>
 
 <h3 id="java-broker">Java broker</h3>

Modified: qpid/site/input/.htaccess
URL: http://svn.apache.org/viewvc/qpid/site/input/.htaccess?rev=1505967&r1=1505966&r2=1505967&view=diff
==============================================================================
--- qpid/site/input/.htaccess (original)
+++ qpid/site/input/.htaccess Tue Jul 23 11:02:08 2013
@@ -45,6 +45,7 @@
 </IfModule>
 
 <IfModule mod_alias.c>
+  Redirect /components/dispatch/index.html http://qpid.apache.org/components/dispatch-router/index.html
   Redirect /download.cgi http://qpid.apache.org/download.html
   Redirect /licence.html http://www.apache.org/licenses/
 

Modified: qpid/site/input/components/index.md
URL: http://svn.apache.org/viewvc/qpid/site/input/components/index.md?rev=1505967&r1=1505966&r2=1505967&view=diff
==============================================================================
--- qpid/site/input/components/index.md (original)
+++ qpid/site/input/components/index.md Tue Jul 23 11:02:08 2013
@@ -42,7 +42,7 @@ persistence, and manageability.
 
  - [C++ broker](cpp-broker/index.html) - A native-code AMQP message broker
  - [C++ broker command-line tools](cpp-broker-tools/index.html) - Manage the C++ broker
- - [Dispatch router](dispatch/index.html) - An AMQP router for scalable messaging interconnect
+ - [Dispatch router](dispatch-router/index.html) - An AMQP router for scalable messaging interconnect
  - [Java broker](java-broker/index.html) - A pure-Java AMQP message broker
  - [QMF](qmf/index.html) - Management built on Qpid messaging
  
@@ -53,7 +53,7 @@ persistence, and manageability.
   || [AMQP Protocol Engine](@site-url@/components/protocol-engine/index.html) || C, Java, Perl, PHP, Python, Ruby || Linux, OS X, JVM || 1.0 ||
   || [C++ broker](@site-url@/components/cpp-broker/index.html) || C++ || Linux, Windows || 1.0, 0-10 ||
   || [C++ broker command-line tools](@site-url@/components/cpp-broker-tools/index.html) || - || Linux || 0-10 ||
-  || [Dispatch router](dispatch/index.html) || C || Linux || 1.0 ||
+  || [Dispatch router](@site-url@/components/dispatch-router/index.html) || C || Linux || 1.0 ||
   || [Java broker](@site-url@/components/java-broker/index.html) || Java || JVM || 1.0, 0-10, 0-91, 0-9, 0-8 ||
   || [Qpid JCA](@site-url@/components/qpid-jca/index.html) || Java || JVM || 0-10 ||
   || [Qpid JMS](@site-url@/components/qpid-jms/index.html) || Java || JVM || 1.0, 0-10, 0-91, 0-9, 0-8 ||

Modified: qpid/site/input/documentation.md
URL: http://svn.apache.org/viewvc/qpid/site/input/documentation.md?rev=1505967&r1=1505966&r2=1505967&view=diff
==============================================================================
--- qpid/site/input/documentation.md (original)
+++ qpid/site/input/documentation.md Tue Jul 23 11:02:08 2013
@@ -85,8 +85,8 @@ find older versions with our
 
 ### Dispatch router
 
- - [Overview](@site-url@/components/dispatch/index.html)
- - [Addressing](@site-url@/components/dispatch/addressing.html)
+ - [Overview](@site-url@/components/dispatch-router/index.html)
+ - [Addressing](@site-url@/components/dispatch-router/addressing.html)
 
 ### Java broker
 



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