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: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to