Author: tross
Date: Fri Jan 17 20:21:58 2014
New Revision: 1559243
URL: http://svn.apache.org/r1559243
Log:
NO-JIRA - Cleanup of the dispatch release site. Fixed a broken link.
Added:
qpid/site/docs/releases/qpid-dispatch-0.1/index.html
qpid/site/docs/releases/qpid-dispatch-0.1/notes.html
qpid/site/input/releases/qpid-dispatch-0.1/index.md
qpid/site/input/releases/qpid-dispatch-0.1/notes.md
- copied unchanged from r1559227,
qpid/site/input/releases/qpid-dispatch-0.1/release-0.1.md
Removed:
qpid/site/docs/releases/qpid-dispatch-0.1/release-0.1.html
qpid/site/input/releases/qpid-dispatch-0.1/release-0.1.md
Modified:
qpid/site/docs/components/dispatch-router/index.html
qpid/site/input/components/dispatch-router/index.md
Modified: qpid/site/docs/components/dispatch-router/index.html
URL:
http://svn.apache.org/viewvc/qpid/site/docs/components/dispatch-router/index.html?rev=1559243&r1=1559242&r2=1559243&view=diff
==============================================================================
--- qpid/site/docs/components/dispatch-router/index.html (original)
+++ qpid/site/docs/components/dispatch-router/index.html Fri Jan 17 20:21:58
2014
@@ -117,7 +117,7 @@ involving a broker at all.</p>
<div class="two-column">
<ul>
-<li><a
href="http://qpid.apache.org/releases/qpid-dispatch-0.1/release-0.1.html";>Initial
Release Overview</a></li>
+<li><a
href="http://qpid.apache.org/releases/qpid-dispatch-0.1/notes.html";>Initial
Release Overview</a></li>
<li><a
href="http://qpid.apache.org/releases/qpid-dispatch-0.1/amqp-mapping.html";>Usage
of AMQP</a></li>
</ul>
Added: qpid/site/docs/releases/qpid-dispatch-0.1/index.html
URL:
http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-dispatch-0.1/index.html?rev=1559243&view=auto
==============================================================================
--- qpid/site/docs/releases/qpid-dispatch-0.1/index.html (added)
+++ qpid/site/docs/releases/qpid-dispatch-0.1/index.html Fri Jan 17 20:21:58
2014
@@ -0,0 +1,122 @@
+<!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>Qpid Dispatch Router 0.1 - Apache Qpid™</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>™</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/releases/index.html";>Releases</a></li><li>Qpid
Dispatch Router 0.1</li></ul>
+ <script type="text/javascript">
+_addEventListener(window, "load", function() {
+ if ("0.1" === "0.1") {
+ _modifyCurrentReleaseLinks();
+ }
+});
+</script>
+
+<h1 id="qpid-dispatch-router-01">Qpid Dispatch Router 0.1</h1>
+
+<p>Dispatch Router is a lightweight AMQP message router library. More
+about <a
href="http://qpid.apache.org/components/dispatch-router/index.html";>Qpid
Dispatch</a>.</p>
+
+<p>For a detailed list of the changes in this release, see the <a
href="notes.html">release
+notes</a>.</p>
+
+<h2 id="downloads">Downloads</h2>
+
+<p>It's important to <a
href="http://qpid.apache.org/download.html#verify-what-you-download";>verify the
+integrity</a> of the
+files you download.</p>
+
+<table>
+<tbody>
+<tr><td><em>Content</em></td><td><em>Download</em></td><td><em>Signature</em></td></tr>
+<tr><td>Dispatch Router</td><td><a
href="http://www.apache.org/dist/qpid/dispatch/0.1/qpid-dispatch-0.6.tar.gz";>qpid-dispatch-0.1.tar.gz</a></td><td><a
href="http://www.apache.org/dist/qpid/dispatch/0.1/qpid-dispatch-0.1.tar.gz.asc";>PGP</a></td></tr>
+</tbody>
+</table>
+
+<h2 id="documentation">Documentation</h2>
+
+<div class="two-column">
+
+<ul>
+<li><a
href="http://qpid.apache.org/releases/qpid-dispatch-0.1/notes.html";>Initial
Release Overview</a></li>
+<li><a
href="http://qpid.apache.org/releases/qpid-dispatch-0.1/amqp-mapping.html";>Usage
of AMQP</a></li>
+</ul>
+
+</div>
+
+<h2 id="more-information">More information</h2>
+
+<ul>
+<li><a href="http://www.apache.org/dist/qpid/dispatch/0.1";>All release
artifacts</a></li>
+<li><a
href="http://svn.apache.org/repos/asf/qpid/dispatch/branches/0.1";>Source
repository branch</a></li>
+<li><a href="http://svn.apache.org/repos/asf/qpid/dispatch/tags/0.1";>Source
repository tag</a></li>
+</ul>
+
+ </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 © 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/releases/qpid-dispatch-0.1/notes.html
URL:
http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-dispatch-0.1/notes.html?rev=1559243&view=auto
==============================================================================
--- qpid/site/docs/releases/qpid-dispatch-0.1/notes.html (added)
+++ qpid/site/docs/releases/qpid-dispatch-0.1/notes.html Fri Jan 17 20:21:58
2014
@@ -0,0 +1,393 @@
+<!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>Qpid Dispatch Release 0.1 - Apache Qpid™</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>™</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/releases/index.html";>Releases</a></li><li><a
href="http://qpid.apache.org/releases/qpid-dispatch-0.1/index.html";>Qpid
Dispatch Router 0.1</a></li><li>Qpid Dispatch Release 0.1</li></ul>
+ <h1 id="qpid-dispatch-release-01">Qpid Dispatch Release 0.1</h1>
+
+<h2 id="system-requirements-and-dependencies">System Requirements and
Dependencies</h2>
+
+<ul>
+<li>Qpid Dispatch will only build and run on Posix-based operating systems
(Linux, et. al.)</li>
+<li>Qpid Proton version 0.6 must be installed (including the Python bindings)
to build Qpid Dispatch</li>
+</ul>
+
+<h2 id="documented-capabilities-available-in-version-01">Documented
capabilities available in version 0.1</h2>
+
+<p>Some of the capabilities listed in these pages for Dispatch are for future
releases and are supplied for the purpose of illustrating the potential of a
message router. This section outlines the actual capabilities of version
0.1:</p>
+
+<ul>
+<li>Route computation uses a fixed constant cost for inter-router links.
Therefore, cost is only determined by the number of hops from source to
destination.</li>
+<li>Addressing semantics are constrained to multicast. If there are multiple
consumers for a particular address, each consumer will receive a copy of every
message produced to that address.</li>
+<li>Link-Routing is not supported in 0.1. All routing is message-based.</li>
+<li>Broker integration is not yet implemented.</li>
+</ul>
+
+<h2 id="building-testing-and-installing">Building, Testing, and Installing</h2>
+
+<p>Download and extract the source tar file: <a
href="http://www.apache.org/dyn/closer.cgi/qpid/dispatch/0.1/qpid-dispatch-0.1.tar.gz";>qpid-dispatch-0.1.tar.gz</a>
[<a
href="http://www.apache.org/dist/qpid/dispatch/0.1/qpid-dispatch-0.1.tar.gz.asc";>PGP</a>]</p>
+
+<pre><code>$ tar -xzf qpid-dispatch-0.1.tar.gz
+</code></pre>
+
+<p>Source the build configuration:</p>
+
+<pre><code>$ cd qpid-dispatch-0.1
+$ source config.sh
+</code></pre>
+
+<p>Build and test the package. This will create two directories: 'build' and
'install'. Dispatch will be built in the 'build' directory
+and installed in the 'install' directory. The regression and system test
suites will then be run against the installed bits.</p>
+
+<pre><code>$ bin/test.sh
+</code></pre>
+
+<p>If you wish to change the build configuration, go into the build directory,
use cmake to configure your build then rebuild and/or reinstall from there:</p>
+
+<pre><code>$ cd build
+$ cmake ..
+$ make
+$ make install
+</code></pre>
+
+<h2 id="configuration">Configuration</h2>
+
+<p>The default configuration file is installed in
+<em>install-prefix</em>/etc/qpid/qdrouterd.conf. This configuration file will
cause the router
+to run in standalone mode, listening on the standard AMQP port (5672).
Dispatch Router
+looks for the configuration file in the installed location by default. If you
wish
+to use a different path, the "-c" command line option will instruct Dispatch
Router as to
+which configuration to load.</p>
+
+<p>To run the router, invoke the executable:</p>
+
+<pre><code>$ qdrouterd
+</code></pre>
+
+<h2 id="client-compatibility">Client Compatibility</h2>
+
+<p>Dispatch Router should, in theory, work with any client that is compatible
with AMQP 1.0.
+The following clients have been tested:</p>
+
+<table>
+<tbody>
+<tr><td><em>Client</em></td><td><em>Notes</em></td></tr>
+<tr><td>qpid::messaging</td><td>The Qpid messaging clients work with Dispatch
Router as long as they are configured to use the 1.0 version of the protocol.
To enable AMQP 1.0 in the C++ client, use the {protocol:amqp1.0} connection
option.</td></tr>
+<tr><td>Proton Messenger</td><td>Messenger works with Dispatch
Router.</td></tr>
+</tbody>
+</table>
+
+<h2 id="tools">Tools</h2>
+
+<p>Installed with the Dispatch Router kit is a command line tool called
<em>qdstat</em>. This tool
+can be used to view manageable data inside Dispatch Router. The following
options are
+useful for seeing that the router is doing:</p>
+
+<table>
+<tbody>
+<tr><td><em>Option</em></td><td><em>Description</em></td></tr>
+<tr><td>-l</td><td>Print a list of AMQP links attached to the router. Links
are unidirectional. Outgoing links are usually associated with a subscription
address. The tool distinguishes between <em>endpoint</em> links and
<em>router</em> links. Endpoint links are attached to clients using the
router. Router links are attached to other routers in a network of
routers.</td></tr>
+<tr><td>-a</td><td>Print a list of addresses known to the router.</td></tr>
+<tr><td>-n</td><td>Print a list of known routers in the network.</td></tr>
+<tr><td>-c</td><td>Print a list of connections to the router.</td></tr>
+</tbody>
+</table>
+
+<h2 id="features-and-examples">Features and Examples</h2>
+
+<h3 id="standalone-and-interior-modes">Standalone and Interior Modes</h3>
+
+<p>The router can operate stand-alone or as a node in a network of routers.
The mode is
+configured in the <em>router</em> section of the configuration file. In
stand-alone mode, the
+router does not attempt to collaborate with any other routers and only routes
messages
+among directly connected endpoints.</p>
+
+<p>If your router is running in stand-alone mode, <em>qdstat -a</em> will look
like the following:</p>
+
+<pre><code>$ qdstat -a
+Router Addresses
+ class address in-proc local remote in out thru to-proc from-proc
+
===============================================================================
+ local $management Y 0 0 1 0 0 1 0
+ local temp.AY81ga 1 0 0 0 0 0 0
+</code></pre>
+
+<p>Note that there are two known addresses. <em>$management</em> is the
address of the router's embedded management agent. <em>temp.AY81ga</em> is the
temporary reply-to address of the <em>qdstat</em> client making requests to the
agent.</p>
+
+<p>If you change the mode to interior and restart the processs, the same
command will yield two additional addresses which are used for inter-router
communication:</p>
+
+<pre><code>$ qdstat -a
+Router Addresses
+ class address in-proc local remote in out thru to-proc from-proc
+
===============================================================================
+ local $management Y 0 0 1 0 0 1 0
+ local qdhello Y 0 0 0 0 0 0 3
+ local qdrouter Y 0 0 0 0 0 0 1
+ local temp.khOpGb 1 0 0 0 0 0 0
+</code></pre>
+
+<h3 id="mobile-subscribers">Mobile Subscribers</h3>
+
+<p>The term "mobile subscriber" simply refers to the fact that a client may
connect to the
+router and subscribe to an address to receive messages sent to that address.
No matter
+where in the network the subscriber attaches, the messages will be routed to
the
+appropriate destination.</p>
+
+<p>To illustrate a subscription on a stand-alone router, you can use the
examples that are
+provided with Qpid Proton. Using the <em>recv.py</em> example receiver:</p>
+
+<pre><code>$ recv.py amqp://0.0.0.0/my-address
+</code></pre>
+
+<p>This command creates a receiving link subscribed to the specified address.
To verify the
+subscription:</p>
+
+<pre><code>$ qdstat -a
+Router Addresses
+ class address in-proc local remote in out thru to-proc
from-proc
+
================================================================================
+ local $management Y 0 0 1 0 0 1 0
+ mobile my-address 1 0 0 0 0 0 0
+ local temp.fDt8_a 1 0 0 0 0 0 0
+</code></pre>
+
+<p>You can then, in a separate command window, run a sender to produce
messages to that
+address:</p>
+
+<pre><code>$ send.py -a amqp://0.0.0.0/my-address
+</code></pre>
+
+<h3 id="dynamic-reply-to">Dynamic Reply-To</h3>
+
+<p>Dynamic reply-to can be used to obtain a reply-to address that routes back
to a client's
+receiving link regardless of how many hops it has to take to get there. To
illustrate
+this feature, see below a simple program (written in C++ against the
qpid::messaging API)
+that queries the management agent of the attached router for a list of other
known
+routers' management addresses.</p>
+
+<pre><code>#include <qpid/messaging/Address.h>
+#include <qpid/messaging/Connection.h>
+#include <qpid/messaging/Message.h>
+#include <qpid/messaging/Receiver.h>
+#include <qpid/messaging/Sender.h>
+#include <qpid/messaging/Session.h>
+
+using namespace qpid::messaging;
+using namespace qpid::types;
+
+using std::stringstream;
+using std::string;
+
+int main() {
+ const char* url = "amqp:tcp:127.0.0.1:5672";
+ std::string connectionOptions = "{protocol:amqp1.0}";
+
+ Connection connection(url, connectionOptions);
+ connection.open();
+ Session session = connection.createSession();
+ Sender sender = session.createSender("mgmt");
+
+ // create reply receiver and get the reply-to address
+ Receiver receiver = session.createReceiver("#");
+ Address responseAddress = receiver.getAddress();
+
+ Message request;
+ request.setReplyTo(responseAddress);
+ request.setProperty("x-amqp-to", "amqp:/_local/$management");
+ request.setProperty("operation", "DISCOVER-MGMT-NODES");
+ request.setProperty("type", "org.amqp.management");
+ request.setProperty("name, "self");
+
+ sender.send(request);
+ Message response = receiver.fetch();
+ Variant content(response.getContentObject());
+ std::cout << "Response: " << content << std::endl
<< std::endl;
+
+ connection.close();
+}
+</code></pre>
+
+<p>The equivalent program written in Python against the Proton Messenger
API:</p>
+
+<pre><code>from proton import Messenger, Message
+
+def main():
+ host = "0.0.0.0:5672"
+
+ messenger = Messenger()
+ messenger.start()
+ messenger.route("amqp:/*", "amqp://%s/$1" % host)
+ reply_subscription = messenger.subscribe("amqp:/#")
+ reply_address = reply_subscription.address
+
+ request = Message()
+ response = Message()
+
+ request.address = "amqp:/_local/$management"
+ request.reply_to = reply_address
+ request.properties = {u'operation' : u'DISCOVER-MGMT-NODES',
+ u'type' : u'org.amqp.management',
+ u'name' : u'self'}
+
+ messenger.put(request)
+ messenger.send()
+ messenger.recv()
+ messenger.get(response)
+
+ print "Response: %r" % response.body
+
+ messenger.stop()
+
+main()
+</code></pre>
+
+<h2 id="known-issues-and-limitations">Known Issues and Limitations</h2>
+
+<p>This is an early test release. It is expected that users will find bugs
and other
+various instabilities. The main goal of this release is to prove that the
process can be
+run and that users can demonstrate basic functionality as described in this
document.
+Nevertheless, the following are known issues with the 0.1 release:</p>
+
+<ul>
+<li>Subscriber addresses are not always cleaned up after a consumer
disconnects. See
+<a
href="https://issues.apache.org/jira/browse/QPID-4964";>https://issues.apache.org/jira/browse/QPID-4964</a>.</li>
+<li>Dispatch Router does not currently use the target address of a client's
sender link to
+route messages. It only looks at the "to" field in the message's headers. See
+<a
href="https://issues.apache.org/jira/browse/QPID-5175";>https://issues.apache.org/jira/browse/QPID-5175</a>.</li>
+<li>All subscription sources are treated as multicast addresses. There is
currently no
+facility for provisioning different types of addresses. Multicast means that
if there
+are multiple subscribers to the same address, they will all receive a copy of
each
+message sent to that address.</li>
+<li>SSL connectors and listeners are supported but very lightly (and not
recently) tested.</li>
+<li>SASL authentication is not currently integrated into any authentication
framework. Use
+ANONYMOUS for testing.</li>
+</ul>
+
+<h2 id="issues-addressed-in-this-release">Issues Addressed in this Release</h2>
+
+<ul>
+<li><a href="https://issues.apache.org/jira/browse/QPID-4612";>QPID-4612</a>
Dispatch - Change server and container pattern to be consistent with other
objects</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-4613";>QPID-4613</a>
Dispatch Message API Improvements</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-4614";>QPID-4614</a>
CTEST for Dispatch</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-4788";>QPID-4788</a>
Dispatch - Re-schedule of an "immediate" timer causes crash</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-4816";>QPID-4816</a>
dispatch-router crashes when incomplete (but valid) url specified by
client.</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-4853";>QPID-4853</a>
Connectors are not closed when connections are closed cleanly</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-4913";>QPID-4913</a>
Dispatch - Add a configuration file reader to configure the service</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-4963";>QPID-4963</a>
Dispatch - Excessive latency in timers under light load</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-4967";>QPID-4967</a>
Dispatch - Distributed routing protocol to compute paths across a network of
routers</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-4968";>QPID-4968</a>
Dispatch - Generalized framework for embedded Python modules</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-4974";>QPID-4974</a>
Dispatch - Improve the API for parsing and composing AMQP-typed fields</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-4997";>QPID-4997</a>
Dispatch - Thread safety issues in the usage of Proton</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5001";>QPID-5001</a>
Dispatch - A web page on the site for the Dispatch Router component</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5045";>QPID-5045</a>
Dispatch - Refactor the router data structures to allow both message-based and
link-based routing that supports full link protocol</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5064";>QPID-5064</a>
Dispatch - make-install doesn't install the Python artifacts</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5066";>QPID-5066</a>
Dispatch - move Python code into the qpid.dispatch package</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5068";>QPID-5068</a>
Dispatch - Internal feature to easily add and update Delivery Annotations</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5096";>QPID-5096</a>
Dispatch - Install the configuration file</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5097";>QPID-5097</a>
Dispatch - create a source tarball</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5173";>QPID-5173</a>
[dispatch] cmake ignores overrides to CMAKE<em>INCLUDE</em>PATH and
CMAKE<em>LIBRARY</em>PATH</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5181";>QPID-5181</a>
Dispatch - Assign temporary source addresses for dynamic listener links</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5185";>QPID-5185</a>
Move the qpid-dispatch.conf file to /etc/qpid</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5186";>QPID-5186</a>
Installing Dispatch should also install the LICENSE, TODO and related files</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5189";>QPID-5189</a>
Add a config.sh file for Qpid Dispatch to set an environment for running the
router</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5201";>QPID-5201</a>
Dispatch - Fix build errors in Release mode</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5212";>QPID-5212</a>
Dispatch - Add management access to data in the router module</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5213";>QPID-5213</a>
Dispatch - Add a CLI tool to display manageable data in Dispatch</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5216";>QPID-5216</a>
Dispatch - Stabilization in anticipation of an early release</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5217";>QPID-5217</a>
Dispatch - Cleanup of API inconsistencies and oddities</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5218";>QPID-5218</a>
[dispatch] Crash when outgoing window > 0 and multiple subscribed Messenger
clients</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5220";>QPID-5220</a>
Dispatch - Define Modes of Operation for the router function</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5221";>QPID-5221</a>
Dispatch - Configured connections can be annotated as to their role</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5257";>QPID-5257</a>
Dispatch - Move the code from trunk/qpid/extras to dispatch</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5258";>QPID-5258</a>
Dispatch - Prepare for Release 0.1</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5267";>QPID-5267</a>
Examples aren't being installed</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5310";>QPID-5310</a>
copy the correlationID into management replies</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5313";>QPID-5313</a>
qpid-dxrouterd binary should install the /usr/sbin on *nix</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5319";>QPID-5319</a>
Add ability to get list of connections through server management agent</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5335";>QPID-5335</a>
Dispatch Python libraries need to install to a private directory.</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5338";>QPID-5338</a>
The Dispatch top-level Python package should be renamed</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5339";>QPID-5339</a>
Dispatch - Intermittent crashes during scripted six-node tests</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5343";>QPID-5343</a>
Dispatch does not properly handle the drain protocol on senders.</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5350";>QPID-5350</a>
Dispatch - Management queries that receive empty tables results in corrupt
response</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5351";>QPID-5351</a>
Settle on one prefix for Dispatch names</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5352";>QPID-5352</a>
Installation of python code ignores prefix</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5365";>QPID-5365</a>
Clean up file locations in Dispatch</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5367";>QPID-5367</a>
Dispatch - Add man pages and stubs for other documentation</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5380";>QPID-5380</a>
Dispatch - Simplify use of non-system instances</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5381";>QPID-5381</a>
Dispatch - Use dynamic source address for the reply-to in qdstat tool</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5392";>QPID-5392</a>
Dispatch - Remove ChangeLog; use jira and our website release pages instead</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5393";>QPID-5393</a>
Dispatch - Allow qdstat to query any router in the network from a
connection</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5397";>QPID-5397</a>
Dispatch - Crash occurs when linked deliveries are concurrently settled</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5403";>QPID-5403</a>
Dispatch - The router-specific annotations have reserved keys</li>
+<li><a href="https://issues.apache.org/jira/browse/QPID-5448";>QPID-5448</a>
qdstat does not have the correct Python path for the internal libraries</li>
+</ul>
+
+ </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 © 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/input/components/dispatch-router/index.md
URL:
http://svn.apache.org/viewvc/qpid/site/input/components/dispatch-router/index.md?rev=1559243&r1=1559242&r2=1559243&view=diff
==============================================================================
--- qpid/site/input/components/dispatch-router/index.md (original)
+++ qpid/site/input/components/dispatch-router/index.md Fri Jan 17 20:21:58 2014
@@ -74,7 +74,7 @@ involving a broker at all.
<div class="two-column" markdown="1">
- - [Initial Release Overview](@current-dispatch-release-url@/release-0.1.html)
+ - [Initial Release Overview](@current-dispatch-release-url@/notes.html)
- [Usage of AMQP](@current-dispatch-release-url@/amqp-mapping.html)
</div>
Added: qpid/site/input/releases/qpid-dispatch-0.1/index.md
URL:
http://svn.apache.org/viewvc/qpid/site/input/releases/qpid-dispatch-0.1/index.md?rev=1559243&view=auto
==============================================================================
--- qpid/site/input/releases/qpid-dispatch-0.1/index.md (added)
+++ qpid/site/input/releases/qpid-dispatch-0.1/index.md Fri Jan 17 20:21:58 2014
@@ -0,0 +1,59 @@
+;;
+;; 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.
+;;
+
+<script type="text/javascript">
+_addEventListener(window, "load", function() {
+ if ("0.1" === "@current-dispatch-release@") {
+ _modifyCurrentReleaseLinks();
+ }
+});
+</script>
+
+# Qpid Dispatch Router 0.1
+
+Dispatch Router is a lightweight AMQP message router library. More
+about [Qpid Dispatch](@site-url@/components/dispatch-router/index.html).
+
+For a detailed list of the changes in this release, see the [release
+notes](notes.html).
+
+## Downloads
+
+It's important to [verify the
+integrity](@site-url@/download.html#verify-what-you-download) of the
+files you download.
+
+ || *Content* || *Download* || *Signature* ||
+ || Dispatch Router ||
[qpid-dispatch-0.1.tar.gz](http://www.apache.org/dist/qpid/dispatch/0.1/qpid-dispatch-0.6.tar.gz)
||
[PGP](http://www.apache.org/dist/qpid/dispatch/0.1/qpid-dispatch-0.1.tar.gz.asc)
||
+
+## Documentation
+
+<div class="two-column" markdown="1">
+
+ - [Initial Release Overview](@current-dispatch-release-url@/notes.html)
+ - [Usage of AMQP](@current-dispatch-release-url@/amqp-mapping.html)
+
+</div>
+
+## More information
+
+ - [All release artifacts](http://www.apache.org/dist/qpid/dispatch/0.1)
+;; - [Resolved issues in
JIRA](https://issues.apache.org/jira/issues/?jql=project+%3D+PROTON+AND+fixVersion+%3D+%270.6%27+ORDER+BY+priority+DESC)
+ - [Source repository
branch](http://svn.apache.org/repos/asf/qpid/dispatch/branches/0.1)
+ - [Source repository
tag](http://svn.apache.org/repos/asf/qpid/dispatch/tags/0.1)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
