diff options
| author | Aidan Skinner <aidan@apache.org> | 2008-06-02 18:14:24 +0000 |
|---|---|---|
| committer | Aidan Skinner <aidan@apache.org> | 2008-06-02 18:14:24 +0000 |
| commit | 967ae29ecf55e700a1a30856025fb65fbcbc9ff5 (patch) | |
| tree | 28fb0d4c125c005008d368d80e49caecc0351b19 | |
| parent | 88f4f04b32cf1024a9ce84db54a986950c1e7499 (diff) | |
| download | qpid-python-967ae29ecf55e700a1a30856025fb65fbcbc9ff5.tar.gz | |
Remove stuff thats been moved
git-svn-id: https://svn.apache.org/repos/asf/incubator/qpid/branches/forrest-site@662506 13f79535-47bb-0310-9956-ffa450edef68
233 files changed, 0 insertions, 21594 deletions
diff --git a/classes/CatalogManager.properties b/classes/CatalogManager.properties deleted file mode 100755 index b3819241c9..0000000000 --- a/classes/CatalogManager.properties +++ /dev/null @@ -1,62 +0,0 @@ -# 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. - -#======================================================================= -# CatalogManager.properties for Catalog Entity Resolver. -# -# This is the default properties file for your project. -# This facilitates local configuration of application-specific catalogs. -# If you have defined any local catalogs, then they will be loaded -# before Forrest's core catalogs. -# -# See the Apache Forrest documentation: -# http://forrest.apache.org/docs/your-project.html -# http://forrest.apache.org/docs/validation.html - -# verbosity: -# The level of messages for status/debug (messages go to standard output). -# The setting here is for your own local catalogs. -# The verbosity of Forrest's core catalogs is controlled via -# main/webapp/WEB-INF/cocoon.xconf -# -# The following messages are provided ... -# 0 = none -# 1 = ? (... not sure yet) -# 2 = 1+, Loading catalog, Resolved public, Resolved system -# 3 = 2+, Catalog does not exist, resolvePublic, resolveSystem -# 10 = 3+, List all catalog entries when loading a catalog -# (Cocoon also logs the "Resolved public" messages.) -verbosity=1 - -# catalogs ... list of additional catalogs to load -# (Note that Apache Forrest will automatically load its own default catalog -# from main/webapp/resources/schema/catalog.xcat) -# Use either full pathnames or relative pathnames. -# pathname separator is always semi-colon (;) regardless of operating system -# directory separator is always slash (/) regardless of operating system -# The project catalog is expected to be at ../resources/schema/catalog.xcat -#catalogs=../resources/schema/catalog.xcat -# FIXME: Workaround FOR-548 "project DTD catalogs are not included -# when running as a servlet WAR". -# Same catalog, different path -catalogs=../resources/schema/catalog.xcat;../../project/src/documentation/resources/schema/catalog.xcat - -# relative-catalogs -# If false, relative catalog URIs are made absolute with respect to the -# base URI of the CatalogManager.properties file. This setting only -# applies to catalog URIs obtained from the catalogs property in the -# CatalogManager.properties file -# Example: relative-catalogs=[yes|no] -relative-catalogs=no diff --git a/content/locationmap.xml b/content/locationmap.xml deleted file mode 100755 index 8ac59a9dd6..0000000000 --- a/content/locationmap.xml +++ /dev/null @@ -1,72 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!-- - 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. ---> -<locationmap xmlns="http://apache.org/forrest/locationmap/1.0"> - <components> - <matchers default="lm"> - <matcher name="lm" src="org.apache.forrest.locationmap.WildcardLocationMapHintMatcher"/> - </matchers> -<!-- - * Can contain any sitemap selector with the following syntax. * - <selectors default="exists"> - <selector name="exists" logger="sitemap.selector.exists" - src="org.apache.forrest.sourceexists.SourceExistsSelector" /> - </selectors> - --> - </components> -<!-- - * Can contain a mount statement as a sibling to components and locator * - <mount src="somelocation.xml"/> - --> - <locator> -<!-- - * Can contain a mount within a selector where a selector is valid. - <select> - <mount src="somelocation.xml"/> - </select> - --> - <match pattern="project.rewrite.**"> - <location src="http://cocoon.apache.org/{1}.html"/> - </match> - <match pattern="project.remote.**.xml"> - <location src="http://svn.apache.org/repos/asf/forrest/trunk/main/fresh-site/src/documentation/content/xdocs/{1}.xml"/> - </match> -<!-- - * Can use a selector inside a match. * - <match pattern="somepattern/**"> - <select> - <location src="first-location-attempted"/> - <location src="second-location-attempted"/> - <location src="third-location-attepted"/> - </select> - </match> - --> -<!-- - To locate all your source documents in a slide repository you can do: - - <match pattern="tabs.xml"> - <location src="http://127.0.0.1:8080/slide/files/tabs.xml"/> - </match> - <match pattern="site.xml"> - <location src="http://127.0.0.1:8080/slide/files/site.xml"/> - </match> - <match pattern="**.xml"> - <location src="http://127.0.0.1:8080/slide/files/{1}.xml"/> - </match> - --> - </locator> -</locationmap> diff --git a/content/xdocs/0.10 Connection URL Format.html b/content/xdocs/0.10 Connection URL Format.html deleted file mode 100755 index 7f2e04ba81..0000000000 --- a/content/xdocs/0.10 Connection URL Format.html +++ /dev/null @@ -1,107 +0,0 @@ -<html> - <head> - <title>Apache Qpid : 0.10 Connection URL Format</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : 0.10 Connection URL Format - </span> - </div> - <div class="pagesubheading"> - This page last changed on Jan 30, 2008 by <font color="#0050B2">asimon</font>. - </div> - - <div class="preformatted"><div class="preformattedContent"> -<pre>qpid:[<property>=<value>[;<property>=<value>]]@<transport>:<host>[:<port>]
-</pre> -</div></div> - -<h4><a name="0.10ConnectionURLFormat-Currentlyhandledproperties"></a>Currently handled properties</h4> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'>Option</th> -<th class='confluenceTh'>Default</th> -<th class='confluenceTh'>Description</th> -</tr> -<tr> -<td class='confluenceTd'>virtualhost</td> -<td class='confluenceTd'>""</td> -<td class='confluenceTd'>Set the virtual host to be used (this is currently not supported by the 0.10 c++ broker</td> -</tr> -<tr> -<td class='confluenceTd'>username</td> -<td class='confluenceTd'>guest</td> -<td class='confluenceTd'>The user name for the client.</td> -</tr> -<tr> -<td class='confluenceTd'>password</td> -<td class='confluenceTd'>guest</td> -<td class='confluenceTd'>The password used for creating a connection.</td> -</tr> -<tr> -<td class='confluenceTd'>client_id</td> -<td class='confluenceTd'>auto-generated</td> -<td class='confluenceTd'>The client identifier used for creating a connection.</td> -</tr> -</tbody></table> - -<h4><a name="0.10ConnectionURLFormat-Currentlyhandledtransports"></a>Currently handled transports</h4> - -<p>Currently only 'tcp' transport is supported. 'tls' will however be supported and additional properties like 'keystore' and 'keystorelocation' will be added. The 'vm' transport should also be supported when a 0.10 Java broker will be available. </p> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'>Option</th> -<th class='confluenceTh'>Default</th> -<th class='confluenceTh'>Description</th> -</tr> -<tr> -<td class='confluenceTd'>tcp</td> -<td class='confluenceTd'>true</td> -<td class='confluenceTd'>Use a TCP connection</td> -</tr> -<tr> -<td class='confluenceTd'>tls</td> -<td class='confluenceTd'>false</td> -<td class='confluenceTd'>Use a tls connection</td> -</tr> -</tbody></table> - -<h4><a name="0.10ConnectionURLFormat-Hostport"></a>Host port</h4> - -<p>The default host port used is 5672 for 'tcp'. </p> - -<h4><a name="0.10ConnectionURLFormat-Failover"></a>Failover </h4> - -<p>It is planned to introduce a failover property for controlling how failover occurs when presented with a list of brokers. This is however not yet supported. </p> - -<h3><a name="0.10ConnectionURLFormat-SampleURLs"></a>Sample URLs </h3> -<div class="preformatted"><div class="preformattedContent"> -<pre>qpid:@tcp:myHost
-qpid:client_id=myClientIDpassword=myPassword;username=myUsername@tcp:myHost:5644
-</pre> -</div></div> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/3rd Party Libraries.html b/content/xdocs/3rd Party Libraries.html deleted file mode 100755 index f0fe46f2d2..0000000000 --- a/content/xdocs/3rd Party Libraries.html +++ /dev/null @@ -1,129 +0,0 @@ -<html> - <head> - <title>Apache Qpid : 3rd Party Libraries</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : 3rd Party Libraries - </span> - </div> - <div class="pagesubheading"> - This page last changed on Mar 10, 2008 by <font color="#0050B2">ritchiem</font>. - </div> - - <h1><a name="3rdPartyLibraries-QpidPersistenceOptions"></a>Qpid Persistence Options</h1> - -<p>There are currently two options for persistence in Qpid, as shown in the table below.</p> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'>Persistence Style</th> -<th class='confluenceTh'>Provider</th> -<th class='confluenceTh'>Advantages</th> -<th class='confluenceTh'>Disadvantages</th> -</tr> -<tr> -<td class='confluenceTd'>In-Memory</td> -<td class='confluenceTd'>Qpid MemoryMessageStore</td> -<td class='confluenceTd'>Comes as part of the Qpid package</td> -<td class='confluenceTd'>Not persistent</td> -</tr> -<tr> -<td class='confluenceTd'>Berkeley DB Store</td> -<td class='confluenceTd'>Berkeley project</td> -<td class='confluenceTd'>Allows persistence for larger messages/volumes</td> -<td class='confluenceTd'>Not Apache licensed</td> -</tr> -</tbody></table> - -<h2><a name="3rdPartyLibraries-UsingInMemoryPersistence"></a>Using In-Memory Persistence</h2> - -<p>Using In-Memory persistence is the default when you install Qpid and requires no additional install/configuration.</p> - -<h2><a name="3rdPartyLibraries-UsingBerkeleyDBPersistence"></a>Using Berkeley DB Persistence</h2> - -<h3><a name="3rdPartyLibraries-InstallBerkeleyDB"></a>Install Berkeley DB</h3> - -<p>If you choose to use the Berkeley DB solution for scalability purposes then you should download & install version 3.1 from <a href="http://www.oracle.com/technology/software/products/berkeley-db/je/index.html" title="Visit page outside Confluence">http://www.oracle.com/technology/software/products/berkeley-db/je/index.html</a></p> - -<h3><a name="3rdPartyLibraries-AmendyourQpidconfigurationtoswitchBDBon"></a>Amend your Qpid configuration to switch BDB on</h3> - -<p>The default Qpid configuration file can be found in the etc directory of your install and is named config.xml. </p> - -<p>To use BDB, simply add the following element:</p> - -<div class="code"><div class="codeContent"> -<pre class="code-xml"><span class="code-tag"><store></span>
- <span class="code-tag"><class></span>org.apache.qpid.server.store.berkeleydb.BDBMessageStore<span class="code-tag"></class></span>
-<span class="code-tag"></store></span></pre> -</div></div> - -<p>alternatively an example file is provided named persistent_config.xml</p> - -<h3><a name="3rdPartyLibraries-InstalltheQpidbridgemodulesforBerkeleyDB"></a>Install the Qpid bridge modules for Berkeley DB</h3> - -<p>You can either build the module from source which is available from the <a href="http://anonsvn.jboss.org/repos/rhmessaging/store/branches/java/" title="Visit page outside Confluence">JBoss Site</a>.</p> - -<p>However, as a temporary measure, you can use the bridging modules from this page <a href="http://cwiki.apache.org/confluence/download/attachments/29783/M1-bdbstore.jar?version=1" title="M1-bdbstore.jar attached to 3rd Party Libraries">M1-BDBStore</a> or <a href="http://cwiki.apache.org/confluence/download/attachments/29783/M2-bdbstore.jar?version=1" title="M2-bdbstore.jar attached to 3rd Party Libraries">M2-BDBStore</a>. You should then ensure that this jar is included in the classpath for the broker (see more info below), along with the BDB jar (je-<version>.jar).</p> - -<p>This can simply be done by editing the your classpath to add the two jars that you need and then pass an option into qpid-server to use your classpath.</p> - -<p>So, first set your classpath to something like this:</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre>CLASSPATH=$QPID_HOME/lib/qpid-incubating.jar:$QPID_HOME/lib/bdbstore.jar:$QPID_HOME/lib/je-<version>.jar
-</pre> -</div></div> - -<p>Then, run qpid-server passing the following additional flag:</p> -<div class="preformatted"><div class="preformattedContent"> -<pre>qpid-server -run:external-classpath=first
-</pre> -</div></div> - -<p>You can check the classpath being used by adding an additional option to output the classpath in use:</p> -<div class="preformatted"><div class="preformattedContent"> -<pre>qpid-server -run:external-classpath=first -run:print-classpath
-</pre> -</div></div> - -<p>alternatively you can edit the QPID_LIBS variable in the qpid-server script.</p> - -<p>We hope to be able to integrate these modules into our Apache project shortly - but pending a discussion about the appropriate way to handle this process.</p> - - - - <br/> - <div class="tabletitle"> - <a name="attachments">Attachments:</a> - </div> - - <div class="greybox" align="left"> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="3rd Party Libraries_attachments/M1-bdbstore.jar">M1-bdbstore.jar</a> (application/x-zip-compressed) - <br/> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="3rd Party Libraries_attachments/M2-bdbstore.jar">M2-bdbstore.jar</a> (application/octet-stream) - <br/> - </div> - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/3rd Party Libraries_attachments/M1-bdbstore.jar b/content/xdocs/3rd Party Libraries_attachments/M1-bdbstore.jar Binary files differdeleted file mode 100755 index 57f7b109e7..0000000000 --- a/content/xdocs/3rd Party Libraries_attachments/M1-bdbstore.jar +++ /dev/null diff --git a/content/xdocs/3rd Party Libraries_attachments/M2-bdbstore.jar b/content/xdocs/3rd Party Libraries_attachments/M2-bdbstore.jar Binary files differdeleted file mode 100755 index fa778a210e..0000000000 --- a/content/xdocs/3rd Party Libraries_attachments/M2-bdbstore.jar +++ /dev/null diff --git a/content/xdocs/AMQP0-9-DesignNotes.html b/content/xdocs/AMQP0-9-DesignNotes.html deleted file mode 100755 index f225d91848..0000000000 --- a/content/xdocs/AMQP0-9-DesignNotes.html +++ /dev/null @@ -1,69 +0,0 @@ -<html> - <head> - <title>Apache Qpid : AMQP0-9-DesignNotes</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : AMQP0-9-DesignNotes - </span> - </div> - <div class="pagesubheading"> - This page last changed on Jan 30, 2007 by <font color="#0050B2">kpvdr</font>. - </div> - - <h2><a name="AMQP0-9-DesignNotes-DesignnotesforAMQP09implemenation"></a>Design notes for AMQP 0-9 implemenation</h2> - -<ul> - <li>Reserved field in Request frame must be set to 0.</li> - <li>Request and Response constants were added to amqp.0-9.xml</li> - <li>Request ID and Response ID must start at 1 for new channels. 0 is reserved for future use, and should not be used in normal interactions between client and server.</li> - <li>Response Mark must start at 0 for new channels.</li> - <li>Content class encoding: For inline messages (first byte = 0), a null or empty byte array may be used.</li> - <li>Content class encoding: For refs, (first byte = 1), an error or exception must be thrown if the byte array is either null or empty. It makes no sense to send a null ref.</li> - <li>Content class decoding: For inline messages (first byte = 0), is is not possible to discriminate between the null array or empty array case above that encoded it. Decode as an empty byte array, not a null. (open for discussion)</li> - <li>Content class: It may be possible to set a value for either/or null and empty values in the future - if a use-case can be made for it</li> - <li>Possible batch-handling modes should be decided upon.</li> - <li>TODO: Devise a mechanism to allow one-way requests, where no acknowledgements are sent.</li> -</ul> - - -<h2><a name="AMQP0-9-DesignNotes-AMQP09SpecificationIssues"></a>AMQP 0-9 Specification Issues</h2> -<ul> - <li>Errara will be made by adding to an amqp-errata.0-9.xml file rather than by making edits directly to the specification file. These are the advantages: - <ul> - <li>The differences between the current specification and the spec as we use it are readily apparent.</li> - <li>Different implementations share the same specification file. Thus errors that may arise as a result of a change required for one implementation (e.g. Java) on others (e.g. C++) are controled/eliminated.</li> - </ul> - </li> - <li>Two constants are missing and need to be inserted as an erratum: -<div class="preformatted"><div class="preformattedContent"> -<pre> <constant name = "frame-request" value = "9" />
- <constant name = "frame-response" value = "10" />
-</pre> -</div></div></li> - <li>The Basic field <font color="blue"><tt>Basic.type</tt></font> (a <tt>shortstr</tt>) was omitted from <font color="blue"><tt>Message.transfer</tt></font>. However, after some discussion it was resolved that since thid field serves JMS messaging only, that it should be handled as a custom property rather than creating an XML erratum to insert it. The property name is "<font color="blue"><b><tt>JMSXType</tt></b></font>".</li> - <li>The Basic field <font color="blue"><tt>Basic.mandatory</tt></font>(a <tt>bit</tt>) was originally omitted form <font color="blue"><tt>Message.transfer</tt></font> because its functionality would have been handled by the availability of dead-letter queues. However, they did not make it into the AMQP 0-9 speicification. Thus, <font color="blue"><tt>Basic.mandatory</tt></font> has been temporarily added as the last field in <font color="blue"><tt>Message.transfer</tt></font> until dead-letter queues become a reality in the specification.</li> -</ul> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/AMQPVersion.1.html b/content/xdocs/AMQPVersion.1.html deleted file mode 100755 index 29082c82c3..0000000000 --- a/content/xdocs/AMQPVersion.1.html +++ /dev/null @@ -1,176 +0,0 @@ -<html> - <head> - <title>Apache Qpid : AMQPVersion.1</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : AMQPVersion.1 - </span> - </div> - <div class="pagesubheading"> - This page last changed on Oct 20, 2006 by <font color="#0050B2">kpvdr</font>. - </div> - - <p>Back to <a href="Multiple AMQP Version Support.html" title="Multiple AMQP Version Support">Multiple AMQP Version Support</a></p> - -<h1><a name="AMQPVersion.1-ApproachtoaddingsupportformultipleAMQPversionsintothebroker"></a>Approach to adding support for multiple AMQP versions into the broker </h1> -<p>I had intended to follow approach 2 below, however after some brainstorming, a better and more efficient approach has been proposed. The following is a summary of the possible courses of action.</p> - -<p>Kim van der Riet</p> -<hr /> -<h2><a name="AMQPVersion.1-1.Presentstatus%3ANoAMQPversiondiscrimination."></a>1. Present status: No AMQP version discrimination. </h2> -<h3><a name="AMQPVersion.1-ADVANTAGES%3A"></a>ADVANTAGES: </h3> -<p> a. Nothing changes in the code, and everyone keeps doing what they are already doing... <img class="emoticon" src="./icons/emoticons/wink.gif" height="20" width="20" align="absmiddle" alt="" border="0"/></p> -<h3><a name="AMQPVersion.1-DISADVANTAGES%3A"></a>DISADVANTAGES: </h3> -<p> a. There is no easy way of hosting more than one version of AMQP at the same time in the broker.<br/> - b. The code that touches the version-specific generated method body classes is scattered all over the place. This makes it difficult to maintain the code if there <em><b>is</b></em> a change to the AMQP protocol. In order to help conceive the scope of possible protocol changes (outside of any policy the AMQP WG may have in this regard) consider the following possible change types/scopes:</p> -<ol> - <li>A method call (class, method, fields, types) does not change, but the use or purpose of a field changes;</li> - <li>A method call changes the type of one or more fields;</li> - <li>A method call changes the number of fields (including by removing a field from one version to the next);</li> - <li>A method call changes the order of the fields;</li> - <li>A totally new method call is added;</li> - <li>A method call is removed;</li> - <li>A class is added;</li> - <li>A class is removed;</li> - <li>Any of 5-9 above in such a way as to alter the class/method numbers of unchanged elements (e.g. a class is removed, so class Basic changes from 60 to 50)</li> -</ol> - - -<h2><a name="AMQPVersion.1-2.Initialapproachtosolvingproblem%3ANamespacediscrimination."></a>2. Initial approach to solving problem: Namespace discrimination. </h2> -<p> a. In this approach, each version of the protocol is generated as before, but into a namespace unique to that version.<br/> - b. The <tt>ProtocolSession</tt> objects are made version-aware, and carry the major and minor version numbers of the current session from the <tt>ProtocolInitiation</tt> objects used to start the session.<br/> - c. The points in the code where version-specific method body objects and/or calls are made are moved into a single layer - the method handlers. Static function calls are added where necessary to instantiate and/or process these objects. Since the method handlers are version-aware, they would contain the logic to select the correct namespace.<br/> - d. The generated code would contain additional methods which allow the fields within any method body to be accessed or set using a parametrized function call. This would aid the coding of the version-sensitive logic used in the method handlers.</p> -<div class="preformatted"><div class="preformattedContent"> -<pre>
- +--------+ +---------+ +------------+ +---------+
- | Broker | | Method | | Generated | | Encoder |
- | code | <---> | Handler | <---> | MethodBody | <---> | Decoder |
- | | | classes | | classes | | classes |
- +--------+ +---------+ +------------+ +---------+
- 1 1 set n sets, 1/version 1 or possibly more
-</pre> -</div></div> -<h3><a name="AMQPVersion.1-ADVANTAGES%3A"></a>ADVANTAGES: </h3> -<p> a. Allows multiple AMQP versions to be used simultaneously in the broker.<br/> - b. Isolates the scope of version-specific code to the method handlers, where hand-coded logic specific to the needs of individual AMQP versions may reside. This aids maintainability in the event of additional versions being added/versions being changed.<br/> - c. Forces the code to choose a specific AMQP version to use the <tt>MethodBody</tt> classes.<br/> - d. Works using existing code-generation system (XSLT).</p> -<h3><a name="AMQPVersion.1-DISADVANTAGES"></a>DISADVANTAGES </h3> -<p> a. Code duplication: Since in most AMQP version changes, 90+% of the specification remains unchanged, the generated classes will contain mostly exact duplicates from version to version.<br/> - b. The ideal system of version fallback (in which default behavior is to use the latest class and to hand-code logic only where differences exist) does not operate. Each version must be handled separately whether identical or not.<br/> - c. The code using the parametrized function calls is more complex and not as easy to understand as direct calls.</p> - -<h2><a name="AMQPVersion.1-3.Revisedapproach%3AIntelligentgeneration"></a>3. Revised approach: Intelligent generation </h2> -<p> a. In this approach, the limitations of the existing XSLT code generation are removed. We assume that we can compare one version of the AMQP specification to another, and generate code for the latest version and code to handle only the differences between the latest and each earlier version. To achieve this, we conceptually refactor the XML specification file so that the version information is contained inside the elements instead of outside them. Then each version of the spec is added cumulatively to create a complete map of the specification. For example, assume the following simple example: <div class="preformatted"><div class="preformattedContent"> -<pre>AMQP 1.0:
-Basic.Consume(Ticket ticket, Queue queue, ConsumerTag consumer_tag, NoLocal no_local, NoAck no_ack, bool exclusive, bool nowait);
-AMQP 1.2:
-Basic.Consume(Ticket ticket, Queue queue, ConsumerTag consumer_tag, int no_ack, bool exclusive, bool nowait, NoLocal no_local, int priority);
-</pre> -</div></div><br/> - would be refactored to something like (abbreviated):<div class="code"><div class="codeContent"> -<pre class="code-xml"><span class="code-tag"><AMQP></span>
- <span class="code-tag"><class name="Basic></span>
- <span class="code-tag"><version major=<span class="code-quote">"1"</span> minor=<span class="code-quote">"0"</span> num=<span class="code-quote">"60"</span>/></span>
- <span class="code-tag"><version major=<span class="code-quote">"1"</span> minor=<span class="code-quote">"2"</span> num=<span class="code-quote">"50"</span>/></span>
- <span class="code-tag"><method name=<span class="code-quote">"Consume"</span>></span>
- <span class="code-tag"><version major=<span class="code-quote">"1"</span> minor=<span class="code-quote">"0"</span> num=<span class="code-quote">"20"</span>/></span>
- <span class="code-tag"><version major=<span class="code-quote">"1"</span> minor=<span class="code-quote">"2"</span> num=<span class="code-quote">"20"</span>/></span>
- <span class="code-tag"><field name=<span class="code-quote">"ticket"</span> type=<span class="code-quote">"Ticket"</span>></span>
- <span class="code-tag"><version major=<span class="code-quote">"1"</span> minor=<span class="code-quote">"0"</span> num=<span class="code-quote">"0"</span>/></span>
- <span class="code-tag"><version major=<span class="code-quote">"1"</span> minor=<span class="code-quote">"2"</span> num=<span class="code-quote">"0"</span>/></span>
- <span class="code-tag"></field></span>
- <span class="code-tag"><field name=<span class="code-quote">"queue"</span> type=<span class="code-quote">"Queue"</span>></span>
- <span class="code-tag"><version major=<span class="code-quote">"1"</span> minor=<span class="code-quote">"0"</span> num=<span class="code-quote">"1"</span>/></span>
- <span class="code-tag"><version major=<span class="code-quote">"1"</span> minor=<span class="code-quote">"2"</span> num=<span class="code-quote">"1"</span>/></span>
- <span class="code-tag"></field></span>
- <span class="code-tag"><field name=<span class="code-quote">"consumer_tag"</span> type=<span class="code-quote">"ConsumerTag"</span>></span>
- <span class="code-tag"><version major=<span class="code-quote">"1"</span> minor=<span class="code-quote">"0"</span> num=<span class="code-quote">"2"</span>/></span>
- <span class="code-tag"><version major=<span class="code-quote">"1"</span> minor=<span class="code-quote">"2"</span> num=<span class="code-quote">"2"</span>/></span>
- <span class="code-tag"></field></span>
- <span class="code-tag"><field name=<span class="code-quote">"no_local"</span> type=<span class="code-quote">"NoLocal"</span>></span>
- <span class="code-tag"><version major=<span class="code-quote">"1"</span> minor=<span class="code-quote">"0"</span> num=<span class="code-quote">"3"</span>/></span>
- <span class="code-tag"><version major=<span class="code-quote">"1"</span> minor=<span class="code-quote">"2"</span> num=<span class="code-quote">"6"</span>/></span>
- <span class="code-tag"></field></span>
- <span class="code-tag"><field name=<span class="code-quote">"no_ack"</span> type=<span class="code-quote">"NoAck"</span>></span>
- <span class="code-tag"><version major=<span class="code-quote">"1"</span> minor=<span class="code-quote">"0"</span> num=<span class="code-quote">"4"</span>/></span>
- <span class="code-tag"></field></span>
- <span class="code-tag"><field name=<span class="code-quote">"no_ack"</span> type=<span class="code-quote">"int"</span>></span>
- <span class="code-tag"><version major=<span class="code-quote">"1"</span> minor=<span class="code-quote">"2"</span> num=<span class="code-quote">"3"</span>/></span>
- <span class="code-tag"></field></span>
- <span class="code-tag"><field name=<span class="code-quote">"exclusive"</span> type=<span class="code-quote">"bool"</span>></span>
- <span class="code-tag"><version major=<span class="code-quote">"1"</span> minor=<span class="code-quote">"0"</span> num=<span class="code-quote">"5"</span>/></span>
- <span class="code-tag"><version major=<span class="code-quote">"1"</span> minor=<span class="code-quote">"2"</span> num=<span class="code-quote">"4"</span>/></span>
- <span class="code-tag"></field></span>
- <span class="code-tag"><field name=<span class="code-quote">"nowait"</span> type=<span class="code-quote">"bool"</span>></span>
- <span class="code-tag"><version major=<span class="code-quote">"1"</span> minor=<span class="code-quote">"0"</span> num=<span class="code-quote">"6"</span>/></span>
- <span class="code-tag"><version major=<span class="code-quote">"1"</span> minor=<span class="code-quote">"2"</span> num=<span class="code-quote">"5"</span>/></span>
- <span class="code-tag"></field></span>
- <span class="code-tag"><field name=<span class="code-quote">"priority"</span> type=<span class="code-quote">"int"</span>></span>
- <span class="code-tag"><version major=<span class="code-quote">"1"</span> minor=<span class="code-quote">"2"</span> num=<span class="code-quote">"7"</span>/></span>
- <span class="code-tag"></field></span>
- <span class="code-tag"></method></span>
- <span class="code-tag"></class></span>
-<span class="code-tag"></AMQP></span></pre> -</div></div><br/> - This would result in the generation of only a single <tt>MethodBody</tt> class, and since all instances of this class are version-aware, each knows how to handle calls for a given version (pseudo-java):</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">class BasicConsumeBody <span class="code-keyword">extends</span> AMQPMethodBody
-{
- <span class="code-keyword">public</span> <span class="code-object">int</span> _major, _minor;
- <span class="code-keyword">public</span> BasicConsumeBody(<span class="code-object">int</span> major, <span class="code-object">int</span> minor) {_major = major; _minor = minor;}
- <span class="code-keyword">public</span> <span class="code-object">int</span> getAMQPClass(){<span class="code-keyword">if</span> (major == 1 && minor == 0) <span class="code-keyword">return</span> 60; <span class="code-keyword">else</span> <span class="code-keyword">return</span> 50;} <span class="code-comment">// the class number has changed!
-</span> <span class="code-keyword">public</span> <span class="code-object">int</span> getAMQPMethod(){<span class="code-keyword">return</span> 20;}
-
- <span class="code-keyword">public</span> Ticket getTicket() {...}
- <span class="code-keyword">public</span> Queue getQueue() {...}
- <span class="code-keyword">public</span> ConsumerTag getConsumerTag() {...}
- <span class="code-keyword">public</span> NoLocal getNoLocal() {....}
- <span class="code-keyword">public</span> T getNoAck(<span class="code-object">Class</span><T>) {<span class="code-keyword">if</span> (major == 1 && minor == 0)...} <span class="code-comment">// NoAck changes type
-</span> <span class="code-keyword">public</span> <span class="code-object">boolean</span> getExclusive() {...}
- <span class="code-keyword">public</span> <span class="code-object">boolean</span> getNoWait() {...}
- <span class="code-keyword">public</span> <span class="code-object">int</span> getPriority() <span class="code-keyword">throws</span> Exception {<span class="code-keyword">if</span> (major != 1 || minor != 2) <span class="code-keyword">throw</span>...} <span class="code-comment">// Priority field is in 1.2 only
-</span> <span class="code-comment">// also <span class="code-keyword">for</span> setXXX() methods...
-</span>}</pre> -</div></div> -<p> Static functions would require major and minor to be passed to be able to operate.<br/> - a.#2 As before, the <tt>ProtocolSession</tt> objects are made version-aware, and carry the major and minor version numbers of the current session from the <tt>ProtocolInitiation</tt> objects used to start the session.<br/> - b. As before, the points in the code where version-specific method body objects and/or calls are made are moved into a single layer - the method handlers.<br/> - c. If different versions of a particular method have additional and/or different parameters, the generated class may be thought of as a cumulative collection of all these parameters/types. Since the object is AMQP version-aware, it is possible for the handlers to know which fields to use and/or how to initialize/handle the unused fields for any call which addresses less than all the available fields. Possible courses of action include ignoring the unused field, or initializing it with a meaningful default. Making the field members of the class public would afford this flexibility, and the get/set methods could simply be viewed as convenience methods. Where the type of a field changes, the different fields would require some kind of name-mangling to indicate their type.</p> - -<h3><a name="AMQPVersion.1-ADVANTAGES"></a>ADVANTAGES </h3> -<p> a. Only a single class for each method body<br/> - b. Single get/set method for each field<br/> - c. Common code is simple and remains unchanged from version to version<br/> - d. Where a field type changes, a <tt>Class<T></tt> type method is used; this will break all areas in the code which used to use this method, and conveniently indicate where hand-coded logic is required.<br/> - e. Where there is a field that is unique to a subset of versions, auto-generated code will throw an exception if it is invoked from a session of the wrong version. The addition of the exception will break the compilation (i.e. must be caught), and will indicate places in the code where hand-coded logic will be required.<br/> - f. The existing handler code can remain substantially unchanged.</p> - -<h3><a name="AMQPVersion.1-DISADVANTAGES"></a>DISADVANTAGES </h3> -<p> a. Complexity...<br/> - b. This generation is beyond the capabilities of XSLT (or would be inordinately difficult), and we would need to switch to either Python (or Jython) or a purpose-written Java generator to do the job.<br/> - c. It is not clear from the interface what field is valid in what version. There has been some discussion on name-mangling to solve this, but the general dislike for name-mangling in general and the complexities it brings seem to outweigh any advantages... </p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Acknowledgment.html b/content/xdocs/Acknowledgment.html deleted file mode 100755 index de79793c88..0000000000 --- a/content/xdocs/Acknowledgment.html +++ /dev/null @@ -1,66 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Acknowledgment</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Acknowledgment - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 11, 2008 by <font color="#0050B2">cctrieloff</font>. - </div> - - <table class='confluenceTable'><tbody> -<tr> -<td class='confluenceTd'> <a href="http://www.ej-technologies.com/products/jprofiler/overview.html" title="Visit page outside Confluence"><img src="Acknowledgment_attachments/jprofiler.png" align="absmiddle" border="0" /></a> </td> -<td class='confluenceTd'> <table class="sectionMacro" border="0" cellpadding="5" cellspacing="0" width="100%"><tbody><tr><p> We acknowledge <a href="http://www.ej-technologies.com" title="Visit page outside Confluence">ej-technologies</a> for giving us a free team license for profiling Qpid Java code. </p></tr></tbody></table> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://www.headwaysoftware.com/products/structure101" title="Visit page outside Confluence"><img src="Acknowledgment_attachments/structure101.jpg" align="absmiddle" border="0" /></a> </td> -<td class='confluenceTd'> <table class="sectionMacro" border="0" cellpadding="5" cellspacing="0" width="100%"><tbody><tr><p> We acknowledge <a href="http://www.headwaysoftware.com" title="Visit page outside Confluence">Headway Software</a> for giving us free licenses of Structure101 for analyzing and managing the architecture of Qpid Java code. </p></tr></tbody></table> </td> -</tr> -</tbody></table> - - -<h3><a name="Acknowledgment-AMQPintegrations"></a>AMQP integrations </h3> -<ul> - <li><a href="HermesJMS.html" title="HermesJMS">HermesJMS</a> - The integration of Hermes JMS with Qpid</li> - <li>New Camel supports Qpid: <a href="http://activemq.apache.org/camel/amqp.html" title="Visit page outside Confluence">http://activemq.apache.org/camel/amqp.html</a></li> -</ul> - - - <br/> - <div class="tabletitle"> - <a name="attachments">Attachments:</a> - </div> - - <div class="greybox" align="left"> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="Acknowledgment_attachments/jprofiler.png">jprofiler.png</a> (image/png) - <br/> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="Acknowledgment_attachments/structure101.jpg">structure101.jpg</a> (image/jpeg) - <br/> - </div> - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Acknowledgment_attachments/jprofiler.png b/content/xdocs/Acknowledgment_attachments/jprofiler.png Binary files differdeleted file mode 100755 index 7c5da2cf94..0000000000 --- a/content/xdocs/Acknowledgment_attachments/jprofiler.png +++ /dev/null diff --git a/content/xdocs/Acknowledgment_attachments/structure101.jpg b/content/xdocs/Acknowledgment_attachments/structure101.jpg Binary files differdeleted file mode 100755 index 9242ea9176..0000000000 --- a/content/xdocs/Acknowledgment_attachments/structure101.jpg +++ /dev/null diff --git a/content/xdocs/BDBMessageStore (3rd Party).html b/content/xdocs/BDBMessageStore (3rd Party).html deleted file mode 100755 index 619a37d247..0000000000 --- a/content/xdocs/BDBMessageStore (3rd Party).html +++ /dev/null @@ -1,48 +0,0 @@ -<html> - <head> - <title>Apache Qpid : BDBMessageStore (3rd Party)</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : BDBMessageStore (3rd Party) - </span> - </div> - <div class="pagesubheading"> - This page last changed on Jul 05, 2007 by <font color="#0050B2">ritchiem</font>. - </div> - - <h2><a name="BDBMessageStore%283rdParty%29-BDBMessageStore"></a>BDBMessageStore</h2> - -<p>The BDBMessageStore module utilises the BerkelyDB to provide persistence. It is not part of the Apache Qpid distribution. However, it is listed here to provide Apache Qpid users with a complete list of available Storage Mechanisms.</p> - -<h2><a name="BDBMessageStore%283rdParty%29-Licensing"></a>Licensing</h2> - -<p>This module is available under GPL.</p> - -<h2><a name="BDBMessageStore%283rdParty%29-Download"></a>Download</h2> - -<p>The current build is available here:<br/> -<a href="http://rhm.et.redhat.com/download/" title="Visit page outside Confluence">http://rhm.et.redhat.com/download/</a></p> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/BewareOfStringPromotion.html b/content/xdocs/BewareOfStringPromotion.html deleted file mode 100755 index 4314303ddc..0000000000 --- a/content/xdocs/BewareOfStringPromotion.html +++ /dev/null @@ -1,59 +0,0 @@ -<html> - <head> - <title>Apache Qpid : BewareOfStringPromotion</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : BewareOfStringPromotion - </span> - </div> - <div class="pagesubheading"> - This page last changed on Oct 19, 2006 by <font color="#0050B2">mmccorma</font>. - </div> - - <p><tt>std::string</tt> is a useful tool for simplifying memory management of strings and avoiding unnecessary copies by reference counting. However there is one common gotcha where it <em>causes</em> unnecessary copies. Consider: </p> - -<div class="code"><div class="codeContent"> -<pre class="code-java">void f(<span class="code-keyword">const</span> std::string& s) { cout << s << endl };
-
-void g() {
- <span class="code-keyword">for</span> (<span class="code-object">int</span> i = 0; i < 1000; ++i) { f(<span class="code-quote">"hello"</span>); };
-}</pre> -</div></div> - -<p>This actually allocates, copies and deletes 1000 heap buffers with the string "hello"! The problem here is that "hello" is <em>not</em> an instance of <tt>std::string</tt>. It is a char[5] that must be converted to a temporary <tt>std::string</tt> using the appropriate constructor. However <tt>std::string</tt> always wants to manage its own memory, so the constructor allocates a new buffer and copies the string. Once f() returns and we go round the loop again the temporary is deleted along with its buffer.</p> - -<p>Here's a better solution:</p> - -<div class="code"><div class="codeContent"> -<pre class="code-java">void f(<span class="code-keyword">const</span> std::string& s) { cout << s << endl };
-namespace { <span class="code-keyword">const</span> std::string hello(<span class="code-quote">"hello"</span>); }
-void g() {
- <span class="code-keyword">for</span> (<span class="code-object">int</span> i = 0; i < 1000; ++i) { f(hello); };
-}</pre> -</div></div> - -<p>This time we have a constant <tt>std::string</tt> that is created once at start up and destroyed once at shut-down. The anonymous namespace makes the constant private to this .cpp file so we wont have name clashes. (Its similar to using the static keyword on a global declaration in C, but anonymous namespaces are the preferred way to do it in modern C++) </p> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/BewareStdStringLiterals.html b/content/xdocs/BewareStdStringLiterals.html deleted file mode 100755 index b8388982c0..0000000000 --- a/content/xdocs/BewareStdStringLiterals.html +++ /dev/null @@ -1,69 +0,0 @@ -<html> - <head> - <title>Apache Qpid : BewareStdStringLiterals</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : BewareStdStringLiterals - </span> - </div> - <div class="pagesubheading"> - This page last changed on Oct 19, 2006 by <font color="#0050B2">mmccorma</font>. - </div> - - <p>The short story: in C++ code using <tt>std::string</tt> never use string literals except to initialize static-scoped <tt>std::string</tt> constants.<br/> -(And by the way: <a href="http://cwiki.apache.org/confluence/display/qpid/NeverUseStaticLocalVariables" title="Visit page outside Confluence">NeverUseStaticLocalVariables</a></p> - -<p>The long story: <tt>std::string</tt> is all about avoiding copies. Reference counting and copy-on-write serve to maximise the sharing of a single heap-allocated char array while maintaining memory safety. When used consistently in a program it works rather nicely.</p> - -<p>However, when mixed with classic C-style string literals <tt>std::string</tt> can actually <em>cause</em> needless heap-allocated copies. Consider these innocent looking constructs:</p> - -<div class="code"><div class="codeContent"> -<pre class="code-java">void f(<span class="code-keyword">const</span> std::string& s);
-void g(<span class="code-keyword">const</span> std::string& s = <span class="code-quote">"hello"</span>);
-std::string h() { <span class="code-keyword">return</span> <span class="code-quote">"foo"</span>; }
-
-void copy_surprise {
- std::string x = <span class="code-quote">"x"</span>; <span class="code-comment">// 1
-</span> f(<span class="code-quote">"y"</span>); <span class="code-comment">// 2
-</span> g(); <span class="code-comment">// 3
-</span> x = h(); <span class="code-comment">//4
-</span> <span class="code-keyword">while</span> (x != <span class="code-quote">"end"</span>) { ... } <span class="code-comment">// 4
-</span>}</pre> -</div></div> - -<p>Lines 1-4 all cause creation and destruction of an implicit temporary <tt>std::string</tt> to hold the literal value. Line 5 does this for every execution of the while loop. That's a new/memcpy/delete each time. The heap is a heavily used resource, in tight inner loops in multi-threaded code this can be a <em>severe</em> contention bottleneck that cripples scalability.</p> - -<p>Use static class <tt>std::string</tt> constants or file-private constants instead. You can make global declarations file-private by using a nameless namespace (this is preferred over the use of the <tt>static</tt> keyword.)</p> - -<div class="code"><div class="codeContent"> -<pre class="code-java">namespace {
- <span class="code-keyword">const</span> std::string end(<span class="code-quote">"end"</span>);
-}
-void f() { std::string x; <span class="code-keyword">while</span> (x != end) {...} }</pre> -</div></div> - -<p>And once again <a href="http://cwiki.apache.org/confluence/display/qpid/NeverUseStaticLocalVariables" title="Visit page outside Confluence">NeverUseStaticLocalVariables</a></p> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/BindingURLFormat.html b/content/xdocs/BindingURLFormat.html deleted file mode 100755 index acd2132946..0000000000 --- a/content/xdocs/BindingURLFormat.html +++ /dev/null @@ -1,100 +0,0 @@ -<html> - <head> - <title>Apache Qpid : BindingURLFormat</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : BindingURLFormat - </span> - </div> - <div class="pagesubheading"> - This page last changed on Feb 18, 2008 by <font color="#0050B2">aidan</font>. - </div> - - <div class="preformatted"><div class="preformattedContent"> -<pre><Exchange Class>://<Exchange Name>/[<Destination>]/[<Queue>][?<option>='<value>'[&<option>='<value>']]
-</pre> -</div></div> - -<p>This URL format is used for two purposes in the code base. The broker uses this in the XML configuration file to create and bind queues at broker startup. It is also used by the client as a destination.</p> - -<p>This format was used because it allows an explicit description of exchange and queue relationship.</p> - -<p>The Exchange Class is not normally required for client connection as clients only publish to a named exchange however if exchanges are being dynamically instantiated it will be required. The class is required for the server to instantiate an exchange.</p> - -<p>There are a number of options that are currently defined:</p> -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'>Option</th> -<th class='confluenceTh'>type</th> -<th class='confluenceTh'>Description</th> -</tr> -<tr> -<td class='confluenceTd'>exclusive</td> -<td class='confluenceTd'> boolean</td> -<td class='confluenceTd'>Is this an exclusive connection</td> -</tr> -<tr> -<td class='confluenceTd'>autodelete</td> -<td class='confluenceTd'> boolean</td> -<td class='confluenceTd'>Should this queue be deleted on client disconnection</td> -</tr> -<tr> -<td class='confluenceTd'>durable</td> -<td class='confluenceTd'>boolean</td> -<td class='confluenceTd'>Create a durable queue</td> -</tr> -<tr> -<td class='confluenceTd'>clientid</td> -<td class='confluenceTd'>string</td> -<td class='confluenceTd'>Use the following client id</td> -</tr> -<tr> -<td class='confluenceTd'>subscription</td> -<td class='confluenceTd'>boolean</td> -<td class='confluenceTd'>Create a subscription to this destination</td> -</tr> -<tr> -<td class='confluenceTd'>routingkey</td> -<td class='confluenceTd'>string</td> -<td class='confluenceTd'>Use this value as the routing key</td> -</tr> -</tbody></table> - -<p>Using these options in conjunction with the Binding URL format should allow future expansion as new and custom exchange types are created.</p> - -<p>The URL format requires <b>that at least one</b> Queue or routingkey option be present on the URL.</p> - -<p>The routingkey would be used to encode a topic as shown in the examples section below.</p> - -<h4><a name="BindingURLFormat-Examples"></a>Examples </h4> -<div class="preformatted"><div class="preformattedContent"> -<pre>direct://amq.direct/SimpleQueue
-direct://amq.direct/UnusuallyBoundQueue?routingkey='/queue'
-topic://amq.topic?routingkey='stocks.#'
-topic://amq.topic?routingkey='stocks.nyse.ibm'
-</pre> -</div></div> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Build .NET Client.html b/content/xdocs/Build .NET Client.html deleted file mode 100755 index 2812ee3133..0000000000 --- a/content/xdocs/Build .NET Client.html +++ /dev/null @@ -1,58 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Build .NET Client</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Build .NET Client - </span> - </div> - <div class="pagesubheading"> - This page last changed on Aug 02, 2007 by <font color="#0050B2">ritchiem</font>. - </div> - - <h2><a name="Build.NETClient-BuildingClient"></a>Building Client</h2> - -<p>Generate framing from /Qpid.Common/amqp.xml specificiation file:</p> - -<p> $ build-framing</p> - -<p>Alternatively, just switch to /Qpid.Common and run "ant" there.</p> - -<p>You can build from Visual Studio 2005 normally. Alternatively, you<br/> -can build debug releases for any supported framework from the <br/> -command line using Nant:</p> - -<p>To build .NET 2.0 executables (to bin/net-2.0):</p> - -<p> $ build-dotnet20</p> - -<p>To build .NET 1.1 executables (to bin/net-1.1):</p> - -<p> $ build-dotnet11</p> - -<p>To build for Mono on Linux (to bin/mono-2.0):</p> - -<p> $ build-mono</p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Building.html b/content/xdocs/Building.html deleted file mode 100755 index f6b4bc2b67..0000000000 --- a/content/xdocs/Building.html +++ /dev/null @@ -1,99 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Building</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Building - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 14, 2008 by <font color="#0050B2">cctrieloff</font>. - </div> - - <h2><a name="Building-JavaBuildingPages"></a>Java Building Pages</h2> - -<p>Developer Information</p> - -<ul> - <li><a href="Qpid Java Build How To.html" title="Qpid Java Build How To">Build How To</a></li> - <li><a href="Qpid Developer Documentation.html" title="Qpid Developer Documentation">Qpid Developer Documentation</a></li> - <li><a href="Java Coding Standards.html" title="Java Coding Standards">Coding Standards</a></li> - <li><a href="Multiple AMQP Version Support.html" title="Multiple AMQP Version Support">AMQP Version Handling</a></li> - <li><a href="URL Formats.html" title="URL Formats">URL format for Connections and Binding</a></li> - <li><a href="Java Unit Tests with InVM Broker.html" title="Java Unit Tests with InVM Broker">Creating Java unit tests with InVM broker</a></li> -</ul> - - -<p>Performance Testing</p> - -<ul> - <li><a href="Qpid IBM JMS Performance Test Results.html" title="Qpid IBM JMS Performance Test Results">IBM JMS Performance Test Results</a></li> -</ul> - - -<p>Management Interfaces</p> - -<ul> - <li><a href="Qpid Management Features.html" title="Qpid Management Features">Management Features</a></li> - <li><a href="JMX Management Console.html" title="JMX Management Console">Management Console</a></li> -</ul> - - -<h2><a name="Building-CBuildingPages"></a>C++ Building Pages</h2> - -<p>Developer Information</p> - -<ul> - <li><a href="Qpid Cpp Build How To.html" title="Qpid Cpp Build How To">Build How To get it going</a></li> - <li><a href="PythonBrokerTest.html" title="PythonBrokerTest">The Pyhton test suite</a></li> - <li><a href="Qpid 'C++' Documentation.html" title="Qpid 'C++' Documentation">C++ Coding Standard, Design notes etc</a></li> -</ul> - - - -<p>Performance Testing</p> - -<ul> - <li><a href="Performance Testing for C++.html" title="Performance Testing for C++">Performance Testing for C++</a></li> -</ul> - - -<p>Management Interfaces</p> - -<ul> - <li><a href="RASC.html" title="RASC">Running & Administration and getting started</a> for the C++ Broker</li> - <li><a href="MgmtC++.html" title="MgmtC++">Managing</a> the C++ Broker</li> -</ul> - - - -<h2><a name="Building-PythonandRubyobviouslydon%27tneedbuilding."></a>Python and Ruby obviously don't need building.</h2> - -<h2><a name="Building-.NETBuildingPages"></a>.NET Building Pages</h2> - -<p>.NET can be built under MONO, or on a Windows .NET platform</p> - - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Cluster Design Note.html b/content/xdocs/Cluster Design Note.html deleted file mode 100755 index 11093d52e8..0000000000 --- a/content/xdocs/Cluster Design Note.html +++ /dev/null @@ -1,671 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Cluster Design Note</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Cluster Design Note - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 20, 2007 by <font color="#0050B2">aconway</font>. - </div> - - <hr /> - -<div> -<ul> - <li><a href='#ClusterDesignNote-Overview'>Overview</a> -<ul> - <li><a href='#ClusterDesignNote-Clientsiderequirements'>Client side requirements</a></li> - <li><a href='#ClusterDesignNote-Clusterprotocols'>Cluster protocols</a></li> - <li><a href='#ClusterDesignNote-Sessions'>Sessions</a></li> -</ul></li> - <li><a href='#ClusterDesignNote-TypesofstateWehavetoconsiderseveralkindsofstate%3A'>Types of state We have to consider several kinds of state:</a> -<ul> - <li> -<ul> - <li><a href='#ClusterDesignNote-TheClusterMap%3AMembershipandWiring'>The Cluster Map: Membership and Wiring</a></li> -</ul></li> - <li><a href='#ClusterDesignNote-ProxiesandQueueContent'>Proxies and Queue Content</a> -<ul> - <li><a href='#ClusterDesignNote-FragmentedSharedQueues'>Fragmented Shared Queues</a></li> -</ul></li> -</ul></li> - <li><a href='#ClusterDesignNote-SessionState'>Session State</a> -<ul> - <li><a href='#ClusterDesignNote-Inflightcommands'>In-flight commands</a></li> - <li><a href='#ClusterDesignNote-Resumingachannel'>Resuming a channel</a></li> - <li><a href='#ClusterDesignNote-Replicatingsessionstate.'>Replicating session state.</a></li> -</ul></li> - <li><a href='#ClusterDesignNote-MappingofAMQPcommandstoreplicationmechanisms'>Mapping of AMQP commands to replication mechanisms</a> -<ul> - <li><a href='#ClusterDesignNote-queue.declare%2Fbind%2Fdelete%2Cexchange.declare%2Fdelete'>queue.declare/bind/delete, exchange.declare/delete</a></li> - <li><a href='#ClusterDesignNote-message.transfer%2Fbasic.publish%28clienttobroker%29'>message.transfer/basic.publish (client to broker)</a></li> - <li><a href='#ClusterDesignNote-message.transfer%28brokertoclient%29%2Cmessage.deliver'>message.transfer(broker to client), message.deliver</a></li> - <li><a href='#ClusterDesignNote-message.consume%2Fbasic.consume'>message.consume/basic.consume</a></li> - <li><a href='#ClusterDesignNote-basic.ack%2Fmessage.ok%28fromclient%29'>basic.ack/message.ok(from client)</a></li> - <li><a href='#ClusterDesignNote-basic.ack%2Fmessage.ok%28frombroker%29'>basic.ack/message.ok(from broker)</a></li> - <li><a href='#ClusterDesignNote-basic.reject%2Fmessage.reject'>basic.reject / message.reject</a></li> - <li><a href='#ClusterDesignNote-reference.open%2Fapppend%2Fclose%28clienttobroker%29'>reference.open/apppend/close (client to broker)</a></li> - <li><a href='#ClusterDesignNote-reference.open%2Fapppend%2Fclose%28brokertoclient%29'>reference.open/apppend/close (broker to client) **</a></li> - <li><a href='#ClusterDesignNote-Allcommands'>All commands</a></li> -</ul></li> - <li><a href='#ClusterDesignNote-ClientBrokerProtocol'>Client-Broker Protocol</a></li> - <li><a href='#ClusterDesignNote-BrokerBrokerProtocol'>Broker-Broker Protocol</a></li> - <li><a href='#ClusterDesignNote-PersistenceandRecovery'>Persistence and Recovery</a> -<ul> - <li><a href='#ClusterDesignNote-Competingfailuremodes%3A'>Competing failure modes:</a></li> - <li><a href='#ClusterDesignNote-Persistenceoverview'>Persistence overview</a></li> -</ul></li> - <li><a href='#ClusterDesignNote-Journals'>Journals</a> -<ul> - <li><a href='#ClusterDesignNote-Overview'>Overview</a></li> - <li><a href='#ClusterDesignNote-Useofjournals'>Use of journals</a></li> - <li><a href='#ClusterDesignNote-Whataboutdisklessreliability%3F'>What about diskless reliability?</a></li> -</ul></li> - <li><a href='#ClusterDesignNote-Virtualsynchrony'>Virtual synchrony</a></li> - <li><a href='#ClusterDesignNote-Configuration'>Configuration</a> -<ul> - <li><a href='#ClusterDesignNote-SimplifyingpatternsPossiblewaystoconfigureacluster%3A'>Simplifying patterns Possible ways to configure a cluster:</a></li> - <li><a href='#ClusterDesignNote-Dynamicclusterconfiguration'>Dynamic cluster configuration</a></li> -</ul></li> - <li><a href='#ClusterDesignNote-Transactions'>Transactions</a> -<ul> - <li><a href='#ClusterDesignNote-Localtransactions'>Local transactions</a></li> - <li><a href='#ClusterDesignNote-DistributedTransactions'>Distributed Transactions</a></li> -</ul></li> - <li><a href='#ClusterDesignNote-OpenQuestions'>Open Questions</a></li> -</ul></div> - -<hr /> - - -<h1><a name="ClusterDesignNote-Overview"></a>Overview</h1> - -<p>A Qpid <em>cluster</em> is a "virtual AMQP broker" distributed over multiple processes on multiple hosts. The cluster can continues to provide service in the event of failures of its members.</p> - -<p>Reliability guarantees depend on configuration, there may be configurable trade-offs between reliability and performance or hardware requirements.</p> - -<p>Clustering is <em>transparent</em> to clients. Cluster clients are standard AMQP clients and use the cluster via the AMQP protocol like a standard broker. If a client is disconnected unexpectedly it can fail-over transparently to another member.</p> - -<p>We want to address two major scenarios:</p> -<ul> - <li>Cluster backed by high-performance SAN storage.</li> - <li>Cluster with only unshared local storage on each node.</li> -</ul> - - -<h2><a name="ClusterDesignNote-Clientsiderequirements"></a>Client side requirements</h2> - -<p><em>Transparent failover</em>: the <em>failover manager</em> component of the Qpid client libraries provides a <em>virtual AMQP connection</em>. Client applications send and receive AMQP commands as if conducting an uninterrupted conversation with a single broker.</p> - -<p>In reality the virtual connection may be a series of real network connections to different cluster members. The failover manager negotiates re-connection and state synchronization, but failover commands <em>do not appear</em> on the virtual connection.</p> - -<p>Imagine an AMQP conversation as a paper tape. The real conversation may be multiple strips of torn tape. Near the tears are failover commands that the client never sees. The failover manager cuts off the ragged edges and glues pieces together into a single tape that looks like an uninterrupted conversation with a single broker.</p> - -<p>The failover manager must present a virtual conversation consistent with the failed conversations that <em>could have happened</em> with a single broker. It does not have to exactly duplicate the timing or ordering of the real conversations.</p> - - -<h2><a name="ClusterDesignNote-Clusterprotocols"></a>Cluster protocols</h2> - -<p>We will use two types of protocol to synchronize the cluster:</p> -<ul> - <li>Virtual synchrony: Open AIS, CPG etc.</li> - <li>Point-to-point: AMQP (with proprietary extensions) over TCP.</li> -</ul> - - -<p>We will use two persistence approaches:</p> -<ul> - <li>GFS shared storage.</li> - <li>Local unshared disk storage on a node.</li> -</ul> - - -<p>The first cluster implementation will be entirely virtual synchrony and GFS: the SAN scenario.</p> - -<p>Next iteration will support the local store only scenario but still replicate via EVS.</p> - -<p>Subsequent optimization iterations will use primary-backup replication and proxies to increase througput by reducing multicast packets appearing on all switch ports. Cluster membership and exchange wiring will remain on EVS.</p> - -<p>At all stages of development there will be concrete performance tests and measurements to ensure we are really optimizing.</p> - -<p>Initially we will use AMQP 0-9 WIP protocol using field tables and message headers to pass additional cluster info. At some point we will migrate to 0-10 which is expected to have all the features needed for clustering.</p> - - -<h2><a name="ClusterDesignNote-Sessions"></a>Sessions</h2> - -<p>A <em>session</em> identifies a client-broker relationship that can outlive a single connection. It will be formalized in AMQPO 0-10.</p> - -<p><em>Orderly closure</em> of a connection by either peer ends the session. On Unexpected disconnect the session remains viable for some timeout period allowing the client can reconnect to the cluster and resume.</p> - -<p>Events in the AMQP.0-8 spec that are triggered by closing a connection (e.g. deleting auto-delete queues) are instead trigged by the closure (or timeout) of a session.</p> - - - -<h1><a name="ClusterDesignNote-TypesofstateWehavetoconsiderseveralkindsofstate%3A"></a>Types of state We have to consider several kinds of state:</h1> - -<ul> - <li><em>Cluster Membership</em>: Active cluster members (nodes) and data about them.</li> - <li><em>AMQP Wiring</em>: Names and properties of queues, exchanges and bindings.</li> - <li><em>AMQP Content</em>: Data in messages on queues.</li> - <li><em>Session</em>: Conversation with a single client, including references.</li> -</ul> - - -<p>Data must be replicated and stored such that:</p> -<ul> - <li>A client knows which node(s) can be used for failover.</li> - <li>After a failover, the client can continue its session uninterruped.</li> - <li>No acknowledged messages or commands are lost.</li> - <li>No messges or commands are applied twice.</li> -</ul> - - - -<p>Cluster membership, wiring and session identities are low volume, and will be replicated using virtual synchrony so the entire cluster has a consistent picture.</p> - -<p>Queue content is high volume so it is replicated point-to-point using primary-backup to avoid flooding the network.</p> - -<p>Session state is potentially high volume and only relevant to a single client, so it is also replicated point-to-point.</p> - -<p>How to choose the number and location of backup nodes for a given queue or session is an open question. Note that the choice is independent for every queue and session in principle, but in practice they will probably be grouped in some way.</p> - -<h3><a name="ClusterDesignNote-TheClusterMap%3AMembershipandWiring"></a>The Cluster Map: Membership and Wiring</h3> - -<p>Membership, wiring and session changes are low volume. They are replicated to entire cluster symmetrically using EVS.</p> - -<p>Wiring inclues</p> -<ul> - <li>exchange names and properties</li> - <li>queue names, properties and bindings.</li> -</ul> - - -<p>Membership data includes:</p> -<ul> - <li>address of each node</li> - <li>state of health of each node</li> - <li>primary/backup for each queue/exchange</li> - <li>session names, primary/backup for each session.</li> -</ul> - - - -<h2><a name="ClusterDesignNote-ProxiesandQueueContent"></a>Proxies and Queue Content</h2> - -<p>For primary-backup replication each queue has a primary and backup node. Other nodes act as proxies to the primary. The client is unaware of the distinction, it sees an identical picture regardless of what node it connects to.</p> - -<p>Note a single cluster member may have a mix of primary, backup and proxy queues.</p> - -<p><b>TODO</b>: Ordering issues with proxys and put-back messages (reject, transaction rollback) or selectors.</p> - -<h3><a name="ClusterDesignNote-FragmentedSharedQueues"></a>Fragmented Shared Queues</h3> - -<p>A shared queue has reduced ordering requirements and increased distribution requirements. <em>Fragmenting</em> a shared queue is a special type of replication. The queue is broken into a set of disjoint sub-queues each on a separate node to distribute load.</p> - -<p>Each fragment (sub-queue) content is replicated to backups just like a normal queue, independently of the other fragments.</p> - -<p>The fragments collaberate to create the appearance of a single queue. Fragments store incomging messges in the local queue, and serve local consumers from the local queue whenever possible. When a fragment does not have messages to satisfy its consumers it consumes messages from other fragments in the group. Proxies to a fragmented queue will consume from the "nearest" fragment if possible.</p> - -<p><b>TODO</b>: Proxies can play a more active role. Ordering guarantees, we can provide "same producer to same consumer preserves order" since messages from the same producer always go on the same fragment queue. May break down in the presence of failover unless we remember which fragment received messges from the client and proxy to the same one on the failover replica.</p> - - - - -<h1><a name="ClusterDesignNote-SessionState"></a>Session State</h1> - -<p>Session state includes:</p> -<ul> - <li>open channels, channel attributes (qos, transactions etc.).</li> - <li>active consumers.</li> - <li>open references.</li> - <li>completed command history.</li> - <li>commands in flight.</li> - <li>open transactions</li> - <li>exclusive/private queues.</li> -</ul> - - -<p>The broker a client is connected to is the session primary, one or more other brokers are session backup. On failure of the primary the client fails-over to a backup as described below.</p> - -<p>The client can also fail over to a non-backup node which retrieves session state from the backup.</p> - -<p>The primary-backup protocol must guarantee that the backup has sufficient data to resume at all times without becoming a synchronous bottleneck.</p> - -<h2><a name="ClusterDesignNote-Inflightcommands"></a>In-flight commands</h2> - -<p>Both peers must store sent commands for possible resend and received commands to detect possible duplicates in a failover.</p> - -<p>To keep session size finite a peer can:</p> -<ul> - <li>forget sent commands when we know the other peer has received them.</li> - <li>forget received commands when we know the other peer will not resend them.</li> -</ul> - - -<p>An algorithm to achieve this:</p> - -<p>self_received(r): <blockquote><p>if r.is_response: peer_received(sentr.responds\_to\_id) for s in sent0..r.process\_mark: peer_received(s)</p></blockquote></p> - -<p>peer_received(s): <blockquote><p>sent.erase(s) # forget s but also... # Peer will never resend commands <= s.process_mark. for r in received0..s.process\_mark received.erase(r)</p></blockquote></p> - -<p>The weakest rules for interop between peers A and B are:</p> - -<ul> - <li>A MAY forget a sent command when A knows B received it.</li> - <li>A MUST NOT re-send a command after <em>B could know that</em> A knows B received it.</li> - <li>A MUST remember received commands till A knows that B knows A received it.</li> -</ul> - - -<p>Or in protocol terms:</p> - -<ul> - <li>A MAY forget sent command N when it receives a response to N.</li> - <li>A MUST NOT resend N after sending a response to a response to N.</li> - <li>A MUST remember received command N until it has both sent M responding to N <em>and</em> received a response to M.</li> -</ul> - - - -<h2><a name="ClusterDesignNote-Resumingachannel"></a>Resuming a channel</h2> - -<p>When a channel is first opened, the broker provides a session-id. If there is a failure, the client can connect to the session backup broker and resume the channel as follows (sync code is just for illustration)</p> - -<p><em>TODO does it matter if the new channel number is different from the old?</em></p> - -<ol> - <li>Client client_resume: <blockquote><p>send(command=channel_resume, command_id=0, session_id=resume_id, process_mark=pre_crash_process_mark) ok = receive(command=channel_ok) self_received(ok) # Clean up to peers process mark. resend() continue_session_as_normal()</p></blockquote></li> -</ol> - - -<ol> - <li>Both sides resend(): <blockquote><ol> - <li>Resend in-flight messages. for s in sent: # Careful not to respond to a command we haven't received yet. if s.is_response: until(received.contains(s.resonds_to_id)): self_received(receive()) send(s); # Original command ids and process_mark</li> -</ol> -</blockquote></li> -</ol> - - -<ol> - <li>Broker broker_received_channel_resume(r): <blockquote><p>session=sessionsr.session\_id self_received(r) # Up to date with peers process mark. send(command=channel_ok, command_id=0, process_mark=session.process_mark) resend() continue_session_as_normal()</p></blockquote></li> -</ol> - - - -<h2><a name="ClusterDesignNote-Replicatingsessionstate."></a>Replicating session state.</h2> - -<p><em>TODO: Need to minimize primary synchronously waiting on backup, while ensuring that the primary always knows that the backup is in a state that satisfies the clients expectations for failover. See recent email thread betwween me & gordon</em></p> - - - - -<h1><a name="ClusterDesignNote-MappingofAMQPcommandstoreplicationmechanisms"></a>Mapping of AMQP commands to replication mechanisms</h1> - -<h2><a name="ClusterDesignNote-queue.declare%2Fbind%2Fdelete%2Cexchange.declare%2Fdelete"></a>queue.declare/bind/delete, exchange.declare/delete</h2> - -<p>Update cluster map. Local broker creates the initial queue as primary and establishes a backup.</p> - -<p><em>Private queue</em>: backed up on the <em>session backup</em>.</p> - -<p><em>Shared queue</em>: local primary queue is the first <em>primary fragment</em>. Other brokers that receive publishes for the queue can proxy to this fragment or create their own local fragment (<em>TODO: How do we decide?</em>) Consumes are always served from the local fragment if possible, otherwise proxied to another fragment <em>(TODO: load balancing algorithms to choose the appropriate fragment)</em></p> - - -<h2><a name="ClusterDesignNote-message.transfer%2Fbasic.publish%28clienttobroker%29"></a>message.transfer/basic.publish (client to broker)</h2> - -<p>Local broker evaluates the binding to determine which queue(s) receive the message.</p> -<ul> - <li>primary queues: update local queue, replicate to backup.</li> - <li>proxy queues: forward to primary<br/> -(When the proxy is also a backup we can optimize out the replication step.)</li> -</ul> - - -<p>If the message is delivered to more than one proxy queue on the same node, we just relay the message once. Brokers must be able to differentiate between normal message transfer and proxy/replication transfer so that when the evaluate the binding they only apply the message to local primary/backup queues respectively, and don't attempt to re-forward messages.</p> - -<p><em>TODO: there are a few options</em>:</p> -<ul> - <li>Use custom backup/proxy exchanges and pass an explicit list of queues to receive the message in the header table.</li> - <li>Use normal AQMP commands over a marked connectin/channel</li> - <li>Introduce new cluster commands.</li> -</ul> - - - -<h2><a name="ClusterDesignNote-message.transfer%28brokertoclient%29%2Cmessage.deliver"></a>message.transfer(broker to client), message.deliver</h2> - -<ul> - <li>primary: replicate deliver to backup(s) deliver to client.</li> - <li>proxy: pass through to client.</li> -</ul> - - -<p>Before sending a message to a client, the primary must be sure that the session backup 'knows' about the delivery; i.e. in the event of primary failure the backup knows about unacked messages and will be able to handle an ack or reject for it, resend or requeue it.</p> - -<p>If we can define a clear and deterministic algorithm for message dispatch, and if we replicate all 'inputs' in order then that should be sufficient.</p> - -<p>Selectors slightly complicate the picture, as do multiple consumers and flow control particularly for shared queues where the consumers could be from different sessions.</p> - -<p>In the case of an exclusive or private queue all the inputs come from a single session. If all session requests are handled serially on both primary and backup then dispatch should be deterministic; if separate threads were used to process separate queues that would be lost as the allocation of delivery tags would be dependent on the interleaving of those threads.</p> - -<p>One way of avoiding the need for deterministic dispatch would be for the primary to send a message to the backup(s) to indicate an allocation before the deliver is sent to the client. This could inform the backup of the queue in question, the message id and the delivery tag/request id. The big drawback is that it requires a round-trip to the backup before each deliver and would really affect throughput.</p> - -<p>This looks like an area that needs some specific focus. Can we convince ourselves of a clear and deterministic dispatch algorithm, are thereother solutions that would avoid requiring this without too much synchronicity?</p> - - - -<h2><a name="ClusterDesignNote-message.consume%2Fbasic.consume"></a>message.consume/basic.consume</h2> -<ul> - <li>proxy: forward consume. No replication, client will re-establish consumers.</li> - <li>primary: register consumer.</li> -</ul> - - - -<h2><a name="ClusterDesignNote-basic.ack%2Fmessage.ok%28fromclient%29"></a>basic.ack/message.ok(from client)</h2> -<ul> - <li>proxy: forward</li> - <li>primary: mark message processed, replicate to backups.</li> -</ul> - - - -<h2><a name="ClusterDesignNote-basic.ack%2Fmessage.ok%28frombroker%29"></a>basic.ack/message.ok(from broker)</h2> -<ul> - <li>proxy: forward to client</li> - <li>client: mark message processed.</li> -</ul> - - - -<h2><a name="ClusterDesignNote-basic.reject%2Fmessage.reject"></a>basic.reject / message.reject</h2> - -<p>Similar to the processing of basic.ack. However here the message might be requeued or might be moved to a dead letter queue. Ignoring the dead letter queue in the first instance, the backup would merely cancel the effect of the basic.allocate on receiving the basic.reject.</p> - - -<h2><a name="ClusterDesignNote-reference.open%2Fapppend%2Fclose%28clienttobroker%29"></a>reference.open/apppend/close (client to broker)</h2> -<ul> - <li>proxy: replicate to session backup, forward to primary.</li> - <li>primary: process.</li> -</ul> - - - -<h2><a name="ClusterDesignNote-reference.open%2Fapppend%2Fclose%28brokertoclient%29"></a>reference.open/apppend/close (broker to client) **</h2> -<ul> - <li>primary: send open/append/close.</li> - <li>proxy: replicate to session backup, forward to client.</li> -</ul> - - - -<h2><a name="ClusterDesignNote-Allcommands"></a>All commands</h2> -<ul> - <li>proxy replicates required command history to session backup.</li> -</ul> - - - - -<h1><a name="ClusterDesignNote-ClientBrokerProtocol"></a>Client-Broker Protocol</h1> - -<p>Normal AMQP with the following extensions.</p> - -<p>Initial connection:</p> -<ul> - <li>Pass session name as 0-9 connection identifier or via arguments table.</li> - <li>Broker provides list of failover replicas in arguments table.</li> -</ul> - - -<p>During connection:</p> -<ul> - <li>Client can subscribe to a special "cluster exchange" for messages carrying updates to failover candidates.</li> -</ul> - - -<p>On failure:</p> -<ul> - <li>client chooses failover node randomly from most recent list.</li> - <li>cluster list my identify "preferred" failover candidates.</li> -</ul> - - -<p>On re-connect:</p> -<ul> - <li>0-9 resume command identifies session.</li> - <li>Client rebuilds conversational state.</li> - <li>opens channels</li> - <li>creates consumers</li> - <li>establishes</li> - <li>replays unacknowledeged commands and continues session.</li> -</ul> - - -<p>Note: the client sends conversational state data in messages to a special system exchange. We cant simply use standard AMQP to rebuild channel state, as we will end up with channels with a different command numbering from the interrupted session. For transparency we also want to distinguish reconnection from resumed "normal" operation.</p> - -<p>At this point the session can continue.</p> - - -<h1><a name="ClusterDesignNote-BrokerBrokerProtocol"></a>Broker-Broker Protocol</h1> - -<p>Broker-broker communication uses extended AMQP over specially identified connections and channels (identified in the connection negotiation argument table.)</p> - -<p><b>EVS</b>: First implementation is entirely EVS, all members have a common shared picture of the entire cluster contents.</p> - -<p><b>Proxying</b>: acting as a proxy, a broker forwards commands from client to primary and vice versa. The proxy is as transparent and stateless as possible. A proxy must renumer channels and commands since a single incoming connection may be proxied to more than one outbound connection, so it does need to keep some state. This state is part of the session state replicated to the session backup.</p> - -<p><b>Queue/fragment replication</b>: Depends on whether AMQP or GFS is used to replicate content.</p> - -<p><b>AMQP</b>: For enqueue use AMQP transfer command to transfer content to backup(s). For dequeue use AMQP get command to indicate message removed - no data is transferfed for get over a replication channel.</p> - -<p><em>TODO</em>: this use of get is strained, it starts to look like we may need a separate replication class of commands.</p> - -<p><b>GFS</b>: Queue state is updated in journal files. On failover, the backup reconstruct queue state from the journal.</p> - -<p><b>Session replication</b>: The broker must replicate a command (and get confirmation it was replicated) before responding. For async clients this can be done in a pair of asynchronous streams, i.e. we don't have to wait for a response to command A before we forward command B.</p> - -<p>Session data is replicated via AMQP on special connections. Primary forwards all outgoing requests and incoming responses to the session backup. Backup can track the primary request/response tables and retransmit messages.</p> - -<p><em><b>TODO</b></em>: 0-9 references force us to have heavy session backup, because message data on a reference is not associated with any queue and therefore can't be backed up in a queue backup. If references are removed in 0-10 revisit the need for session backups, we may be able to comress session data enough to store it in the cluster map.</p> - - -<h1><a name="ClusterDesignNote-PersistenceandRecovery"></a>Persistence and Recovery</h1> - -<h2><a name="ClusterDesignNote-Competingfailuremodes%3A"></a>Competing failure modes:</h2> - -<p><b>Tibco</b>: fast when running clean but performance over time has GC "spikes" Single journal for all queues. "holes" in log have to be garbage collected to re-use the log. 1 slow consumer affects everyone because it causes fragmentation of the log.</p> - -<p><b>MQ</b>: write to journal, write journal to DB, read from DB. Consistent & reliable but slow.</p> - -<p><b>Street homegrown solutions</b>: transient MQ with home grown persistence. Can we get more design details for these solutions?</p> - - - -<h2><a name="ClusterDesignNote-Persistenceoverview"></a>Persistence overview</h2> - -<p>There are 3 reasons to persist a message:</p> - -<p><b>Durable messages</b>: must be stored to disk across broker shutdowns or failures.</p> -<ul> - <li>stored when received.</li> - <li>read during start-up.</li> - <li>must be removed after deliver.</li> -</ul> - - -<p><b>Reliability</b>: recover after a crash.</p> -<ul> - <li>stored when received.</li> - <li>read during crash recovery.</li> - <li>must be removed after delivery.</li> -</ul> - - -<p><b>Flow-to-disk</b>: to reduce memory use for full queues.</p> -<ul> - <li>stored when memory gets tight.</li> - <li>read when delivered.</li> - <li>must be removed after delivery.</li> -</ul> - - - -<p>Durable and reliable cases are very similar: storage time is performance-critical (blocks response to sender) but reading is not and cleanup can be done by an async thread or process.</p> - -<p>For flow-to-disk, when queues are full, both store and reading are critical.</p> - -<p>So it looks like the same solution will work for durable and reliable.</p> - -<p>Flow-to-disk has different requirements but it would be desirable to re-use some or all of the durable/reliable solution. In particular if flow-to-disk is combined with durable/reliablle it would be wasteful to write the message to disk a second time - instead it would seem better to keep an in-memory index that allows messages to be read quickly from the reliable/durable store.</p> - -<p>We also need to persist <b>wiring</b> (Queues/Exchanges/Bindings), but this is much less performance critical. The entire wiring model is held in memory so wiring is only read at startup, and updates are low volume and not performance-critical. A simple database should suffice.</p> - - - -<h1><a name="ClusterDesignNote-Journals"></a>Journals</h1> - -<h2><a name="ClusterDesignNote-Overview"></a>Overview</h2> - -<p>A journal is a sequential record of actions taken (e.g. messages enqueued, responses sent.) sufficient to reconstruct the state of the journalled entity (e.g. queue) in the case of failure and recovery.</p> - - -<p><b>TODO</b>: <em>Journal indexing, async journal (thruput vs. latency), journal as common API for backups and disk store?</em></p> - -<p><em><b>TODO</b></em>: <em>Windows for error in journalling - how to make disk update and network ack atomic? How do other technologies handle it?</em></p> - -<p><em><b>TODO</b></em>: <em>References strike again: where do they go in a journal-per-queue?</em></p> - -<p><em><b>TODO</b></em>: <em>Journal per broker pros/cons</em></p> - - -<h2><a name="ClusterDesignNote-Useofjournals"></a>Use of journals</h2> - -<p>For reliability and durability we will use</p> -<ul> - <li>Queue journal (per queue) records enqueue/dequeues and acknowledgements.</li> - <li>Session journal (per session) records references in progress</li> -</ul> - - -<p>The broker writes enqueue and dequeue records to the end of the active journal file. When the file reaches a fixed size it starts a new one.</p> - -<p>A cleanup agent (thread or process) removes, recycles or compacts journal files that have no live (undelivered) messages. (References complicate the book-keeping a little but don't alter the conceptual model.)</p> - -<p>Recovery or restart reconstructs the queue contents from the enqueue/dequeue records in the journal.</p> - -<p>Flow-to-disk can re-use the journal framework, with a simple extension: the broker keeps an in-memory index of live messages in the journal.</p> - -<p>If flow-to-disk is combined with reliability then messages are automatically journalled on arrival, so flow-to-disk can simply delete them from memory and use the in-memory index to read them for delivery.</p> - -<p>Without reliability flow-to-disk is similar except that messages are only journalled if memory gets tight.</p> - -<p><b>Disk thrashing</b>: Why do we think skipping disk heads around between multiple journals will be better than seeking up and down a single journal? Are we assuming that we only need to optimize the case where long sequences of traffic tend to be for the same queue?</p> - -<p><b>No write on fast consume</b>: Optimization - if we can deliver (and get ack) faster than we write then no need to write. How does this interact with HA?</p> - -<p><b>Async journalling</b>: writing to client, writing to journal, acks from client, acks from journal are separate async streams? So if we get client ack before the journalling stream has written the journal we cancel the write? But what kind of ack info do we need? Need a diagram of interactions, failure points and responses at each point. Start simple and optimize, but dont rule out optimizations.</p> - - -<h2><a name="ClusterDesignNote-Whataboutdisklessreliability%3F"></a>What about diskless reliability?</h2> - -<p>Is memory+network replication with no disk a viable option for high-speed transient message flow? May be faster, but can't support durable messages/persistent queues. We will lose messages in total failure or multiple failures where all backups fail, but we can survive single failures and will run a lot faster than diskful.</p> - - - - -<h1><a name="ClusterDesignNote-Virtualsynchrony"></a>Virtual synchrony</h1> - -<p><b>TODO</b>: Wiring & membership via virtual synchrony</p> - -<p><b>TODO</b>: journaling, speed. Will file-per-q really help with disk burnout?</p> - - -<h1><a name="ClusterDesignNote-Configuration"></a>Configuration</h1> - -<h2><a name="ClusterDesignNote-SimplifyingpatternsPossiblewaystoconfigureacluster%3A"></a>Simplifying patterns Possible ways to configure a cluster:</h2> -<ul> - <li>Virtual hosts as units of replication.</li> - <li>Backup rings: all primary components in a broker use the same backup broker and vice-versa. Backups form rings.</li> - <li>Broker component rinks: all the components <em>except sessions</em> have the same backup broker. Session backups are chosen at random so a brokers load will be distributed rather than all falling on its backup.</li> - <li>Disk management issues?</li> - <li>Shared storage issues?</li> -</ul> - - - -<h2><a name="ClusterDesignNote-Dynamicclusterconfiguration"></a>Dynamic cluster configuration</h2> -<ul> - <li>Failover: the primary use case.</li> - <li>Add node: backup, proxy, primary case?</li> - <li>Redirect clients from loaded broker (pretend failure)</li> - <li>Move queue primary from loaded broker/closer to consumers?</li> - <li>Re-start after failover.</li> -</ul> - - -<p><b>Issue:</b> unit of failover/redirect is connection/channel but "working set" of queues and exchanges is unrelated. Use virtual host as unit for failover/relocation? It's also a queue namespace...</p> - -<p>If a queue moves we have to redirect its <em>consumers</em>, can't redirect entire channels! Channels in the same session may move between connections. Or rather we depend on broker to proxy?</p> - -<p>Backups: chained backups rather than multi-backup? Ring backup? What about split brain, elections, quorums etc.</p> - -<p>Should new backups acquire state from primary, from disk or possibly both? Depends on GFS/SAN vs. commodity hw?</p> - - - -<h1><a name="ClusterDesignNote-Transactions"></a>Transactions</h1> - -<h2><a name="ClusterDesignNote-Localtransactions"></a>Local transactions</h2> - -<p>AMQP offers local and distributed transactions, however in a cluster a local transaction could involve queues that are distributed across several nodes.</p> - -<p><em><b>TODO</b></em>: This complicates the model of a proxy as a simple forwarder. You cannot simply forward a local transaction involving queues on two separate primary brokers, the proxy has to be aware of the transaction.</p> - -<p><em><b>TODO</b></em> Can we use point-to-point local transactions or do we have to turn this into a dtx? If dtx, who co-ordinates? Is every broker potentially a transaction co-ordinator?</p> - -<p><em><b>TODO</b></em>: For distributed transactions, will the primary broker and its backups act as a single clustered resource manager for the resource set, or will a failure of one broker abort the transaction?</p> - - -<h2><a name="ClusterDesignNote-DistributedTransactions"></a>Distributed Transactions</h2> - -<p>The prepare needs to be replicated so that if one node fails before completion another node can honour the guarantee to be able to commit or abort. It is also possibe that the work of a transaction is distributed across more than one node anyway.</p> - -<p>I think broadcasting all dtx commands over the group communication protocol seems like the most likely way to handle this.</p> - -<p>The session in which the commands are initiated needs to be replicated also to allow clean resumption on failover.</p> - - - - -<h1><a name="ClusterDesignNote-OpenQuestions"></a>Open Questions</h1> - -<p>Issues: double failure in backup ring: A -> B -> C. Simultaneous failure of A and B. C doesn't have the replica data to take over for A.</p> - -<p>Java/C++ interworking - is there a requirement? Fail over from C++ to Java? Common persistence formats?</p> - - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/ClusteringAndFederation.html b/content/xdocs/ClusteringAndFederation.html deleted file mode 100755 index 9bf1b10cbe..0000000000 --- a/content/xdocs/ClusteringAndFederation.html +++ /dev/null @@ -1,135 +0,0 @@ -<html> - <head> - <title>Apache Qpid : ClusteringAndFederation</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : ClusteringAndFederation - </span> - </div> - <div class="pagesubheading"> - This page last changed on Oct 19, 2006 by <font color="#0050B2">mmccorma</font>. - </div> - - <h1><a name="ClusteringAndFederation-ClusteringAndFederation"></a>Clustering And Federation</h1> - -<p>Each diagram below depicts a distributed network of exchanges and queues. The following notation is used in all diagrams:</p> -<ul> - <li>M: message</li> - <li>E: exchange</li> - <li>Q: queue</li> -</ul> - - -<h2><a name="ClusteringAndFederation-Multicast"></a>Multicast</h2> - -<div class="preformatted"><div class="preformattedContent"> -<pre> M1...Mn
- +--------> Q
- |
- | M1...Mn
- M1...Mn ---> E----+--------> Q
- |
- | M1...Mn
- +--------> Q
-</pre> -</div></div> - -<p>Queue contents are duplicated across all queues. For this scenario PGM<br/> -would be ideal between E and Q, or even directly between E and<br/> -consumers.</p> - -<h2><a name="ClusteringAndFederation-LoadBalancing"></a>Load Balancing </h2> - -<div class="preformatted"><div class="preformattedContent"> -<pre> M1
- +--------> Q
- |
- | ...
- M1...Mn ---> E----+--------> Q
- |
- | Mn
- +--------> Q
-</pre> -</div></div> - -<p>No ordering is guaranteed accross different queues. A naive<br/> -implementation could just be an exchange doing round-robin routing or<br/> -any algorithm of choice. A more complicated exchange could have flow<br/> -control between each queue and the exchange.</p> - -<h2><a name="ClusteringAndFederation-MultipleExchanges"></a>Multiple Exchanges </h2> - -<div class="preformatted"><div class="preformattedContent"> -<pre> M? ---> E1-----+ +-----> Q1
- | |
- | (n*m arrows) |
- M? ---> E2-----+--------------+-----> Q2
- | |
- | |
- M? ---> En-----+ +-----> Qm
-</pre> -</div></div> - -<p>Both the Load Balancing and Multicast scenarios can be extended by<br/> -adding multiple exchange nodes wired into the same (or an overlapping)<br/> -set of queues. One virtual mega exchange (with relaxed ordering<br/> -semantics) could be created by segmenting client connections between<br/> -exchanges. This could be done using a number of strategies, e.g.<br/> -round-robin dns, name mangling, redirects.</p> - -<p>The topologies described above could in theory be use in a variety of<br/> -scenarios ranging from an an isolated high speed subnet with<br/> -identically configured nodes to a loosely coupled WAN with separately<br/> -administered nodes. In fact a single network could include exchanges<br/> -bound to local queues, remote queues available on an isolated high<br/> -speed subnet, and remote destinations (exchange or queue) available<br/> -over WAN/internet. In the last case the exchange may be requred to<br/> -queue messages routed to the remote destination if the WAN/internet<br/> -link is down.</p> - -<p>In the terminology I've been using, a cluster is a set of machines<br/> -sharing the same software and configuration, and generally connected<br/> -via an isolated high speed subnet. A federation on the other hand<br/> -consists of distinctly configured machines individually wired<br/> -together. Both clustering and federation <b>could</b> share a common<br/> -protocol for message delivery. This could possibly even be used for<br/> -multicast if it were a simple stateless store-and-forward protocol.<br/> -(Note the "store" in "store-and-forward" can mean both store on disk<br/> -and store in memory.)</p> - -<p>With this model the key distinction between a cluster and a federation<br/> -is that all the nodes in a cluster are managed as a single unit, e.g.<br/> -one place to start/stop/add/remove/etc. Because of this the nodes in a<br/> -cluster have to pass control messages to each other distinct from the<br/> -general message traffic. These control messages need to be isolated<br/> -from the general message traffic (e.g. on their own subnet). This<br/> -could be done using JGroups and OpenAIS for Java and C++ respectively.</p> - -<p>This document doesn't directly address fault tolerance, but it is<br/> -assumed that any node/broker that contains state can be configured to<br/> -have a passive counterpart that supports two methodologies for<br/> -failover. Broker swapout based on virtual IP, or client reconnect to a<br/> -backup IP.</p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/ClusteringHA.html b/content/xdocs/ClusteringHA.html deleted file mode 100755 index de5abab233..0000000000 --- a/content/xdocs/ClusteringHA.html +++ /dev/null @@ -1,66 +0,0 @@ -<html> - <head> - <title>Apache Qpid : ClusteringHA</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : ClusteringHA - </span> - </div> - <div class="pagesubheading"> - This page last changed on Sep 25, 2007 by <font color="#0050B2">aconway</font>. - </div> - - <h2><a name="ClusteringHA-Definitions"></a>Definitions </h2> - -<p>The topic is being broken up into three sections:</p> - -<ul> - <li>Federation (a set of distributed exchanges and queues, seperately managed and wired together)</li> - <li>Clustering (a set of distributed exchanges and queues managed as a single entity)</li> - <li>HA / Fault tolarance (the ability for exchanges and queues, clustered, federated, or isolated to replicated important state to a backup (failover partner))</li> - <li>Failover (the ability for a client to reconnect to the failover partner)</li> -</ul> - - -<h2><a name="ClusteringHA-Requirements%2FUseCases"></a>Requirements/Use Cases </h2> - -<ul> - <li><a href="Reliability Requirements.html" title="Reliability Requirements">Reliability Requirements</a></li> - <li><a href="ClusteringAndFederation.html" title="ClusteringAndFederation">ClusteringAndFederation</a></li> -</ul> - - -<h2><a name="ClusteringHA-Designnotes"></a>Design notes </h2> -<ul> - <li><a href="Cluster Design Note.html" title="Cluster Design Note">Cluster Design Note</a> - primary/backup pairing, transaction logging.</li> -</ul> - - -<p>Historical</p> -<ul> - <li><a href="Old Clustering Design Note.html" title="Old Clustering Design Note">Old Clustering Design Note</a></li> -</ul> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Configure ACLs.html b/content/xdocs/Configure ACLs.html deleted file mode 100755 index 31c19b46e2..0000000000 --- a/content/xdocs/Configure ACLs.html +++ /dev/null @@ -1,40 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Configure ACLs</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Configure ACLs - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 08, 2008 by <font color="#0050B2">ritchiem</font>. - </div> - - <h2><a name="ConfigureACLs-ConfigureACLs"></a>Configure ACLs</h2> - -<p>This page will be completed shortly with details on how to configure ACLs on the M2.1 broker.</p> - -<p>TBC</p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Configure Java Qpid to use a SSL connection..html b/content/xdocs/Configure Java Qpid to use a SSL connection..html deleted file mode 100755 index 082f53c9b3..0000000000 --- a/content/xdocs/Configure Java Qpid to use a SSL connection..html +++ /dev/null @@ -1,64 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Configure Java Qpid to use a SSL connection.</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Configure Java Qpid to use a SSL connection. - </span> - </div> - <div class="pagesubheading"> - This page last changed on Dec 05, 2007 by <font color="#0050B2">ritchiem</font>. - </div> - - <h2><a name="ConfigureJavaQpidtouseaSSLconnection.-UsingSSLconnectionwithQpidJava."></a>Using SSL connection with Qpid Java.</h2> - -<p>This section will show how to use SSL to enable secure connections between a Java client and broker.</p> - - -<h2><a name="ConfigureJavaQpidtouseaSSLconnection.-Setup"></a>Setup</h2> - -<h3><a name="ConfigureJavaQpidtouseaSSLconnection.-BrokerSetup"></a>Broker Setup</h3> - -<p>The broker configuration file (config.xml) needs to be updated to include the SSL keystore location details.</p> -<div class="code" style="border-style: solid; "><div class="codeHeader" style="border-bottom-style: solid; "><b>Additions required to Connector Section</b></div><div class="codeContent"> -<pre class="code-java"><ssl>
- <enabled><span class="code-keyword">true</span></enabled>
- <sslOnly><span class="code-keyword">true</span></sslOnly>
- <keystorePath>/path/to/keystore.ks</keystorePath>
- <keystorePassword>keystorepass</keystorePassword>
-</ssl></pre> -</div></div> - -<p>The sslOnly option is included here for completeness however this will disable the unencrypted port and leave only the SSL port listening for connections.</p> - - -<h3><a name="ConfigureJavaQpidtouseaSSLconnection.-ClientSetup"></a>Client Setup</h3> - -<p>The best place to start looking is class <em>SSLConfiguration</em> this is provided to the connection during creation however there is currently no example that demonstrates its use.</p> - -<h2><a name="ConfigureJavaQpidtouseaSSLconnection.-Performingtheconnection."></a>Performing the connection.</h2> - - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Configure the Broker via config.xml.html b/content/xdocs/Configure the Broker via config.xml.html deleted file mode 100644 index 5f430942fa..0000000000 --- a/content/xdocs/Configure the Broker via config.xml.html +++ /dev/null @@ -1,51 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Configure the Broker via config.xml</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Configure the Broker via config.xml - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 08, 2008 by <font color="#0050B2">ritchiem</font>. - </div> - - <h2><a name="ConfiguretheBrokerviaconfig.xml-Brokerconfig.xmlOverview"></a>Broker config.xml Overview</h2> - -<p>The broker config.xml file which is shipped in the etc directory of any Qpid binary distribution details various options and configuration for the Java Qpid broker implementation.</p> - -<p>In tandem with the virtualhosts.xml file, the config.xml file allows you to control much of the deployment detail for your Qpid broker in a flexible fashion. </p> - -<p>Note that you can pass the config.xml you wish to use for your broker instance to the broker using the -c command line option. In turn, you can specify the paths for the broker password file and virtualhosts.xml files in your config.xml for simplicity.</p> - -<p>For more information about command line configuration options please see <a href="http://cwiki.apache.org/confluence/display/qpid/Qpid+Design+-+Configuration" title="Visit page outside Confluence">Qpid Design - Configuration</a>.</p> - -<h2><a name="ConfiguretheBrokerviaconfig.xml-QpidVersion"></a>Qpid Version</h2> - -<p>The config format has changed between versions here you can find the configuration details on a per version basis.</p> - -<p><a href="M2 - config.xml.html" title="M2 - config.xml">M2 - config.xml</a><br/> -<a href="M2.1 - config.xml.html" title="M2.1 - config.xml">M2.1 - config.xml</a></p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Configure the Virtual Hosts via virtualhosts.xml.html b/content/xdocs/Configure the Virtual Hosts via virtualhosts.xml.html deleted file mode 100755 index 219e8d5086..0000000000 --- a/content/xdocs/Configure the Virtual Hosts via virtualhosts.xml.html +++ /dev/null @@ -1,113 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Configure the Virtual Hosts via virtualhosts.xml</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Configure the Virtual Hosts via virtualhosts.xml - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 06, 2007 by <font color="#0050B2">mmccorma</font>. - </div> - - <h2><a name="ConfiguretheVirtualHostsviavirtualhosts.xml-virtualhosts.xmlOverview"></a>virtualhosts.xml Overview</h2> - -<p>This configuration file contains details of all queues and topics, and associated properties, to be created on broker startup. These details are configured on a per virtual host basis.</p> - -<p>Note that if you do not add details of a queue or topic you intend to use to this file, you must first create a consumer on a queue/topic before you can publish to it using Qpid. </p> - -<p>Thus most application deployments need a virtualhosts.xml file with at least some minimal detail.</p> - -<h3><a name="ConfiguretheVirtualHostsviavirtualhosts.xml-XMLFormatwithComments"></a>XML Format with Comments</h3> - -<p>The virtualhosts.xml which currently ships as part of the Qpid distribution is really targeted at development use, and supports various artifacts commonly used by the Qpid development team.</p> - -<p>As a result, it is reasonably complex. In the example XML below, I have tried to simplify one example virtual host setup which is possibly more useful for new users of Qpid or development teams looking to simply make use of the Qpid broker in their deployment.</p> - -<p>I have also added some inline comments on each section, which should give some extra information on the purpose of the various elements.</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre>
-<virtualhosts>
- <!-- Sets the default virtual host for connections which do not specify a vh -->
- <default>localhost</default>
- <!-- Define a virtual host and all it's config -->
- <virtualhost>
- <name>localhost</name>
- <localhost>
- <!-- Define the types of additional AMQP exchange available for this vh -->
- <!-- Always get amq.direct (for queues) and amq.topic (for topics) by default -->
- <exchanges>
- <!-- Example of declaring an additional exchanges type for developer use only -->
- <exchange>
- <type>direct</type>
- <name>test.direct</name>
- <durable>true</durable>
- </exchange>
- </exchanges>
-
- <!-- Define the set of queues to be created at broker startup -->
- <queues>
- <!-- The properties configured here will be applied as defaults to all -->
- <!-- queues subsequently defined unless explicitly overridden -->
- <exchange>amq.direct</exchange>
- <!-- Set threshold values for queue monitor alerting to log -->
- <maximumQueueDepth>4235264</maximumQueueDepth> <!-- 4Mb -->
- <maximumMessageSize>2117632</maximumMessageSize> <!-- 2Mb -->
- <maximumMessageAge>600000</maximumMessageAge> <!-- 10 mins -->
-
- <!-- Define a queue with all default settings -->
- <queue>
- <name>ping</name>
- </queue>
- <!-- Example definitions of queues with overriden settings -->
- <queue>
- <name>test-queue</name>
- <test-queue>
- <exchange>test.direct</exchange>
- <durable>true</durable>
- </test-queue>
- </queue>
- <queue>
- <name>test-ping</name>
- <test-ping>
- <exchange>test.direct</exchange>
- </test-ping>
- </queue>
- </queues>
- </localhost>
- </virtualhost>
-</virtualhosts>
-</pre> -</div></div> - - -<h3><a name="ConfiguretheVirtualHostsviavirtualhosts.xml-Usingyourownvirtualhosts.xml"></a>Using your own virtualhosts.xml</h3> - -<p>Note that the config.xml file shipped as an example (or developer default) in the Qpid distribution contains an element which defines the path to the virtualhosts.xml. </p> - -<p>When using your own virtualhosts.xml you must edit this path to point at the location of your file.</p> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Configuring Qpid Management Console.html b/content/xdocs/Configuring Qpid Management Console.html deleted file mode 100755 index e59215f8ba..0000000000 --- a/content/xdocs/Configuring Qpid Management Console.html +++ /dev/null @@ -1,105 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Configuring Qpid Management Console</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Configuring Qpid Management Console - </span> - </div> - <div class="pagesubheading"> - This page last changed on Jun 29, 2007 by <font color="#0050B2">ritchiem</font>. - </div> - - <h2><a name="ConfiguringQpidManagementConsole-ConfiguringQpidManagementConsole"></a>Configuring Qpid Management Console</h2> - -<p>QPID has a management interface that exposes . By default the management interface is enabled but it can also be disabled by modifying the management element in config.xml.</p> - -<p>When starting the broker, the following system properties need to be set by setting the environment variable QPID_OPTS:</p> -<div class="panel"><div class="panelContent"> -<p>QPID_OPTS="-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=8999 -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false"</p> -</div></div> - -<p>Note that you should only use these settings for non-production systems. For production deployments you should use authentication !</p> - -<p>You can find out more about the features exposed by the Qpid JMS interfaces <a href="https://confluence.uk.jpmorgan.com/confluence/display/IBTAMQ/QPID+Management+Features" title="Visit page outside Confluence">here</a>.</p> - -<h2><a name="ConfiguringQpidManagementConsole-UsingEclipseRCP"></a>Using Eclipse RCP</h2> - - -<h3><a name="ConfiguringQpidManagementConsole-InstallingtheQpidManagementConsole%28eclipseRCP%29"></a>Installing the Qpid Management Console (eclipse RCP)</h3> - -<p>Unzip the management eclipse plugin zip for windows in a dir (eg C:/). A dir with name qpidmc (eg C:/qpidmc) will get created.</p> - -<p>To run the RCP from command prompt, set the environment variable QPIDMC_HOME to installation dir (eg. QPIDMC_HOME=C:/qpidmc) and include $QPIDMC_HOME/bin in your PATH.</p> - -<h3><a name="ConfiguringQpidManagementConsole-RunningtheQpidManagementConsole%28eclipseRCP%29"></a>Running the Qpid Management Console (eclipse RCP)</h3> - -<p>To run this application on windows, run any of these scripts-</p> - -<p>qpidmc.bat (windows command prompt)</p> - -<p>qpidmc.sh (cygwin) </p> - -<p>For running on unix, use the scritps for particular windowing system<br/> -qpidmc_<windowing system>.sh (eg. qpidmc_motif.sh)</p> - -<h3><a name="ConfiguringQpidManagementConsole-UsingtheQpidManagementConsole%28eclipseRCP%29"></a>Using the Qpid Management Console (eclipse RCP)</h3> - -<p>Please see <span class="error">[attachment |^Qpid_Management_Console.doc]</span> for using this Eclipse RCP. Attchment contains some of the screenshots of Qpid Management Console (Eclipse RCP) .</p> - -<h2><a name="ConfiguringQpidManagementConsole-UsingJConsole"></a>Using JConsole</h2> - -<p>JConsole is a management tool that comes with the Java Runtime Environment and provides a very simple view of managed beans. It requires no special configuration to be used with QPID.</p> - -<p>To attach to a running broker simply enter the host and port details on the JConsole connect dialog. The port should be the same as the one specified in the system property <tt>com.sun.management.jmxremote.port</tt>.</p> - -<p>Once you are connected expand the tree nodes marked "org.apache".</p> - -<p>Please see attachment for some of the <span class="error">[screenshots|^Qpid_using_jconsole.doc]</span> of using jconsole for Qpid.</p> - -<h2><a name="ConfiguringQpidManagementConsole-UsingHermesJMS"></a>Using HermesJMS</h2> - -<p>HermesJMS also offers integration with the Qpid management interfaces. You can get instructions and more information from <a href="http://wiki.apache.org/qpid/HermesJMS" title="Visit page outside Confluence">http://wiki.apache.org/qpid/HermesJMS</a>.</p> - -<h2><a name="ConfiguringQpidManagementConsole-UsingMC4J"></a>Using MC4J</h2> - -<p><a href="http://www.mc4j.org" title="Visit page outside Confluence">MC4J</a> is an alternative management tool. It provide a richer "dashboard" that can customise the raw MBeans.</p> - -<h4><a name="ConfiguringQpidManagementConsole-Installation"></a>Installation</h4> - -<ul> - <li>First download and install MC4J for your platform. Version 1.2 beta 9 is the latest version that has been tested.</li> - <li>Copy the directory <tt>blaze/java/management/mc4j</tt> into the directory <tt><MC4J-Installation>/dashboards</tt></li> -</ul> - - -<h4><a name="ConfiguringQpidManagementConsole-Configuration"></a>Configuration</h4> - -<p>You should create a connection the JVM to be managed. Using the <tt>Management->Create Server Connection</tt> menu option. The connection URL should be of the form: <tt>service:jmx:rmi:///jndi/rmi://localhost:8999/jmxrmi</tt> making the appropriate host and post changes.</p> - -<h4><a name="ConfiguringQpidManagementConsole-Operation"></a>Operation</h4> - -<p>You can view tabular summaries of the queues, exchanges and connections using the Global Dashboards->QPID tree view. To drill down on individual beans you can right click on the bean. This will show any available graphs too.</p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Connection URL Format.html b/content/xdocs/Connection URL Format.html deleted file mode 100755 index e0223b0626..0000000000 --- a/content/xdocs/Connection URL Format.html +++ /dev/null @@ -1,167 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Connection URL Format</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Connection URL Format - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 02, 2008 by <font color="#0050B2">asimon</font>. - </div> - - <div class="preformatted"><div class="preformattedContent"> -<pre>amqp://[<user>:<pass>@][<clientid>]<virtualhost>[?<option>='<value>'[&<option>='<value>']]
-</pre> -</div></div> - -<p>The connection url defines the values that are common across the cluster of brokers. The virtual host is second in the list as the AMQP specification demands that it start with a '/' otherwise it be more readable to be swapped with clientid. There is currently only one required option and that is the <b>brokerlist</b> option. In addition the following options are recognised.</p> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'>Option</th> -<th class='confluenceTh'>Default</th> -<th class='confluenceTh'>Description</th> -</tr> -<tr> -<td class='confluenceTd'>ssl</td> -<td class='confluenceTd'>false</td> -<td class='confluenceTd'>Set the default for all connections. This can be overridden by the individual broker url.</td> -</tr> -<tr> -<td class='confluenceTd'>brokerlist</td> -<td class='confluenceTd'>see below</td> -<td class='confluenceTd'>The list of brokers to use for this connection</td> -</tr> -<tr> -<td class='confluenceTd'>failover</td> -<td class='confluenceTd'>see below</td> -<td class='confluenceTd'>The type of failover method to use with the broker list.</td> -</tr> -<tr> -<td class='confluenceTd'>cyclecount</td> -<td class='confluenceTd'>0</td> -<td class='confluenceTd'> The number of times to loop through the list of available brokers before failure.</td> -</tr> -</tbody></table> - -<h4><a name="ConnectionURLFormat-Brokerlistoption"></a>Brokerlist option </h4> -<div class="preformatted"><div class="preformattedContent"> -<pre>brokerlist='<broker url>[;<broker url>]'
-</pre> -</div></div> - -<p>The broker list defines the various brokers that can be used for this connection. A minimum of one broker url is required additional URLs are semi-colon(';') delimited.</p> - -<h4><a name="ConnectionURLFormat-BrokerURLformat"></a>Broker URL format </h4> -<div class="preformatted"><div class="preformattedContent"> -<pre><transport>://<host>[:<port>][?<option>='<value>'[&<option>='<value>']]
-</pre> -</div></div> - -<p>There are currently quite a few default values that can be assumed. This was done so that the current client examples would not have to be re-written. The result is if there is no transport, 'tcp' is assumed and the default AMQP port of 5672 is used if no port is specified.</p> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'>Transport</th> -</tr> -<tr> -<td class='confluenceTd'>tcp</td> -</tr> -<tr> -<td class='confluenceTd'>vm</td> -</tr> -</tbody></table> - -<p>Currently only 'tcp' and 'vm' transports are supported. Each broker can take have additional options that are specific to that broker. The following are currently implemented options. To add support for further transports the ''client.transportTransportConnection'' class needs updating along with the parsing to handle the transport.</p> - - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'>Option</th> -<th class='confluenceTh'>Default</th> -<th class='confluenceTh'>Description</th> -</tr> -<tr> -<td class='confluenceTd'>retries</td> -<td class='confluenceTd'>1</td> -<td class='confluenceTd'> The number of times to retry connection to this Broker</td> -</tr> -<tr> -<td class='confluenceTd'>ssl</td> -<td class='confluenceTd'>false</td> -<td class='confluenceTd'>Use ssl on the connection</td> -</tr> -<tr> -<td class='confluenceTd'>connecttimeout</td> -<td class='confluenceTd'>30000</td> -<td class='confluenceTd'>How long in (milliseconds) to wait for the connection to succeed</td> -</tr> -<tr> -<td class='confluenceTd'>connectdelay</td> -<td class='confluenceTd'>none</td> -<td class='confluenceTd'>How long in (milliseconds) to wait before attempting to reconnect</td> -</tr> -</tbody></table> - - -<h4><a name="ConnectionURLFormat-Brokerlistfailoveroption"></a>Brokerlist failover option </h4> -<div class="preformatted"><div class="preformattedContent"> -<pre>failover='<method>[?<options>]'
-</pre> -</div></div> - -<p>This option controls how failover occurs when presented with a list of brokers. There are only two methods currently implemented but interface <tt>qpid.jms.failover.FailoverMethod</tt> can be used for defining further methods.</p> - -<p>Currently implemented failover methods.</p> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'>Method</th> -<th class='confluenceTh'>Description</th> -</tr> -<tr> -<td class='confluenceTd'>singlebroker</td> -<td class='confluenceTd'>This will only use the first broker in the list.</td> -</tr> -<tr> -<td class='confluenceTd'>roundrobin</td> -<td class='confluenceTd'>This method tries each broker in turn.</td> -</tr> -</tbody></table> - -<p>The current defaults are naturally to use the 'singlebroker' when only one broker is present and the 'roundrobin' method with multiple brokers. The '''method''' value in the URL may also be any valid class on the classpath that implements the <tt>FailoverMethod</tt> interface.</p> - -<h3><a name="ConnectionURLFormat-SampleURLs"></a>Sample URLs </h3> -<div class="preformatted"><div class="preformattedContent"> -<pre>amqp:///test?brokerlist='localhost'
-amqp:///test?brokerlist='tcp://anotherhost:5684?retries='10''
-amqp://guest:guest@/test?brokerlist='vm://:1;vm://:2'&failover='roundrobin'
-amqp://guest:guest@/test?brokerlist='vm://:1;vm://:2'&cyclecount='20'
-amqp://guest:guest@client/test?ssl='true'&brokerlist='tcp://localhost;tcp://redundant-server:5673?ssl='false''&failover='roundrobin'
-</pre> -</div></div> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Cpp Client Java Interop Issues.html b/content/xdocs/Cpp Client Java Interop Issues.html deleted file mode 100755 index 1f81de2873..0000000000 --- a/content/xdocs/Cpp Client Java Interop Issues.html +++ /dev/null @@ -1,71 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Cpp Client Java Interop Issues</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Cpp Client Java Interop Issues - </span> - </div> - <div class="pagesubheading"> - This page last changed on Feb 15, 2007 by <font color="#0050B2">mmccorma</font>. - </div> - - <p>Issues affecting C++ client/Java broker/Java client interop build 6th Feb:</p> - -<h2><a name="CppClientJavaInteropIssues-OpenIssues"></a>Open Issues</h2> - -<ul> - <li><a href="http://issues.apache.org/jira/browse/QPID-243" title="Visit page outside Confluence">http://issues.apache.org/jira/browse/QPID-243</a> Inconsistent use of paths in #includes – this does not affect interop, will do after 0-9 branch merge</li> - <li><a href="http://issues.apache.org/jira/browse/QPID-350" title="Visit page outside Confluence">http://issues.apache.org/jira/browse/QPID-350</a> Broker infinite loop on restart with immediate messages</li> -</ul> - - -<ul> - <li>Non-Apache JIRA - Problem with BDBStore queue recreation at startup - details: -<div class="preformatted"><div class="preformattedContent"> -<pre>Restarting our application, I sometimes get a "Protocol Error" exception and the following
-message appearing in the broker log. This is even after restarting the broker when there
-are absolutely no connections.
-RECV: Frame[channel=1; ChannelClose: replyCode=405; replyText=Cannot declare queue, as
-exclusive queue with same name declared on another connection [error code 405]; classId=50;
-methodId=10]
-
-I deleted the $QPID_WORK/<virtual-host>-store directory and I was able to restart.
-
-Also, in the application code, the queue is created as shared (single param constructor) so
-not sure why the broker thinks that it is exclusive?
-</pre> -</div></div></li> -</ul> - - -<h2><a name="CppClientJavaInteropIssues-ResolvedIssues"></a>Resolved Issues</h2> - -<ul> - <li><a href="http://issues.apache.org/jira/browse/QPID-353" title="Visit page outside Confluence">http://issues.apache.org/jira/browse/QPID-353</a> Amend type of destination type from byte to int</li> - <li><a href="http://issues.apache.org/jira/browse/QPID-349" title="Visit page outside Confluence">http://issues.apache.org/jira/browse/QPID-349</a> Use the empty string as the default for virtual host name.</li> -</ul> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/CppApiGuide.html b/content/xdocs/CppApiGuide.html deleted file mode 100755 index 5c01c7a3f2..0000000000 --- a/content/xdocs/CppApiGuide.html +++ /dev/null @@ -1,82 +0,0 @@ -<html> - <head> - <title>Apache Qpid : CppApiGuide</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : CppApiGuide - </span> - </div> - <div class="pagesubheading"> - This page last changed on Sep 26, 2007 by <font color="#0050B2">gsim@redhat.com</font>. - </div> - - <h1><a name="CppApiGuide-C%5CpublicAPIguidelines."></a>C++ public API guidelines.</h1> - -<p>These guidelines are for the public client API to be released in qpid 1.0. The "plugin" API exposed for bdbstore should eventually follow these guidelines but it can be deferred.</p> - -<h2><a name="CppApiGuide-Publicheaderfiles"></a>Public header files</h2> - -<p>Public headers under: qpid/cpp/src/include </p> - -<p>Non-unit client tests should be built with -I include and <em>without</em> -I . so that missing public headers can be quickly identified.</p> - -<p> Only src/include headers are installed with package qpidc-devel. Package qpidd-devel should only install src/include headers, but for 1.0 it may still install private headers.</p> - - -<h2><a name="CppApiGuide-PIMPLidiom"></a>PIMPL idiom</h2> - - -<p>Value classes needed by the user (e.g. framing data types, message content) are exposed as normal classes in public headers.</p> - -<p>Service classes (e.g. Session, Connection etc) use the pimpl idiom for compatibility isolation. See <a href="http://en.wikipedia.org/wiki/Pimpl" title="Visit page outside Confluence">http://en.wikipedia.org/wiki/Pimpl</a>.</p> - - -<h2><a name="CppApiGuide-Threadsafety"></a>Thread safety</h2> - -<p>I believe making the session thread safe will make it simpler to use in various circumstances (some of which may be unforeseen). I don't think it necessarily adds significant overhead (though this is something we can verify).</p> - - - <div class="tabletitle"> - <a name="comments">Comments:</a> - </div> - - <table border="0" width="100%"> - <tr> - <td > - <a name="comment-66761"></a> - <font class="smallfont"><p>= Namespaces in Client Applications =</p> - -<p>Currently, a client application needs the following namespaces:</p> - -<p>using namespace qpid::client;<br/> -using namespace qpid::framing;</p> - -<p>Why should someone writing a client application need to know about the framing namespace? And is 'framing' really the best name to describe this namespace?</p></font> - <div align="left" class="smallfont" style="color: #666666; width: 98%; margin-bottom: 10px;"> - <img src="icons/comment_16.gif" height="16" width="16" border="0" align="absmiddle"/> - Posted by jonathan.robie@redhat.com at Sep 20, 2007 06:58 - </div> - </td> - </tr> - </table> - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/CppEventChannelIo.html b/content/xdocs/CppEventChannelIo.html deleted file mode 100755 index ec38687b43..0000000000 --- a/content/xdocs/CppEventChannelIo.html +++ /dev/null @@ -1,167 +0,0 @@ -<html> - <head> - <title>Apache Qpid : CppEventChannelIo</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : CppEventChannelIo - </span> - </div> - <div class="pagesubheading"> - This page last changed on Nov 06, 2006 by <font color="#0050B2">aconway</font>. - </div> - - <h1><a name="CppEventChannelIo-EventchannelIOabstraction."></a>Event channel IO abstraction.</h1> - -<p>Goals: provide an IO abstraction layer that can be efficiently implemented using differente techniques:</p> - -<ul> - <li>select/poll/epoll</li> - <li>aio_</li> - <li>ec_ new linux event channel.</li> - <li>shared mem, IPC etc.</li> -</ul> - - -<p>The event channel is the central IO absctraction.</p> - -<p>Async requests are posted to the channel as Events. When the request is complete it is returned from getEvent() with the data filled in.</p> - -<p>We provide synchronous APIs to wrap post(event), wait for getEvent(). On posix these APIs are actually implemented using user-level context swithching so we get a simple programing model with minimal blocking and kernel context switching.</p> - -<p>Note: this means that code before and after an apparently synchronous call ''may execute in different threads''. Don't use thread-local<br/> -storage. The term "task" will denote the user-level execution context and we'll provide "task-locak storage" that is carried with the user<br/> -context if we need it. </p> - -<p>We can provide some simple in-process synchronization via the event channel to allow use level tasks to block on application events.</p> - -<h2><a name="CppEventChannelIo-Coreconcepts%3A"></a>Core concepts:</h2> - -<p><tt>EventChannel</tt>:</p> - -<ul> - <li>Manages thread pool.</li> -</ul> - - -<ul> - <li>Worker threads loop getting and processing events.</li> -</ul> - - -<ul> - <li>Async requests: post request event, it will be processed when complete.</li> -</ul> - - -<ul> - <li>Notification: Threads can block on a notification event to be woken when some other thread posts that event.</li> -</ul> - - -<p><tt>Task</tt>:</p> - -<ul> - <li>like lightweight thread</li> -</ul> - - -<ul> - <li>ucontext APIs for user-level context switch.</li> -</ul> - - -<p>Linux ec_ + ucontext implementation:</p> - -<ul> - <li>EventChannel is thin facade over native ec_ APIs.</li> -</ul> - - -<ul> - <li>Tasks are scheduled onto threads.</li> -</ul> - - -<ul> - <li>ideally our threads ''never block'' (but they can be preempted)</li> -</ul> - - -<ul> - <li>when a thread hits a blocking point it suspends the current task and swaps to a ready task.</li> -</ul> - - -<ul> - <li>when the suspended task is unblocked (e.g. async IO completes) it becomes ready and will be picked up by another thread.</li> -</ul> - - -<p>Linux epoll + ucontext:</p> - -<ul> - <li>Prove ucontext ideas.</li> -</ul> - - -<ul> - <li>Use traditional polling inside EventChannel.</li> -</ul> - - -<p>APR portable impl: only need client support - simple blocking socket calls.</p> - -<p>Computing thread pool size:</p> - -<ul> - <li>Initial size based on availabe CPU paralleism</li> -</ul> - - -<ul> - <li>On linux /proc/cpuinfo? Any portable options.</li> -</ul> - - -<ul> - <li>Thread pool grows automatically to avoid deadlock.</li> -</ul> - - -<p><tt>ThreadPool</tt>: Size should stay close to actuall hardware paralellism + some delta due to pre-empted threads and thread-blocking<br/> -synchronization calls required in the event channel implementation itself.</p> - -<p>Questions:</p> - -<ul> - <li>Does the thread pool need to shrink to reclaim resources?</li> -</ul> - - -<ul> - <li>Is there a risk of unbounded growth? How to avoid without deadlock?</li> -</ul> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/CppHandlerChains.html b/content/xdocs/CppHandlerChains.html deleted file mode 100755 index 7896cc8feb..0000000000 --- a/content/xdocs/CppHandlerChains.html +++ /dev/null @@ -1,76 +0,0 @@ -<html> - <head> - <title>Apache Qpid : CppHandlerChains</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : CppHandlerChains - </span> - </div> - <div class="pagesubheading"> - This page last changed on Sep 20, 2007 by <font color="#0050B2">aconway</font>. - </div> - - <p>The C++ broker uses handler chains to break complex processing into individual pieces.</p> - -<ul> - <li>Each session has its own set of FrameHandler chains.</li> - <li>Frames from the network are delivered to the first handler in the chain.</li> - <li>Handlers do something with a frame, then pass it to the next handler.</li> - <li>Handlers may "filter" frames by not passing some frames to the next handler.</li> -</ul> - - -<h1><a name="CppHandlerChains-Currentstatus%282002%2F9%2F20%29"></a>Current status (2002/9/20)</h1> - -<p>Each chain starts with a SessionHandler. It handles L2 (session open, close etc.) and passes other frames to the next handler.</p> - -<p>L3/L4 frames are handled by the SemanticHandler.</p> - -<p>For clustering, a ClusterHandler is inserted at the start of the chain. It replicates frames to a backup broker so the backup can handle failover. It then passes frames on to the normal session handlers.</p> - -<h1><a name="CppHandlerChains-Approachformultiframesegments"></a>Approach for multi-frame segments</h1> - -<ul> - <li>The frame handler chain continues to handle individual frames.</li> - <li>Each handler uses a FrameSet to accumulate its frames.</li> - <li>Frame no longer contains a Body, moved to FrameSet -<div class="code"><div class="codeContent"> -<pre class="code-java">class FrameSet { <span class="code-comment">// sketch
-</span> void add(<span class="code-keyword">const</span> Frame& frame); <span class="code-comment">// True <span class="code-keyword">if</span>
-</span> <span class="code-keyword">const</span> AMQMethodBody* getMethod(); <span class="code-comment">// 0 means not complete.
-</span> <span class="code-keyword">const</span> AMQHeaderBody* getHeader();
- <span class="code-keyword">const</span> AMQContentBody* getContent();
-};</pre> -</div></div> -<p>Note: All the visitor/dispatch classes using AMQFrame need to be reworked. Dispatch will always be based on an AMQMethodBody, not a frame. </p></li> -</ul> - - -<p>Rationale: </p> - -<p>''Frame rather than Segment/FrameSet handlers'': Allows most flexibility to compose or not compose frames into segments & FrameSets. For example a cluster handler needs to replicate frame-by-frame, so we don't want to compose the full segment up front. Since the FrameSet class provides the composition logic, this is specified only once and easy to use in frame handlers.</p> - -<p>''No Segment class'': A segment by itself is not very useful. A non-content method is just a FrameSet containing a single method segment. For content bearing methods are a frameset with headers & content. There's little value for a stand alone segment class.</p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/CppStyleGuide.html b/content/xdocs/CppStyleGuide.html deleted file mode 100755 index 92f21cd503..0000000000 --- a/content/xdocs/CppStyleGuide.html +++ /dev/null @@ -1,86 +0,0 @@ -<html> - <head> - <title>Apache Qpid : CppStyleGuide</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : CppStyleGuide - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 24, 2007 by <font color="#0050B2">aconway</font>. - </div> - - <h1><a name="CppStyleGuide-QpidCstyleguide"></a>Qpid C++ style guide</h1> - -<p>Qpid C++ follows this guide: <a href="http://geosoft.no/development/cppstyle.html" title="Visit page outside Confluence">http://geosoft.no/development/cppstyle.html</a></p> - -<p>With the following amendments:</p> - -<ul> - <li>Rule 34: Qpid source files have .h and .cpp extensions.</li> - <li>Rule 71: Qpid uses 4 space indent, not 2. <b>No tabs</b>.</li> - <li>Rule 75, 81: Qpid allows (but does not require) else/catch to be on same line as preceeding }</li> - <li>Rule 11: Qpid does <em>not</em> add an underscore to member variable names.</li> -</ul> - - -<p>And the following additional rules:</p> - -<ul> - <li>Rule q1: Unlike other blocks, the contents of namespace blocks are <em>not</em> indented to prevent excessive line splitting, and multiple namespaces may be opened or closed on a single line. For example: -<div class="code"><div class="codeContent"> -<pre class="code-java">namespace qpid { namespace common {
-
-class SomeClass {
- void foo();
-};
-
-}} <span class="code-comment">// namespace qpid::common</span></pre> -</div></div></li> -</ul> - - - - -<h2><a name="CppStyleGuide-Debateandchanges"></a>Debate and changes</h2> - -<p>The discussion on qpid-dev did raise debate about some points of the style guide. The exceptions and new rules above reflect:</p> -<ul> - <li>Points that were agreed on the list.</li> - <li>De-facto style of the codebase as it stands today.</li> -</ul> - - -<p>Anyone who feels strongly about further modifications to the style guide should:</p> -<ol> - <li>Raise the issue on qpid-dev.</li> - <li>Get consensus among the active qpid C++ developers for the change.</li> - <li>Reformat the entire qpid codebase to conform to the change.</li> -</ol> - - -<p>If you are not willing to do step 3 then don't bother raising the issue.</p> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/CppTips.html b/content/xdocs/CppTips.html deleted file mode 100755 index 2dddad2409..0000000000 --- a/content/xdocs/CppTips.html +++ /dev/null @@ -1,55 +0,0 @@ -<html> - <head> - <title>Apache Qpid : CppTips</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : CppTips - </span> - </div> - <div class="pagesubheading"> - This page last changed on Mar 28, 2007 by <font color="#0050B2">aconway</font>. - </div> - - <p>Some advice on makefiles and build system</p> -<ul> - <li>SingleMakefile</li> -</ul> - - -<p>This is a collection of coding guidelines, some specific to Qpid, some just good practice in C++. </p> -<ul> - <li><a href="PrivateLocking.html" title="PrivateLocking">PrivateLocking</a></li> - <li><a href="ScopedLocking.html" title="ScopedLocking">ScopedLocking</a></li> - <li><a href="SharedPtr.html" title="SharedPtr">SharedPtr</a></li> - <li><a href="BewareStdStringLiterals.html" title="BewareStdStringLiterals">BewareStdStringLiterals</a></li> - <li><a href="NeverUseStaticLocalVariables.html" title="NeverUseStaticLocalVariables">NeverUseStaticLocalVariables</a></li> - <li><a href="BewareOfStringPromotion.html" title="BewareOfStringPromotion">BewareOfStringPromotion</a></li> - <li><a href="ReturnStdStringByValue.html" title="ReturnStdStringByValue">ReturnStdStringByValue</a></li> - <li><a href="NoUsingNamespaceInHeaders.html" title="NoUsingNamespaceInHeaders">NoUsingNamespaceInHeaders</a></li> - <li><a href="ValgrindBadSuppressions.html" title="ValgrindBadSuppressions">ValgrindBadSuppressions</a></li> -</ul> - - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Developer Pages.html b/content/xdocs/Developer Pages.html deleted file mode 100755 index 34b210b9e3..0000000000 --- a/content/xdocs/Developer Pages.html +++ /dev/null @@ -1,82 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Developer Pages</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Developer Pages - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 18, 2008 by <font color="#0050B2">godfrer</font>. - </div> - - <h2><a name="DeveloperPages-DeveloperPages"></a>Developer Pages</h2> - -<h3><a name="DeveloperPages-Implementations%2CStyleguidesandTools"></a>Implementations, Style guides and Tools</h3> - -<p>Follow the links below to view documentation about the Java & C++ brokers, client implementations and other useful project information. Our project documentation is currently being expanded so check back for updates !</p> - -<ul> - <li><a href="Qpid .Net Documentation.html" title="Qpid .Net Documentation">Qpid .Net Documentation</a></li> - <li><a href="Qpid Java Documentation.html" title="Qpid Java Documentation">Qpid Java Documentation</a></li> - <li><a href="Qpid 'C++' Documentation.html" title="Qpid 'C++' Documentation">Qpid 'C++' Documentation</a></li> - <li><a href="PythonBrokerTest.html" title="PythonBrokerTest">Qpid Python Test Framework</a></li> - <li><a href="Qpid Release Page.html" title="Qpid Release Page">Qpid Release Page</a></li> - <li><a href="source repository.html" title="Source Repository">Subversion repository</a></li> -</ul> - - -<h3><a name="DeveloperPages-Designnotes"></a>Design notes </h3> -<ul> - <li><a href="Management Design notes.html" title="Management Design notes">Management Design notes</a> - The layered AMQP management protocol for mgmt tools (currently in C++ broker)</li> - <li><a href="http://cwiki.apache.org/confluence/display/qpid/Multiple+AMQP+Version+Support" title="Visit page outside Confluence">AMQPVersion</a> - Multiple AMQP version support design notes</li> - <li><a href="ClusteringHA.html" title="ClusteringHA">ClusteringHA</a> - Federation, HA, and Clustering design notes</li> - <li><a href="AMQP0-9-DesignNotes.html" title="AMQP0-9-DesignNotes">AMQP0-9-DesignNotes</a> - Design notes for AMQP 0-9 implementation</li> - <li><a href="Queue Replay.html" title="Queue Replay">Queue Replay</a> - Adding replay to queues.</li> - <li><a href="Interop Testing Specification.html" title="Interop Testing Specification">Interop Testing Specification</a> - Common test cases to ensure all clients and brokers interop.</li> - <li><a href="The AMQP Distributed Transaction Classes.html" title="The AMQP Distributed Transaction Classes">The AMQP Distributed Transaction Classes</a> - The+AMQP+Distributed+Transaction+Classes</li> -</ul> - - -<h3><a name="DeveloperPages-WeeklyDeveloperMeetingMinutes"></a>Weekly Developer Meeting Minutes</h3> - -<ul> - <li><a href="Qpid Java Meeting Minutes 28-03-2008.html" title="Qpid Java Meeting Minutes 28-03-2008">Qpid Java Meeting Minutes 2008-03-28</a></li> - <li><a href="Qpid Java Meeting Minutes 04-04-2008.html" title="Qpid Java Meeting Minutes 04-04-2008">Qpid Java Meeting Minutes 2008-04-04</a></li> - <li><a href="Qpid Java Meeting Minutes 11-04-2008.html" title="Qpid Java Meeting Minutes 11-04-2008">Qpid Java Meeting Minutes 2008-04-11</a></li> - <li><a href="Qpid Java Meeting Minutes 2008-04-18.html" title="Qpid Java Meeting Minutes 2008-04-18">Qpid Java Meeting Minutes 2008-04-18</a></li> -</ul> - - - <br/> - <div class="tabletitle"> - <a name="attachments">Attachments:</a> - </div> - - <div class="greybox" align="left"> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="Developer Pages_attachments/merege_test_output.txt">merege_test_output.txt</a> (application/octet-stream) - <br/> - </div> - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Developer Pages_attachments/merege_test_output.txt b/content/xdocs/Developer Pages_attachments/merege_test_output.txt deleted file mode 100755 index 2ff820ea55..0000000000 --- a/content/xdocs/Developer Pages_attachments/merege_test_output.txt +++ /dev/null @@ -1,470 +0,0 @@ -[INFO] Scanning for projects...
-[INFO] Reactor build order:
-[INFO] Qpid
-[INFO] Qpid Common Utilities
-[INFO] Qpid Broker
-[INFO] junit-toolkit
-[INFO] Qpid Client
-[INFO] Qpid Plugins
-[INFO] junit-toolkit-maven-plugin
-[INFO] Qpid System Tests
-[INFO] Qpid Performance Tests
-[INFO] Qpid Integration Tests
-[INFO] Qpid Management
-[INFO] Qpid Example
-[INFO] Qpid Client for Java 1.4
-[INFO] ----------------------------------------------------------------------------
-[INFO] Building Qpid
-[INFO] task-segment: [test]
-[INFO] ----------------------------------------------------------------------------
-[INFO] No goals needed for project - skipping
-[INFO] ----------------------------------------------------------------------------
-[INFO] Building Qpid Common Utilities
-[INFO] task-segment: [test]
-[INFO] ----------------------------------------------------------------------------
-[INFO] [antrun:run {execution: protocol-version}]
-[INFO] Executing tasks
- [echo] "C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\common\target/generated-sources/gentools"
-
-compile_generator:
-
-compile:
-
-generate:
- [java] XML files: [C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\specs/amqp.0-8.xml, C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\specs/amqp.0-9.xml]
- [java] "C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\specs/amqp.0-8.xml": Found version 8-0.
- [java] "C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\specs/amqp.0-9.xml": Found version 0-9.
- [java] Looking for template files in directory: C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\common\templates\model
- [java] Looking for version specific template files in directory: C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\common\templates\model\version
- [java] model template file(s):
- [java] C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\common\templates\model\ClientMethodDispatcherInterface.vm
- [java] model template file(s):
- [java] C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\common\templates\model\MethodDispatcherInterface.vm
- [java] model template file(s):
- [java] C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\common\templates\model\MethodRegistryClass.vm
- [java] model template file(s):
- [java] C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\common\templates\model\ProtocolVersionListClass.vm
- [java] model template file(s):
- [java] C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\common\templates\model\ServerMethodDispatcherInterface.vm
- [java] model template file(s):
- [java] C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\common\templates\model\version\AmqpConstantsClass.vm
- [java] model template file(s):
- [java] C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\common\templates\model\version\ClientMethodDispatcherInterface.vm
- [java] model template file(s):
- [java] C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\common\templates\model\version\MethodDispatcherInterface.vm
- [java] model template file(s):
- [java] C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\common\templates\model\version\MethodRegistryClass.vm
- [java] model template file(s):
- [java] C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\common\templates\model\version\ServerMethodDispatcherInterface.vm
- [java] Looking for template files in directory: C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\common\templates\class
- [java] Looking for version specific template files in directory: C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\common\templates\class\version
- [java] Looking for template files in directory: C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\common\templates\method
- [java] Looking for version specific template files in directory: C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\common\templates\method\version
- [java] method template file(s):
- [java] C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\common\templates\method\MethodBodyInterface.vm
- [java] method template file(s):
- [java] C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\common\templates\method\version\MethodBodyClass.vm
- [java] Looking for template files in directory: C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\common\templates\field
- [java] Looking for version specific template files in directory: C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\common\templates\field\version
- [java] Generation directory: C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\common\target\generated-sources\gentools\org\apache\qpid\framing
- [java] Files generated: 0
- [java] Done.
-[INFO] Executed tasks
-[INFO] Registering compile source root C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\common\target\generated-sources\gentools
-[INFO] [jython:jython {execution: jython}]
-[INFO] [resources:resources]
-[INFO] Using default encoding to copy filtered resources.
-[INFO] [compiler:compile]
-Compiling 325 source files to C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\common\target\classes
-[INFO] [antrun:run {execution: version_properties}]
-[INFO] Executing tasks
-[propertyfile] Updating property file: C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\common\target\classes\qpidversion.properties
-[INFO] Executed tasks
-[INFO] [resources:testResources]
-[INFO] Using default encoding to copy filtered resources.
-[INFO] [compiler:testCompile]
-[INFO] Nothing to compile - all classes are up to date
-[INFO] [surefire:test]
-[INFO] Surefire report directory: C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\common\target\surefire-reports
-
--------------------------------------------------------
- T E S T S
--------------------------------------------------------
-Running org.apache.qpid.pool.PoolingFilterTest
-log4j:WARN No appenders could be found for logger (org.apache.qpid.pool.PoolingFilter).
-log4j:WARN Please initialize the log4j system properly.
-Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.125 sec
-Running org.apache.qpid.framing.BasicContentHeaderPropertiesTest
-Tests run: 18, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.156 sec
-Running org.apache.qpid.util.CommandLineParserTest
-Tests run: 22, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.031 sec
-Running org.apache.qpid.framing.AMQShortStringTest
-Tests run: 4, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.016 sec
-Running org.apache.qpid.util.SerialTest
-Tests run: 2, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.047 sec
-Running org.apache.qpid.session.TestSession
-Tests run: 0, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0 sec
-Running org.apache.qpidity.transport.ConnectionTest
-Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.594 sec
-Running org.apache.qpid.framing.PropertyFieldTableTest
-Tests run: 23, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.093 sec
-
-Results :
-Tests run: 71, Failures: 0, Errors: 0, Skipped: 0
-
-[INFO] ----------------------------------------------------------------------------
-[INFO] Building Qpid Broker
-[INFO] task-segment: [test]
-[INFO] ----------------------------------------------------------------------------
-[WARNING] While downloading javacc:javacc:3.2 - This artifact has been relocated to net.java.dev.javacc:javacc:3.2. - -
-[INFO] [javacc:javacc {execution: default}]
-[INFO] Nothing to process - all grammars are up to date
-[INFO] [resources:resources]
-[INFO] Using default encoding to copy filtered resources.
-[INFO] [compiler:compile]
-[INFO] Nothing to compile - all classes are up to date
-[INFO] [antrun:run {execution: version_properties}]
-[INFO] Executing tasks
-[propertyfile] Updating property file: C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\broker\target\classes\qpidversion.properties
-[INFO] Executed tasks
-[INFO] [resources:testResources]
-[INFO] Using default encoding to copy filtered resources.
-[INFO] [compiler:testCompile]
-[INFO] Nothing to compile - all classes are up to date
-[INFO] [surefire:test]
-[INFO] Surefire report directory: C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\broker\target\surefire-reports
-main 2008-04-17 15:48:19,460 WARN [security.auth.sasl.UsernamePasswordInitialiser] we need a server that will correctly convert the incomming plain text for comparison to file.
-main 2008-04-17 15:48:20,320 WARN [server.security.access.ACLManager] No ACL Plugin specified. Using default ACL Plugin 'AllowAll' for VirtualHost:'test'
-
--------------------------------------------------------
- T E S T S
--------------------------------------------------------
-Running org.apache.qpid.server.util.LoggingProxyTest
-Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.031 sec
-Running org.apache.qpid.server.SelectorParserTest
-Tests run: 12, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.063 sec
-Running org.apache.qpid.server.configuration.TestPropertyUtils
-Tests run: 2, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.016 sec
-Running org.apache.qpid.server.exchange.ExchangeMBeanTest
-Tests run: 3, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.125 sec
-Running org.apache.qpid.server.queue.AMQQueueAlertTest
-Tests run: 5, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 1.312 sec
-Running org.apache.qpid.server.exchange.HeadersBindingTest
-Tests run: 14, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0 sec
-Running org.apache.qpid.server.queue.AMQQueueMBeanTest
-Tests run: 5, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.079 sec
-Running org.apache.qpid.server.protocol.TestIoSession
-Tests run: 0, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0 sec
-Running org.apache.qpid.server.store.TestableMemoryMessageStore
-Tests run: 0, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0 sec
-Running org.apache.qpid.server.exchange.DestWildExchangeTest
-Tests run: 11, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.047 sec
-Running org.apache.qpid.server.protocol.TestMinaProtocolSession
-Tests run: 0, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0 sec
-
-Results :
-Tests run: 53, Failures: 0, Errors: 0, Skipped: 0
-
-[INFO] [antrun:run {execution: python_test}]
-[INFO] Executing tasks
-
-run-tests:
- [echo] Starting Broker with command
- [java] main 2008-04-17 15:48:22,789 DEBUG [apache.qpid.common.QpidProperties] Dumping QpidProperties
- [java] main 2008-04-17 15:48:22,789 DEBUG [apache.qpid.common.QpidProperties] Property: qpid.version Value: 1.0-incubating-M3-SNAPSHOT
- [java] main 2008-04-17 15:48:22,789 DEBUG [apache.qpid.common.QpidProperties] Property: qpid.svnversion Value: 649054:649132
- [java] main 2008-04-17 15:48:22,789 DEBUG [apache.qpid.common.QpidProperties] Property: qpid.name Value: Qpid Broker
- [java] main 2008-04-17 15:48:22,789 DEBUG [apache.qpid.common.QpidProperties] End of property dump
- [java] Qpid Broker - 1.0-incubating-M3-SNAPSHOT build: 649054:649132 (AMQP version(s) [major.minor]: 8-0, 0-9)
- [java] Using configuration file C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\broker\etc\config.xml
- [java] Configuring logger using configuration file C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\broker\etc\log4j.xml
- [java] 2008-04-17 15:48:23,789 WARN [main] management.AMQUserManagementMBean (AMQUserManagementMBean.java:387) - Access rights contains user 'admin' but there is no authentication data for that user
- [java] 2008-04-17 15:48:23,789 WARN [main] management.AMQUserManagementMBean (AMQUserManagementMBean.java:387) - Access rights contains user 'user' but there is no authentication data for that user
- [java] 2008-04-17 15:48:24,570 WARN [main] management.JMXManagedObjectRegistry (JMXManagedObjectRegistry.java:153) - JMX: Started JMXConnector server on port '2111' with security disabled
- [java] 2008-04-17 15:48:24,679 WARN [main] access.ACLManager (ACLManager.java:52) - No ACL Plugin specified. Using default ACL Plugin 'AllowAll' for VirtualHost:'localhost'
- [java] 2008-04-17 15:48:24,711 WARN [main] access.ACLManager (ACLManager.java:52) - No ACL Plugin specified. Using default ACL Plugin 'AllowAll' for VirtualHost:'development'
- [java] 2008-04-17 15:48:24,726 WARN [main] access.ACLManager (ACLManager.java:52) - No ACL Plugin specified. Using default ACL Plugin 'AllowAll' for VirtualHost:'test'
- [java] 2008-04-17 15:48:24,726 INFO [main] server.Main (Main.java:267) - Starting Qpid Broker 1.0-incubating-M3-SNAPSHOT build: 649054:649132
- [java] 2008-04-17 15:48:24,929 WARN [main] transport.ConnectorConfiguration (ConnectorConfiguration.java:110) - Using Mina IO Processing
- [java] 2008-04-17 15:48:25,039 INFO [main] server.Main (Main.java:420) - Qpid.AMQP listening on non-SSL address 0.0.0.0/0.0.0.0:2110
- [java] 2008-04-17 15:48:25,039 INFO [main] server.Main (Main.java:441) - Qpid Broker Ready :1.0-incubating-M3-SNAPSHOT build: 649054:649132
- [java] Started Proccess: python run-tests -v -I java_failing.txt -b localhost:2110 -s ../specs/amqp.0-9.no-wip.xml
- [java] [ERR]Traceback (most recent call last):
- [java] [ERR] File "run-tests", line 32, in <module>
- [java] [ERR] if not testrunner.run(): sys.exit(1)
- [java] [ERR] File "/cygdrive/c/work/qpid/thegreatmerge/thegreatmerge-working/qpid/python/qpid/testlib.py", line 176, in run
- [java] [ERR] self._parseargs(args)
- [java] [ERR] File "/cygdrive/c/work/qpid/thegreatmerge/thegreatmerge-working/qpid/python/qpid/testlib.py", line 129, in _parseargs
- [java] [ERR] if opt in ("-I", "--ignore-file"): self.ignoreFile(value)
- [java] [ERR] File "/cygdrive/c/work/qpid/thegreatmerge/thegreatmerge-working/qpid/python/qpid/testlib.py", line 96, in ignoreFile
- [java] [ERR] f = file(filename)
- [java] [ERR]IOError: [Errno 2] No such file or directory: 'java_failing.txt'
- [java] Waiting for process to exit: python run-tests -v -I java_failing.txt -b localhost:2110 -s ../specs/amqp.0-9.no-wip.xml
- [java] Done Proccess: python run-tests -v -I java_failing.txt -b localhost:2110 -s ../specs/amqp.0-9.no-wip.xml
-[INFO] Executed tasks
-[INFO] ----------------------------------------------------------------------------
-[INFO] Building junit-toolkit
-[INFO] task-segment: [test]
-[INFO] ----------------------------------------------------------------------------
-[INFO] [resources:resources]
-[INFO] Using default encoding to copy filtered resources.
-[INFO] [compiler:compile]
-[INFO] Nothing to compile - all classes are up to date
-[INFO] [resources:testResources]
-[INFO] Using default encoding to copy filtered resources.
-[INFO] [compiler:testCompile]
-[INFO] No sources to compile
-[INFO] [surefire:test]
-[INFO] Surefire report directory: C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\junit-toolkit\target\surefire-reports
-
--------------------------------------------------------
- T E S T S
--------------------------------------------------------
-There are no tests to run.
-
-Results :
-Tests run: 0, Failures: 0, Errors: 0, Skipped: 0
-
-[INFO] ----------------------------------------------------------------------------
-[INFO] Building Qpid Client
-[INFO] task-segment: [test]
-[INFO] ----------------------------------------------------------------------------
-[INFO] Ignoring available plugin update: 2.4 as it requires Maven version 2.0.8
-[INFO] Ignoring available plugin update: 2.4-SNAPSHOT as it requires Maven version 2.0.8
-[INFO] [javacc:javacc {execution: default}]
-[INFO] Nothing to process - all grammars are up to date
-[INFO] [resources:resources]
-[INFO] Using default encoding to copy filtered resources.
-[INFO] [compiler:compile]
-[INFO] Nothing to compile - all classes are up to date
-[INFO] [antrun:run {execution: version_properties}]
-[INFO] Executing tasks
-[propertyfile] Updating property file: C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\client\target\classes\qpidversion.properties
-[INFO] Executed tasks
-[INFO] [resources:testResources]
-[INFO] Using default encoding to copy filtered resources.
-[INFO] [compiler:testCompile]
-[INFO] Nothing to compile - all classes are up to date
-[INFO] [surefire:test]
-[INFO] Surefire report directory: C:\work\qpid\thegreatmerge\thegreatmerge-working\qpid\java\client\target\surefire-reports
-
--------------------------------------------------------
- T E S T S
--------------------------------------------------------
-Running org.apache.qpid.test.unit.topic.TopicSessionTest
-log4j:WARN No appenders could be found for logger (org.apache.qpid.testutil.QpidTestCase).
-log4j:WARN Please initialize the log4j system properly.
-Tests run: 8, Failures: 0, Errors: 8, Skipped: 0, Time elapsed: 1.828 sec <<< FAILURE!
-Running org.apache.qpid.test.unit.client.connectionurl.ConnectionURLTest
-Tests run: 24, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.063 sec
-Running org.apache.qpid.client.AMQQueueDeferredOrderingTest
-Tests run: 1, Failures: 0, Errors: 1, Skipped: 0, Time elapsed: 0.015 sec <<< FAILURE!
-Running org.apache.qpid.test.unit.basic.MultipleConnectionTest
-Tests run: 1, Failures: 0, Errors: 1, Skipped: 0, Time elapsed: 0.015 sec <<< FAILURE!
-Running org.apache.qpid.test.unit.client.message.MapMessageTest
-Tests run: 18, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.047 sec
-Running org.apache.qpid.test.unit.transacted.TransactedTest
-java.lang.NullPointerException
- at org.apache.qpid.client.handler.ClientMethodDispatcherImpl.newMethodDispatcher(ClientMethodDispatcherImpl.java:86)
- at org.apache.qpid.client.protocol.AMQProtocolSession.setStateManager(AMQProtocolSession.java:171)
- at org.apache.qpid.client.protocol.AMQProtocolHandler.setStateManager(AMQProtocolHandler.java:750)
- at org.apache.qpid.client.AMQConnection.<init>(AMQConnection.java:451)
- at org.apache.qpid.client.AMQConnection.<init>(AMQConnection.java:281)
- at org.apache.qpid.testutil.QpidTestCase.getConnection(QpidTestCase.java:339)
- at org.apache.qpid.test.unit.transacted.TransactedTest.setUp(TransactedTest.java:65)
- at junit.framework.TestCase.runBare(TestCase.java:125)
- at org.apache.qpid.testutil.QpidTestCase.runBare(QpidTestCase.java:131)
- at junit.framework.TestResult$1.protect(TestResult.java:106)
- at junit.framework.TestResult.runProtected(TestResult.java:124)
- at junit.framework.TestResult.run(TestResult.java:109)
- at junit.framework.TestCase.run(TestCase.java:118)
- at org.apache.qpid.testutil.QpidTestCase.run(QpidTestCase.java:157)
- at junit.framework.TestSuite.runTest(TestSuite.java:208)
- at junit.framework.TestSuite.run(TestSuite.java:203)
- at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
- at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
- at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
- at java.lang.reflect.Method.invoke(Method.java:597)
- at org.apache.maven.surefire.junit.JUnitTestSet.execute(JUnitTestSet.java:210)
- at org.apache.maven.surefire.suite.AbstractDirectoryTestSuite.executeTestSet(AbstractDirectoryTestSuite.java:135)
- at org.apache.maven.surefire.suite.AbstractDirectoryTestSuite.execute(AbstractDirectoryTestSuite.java:122)
- at org.apache.maven.surefire.Surefire.run(Surefire.java:129)
- at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
- at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
- at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
- at java.lang.reflect.Method.invoke(Method.java:597)
- at org.apache.maven.surefire.booter.SurefireBooter.runSuitesInProcess(SurefireBooter.java:225)
- at org.apache.maven.surefire.booter.SurefireBooter.run(SurefireBooter.java:139)
- at org.apache.maven.plugin.surefire.SurefirePlugin.execute(SurefirePlugin.java:376)
- at org.apache.maven.plugin.DefaultPluginManager.executeMojo(DefaultPluginManager.java:443)
- at org.apache.maven.lifecycle.DefaultLifecycleExecutor.executeGoals(DefaultLifecycleExecutor.java:539)
- at org.apache.maven.lifecycle.DefaultLifecycleExecutor.executeGoalWithLifecycle(DefaultLifecycleExecutor.java:480)
- at org.apache.maven.lifecycle.DefaultLifecycleExecutor.executeGoal(DefaultLifecycleExecutor.java:459)
- at org.apache.maven.lifecycle.DefaultLifecycleExecutor.executeGoalAndHandleFailures(DefaultLifecycleExecutor.java:311)
- at org.apache.maven.lifecycle.DefaultLifecycleExecutor.executeTaskSegments(DefaultLifecycleExecutor.java:278)
- at org.apache.maven.lifecycle.DefaultLifecycleExecutor.execute(DefaultLifecycleExecutor.java:143)
- at org.apache.maven.DefaultMaven.doExecute(DefaultMaven.java:334)
- at org.apache.maven.DefaultMaven.execute(DefaultMaven.java:125)
- at org.apache.maven.cli.MavenCli.main(MavenCli.java:280)
- at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
- at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
- at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
- at java.lang.reflect.Method.invoke(Method.java:597)
- at org.codehaus.classworlds.Launcher.launchEnhanced(Launcher.java:315)
- at org.codehaus.classworlds.Launcher.launch(Launcher.java:255)
- at org.codehaus.classworlds.Launcher.mainWithExitCode(Launcher.java:430)
- at org.codehaus.classworlds.Launcher.main(Launcher.java:375)
-java.lang.NullPointerException
- at org.apache.qpid.client.handler.ClientMethodDispatcherImpl.newMethodDispatcher(ClientMethodDispatcherImpl.java:86)
- at org.apache.qpid.client.protocol.AMQProtocolSession.setStateManager(AMQProtocolSession.java:171)
- at org.apache.qpid.client.protocol.AMQProtocolHandler.setStateManager(AMQProtocolHandler.java:750)
- at org.apache.qpid.client.AMQConnection.<init>(AMQConnection.java:451)
- at org.apache.qpid.client.AMQConnection.<init>(AMQConnection.java:281)
- at org.apache.qpid.testutil.QpidTestCase.getConnection(QpidTestCase.java:339)
- at org.apache.qpid.test.unit.transacted.TransactedTest.setUp(TransactedTest.java:65)
- at junit.framework.TestCase.runBare(TestCase.java:125)
- at org.apache.qpid.testutil.QpidTestCase.runBare(QpidTestCase.java:131)
- at junit.framework.TestResult$1.protect(TestResult.java:106)
- at junit.framework.TestResult.runProtected(TestResult.java:124)
- at junit.framework.TestResult.run(TestResult.java:109)
- at junit.framework.TestCase.run(TestCase.java:118)
- at org.apache.qpid.testutil.QpidTestCase.run(QpidTestCase.java:157)
- at junit.framework.TestSuite.runTest(TestSuite.java:208)
- at junit.framework.TestSuite.run(TestSuite.java:203)
- at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
- at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
- at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
- at java.lang.reflect.Method.invoke(Method.java:597)
- at org.apache.maven.surefire.junit.JUnitTestSet.execute(JUnitTestSet.java:210)
- at org.apache.maven.surefire.suite.AbstractDirectoryTestSuite.executeTestSet(AbstractDirectoryTestSuite.java:135)
- at org.apache.maven.surefire.suite.AbstractDirectoryTestSuite.execute(AbstractDirectoryTestSuite.java:122)
- at org.apache.maven.surefire.Surefire.run(Surefire.java:129)
- at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
- at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
- at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
- at java.lang.reflect.Method.invoke(Method.java:597)
- at org.apache.maven.surefire.booter.SurefireBooter.runSuitesInProcess(SurefireBooter.java:225)
- at org.apache.maven.surefire.booter.SurefireBooter.run(SurefireBooter.java:139)
- at org.apache.maven.plugin.surefire.SurefirePlugin.execute(SurefirePlugin.java:376)
- at org.apache.maven.plugin.DefaultPluginManager.executeMojo(DefaultPluginManager.java:443)
- at org.apache.maven.lifecycle.DefaultLifecycleExecutor.executeGoals(DefaultLifecycleExecutor.java:539)
- at org.apache.maven.lifecycle.DefaultLifecycleExecutor.executeGoalWithLifecycle(DefaultLifecycleExecutor.java:480)
- at org.apache.maven.lifecycle.DefaultLifecycleExecutor.executeGoal(DefaultLifecycleExecutor.java:459)
- at org.apache.maven.lifecycle.DefaultLifecycleExecutor.executeGoalAndHandleFailures(DefaultLifecycleExecutor.java:311)
- at org.apache.maven.lifecycle.DefaultLifecycleExecutor.executeTaskSegments(DefaultLifecycleExecutor.java:278)
- at org.apache.maven.lifecycle.DefaultLifecycleExecutor.execute(DefaultLifecycleExecutor.java:143)
- at org.apache.maven.DefaultMaven.doExecute(DefaultMaven.java:334)
- at org.apache.maven.DefaultMaven.execute(DefaultMaven.java:125)
- at org.apache.maven.cli.MavenCli.main(MavenCli.java:280)
- at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
- at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
- at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
- at java.lang.reflect.Method.invoke(Method.java:597)
- at org.codehaus.classworlds.Launcher.launchEnhanced(Launcher.java:315)
- at org.codehaus.classworlds.Launcher.launch(Launcher.java:255)
- at org.codehaus.classworlds.Launcher.mainWithExitCode(Launcher.java:430)
- at org.codehaus.classworlds.Launcher.main(Launcher.java:375)
-java.lang.NullPointerException
- at org.apache.qpid.client.handler.ClientMethodDispatcherImpl.newMethodDispatcher(ClientMethodDispatcherImpl.java:86)
- at org.apache.qpid.client.protocol.AMQProtocolSession.setStateManager(AMQProtocolSession.java:171)
- at org.apache.qpid.client.protocol.AMQProtocolHandler.setStateManager(AMQProtocolHandler.java:750)
- at org.apache.qpid.client.AMQConnection.<init>(AMQConnection.java:451)
- at org.apache.qpid.client.AMQConnection.<init>(AMQConnection.java:281)
- at org.apache.qpid.testutil.QpidTestCase.getConnection(QpidTestCase.java:339)
- at org.apache.qpid.test.unit.transacted.TransactedTest.setUp(TransactedTest.java:65)
- at junit.framework.TestCase.runBare(TestCase.java:125)
- at org.apache.qpid.testutil.QpidTestCase.runBare(QpidTestCase.java:131)
- at junit.framework.TestResult$1.protect(TestResult.java:106)
- at junit.framework.TestResult.runProtected(TestResult.java:124)
- at junit.framework.TestResult.run(TestResult.java:109)
- at junit.framework.TestCase.run(TestCase.java:118)
- at org.apache.qpid.testutil.QpidTestCase.run(QpidTestCase.java:157)
- at junit.framework.TestSuite.runTest(TestSuite.java:208)
- at junit.framework.TestSuite.run(TestSuite.java:203)
- at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
- at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
- at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
- at java.lang.reflect.Method.invoke(Method.java:597)
- at org.apache.maven.surefire.junit.JUnitTestSet.execute(JUnitTestSet.java:210)
- at org.apache.maven.surefire.suite.AbstractDirectoryTestSuite.executeTestSet(AbstractDirectoryTestSuite.java:135)
- at org.apache.maven.surefire.suite.AbstractDirectoryTestSuite.execute(AbstractDirectoryTestSuite.java:122)
- at org.apache.maven.surefire.Surefire.run(Surefire.java:129)
- at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
- at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
- at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
- at java.lang.reflect.Method.invoke(Method.java:597)
- at org.apache.maven.surefire.booter.SurefireBooter.runSuitesInProcess(SurefireBooter.java:225)
- at org.apache.maven.surefire.booter.SurefireBooter.run(SurefireBooter.java:139)
- at org.apache.maven.plugin.surefire.SurefirePlugin.execute(SurefirePlugin.java:376)
- at org.apache.maven.plugin.DefaultPluginManager.executeMojo(DefaultPluginManager.java:443)
- at org.apache.maven.lifecycle.DefaultLifecycleExecutor.executeGoals(DefaultLifecycleExecutor.java:539)
- at org.apache.maven.lifecycle.DefaultLifecycleExecutor.executeGoalWithLifecycle(DefaultLifecycleExecutor.java:480)
- at org.apache.maven.lifecycle.DefaultLifecycleExecutor.executeGoal(DefaultLifecycleExecutor.java:459)
- at org.apache.maven.lifecycle.DefaultLifecycleExecutor.executeGoalAndHandleFailures(DefaultLifecycleExecutor.java:311)
- at org.apache.maven.lifecycle.DefaultLifecycleExecutor.executeTaskSegments(DefaultLifecycleExecutor.java:278)
- at org.apache.maven.lifecycle.DefaultLifecycleExecutor.execute(DefaultLifecycleExecutor.java:143)
- at org.apache.maven.DefaultMaven.doExecute(DefaultMaven.java:334)
- at org.apache.maven.DefaultMaven.execute(DefaultMaven.java:125)
- at org.apache.maven.cli.MavenCli.main(MavenCli.java:280)
- at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
- at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
- at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
- at java.lang.reflect.Method.invoke(Method.java:597)
- at org.codehaus.classworlds.Launcher.launchEnhanced(Launcher.java:315)
- at org.codehaus.classworlds.Launcher.launch(Launcher.java:255)
- at org.codehaus.classworlds.Launcher.mainWithExitCode(Launcher.java:430)
- at org.codehaus.classworlds.Launcher.main(Launcher.java:375)
-Tests run: 3, Failures: 0, Errors: 3, Skipped: 0, Time elapsed: 0.031 sec <<< FAILURE!
-Running org.apache.qpid.test.unit.client.channelclose.CloseWithBlockingReceiveTest
-Tests run: 1, Failures: 0, Errors: 1, Skipped: 0, Time elapsed: 0 sec <<< FAILURE!
-Running org.apache.qpid.test.unit.basic.PubSubTwoConnectionTest
-Tests run: 1, Failures: 0, Errors: 1, Skipped: 0, Time elapsed: 0.016 sec <<< FAILURE!
-Running org.apache.qpid.test.unit.basic.SelectorTest
-Tests run: 2, Failures: 0, Errors: 2, Skipped: 0, Time elapsed: 0.016 sec <<< FAILURE!
-Running org.apache.qpid.test.unit.topic.DurableSubscriptionTest
-Tests run: 4, Failures: 0, Errors: 4, Skipped: 0, Time elapsed: 0.015 sec <<< FAILURE!
-Running org.apache.qpid.test.unit.client.message.BytesMessageTest
-Tests run: 31, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.047 sec
-Running org.apache.qpid.test.unit.client.message.TextMessageTest
-Tests run: 16, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.047 sec
-Running org.apache.qpid.test.unit.xa.TopicTest
-Tests run: 7, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0 sec
-Running org.apache.qpid.test.unit.client.message.StreamMessageTest
-Tests run: 33, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.031 sec
-Running org.apache.qpid.test.unit.client.connection.ConnectionCloseTest
-Tests run: 1, Failures: 0, Errors: 1, Skipped: 0, Time elapsed: 0 sec <<< FAILURE!
-Running org.apache.qpid.test.unit.close.TopicPublisherCloseTest
-Tests run: 1, Failures: 0, Errors: 1, Skipped: 0, Time elapsed: 0 sec <<< FAILURE!
-Running org.apache.qpid.test.unit.client.AMQConnectionTest
-Tests run: 9, Failures: 0, Errors: 9, Skipped: 0, Time elapsed: 0.032 sec <<< FAILURE!
-Running org.apache.qpid.test.unit.client.temporaryqueue.TemporaryQueueTest
-Tests run: 1, Failures: 0, Errors: 1, Skipped: 0, Time elapsed: 0 sec <<< FAILURE!
-Running org.apache.qpid.test.unit.message.JMSDestinationTest
-Tests run: 1, Failures: 0, Errors: 1, Skipped: 0, Time elapsed: 0 sec <<< FAILURE!
-Running org.apache.qpid.test.unit.client.connection.ExceptionListenerTest
-Tests run: 1, Failures: 0, Errors: 1, Skipped: 0, Time elapsed: 0.015 sec <<< FAILURE!
-Running org.apache.qpid.client.message.TestMessageHelper
-Tests run: 0, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.016 sec
-Running org.apache.qpid.test.unit.basic.MapMessageTest
-Tests run: 1, Failures: 1, Errors: 0, Skipped: 0, Time elapsed: 0.016 sec <<< FAILURE!
-Running org.apache.qpid.test.unit.client.connection.ConnectionTest
-Tests run: 8, Failures: 0, Errors: 8, Skipped: 0, Time elapsed: 0.563 sec <<< FAILURE!
-Running org.apache.qpid.test.unit.message.MessageConverterTest
-Tests run: 4, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.032 sec
-Running org.apache.qpid.test.unit.basic.SessionStartTest
-[INFO] ------------------------------------------------------------------------
-[ERROR] BUILD ERROR
-[INFO] ------------------------------------------------------------------------
-[INFO] org.apache.qpid.test.unit.basic.SessionStartTest; nested exception is java.lang.reflect.UndeclaredThrowableException: null; nested exception is org.apache.maven.surefire.testset.TestSetFailedException: org.apache.qpid.test.unit.basic.SessionStartTest; nested exception is java.lang.reflect.UndeclaredThrowableException: null - -org.apache.qpid.testutil.VMBrokerSetup.getName()
-[INFO] ------------------------------------------------------------------------
-[INFO] For more information, run Maven with the -e switch
-[INFO] ------------------------------------------------------------------------
-[INFO] Total time: 45 seconds
-[INFO] Finished at: Thu Apr 17 15:48:37 BST 2008
-[INFO] Final Memory: 12M/26M
-[INFO] ------------------------------------------------------------------------
diff --git a/content/xdocs/Distributed Testing.html b/content/xdocs/Distributed Testing.html deleted file mode 100755 index 8afb7d5ec4..0000000000 --- a/content/xdocs/Distributed Testing.html +++ /dev/null @@ -1,379 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Distributed Testing</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Distributed Testing - </span> - </div> - <div class="pagesubheading"> - This page last changed on Aug 15, 2007 by <font color="#0050B2">rupertlssmith</font>. - </div> - - <h1><a name="DistributedTesting-TestingProposal."></a>Testing Proposal.</h1> - -<h2><a name="DistributedTesting-UseCases."></a>Use Cases.</h2> - -<p>The following usage scenarios are covered by this test framework design proposal:</p> - -<h3><a name="DistributedTesting-PerformanceTesting."></a>Performance Testing.</h3> - -<ul> - <li>Distributed testing.</li> -</ul> - - -<p> Want to be able to distribute performance tests accross many machines in parallel, in order to more accurately simulate real usage scenarios and to be able to fully stress test the broker under load.<br/> - Want to be able to run performance tests, with the test parameters configurable, so that any reasonable toplogy can be simulated and performance estimated.</p> - -<p> For example:</p> - -<ol> - <li>P2P test. On 10 machines, simulating load of 1000 clients. Each machine will run 100 test circuits on 100 connections. Both ends of the test circuit will reside on the same machine, with each client consuming its own messages. Results over all machines to be collated to arrive at total throughput figures.</li> - <li>Pub/Sub test. On 10 machines, simulating load of 1000 subscribers, 1 publisher. One machine acts as the sending half of the test circuit. The 1000 subscriber nodes, the receiving end of the circuit, are distributed as evenly as possible accross the other 9 machines. The publisher sends messages and collates throughput or latency measurements on the test circuit.</li> -</ol> - - -<h3><a name="DistributedTesting-SystemTesting."></a>System Testing.</h3> - -<ul> - <li>Thorough testing.</li> - <li>Functional testing at the product surface; behavioural tests to carry forward as the system evolves.</li> -</ul> - - -<p> Configurable framework, capable of exercising every imaginable combination of options, both in-vm broker and standalone, accross one client/test circuit up to many clients/test circuits in parallel.<br/> - Want to be able to exercise as many different combinations of test configuration parameters in possible in order to generate to the most comprehensive testing of the broker and protocol as possible. Exhaustive testing of every combination will discover bugs.<br/> - Want to test the system behaviour at its surface. That is, through the JMS API or through a more direct AMQ API where necessary. The test framework will ideally, abstract out the exact details of the API used, in order to allow forward evolution of the AMQ API. <br/> - Want to be able to set up each producer or consumer in a test circuit identically by default. More specific tests to be able to produce variations on this theme to test specific scenarios. For example test circuits the send both persistent and transient messages etc.</p> - -<h2><a name="DistributedTesting-Buildtestsoutofastandardizedconstructionblock."></a>Build tests out of a standardized construction block.</h2> - -<ul> - <li>Diagram: The test circuit.</li> -</ul> - - -<p>Publisher/Receiver pair.<br/> -Each end of which is a Producer/Consumer unit.<br/> - M producers, N consumers, talking over Z destinations.</p> - -<p> The standard consruction block for a test, is a test circuit. This consists of a publisher, and a receiver. The publisher and receiver may reside on the same machine, or may be distributed. Will use a standard set of properties to define the desired circuit topology.</p> - -<p> Tests are always to be controlled from the publishing side only. The receiving end of the circuit is to be exposed to the test code through an interface, that abstracts as much as possible the receiving end of the test. The interface exposes a set of 'assertions' that may be applied to the receiving end of the test circuit.</p> - -<p> In the case where the receiving end of the circuit resides on the same JVM, the assertions will call the receivers code locally. Where the receiving end is distributed accross one or more machines, the assertions will be applied to a test report gethered from all of the receivers. Test code will be written to the assertions making as few assumptions as possible about the exact test topology.</p> - -<p> A test circuit defines a test topology, M producers, N consumers, Z outgoing routes between them.<br/> - The publishing end of each test circuit always resides on a single JVM, even if M > 1. If publishers are to be distributed accross many machines, the test framework itself provides the scaling by running the same test circuit many times in parallel. This means that it is possible to have an arbitrary number of message publishers accross one or many machines, determined by the test setup.<br/> - The receiving half of the circuit may be local, in which case all messages come back to the same machine, or distributed in which case they may be received by many machines.<br/> - There are therefore two ways in which tests may be distributed accross multiple nodes in a network; many test circuits may be distributed and run in parallel and/or the receiving ends of those circuits may be distributed or local.<br/> - Each node in the network can play up to 2 roles in any given test; publisher or receiver. It is possible to play both roles at once, but would like to have a 'single_role' flag, that can be set to ensure that test nodes taking one role, will not participate in the other for the duration of a test. For example, in the pub/sub test want one publisher and the remaining nodes to distribute the receiver role amongst themselves.</p> - -<h2><a name="DistributedTesting-Probingfortheavailabletesttopology."></a>Probing for the available test topology.</h2> - -<ul> - <li>Diagram: The available topology.</li> -</ul> - - -<p> When the test distribution framework starts up, it should broadcast an 'enlist' request on a known topic. All available nodes in the network to reply in order to make it known that they are available to carry out tests. For the requested test case, C test circuits are to be run in parallel. Each test defines its desired M by N topology for each circuit. The entire network may be available to run both roles, or the test case may have specified a limit on the number of publishing nodes and set the 'single_role' flag. If the number of publishing nodes exhausts the available network and the single role flag is on, then there are no nodes available to run the receiver roles, the test will fail with an error at this point. Suppose there are P nodes available to run the publisher roles, and R nodes available to run the receiver roles. The C test circuits will be divided up as evenly as possible amongst the P nodes. The C * N receivers will be divided up as evenly as possible amongst the R nodes.</p> - -<p> A more concrete example. There are 10 test machines available. Want to run a pub/sub test with 2 publishers, publishing to 50 topics, with 250 subscribers, measuring total throughput. The distribution framework probes to find the ten machines. The test parameters specify a concurrency level of 2 circuits, limited to 2 nodes, with the single role flag set, which leaves 8 nodes to play the receiver role. The test parameters specify each circuit as having 25 topics, unique to the circuit, and 125 receivers. The total of 250 receivers are distributed amongst the 8 available nodes, 31 each, except for two of them which get 32. The test specifies a duration of 10 minutes, sending messages 500 bytes in size using test batches of 10000 messages, as fast as possible. The distribution framework sends a start signal to each of the publishers. The publishers run for 10000 messages. The publishers request a report from each receiver on their cicruit. The receivers send back to the publishers a report on the number of messages received in the batch. The publishers assert that the correct number for the batch were indeed received, and log a time sample for the batch. This continues for 10 minutes. At the end of the 10 minutes, the publishers collate all of their timings, failures, errors into a log message. The distribution framework requests the test report from each publishing nodes, and these logs are combined together to produce a single log for the entire run. Some stats, such as total time taken, total messages through the system, total throughput are calculated and added as a summary to the log, along with a record of the requested and actual topology used to run the test.</p> - -<ul> - <li>Diagram: The requested test applied onto the available topology.</li> -</ul> - - -<h2><a name="DistributedTesting-TestProcedures."></a>Test Procedures.</h2> - -<p>A variety of different tests can be written against a standard test circuit, many of these will follow a common pattern. One of the aims of using a common test circuit configured by a number of test parameters, is to be able to automate the generation of all possible test cases that can be produced from the circuit combined with the common testing pattern, and an outline of a procedure for doing this is described here. The typical test sequence is described below:</p> - -<h3><a name="DistributedTesting-Atypicaltestsequence."></a>A typical test sequence.</h3> - -<ol> - <li>Initialize the test circuit from the default parameters, plus specific settings for the test.</li> - <li>Create the test circuit. The requested test parameters are applied to the available topology to produce a live circuit.</li> - <li>Send messages.</li> - <li>Request a status report.</li> - <li>Assert conditions on the publishing end of the circuit.</li> - <li>Assert conditions on the receiving end of the circuit.</li> - <li>Pass or fail the test.</li> -</ol> - - -<h3><a name="DistributedTesting-Thethoroughtestprocedure."></a>The thorough test procedure.</h3> - -<p>The thorough test procedure uses the typical test sequence described above, but generates all of combinations of test parameters and corresponding assertions against the results.</p> - -<p>The all_combinations function produces all combinations of test parameters described in Appendix A.</p> - -<p>all_combinations : List<Properties></p> - -<p>The expected_results function, produces a list of assertions, given a set of test parameters. For example, mandatory && no_route -> assertions.add(producer.assertMessageReturned), assertions.add(receiver.assertMessageNotReceived).</p> - -<p>expected_results: Properties -> List<Assertions></p> - -<p>For parameters : all_combinations<br/> - test_circuit = new TestCircuit(parameters).<br/> - test_circuit.start.</p> - -<p> Send mesages.<br/> - Request status.</p> - -<p> For assertion : exected_results(parameters)<br/> - Assert(assertion).</p> - -<h2><a name="DistributedTesting-AppendixATestParameters."></a>Appendix A - Test Parameters.</h2> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'> </th> -<td class='confluenceTd'> Possible Values </td> -<td class='confluenceTd'> Default Value </td> -</tr> -<tr> -<th class='confluenceTh'> Connection properties. </th> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> broker </td> -<td class='confluenceTd'> tcp, vm </td> -<td class='confluenceTd'> tcp://localhost </td> -</tr> -<tr> -<td class='confluenceTd'> vhost </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> <empty> </td> -</tr> -<tr> -<td class='confluenceTd'> username </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> guest </td> -</tr> -<tr> -<td class='confluenceTd'> password </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> guest </td> -</tr> -<tr> -<th class='confluenceTh'> Topology properties. </th> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> max_publishing_node </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> 1 </td> -</tr> -<tr> -<td class='confluenceTd'> single_role </td> -<td class='confluenceTd'> true, false </td> -<td class='confluenceTd'> true </td> -</tr> -<tr> -<th class='confluenceTh'> Circuit properties. </th> -<td class='confluenceTd'> Total: 2^2 = 4 combinations. </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> num_publishers </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> 1 </td> -</tr> -<tr> -<td class='confluenceTd'> num_consumers </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> 1 </td> -</tr> -<tr> -<td class='confluenceTd'> num_destinations </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> 1 </td> -</tr> -<tr> -<td class='confluenceTd'> base_out_route_name </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> ping </td> -</tr> -<tr> -<td class='confluenceTd'> base_in_route_name </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> pong </td> -</tr> -<tr> -<td class='confluenceTd'> bind_out_route </td> -<td class='confluenceTd'> true, false </td> -<td class='confluenceTd'> true </td> -</tr> -<tr> -<td class='confluenceTd'> bind_in_route </td> -<td class='confluenceTd'> true, false </td> -<td class='confluenceTd'> false </td> -</tr> -<tr> -<td class='confluenceTd'> consumer_out_active </td> -<td class='confluenceTd'> true, false </td> -<td class='confluenceTd'> true </td> -</tr> -<tr> -<td class='confluenceTd'> consumer_in_active </td> -<td class='confluenceTd'> true, false </td> -<td class='confluenceTd'> false </td> -</tr> -<tr> -<th class='confluenceTh'> JMS flags and options. </th> -<td class='confluenceTd'> Total: 2 * 2 * 2 * 6 = 48 combinations. </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> transactional </td> -<td class='confluenceTd'> true, false </td> -<td class='confluenceTd'> false </td> -</tr> -<tr> -<td class='confluenceTd'> persistent </td> -<td class='confluenceTd'> true, false </td> -<td class='confluenceTd'> false </td> -</tr> -<tr> -<td class='confluenceTd'> no_local </td> -<td class='confluenceTd'> true, false </td> -<td class='confluenceTd'> false </td> -</tr> -<tr> -<td class='confluenceTd'> ack_mode </td> -<td class='confluenceTd'> tx, auto, client, dups_ok, no_ack, pre_ack </td> -<td class='confluenceTd'> auto </td> -</tr> -<tr> -<th class='confluenceTh'> AMQP/Qpid flags and options. </th> -<td class='confluenceTd'> Total: 2^4 = 16 combinations. </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> exclusive </td> -<td class='confluenceTd'> true, false </td> -<td class='confluenceTd'> false </td> -</tr> -<tr> -<td class='confluenceTd'> immediate </td> -<td class='confluenceTd'> true, false </td> -<td class='confluenceTd'> false </td> -</tr> -<tr> -<td class='confluenceTd'> mandatory </td> -<td class='confluenceTd'> true, false </td> -<td class='confluenceTd'> false </td> -</tr> -<tr> -<td class='confluenceTd'> durable </td> -<td class='confluenceTd'> true, false </td> -<td class='confluenceTd'> false </td> -</tr> -<tr> -<td class='confluenceTd'> prefetch_size </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> header_fields </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<th class='confluenceTh'> Standard test parameters. </th> -<td class='confluenceTd'> Total: 3 combinations. </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> message_size </td> -<td class='confluenceTd'> no_body, one_body, multi_body </td> -<td class='confluenceTd'> one_body </td> -</tr> -<tr> -<td class='confluenceTd'> num_messages </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> 100 </td> -</tr> -<tr> -<td class='confluenceTd'> outgoing_rate </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> inbound_rate </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> timeout </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> 30 seconds </td> -</tr> -<tr> -<td class='confluenceTd'> tx_batch_size </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> 100 </td> -</tr> -<tr> -<td class='confluenceTd'> max_pending_data </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> </td> -</tr> -</tbody></table> - -<p>Total combinations over all test parameters: 4 * 48 * 16 * 3 = 9216 combinations.</p> - -<p>Defaults give an in-VM broker, 1:1 P2P topology, no tx, auto ack, no flags, publisher -> receiver route configured, no return route.</p> - -<h2><a name="DistributedTesting-AppendixBClockSynchronizationAlgorithm."></a>Appendix B - Clock Synchronization Algorithm.</h2> - -<p>On connection/initialization of the framework, synch clocks between all nodes in the available toplogy. For in vm tests, the clock delta and error will automatically be zero. For throughput measurements, the overall test times will be long enough that the error does not need to be particularly small. For latency measurements, want to get accurate clock synchronization. This should not be too hard to achieve over a quiet local network.</p> - -<p>After determining the list of clients available to conduct tests against, the Coordinator synchronizes the clocks of each in turn. The synchronization is done against one client at a time, at a fairly low messaging rate over the Qpid broker. If needed, a more accurate mechanism, using something like NTP over UDP could be used. Ensure the clock synchronization is captured by an interface, to allow better solutions to be added at a later date. Here is a simple algorithm to get started with:</p> - -<ol> - <li>Coordinator tells client to synchronize its clock with the coordinators time.</li> - <li>Client stamps current local time on a "time request" message and sends to Coordinator.</li> - <li>Upon receipt by Coordinator, Coordinator stamps Coordinator-time and returns.</li> - <li>Upon receipt by Client, Client subtracts current time from sent time and divides by two to compute latency. It subtracts current time from Coordinator time to determine Client-Coordinator time delta and adds in the half-latency to get the correct clock delta.</li> - <li>The first result should immediately be used to update the clock since it will get the local clock into at least the right ballpark.</li> - <li>The Client repeats steps 1 through 3, 25 or more times, pausing a few tens of milliseconds each time.</li> - <li>The results of the packet receipts are accumulated and sorted in lowest-latency to highest-latency order. The median latency is determined by picking the mid-point sample from this ordered list.</li> - <li>All samples above approximately 1 standard-deviation from the median are discarded and the remaining samples are averaged using an arithmetic mean.</li> -</ol> - - -<p>The above algorithm includes broker latency, two network hops each way, plus possible effects of buffering/resends on the TCP protocol. A fairly easy improvement on it might be:</p> - -<ol> - <li>Coordinator tells client to synchronize its clock with the coordinators time, provides a port/address to synchronize against.</li> - <li>Clients sends UDP packets to the Coordinators address and performs the same procedure as outlined above.</li> -</ol> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Download.html b/content/xdocs/Download.html deleted file mode 100755 index beb1372e2b..0000000000 --- a/content/xdocs/Download.html +++ /dev/null @@ -1,84 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Download</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Download - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 14, 2008 by <font color="#0050B2">aidan</font>. - </div> - - <h3><a name="Download-Introductiontoreleases%3A"></a>Introduction to releases:</h3> - -<p>Qpid implements the AMQP Specification, and as the specification has progressed Qpid is keeping up with the updates. This means that different Qpid versions support different versions of AMQP. Here is a simple guide on what use.</p> - -<ul> - <li>M1 Release is our first release and support AMQP 0-8. Not recommended anymore</li> - <li>M2.x Release supports AMQP 0-9. The use of these versions are recommended. – download below</li> - <li>Trunk (M3) supports AMQP 0-10 and some backwards compatibility with AMQP 0-9, the C++ Broker, Java, and Python Client support 0-10, The Java client support 0-9 & 0-10. Other clients and Java broker (will support both AMQP 0-9 and AMQP 0-10) to be updated. Recommended development tree, or running AMQP 0-10 – use svn <a href="Source Repository.html" title="Source Repository">Source Repository</a> or download a clean build <a href="http://rhm.et.redhat.com/download/" title="Visit page outside Confluence">cruisecontrol builds</a></li> -</ul> - - - -<h3><a name="Download-ProductionReleases"></a>Production Releases</h3> - -<p>These releases are well tested and appropriate for production use. M2 is the lastest IPMC ratfied release from Qpid.</p> - -<p>Full release: <a href="http://people.apache.org/dist/incubator/qpid/M2-incubating/" title="Visit page outside Confluence">http://people.apache.org/dist/incubator/qpid/M2-incubating/</a></p> - -<ul> - <li>Java <a href="http://people.apache.org/dist/incubator/qpid/M2-incubating/Java" title="Visit page outside Confluence">http://people.apache.org/dist/incubator/qpid/M2-incubating/Java</a></li> - <li>C++ <a href="http://people.apache.org/dist/incubator/qpid/M2-incubating/CPP" title="Visit page outside Confluence">http://people.apache.org/dist/incubator/qpid/M2-incubating/CPP</a></li> - <li>Python <a href="http://people.apache.org/dist/incubator/qpid/M2-incubating/Python" title="Visit page outside Confluence">http://people.apache.org/dist/incubator/qpid/M2-incubating/Python</a></li> - <li>C# (.NET) <a href="http://people.apache.org/dist/incubator/qpid/M2-incubating/DOTNET" title="Visit page outside Confluence">http://people.apache.org/dist/incubator/qpid/M2-incubating/DOTNET</a></li> - <li>Ruby <a href="http://people.apache.org/dist/incubator/qpid/M2-incubating/Ruby" title="Visit page outside Confluence">http://people.apache.org/dist/incubator/qpid/M2-incubating/Ruby</a></li> -</ul> - - -<p>If you have any questions please mail the user list <a href="mailto:qpid-user@incubator.apache.org" title="Send mail to user list">user list</a> </p> - - -<h3><a name="Download-DevelopmentReleases"></a>Development Releases</h3> - -<p>These releases are intended for testing and previewing new features. They have been tested and meet reasonable quality standards.</p> - -<p>As Qpid tracks AMQP working group public work aggressively it might be worth mailing the <a href="mailto:qpid-dev@incubator.apache.org" title="Send mail to dev list">dev list</a> to check the state of svn trunk and if you want to use that to understand the current compatibility matrix.</p> - -<p>RPMs for the builds of trunk that have passed all the tests get automatically posted and are available at <a href="http://rhm.et.redhat.com/download" title="Visit page outside Confluence">cruisecontrol</a></p> - -<p>Beta builds of M2.1 are available from <a href="http://people.apache.org/~aidan/qpid-M2.1-RC5/" title="Visit page outside Confluence">http://people.apache.org/~aidan/qpid-M2.1-RC5/</a></p> - -<h3><a name="Download-PreviousReleases"></a>Previous Releases</h3> - - -<p>The M1 release:<br/> -<a href="http://people.apache.org/dist/incubator/qpid/M1-incubating/" title="Visit page outside Confluence">http://people.apache.org/dist/incubator/qpid/M1-incubating/</a></p> - - - - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Example Classes.html b/content/xdocs/Example Classes.html deleted file mode 100755 index 055d085523..0000000000 --- a/content/xdocs/Example Classes.html +++ /dev/null @@ -1,119 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Example Classes</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Example Classes - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 06, 2007 by <font color="#0050B2">mmccorma</font>. - </div> - - <h2><a name="ExampleClasses-Overview"></a>Overview</h2> - -<p>Some example client code is provided to help you get started, using JNDI and JMS.</p> - -<h2><a name="ExampleClasses-Downloadingthesource"></a>Downloading the source</h2> - -<p>The source code for the example client classes being provided is contained in the example package which can be found in:</p> - -<p><a href="https://svn.apache.org/repos/asf/incubator/qpid/trunk/qpid/java/client/example/" title="Visit page outside Confluence">https://svn.apache.org/repos/asf/incubator/qpid/trunk/qpid/java/client/example/</a></p> - -<h2><a name="ExampleClasses-BuildingtheExamplesource"></a>Building the Example source</h2> - -<p>You can build the example source using Maven by simply typing 'mvn' in the example directory.</p> - -<h2><a name="ExampleClasses-Notesonthesourcepackage"></a>Notes on the source package</h2> - -<p>Note that if you wish to build the example client code from within your IDE you will need to add the following jars contained in the Qpid binary release into your classpath:</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre>qpid-client-<RELEASE>-incubating-<MILESTONE>.jar
-qpid-common-<RELEASE>-incubating-<MILESTONE>.jar
-geronimo-jms_1.1_spec-1.0.jar
-</pre> -</div></div> - -<p>At the time of writing, RELEASE is '1.0' and MILESTONE is 'M2-SNAPSHOT'.</p> - -<p><b>NB: At runtime, you'll need to put all the jars in the client/lib dir into your classpath along with these jars.</b></p> - -<p>The example packages classes currently use log4j for logging. You may instead wish to amend the logging and exception handling in line with your project standards.</p> - -<h2><a name="ExampleClasses-ClassOverview"></a>Class Overview</h2> - -<p>Essentially we have provided example client classes to act as a publisher and a subscriber for handling messages using AMQ, as far as possible via JMS.</p> - -<p>Contributions to the example classes are most welcome. Please send your classes to our qpid-dev mailing list.</p> - -<h3><a name="ExampleClasses-BasicClasses"></a>Basic Classes</h3> - -<p>This section outlines the classes that you're likely to find most useful.</p> - -<p><b>Publisher</b></p> - -<p>This class contains the methods for publishing messages to a queue, using the example.properties file to populate the initial context and provide an example queue and topic.</p> - -<p><b>FileMessageDispatcher</b></p> - -<p>This class provides a simple wrapper around the publisher for dispathcing messages from file input, providing a really easy way to get started publishing messages. So, first create some files you'd like to use as payload for your test messages.</p> - -<p>Then, you simply pass one argument to the FileMessageDispatcher class which is the path to your test message files. The dispatcher will then create a message from each file in the directory. You can opt to use the path to a single file as an alternative, in the same way.</p> - -<p><b>Subscriber</b></p> - -<p>This class acts as a consumer of messages sent to a queue.</p> - -<h3><a name="ExampleClasses-HelperClasses%2FExceptions"></a>Helper Classes/Exceptions</h3> - -<p>This section gives some additional information about helper classes in the example packages.</p> - -<p><b>MessageFactory</b></p> - -<p>This class constructs a message with payload from an input file provided and sets a property on the message using the filename.</p> - -<p><b>MessageFactoryException</b></p> - -<p>Exception thrown if a message cannot be created in the factory class.</p> - -<h3><a name="ExampleClasses-ExamplesUsingAMQPImmediateDeliveryFeature"></a>Examples Using AMQP Immediate Delivery Feature</h3> - -<p><b>MonitorMessageDispatcher</b></p> - -<p>This is an additional wrapper class to be run independently as the monitor which allows you to provide a heartbeat (set to 20 seconds intervals but can be changed at will) being consumed by the example subscriber. When we detect that the subscriber has stopped, you can opt to make a call to an application specific 'recovery process' by amending the exception handling in the main method when a UndeliveredMessageException is caught (marked by a TODO), or simply exit gracefully if appropriate.</p> - -<p><b>UndeliveredMessageException</b></p> - -<p>Thrown when the subscriber is not there to read the monitor traffic which has been marked as for immediate delivery.</p> - - - -<p><b>MonitoredSubscriber</b></p> - -<p>Subclass of the Subscriber which also reads messages from the monitor queue to let us know that it's consuming ok.</p> - -<p>The <b>shared</b> package contains utility classes for file manipulation etc and constants for general use (to reduce the maintenance overhead) which could perhaps be replaced with config properties as appropriate.</p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/FAQ.html b/content/xdocs/FAQ.html deleted file mode 100755 index 314f9041d0..0000000000 --- a/content/xdocs/FAQ.html +++ /dev/null @@ -1,79 +0,0 @@ -<html> - <head> - <title>Apache Qpid : FAQ</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : FAQ - </span> - </div> - <div class="pagesubheading"> - This page last changed on Jun 29, 2007 by <font color="#0050B2">ritchiem</font>. - </div> - - <script type='text/javascript'>//<![CDATA[ -function debug() { } -// ]]></script><script type='text/javascript' src='/confluence/download/resources/org.randombits.confluence.composition:composition-setup/js/browser.js'>//<![CDATA[ -// ]]></script><script type='text/javascript' src='/confluence/download/resources/org.randombits.confluence.composition:composition-setup/js/behaviour.js'>//<![CDATA[ -// ]]></script><script type='text/javascript' src='/confluence/download/resources/org.randombits.confluence.composition:composition-setup/js/memory.js'>//<![CDATA[ -// ]]></script><script type='text/javascript' src='/confluence/download/resources/org.randombits.confluence.composition:composition-setup/js/cloak.js'>//<![CDATA[ -// ]]></script><script type='text/javascript'>//<![CDATA[ -Cloak.closeHTML = "<img src=\'/confluence/download/resources/org.randombits.confluence.composition:toggle-cloak/img/navigate_down_10.gif\'/>"; -Cloak.openHTML = "<img src=\'/confluence/download/resources/org.randombits.confluence.composition:toggle-cloak/img/navigate_right_10.gif\'/>"; -Cloak.toggleZone = true; -Cloak.memoryDuration = 0; -Cloak.memoryPrefix = "contentId:60677"; -Cloak.memoryPath = "/confluence/"; -// ]]></script><style type='text/css'> -.cloakToggle { /* Definition for state toggling image */ -cursor:hand; -cursor:pointer; -} -</style><script type='text/javascript' src='/confluence/download/resources/org.randombits.confluence.composition:composition-setup/js/transitions.js'>//<![CDATA[ -// ]]></script><script type='text/javascript' src='/confluence/download/resources/org.randombits.confluence.composition:composition-setup/js/deck.js'>//<![CDATA[ -// ]]></script><link rel='stylesheet' type='text/css' href='/confluence/styles/main-action.css?pluginCompleteKey=org.randombits.confluence.composition:composition-setup&stylesheetName=deck&spaceKey=qpid'/><script type='text/javascript'>//<![CDATA[ -Deck.memoryDuration = 0; -Deck.memoryPrefix = "contentId:60677"; -Deck.memoryPath = "/confluence/"; -// ]]></script> - - - -<h2><a name="FAQ-Errors"></a>Errors</h2> - -<h3><a name="FAQ-Igetthefollowingerroronconnection%22ServerConnectionFailedReason%3AQpidserverconnectiontimedout%22%3F"></a><span id='tgl_content_q1' class='cloakToggle'></span> I get the following error on connection "Server Connection Failed Reason: Qpid server connection timed out" ?</h3> -<span id='content_q1' class='cloak' style='display: none'> -<p>There are two possibilities here:</p> - -<p>1) The management server is not running on the broker / the specified port check the <a href="Configure the Broker via config.xml.html" title="Configure the Broker via config.xml">XML Configuration</a> page for further details.</p> - -<p>2) The management server running using JMX connectivity but the console is trying to use SASL for connections. This is the <b>default</b> configuration of the <em>qpidmc.bat</em>. Either adjust the config to use SASL:</p> -<div class="preformatted"><div class="preformattedContent"> -<pre> <security-enabled>true</security-enabled>
-</pre> -</div></div> -<p>or remove the <em>-Dsecurity=CRAM-MD5</em> from the command line in <em>qpidmc.bat</em></p> - -</span> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/GSoC.html b/content/xdocs/GSoC.html deleted file mode 100755 index 93b22f1859..0000000000 --- a/content/xdocs/GSoC.html +++ /dev/null @@ -1,182 +0,0 @@ -<html> - <head> - <title>Apache Qpid : GSoC</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : GSoC - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 02, 2008 by <font color="#0050B2">mmccorma</font>. - </div> - - <h2><a name="GSoC-GSoCProjectsandwhoisdoingwhat%3A"></a>GSoC Projects and who is doing what: </h2> - - -<h3><a name="GSoC-QpidDemotwoprojects%28oneforAMQP09andoneforAMQP010%29"></a>Qpid Demo - two projects (one for AMQP 0-9 and one for AMQP 0-10)</h3> - -<p>Candidates: Senaka Fernando, Buddika Laknath</p> - -<p>Project Goal: Create a multi language Demo for Qpid, and use the demo as source to create the Qpid getting Started pages</p> - -<p>Mentor: Carl/Rajith </p> - -<p>Project Description: </p> - -<p> The Qpid project likes to have an enterprise grade demo that reflects the messaging capabilities of the AMQP (www.amqp.org) protocol that uses brokers written in Java and C++ and the clients written in Java/JMS, c++, python, ruby, .NET</p> - -<p>The Demo ca use any client server problem (like bank, stock, render farm, travel site etc) to illustrate the capabilities of the Qpid.</p> - - - - -<h3><a name="GSoC-AMQPmgmtBridgeJMX"></a>AMQP mgmt Bridge - JMX </h3> - -<p>Candidates: Le Duc Bao,Lahiru Gunathilaka</p> - -<p>Project Goal: Create a dynamic bridge from AMQP-mgmt protocol to JMX to facilitate std management console integration</p> - -<p>Mentor: Marnie/Aidan/Arnaud ?</p> - -<p>Project Description:</p> - -<p> Project is to create a process will receive management Data through the AMQP mgmt protocol and translate those into JMX. This will allow the C++ broker to also be hooked into a JMX allow for all the instrumentation data to be read from JMX, all the methods to be invoked, and the configuration to be updated through standard JMX consoles.</p> - -<p>Note that all the schema is dynamic, so the bridge need to configure itself at runtime, so this service should derive it's behavior from the schema provided to it.</p> - -<p>AMQP mgmt side protocol can be found here: <a href="http://cwiki.apache.org/qpid/management-design-notes.html" title="Visit page outside Confluence">http://cwiki.apache.org/qpid/management-design-notes.html</a></p> - -<p>To play with it, build the C++ broker<br/> -./bootstrap<br/> -./configure<br/> -make</p> - -<p>on linux, the to run the cmd line mgmt set the PYTHONPATH and run it from mgnt-cli</p> - -<p>You should pretty quickly see how the objects get dynamically build and how they are layed out, these can then quite simple be dynamically mapped to JMX. </p> - -<p>Implementation language is Java</p> - -<h3><a name="GSoC-AMQPmgmtBridgeWSDM"></a>AMQP mgmt Bridge - WS-DM</h3> - -<p>Candidates: Rahul Mehta</p> - -<p>Project Goal: Create a bridge between AMQP-JMX and WS-DM</p> - -<p>Mentor: Arnaud</p> - -<p>Project Description:</p> - -<p> Project is to to expose the AMQP JMX-instrumented applications (Java broker and JMX/C++ management bridge) using MS-DM interfaces. Referring to the JMX architecture, this mapping should be addressed through a JMX-WS-DM connector. This will allow any qpid broker to be hooked into industry standard management product line like BMC, Tivoli, etc.</p> - -<p>current qpid Java broker JMX can be found here: <a href="http://cwiki.apache.org/qpid/jmx-management-console.html" title="Visit page outside Confluence">http://cwiki.apache.org/qpid/jmx-management-console.html</a></p> - -<p>To play with it, you should build the Java broker</p> - -<p>Implementation language is Java. </p> - -<h3><a name="GSoC-JMXCli"></a>JMX Cli</h3> - -<p>Candidates: Lahiru Gunathilaka, Ruchira Wageesha </p> - -<p>Project Goal: Provide the ability to access Java Broker mgmt info from cmd line.</p> - -<p>Secondary Goal: Integrate with AMQP mgnt protocol ??</p> - -<p>Mentor: Adian/Marnie/Martin</p> - -<p>Project Description:</p> - -<p> Design and implement a simple solution, runnable from the command line, for extracting useful JMX information from the Qpid Java Broker. Solution should be configurable at runtime to allow users to decide which bits of info they're interested in and when. Might be nice to see the information extracted in a report format</p> - -<p>More info:</p> - -<p>Currently, the Qpid Java broker provides several JMX methods to all users/applications to extract information about queues etc on the broker. We have used this information for two purposes: exposing management details in the existing Eclipse RCP Management Console UI and also to provide alerting in the broker log when certain configurable thresholds are reached e.g. maximum queue size etc.</p> - -<p>However, some of our users have expressed an interest in being able to extract JMX information more simply i.e. without the constraints our existing confgurable alerting brings with it and also independently of the UI.</p> - -<p>Thus, an application which could be called from the command line on Windows, Unix (Solaris) and Linux would be invaluable for our user projects. </p> - -<p>Ideally this CLI would expose all the JMX calls in a simple wrapper and perhaps allow the user to dump the results to an XML file or a web page.</p> - -<p>This is not intended to be too heavily prescriptive and is really intended as a starter for ten !</p> - -<h3><a name="GSoC-Qpidjavabrokerconfig"></a>Qpid-java-broker-config</h3> - -<p>Candidates: Sachith Danushka.</p> - -<p>Project Goal: Rationalize the configuration in the Java Broker to get it more consistent</p> - -<p>Mentor: Adian/Marnie/Martin</p> - -<p>Project Description:</p> - -<p> Refactor Qpid Java Broker configuration into a more elegant xml schema, with xsd, covering all existing configuration options and allowing for extension. Additionally implement a module to validate broker configuration files, which could be run standalone i.e. before starting a broker, to check that they're well formed and validate against the xsd.</p> - -<p>More info:</p> - -<p>Currently the broker configuration for the Qpid Java Broker is a little untidy. There's the bulk of the core broker configuration, much of which the majority of our end users won't want to change much, in the default config.xml files that we ship. On top of that we have a set of properties for the virtualhosts (which includes the ability to define per host some queues which will always exist on broker startup etc) in a separate file. </p> - -<p>At the moment, if you edit the config.xml file you're using and accidentally damage or remove an important section the broker will blow up in an unexpected fashion. Creating an xsd and validating the config.xml at startup (probably as a switch on/off-able option !) would help to avoid this possibility. </p> - -<p>We could also provide more information about what the config file contains in a self-documenting way. I'd suggest we need to restructure the config set up too - the virtualhosts file is at the very least badly named, but probably not really fit for purpose. </p> - -<h3><a name="GSoC-qpidandroiddemo"></a>qpid-android-demo</h3> - -<p>Project Goal:<br/> -Implement a simple demo on Android using the Qpid client to send messages to and from a broker, such as stock price information and trade orders</p> - -<p>Contact person: Aidan Skinner <aidan AT apache DOT org></p> - -<p>Project Description:</p> - -<p> Android is hot, Qpid is hot, porting the Qpid client to Android and getting it to pull some information and publish some would be hot. </p> - -<h3><a name="GSoC-DBusoverQpid"></a>DBus over Qpid</h3> - -<p>Project Goal:<br/> -Implement an AMQP transport for DBus using Qpid.</p> - -<p>Contact Person: Aidan Skinner <aidan AT apache DOT org></p> - -<p>Project Description:<br/> - Running DBus over AMQP would allow some interesting use cases, such as home automation, automatic synchronisation and the like, turning it into a true network bus. </p> - -<p> You would need to be familiar with C, C++, Python or Java, and would ideally have experience working with disparate Free Software communities.</p> - - -<h3><a name="GSoC-ApacheDerbyDatastore"></a>Apache Derby Datastore</h3> - -<p>Project Goal:<br/> -Implement a datastore backed by Hibernate or Apache Derby</p> - -<p>Contact Person: Aidan Skinner <aidan AT apache DOT org></p> - -<p>Project Description:</p> - -<p> Create a persistent datastore for Qpid that uses JDBC to connect to a database and which uses Apache Derby as a default backend. Bonus points for implementing it using hibernate so it's easily portable across different databases.</p> - -<p> You would need to be familiar with Java, JDBC, Hibernate and SQL.</p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Getting Involved.html b/content/xdocs/Getting Involved.html deleted file mode 100755 index a8917d0cc3..0000000000 --- a/content/xdocs/Getting Involved.html +++ /dev/null @@ -1,80 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Getting Involved</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Getting Involved - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 11, 2008 by <font color="#0050B2">cctrieloff</font>. - </div> - - <h2><a name="GettingInvolved-TherearemanywaysyoucangetinvolvedinQpid%3A"></a>There are many ways you can get involved in Qpid:</h2> - -<p>1. Use Qpid and post us your feedback to <a href="mailto:qpid-dev@incubator.apache.org" title="Send mail to qpid-dev@incubator.apache.org">qpid-dev@incubator.apache.org</a><br/> -2. Participate on the <a href="Mailing Lists.html" title="Mailing Lists">mailing lists</a>.<br/> -3. Contibute via open JIRA <a href="http://issues.apache.org/jira/browse/qpid" title="Visit page outside Confluence">JIRA issues</a><br/> -4. Review the current code<br/> -5. Help write user documentation or wiki documentation<br/> -6. Help write user examples.</p> - -<p>Plesae be sure to take a look at the coding guidelines for the setcion of the project that you contribute to</p> - -<ul> - <li><a href="Java Coding Standards.html" title="Java Coding Standards">Java Coding Standards</a></li> - <li><a href="CppStyleGuide.html" title="CppStyleGuide">C++ Coding Standards</a></li> - <li><a href="CppTips.html" title="CppTips">C++ Tips</a></li> - <li><a href="OSVC.html" title="OSVC">OS version considerations</a></li> -</ul> - - -<h2><a name="GettingInvolved-SomeIdeastocontribute"></a>Some Ideas to contribute</h2> - -<p>Themes and JIRA's for our road map are located here <a href="RoadMap.html" title="roadmap">RoadMap</a> Please fell free to mail the dev list if you want to pick up any of these items on the project.</p> - - -<p>Google Summer of Code <a href="GSoC.html" title="GSoC">GSoC</a></p> - - -<h2><a name="GettingInvolved-Becomingacommitter%3A"></a>Becoming a committer:</h2> - -<p>Qpid uses the following guidelines for voting in new committers. First off we would like new committers to have provided meaningful contribution to the project. By contributions we include development (tests, features, examples) or documentation through patches and interactions with the project through lists and JIRA.</p> - -<p>The key question is what does the Qpid project consider to be a meaningful contribution to be come a committer. As this bar is set for all new commiters Qpid will be conservative in general with adding new committers.</p> - -<p>The Qpid project will look to see if someone consistently provides quality contributions and interactions with the project over a period or 1 to 2 months. Based on that the PPMC will vote the new committers onto the project. </p> - -<p>If you have any question please mail <a href="mailto:qpid-dev@incubator.apache.org" title="Send mail to qpid-dev@incubator.apache.org">qpid-dev@incubator.apache.org</a> or <a href="mailto:qpid-private@incubator.apache.org" title="Send mail to qpid-private@incubator.apache.org">qpid-private@incubator.apache.org</a> </p> - -<p>Many thanks for you interest,<br/> -the Qpid team.</p> - -<h2><a name="GettingInvolved-JoiningthePPMC"></a>Joining the PPMC</h2> - -<p>While we (Qpid) are still in the incubator, if you want to join the PPMC, once you have become a committer please just mail he qpid-private@i.a.o list and request to be added to the PPMC. Once we graduate this will be done with a vote buy the then action PMC.</p> - - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Getting Started Guide.html b/content/xdocs/Getting Started Guide.html deleted file mode 100755 index 11782603bd..0000000000 --- a/content/xdocs/Getting Started Guide.html +++ /dev/null @@ -1,250 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Getting Started Guide</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Getting Started Guide - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 22, 2008 by <font color="#0050B2">mmccorma</font>. - </div> - - <h1><a name="GettingStartedGuide-"></a><font color="#000000">Installing & Using Qpid (Java)</font></h1> - - -<h2><a name="GettingStartedGuide-Introduction"></a>Introduction</h2> - -<p>The information below details how to install and use the main Broker and Client packages.</p> - -<p>Essentially, to make use of the Qpid AMQP infrastructure you need to be able to run a broker instance to handle messaging traffic and talk to your client code. Your own application code will make use of the Qpid client package provided to interface with the broker.</p> - -<p>Related pages to get you going</p> - -<ul> - <li><a href="Qpid Troubleshooting Guide.html" title="Qpid Troubleshooting Guide">Troubleshooting Guide</a></li> - <li><a href="How to Use JNDI.html" title="How to Use JNDI">How to Use JNDI</a></li> - <li><a href="URL Formats.html" title="URL Formats">URL Formats for Qpid</a></li> - <li><a href="Example Classes.html" title="Example Classes">Example Classes</a></li> -</ul> - - -<p>Minor apologies since these instructions are heavily linux/unix focused. If you have difficulty using our .bat script (see below) please email qpid-users for assistance.</p> -<h3><a name="GettingStartedGuide-Prerequisites"></a>Prerequisites</h3> - -<p>The Qpid broker requires Java 5 or later to be available. For maximum performance Java 6 is recommended. Note that JDK 5 has a bug which may cause problems, so plase use versions later than 1.5.0_15 !</p> - -<p>The Java JMS client can be run using Java 1.4, 5 or 6. Note that the 1.4 client libraries come in a separate package.</p> - -<h2><a name="GettingStartedGuide-Downloading%26InstallingQpid"></a>Downloading & Installing Qpid</h2> - -<p>The latest binary and source distributions of Qpid Broker and Client packages are available from the <a href="Download.html" title="Download">downloads page</a>.</p> - -<p>If you want to use a newer version than an official release then you should check out the code from the <a href="Source Repository.html" title="Source Repository">Subversion repository</a> and then consult the <a href="Qpid Java Build How To.html" title="Qpid Java Build How To">Build How To</a> page.</p> - -<h3><a name="GettingStartedGuide-BrokerInstall"></a>Broker Install</h3> - -<p>Unpack the archive into any directory of your choice e.g c:/qpid</p> - -<p>Once unpacked, the package will be installed in a directory with a release label (i.e. qpid-1.0-incubating-M2) and the directories underneath should look something like this:</p> - -<p><b>/bin</b></p> - -<p>Contains various startup utilities:</p> - -<p><b>qpid-server</b> is a bash script which runs the broker on linux/unix. You should set the environment variable QPID_HOME to point at your install path e.g. C:/qpid/qpid-1.0-incubating-M2. This enables the startup script to find default config files in the installed etc directory.</p> - -<p><b>qpid-run</b> is a script which allows shell commands to be executed which the qpid-server script utilises.</p> - -<p><b>qpid-server.bat</b> is a dos script which runs the broker on Windows. See note above about QPID_HOME.</p> - -<p>The other scripts in this directory can be safely ignored for now.</p> - -<p><b>/lib</b></p> - -<p>Contains all the jars used by the broker, mainly in their own subdirectories.</p> - -<p>The <b>broker-launch.jar</b> contains a manifest file which puts the requisite jars into the classpath for broker startup.</p> - -<p>Other files & jars in here can be safely ignored for now.</p> - -<p><b>/etc</b></p> - -<p>Contains the config files used by the broker on startup.</p> - -<p><b>/client</b></p> - -<p>This comes with the broker package at the moment and contains the client package. The client can also be downloaded independently. See client section below for details.</p> - -<p><b>/doc</b></p> - -<p>Contains javadoc for the broker.</p> - -<p>If running on a unix or linux platform check that the appropriate permissions have been applied to the .sh scripts. If not, then update i.e. chmod 755 *.sh</p> - -<h2><a name="GettingStartedGuide-EnvironmentVariables"></a>Environment Variables</h2> - -<h3><a name="GettingStartedGuide-QpidLocations"></a>Qpid Locations</h3> - -<p>You should set the following variables:</p> - -<p><b>QPID_HOME</b> - specifies where your install of Qpid exists, used for broker lookups of files etc<br/> -<b>QPID_WORK</b> - defines location of all working files created by the broker including log and db (i.e. BDB if used)<br/> -<b>PATH</b> - ensure that the QPID_HOME/bin directory is added to your path so that the server scripts can run</p> - -<ol> - <li>First set the QPID_HOME variable to reflect the root of your installation. For example, if you have installed the broker package into a directory <homedir>/broker/qpid-xx then you should set the QPID_HOME variable to <homedir>/broker/qpid-xx.</li> - <li>You can also set the QPID_WORK variable in order to control the destination directory for the log dir into which broker logging is generated. For example, if you wish to set the working directory to be <homedir>/working you should set the QPID_WORK directory to be <homedir>/working. Note that the QPID_WORK variable defaults to the current user's home directory if not set.</li> - <li>Then set your PATH variable appropriately to include the bin dir</li> -</ol> - - -<h3><a name="GettingStartedGuide-SettingJAVAenvironment"></a>Setting JAVA environment</h3> - -<p>You must make the JDK available available by setting the JAVA_HOME environment variable and adding the JAVA_HOME/bin directory to your PATH.</p> - -<p>You should use JDK 1.6, or at least a version later than 1.5_15.</p> - -<p>For example, if you have installed the JDK in /home/jdk1.6 then:<br/> -JAVA_HOME should be set to /home/jdk1.6<br/> -PATH should include /home/jdk1.6/bin</p> - -<p>To check that you have completed this change successfully, simply type</p> - -<p>java -version</p> - -<p>You should see something like</p> - -<p>java version "1.6.0_02"<br/> -Java(TM) SE Runtime Environment (build 1.6.0_02-b06)<br/> -Java HotSpot(TM) Server VM (build 1.6.0_02-b06, mixed mode)</p> - -<p>The Qpid scripts set the classpath and other flags required for the broker to run.</p> - -<h2><a name="GettingStartedGuide-Configuration"></a>Configuration</h2> - -<p>We ship two example configuration files with the Java broker:</p> - -<p><b>persistent_confg.xml</b> - when you want to use any persistent messages with the Qpid broker (currently with BDB)<br/> -<b>transient_config.xml</b> - for transient messaging only</p> - -<p>You can simply use one of these config files to get started, using the -c option to specify to the qpid-server script. See details next in the next section for more info on command line options.</p> - -<p>Please visit our <a href="3rd Party Libraries.html" title="3rd Party Libraries">3rd Party Libraries</a> page to get more generic information on how to set up your chosen persistence implementation for Qpid.</p> - -<h2><a name="GettingStartedGuide-RunningtheQpidBroker"></a>Running the Qpid Broker</h2> - -<p>There are scripts provided to run the broker on Windows and on Linux/Unix.</p> - -<h3><a name="GettingStartedGuide-RunningtheQpidBrokeronLinux%2FUnix"></a>Running the Qpid Broker on Linux/Unix</h3> - -<ul> - <li>Make sure you have set the QPID_HOME variable as specified above, and QPID_WORK if you don't want the default</li> - <li>One of the config files (persistent_config.xml or transient_config.xml) supplied in the etc directory one level below your root dir probably doesn't need modification and should be passed in using -c and the path to your config file</li> - <li>Then run the qpid-server script from the root dir of your install. (The qpid-server script also supports cygwin environments.)</li> -</ul> - - -<h3><a name="GettingStartedGuide-CommandLineArguments"></a>Command Line Arguments</h3> -<p>You can get a list of all command line arguments by using the -h argument.</p> - -<p>The following command line options are available:</p> -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'> Option </th> -<th class='confluenceTh'> Long Option </th> -<th class='confluenceTh'> Description </th> -</tr> -<tr> -<td class='confluenceTd'> b </td> -<td class='confluenceTd'> bind </td> -<td class='confluenceTd'> Bind to the specified address overriding any value in the config file </td> -</tr> -<tr> -<td class='confluenceTd'> c </td> -<td class='confluenceTd'> config </td> -<td class='confluenceTd'> Use the given configuration file </td> -</tr> -<tr> -<td class='confluenceTd'> h </td> -<td class='confluenceTd'> help </td> -<td class='confluenceTd'> Prints list of options </td> -</tr> -<tr> -<td class='confluenceTd'> l </td> -<td class='confluenceTd'> logconfig </td> -<td class='confluenceTd'> Use the specified log4j.xml file rather than that in the etc directory </td> -</tr> -<tr> -<td class='confluenceTd'> p </td> -<td class='confluenceTd'> port </td> -<td class='confluenceTd'> Specify port to listen on. Overrides value in config file </td> -</tr> -<tr> -<td class='confluenceTd'> v </td> -<td class='confluenceTd'> version </td> -<td class='confluenceTd'> Print version information and exit </td> -</tr> -<tr> -<td class='confluenceTd'> w </td> -<td class='confluenceTd'> logwatch </td> -<td class='confluenceTd'> Specify interval for checking for logging config changes. Zero means no checking </td> -</tr> -</tbody></table> - -<p>For more detailed information on configuration, please see <a href="Qpid Design - Configuration.html" title="Qpid Design - Configuration">Qpid Design - Configuration</a></p> - -<h4><a name="GettingStartedGuide-Checkingthebrokerhasstartedup"></a>Checking the broker has started up</h4> - -<p>You can check that the broker has started up successfully by viewing the output it sends to stdout and looking for the start up port info:<br/> -2006-07-06 09:18:24,264 INFO [main] server.Main (Main.java:181) - Starting Qpid.AMQP broker<br/> -2006-07-06 09:18:24,331 INFO [main] server.Main (Main.java:251) - Qpid.AMQP listening on non-SSL address 0.0.0.0/0.0.0.0:5672</p> - -<p>Note that you may have to edit the log4j.xml in the /etc directory to add an appender for the server.Main class to see loggeds output like this on startup.</p> - -<h3><a name="GettingStartedGuide-RunningtheQpidBrokeronWindows"></a>Running the Qpid Broker on Windows</h3> - -<p>Simply set the QPID_HOME variable and run the .bat script. All other details as identical to running on Linux/Unix.</p> - -<p>So for example:<br/> -qpid-server.bat</p> - -<h2><a name="GettingStartedGuide-GettingHelp"></a>Getting Help</h2> - -<p>You can view our <a href="Qpid Java FAQ.html" title="Qpid Java FAQ">FAQ</a> and <a href="Qpid Troubleshooting Guide.html" title="Qpid Troubleshooting Guide">Troubleshooting Guide</a> for assistance. If you can't find the information that you need there, then email our qpid users list</p> - - <br/> - <div class="tabletitle"> - <a name="attachments">Attachments:</a> - </div> - - <div class="greybox" align="left"> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="Getting Started Guide_attachments/set_classpath.bat">set_classpath.bat</a> (application/octet-stream) - <br/> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="Getting Started Guide_attachments/set_classpath.sh">set_classpath.sh</a> (application/octet-stream) - <br/> - </div> - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Getting Started Guide_attachments/set_classpath.bat b/content/xdocs/Getting Started Guide_attachments/set_classpath.bat deleted file mode 100755 index d528967024..0000000000 --- a/content/xdocs/Getting Started Guide_attachments/set_classpath.bat +++ /dev/null @@ -1,50 +0,0 @@ -@REM Licensed to the Apache Software Foundation (ASF) under one
-@REM or more contributor license agreements. See the NOTICE file
-@REM distributed with this work for additional information
-@REM regarding copyright ownership. The ASF licenses this file
-@REM to you under the Apache License, Version 2.0 (the
-@REM "License"); you may not use this file except in compliance
-@REM with the License. You may obtain a copy of the License at
-@REM
-@REM http://www.apache.org/licenses/LICENSE-2.0
-@REM
-@REM Unless required by applicable law or agreed to in writing,
-@REM software distributed under the License is distributed on an
-@REM "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-@REM KIND, either express or implied. See the License for the
-@REM specific language governing permissions and limitations
-@REM under the License.
-
-@REM Helper script to set classpath for running Qpid example classes
-@REM NB: You must add the Qpid client and common jars to your CLASSPATH
-@REM before running this script
-
-@echo off
-
-if "%QPID_HOME%" == "" GOTO ERROR_QPID_HOME
-
-set QPIDLIB=%QPID_HOME%\lib
-
-if "%CLASSPATH%" == "" GOTO ERROR_CLASSPATH
-
-set CLASSPATH=%CLASSPATH%;%QPIDLIB%\backport-util-concurrent-2.2.jar
-set CLASSPATH=%CLASSPATH%;%QPIDLIB%\geronimo-jms_1.1_spec-1.0.jar
-set CLASSPATH=%CLASSPATH%;%QPIDLIB%\commons-collections-3.1.jar
-set CLASSPATH=%CLASSPATH%;%QPIDLIB%\commons-configuration-1.2.jar
-set CLASSPATH=%CLASSPATH%;%QPIDLIB%\commons-cli-1.0.jar
-set CLASSPATH=%CLASSPATH%;%QPIDLIB%\commons-lang-2.1.jar
-set CLASSPATH=%CLASSPATH%;%QPIDLIB%\commons-logging-api-1.0.4.jar
-set CLASSPATH=%CLASSPATH%;%QPIDLIB%\commons-logging-1.0.jar
-set CLASSPATH=%CLASSPATH%;%QPIDLIB%\log4j-1.2.12.jar
-set CLASSPATH=%CLASSPATH%;%QPIDLIB%\mina-core-1.0.0.jar
-set CLASSPATH=%CLASSPATH%;%QPIDLIB%\mina-filter-ssl-1.0.0.jar
-set CLASSPATH=%CLASSPATH%;%QPIDLIB%\mina-java5-1.0.0.jar
-set CLASSPATH=%CLASSPATH%;%QPIDLIB%\slf4j-simple-1.0.jar
-
-GOTO END
-
-:ERROR_CLASSPATH
-Echo Please set set your CLASSPATH variable to include the Qpid client and common jars. Exiting ....
-:ERROR_QPID_HOME
-Echo Please set QPID_HOME variable. Exiting ....
-:END
diff --git a/content/xdocs/Getting Started Guide_attachments/set_classpath.sh b/content/xdocs/Getting Started Guide_attachments/set_classpath.sh deleted file mode 100755 index bab9cbad77..0000000000 --- a/content/xdocs/Getting Started Guide_attachments/set_classpath.sh +++ /dev/null @@ -1,83 +0,0 @@ -#!/bin/sh -xv
-#
-# 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.
-#
-
-# Helper script to set classpath for running Qpid example classes
-# NB: You must add the Qpid client and common jars to your CLASSPATH
-# before running this script
-
-
-cygwin=false
-if [[ "$(uname -a | fgrep Cygwin)" != "" ]]; then
- cygwin=true
-fi
-
-#Should have set the QPID_HOME var after install to the working dir e.g. home/qpid/qpid-1.0-incubating-M2-SNAPSHOT
-if [ "$QPID_HOME" = "" ] ; then
- echo "ERROR: Please set QPID_HOME variable. Exiting ...."
- exit 1
-else
- QPIDLIB=$QPID_HOME/lib
-fi
-
-if $cygwin; then
- QPIDLIB=$(cygpath -w $QPIDLIB)
-fi
-
-if [ "$CLASSPATH" = "" ] ; then
- echo "ERROR: Please set set your CLASSPATH variable to include the Qpid client and common jars. Exiting ...."
- exit 2
-fi
-
-#Converts paths for cygwin if req
-#Some nasty concatenation to get round cygpath line limits
-if $cygwin; then
- SEP=";"
- CLASSPATH=`cygpath -w $CLASSPATH`
- CLASSPATH=$CLASSPATH$SEP`cygpath -w $QPIDLIB/backport-util-concurrent-2.2.jar`
- CLASSPATH=$CLASSPATH$SEP`cygpath -w $QPIDLIB/geronimo-jms_1.1_spec-1.0.jar`
- CLASSPATH=$CLASSPATH$SEP`cygpath -w $QPIDLIB/commons-collections-3.1.jar`
- CLASSPATH=$CLASSPATH$SEP`cygpath -w $QPIDLIB/commons-configuration-1.2.jar`
- CLASSPATH=$CLASSPATH$SEP`cygpath -w $QPIDLIB/commons-cli-1.0.jar`
- CLASSPATH=$CLASSPATH$SEP`cygpath -w $QPIDLIB/commons-lang-2.1.jar`
- CLASSPATH=$CLASSPATH$SEP`cygpath -w $QPIDLIB/commons-logging-api-1.0.4.jar`
- CLASSPATH=$CLASSPATH$SEP`cygpath -w $QPIDLIB/commons-logging-1.0.jar`
- CLASSPATH=$CLASSPATH$SEP`cygpath -w $QPIDLIB/log4j-1.2.12.jar`
- CLASSPATH=$CLASSPATH$SEP`cygpath -w $QPIDLIB/mina-core-1.0.0.jar`
- CLASSPATH=$CLASSPATH$SEP`cygpath -w $QPIDLIB/mina-filter-ssl-1.0.0.jar`
- CLASSPATH=$CLASSPATH$SEP`cygpath -w $QPIDLIB/mina-java5-1.0.0.jar`
- CLASSPATH=$CLASSPATH$SEP`cygpath -w $QPIDLIB/slf4j-simple-1.0.jar`
- export CLASSPATH
-else
- CLASSPATH=$CLASSPATH:$QPIDLIB/backport-util-concurrent-2.2.jar
- CLASSPATH=$CLASSPATH:$QPIDLIB/geronimo-jms_1.1_spec-1.0.jar
- CLASSPATH=$CLASSPATH:$QPIDLIB/commons-collections-3.1.jar
- CLASSPATH=$CLASSPATH:$QPIDLIB/commons-configuration-1.2.jar
- CLASSPATH=$CLASSPATH:$QPIDLIB/commons-cli-1.0.jar
- CLASSPATH=$CLASSPATH:$QPIDLIB/commons-lang-2.1.jar
- CLASSPATH=$CLASSPATH:$QPIDLIB/commons-logging-api-1.0.4.jar
- CLASSPATH=$CLASSPATH:$QPIDLIB/commons-logging-1.0.jar
- CLASSPATH=$CLASSPATH:$QPIDLIB/log4j-1.2.12.jar
- CLASSPATH=$CLASSPATH:$QPIDLIB/mina-core-1.0.0.jar
- CLASSPATH=$CLASSPATH:$QPIDLIB/mina-filter-ssl-1.0.0.jar
- CLASSPATH=$CLASSPATH:$QPIDLIB/mina-java5-1.0.0.jar
- CLASSPATH=$CLASSPATH:$QPIDLIB/slf4j-simple-1.0.jar
- export CLASSPATH
-fi
-
diff --git a/content/xdocs/Getting Started.html b/content/xdocs/Getting Started.html deleted file mode 100755 index bec70f9b83..0000000000 --- a/content/xdocs/Getting Started.html +++ /dev/null @@ -1,96 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Getting Started</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Getting Started - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 11, 2008 by <font color="#0050B2">cctrieloff</font>. - </div> - - <h3><a name="GettingStarted-GettingtheBits."></a>Getting the Bits.</h3> - -<p>To work out what to download or where to start <a href="Download.html" title="Download">Download</a></p> - - -<h3><a name="GettingStarted-Runningit%2FAdministration"></a>Running it / Administration</h3> - -<p>These sections show you how to run the brokers, basic configuration and management</p> - -<ul> - <li><a href="Getting Started Guide.html" title="Getting Started Guide">Running & Administration and getting started</a> with the Java Broker</li> - <li><a href="RASC.html" title="RASC">Running & Administration and getting started</a> for the C++ Broker</li> - <li><a href="MgmtC++.html" title="MgmtC++">Managing</a> the C++ Broker</li> -</ul> - - -<h3><a name="GettingStarted-Makingsureitrunscorrectly"></a>Making sure it runs correctly</h3> - -<p>For more details on starting the brokers, see Administration section.</p> - -<p>The simplest way to check that the install is working correct is to try some of the examples. Each clients<br/> -has a set of examples included with it (or at least JMS, Java, C++ and Python do)</p> - -<p>If working from svn, a good smoke test is to run the python tests as they can be run against<br/> -any version of AMQP and any broker.</p> - -<p>To do so</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">export PYTHONPATH=~/qpid/python # or wherever you have it
-$./run-tests
-.........EFF.... /.../ #each . is a test E is an error, F is a fail
-
-
-#or to <span class="code-keyword">do</span> a specific version
-$./run-tests
-Options:
- ?/-h/-help : <span class="code-keyword">this</span> message
- s/-spec <spec.xml> : URL of AMQP XML specification or one of these abbreviations:
- 0-8 - use the <span class="code-keyword">default</span> 0-8 specification.
- 0-9 - use the <span class="code-keyword">default</span> 0-9 specification.
- e/-errata <errata.xml> : file containing amqp XML errata
- b/-broker [<user>/<password>@]<host>:<port> : broker to connect to
- v/-verbose : verbose - lists tests as they are run.
- d/-debug : enable debug logging.
- i/-ignore <test> : ignore the named test.
- I/-ignore-file : file containing patterns to ignore.
- S/-skip-self-test : skips the client self tests in the 'tests folder'
- F/-spec-folder : folder that contains the specs to be loaded</pre> -</div></div> - - -<p>Finally, if developing in svn, each build system has tests integrated into the build system for that language</p> - - - -<h3><a name="GettingStarted-YourfirstHelloWorld"></a>Your first Hello World</h3> - - -<h3><a name="GettingStarted-APIGuides"></a>API Guides</h3> - - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/HermesJMS.html b/content/xdocs/HermesJMS.html deleted file mode 100755 index 69228f4ad0..0000000000 --- a/content/xdocs/HermesJMS.html +++ /dev/null @@ -1,98 +0,0 @@ -<html> - <head> - <title>Apache Qpid : HermesJMS</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : HermesJMS - </span> - </div> - <div class="pagesubheading"> - This page last changed on Oct 19, 2006 by <font color="#0050B2">mmccorma</font>. - </div> - - <p><font color="red"><br/> -This is a draft </font></p> - -<h1><a name="HermesJMS-Background"></a>Background </h1> - -<p><a href="http://hermesjms.com" title="Visit page outside Confluence">HermesJMS</a> is a console for JMS messaging and supports QPID. This page shows how to configure Hermes with QPID.</p> - -<p>As the QPID codebase is moving quickly forward at the moment and there are some workarounds in place within Hermes to support it, you should ensure that you download the latest Hermes build from <a href="http://hermesjms.com/patches" title="Visit page outside Confluence">HEAD</a></p> - -<p>Finally, you should familiarise youself with Hermes via the tutorials on the website before continuing. Look at the Tibco EMS and JBoss tutorials for how to use connection factories directly or via JNDI. This page uses them directly.</p> - -<h1><a name="HermesJMS-Configuring"></a>Configuring </h1> - -<p>To get QPID working, you need to configure the libraries to load via the GUI. Hermes loads up each provider in its own classloader to avoid any dependency problems across providers. This tutorial assumes you've downloaded and built QPID via the <tt>ant dist</tt> task.</p> - -<h2><a name="HermesJMS-ConfiguretheCLASSPATH"></a>Configure the CLASSPATH </h2> - -<p>Start Hermes and select <em>Options -> Configuration</em> and click on the <em>Providers</em> tab. Create a new classpath group (right click for this) and add the following JARS to it:</p> - -<p><span class="error">Cannot resolve external resource into attachment.</span></p> - - -<p>When asked, choose the scan option to get Hermes to search the libraries to find any classes that implement JMS connection factory interfaces, this is essential for the next step.</p> - -<p>Finally, click OK.</p> - -<h2><a name="HermesJMS-ConfigureTheSession"></a>Configure The Session </h2> - -<p>Right click on the tree of sessions and select <em>New -> Session</em>. In the session combo box at the top put in the name you want, for example QPID. Its important the next thing you do is select the loader so the dialog can find any connection factories.</p> - -<p>In the <em>Class</em> combo box choose the <tt>org.apache.qpid.client.AMQConnectionFactory</tt>.</p> - -<p>Next, in the property list for the connection factory, right click to add new properties and use the combo to select which one and add their value.</p> - -<p>Finally, and very importantly, check the <em>Use consumer</em> checkbox at the top. QPID does not support JMS queue browsing but Hermes lets you use a {<tt>MessageConsumer</tt> instead. Remember of course that if an consumer is currently active you will not get the real queue content, Hermes uses a transacted session and some messages may be uncommitted in another consumers session.</p> - -<h2><a name="HermesJMS-AddDestinations"></a>Add Destinations </h2> - -<p>Currently you must manually add queues and topics. You can add them now or later from the <em>New queue</em>, <em>New topic</em> or <em>New durable subscription</em> actions in the toolbar. If you add them now then right click in the destination list to add them.</p> - -<p>The session and destinations should look something like this. Once happy, click OK.</p> - -<p><span class="error">Cannot resolve external resource into attachment.</span></p> - -<h2><a name="HermesJMS-TryaBrowse"></a>Try a Browse </h2> - -<p>Finally, double click on a queue or topic in the newly created session in the tree and you should get see something like the following (assuming you've got something in the queue or being published in the topic to see):</p> - -<p><span class="error">Cannot resolve external resource into attachment.</span></p> - -<p>This message is a JMS <tt>BytesMessage</tt> so there not much to see until you see its really a <a href="http://fixprotocol.org" title="Visit page outside Confluence">FIX </a> message and clicking on the FIX tab reveals it.</p> - -<p><span class="error">Cannot resolve external resource into attachment.</span></p> - -<h1><a name="HermesJMS-OtherFeatures"></a>Other Features</h1> - -<p>Refer to the <a href="http://hermesjms.com" title="Visit page outside Confluence">HermesJMS</a> site for how to use all the other feature of HermesJMS with QPID.</p> - -<h1><a name="HermesJMS-Issues"></a>Issues </h1> - -<p>1. Queues must already exist before you browse them.</p> - -<p>1. <tt>get/setJMSDestination()</tt> is not supported on a message so <tt>Unknown</tt> is shown.</p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/How to Use JNDI.html b/content/xdocs/How to Use JNDI.html deleted file mode 100755 index 45f284d965..0000000000 --- a/content/xdocs/How to Use JNDI.html +++ /dev/null @@ -1,124 +0,0 @@ -<html> - <head> - <title>Apache Qpid : How to Use JNDI</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : How to Use JNDI - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 02, 2008 by <font color="#0050B2">asimon</font>. - </div> - - <h2><a name="HowtoUseJNDI-HowtousethePropertiesFileInitialContextFactory"></a>How to use the PropertiesFileInitialContextFactory</h2> - -<p>This ContextFactory uses a java properties file to setup initial values. </p> - -<p>This is the example properties file.</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre>java.naming.factory.initial = org.apache.qpid.jndi.PropertiesFileInitialContextFactory
-
-# use the following property to configure the default connector
-#java.naming.provider.url - ignored.
-
-# register some connection factories
-# connectionfactory.[jndiname] = [ConnectionURL]
-connectionfactory.local = amqp://guest:guest@clientid/testpath?brokerlist='vm://:1'
-
-# register some queues in JNDI using the form
-# queue.[jndiName] = [physicalName]
-queue.MyQueue = example.MyQueue
-
-# register some topics in JNDI using the form
-# topic.[jndiName] = [physicalName]
-topic.ibmStocks = stocks.nyse.ibm
-
-# Register an AMQP destination in JNDI
-# NOTE: Qpid currently only supports direct,topics and headers
-# destination.[jniName] = [BindingURL]
-destination.direct = direct://amq.direct//directQueue
-</pre> -</div></div> - - -<p>The property file allows a number of queues to be defined that can then be discovered via JNDI. There are four properties used by the PFICFactory. <br/> -<em>connectionfactory.<jndiname></em> this is the <a href="Connection URL Format.html" title="Connection URL Format">Connection URL</a> that the connection factory will use to perform connections.<br/> -<em>queue.<jndiname></em> this defines a jms queue or in amqp a amq.direct exchange<br/> -<em>topic.<jndiname></em> this defines a jms topic or in amqp a amq.topic exchange<br/> -<em>destination.<jndiname></em> this takes a <a href="BindingURLFormat.html" title="BindingURLFormat">Binding URL</a> and so can be used for defining all amq destinations, queues, topics and header matching.</p> - -<p>In all of these properties the <em><jndiname></em> is the string value that would be given when performing a lookup.</p> - - -<p><b>NOTE</b>: This does not create the queue on the broker. You should ensure that you have created the queue before publishing to it. Queues can be declared in the virtualhosts.xml file so that they are created on broker startup, or created dynamically by consuming clients. Topics and other destinations that use temporary queues cannot be created in this way, so a consumer must be created first before publishing messages with mandatory routing.</p> - -<h3><a name="HowtoUseJNDI-Examplelookupcode"></a>Example lookup code</h3> - -<p>The <em>bindingValue</em> is the String that would be placed in <em><jndiname></em> above.</p> - -<div class="code" style="border-style: solid; "><div class="codeHeader" style="border-bottom-style: solid; "><b>Simple JNDI lookup using files</b></div><div class="codeContent"> -<pre class="code-java"><span class="code-comment">// Load the properties file ...
-</span>Properties properties = <span class="code-keyword">new</span> Properties();
-properties.load(propertiesfile_inputStream);
-
-<span class="code-comment">// Create the initial context
-</span>Context ctx = <span class="code-keyword">new</span> InitialContext(properties);
-
-<span class="code-comment">// Perform the binds
-</span>object = ctx.lookup(bindingValue);
-
-<span class="code-comment">// Close the context when we're done
-</span>ctx.close();</pre> -</div></div> - -<div class="code" style="border-style: solid; "><div class="codeHeader" style="border-bottom-style: solid; "><b>Simple JNDI lookup using properties</b></div><div class="codeContent"> -<pre class="code-java"><span class="code-keyword">final</span> <span class="code-object">String</span> INITIAL_CONTEXT_FACTORY = <span class="code-quote">"org.apache.qpid.jndi.PropertiesFileInitialContextFactory"</span>;
-
-<span class="code-keyword">final</span> <span class="code-object">String</span> CONNECTION_JNDI_NAME = <span class="code-quote">"local"</span>;
-<span class="code-keyword">final</span> <span class="code-object">String</span> CONNECTION_NAME = <span class="code-quote">"amqp:<span class="code-comment">//guest:guest@clientid/testpath?brokerlist='vm://:1'"</span>;
-</span>
-<span class="code-keyword">final</span> <span class="code-object">String</span> QUEUE_JNDI_NAME = <span class="code-quote">"queue"</span>;
-<span class="code-keyword">final</span> <span class="code-object">String</span> QUEUE_NAME = <span class="code-quote">"example.MyQueue"</span>;
-
-<span class="code-comment">// Set the properties ...
-</span>Properties properties = <span class="code-keyword">new</span> Properties();
-properties.put(Context.INITIAL_CONTEXT_FACTORY, INITIAL_CONTEXT_FACTORY);
-properties.put(<span class="code-quote">"connectionfactory."</span>+CONNECTION_JNDI_NAME , CONNECTION_NAME);
-properties.put(<span class="code-quote">"queue."</span>+QUEUE_JNDI_NAME , QUEUE_NAME);
-
-<span class="code-comment">// Create the initial context
-</span>Context ctx = <span class="code-keyword">new</span> InitialContext(properties);
-
-<span class="code-comment">// Perform the lookups
-</span>ConnectionFactory factory = (ConnectionFactory)ctx.lookup(CONNECTION_JNDI_NAME);
-Queue queue = (Queue)ctx.lookup(QUEUE_JNDI_NAME);
-
-<span class="code-comment">// Close the context when we're done
-</span>ctx.close();</pre> -</div></div> - -<p><a href="Using Qpid with other JNDI Providers.html" title="Using Qpid with other JNDI Providers">Using Qpid with other JNDI Providers</a></p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Informal M2.1 code review 2008-03-18.html b/content/xdocs/Informal M2.1 code review 2008-03-18.html deleted file mode 100755 index 9c66f0ce88..0000000000 --- a/content/xdocs/Informal M2.1 code review 2008-03-18.html +++ /dev/null @@ -1,42 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Informal M2.1 code review 2008-03-18</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Informal M2.1 code review 2008-03-18 - </span> - </div> - <div class="pagesubheading"> - This page last changed on Mar 20, 2008 by <font color="#0050B2">ritchiem</font>. - </div> - - <p>rgodfrey, 634720, BasicMessageConsumer.java: add comment to document DUPS_OK and AUTO_ACK closenes<br/> -ritchiem, 635549, SelectorParserTest.java: fix and enable test DONE<br/> -aidan, 637146, AMQConnection.java: add comment <br/> -ritchiem, 637170: jira that only outer failover should rety <a href="https://issues.apache.org/jira/browse/QPID-855" title="Visit page outside Confluence">QPID-855</a><br/> -ritchiem, 637176: change CancelTest logger to use CancelTest class DONE<br/> -ritchiem, 637977: raise Jira to fix client to not communciate on channels it has been told are closed <a href="https://issues.apache.org/jira/browse/QPID-865" title="Visit page outside Confluence">QPID-865</a></p> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Interop Testing Specification.html b/content/xdocs/Interop Testing Specification.html deleted file mode 100755 index f06ca04bd1..0000000000 --- a/content/xdocs/Interop Testing Specification.html +++ /dev/null @@ -1,1106 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Interop Testing Specification</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Interop Testing Specification - </span> - </div> - <div class="pagesubheading"> - This page last changed on Nov 22, 2007 by <font color="#0050B2">rupertlssmith</font>. - </div> - - <h1><a name="InteropTestingSpecification-QpidInteropTestingSpec.WorkingCopy."></a>Qpid Interop Testing Spec. Working Copy.</h1> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'> Draft. </th> -<td class='confluenceTd'> Rupert Smith. </td> -<td class='confluenceTd'> 22nd Feb 2007 </td> -<td class='confluenceTd'> Document started. </td> -</tr> -<tr> -<th class='confluenceTh'> Working Copy. </th> -<td class='confluenceTd'> Rupert Smith. </td> -<td class='confluenceTd'> 6th Mar 2007 </td> -<td class='confluenceTd'> Document updated from feedback to draft on qpid-dev list. Last requirement # used: 47 </td> -</tr> -<tr> -<th class='confluenceTh'> Working Copy. </th> -<td class='confluenceTd'> Rupert Smith. </td> -<td class='confluenceTd'> 7th Mar 2007 </td> -<td class='confluenceTd'> Senders and receivers to send reports to coordinator. Reply-to added to broadcast messages. Last requirement # used: 49 </td> -</tr> -<tr> -<th class='confluenceTh'> Working Copy. </th> -<td class='confluenceTd'> Rupert Smith. </td> -<td class='confluenceTd'> 13th Mar 2007 </td> -<td class='confluenceTd'> Added test case names. Last requirement # used: 52 </td> -</tr> -<tr> -<th class='confluenceTh'> Working Copy. </th> -<td class='confluenceTd'> Rupert Smith. </td> -<td class='confluenceTd'> 25th Sept 2007 </td> -<td class='confluenceTd'> Added test cases for message size variation. Last requirement # used: 60 </td> -</tr> -<tr> -<th class='confluenceTh'> Version 2 Work in Progress. </th> -<td class='confluenceTd'> Rupert Smith </td> -<td class='confluenceTd'> 22nd Nov 2007 </td> -<td class='confluenceTd'> Test framework being expanded to cover functional and perforance tests and a much wider variety of testing possibilities. </td> -</tr> -</tbody></table> - -<h2><a name="InteropTestingSpecification-Introduction%3A"></a>Introduction:</h2> - -<p> The requirements in this specification use a common format, an example of which is given below:</p> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'> RE-1. </th> -<th class='confluenceTh'> Sample Requirement. </th> -<td class='confluenceTd'> A brief descritpion of the requirement. </td> -</tr> -</tbody></table> - -<p> The requirements are numbered from 1.</p> - -<h2><a name="InteropTestingSpecification-Purpose%3A"></a>Purpose:</h2> - -<ul> - <li>Test sending from and receiving by each of the clients in Qpid over both of the broker implementations.</li> -</ul> - - -<ul> - <li>Enable testing of any JMS compliant product, by keeping a pure JMS sub-set of the testing framework seperate. This only applies to Java messaging client implementations.</li> -</ul> - - -<ul> - <li>Provide a parameter driven test framework, that can be used to generate many testing scenarios for different messaging modes.</li> -</ul> - - -<ul> - <li>Allow functional testing of messaging at the product surface, through the standard interfaces/protocols (JMS, AMQP), so that the same test suite may be applied over different implementations.</li> -</ul> - - -<ul> - <li>Allow tests to be posed in terms of abstract asynchronous messaging concepts that AMQP and JMS support, rather than at the level of direct interfaces. This allows the same tests to carry forward as standards and products evolve.</li> -</ul> - - -<ul> - <li>Enable interopability testing between any AMQP compliant components, not just those in Qpid.</li> -</ul> - - -<ul> - <li>Allow performance testing to be carried out accross a distributed set of edge nodes connected to a messaging broker.</li> -</ul> - - -<ul> - <li>Make tests robust enough to run as part of an automated build. The scripts should pass or fail, not hang, wait forever, run out of memory or otherwise cause an automated build process to fail to complete.</li> -</ul> - - -<ul> - <li>Be capable of running the full test suite on several machines in a hands free way. In particular C++ tests need to run on unix and .Net on windows, necessitating a multi-box solution for full interop testing.</li> -</ul> - - -<ul> - <li>Be capable of running the same test cases accross message topologies ranging from a single test node running in the same process as a broker, to many test nodes running on different machines, remotely connected to a broker.</li> -</ul> - - -<h2><a name="InteropTestingSpecification-Constraints%3A"></a>Constraints:</h2> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'> IOP-1. </th> -<th class='confluenceTh'> Operating System. </th> -<td class='confluenceTd'> The test client scripts must run on Unix and Windows. If a test client implementation is only available on one of these platforms it only needs to run on its supported platform. </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-2. </th> -<th class='confluenceTh'> Scripting Language. </th> -<td class='confluenceTd'> Each test client must be startable from a Unix shell script. Tests run on Windows will use Cygwin to run these scripts. There is no need to support Windows .bat scripts. </td> -</tr> -</tbody></table> - -<h2><a name="InteropTestingSpecification-FunctionalRequirements%3A"></a>Functional Requirements:</h2> - -<h3><a name="InteropTestingSpecification-Introduction."></a>Introduction.</h3> - -<p> These requirements describe the behaviour of test clients for testing between different client implementations of AMQP. Each client is expected to be a single program that is capable of sending test messages to other clients and receiving and responding to test messages received from other test clients. The clients are not to be run as seperate programs for the sending and receiving parts for the sake of convenience in being able to run the clients as part of an automated build. The clients will listen for control messages broadcast by a master coordinator, to enlist them in tests, tell them which test to run, when to begin their tests, where to submit reports about the tests and when to shut down. </p> - -<p> A centralized approach has been chosen, using a single coordinator, as test framework code which would otherwise have to be duplicated amongst all the clients will generally be put in the coordinator. The idea is to place as much logic as possible in the coordinator and as little as possible in the clients which means that code will only have to be written and maintained in one place. This code will include code for enlisting clients for tests, deciding which test case to run, and formatting and logging out the results. The alternative would be to have a de-centralized approach, where each client broadcasts the test enlist messages, finds out what other clients are available to talk to, choses which tests to run and outputs the test results. One advantage of the centralized approach, is that the coordinator should know which clients are available, and therefore which clients cannot run particular tests, or fail completely to run particular tests, and should therefore be able to log out failures for clients that fail tests in a more reliable way, than if it were up to the clients to log their own failures and ommissions.</p> - -<h2><a name="InteropTestingSpecification-Buildtestsoutofastandardizedconstructionblock."></a>Build tests out of a standardized construction block.</h2> - -<ul> - <li>Diagram: The test circuit.</li> -</ul> - - -<p>Publisher/Receiver pair.<br/> -Each end of which is a Producer/Consumer unit.<br/> - M producers, N consumers, talking over Z destinations.</p> - -<p> One of the stated aima of this specificiation is to "Allow tests to be posed in terms of abstract asynchronous messaging concepts that AMQP and JMS support, rather than at the level of direct interfaces". For example, we know that messages sent in a transaction, must not be delivered until the transaction is committed. This is true of AMQP as it is of JMS; as AMQP is intended to provide similar messaging semantics to JMS. The statement is also true, whether the messages are broadcast to many receivers or sent to just one.</p> - -<p> The standard consruction block for a test, is a test circuit. This consists of a publisher, and a receiver. The publisher and receiver may reside on the same machine, or may be distributed. Will use a standard set of properties to define the desired circuit topology.</p> - -<p> Tests are always to be controlled from the publishing side only. The receiving end of the circuit is to be exposed to the test code through an interface, that abstracts as much as possible the receiving end of the test. The interface exposes a set of 'assertions' that may be applied to the receiving end of the test circuit.</p> - -<p> In the case where the receiving end of the circuit resides on the same JVM, the assertions will call the receivers code locally. Where the receiving end is distributed accross one or more machines, the assertions will be applied to a test report gethered from all of the receivers. Test code will be written to the assertions making as few assumptions as possible about the exact test topology.</p> - -<p> A test circuit defines a test topology, M producers, N consumers, Z outgoing routes between them.<br/> - The publishing end of each test circuit always resides on a single JVM, even if M > 1. If publishers are to be distributed accross many machines, the test framework itself provides the scaling by running the same test circuit many times in parallel. This means that it is possible to have an arbitrary number of message publishers accross one or many machines, determined by the test setup.<br/> - The receiving half of the circuit may be local, in which case all messages come back to the same machine, or distributed in which case they may be received by many machines.<br/> - There are therefore two ways in which tests may be distributed accross multiple nodes in a network; many test circuits may be distributed and run in parallel and/or the receiving ends of those circuits may be distributed or local.<br/> - Each node in the network can play up to 2 roles in any given test; publisher or receiver. It is possible to play both roles at once, but would like to have a 'single_role' flag, that can be set to ensure that test nodes taking one role, will not participate in the other for the duration of a test. For example, in the pub/sub test want one publisher and the remaining nodes to distribute the receiver role amongst themselves.</p> - -<h2><a name="InteropTestingSpecification-Probingfortheavailabletesttopology."></a>Probing for the available test topology.</h2> - -<ul> - <li>Diagram: The available topology.</li> -</ul> - - -<p> When the test distribution framework starts up, it should broadcast an 'enlist' request on a known topic. All available nodes in the network to reply in order to make it known that they are available to carry out tests. For the requested test case, C test circuits are to be run in parallel. Each test defines its desired M by N topology for each circuit. The entire network may be available to run both roles, or the test case may have specified a limit on the number of publishing nodes and set the 'single_role' flag. If the number of publishing nodes exhausts the available network and the single role flag is on, then there are no nodes available to run the receiver roles, the test will fail with an error at this point. Suppose there are P nodes available to run the publisher roles, and R nodes available to run the receiver roles. The C test circuits will be divided up as evenly as possible amongst the P nodes. The C * N receivers will be divided up as evenly as possible amongst the R nodes.</p> - -<p> A more concrete example. There are 10 test machines available. Want to run a pub/sub test with 2 publishers, publishing to 50 topics, with 250 subscribers, measuring total throughput. The distribution framework probes to find the ten machines. The test parameters specify a concurrency level of 2 circuits, limited to 2 nodes, with the single role flag set, which leaves 8 nodes to play the receiver role. The test parameters specify each circuit as having 25 topics, unique to the circuit, and 125 receivers. The total of 250 receivers are distributed amongst the 8 available nodes, 31 each, except for two of them which get 32. The test specifies a duration of 10 minutes, sending messages 500 bytes in size using test batches of 10000 messages, as fast as possible. The distribution framework sends a start signal to each of the publishers. The publishers run for 10000 messages. The publishers request a report from each receiver on their cicruit. The receivers send back to the publishers a report on the number of messages received in the batch. The publishers assert that the correct number for the batch were indeed received, and log a time sample for the batch. This continues for 10 minutes. At the end of the 10 minutes, the publishers collate all of their timings, failures, errors into a log message. The distribution framework requests the test report from each publishing nodes, and these logs are combined together to produce a single log for the entire run. Some stats, such as total time taken, total messages through the system, total throughput are calculated and added as a summary to the log, along with a record of the requested and actual topology used to run the test.</p> - -<ul> - <li>Diagram: The requested test applied onto the available topology.</li> -</ul> - - -<h2><a name="InteropTestingSpecification-TestProcedures."></a>Test Procedures.</h2> - -<p>A variety of different tests can be written against a standard test circuit, many of these will follow a common pattern. One of the aims of using a common test circuit configured by a number of test parameters, is to be able to automate the generation of all possible test cases that can be produced from the circuit combined with the common testing pattern, and an outline of a procedure for doing this is described here. The typical test sequence is described below:</p> - -<h3><a name="InteropTestingSpecification-Atypicaltestsequence."></a>A typical test sequence.</h3> - -<ol> - <li>Initialize the test circuit from the default parameters, plus specific settings for the test.</li> - <li>Create the test circuit. The requested test parameters are applied to the available topology to produce a live circuit.</li> - <li>Send messages.</li> - <li>Request a status report.</li> - <li>Assert conditions on the publishing end of the circuit.</li> - <li>Assert conditions on the receiving end of the circuit.</li> - <li>Pass or fail the test.</li> -</ol> - - -<h3><a name="InteropTestingSpecification-Thethoroughtestprocedure."></a>The thorough test procedure.</h3> - -<p>The thorough test procedure uses the typical test sequence described above, but generates all of combinations of test parameters and corresponding assertions against the results.</p> - -<p>The all_combinations function produces all combinations of test parameters described in Appendix A.</p> - -<p>all_combinations : List<Properties></p> - -<p>The expected_results function, produces a list of assertions, given a set of test parameters. For example, mandatory && no_route -> assertions.add(producer.assertMessageReturned), assertions.add(receiver.assertMessageNotReceived).</p> - -<p>expected_results: Properties -> List<Assertions></p> - -<p>For parameters : all_combinations<br/> - test_circuit = new TestCircuit(parameters).<br/> - test_circuit.start.</p> - -<p> Send mesages.<br/> - Request status.</p> - -<p> For assertion : exected_results(parameters)<br/> - Assert(assertion).</p> - -<h3><a name="InteropTestingSpecification-CommonRequirements."></a>Common Requirements.</h3> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'> IOP-3. </th> -<th class='confluenceTh'> Directory Structure. </th> -<td class='confluenceTd'> All scripts to start and stop brokers and run test clients will be placed in a directory structure underneath a top-level directory called 'interop' that sits at the top level of the Qpid project. </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-4. </th> -<th class='confluenceTh'> Test Output Format. </th> -<td class='confluenceTd'> Output in junit xml format (because a lot of automated build software understands this format). There doesn't seem to be a schema or DTD for this format but it is simple enough. See Appendix B for an example. </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-5. </th> -<th class='confluenceTh'> Terminate On Timeout. </th> -<td class='confluenceTd'> Each client will keep a timeout count. Every time it gets a message it will reset this count. If it does not hear from the broker at all for 60 seconds then it will assume that the broker has died or that the other test clients are failing to communicate with it, and will terminate. Test clients will only wait on this timeout when they are actually expecting messages, for example after enlisting to a test and expecting a role assignment message, or during a test when they are expecting to be sent a test message. If neccessary, this timeout can be extended to a longer time period than 60 secods, its purpose is to ensure eventual termination of all clients during a fully automated build. </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-6. </th> -<th class='confluenceTh'> Default Virtual Host. </th> -<td class='confluenceTd'> All test clients will use the default virtual host (no name) for all tests, unless overriden by test parameters for a particular test case, or by command line options when starting the client. </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-7. </th> -<th class='confluenceTh'> Broadcast Control Topic. </th> -<td class='confluenceTd'> All test clients will listen to control messages broadcast on the routing key 'iop.control' on the default virtual host on the default topic exchange. This control topic is used for communicating with the test coordinator client. </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-48. </th> -<th class='confluenceTh'> Control Message Replies. </th> -<td class='confluenceTd'> All control messages broadcast by the coordinator will include a reply to field. The coordinator will listen on the reply address for responses to its control messages. </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-8. </th> -<th class='confluenceTh'> No Environment for Scripts. </th> -<td class='confluenceTd'> In general, start up scripts should be intelligent enough to configure the environment variables that they need in order to run. It should be sufficient to have a path configured for the neccessary run time tools (such as Java) when calling scripts. Environment variables, such as QPID_HOME, should be set by startup scripts themselves, figured out from their installation locations. </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-9. </th> -<th class='confluenceTh'> Wait Until Background Process Started. </th> -<td class='confluenceTd'> Scripts that start processes running in the background should not terminate until the process they are starting has succesfully started. This is neccessary for reliable testing, to ensure that subsequent scripts can be run, knowing that previous scripts have completed, with dependant proccesses in a known state. For example, it is important to start all test clients prior to starting the coordinator. </td> -</tr> -</tbody></table> - -<h3><a name="InteropTestingSpecification-UseCase1.StartingaBroker."></a>Use Case 1. Starting a Broker.</h3> - -<p> Run the broker start script.<br/> - The script starts a broker running and tries to connect to it (or otherwise ping it) until it is verified to be running.<br/> - Once the broker is verified to be running the script terminates with no error code.</p> - -<p> <b>Failure path:</b> The broker fails to start or does not appear to be running after a timeout has passed. The script fails with an error code.</p> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'> IOP-10. </th> -<th class='confluenceTh'> Broker Start Script. </th> -<td class='confluenceTd'> The Java and C++ brokers will define scripts that can start the broker running on the local machine, and these scripts will be located at interop/java/broker/start and interop/cpp/broker/start. The Java and C++ build processes will generate these scripts (or copy pre-defined ones to the output location) as part of their build processes. </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-11. </th> -<th class='confluenceTh'> Broker Start Failure. </th> -<td class='confluenceTd'> If a broker fails to start within 60 seconds its start script will timeout. Script will terminate with error code 1. </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-12. </th> -<th class='confluenceTh'> Broker Start Succesfull. </th> -<td class='confluenceTd'> When the broker starts succesfully the script will terminate with error code 0. </td> -</tr> -</tbody></table> - -<h3><a name="InteropTestingSpecification-UseCase2.StoppingaBroker."></a>Use Case 2. Stopping a Broker.</h3> - -<p> Run the broker stop script.<br/> - The script terminates the broker that was started with the start script if it is still running.</p> - -<p> <b>Failure path:</b> The broker won't terminate. The script fails with an error code.</p> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'> IOP-13. </th> -<th class='confluenceTh'> Broker Stop Script. </th> -<td class='confluenceTd'> The Java and C++ brokers will define scripts that can stop the broker running on the local machine, and these scripts will be located at interop/java/broker/stop and interop/cpp/broker/stop. The Java and C++ build processes will generate these scripts (or copy pre-defined ones to the output location) as part of their build processes. </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-14. </th> -<th class='confluenceTh'> Broker Stop Timeout. </th> -<td class='confluenceTd'> If a broker fails to terminate within 60 seconds its stop script will timeout. Script will terminate with error code 1. </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-15. </th> -<th class='confluenceTh'> Broker Stop Succesfull. </th> -<td class='confluenceTd'> When the broker stops succesfully the script will terminate with error code 0. </td> -</tr> -</tbody></table> - -<h3><a name="InteropTestingSpecification-UseCase3.StartingaTestClient."></a>Use Case 3. Starting a Test Client.</h3> - -<p> Run the client start script. The caller will pass in the address of the broker to connect to.<br/> - The script starts a client running.<br/> - The client starts running but waits for further instruction before running its tests.<br/> - The start script will terminate but leave the client running as a forked process.</p> - -<p> <b>Failure path:</b> The client will not start, or fails to connect to the specified broker. The script will terminate with error code 1.</p> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'> IOP-16. </th> -<th class='confluenceTh'> Client Start Scripts. </th> -<td class='confluenceTd'> For each client implementation, <client>, there will be a start script located at interop/<client>/client/start. The build processes for each client will generate these scripts and output them to this location as part of their build process. </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-17. </th> -<th class='confluenceTh'> Client Start Timeout. </th> -<td class='confluenceTd'> If the client fails to start and connect to the specified broker within 60 seconds the script will terminate with error code 1. </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-18. </th> -<th class='confluenceTh'> Client Start Succesfull. </th> -<td class='confluenceTd'> When the client starts successfully its script will terminate with error code 0. </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-19. </th> -<th class='confluenceTh'> Client Start Broker and Port. </th> -<td class='confluenceTd'> The -b <hostname> option will be used to instruct the start script to connect to the specified hostname. The -p <port> option will similarly allow the port to be specified. </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-20. </th> -<th class='confluenceTh'> Client Virtual Host. </th> -<td class='confluenceTd'> The default virtual host to connect to, may be overridden with the -v <virtual_host> command line option, which will be accepted by all test clients. </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-21. </th> -<th class='confluenceTh'> Client Start General Parameters. </th> -<td class='confluenceTd'> General parameters may be passed to the client start scripts using the synax name=value. These name/value pairs may be used by specific test cases to override default test parameters. See Appendix C for a list of test parameters. </td> -</tr> -</tbody></table> - -<h3><a name="InteropTestingSpecification-UseCase4.StartingtheCoordinator."></a>Use Case 4. Starting the Coordinator.</h3> - -<ul> - <li>The requirements defined for Use Case 3, also apply to this use case.</li> -</ul> - - -<p> Run the testall start script. The caller will pass in the address of the broker to connect to.<br/> - The script starts the coordinator client running.<br/> - The coordinator will manage the test procedure.<br/> - The scipt will terminate when the coordinator has completed.</p> - -<p> <b>Failure path:</b> The coordinator will not start, or fails to connect to the broker. The script will terminate with error code 1.</p> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'> IOP-22. </th> -<th class='confluenceTh'> Coordinator Test Script. </th> -<td class='confluenceTd'> There will be a coordinator test script that kicks off the testing process once all clients have been started. It is to be located at interop/testall. It will start a coordinator test client that issues test invites, assigns roles, collects results and terminates test clients when all tests have been run. </td> -</tr> -</tbody></table> - -<h3><a name="InteropTestingSpecification-UseCase5.OverallTestProcedure."></a>Use Case 5. Overall Test Procedure.</h3> - -<p> Start a broker running using its start script as described by Use Case 1.<br/> - Call the start all clients script on each of the machines where there are clients that are to be tested. The caller will pass in address of the broker to connect to, and any additional parameters.<br/> - The start all script will scan for all start scripts located under interop/<client>/client/start and call each of them forwarding its command line arguments on the call. This performs Use Case 3 for each client.<br/> - Call the coordinator test client script. This is described as Use Case 4.</p> - -<p> The coordinator test script will broadcast an invite message, with no test name on the control topic. The lack of a test name indicates that this is a compulsory invite, to which all clients must enlist.<br/> - Each client will respond with an enlist message. This message will contain the routing key on the default topic exchange to which the client has bound its private control queue.<br/> - The coordinator retains the list of available clients, and the addresses of their control queues.</p> - -<p> The coordinator will broadcast an invite to a named test. This invite may also contain any parameters needed to configure the test, that are relevant to a clients choice to accept the invite or not.<br/> - All clients that are able to participate in this test will reply to the invite with enlist messages. Clients may opt to participate in the test depending on the test parameters, if desired.<br/> - The coordinator will send messages to assign roles to the sender and receivers private control topics. These messages will contain the test parameters and roles. The test parameters may also include additional parameters not in the original invite, for test parameters that are to be set on a per test instance basis.<br/> - The clients will respond with accept role messages.<br/> - The coordinator will wait until it has received acceptances from both roles.<br/> - The coordinator will issue a start message to the client with the sender role.<br/> - The sender client will send its test messages. Once the test has completed the sender will send a report message to the coordinator, giving details about the message that it sent.<br/> - The coordinator will wait until it receives a report message from the sender.<br/> - The coordinator will issue a status request message to the reciever role.<br/> - The receiver will reply with a report, giving details about the messages it has received.<br/> - The coordinator will wait until it receives a report message from the receiver.<br/> - The coordinator will compare the sender and receiver reports in order to decide whether the test passed or failed.<br/> - The coordinator will check its list of available clients and log out failures for any combinations of clients that were not tested because they did not enlist for the test.</p> - -<p> Once all test cases are complete, the coordinator will broadcast a shutdown message.<br/> - All clients will terminate on receipt of the shutdown message.<br/> - The coordinator will terminate.<br/> - Terminate the broker using its stop script.</p> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'> IOP-23. </th> -<th class='confluenceTh'> Start All Script. </th> -<td class='confluenceTd'> There will be a start all clients script, located at interop/startall. The startall script finds all client starts scripts under interop/<client>/client/start and calls them. </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-24. </th> -<th class='confluenceTh'> Start All Script Options Forwarding. </th> -<td class='confluenceTd'> The start all script will take the same command line options as the client start scripts and will pass these command line options on to them. </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-25. </th> -<th class='confluenceTh'> Invite Message. </th> -<td class='confluenceTd'> <table class="sectionMacro" border="0" cellpadding="5" cellspacing="0" width="100%"><tbody><tr><p> For every test case the coordinator will broadcast an invite message on the control topic. This message will be identified by the header field, "CONTROL_TYPE", having the value, "INVITE". This message will also include the name of the test case and may also include some test parameters. (See IOP-48, for the reply to address.)</p> -<div class="preformatted"><div class="preformattedContent"> -<pre> "CONTROL_TYPE", "INVITE"
- "TEST_NAME", "<test_case>"
- ... optional test parameters.
-</pre> -</div></div> </tr></tbody></table> </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-26. </th> -<th class='confluenceTh'> Initial Invite. </th> -<td class='confluenceTd'> At the start of the test procedure the coordinator will broadcast a compulsory invite, to which all available clients must enlist, in order to declare their availability and to enable the coordinator to detect when there are clients that did not participate in some tests. The compulsory invite will be differentiated form an ordinatory invite because it will have no "TEST_NAME" header field. </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-27. </th> -<th class='confluenceTh'> Enlist Message. </th> -<td class='confluenceTd'> <table class="sectionMacro" border="0" cellpadding="5" cellspacing="0" width="100%"><tbody><tr><p> Every test client that receives an invite message will respond by declaring its availability to run interop tests. The client will send an enlist message by replying to the invite message. The enlist message will be identified by the header field, "CONTROL_TYPE", having the value, "ENLIST". The client will declare the routing key on which it expects to be sent private control messages. The client will also declare a unique name by which it can be identified (see IOP-35). The declare available message will contain the following header fields with this information: </p> -<div class="preformatted"><div class="preformattedContent"> -<pre> "CONTROL_TYPE", "ENLIST"
- "CLIENT_NAME", "<client_name>" (see IOP-35 for rules about the client name).
- "CLIENT_PRIVATE_CONTROL_KEY", "iop.control.<client_name>" (see IOP-36)
-</pre> -</div></div> </tr></tbody></table> </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-28. </th> -<th class='confluenceTh'> Assign Role Message. </th> -<td class='confluenceTd'> <table class="sectionMacro" border="0" cellpadding="5" cellspacing="0" width="100%"><tbody><tr><p> Having selected clients to participate in a particular test case, the coordinator will send those clients messages to assign the roles they will play in the test case, on the clients private control topics. Each test case has sender and receiver roles. This message will be identified by the header field, "CONTROL_TYPE", having the value, "ASSIGN_ROLE". The full test parameters will be included in this message, allowing tests to be configured on a per test instance basis.</p> -<div class="preformatted"><div class="preformattedContent"> -<pre> "CONTROL_TYPE", "ASSIGN_ROLE"
- ... full test parameters.
-</pre> -</div></div> </tr></tbody></table> </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-29. </th> -<th class='confluenceTh'> Accept Role Message. </th> -<td class='confluenceTd'> <table class="sectionMacro" border="0" cellpadding="5" cellspacing="0" width="100%"><tbody><tr><p> A client receiving an assign role message, will reply to it with an accept role message. This message also indicates that the client is ready to start the test. This message will be identifier by the header field, "CONTROL_TYPE", having the value, "ACCEPT_ROLE".</p> -<div class="preformatted"><div class="preformattedContent"> -<pre> "CONTROL_TYPE", "ACCEPT_ROLE"
-</pre> -</div></div> </tr></tbody></table> </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-30. </th> -<th class='confluenceTh'> Start Message. </th> -<td class='confluenceTd'> <table class="sectionMacro" border="0" cellpadding="5" cellspacing="0" width="100%"><tbody><tr><p> The coordinator will send a start message to begin the test procedure. All test clients will listen for this message on their private control topics. The start message will be identified by the header field, "CONTROL_TYPE", having the value, "START". </p> -<div class="preformatted"><div class="preformattedContent"> -<pre> "CONTROL_TYPE", "START"
-</pre> -</div></div> </tr></tbody></table> </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-31. </th> -<th class='confluenceTh'> Report Message. </th> -<td class='confluenceTd'> <table class="sectionMacro" border="0" cellpadding="5" cellspacing="0" width="100%"><tbody><tr><p> Once the test clients have completed a test case, they will send the coordinator a report about the actions they have performed. In the case of senders, this report will be sent once they have finished sending test messages. In the case of receiver, this report will be sent in response to a status request from the coordinator (see IOP-49). The report message will be identified by the header field, "CONTROL_TYPE", having the value, "REPORT". Its message body, or additional header fields will contain the report, specific to the test case being run.</p> -<div class="preformatted"><div class="preformattedContent"> -<pre> "CONTROL_TYPE", "REPORT"
- ... test specific parameters.
- Message body, Test case specific report.
-</pre> -</div></div> </tr></tbody></table> </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-49. </th> -<th class='confluenceTh'> Status Request Message. </th> -<td class='confluenceTd'> <table class="sectionMacro" border="0" cellpadding="5" cellspacing="0" width="100%"><tbody><tr><p> Once the coordinator has received the senders report, it will send a status request to the receiver, to request the receivers report. This message will be identified by the header field, "CONTROL_TYPE", having the value, "STATUS_REQUEST".</p> -<div class="preformatted"><div class="preformattedContent"> -<pre> "CONTROL_TYPE", "STATUS_REQUEST"
-</pre> -</div></div> </tr></tbody></table> </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-34. </th> -<th class='confluenceTh'> Terminate Message. </th> -<td class='confluenceTd'> <table class="sectionMacro" border="0" cellpadding="5" cellspacing="0" width="100%"><tbody><tr><p> The coordinator will wait for all test clients to complete their tests for all test cases at which time it will broadcast a terminate message to the control topic. The terminate message will be identified by the header field, "CONTROL_TOPIC", having the value, "TERMINATE". Upon receipt of this message the test clients will terminate.</p> -<div class="preformatted"><div class="preformattedContent"> -<pre> "CONTROL_TYPE", "TERMINATE"
-</pre> -</div></div> </tr></tbody></table> </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-35. </th> -<th class='confluenceTh'> Client Name. </th> -<td class='confluenceTd'> Each test client will provide a unique name for itself that reflects its implementation language and distinguishes it from the other clients. Clients may append an environment identifier onto this name to cater for the case where the same client is used multiple times in an interop test. For example, the same client might be run on two different operating systems, in order to check that it works correctly on both. Example names in this case might be "java-win" and "java-linux". </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-36. </th> -<th class='confluenceTh'> Private Client Control Topic. </th> -<td class='confluenceTd'> Each test client will listen for test control messages directed specifically to it on the default topic exchange. The routing key for these messages will consist of "iop.control." followed by the client name (see IOP-35). A topic exchange is used, rather than a direct exchange, to cater for the situation where multiple instances of a client are run in parallel and tests are to be scaled accross many clients (not currently in scope, see Waiting Room). It also allows a listener to be attached to the default topic exchange to listen to all control messages using a wildcard selector. </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-37. </th> -<th class='confluenceTh'> Seperate Connection for Control Topic. </th> -<td class='confluenceTd'> Test clients should create open a seperate connection to communicate with the control topics on the default topic exchange, to that which they use to perform tests. This is so that a channel level error that results in the closing of a connection during a test, may still allow a client to succesfully send a failure report to the coordinator. </td> -</tr> -</tbody></table> - -<h3><a name="InteropTestingSpecification-CommonRequirementsforTestCases."></a>Common Requirements for Test Cases.</h3> - -<p> Test cases that use these requirements mention them in the description of the test case.</p> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'> IOP-38. </th> -<th class='confluenceTh'> Message Counts. </th> -<td class='confluenceTd'> Whenever a test client recieves a message from another test client it will increment the total count of messages received from that client. Test messages will contain the name of the sending client in the header field "CLIENT_NAME", and the count will be held against a combination of that name and the messages correlation id (see IOP-42). </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-39. </th> -<th class='confluenceTh'> Message Count Reset. </th> -<td class='confluenceTd'> Whenever a test client is begining a new test case (when it accepts a role) it will reset its message counts to zero. </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-41. </th> -<th class='confluenceTh'> Message Count Report Message. </th> -<td class='confluenceTd'> <table class="sectionMacro" border="0" cellpadding="5" cellspacing="0" width="100%"><tbody><tr><p> Upon receipt of a status request message, a test client will reply with a report message. The report message will be identified by the header field "CONTROL_TYPE", having the value, "REPORT" (as described by IOP-31). In addition to this, the header field, "MESSAGE_COUNT" will contain the count of messages received since the last reset as a signed 32-bit integer.</p> -<div class="preformatted"><div class="preformattedContent"> -<pre> "CONTROL_TYPE", "REPORT"
- "MESSAGE_COUNT", <count> (signed 32 bit integer)
-</pre> -</div></div> </tr></tbody></table> </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-42. </th> -<th class='confluenceTh'> Correlation Id. </th> -<td class='confluenceTd'> When sending test messages, clients will identify all messages using a unique correlation id for the test case instance. This will differentiate test messages in a situation where the same client is scaled up to run a test case many times in parallel (not in scope, see Waiting Room). </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-43. </th> -<th class='confluenceTh'> Test Connections. </th> -<td class='confluenceTd'> Test clients will create connections to send test messages on when they are assigned roles. In many cases this will consist of creating a single connection, and a producer or consumer for the test routing key or queue. In some tests, which simulate the activity of many message receivers, multiple connections may be opened. </td> -</tr> -</tbody></table> - -<h3><a name="InteropTestingSpecification-TestCase1.DummyRun."></a>Test Case 1. Dummy Run.</h3> - -<p> The sending client will not send any test messages at all. It will send a report message on the control topic, declaring that the test has passed.</p> - -<p> The purpose of this test case is to check that clients can interoperate succesfully with the test coordinator and participate in the sequencing of the tests.</p> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'> IOP-50. </th> -<th class='confluenceTh'> Test Case 1 Name. </th> -<td class='confluenceTd'> The "TEST_NAME" field in the test invite (IOP-25) will be "TC1_DummyRun" for this test. </td> -</tr> -</tbody></table> - -<h3><a name="InteropTestingSpecification-TestCase2.BasicP2PTest."></a>Test Case 2. Basic P2P Test.</h3> - -<ul> - <li>This test case uses requirements IOP-38 to 43 inclusive.</li> -</ul> - - -<p> The sending client creates a fresh correlation id, and the entire test case conversation uses this id.<br/> - The sending client will send the required number of test messages to the test routing key on the default direct exchange.<br/> - The sending client will send a message count report to the coordinator.<br/> - In response to a status request from the coordinator, the receiving client will reply with a message count report.<br/> - The coordinator will compare the messages received to the messages sent and pass or fail the test accordingly.</p> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'> IOP-44. </th> -<th class='confluenceTh'> Basic P2P Setup. </th> -<td class='confluenceTd'> Prior to assigning roles, the coordinator will bind a queue to the default direct exchange with a routing key, the same as the queue name. It will create a fresh queue and key for every test case instance. </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-45. </th> -<th class='confluenceTh'> Basic P2P Assign Role Parameters. </th> -<td class='confluenceTd'> <table class="sectionMacro" border="0" cellpadding="5" cellspacing="0" width="100%"><tbody><tr><p> In addition to the invite message format defined in IOP-26, the basic p2p test invite will also include the following parameters.</p> -<div class="preformatted"><div class="preformattedContent"> -<pre> "P2P_QUEUE_AND_KEY_NAME", "<name>"
- "P2P_NUM_MESSAGES", <count> (signed 32 bit int), P2P_NUM_MESSAGES property.
-</pre> -</div></div> </tr></tbody></table> </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-51. </th> -<th class='confluenceTh'> Test Case 2 Name. </th> -<td class='confluenceTd'> The "TEST_NAME" field in the test invite (IOP-25) will be "TC2_BasicP2P" for this test. </td> -</tr> -</tbody></table> - -<h3><a name="InteropTestingSpecification-TestCase3.BasicPub%2FSubTest."></a>Test Case 3. Basic Pub/Sub Test.</h3> - -<ul> - <li>This test case uses requirements IOP-38 to 43 inclusive.</li> -</ul> - - -<p> The sending client creates a fresh correlation id, and the entire test case conversation uses this id.<br/> - The sending client will send the required number of test messages to the test routing key on the default topic exchange.<br/> - The sending client will send a message count report to the coordinator.<br/> - In response to a status request from the coordinator, the receiving client will reply with a message count report. This number will be the number of messages sent multiplied by the number of receivers being simulated by the receiving client.<br/> - The coordinator will compare the messages received to the messages sent and pass or fail the test accordingly.</p> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'> IOP-46. </th> -<th class='confluenceTh'> Basic Pub/Sub Setup. </th> -<td class='confluenceTd'> Prior to assigning roles, the coordinator will choose a routing key for the test. If will create a fresh key for every test case instance. </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-47. </th> -<th class='confluenceTh'> Basic Pub/Sub Invite Parameters. </th> -<td class='confluenceTd'> <table class="sectionMacro" border="0" cellpadding="5" cellspacing="0" width="100%"><tbody><tr><p> In addition to the invite message format defined in IOP-26, the basic pub/sub test invite will also include the following parameters.</p> -<div class="preformatted"><div class="preformattedContent"> -<pre> "PUBSUB_KEY", "<key>"
- "PUBSUB_NUM_RECEIVERS", <count> (signed 32 bit int), PUBSUB_NUM_RECEIVERS property.
- "PUBSUB_NUM_MESSAGES", <count> (signed 32 bit int), PUBSUB_NUM_MESSAGES property.
-</pre> -</div></div> </tr></tbody></table> </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-52. </th> -<th class='confluenceTh'> Test Case 3 Name. </th> -<td class='confluenceTd'> The "TEST_NAME" field in the test invite (IOP-25) will be "TC3_BasicPubSub" for this test. </td> -</tr> -</tbody></table> - -<h3><a name="InteropTestingSpecification-TestCase4.P2PTestwithDifferentMessageSizes."></a>Test Case 4. P2P Test with Different Message Sizes.</h3> - -<ul> - <li>This test case uses requirements IOP-38 to 43 inclusive.</li> -</ul> - - -<p> The sending client creates a fresh correlation id, and the entire test case conversation uses this id.<br/> - The sending client will send the required number of test messages to the test routing key on the default direct exchange.<br/> - The sending client will send a message count report to the coordinator.<br/> - In response to a status request from the coordinator, the receiving client will reply with a message count report.<br/> - The coordinator will compare the messages received to the messages sent and pass or fail the test accordingly.<br/> - The above test cycle will be repeated for each message size to test.</p> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'> IOP-53. </th> -<th class='confluenceTh'> P2P Message Size Test Setup. </th> -<td class='confluenceTd'> Prior to assigning roles, the coordinator will bind a queue to the default direct exchange with a routing key, the same as the queue name. It will create a fresh queue and key for every test case instance. </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-54. </th> -<th class='confluenceTh'> P2P Message Size Test Assign Role Parameters. </th> -<td class='confluenceTd'> <table class="sectionMacro" border="0" cellpadding="5" cellspacing="0" width="100%"><tbody><tr><p> In addition to the invite message format defined in IOP-26, the basic p2p test invite will also include the following parameters.</p> -<div class="preformatted"><div class="preformattedContent"> -<pre> "P2P_QUEUE_AND_KEY_NAME", "<name>"
- "P2P_NUM_MESSAGES", <count> (signed 32 bit int), P2P_NUM_MESSAGES property.
- "messageSize", <count> (signed 32-bit int).
-</pre> -</div></div> </tr></tbody></table> </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-55. </th> -<th class='confluenceTh'> P2P Message Size Test Sizes </th> -<td class='confluenceTd'> The following values for the message size parameter will be tested: 0K, 63K, 64K, 65K, 127K, 128K, 129K, 255K, 256K, 257K. </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-56. </th> -<th class='confluenceTh'> Test Case 4 Name. </th> -<td class='confluenceTd'> The "TEST_NAME" field in the test invite (IOP-25) will be "TC4_P2PMessageSize" for this test. </td> -</tr> -</tbody></table> - -<h3><a name="InteropTestingSpecification-TestCase5.Pub%2FSubTestwithDifferentMessageSizes."></a>Test Case 5. Pub/Sub Test with Different Message Sizes.</h3> - -<ul> - <li>This test case uses requirements IOP-38 to 43 inclusive.</li> -</ul> - - -<p> The sending client creates a fresh correlation id, and the entire test case conversation uses this id.<br/> - The sending client will send the required number of test messages to the test routing key on the default topic exchange.<br/> - The sending client will send a message count report to the coordinator.<br/> - In response to a status request from the coordinator, the receiving client will reply with a message count report. This number will be the number of messages sent multiplied by the number of receivers being simulated by the receiving client.<br/> - The coordinator will compare the messages received to the messages sent and pass or fail the test accordingly.<br/> - The above test cycle will be repeated for each message size to test.</p> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'> IOP-57. </th> -<th class='confluenceTh'> Pub/Sub Message Size Test Setup. </th> -<td class='confluenceTd'> Prior to assigning roles, the coordinator will choose a routing key for the test. If will create a fresh key for every test case instance. </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-58. </th> -<th class='confluenceTh'> Pub/Sub Message Size Test Invite Parameters. </th> -<td class='confluenceTd'> <table class="sectionMacro" border="0" cellpadding="5" cellspacing="0" width="100%"><tbody><tr><p> In addition to the invite message format defined in IOP-26, the basic pub/sub test invite will also include the following parameters.</p> -<div class="preformatted"><div class="preformattedContent"> -<pre> "PUBSUB_KEY", "<key>"
- "PUBSUB_NUM_RECEIVERS", <count> (signed 32 bit int), PUBSUB_NUM_RECEIVERS property.
- "PUBSUB_NUM_MESSAGES", <count> (signed 32 bit int), PUBSUB_NUM_MESSAGES property.
- "messageSize", <count> (signed 32-bit int).
-</pre> -</div></div> </tr></tbody></table> </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-59. </th> -<th class='confluenceTh'> P2P Message Size Test Sizes </th> -<td class='confluenceTd'> The following values for the message size parameter will be tested: 0K, 63K, 64K, 65K, 127K, 128K, 129K, 255K, 256K, 257K. </td> -</tr> -<tr> -<th class='confluenceTh'> IOP-60. </th> -<th class='confluenceTh'> Test Case 5 Name. </th> -<td class='confluenceTd'> The "TEST_NAME" field in the test invite (IOP-25) will be "TC5_PubSubMessageSize" for this test. </td> -</tr> -</tbody></table> - -<h2><a name="InteropTestingSpecification-WaitingRoom%3A"></a>Waiting Room:</h2> - -<p> Contains ideas for possible future directions relating to this spec.</p> - -<p> <ins>Command processor.</ins> Test cases to be written using a command language (perhaps in XML) on top of a common client API. Interpreter for this to be implemented using each client library. Test cases need only be written once and can be run by the interpreters. Command language rich enough to exercise the whole AMQP protocol. May not handle client specific edge cases. Good for ensuring test consistency, but may take a fair amount of time to do.</p> - -<p> <ins>How I anticipate this being run as part of a fully automated build.</ins> Will try to get a free licence for Anthill Pro 3 as they offer free licences for open source projects. Viewtier Parabuild is another possibility. Anthill Pro runs a central build server that does all its work through build agents that can run on many boxes. It also lets you define build workflows. I imagine running a Unix agent to build the c++, java and python stuff, and a Windows agent for the .net stuff. Will define a workflow that starts a broker on the unix box, then starts all clients built on the unix and windows boxes in parallel, then runs the entire test procedure across all clients, then terminates the broker on the unix box. The agents send back the test results to the central server.</p> - -<p> <ins>Full testing of field tables.</ins> Make sure that every possible data type is tested and confirmed to encode and decode correctly between all client implementations.</p> - -<p> <ins>Testing more of the protocol.</ins> Add tests to more fully exercise the complete AMQP protocol.</p> - -<p> <ins>Allow scaling of test clients.</ins> Each test client should only be run once (in each environment) and they create unique names for themselves. Tests are only run between pairs of single clients, with a single sender and number of receivers defined by the test case (often 1). Clients listen for control messages on topics, and use correlation id's in all tests messages to differentiate themselves, were multiple senders to be active. This has been done deliberately to allow for future expansion of the test framework to allow scaling up of the tests by starting more clients in parallel on the same environment. To do this each client might also create a sequence number, to unqiuely identify itself, as the client names will no longer be unique. Reports from senders will include client name, sequence number and correlation id. Status requests to receivers may specify client name, sequence number and correlation id to get specific reports, or ommit correlation id or sequence number to get a bulk report of all messages with a particular client.</p> - -<p> <ins>More sophisticated reporting.</ins> Message count reports are fairly minimal. Might also put an entire list of messages send/recieved in a report, in order to check that there were no ommissions or duplicates.</p> - -<h2><a name="InteropTestingSpecification-AppendixA%2CGeneralNotes%3A"></a>Appendix A, General Notes:</h2> - -<p> Brokers that need to be interop tested: C++ and Java</p> - -<p> Clients that need to be interop tested: C++ , Java, Java 1.4 retrotranslation, C++, .Net 2.0, .Net 1.1, (Mono?), Python, Ruby.</p> - -<h2><a name="InteropTestingSpecification-AppendixB%2CExampleofXMLFormatforTestOuput%3A"></a>Appendix B, Example of XML Format for Test Ouput:</h2> - -<p> I don't think there is a DTD or schema for this but the XML output from JUnit looks like the example below. This is a convenient choice for the output format from these test results even if the code does not actually use JUnit (or cppunit or nunit) iternally, because automated build servers generally understand and are able to produce test reports from it.</p> - -<p> Example:</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre><?xml version="1.0" encoding="UTF-8" ?>
-<testsuite errors="0" skipped="0" tests="18" time="0.02" failures="0" name="org.apache.qpid.framing.BasicContentHeaderPropertiesTest">
- <properties>
- <property value="Java(TM) 2 Runtime Environment, Standard Edition" name="java.runtime.name"/>
- ... (there were lots of properties).
- </properties>
- <testcase time="0.02" name="testRejectedExecution"/>
- ... (there were lots of test cases).
-</testsuite>
-</pre> -</div></div> - -<h2><a name="InteropTestingSpecification-AppendixC%2CTestParameters."></a>Appendix C, Test Parameters.</h2> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'> </th> -<td class='confluenceTd'> Possible Values </td> -<td class='confluenceTd'> Default Value </td> -</tr> -<tr> -<th class='confluenceTh'> Connection properties. </th> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> broker </td> -<td class='confluenceTd'> tcp, vm </td> -<td class='confluenceTd'> tcp://localhost </td> -</tr> -<tr> -<td class='confluenceTd'> vhost </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> <empty> </td> -</tr> -<tr> -<td class='confluenceTd'> username </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> guest </td> -</tr> -<tr> -<td class='confluenceTd'> password </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> guest </td> -</tr> -<tr> -<th class='confluenceTh'> Topology properties. </th> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> max_publishing_node </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> 1 </td> -</tr> -<tr> -<td class='confluenceTd'> single_role </td> -<td class='confluenceTd'> true, false </td> -<td class='confluenceTd'> true </td> -</tr> -<tr> -<th class='confluenceTh'> Circuit properties. </th> -<td class='confluenceTd'> Total: 2^2 = 4 combinations. </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> num_publishers </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> 1 </td> -</tr> -<tr> -<td class='confluenceTd'> num_consumers </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> 1 </td> -</tr> -<tr> -<td class='confluenceTd'> num_destinations </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> 1 </td> -</tr> -<tr> -<td class='confluenceTd'> base_out_route_name </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> ping </td> -</tr> -<tr> -<td class='confluenceTd'> base_in_route_name </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> pong </td> -</tr> -<tr> -<td class='confluenceTd'> bind_out_route </td> -<td class='confluenceTd'> true, false </td> -<td class='confluenceTd'> true </td> -</tr> -<tr> -<td class='confluenceTd'> bind_in_route </td> -<td class='confluenceTd'> true, false </td> -<td class='confluenceTd'> false </td> -</tr> -<tr> -<td class='confluenceTd'> consumer_out_active </td> -<td class='confluenceTd'> true, false </td> -<td class='confluenceTd'> true </td> -</tr> -<tr> -<td class='confluenceTd'> consumer_in_active </td> -<td class='confluenceTd'> true, false </td> -<td class='confluenceTd'> false </td> -</tr> -<tr> -<th class='confluenceTh'> JMS flags and options. </th> -<td class='confluenceTd'> Total: 2 * 2 * 2 * 6 = 48 combinations. </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> transactional </td> -<td class='confluenceTd'> true, false </td> -<td class='confluenceTd'> false </td> -</tr> -<tr> -<td class='confluenceTd'> persistent </td> -<td class='confluenceTd'> true, false </td> -<td class='confluenceTd'> false </td> -</tr> -<tr> -<td class='confluenceTd'> no_local </td> -<td class='confluenceTd'> true, false </td> -<td class='confluenceTd'> false </td> -</tr> -<tr> -<td class='confluenceTd'> ack_mode </td> -<td class='confluenceTd'> tx, auto, client, dups_ok, no_ack, pre_ack </td> -<td class='confluenceTd'> auto </td> -</tr> -<tr> -<th class='confluenceTh'> AMQP/Qpid flags and options. </th> -<td class='confluenceTd'> Total: 2^4 = 16 combinations. </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> exclusive </td> -<td class='confluenceTd'> true, false </td> -<td class='confluenceTd'> false </td> -</tr> -<tr> -<td class='confluenceTd'> immediate </td> -<td class='confluenceTd'> true, false </td> -<td class='confluenceTd'> false </td> -</tr> -<tr> -<td class='confluenceTd'> mandatory </td> -<td class='confluenceTd'> true, false </td> -<td class='confluenceTd'> false </td> -</tr> -<tr> -<td class='confluenceTd'> durable </td> -<td class='confluenceTd'> true, false </td> -<td class='confluenceTd'> false </td> -</tr> -<tr> -<td class='confluenceTd'> prefetch_size </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> header_fields </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<th class='confluenceTh'> Standard test parameters. </th> -<td class='confluenceTd'> Total: 3 combinations. </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> message_size </td> -<td class='confluenceTd'> no_body, one_body, multi_body </td> -<td class='confluenceTd'> one_body </td> -</tr> -<tr> -<td class='confluenceTd'> num_messages </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> 100 </td> -</tr> -<tr> -<td class='confluenceTd'> outgoing_rate </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> inbound_rate </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> timeout </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> 30 seconds </td> -</tr> -<tr> -<td class='confluenceTd'> tx_batch_size </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> 100 </td> -</tr> -<tr> -<td class='confluenceTd'> max_pending_data </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> </td> -</tr> -</tbody></table> - -<p>Total combinations over all test parameters: 4 * 48 * 16 * 3 = 9216 combinations.</p> - -<p>Defaults give an in-VM broker, 1:1 P2P topology, no tx, auto ack, no flags, publisher -> receiver route configured, no return route.</p> - -<h2><a name="InteropTestingSpecification-AppendixD%2CCommandlineoptions."></a>Appendix D, Command line options.</h2> - -<p> IOP-21 states that general parameters can be passed on the command line using name=value syntax. The coordinator understands the following parameters, and will use them to override the default values for the tests. Individual test cases refer to the command line parameter that they take their test parameters from.</p> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'> Parameter </th> -<th class='confluenceTh'> Default </th> -</tr> -<tr> -<td class='confluenceTd'> P2P_NUM_MESSAGES </td> -<td class='confluenceTd'> 50 </td> -</tr> -<tr> -<td class='confluenceTd'> PUBSUB_NUM_RECEIVERS </td> -<td class='confluenceTd'> 5 </td> -</tr> -<tr> -<td class='confluenceTd'> PUBSUB_NUM_MESSAGES </td> -<td class='confluenceTd'> 10 </td> -</tr> -</tbody></table> - -<h2><a name="InteropTestingSpecification-AppendixE%2CClockSynchronizationAlgorithm."></a>Appendix E, Clock Synchronization Algorithm.</h2> - -<p>On connection/initialization of the framework, synch clocks between all nodes in the available toplogy. For in vm tests, the clock delta and error will automatically be zero. For throughput measurements, the overall test times will be long enough that the error does not need to be particularly small. For latency measurements, want to get accurate clock synchronization. This should not be too hard to achieve over a quiet local network.</p> - -<p>After determining the list of clients available to conduct tests against, the Coordinator synchronizes the clocks of each in turn. The synchronization is done against one client at a time, at a fairly low messaging rate over the Qpid broker. If needed, a more accurate mechanism, using something like NTP over UDP could be used. Ensure the clock synchronization is captured by an interface, to allow better solutions to be added at a later date. Here is a simple algorithm to get started with:</p> - -<ol> - <li>Coordinator tells client to synchronize its clock with the coordinators time.</li> - <li>Client stamps current local time on a "time request" message and sends to Coordinator.</li> - <li>Upon receipt by Coordinator, Coordinator stamps Coordinator-time and returns.</li> - <li>Upon receipt by Client, Client subtracts current time from sent time and divides by two to compute latency. It subtracts current time from Coordinator time to determine Client-Coordinator time delta and adds in the half-latency to get the correct clock delta.</li> - <li>The first result should immediately be used to update the clock since it will get the local clock into at least the right ballpark.</li> - <li>The Client repeats steps 1 through 3, 25 or more times, pausing a few tens of milliseconds each time.</li> - <li>The results of the packet receipts are accumulated and sorted in lowest-latency to highest-latency order. The median latency is determined by picking the mid-point sample from this ordered list.</li> - <li>All samples above approximately 1 standard-deviation from the median are discarded and the remaining samples are averaged using an arithmetic mean.</li> -</ol> - - -<p>The above algorithm includes broker latency, two network hops each way, plus possible effects of buffering/resends on the TCP protocol. A fairly easy improvement on it might be:</p> - -<ol> - <li>Coordinator tells client to synchronize its clock with the coordinators time, provides a port/address to synchronize against.</li> - <li>Clients sends UDP packets to the Coordinators address and performs the same procedure as outlined above.</li> -</ol> - - -<h2><a name="InteropTestingSpecification-AppendixF%2CDeletedRequirements%3A"></a>Appendix F, Deleted Requirements:</h2> - -<p> Put deleted requirements here, in case they can be re-used.</p> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'> IOP. </th> -<th class='confluenceTh'> Client Start Messages Per Test. </th> -<td class='confluenceTd'> The -m <num_messages> option will be used to tell the client how many messages to send per test. </td> -</tr> -<tr> -<th class='confluenceTh'> IOP. </th> -<th class='confluenceTh'> Client Number of Receivers. </th> -<td class='confluenceTd'> For topic testing each client will simulate the behaviour of many clients listening to the same topic. The number of receivers per test client for topic tests will be sepcified by the -r <num_receivers> command line option. </td> -</tr> -<tr> -<th class='confluenceTh'> IOP. </th> -<th class='confluenceTh'> Client Default P2P Test Direct Key. </th> -<td class='confluenceTd'> Each test client will listen for test messages on the default direct exchange. The routing key for these messages will consist of the client name (see IOP-35) followed by ".direct". </td> -</tr> -<tr> -<th class='confluenceTh'> IOP. </th> -<th class='confluenceTh'> Client Default Pub/Sub Test Direct Key. </th> -<td class='confluenceTd'> Each test client will listen for test messages on the default topic exchange. The routing key for these messages will consist of the client name (see IOP-35) followed by ".topic". </td> -</tr> -<tr> -<th class='confluenceTh'> IOP. </th> -<th class='confluenceTh'> Test Done Message. </th> -<td class='confluenceTd'> <table class="sectionMacro" border="0" cellpadding="5" cellspacing="0" width="100%"><tbody><tr><p> Once a test client has completed its role, it will send the coordinator a test done message on the control topic. This message will be identified by the header field, "CONTROL_TYPE", having the value, "TEST_DONE". The client will also post its name in the "CLIENT_NAME" header field.</p> -<div class="preformatted"><div class="preformattedContent"> -<pre> "CONTROL_TYPE", "TEST_DONE"
-</pre> -</div></div> </tr></tbody></table> </td> -</tr> -<tr> -<th class='confluenceTh'> IOP. </th> -<th class='confluenceTh'> End Role Message. </th> -<td class='confluenceTd'> <table class="sectionMacro" border="0" cellpadding="5" cellspacing="0" width="100%"><tbody><tr><p> Once the coordinator receives a report for a test case, it will send end role messages to the private control topics of all clients participating in the test case. This message will be identified by the header field, "CONTROL_TYPE", having the value, "END_ROLE".</p> -<div class="preformatted"><div class="preformattedContent"> -<pre> "CONTROL_TYPE", "END_ROLE"
-</pre> -</div></div> </tr></tbody></table> </td> -</tr> -<tr> -<th class='confluenceTh'> IOP. </th> -<th class='confluenceTh'> Client Status Request Message. </th> -<td class='confluenceTd'> <table class="sectionMacro" border="0" cellpadding="5" cellspacing="0" width="100%"><tbody><tr><p> When a test client has completed sending test messages it may request the count of actual messages receieved from the test client to which it sent the messages. The status request message will be send to the receving test clients individual control topic. This message will be identified by the header field, "CONTROL_TYPE", having the value, "STATUS_REQUEST", and will contain the name of the sending client in the header field "CLIENT_NAME".</p> -<div class="preformatted"><div class="preformattedContent"> -<pre> "CONTROL_TYPE", "STATUS_REQUEST"
- "CLIENT_NAME", "<client_name>"
-</pre> -</div></div> </tr></tbody></table> </td> -</tr> -</tbody></table> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/JDBCStore.html b/content/xdocs/JDBCStore.html deleted file mode 100755 index 19861362b9..0000000000 --- a/content/xdocs/JDBCStore.html +++ /dev/null @@ -1,38 +0,0 @@ -<html> - <head> - <title>Apache Qpid : JDBCStore</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : JDBCStore - </span> - </div> - <div class="pagesubheading"> - This page last changed on Jul 04, 2007 by <font color="#0050B2">ritchiem</font>. - </div> - - <h2><a name="JDBCStore-JDBCStore"></a>JDBCStore</h2> - -<p>This is a MessageStore that uses a JDBC connection as a backing store for the broker.</p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/JMS Compliance.html b/content/xdocs/JMS Compliance.html deleted file mode 100755 index 7e15d701df..0000000000 --- a/content/xdocs/JMS Compliance.html +++ /dev/null @@ -1,41 +0,0 @@ -<html> - <head> - <title>Apache Qpid : JMS Compliance</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : JMS Compliance - </span> - </div> - <div class="pagesubheading"> - This page last changed on Dec 07, 2006 by <font color="#0050B2">ritchiem</font>. - </div> - - <h3><a name="JMSCompliance-StricktJMSCompliance"></a>Strickt JMS Compliance</h3> -<p>By default where AMQP is more flexible than JMS the AMQP option is used. To restrict operation to the JMS 1.1 specification set the system property:</p> -<div class="preformatted"><div class="preformattedContent"> -<pre>-Dstrict-jms=true
-</pre> -</div></div> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/JMX Management Console.html b/content/xdocs/JMX Management Console.html deleted file mode 100755 index 3fd5eb6b7a..0000000000 --- a/content/xdocs/JMX Management Console.html +++ /dev/null @@ -1,64 +0,0 @@ -<html> - <head> - <title>Apache Qpid : JMX Management Console</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : JMX Management Console - </span> - </div> - <div class="pagesubheading"> - This page last changed on Jul 04, 2007 by <font color="#0050B2">ritchiem</font>. - </div> - - <h2><a name="JMXManagementConsole-JMXManagementConsole"></a>JMX Management Console</h2> - -<h3><a name="JMXManagementConsole-Overview"></a>Overview</h3> - -<p>The current Management console is an eclipse application that communicates with the broker of JMX. </p> - -<ul><li><a href="Configuring Qpid Management Console.html" title="Configuring Qpid Management Console">Configuring Qpid Management Console</a></li><li><a href="FAQ.html" title="FAQ">FAQ</a></li><li><a href="Qpid Management Features.html" title="Qpid Management Features">Qpid Management Features</a></li></ul> - - <br/> - <div class="tabletitle"> - <a name="attachments">Attachments:</a> - </div> - - <div class="greybox" align="left"> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="JMX Management Console_attachments/Qpid_using_jconsole.doc">Qpid_using_jconsole.doc</a> (application/msword) - <br/> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="JMX Management Console_attachments/Qpid_using_jconsole.doc">Qpid_using_jconsole.doc</a> (application/msword) - <br/> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="JMX Management Console_attachments/Qpid_Management_Console.doc">Qpid_Management_Console.doc</a> (application/msword) - <br/> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="JMX Management Console_attachments/Qpid_Management_Console.doc">Qpid_Management_Console.doc</a> (application/msword) - <br/> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="JMX Management Console_attachments/Qpid_Management_Console.doc">Qpid_Management_Console.doc</a> (application/msword) - <br/> - </div> - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/JMX Management Console_attachments/Qpid_Management_Console.doc b/content/xdocs/JMX Management Console_attachments/Qpid_Management_Console.doc Binary files differdeleted file mode 100755 index 245f171d2f..0000000000 --- a/content/xdocs/JMX Management Console_attachments/Qpid_Management_Console.doc +++ /dev/null diff --git a/content/xdocs/JMX Management Console_attachments/Qpid_using_jconsole.doc b/content/xdocs/JMX Management Console_attachments/Qpid_using_jconsole.doc Binary files differdeleted file mode 100755 index 910e004218..0000000000 --- a/content/xdocs/JMX Management Console_attachments/Qpid_using_jconsole.doc +++ /dev/null diff --git a/content/xdocs/Java Architecture Overview.html b/content/xdocs/Java Architecture Overview.html deleted file mode 100755 index 4328d7d615..0000000000 --- a/content/xdocs/Java Architecture Overview.html +++ /dev/null @@ -1,46 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Java Architecture Overview</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Java Architecture Overview - </span> - </div> - <div class="pagesubheading"> - This page last changed on Dec 14, 2007 by <font color="#0050B2">ritchiem</font>. - </div> - - <p><img src="Java Architecture Overview_attachments/Qpid-architecture.png" align="absmiddle" border="0" /></p> - - <br/> - <div class="tabletitle"> - <a name="attachments">Attachments:</a> - </div> - - <div class="greybox" align="left"> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="Java Architecture Overview_attachments/Qpid-architecture.png">Qpid-architecture.png</a> (image/png) - <br/> - </div> - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Java Architecture Overview_attachments/Qpid-architecture.png b/content/xdocs/Java Architecture Overview_attachments/Qpid-architecture.png Binary files differdeleted file mode 100755 index fbf600200f..0000000000 --- a/content/xdocs/Java Architecture Overview_attachments/Qpid-architecture.png +++ /dev/null diff --git a/content/xdocs/Java Broker Design - MessageStore.html b/content/xdocs/Java Broker Design - MessageStore.html deleted file mode 100755 index 01e45bd524..0000000000 --- a/content/xdocs/Java Broker Design - MessageStore.html +++ /dev/null @@ -1,39 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Java Broker Design - MessageStore</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Java Broker Design - MessageStore - </span> - </div> - <div class="pagesubheading"> - This page last changed on Jul 04, 2007 by <font color="#0050B2">ritchiem</font>. - </div> - - <p>The MessageStore interface allows us to abstract the method by which the message data is stored within the broker.</p> - -<h3><a name="JavaBrokerDesign-MessageStore-Currentlyavailableimplementations"></a>Currently available implementations</h3> -<ul><li><a href="BDBMessageStore (3rd Party).html" title="BDBMessageStore (3rd Party)">BDBMessageStore (3rd Party)</a></li><li><a href="JDBCStore.html" title="JDBCStore">JDBCStore</a></li><li><a href="MemoryMessageStore.html" title="MemoryMessageStore">MemoryMessageStore</a></li></ul> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Java Coding Standards.html b/content/xdocs/Java Coding Standards.html deleted file mode 100755 index e8a81e171b..0000000000 --- a/content/xdocs/Java Coding Standards.html +++ /dev/null @@ -1,406 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Java Coding Standards</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Java Coding Standards - </span> - </div> - <div class="pagesubheading"> - This page last changed on Oct 19, 2006 by <font color="#0050B2">rgreig</font>. - </div> - - <p>This page documents the standard adopted for Java code in the Qpid project. All committers are expected to follow these standards; checkstyle or similar is used to check compliance.</p> - -<h3><a name="JavaCodingStandards-ExecutiveSummary"></a>Executive Summary</h3> - -<p>The main things for layout purposes in the standard are:</p> - -<ul> - <li>Indent using four spaces. <b>No tabs</b>.</li> - <li>braces always go on new lines, e.g.</li> -</ul> - - -<div class="code"><div class="codeContent"> -<pre class="code-java"><span class="code-keyword">if</span> (x == 5)
-{
- <span class="code-object">System</span>.out.println(<span class="code-quote">"Hello"</span>);
-}</pre> -</div></div> - -<p>rather than</p> -<div class="code"><div class="codeContent"> -<pre class="code-java"><span class="code-keyword">if</span> (x == 5} {
- <span class="code-object">System</span>.out.println(<span class="code-quote">"Hello"</span>);
-}</pre> -</div></div> -<ul> - <li>Always add braces, e.g. -<div class="code"><div class="codeContent"> -<pre class="code-java"><span class="code-keyword">if</span> (x == 5)
-{
- <span class="code-object">System</span>.out.println(<span class="code-quote">"Hello"</span>);
-}</pre> -</div></div></li> -</ul> - - -<p>rather than</p> -<div class="code"><div class="codeContent"> -<pre class="code-java"><span class="code-keyword">if</span> (x == 5}
- <span class="code-object">System</span>.out.println(<span class="code-quote">"Hello"</span>);</pre> -</div></div> -<ul> - <li>Fields prefixed with underscores, e.g. _messageCount</li> - <li>Spaces after keywords but no spaces either before or after parentheses in method calls, e.g. -<div class="code"><div class="codeContent"> -<pre class="code-java"><span class="code-keyword">if</span> (x == 5)</pre> -</div></div> -<p>rather than</p> -<div class="code"><div class="codeContent"> -<pre class="code-java"><span class="code-keyword">if</span>(x==5)</pre> -</div></div> -<p>but</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">foo.bar(4, 5)</pre> -</div></div> -<p>rather than</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">foo.bar( 4, 5 )</pre> -</div></div></li> -</ul> - - -<h3><a name="JavaCodingStandards-Details"></a>Details</h3> - -<h4><a name="JavaCodingStandards-Introduction"></a>Introduction</h4> - -<p>This document describes two types of coding standard:</p> - -<p>1. <b>Mandatory</b> standards must be followed at all times.<br/> -2. <b>Recommended</b> standards should in general be followed but in particular cases may be omitted where the programmer feels that there is a good reason to do so.</p> - -<p>Code that does not adhere to mandatory standards will not pass the automated checks (or a code review if the guideline is not stylistic).</p> - -<h4><a name="JavaCodingStandards-Sourcefiles"></a>Source files</h4> -<p>This section defines the general rules associated with the contents of a Java source file and the order in which the each part should be presented. No rules on programming style, naming conventions or indentation are given here.</p> - -<ol> - <li>Java source files must have a ".java" suffix (this will be enforced by the compiler) [mandatory].</li> - <li>The basename of a Java source file must be the same as the public class defined therein (this will be enforced by the compiler) [mandatory].</li> - <li>Only one class should be defined per source file (except for inner classes and one-shot uses where the non-public class cannot conceivably be used outside of its context) [mandatory].</li> - <li>Source files should not exceed 1500 lines [recommended].</li> - <li>No line in a source file should exceed 120 characters [mandatory].</li> - <li>The sections of a source file should be presented in the following order [mandatory]:</li> -</ol> -<ul> - <li>File information comment (see rule 7 below).</li> - <li>Package name (see rules 1 to 3 in the section 2.1 above and rule 8 below).</li> - <li>Imports (see rules 9 to 10 below).</li> - <li>Other class definitions.</li> - <li>Public class definition.</li> -</ul> -<ol> - <li>Do not use automatically expanded log or revision number provided by your source code management system unless it provides a facility to avoid "false conflicts" when doing merges due simply to revision number changes (which happens, for example, with cvs when branches are used). [mandatory]</li> - <li>Every class that is to be released must be a member of a package [mandatory].<br/> -Rationale: classes that are not explicitly put in a package are placed in the unnamed package by the compiler. Therefore as the classes from many developers will be being placed in the same package the likelihood of a name clash is greatly increased. </li> - <li>All class imports from the same package should be grouped together. A single blank line should separate imports from different packages [recommended].</li> - <li>Use javadoc tags and use HTML mark-up to enhance the readability of the output files [mandatory].</li> -</ol> - - -<h3><a name="JavaCodingStandards-JavaElements"></a>Java Elements</h3> -<p>This section gives advice on coding the various elements of the Java programming language.</p> -<h4><a name="JavaCodingStandards-Classdefinitions"></a>Class definitions</h4> -<p>This section gives guidelines for class and interface definitions in Java. The term class in this section is used more broadly to mean class and interface:</p> -<ol> - <li>Class names should start with a capital letter with every subsequent word capitalised, for example: DataProcessor [mandatory].</li> - <li>The name of exception classes should end in the word exception, for example: UnknownMungeException [mandatory].</li> - <li>Class names should in general not be overloaded. For example, defining a class "com.foo.bar.String" should be avoided as there is already a class "java.lang.String" [recommended].<br/> -Rationale: adhering to this rule reduces the likelihood of confusion and means that the use of fully qualified class names should not be required. </li> - <li>The definition of the primary class (i.e. the class with the same name as the java file) should start in column 0 of the source file. Inner class definitions should be indented 4 spaces more than their enclosing class [mandatory].</li> - <li>Declare a class as final only if specialisation will never be required and improved performance is essential. With modern JVMs there in fact may be no performance advantage. Warning: use of final limits code reuse [mandatory].</li> - <li>For all but simplest classes the following methods should have useful definitions [recommended]: -<div class="code"><div class="codeContent"> -<pre class="code-java"><span class="code-keyword">public</span> <span class="code-object">boolean</span> equals(<span class="code-object">Object</span> obj)
-<span class="code-keyword">public</span> <span class="code-object">int</span> hashCode()
-<span class="code-keyword">public</span> <span class="code-object">String</span> toString()</pre> -</div></div></li> - <li>The order of presentation of the sections in a class should be [mandatory]:</li> -</ol> -<ul> - <li>Variables</li> - <li>Methods -<h4><a name="JavaCodingStandards-Variables"></a>Variables</h4> -<p>This section gives guidelines for class and instance variable definitions in Java. In this section if a rule uses the term variable rather than instance variable or class variable, then the rule applies to both types of variable.</p></li> -</ul> -<ol> - <li>The order of presentation of variables in a class definition should be [recommended]:</li> -</ol> -<ul> - <li>private, protected, public: static final variables (aka constant class variables).</li> - <li>private, protected, public: static variables (aka class variables).</li> - <li>private, protected, public: final variables (aka constant instance variables).</li> - <li>private, protected, public: variables (aka instance variables).<br/> -It should be noted that as javadoc will automatically order variables in a consistent manner, rigid adherence to this rule is not necessary.</li> -</ul> -<ol> - <li>Variable modifiers should be presented in the following order: static, final, transient, volatile [mandatory].</li> - <li>The names of static final variables should be upper case with subsequent words prefixed with an underscore [mandatory]. For example: -<div class="code"><div class="codeContent"> -<pre class="code-java"><span class="code-keyword">public</span> <span class="code-keyword">static</span> <span class="code-keyword">final</span> <span class="code-object">int</span> NOT_FOUND = -1;</pre> -</div></div></li> - <li>When a subclass refers to a static final variable defined in a parent class, access should be qualified by specifying the defining class name [mandatory]. For example: use ParentClass.MAX rather than MAX.</li> - <li>The names of variables (other that static final) should start with a lower case letter. Any words that are contained in the rest of the variable name should be capitalised [mandatory]. For example: -<div class="code"><div class="codeContent"> -<pre class="code-java"><span class="code-object">String</span> name;
-<span class="code-object">String</span>[] childrensNames;</pre> -</div></div></li> - <li>Class and instance variables must be prefixed with an underscore (_) [mandatory].</li> - <li>Variables must not be named using the so-called Hungarian notation [mandatory]. For example: -<div class="code"><div class="codeContent"> -<pre class="code-java"><span class="code-object">int</span> nCount = 4; <span class="code-comment">// not allowed</span></pre> -</div></div></li> - <li>Only one variable may be defined per line [mandatory].</li> - <li>Variable declarations should be indented 4 spaces more than their enclosing class [mandatory].</li> - <li>All variables should be preceded by a javadoc comment that specifies what the variable is for, where it is used and so forth. The comment should be of the following form and be indented to the same level as the variable it refers to [mandatory]</li> - <li>Never declare instance variables as public unless the class is effectively a "struct" [mandatory].</li> - <li>Never give a variable the same name as a variable in a superclass [mandatory].</li> - <li>Ensure that all non-private class variables have sensible values even if no instances have been created (use static initialisers if necessary, i.e. "static { ... }") [mandatory].<br/> -Rationale: prevents other objects accessing fields with undefined/unexpected values. -<h4><a name="JavaCodingStandards-Methods"></a>Methods</h4> -<p>This section gives guidelines for class and instance method definitions in Java. In this section if a rule uses the term method rather than instance method or class method, then the rule applies to both types of method.</p></li> - <li>Constructors and finalize methods should follow immediately after the variable declarations [mandatory].</li> - <li>Do not call non-final methods from constructors. This can lead to unexpected results when the class is subclassed. If you must call non-final methods from constructors, document this in the constructor's javadoc [mandatory]. Note that private implies final.</li> - <li>Methods that are associated with the same area of functionality should be physically close to one another [recommended].</li> - <li>After grouping by functionality, methods should be presented in the following order [recommended]:</li> -</ol> -<ul> - <li>private, protected, public: static methods.</li> - <li>private, protected, public: instance methods.<br/> -It should be noted that as javadoc will automatically order methods in a consistent manner, rigid adherence to this rule is not necessary.</li> -</ul> -<ol> - <li>Method modifiers should be presented in the following order: abstract, static, final., synchronized [mandatory]</li> - <li>When a synchronized method is overloaded, it should be explicitly synchronized in the subclass [recommended].</li> - <li>Method names should start with a lower case letter with all subsequent words being capitalised [mandatory]. For example: -<div class="code"><div class="codeContent"> -<pre class="code-java"><span class="code-keyword">protected</span> <span class="code-object">int</span> resize(<span class="code-object">int</span> newSize)
-<span class="code-keyword">protected</span> void addContentsTo(Container destinationContainer)</pre> -</div></div></li> - <li>Methods which get and set values should be named as follows [mandatory]: -<div class="code"><div class="codeContent"> -<pre class="code-java">Type getVariableName()
-void setVariableName(Type newValue)</pre> -</div></div> -<p>Exceptions should be used to report any failure to get or set a value. The "@param" description should detail any assumptions made by the implementation, for example: "Specifying a null value will cause an error to be reported".</p></li> - <li>Method definitions should be indented 4 spaces more than their enclosing class [mandatory].</li> - <li>All methods should be preceded by a javadoc comment specifying what the method is for, detailing all arguments, returns and possible exceptions. This comment should be of the following form and be indented to the same level as the method it refers to [mandatory]:</li> - <li>The braces associated with a method should be on a line on their own and be indented to the same level as the method [mandatory]. For example: -<div class="code"><div class="codeContent"> -<pre class="code-java"><span class="code-keyword">public</span> void munge()
-{
- <span class="code-object">int</span> i;
- <span class="code-comment">// method definition omitted...
-</span>}</pre> -</div></div></li> - <li>The body of a method should be indented 4 columns further that the opening and closing braces associated with it [mandatory]. See the above rule for an example.</li> - <li>When declaring and calling methods there should be no white space before or after the parenthesis [mandatory].</li> - <li>In argument lists there should be no white space before a comma, and only a single space (or newline) after it [mandatory]. For example: -<div class="code"><div class="codeContent"> -<pre class="code-java"><span class="code-keyword">public</span> void munge(<span class="code-object">int</span> depth, <span class="code-object">String</span> name)
-{
- <span class="code-keyword">if</span> (depth > 0)
- {
- munge(depth - 1, name);
- }
- <span class="code-comment">// <span class="code-keyword">do</span> something
-</span>}</pre> -</div></div></li> - <li>Wherever reasonable define a default constructor (i.e. one that takes no arguments) so that Class.newInstance() may be used [recommended]. If an instance which was created by default construction could be used until further initialisation has been performed, then all unserviceable requests should cause a runtime exception to be thrown.</li> - <li>The method public static void main() should not be used for test purposes. Instead a test/demo program should be supplied separately. [mandatory].</li> - <li>Public access methods (i.e. methods that get and set attributes) should only be supplied when required [mandatory].</li> - <li>If an instance method has no natural return value, declare it as void rather than using the "return this;" convention [mandatory].</li> - <li>Ensure that non-private static methods behave sensibly if no instances of the defining class have been created [mandatory]. -<h4><a name="JavaCodingStandards-Expressions"></a>Expressions</h4> -<p>This section defines the rules to be used for Java expressions:</p></li> - <li>Unary operators should not be separated from their operand by white space [mandatory].</li> - <li>Embedded ++ or – operators should only be used when it improves code clarity [recommended]. This is rare.</li> - <li>Extra parenthesis should be used in expressions to improve their clarity [recommended].</li> - <li>The logical expression operand of the "?:" (ternary) operator must be enclosed in parenthesis. If the other operands are also expressions then they should also be enclosed in parenthesis [mandatory]. For example: -<div class="code"><div class="codeContent"> -<pre class="code-java">biggest = (a > b) ? a : b;
-complex = (a + b > 100) ? (100 * c) : (10 * d);</pre> -</div></div></li> - <li>Nested "?:" (ternary) operators can be confusing and should be avoided [mandatory].</li> - <li>Use of the binary "," operator (the comma operator) should be avoided [mandatory]. Putting all the work of a for loop on a single line is not a sign of great wisdom and talent.</li> - <li>If an expression is too long for a line (i.e. extends beyond column 119) then it should be split after the lowest precedence operator near the break [mandatory]. For example: -<div class="code"><div class="codeContent"> -<pre class="code-java"><span class="code-keyword">if</span> ((state == NEED_TO_REPLY) ||
- (state == REPLY_ACK_TIMEOUT))
-{
- <span class="code-comment">// (re)send the reply and enter state WAITING_FOR_REPLY_ACK
-</span>}</pre> -</div></div> -<p>Furthermore if an expression requires to be split more than once, then the split should occur at the same logical level if possible.</p></li> - <li>All binary and ternary operators (exception for ".") should be separated from their operands by a space [mandatory]. -<h4><a name="JavaCodingStandards-Statements"></a>Statements</h4> -<h5><a name="JavaCodingStandards-SimpleStatements"></a>Simple Statements</h5> -<p>This section defines the general rules for simple Java statements:</p></li> - <li>There must only be one statement per line [mandatory].</li> - <li>In general local variables should be named in a similar manner to instance variables [recommended].</li> - <li>More than one temporary variable may be declared on a single line provided no initialisers are used [mandatory]. For example: -<div class="code"><div class="codeContent"> -<pre class="code-java"><span class="code-object">int</span> j, k = 10, l; <span class="code-comment">// Incorrect!
-</span><span class="code-object">int</span> j, l; <span class="code-comment">// Correct
-</span><span class="code-object">int</span> k = 10;</pre> -</div></div></li> - <li>A null body for a while, for, if, etc. should be documented so that it is clearly intentional [mandatory].</li> - <li>Keywords that are followed by a parenthesised expression (such as while, if, etc) should be separated from the open bracket by a single space [mandatory]. For example: -<div class="code"><div class="codeContent"> -<pre class="code-java"><span class="code-keyword">if</span> (a > b)
-{
- munge();
-}</pre> -</div></div></li> - <li>In method calls, there should be no spaces before or after the parentheses [mandatory]. For example: -<div class="code"><div class="codeContent"> -<pre class="code-java">munge (a, 10); <span class="code-comment">// Incorrect!
-</span>munge(a, 10); <span class="code-comment">// Correct.</span></pre> -</div></div> -<h5><a name="JavaCodingStandards-CompoundStatements"></a>Compound Statements</h5> -<p>This section defines the general rules associated with compound statements in Java:</p></li> - <li>The body of a compound statement should be indented by 4 spaces more than the enclosing braces [mandatory]. See the following rule for an example.</li> - <li>The braces associated with a compound statement should be on their own line and be indented to the same level as the surrounding code [mandatory]. For example: -<div class="code"><div class="codeContent"> -<pre class="code-java"><span class="code-keyword">if</span> ((length >= LEN_BOX) && (width >= WID_BOX))
-{
- <span class="code-object">int</span> i;
- <span class="code-comment">// Statements omitted...
-</span>}</pre> -</div></div></li> - <li>If the opening and closing braces associated with a compound statement are further than 20 lines apart then the closing brace should annotated as follows [mandatory]: -<div class="code"><div class="codeContent"> -<pre class="code-java"><span class="code-keyword">for</span> (<span class="code-object">int</span> j = 0; j < SIZE; j++)
-{
- lotsOfCode();
-} <span class="code-comment">// end <span class="code-keyword">for</span></span></pre> -</div></div></li> - <li>All statements associated with an if or if-else statement should be made compound by the use of braces [mandatory]. For example: -<div class="code"><div class="codeContent"> -<pre class="code-java"><span class="code-keyword">if</span> (a > b)
-{
- statement();
-}
-<span class="code-keyword">else</span>
-{
- statement1();
- statement2();
-}</pre> -</div></div></li> - <li>The case labels in a switch statement should be on their own line and indented by a further 4 spaces. The statements associated with the label should be indented by 4 columns more than the label and not be enclosed in a compound statement. [mandatory]. For example: -<div class="code"><div class="codeContent"> -<pre class="code-java"><span class="code-keyword">switch</span> (tState)
-{
- <span class="code-keyword">case</span> NOT_RUNNING:
- start();
- <span class="code-keyword">break</span>;
-
- <span class="code-keyword">case</span> RUNNING:
- <span class="code-keyword">default</span>:
- monitor();
- <span class="code-keyword">break</span>;
-}</pre> -</div></div></li> - <li>In switch statements - the statements associated with all cases should terminate with a statement which explicitly determines the flow of control, for example break [recommended].</li> - <li>In switch statements - fall through should be avoided wherever possible, however if it is unavoidable it must be commented with "// FALLTHROUGH" [mandatory].</li> - <li>In switch statements - a default case must be present and should always be the last case [mandatory]. -<h4><a name="JavaCodingStandards-General"></a>General</h4> -<p>This section gives general rules to be followed when programming in Java:</p></li> - <li>When comparing objects for equivalence use the method equals() and not the == operator. The only exceptions to this are static final objects that are being used as constants and interned Strings [mandatory].</li> - <li>In general labelled break and continue statements should be avoided [recommended]. This is due to the complex flow of control, especially when used with try/finally blocks.</li> - <li>Unless some aspect of an algorithm relies on it, then loops count forward [mandatory]. For example: -<div class="code"><div class="codeContent"> -<pre class="code-java"><span class="code-keyword">for</span> (<span class="code-object">int</span> j = 0; j < size; j++)
-{
- <span class="code-comment">// Do something interesting
-</span>}</pre> -</div></div></li> - <li>Use local variables in loops [recommended]. For example: -<div class="code"><div class="codeContent"> -<pre class="code-java">ArrayList clone = (ArrayList)listeners.clone();
-<span class="code-keyword">final</span> <span class="code-object">int</span> size = clone.size();
-<span class="code-keyword">for</span> (<span class="code-object">int</span> j = 0; j < size; j++)
-{
- <span class="code-object">System</span>.out.println(clone.elementAt(j));
-}</pre> -</div></div></li> - <li>Anonymous inner classes should define no instance variables and be limited to three single line methods. Inner classes that declare instance variables or have more complex methods should be named [mandatory].</li> - <li>Use final local variables where possible to help avoid errors in code [recommended]. For example: -<div class="code"><div class="codeContent"> -<pre class="code-java"><span class="code-keyword">public</span> void foo()
-{
- <span class="code-keyword">final</span> <span class="code-object">int</span> x = dataSource.getCount();
- <span class="code-comment">// <span class="code-keyword">do</span> things with x
-</span> <span class="code-comment">// ...
-</span>}</pre> -</div></div> -<h4><a name="JavaCodingStandards-Exceptions"></a>Exceptions</h4> -<p>This section gives general guidance on the use of exceptions when programming in Java.</p></li> - <li>try/catch blocks should be laid out like any other compound statement [mandatory]. For example: -<div class="code"><div class="codeContent"> -<pre class="code-java"><span class="code-keyword">try</span>
-{
- <span class="code-object">String</span> str = someStrings[specifiedIndex];
-}
-<span class="code-keyword">catch</span> (IndexOutOfBoundsException ex)
-{
- <span class="code-comment">// The user specified an incorrect index, better take
-</span> <span class="code-comment">// some remedial action.
-</span>}</pre> -</div></div> -<p>4. When an exception is caught but ignored then a comment should be supplied explaining the rationale [mandatory]. For example:</p> -<div class="code"><div class="codeContent"> -<pre class="code-java"><span class="code-keyword">try</span>
-{
- propertySet.setProperty(<span class="code-quote">"thingy"</span>, <span class="code-keyword">new</span> <span class="code-object">Integer</span>(10));
-}
-<span class="code-keyword">catch</span> (UnknownPropertyException ignore)
-{
- <span class="code-comment">// This exception will never occur as <span class="code-quote">"thingy"</span> definitely exists
-</span>}</pre> -</div></div></li> - <li>All exceptions that are likely to be thrown by a method should be documented, except if they are runtime exceptions (note: the compiler will not enforce catch blocks for runtimes even if they are mentioned in the throws clause) [mandatory]. For example: -<div class="code"><div class="codeContent"> -<pre class="code-java">/* Comment snippet:
- * @exception IllegalValueException Thrown <span class="code-keyword">if</span> values is <span class="code-keyword">null</span> or
- * any of the integers it contains is <span class="code-keyword">null</span>.
- */
-<span class="code-keyword">private</span> <span class="code-object">Integer</span> sum(<span class="code-object">Integer</span>[] values) <span class="code-keyword">throws</span> IllegalValueException</pre> -</div></div></li> -</ol> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Java Unit Tests with InVM Broker.html b/content/xdocs/Java Unit Tests with InVM Broker.html deleted file mode 100755 index ec5f9191e6..0000000000 --- a/content/xdocs/Java Unit Tests with InVM Broker.html +++ /dev/null @@ -1,84 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Java Unit Tests with InVM Broker</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Java Unit Tests with InVM Broker - </span> - </div> - <div class="pagesubheading"> - This page last changed on Mar 28, 2008 by <font color="#0050B2">godfrer</font>. - </div> - - <h2><a name="JavaUnitTestswithInVMBroker-SampleCode"></a>Sample Code</h2> - -<p>Here is a template for correctly creating a unit test that will use the InVM Broker.</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre>
- @Before
- public void initialSetup() throws Exception
- {
- createVMBroker();
-
- //Any other setup code
-
- }
-
- public void createVMBroker()
- {
- try
- {
- TransportConnection.createVMBroker(1);
- // Multiple Brokers can be created by passing in a different port. The above is connected to with the url vm://:1
- }
- catch (AMQVMBrokerCreationException e)
- {
- Assert.fail("Unable to create broker: " + e);
- }
- }
-
- @After
- public void stopVmBroker()
- {
- // If you created a connection in the @Before be sure to close it before you kill the broker or
- // it will attempt failover, and recreate the broker.
- TransportConnection.killVMBroker(1);
- //Remember to kill any other brokers you create
- }
-
- @Test
- public void yourTest code() throws Exception
- {
- //If you do your connection setup here
- Connection con = new AMQConnection("vm://:1", "guest", "guest", "consumer1", "test");
-
-
- // Be sure to close it before you end the test
- con.close();
- }
-</pre> -</div></div> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/License.html b/content/xdocs/License.html deleted file mode 100755 index 5165d80991..0000000000 --- a/content/xdocs/License.html +++ /dev/null @@ -1,100 +0,0 @@ -<html> - <head> - <title>Apache Qpid : License</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : License - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 11, 2008 by <font color="#0050B2">cctrieloff</font>. - </div> - - <p>Qpid is licensed in under the ASL 2.0. Please look at the notice files provided with the downloads to see the list of embedded components.</p> -<div class="panel"><div class="panelContent"> -<p>Apache License<br/> - Version 2.0, January 2004<br/> -<a href="http://www.apache.org/licenses/" title="Visit page outside Confluence">http://www.apache.org/licenses/</a><br/> - TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION</p> - -<p><b>1. Definitions</b>.</p> - -<p> "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document.</p> - -<p> "Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License.</p> - -<p> "Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means ( i ) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity.</p> - -<p> "You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License.</p> - -<p> "Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files.</p> - -<p> "Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types.</p> - -<p> "Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below).</p> - -<p> "Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof.</p> - -<p> "Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution."</p> - -<p> "Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work.</p> - -<p><b>2. Grant of Copyright License</b>. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.</p> - -<p><b>3. Grant of Patent License</b>. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed.</p> - -<p><b>4. Redistribution</b>. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions:</p> -<ol> - <li>You must give any other recipients of the Work or Derivative Works a copy of this License; and</li> -</ol> - - -<ol> - <li>You must cause any modified files to carry prominent notices stating that You changed the files; and</li> -</ol> - - -<ol> - <li>You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and</li> -</ol> - - -<ol> - <li>If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License.</li> -</ol> - - -<p> You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License.<br/> -<b>5. Submission of Contributions</b>. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions.</p> - -<p><b>6. Trademarks</b>. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file.</p> - -<p><b>7. Disclaimer of Warranty</b>. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License.</p> - -<p><b>8. Limitation of Liability</b>. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages.</p> - -<p><b>9. Accepting Warranty or Additional Liability</b>. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability.</p> -</div></div> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Low-Level API Diagram.html b/content/xdocs/Low-Level API Diagram.html deleted file mode 100755 index 0ae6033ae6..0000000000 --- a/content/xdocs/Low-Level API Diagram.html +++ /dev/null @@ -1,46 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Low-Level API Diagram</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Low-Level API Diagram - </span> - </div> - <div class="pagesubheading"> - This page last changed on Aug 22, 2007 by <font color="#0050B2">rupertlssmith</font>. - </div> - - <p><img src="Low-Level API Diagram_attachments/API.gif" align="absmiddle" border="0" /></p> - - <br/> - <div class="tabletitle"> - <a name="attachments">Attachments:</a> - </div> - - <div class="greybox" align="left"> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="Low-Level API Diagram_attachments/api.GIF">api.GIF</a> (image/gif) - <br/> - </div> - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Low-Level API Diagram_attachments/api.GIF b/content/xdocs/Low-Level API Diagram_attachments/api.GIF Binary files differdeleted file mode 100755 index ba9395e961..0000000000 --- a/content/xdocs/Low-Level API Diagram_attachments/api.GIF +++ /dev/null diff --git a/content/xdocs/M1 Release Check list.html b/content/xdocs/M1 Release Check list.html deleted file mode 100755 index c0034ea8b0..0000000000 --- a/content/xdocs/M1 Release Check list.html +++ /dev/null @@ -1,97 +0,0 @@ -<html> - <head> - <title>Apache Qpid : M1 Release Check list</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : M1 Release Check list - </span> - </div> - <div class="pagesubheading"> - This page last changed on Nov 10, 2006 by <font color="#0050B2">ritchiem</font>. - </div> - - <table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'> Item Description </th> -<th class='confluenceTh'> Status </th> -</tr> -<tr> -<td class='confluenceTd'> Check license for dependencies </td> -<td class='confluenceTd'> Complete MM 10 Nov, required licenses added </td> -</tr> -<tr> -<td class='confluenceTd'> Create NOTICE.txt and LICENSE.txt in the root folder </td> -<td class='confluenceTd'> Complete QPID-74, QPID-79 </td> -</tr> -<tr> -<td class='confluenceTd'> Add all attributions to NOTICE.txt </td> -<td class='confluenceTd'> Complete MM 10 Nov, required attributions added </td> -</tr> -<tr> -<td class='confluenceTd'> Task to create source distribution </td> -<td class='confluenceTd'> Complete QPID-74 ant target 'std-src-release'</td> -</tr> -<tr> -<td class='confluenceTd'> Task to create binary distribution<br clear="all" /> </td> -<td class='confluenceTd'> Complete QPID-73 ant target 'std-bin-release'</td> -</tr> -<tr> -<td class='confluenceTd'> Proper naming of release artifacts<br clear="all" /> </td> -<td class='confluenceTd'> Complete QPID-77 </td> -</tr> -<tr> -<td class='confluenceTd'> Check if all release jars containing a LICENSE.txt and NOTICE.txt<br clear="all" /> </td> -<td class='confluenceTd'> Complete QPID-78 </td> -</tr> -<tr> -<td class='confluenceTd'> Proper versioning (adding the correct version numbers to the jar/src files)<br clear="all" /> </td> -<td class='confluenceTd'> QPID-73 & QPID-74 ?</td> -</tr> -<tr> -<td class='confluenceTd'> Check if Subversion tag is created for release <br clear="all" /> </td> -<td class='confluenceTd'> Rajith to action please </td> -</tr> -<tr> -<td class='confluenceTd'> Release Notes </td> -<td class='confluenceTd'> Complete QPID-79 </td> -</tr> -<tr> -<td class='confluenceTd'> README doc in the root folder </td> -<td class='confluenceTd'> Complete QPID-79 </td> -</tr> -<tr> -<td class='confluenceTd'> Basic documentation </td> -<td class='confluenceTd'> Complete and ref'd in release notes and readme </td> -</tr> -<tr> -<td class='confluenceTd'> Keys ready for singing the release </td> -<td class='confluenceTd'> Rajith/Gordon to action please QPID-82 pending </td> -</tr> -<tr> -<td class='confluenceTd'> Adding minimum JDK version for the client/common (1.4) and broker (1.5) </td> -<td class='confluenceTd'> Complete QPID-83 </td> -</tr> -</tbody></table> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/M1 Release.html b/content/xdocs/M1 Release.html deleted file mode 100755 index 3162adcad4..0000000000 --- a/content/xdocs/M1 Release.html +++ /dev/null @@ -1,51 +0,0 @@ -<html> - <head> - <title>Apache Qpid : M1 Release</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : M1 Release - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 19, 2007 by <font color="#0050B2">mmccorma</font>. - </div> - - <h1><a name="M1Release-M1ReleaseCOMPLETED14thDec2006"></a>M1 Release - COMPLETED 14th Dec 2006</h1> - -<p>Target Date - November 2006 (tbc)</p> - -<p>Release Manager - Rajith Attapattu</p> - -<h2><a name="M1Release-ReleaseNotes"></a>Release Notes</h2> - -<p>You can view our release notes for M1 at:</p> - -<p><a href="https://issues.apache.org/jira/secure/ReleaseNote.jspa?version=12312115&styleName=Html&projectId=12310520" title="Visit page outside Confluence">https://issues.apache.org/jira/secure/ReleaseNote.jspa?version=12312115&styleName=Html&projectId=12310520</a></p> - -<h2><a name="M1Release-ReleaseChecklist"></a>Release Check list</h2> -<p> <a href="M1 Release Check list.html" title="M1 Release Check list">M1 Release Check list</a></p> - -<h2><a name="M1Release-SupportedFeatureList"></a>Supported Feature List </h2> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/M2 - config.xml.html b/content/xdocs/M2 - config.xml.html deleted file mode 100644 index bd14dbe439..0000000000 --- a/content/xdocs/M2 - config.xml.html +++ /dev/null @@ -1,249 +0,0 @@ -<html> - <head> - <title>Apache Qpid : M2 - config.xml</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : M2 - config.xml - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 08, 2008 by <font color="#0050B2">ritchiem</font>. - </div> - - <h2><a name="M2-config.xml-M2Brokerconfig.xmldetails"></a>M2 Broker config.xml details</h2> - -<h3><a name="M2-config.xml-ChangesfromM1configuration"></a>Changes from M1 configuration</h3> - - -<h3><a name="M2-config.xml-FileFormat"></a>File Format</h3> -<p>This is an overview of the top level of the config file. Description of each section is embedded below. Each section is then described in detail in their own section.</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre><broker>
-<!-- Various initial global definitions -->
- <connector>
-<!-- Various connection information about the type connections the broker should listen for-->
- <management>
-<!-- Enablement of management functionality -->
- <advanced>
-<!-- Various advanced flags -->
- <security>
-<!-- Definition of available security options -->
- <virtualhosts>
-<!-- Definition of available virtual hosts -->
- <heartbeat>
-<!-- Heartbeat configuration -->
- <queue>
-<!-- General queue configuration options-->
- <virtualhosts>
-<!-- Configuration of various virtual hosts. -->
-</broker>
-
-</pre> -</div></div> - -<h2><a name="M2-config.xml-ConfigurationSectionsDetailedInformation"></a>Configuration Sections - Detailed Information</h2> - -<p>The following sections provide an element by element overview of the config.xml.</p> - -<h3><a name="M2-config.xml-Broker"></a>Broker</h3> - -<p>The setting of the prefixes for QPID_HOME and QPID_WORK allows environment variables to be used throughout the config.xml and removes the need for hard coding of paths in this file.</p> - -<p>See the <a href="Getting Started Guide.html" title="Getting Started Guide">Getting Started Guide</a> for more information on these variables.</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre><broker>
- <prefix>${QPID_HOME}</prefix>
- <work>${QPID_WORK}</work>
- <conf>${prefix}/etc</conf>
-</pre> -</div></div> - -<h3><a name="M2-config.xml-Connector"></a>Connector</h3> - -<p>The connector section allows configuration of SSL and related keystore settings. By default this section is commented out and thus SSL is not enabled.</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre><connector>
- <!-- Uncomment out this block and edit the keystorePath and keystorePassword
- to enable SSL support
- <ssl>
- <enabled>true</enabled>
- <sslOnly>true</sslOnly>
- <keystorePath>/path/to/keystore.ks</keystorePath>
- <keystorePassword>keystorepass</keystorePassword>
- </ssl>-->
- <qpidnio>true</qpidnio>
- <transport>nio</transport>
- <port>5672</port>
- <sslport>8672</sslport>
- <socketReceiveBuffer>32768</socketReceiveBuffer>
- <socketSendBuffer>32768</socketSendBuffer>
-</connector>
-</pre> -</div></div> - -<h3><a name="M2-config.xml-Management"></a>Management</h3> - -<p>This element allows the user to switch the connectivity of the management console on/off i.e. if the enabled tag is set to false you will not be able to connect a management console to this broker instance.</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre><management>
- <enabled>true</enabled>
-</management>
-</pre> -</div></div> - -<h3><a name="M2-config.xml-Advanced"></a>Advanced</h3> -<p>The elements in this section are used under the covers in the broker. At present, we do not recommend any changes to these settings.</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre><advanced>
- <filterchain enableExecutorPool="true"/>
- <enablePooledAllocator>false</enablePooledAllocator>
- <enableDirectBuffers>false</enableDirectBuffers>
- <framesize>65535</framesize>
- <compressBufferOnQueue>false</compressBufferOnQueue>
-</advanced>
-</pre> -</div></div> - -<h3><a name="M2-config.xml-Security"></a>Security</h3> - -<p>This section lists all the principal databases that are available for authentication and the default access control. The databases understand what SASL mechanisms can be used against their data and so are responsible for registering these SASL mechanisms. Currently we do not provide means of limiting these mechanisms.</p> -<div class="preformatted"><div class="preformattedContent"> -<pre><security>
- <principal-databases>
- <principal-database>
- <!-- A name for referencing this database-->
- <name>passwordfile</name>
- <!-- The type of principal database -->
- <class>org.apache.qpid.server.security.auth.database.PlainPasswordVhostFilePrincipalDatabase</class>
- <!-- Any attributes associated with the database. Here it is a password file to load. -->
- <attributes>
- <attribute>
- <name>passwordFile</name>
- <value>${conf}/passwdVhost</value>
- </attribute>
- </attributes>
- </principal-database>
- </principal-databases>
- <!-- This access value can be any access manager. The built in defaults are AllowAll and DenyAll -->
- <access>
- <class>org.apache.qpid.server.security.access.AllowAll</class>
- </access>
- <!-- Properties required when running the JMX Management console. -->
- <jmx>
- <!-- Access file that allows users rights to access the management console. -->
- <access>${conf}/jmxremote.access</access>
- <!-- The principal database to use to authenticate users. -->
- <principal-database>passwordfile</principal-database>
- </jmx>
-</security>
-</pre> -</div></div> - -<h3><a name="M2-config.xml-Virtualhosts"></a>Virtualhosts</h3> - -<p>This section allows you to define the set of virtual hosts which will be contained in your broker instance, and the message store & location for each. NB: The commented out section referencing BDBMessageStore should be used for all applications wishing to use persistence to disk. </p> - -<p>If you are using transient messaging you can use the MemoryMessageStore, with the caveat that scalability for transient use is limited by heap size.</p> - -<p>In our example config.xml, we define three virtual hosts which we commonly use for development (development), system testing (test) and integration testing (localhost). In the config.xml the per virtual host sections define both the Message Store in use (MemoryMessageStore for non-persistent applications or BDBMessageStore for persistent application usage) and the security for each virtual host. The security settings are under currently development so subject to changes.</p> - -<p>The default virtual host for connections which do not specify a host on the url is 'test' in the example config.xml.</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre><virtualhost>
- <name>localhost</name>
- <localhost>
- <store>
- <!-- <class>org.apache.qpid.server.store.berkeleydb.BDBMessageStore</class>
- <environment-path>${work}/localhost-store</environment-path> -->
-
- <class>org.apache.qpid.server.store.MemoryMessageStore</class>
- </store>
-
- <security>
- <!-- Need protocol changes to allow this-->
- <authentication>
- <name>passwordfile</name>
- <!-- Currently this can't be used as Vhost isn't specified at connection start only connection open -->
- <mechanism>PLAIN</mechanism>
- </authentication>
- <access>
- <class>org.apache.qpid.server.security.access.PrincipalDatabaseAccessManager</class>
- <attributes>
- <attribute>
- <name>principalDatabase</name>
- <value>passwordfile</value>
- </attribute>
- <attribute>
- <name>defaultAccessManager</name>
- <value>DenyAll</value>
- </attribute>
- </attributes>
- </access>
- </security>
- </localhost>
- </virtualhost>
-</pre> -</div></div> - -<h3><a name="M2-config.xml-Heartbeat"></a>Heartbeat</h3> - -<p>The Qpid broker sends an internal (only) heartbeat. This element allows configuration of the frequency of this heartbeat. At present, we recommend that you leave this section unchanged !</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre><heartbeat>
- <delay>0</delay>
- <timeoutFactor>2.0</timeoutFactor>
-</heartbeat>
-</pre> -</div></div> - -<h3><a name="M2-config.xml-Queue"></a>Queue</h3> - -<p>This should NOT be changed lightly as it sets the broker up to automatically bind queues to exchanges. </p> - -<p>It could theoretically be used to prevent users creating new queues at runtime, assuming that you have created all queues/topics etc at broker startup. However, best advice is to leave unchanged for now.</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre><queue>
- <auto_register>true</auto_register>
-</queue>
-</pre> -</div></div> - -<h3><a name="M2-config.xml-Virtualhosts"></a>Virtualhosts</h3> - -<p>This element allows you to specify a location for the virtualhosts.xml file that you wish to use. If you are not using a subdirectory under $QPID_HOME you can provide a fully qualified path instead. For more information on the content of the virtualhosts.xml file please see <a href="Configure the Virtual Hosts via virtualhosts.xml.html" title="Configure the Virtual Hosts via virtualhosts.xml">Configure the Virtual Hosts via virtualhosts.xml</a></p> - -<div class="preformatted"><div class="preformattedContent"> -<pre><virtualhosts>${conf}/virtualhosts.xml</virtualhosts>
-</pre> -</div></div> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/M2 Release.html b/content/xdocs/M2 Release.html deleted file mode 100755 index 0d916e0b52..0000000000 --- a/content/xdocs/M2 Release.html +++ /dev/null @@ -1,112 +0,0 @@ -<html> - <head> - <title>Apache Qpid : M2 Release</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : M2 Release - </span> - </div> - <div class="pagesubheading"> - This page last changed on Jun 18, 2007 by <font color="#0050B2">ritchiem</font>. - </div> - - <h2><a name="M2Release-M2ReleaseOverview"></a>M2 Release - Overview</h2> - -<p>The Qpid project voted to make an M2 release (see this <a href="http://mail-archives.apache.org/mod_mbox/incubator-qpid-dev/200703.mbox/%3cb9472b590703060341j5221bd9et1102f5782070e576@mail.gmail.com%3e" title="Visit page outside Confluence">thread</a>) which will include:</p> - -<p>Java Broker (with a caveat on the clustered broker code)<br/> -Java Client<br/> -C++ Broker<br/> -C++ Client<br/> -.NET Client<br/> -Python Client<br/> -Ruby Client</p> - -<p>This will be a significant step up from the M1 Release, which only included the Java components.</p> - -<h2><a name="M2Release-M2ReleaseTasks"></a>M2 Release Tasks</h2> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'> Task </th> -<th class='confluenceTh'> Status </th> -<th class='confluenceTh'> Owner </th> -<th class='confluenceTh'> Notes </th> -</tr> -<tr> -<td class='confluenceTd'> Identify Release Manager </td> -<td class='confluenceTd'> Complete </td> -<td class='confluenceTd'> Marnie McCormack </td> -<td class='confluenceTd'> Rajith Attapattu volunteered </td> -</tr> -<tr> -<td class='confluenceTd'> Identify JIRAs for inclusion in M2 </td> -<td class='confluenceTd'> In Progress </td> -<td class='confluenceTd'> Marnie McCormack </td> -<td class='confluenceTd'> Tidying up M2 tasks to leave only open tasks for release + showstoppers </td> -</tr> -<tr> -<td class='confluenceTd'> Define minimal interop requirements for M2 </td> -<td class='confluenceTd'> Complete </td> -<td class='confluenceTd'> Rupert Smith </td> -<td class='confluenceTd'> Interop test suites now exist in Java/C++/.Net. Covers fairly minimal use-cases of basic p2p and pub/sub messaging. </td> -</tr> -<tr> -<td class='confluenceTd'> Identify License Issues </td> -<td class='confluenceTd'> Not Started </td> -<td class='confluenceTd'> ? </td> -<td class='confluenceTd'> Aware that there are probably license tidy ups for Java and need to review license list for C++ etc </td> -</tr> -<tr> -<td class='confluenceTd'> c++ broker and client owner </td> -<td class='confluenceTd'> In progress </td> -<td class='confluenceTd'> Rajith </td> -<td class='confluenceTd'> Alan volunteered to handle the c++ broker and client release </td> -</tr> -<tr> -<td class='confluenceTd'> Python and Ruby client owner </td> -<td class='confluenceTd'> In progress </td> -<td class='confluenceTd'> Rajith </td> -<td class='confluenceTd'> Rafi volunteered to handle the Ruby and Python client release </td> -</tr> -<tr> -<td class='confluenceTd'> java broker and client owner </td> -<td class='confluenceTd'> In progress </td> -<td class='confluenceTd'> Rajith </td> -<td class='confluenceTd'> Martin volunteered to handle the Java broker and client release </td> -</tr> -</tbody></table> - -<h2><a name="M2Release-C%5CClient%2FBrokerActionItemsforM2release"></a>C++ Client/Broker Action - Items for M2 release</h2> - -<p><a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&&pid=12310520&component=12311395&component=12311396&fixfor=12312116&sorter/field=issuekey&sorter/order=DESC" title="Visit page outside Confluence">C++ JIRAs for M2</a></p> - -<h2><a name="M2Release-Python%26RubyClientsActionItemsforM2release"></a>Python & Ruby Clients - Action Items for M2 release</h2> - - -<h2><a name="M2Release-JavaClient%2FBrokerActionItemsforM2release"></a>Java Client/Broker - Action Items for M2 release</h2> - -<p><a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&&pid=12310520&status=1&status=3&status=4&component=12311388&component=12311389&component=12311585&component=12311490&component=12311630&component=12311614&component=12311501&component=12311489&fixfor=12312116&sorter/field=issuekey&sorter/order=DESC" title="Visit page outside Confluence">Java JIRAs for M2 </a></p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/M2.1 - config.xml.html b/content/xdocs/M2.1 - config.xml.html deleted file mode 100755 index 1f8998370b..0000000000 --- a/content/xdocs/M2.1 - config.xml.html +++ /dev/null @@ -1,266 +0,0 @@ -<html> - <head> - <title>Apache Qpid : M2.1 - config.xml</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : M2.1 - config.xml - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 08, 2008 by <font color="#0050B2">ritchiem</font>. - </div> - - <h2><a name="M2.1-config.xml-M2.1Brokerconfig.xmldetails"></a>M2.1 Broker config.xml details</h2> - -<h3><a name="M2.1-config.xml-QpidUpgradestepsfromM2"></a>Qpid Upgrade steps from M2</h3> - -<p>Here are the manual changes required to config.xml for M2.1:</p> - -<p>1. Remove use of old password format</p> -<ul> - <li>Replace line '<class>org.apache.qpid.server.security.auth.database.PlainPasswordVHostFilePrincipalDatabase</class>'</li> - <li>With '<class>org.apache.qpid.server.security.auth.database.PlainPasswordFilePrincipalDatabase</class>'</li> - <li>Change format of the password file '${conf}/passwdVhost' to be username:password</li> - <li>Rename file on disk '${conf}/passwdVhost' to '${conf}/passwd'</li> - <li>Replace config line '<value>${conf}/passwdVhost</value>' with '<value>${conf}/passwd</value>'</li> - <li>For details on how to configure the new ACLs to restore the per VirtualHost Access rights see <a href="Configure ACLs.html" title="Configure ACLs">Configure ACLs</a></li> -</ul> - - -<p>2. Update package of AllowAll</p> -<ul> - <li>Replace line '<class>org.apache.qpid.server.security.access.AllowAll</class>'</li> - <li>With '<class>org.apache.qpid.server.security.access.plugins.AllowAll</class>'</li> -</ul> - - -<p>3. Remove all Security sections from virtualhosts</p> - - -<h3><a name="M2.1-config.xml-ChangesfromM2configuration"></a>Changes from M2 configuration</h3> - -<p>There are a four sections with changes that have occurred since M2. Taking them in order as they appear in the file the first change is in the <em>connector</em> section. The <em>protectio</em> feature is new its purpose is to limit the underlying send and receive buffers so that they do not grow unbounded. Testing has shown this feature to affect performance so further work is required to fully understand the impact.</p> - -<p>The <em>advanced</em> section now includes a boolean <em>enableJMSXUserID</em> which causes the broker to stamp every message with the UserID of the producing connection. This has an impact on performance so will be improved in a later release with client side setting of JMSXUserID and broker side verification, which is a low overhead.</p> - -<p>The <em>security</em> section has had a couple of changes. The <em>PlainPasswordVHostFilePrincipalDatabase</em> was an early attempt to show how ACLs could be performed. The introduction of a more comprehensive ACL package now removes the need for that class and so the use of <em>PlainPasswordFilePrincipalDatabase</em> would be recommended instead. The change to ACLs also included the repackaging of the <em>AllowAll</em> ACL class to be in a <em>pluings</em> package.</p> - -<p>The <em>virtualhost</em> sections now have new security sections based on the type of ACL being used. The documentation of which will occur on the a different page. </p> - - -<h3><a name="M2.1-config.xml-FileFormat"></a>File Format</h3> -<p>This is an overview of the top level of the config file. Description of each section is embedded below. Each section is then described in detail in their own section. Each section that has changes from M2 is highlighted.</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre><broker>
- <connector>
-<!-- Type of connections and properties --> <!-- Additional features in M2.1 -->
- <management>
-<!-- Enablement of management functionality -->
- <advanced>
-<!-- Various advanced flags --> <!-- Additional features in M2.1 -->
- <security>
-<!-- Definition of available security options --> <!-- M2 Incompatible changes in M2.1 -->
- <virtualhosts>
-<!-- Definition of available virtual hosts --> <!-- M2 Incompatible changes in M2.1 -->
- <heartbeat>
-<!-- Heartbeat configuration -->
- <queue>
-<!-- General queue configuration options-->
- <virtualhosts>
-<!-- Configuration of various virtual hosts. -->
-</broker>
-
-</pre> -</div></div> - -<h2><a name="M2.1-config.xml-ConfigurationSectionsDetailedInformation"></a>Configuration Sections - Detailed Information</h2> - -<p>The following sections provide an element by element overview of the config.xml.</p> - -<h3><a name="M2.1-config.xml-Broker"></a>Broker</h3> - -<p>The setting of the prefixes for QPID_HOME and QPID_WORK allows environment variables to be used throughout the config.xml and removes the need for hard coding of paths in this file.</p> - -<p>See the <a href="Getting Started Guide.html" title="Getting Started Guide">Getting Started Guide</a> for more information on these variables.</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre><broker>
- <prefix>${QPID_HOME}</prefix>
- <work>${QPID_WORK}</work>
- <conf>${prefix}/etc</conf>
-</pre> -</div></div> - -<h3><a name="M2.1-config.xml-Connector"></a>Connector</h3> - -<p>The connector section allows configuration of SSL and related keystore settings. By default this section is commented out and thus SSL is not enabled.</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre><connector>
- <!-- Uncomment out this block and edit the keystorePath and keystorePassword
- to enable SSL support
- <ssl>
- <enabled>true</enabled>
- <sslOnly>true</sslOnly>
- <keystorePath>/path/to/keystore.ks</keystorePath>
- <keystorePassword>keystorepass</keystorePassword>
- </ssl>-->
- <qpidnio>false</qpidnio>
- <protectio> <!-- New Feature in M2.1 -->
- <enabled>false</enabled>
- <readBufferLimitSize>262144</readBufferLimitSize>
- <writeBufferLimitSize>262144</writeBufferLimitSize>
- </protectio>
- <transport>nio</transport>
- <port>5672</port>
- <sslport>8672</sslport>
- <socketReceiveBuffer>32768</socketReceiveBuffer>
- <socketSendBuffer>32768</socketSendBuffer>
-</connector>
-</pre> -</div></div> - -<h3><a name="M2.1-config.xml-Management"></a>Management</h3> - -<p>This element allows the user to switch the connectivity of the management console on/off i.e. if the enabled tag is set to false you will not be able to connect a management console to this broker instance.</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre><management>
- <enabled>true</enabled>
-</management>
-</pre> -</div></div> - -<h3><a name="M2.1-config.xml-Advanced"></a>Advanced</h3> -<p>The elements in this section are used under the covers in the broker. At present, we do not recommend any changes to these settings.</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre><advanced>
- <filterchain enableExecutorPool="true"/>
- <enablePooledAllocator>false</enablePooledAllocator>
- <enableDirectBuffers>false</enableDirectBuffers>
- <framesize>65535</framesize>
- <compressBufferOnQueue>false</compressBufferOnQueue>
- <enableJMSXUserID>false</enableJMSXUserID> <!-- Additional features in M2.1 -->
-</advanced>
-</pre> -</div></div> - -<h3><a name="M2.1-config.xml-Security"></a>Security</h3> - -<p>This section lists all the principal databases that are available for authentication and the default access control. The databases understand what SASL mechanisms can be used against their data and so are responsible for registering these SASL mechanisms. Currently we do not provide means of limiting these mechanisms.</p> -<div class="preformatted"><div class="preformattedContent"> -<pre><security>
- <principal-databases>
- <principal-database>
- <!-- A name for referencing this database-->
- <name>passwordfile</name>
- <!-- The type of principal database -->
- <class>org.apache.qpid.server.security.auth.database.PlainPasswordFilePrincipalDatabase</class>
- <!-- Any attributes associated with the database. Here it is a password file to load. -->
- <attributes>
- <attribute>
- <name>passwordFile</name>
- <value>${conf}/passwd</value>
- </attribute>
- </attributes>
- </principal-database>
- </principal-databases>
- <!-- This access value can be any access manager. The built in defaults are AllowAll and DenyAll -->
- <access>
- <class>org.apache.qpid.server.security.access.plugin.AllowAll</class> <!-- NOTE class change in M2.1 -->
- </access>
- <!-- Properties required when running the JMX Management console. -->
- <jmx>
- <!-- Access file that allows users rights to access the management console. -->
- <access>${conf}/jmxremote.access</access>
- <!-- The principal database to use to authenticate users. -->
- <principal-database>passwordfile</principal-database>
- </jmx>
-</security>
-</pre> -</div></div> - -<h3><a name="M2.1-config.xml-Virtualhosts"></a>Virtualhosts</h3> - -<p>This section allows you to define the set of virtual hosts which will be contained in your broker instance, and the message store & location for each. NB: The commented out section referencing BDBMessageStore should be used for all applications wishing to use persistence to disk. </p> - -<p>If you are using transient messaging you can use the MemoryMessageStore, with the caveat that scalability for transient use is limited by heap size.</p> - -<p>In our example config.xml, we define three virtual hosts which we commonly use for development (development), system testing (test) and integration testing (localhost). In the config.xml the per virtual host sections define both the Message Store in use (MemoryMessageStore for non-persistent applications or BDBMessageStore for persistent application usage) and the security for each virtual host. The security settings are under currently development so subject to changes.</p> - -<p>The default virtual host for connections which do not specify a host on the url is 'test' in the example config.xml.</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre><virtualhost>
- <name>localhost</name>
- <localhost>
- <store>
- <!-- <class>org.apache.qpid.server.store.berkeleydb.BDBMessageStore</class>
- <environment-path>${work}/localhost-store</environment-path> -->
-
- <class>org.apache.qpid.server.store.MemoryMessageStore</class>
- </store>
- </localhost>
- </virtualhost>
-</pre> -</div></div> - -<h3><a name="M2.1-config.xml-Heartbeat"></a>Heartbeat</h3> - -<p>The Qpid broker sends an internal (only) heartbeat. This element allows configuration of the frequency of this heartbeat. At present, we recommend that you leave this section unchanged !</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre><heartbeat>
- <delay>0</delay>
- <timeoutFactor>2.0</timeoutFactor>
-</heartbeat>
-</pre> -</div></div> - -<h3><a name="M2.1-config.xml-Queue"></a>Queue</h3> - -<p>This should NOT be changed lightly as it sets the broker up to automatically bind queues to exchanges. </p> - -<p>It could theoretically be used to prevent users creating new queues at runtime, assuming that you have created all queues/topics etc at broker startup. However, best advice is to leave unchanged for now.</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre><queue>
- <auto_register>true</auto_register>
-</queue>
-</pre> -</div></div> - -<h3><a name="M2.1-config.xml-Virtualhosts"></a>Virtualhosts</h3> - -<p>This element allows you to specify a location for the virtualhosts.xml file that you wish to use. If you are not using a subdirectory under $QPID_HOME you can provide a fully qualified path instead. For more information on the content of the virtualhosts.xml file please see <a href="Configure the Virtual Hosts via virtualhosts.xml.html" title="Configure the Virtual Hosts via virtualhosts.xml">Configure the Virtual Hosts via virtualhosts.xml</a></p> - -<div class="preformatted"><div class="preformattedContent"> -<pre><virtualhosts>${conf}/virtualhosts.xml</virtualhosts>
-</pre> -</div></div> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Mailing Lists.html b/content/xdocs/Mailing Lists.html deleted file mode 100755 index 823d49fc12..0000000000 --- a/content/xdocs/Mailing Lists.html +++ /dev/null @@ -1,67 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Mailing Lists</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Mailing Lists - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 11, 2008 by <font color="#0050B2">cctrieloff</font>. - </div> - - <h2><a name="MailingLists-QpidUserList"></a>Qpid User List</h2> - -<p>The user's list is for discussions that relate to use or questions on Qpid. If you have questions about how a feature works, suggestions on additional requirements, or general questions about Qpid please use this list</p> - -<ul> - <li>To subscribe to the user's list send an empty e-mail to <a href="mailto:qpid-users-subscribe@incubator.apache.org" title="Send mail to qpid-users-subscribe@incubator.apache.org">qpid-users-subscribe@incubator.apache.org</a></li> - <li>To remove yourself from the user's list send an empty e-mail to <a href="mailto:qpid-users-unsubscribe@incubator.apache.org" title="Send mail to qpid-users-unsubscribe@incubator.apache.org">qpid-users-unsubscribe@incubator.apache.org</a></li> - <li>The user's mailing list is archived. You can view the archive at <a href="http://mail-archives.apache.org/mod_mbox/incubator-qpid-users/" title="Visit page outside Confluence">http://mail-archives.apache.org/mod_mbox/incubator-qpid-users/</a></li> -</ul> - - -<h2><a name="MailingLists-QpidDeveloperList"></a>Qpid Developer List</h2> - -<p>The developer's list is for discussions that relate to the on going development of Qpid. If you have questions about how a feature is being developed, suggestions on how to implement a new feature, or requests for a new feature this is the list to use.</p> - -<ul> - <li>To subscribe to the developer's list send an empty e-mail to <a href="mailto:qpid-dev-subscribe@incubator.apache.org" title="Send mail to qpid-dev-subscribe@incubator.apache.org">qpid-dev-subscribe@incubator.apache.org</a></li> - <li>To remove yourself from the developer's list send an empty e-mail to <a href="mailto:qpid-dev-unsubscribe@incubator.apache.org" title="Send mail to qpid-dev-unsubscribe@incubator.apache.org">qpid-dev-unsubscribe@incubator.apache.org</a></li> - <li>The developer's mailing list is archived. You can view the archive at <a href="http://mail-archives.apache.org/mod_mbox/incubator-qpid-dev/" title="Visit page outside Confluence">http://mail-archives.apache.org/mod_mbox/incubator-qpid-dev/</a></li> -</ul> - - -<h2><a name="MailingLists-QpidCommitsList"></a>Qpid Commits List</h2> - -<p>The commits list is for recieving notifications about code being committed to the Qpid repository. The trafic on this list is automatically generated by Subversion. You should not post messages to this list.</p> - -<ul> - <li>To subscribe to the commits list send an empty e-mail to <a href="mailto:qpid-commits-subscribe@incubator.apache.org" title="Send mail to qpid-commits-subscribe@incubator.apache.org">qpid-commits-subscribe@incubator.apache.org</a></li> - <li>To remove yourself from the commits list send an empty e-mail to <a href="mailto:qpid-commits-unsubscribe@incubator.apache.org" title="Send mail to qpid-commits-unsubscribe@incubator.apache.org">qpid-commits-unsubscribe@incubator.apache.org</a></li> - <li>The commits mailing list is archived. You can view the archive at <a href="http://mail-archives.apache.org/mod_mbox/incubator-qpid-commits/" title="Visit page outside Confluence">http://mail-archives.apache.org/mod_mbox/incubator-qpid-commits/</a></li> -</ul> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Management Design notes.html b/content/xdocs/Management Design notes.html deleted file mode 100755 index f16fa90f99..0000000000 --- a/content/xdocs/Management Design notes.html +++ /dev/null @@ -1,714 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Management Design notes</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Management Design notes - </span> - </div> - <div class="pagesubheading"> - This page last changed on Feb 06, 2008 by <font color="#0050B2">cctrieloff</font>. - </div> - - <p>Management design notes:</p> - -<ul> - <li>The schema is checked into svn.</li> -</ul> - - - -<p>Todo / info to fill out:</p> - -<ul class="alternate" type="square"> - <li>Gateway defintions for SNMP, JMX etc..</li> -</ul> - - - -<h2><a name="ManagementDesignnotes-ManagementRequirements"></a>Management Requirements</h2> - -<ul> - <li>Must operate from a formally defined management schema.</li> - <li>Must natively use the AMQP protocol and its type system.</li> - <li>Must support the following operations - <ul> - <li>SET operation on configurable (persistent) aspects of objects</li> - <li>GET operation on all aspects of objects</li> - <li>METHOD invocation on schema-defined object-specific methods</li> - <li>Distribution of unsolicited periodic updates of instrumentation data - <ul> - <li>Data updates shall carry an accurate sample timestamp for rate calculation</li> - <li>Updates shall carry object create/delete timestamps.</li> - <li>Transient objects shall be fully accounted for via updates. Note that short-lived transient objects may come and go within a single update interval. All of the information pertaining to such an object must be captured and transmitted.</li> - </ul> - </li> - <li>Distribution of unsolicited event and/or alert indications (schema defined)</li> - </ul> - </li> - <li>Role-based access control at object, operation, and method granularity</li> - <li>End-to-end encryption and signing of management content</li> - <li>Schema must be self-describing so the management client need not have prior knowledge of the management model of the system under management.</li> - <li>Must be extensible to support the management of objects beyond the AMQP component set. This allows AMQP to be used as a general-purpose management protocol.</li> -</ul> - - -<h2><a name="ManagementDesignnotes-ArchitecturalFramework"></a>Architectural Framework</h2> - -<p>There are two primary interfaces defined in the management architecture:</p> -<ol> - <li>The Management Console Interface is used by management clients (CLIs, GUIs, console servers, etc.) to remotely access management data.</li> - <li>The Extension Interface is used by software components (not necessarily related to the AMQP infrastructure) to provide access to their managed objects.</li> -</ol> - - -<div class="preformatted"><div class="preformattedContent"> -<pre> +---------+ +---------+ +---------+
- | | | | | |
- | CLI/GUI | | Console |<======>| CLI/GUI |
- | | | Server | | |
- +---------+ | | +---------+
- ^ +---------+
- | ^
- | |
- v v
- +---------------------------------+
- | |
- | Managed AMQP Infrastructure |
- | |
- +---------------------------------+
- ^
- |
- v
- +------------+
- | |-+
- | Management | |-+
- | Extensions | | |
- | | | |
- +------------+ | |
- +------------+ |
- +------------+
-</pre> -</div></div> - -<p>Both management interfaces are based on the AMQP protocol and its type system.</p> - -<h2><a name="ManagementDesignnotes-DefinitionsofTerms"></a>Definitions of Terms</h2> - -<table class='confluenceTable'><tbody> -<tr> -<td class='confluenceTd'>class </td> -<td class='confluenceTd'> A type definition for a manageable object.</td> -</tr> -<tr> -<td class='confluenceTd'>package </td> -<td class='confluenceTd'> A grouping of class definitions that are related to a single software component. The package concept is used to extend the management schema beyond just the AMQP software components.</td> -</tr> -<tr> -<td class='confluenceTd'>object </td> -<td class='confluenceTd'> Also "manageable object". An instantiation of a class. An object represents a physical or logical component in the core function of the system under management.</td> -</tr> -<tr> -<td class='confluenceTd'>configuration element </td> -<td class='confluenceTd'> A typed member of a class which represents a configurable attribute of the class. Configurable attributes are persistent on the system under management (i.e. they are inherent to the system or are stored in a configuration file on the system).</td> -</tr> -<tr> -<td class='confluenceTd'>instrumentation element </td> -<td class='confluenceTd'> A typed member of a class which represents an instrumentation attribute of the class. Instrumentation elements are typically counters or state values.</td> -</tr> -<tr> -<td class='confluenceTd'>method </td> -<td class='confluenceTd'> A member of a class which represents a callable procedure on an object of the class. Methods may have an arbitrary set of typed arguments and may supply a return code. Methods typically have side effects on the associated object.</td> -</tr> -<tr> -<td class='confluenceTd'>event </td> -<td class='confluenceTd'> A member of a class which represents the occurence of an event of interest within the system under management.</td> -</tr> -<tr> -<td class='confluenceTd'>management agent </td> -<td class='confluenceTd'> A software component built into the broker that handles management traffic and distributes management data.</td> -</tr> -</tbody></table> - -<h2><a name="ManagementDesignnotes-TheManagementExchange"></a>The Management Exchange</h2> - -<p>The management exchange (called "qpid.management" currently) is a special type of exchange used for remote management access to the Qpid broker. The management exchange is an extension of the standard "Topic" exchange. It behaves like a topic exchange with the following exceptions:</p> -<ol> - <li>When a queue is successfully bound to the exchange, a method is invoked on the broker's management agent to notify it of the presence of a new remote managment client.</li> - <li>When messages arrive at the exchange for routing, the exchange examines the message's routing key and if the key represents a management command or method, it routes it directly to the management agent rather than routing it to queues using the topic algorithm.<br/> -The management exchange is used by the management agent to distribute unsolicited management data. Such data is classified by the routing key allowing management clients to register for only the data they need.</li> -</ol> - - -<h2><a name="ManagementDesignnotes-ManagementMessageProtocol"></a>Management Message Protocol</h2> - -<p>The principals in a management exchange are the <em>management client</em> and the <em>management agent</em>. The management agent is integrated into the AMQP broker and the management client is a remote entity. A management agent may be managed by zero or more management clients at any given time. Additionally, a management client may manage multiple management agents at the same time.</p> - -<p>For authentication and access control, management relies on the mechanisms supplied by the AMQP protocol.</p> - -<h3><a name="ManagementDesignnotes-EstablishingCommunicationBetweenClientandAgent"></a>Establishing Communication Between Client and Agent</h3> - -<p>Communication is established between the management client and management agent using normal AMQP procedures. The client creates a connection to the broker and then establishes a session with its corresponding channel.</p> - -<p>Two private queues are then declared (only one if method invocation is not needed). A management queue is declared and bound to the qpid.management exchange. If the binding key is "mgmt.#", all management-related messages sent to the exchange will be received by this client. A more specific binding key will result in a more restricted set of messages being received (see the section on Routing Key Structure below).</p> - -<p>If methods are going to be invoked on managed objects, a second private queue must be declared so the client can receive method replies. This queue is bound to the amq.direct exchange using a routing key equal to the name of the queue.</p> - -<p>When a client successfully binds to the qpid.management exchange, the management agent schedules a schema broadcast to be sent to the exchange. The agent will publish, via the exchange, a description of the schema for all manageable objects in its control.</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre> Client Agent
- | |
- | --- AMQP Connection and Session Setup ----------------------> |
- | |
- | --- Queue.declare (private data queue) ---------------------> |
- | --- Bind queue to exchange 'qpid.management' key 'mgmt.#' --> |
- | |
- | --- Queue.declare (private method-reply queue) -------------> |
- | --- Bind queue to exchange 'amq.direct' --------------------> |
- | |
- | <------- Management schema via exchange 'qpid.management' --- |
- | |
-</pre> -</div></div> - -<h3><a name="ManagementDesignnotes-BroadcastofConfigurationandInstrumentationUpdates"></a>Broadcast of Configuration and Instrumentation Updates</h3> - -<p>The management agent will periodically publish updates to the configuration and instrumentation of management objects under its control. Under normal circumstances, these updates are published only if they have changed since the last time they were published. Configuration updates are only published if configuration has changed and instrumentation updates are only published if instrumentation has changed. The exception to this rule is that after a management client binds to the qpid.management exchange, all configuration and instrumentation records are published as though they had changed whether or not they actually did.</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre> Client Agent
- | |
- | <-------------- Object Configurations via 'mgmt.config.#' --- | |
- | <--------------- Object Instrumentation via 'mgmt.inst.#' --- | |
- | | |
- | | | Publish Interval
- | | |
- | | |
- | | V
- | <-------------- Object Configurations via 'mgmt.config.#' --- |
- | <--------------- Object Instrumentation via 'mgmt.inst.#' --- |
- | |
-</pre> -</div></div> - -<h3><a name="ManagementDesignnotes-InvokingaMethodonaManagedObject"></a>Invoking a Method on a Managed Object</h3> - -<p>When the management client wishes to invoke a method on a managed object, it sends a method request message to the qpid.management exchange. The routing key contains the object class and method name (refer to Routing Key Structure below). The method request must have a header entry (reply-to) that contains the name of the method-reply queue so that the method response can be properly routed back to the requestor.</p> - -<p>The method request contains a sequence number that is copied to the method reply. This number is opaque to the management agent and may be used by the management client to correlate the reply to the request. The asynchronous nature of requests and replies allows any number of methods to be in-flight at a time. Note that there is no guarantee that methods will be replied to in the order in which they were requested.</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre> Client Agent
- | |
- | --- Method Request (to exchange 'qpid.management') ---------> |
- | |
- | |
- | <--------------- Method Reply (via exchange 'amq.direct') --- |
- | |
-</pre> -</div></div> - -<h2><a name="ManagementDesignnotes-RoutingKeyStructure"></a>Routing Key Structure</h2> - -<p>As noted above, the structure of the binding and routing keys used on the management exchange is important to the function of the management architecture. The routing key of a management message determines:</p> -<ol> - <li>The type of message (i.e. operation request or unsolicited update).</li> - <li>The class of the object that the message pertains to.</li> - <li>The specific operation or update type.</li> - <li>The namespace in which the class belongs. This allows for plug-in expansion of the management schema for manageable objects that are outside of the broker itself.</li> -</ol> - - -<p>Placing this information in the routing key provides the ability to enforce access control at class, operation, and method granularity. It also separates the command structure from the content of the management message (i.e. element values) allowing the content to be encrypted and signed end-to-end while still allowing access control at the message-transport level. This means that special access control code need not be written for the management agent.<br/> -There are two general types of routing/binding key:</p> -<ul> - <li><b>Command</b> keys have the structure: <tt>method.<package>.<class>.<method></tt> where - <ul> - <li><tt><package></tt> is the namespace in which the <class> name is valid,</li> - <li><tt><class></tt> is the name of the class as defined in the schema, and</li> - <li><tt><method></tt> is one of "get", "set", or a schema-defined class-specific method name.</li> - </ul> - </li> - <li><b>Unsolicited</b> keys have the structure: <tt>mgmt.<type>.<package>.<class>.<severity></tt> where - <ul> - <li><tt><type></tt> is one of "schema", "config", "inst", or "event",</li> - <li><tt><package></tt> is the namespace in which the <class> name is valid, and</li> - <li><tt><class></tt> is the name of the class as defined in the schema.</li> - <li><tt><severity></tt> is relevant for events only. It is one of "critical", "error", "warning", or "info".</li> - </ul> - </li> -</ul> - - -<p>In both cases, the content of the message (i.e. method arguments, element values, etc.) is carried in the body segment of the message.</p> - -<p>The <tt><package></tt> namespace allows this management framework to be extended with the addition of other software packages.</p> - -<h2><a name="ManagementDesignnotes-ManagementMessageBodyStructure"></a>Management Message Body Structure</h2> - -<p>The body segments of management messages are composed of sequences of binary-encoded data fields, in a manner consistent with the 0-10 version of the AMQP specification.</p> - -<p>All management messages begin with a message header:</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre> octet 0 1 2 3 4 5
- +---------+---------+---------+---------+---------+---------+
- | 'A' | 'M' | '0' | '1' | opcode | class |
- +---------+---------+---------+---------+---------+---------+
-</pre> -</div></div> - -<p>The first four octets contain the protocol <b>magic number</b> "AM01" which is used to identify the type and version of the message.</p> - -<p>The <b>opcode</b> field identifies the operation represented by the message:</p> - -<table class='confluenceTable'><tbody> -<tr> -<td class='confluenceTd'><b>opcode</b></td> -<td class='confluenceTd'><b>description</b></td> -</tr> -<tr> -<td class='confluenceTd'>'S'</td> -<td class='confluenceTd'>This message contains a schema record which describes the full schema description for a single object class</td> -</tr> -<tr> -<td class='confluenceTd'>'C'</td> -<td class='confluenceTd'>This message contains a content record. Content records contain the values of all configuration or instrumentation elements in an object. Such records are broadcast on a periodic interval if 1) a change has been made in the value of one of the elements, or 2) if a new management client has bound a queue to the management exchange.</td> -</tr> -<tr> -<td class='confluenceTd'>'M'</td> -<td class='confluenceTd'>This message contains a method request</td> -</tr> -<tr> -<td class='confluenceTd'>'R'</td> -<td class='confluenceTd'>This message contains a method reply</td> -</tr> -</tbody></table> - -<p>The <b>class</b> field identifies the type of content data in a content record. If the opcode is not 'C', this field must be set to zero.</p> - -<table class='confluenceTable'><tbody> -<tr> -<td class='confluenceTd'><b>class</b></td> -<td class='confluenceTd'><b>description</b></td> -</tr> -<tr> -<td class='confluenceTd'>'C'</td> -<td class='confluenceTd'>Configuration content</td> -</tr> -<tr> -<td class='confluenceTd'>'I'</td> -<td class='confluenceTd'>Instrumentation content</td> -</tr> -</tbody></table> - -<h3><a name="ManagementDesignnotes-SchemaMessages"></a>Schema Messages</h3> - -<p>Schema messages are published periodically if 1) the first instance of the object class has been created, or 2) a new management client has bound a queue to the management exchange. A schema message contains all schema-related data for a single object class.</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre> +-----+-----+-----+-----+-----+-----+
- | 'A' | 'M' | '0' | '1' | 'S' | 0 |
- +-----+-----+-----+-----+-----+-----+----------------------+
- | packageName (short string) |
- +----------------------------------------------------------+
- | className (short string) |
- +----------------------------------------------------------+
- | schema-hash (bin128) |
- +-----------+-----------+-----------+-----------+----------+
- | configCnt | instCnt | methodCnt | eventCnt |
- +-----------+-----------+-----------+-----------+----------------------------+
- | configCnt config-element records |
- +----------------------------------------------------------------------------+
- | instCnt instrumentation-element records |
- +----------------------------------------------------------------------------+
- | methodCnt method records |
- +----------------------------------------------------------------------------+
- | eventCnt event records |
- +----------------------------------------------------------------------------+
-</pre> -</div></div> - -<p>Each <b>config-element</b> record is an AMQP field table with the following fields. Optional fields may optionally be omitted from the field table.</p> - -<table class='confluenceTable'><tbody> -<tr> -<td class='confluenceTd'><b>field name</b></td> -<td class='confluenceTd'><b>optional</b></td> -<td class='confluenceTd'><b>description</b></td> -</tr> -<tr> -<td class='confluenceTd'>name</td> -<td class='confluenceTd'>no</td> -<td class='confluenceTd'>Name of the configuration element</td> -</tr> -<tr> -<td class='confluenceTd'>type</td> -<td class='confluenceTd'>no</td> -<td class='confluenceTd'>Type code for the element</td> -</tr> -<tr> -<td class='confluenceTd'>access</td> -<td class='confluenceTd'>no</td> -<td class='confluenceTd'>Access code for the element</td> -</tr> -<tr> -<td class='confluenceTd'>index</td> -<td class='confluenceTd'>no</td> -<td class='confluenceTd'>1 = index element, 0 = not an index element</td> -</tr> -<tr> -<td class='confluenceTd'>unit</td> -<td class='confluenceTd'>yes</td> -<td class='confluenceTd'>Units for numeric values (i.e. seconds, bytes, etc.)</td> -</tr> -<tr> -<td class='confluenceTd'>min</td> -<td class='confluenceTd'>yes</td> -<td class='confluenceTd'>Minimum value for numerics</td> -</tr> -<tr> -<td class='confluenceTd'>max</td> -<td class='confluenceTd'>yes</td> -<td class='confluenceTd'>Maximum value for numerics</td> -</tr> -<tr> -<td class='confluenceTd'>maxlen</td> -<td class='confluenceTd'>yes</td> -<td class='confluenceTd'>Maximum length for strings</td> -</tr> -<tr> -<td class='confluenceTd'>desc</td> -<td class='confluenceTd'>yes</td> -<td class='confluenceTd'>Description of the element</td> -</tr> -</tbody></table> - -<p>Each <b>instrumentation-element</b> record is an AMQP field table with the following fields:</p> - -<table class='confluenceTable'><tbody> -<tr> -<td class='confluenceTd'><b>field name</b></td> -<td class='confluenceTd'><b>optional</b></td> -<td class='confluenceTd'><b>description</b></td> -</tr> -<tr> -<td class='confluenceTd'>name</td> -<td class='confluenceTd'>no</td> -<td class='confluenceTd'>Name of the instrumentation element</td> -</tr> -<tr> -<td class='confluenceTd'>type</td> -<td class='confluenceTd'>no</td> -<td class='confluenceTd'>Type code for the element</td> -</tr> -<tr> -<td class='confluenceTd'>unit</td> -<td class='confluenceTd'>yes</td> -<td class='confluenceTd'>Units for numeric values (i.e. seconds, bytes, etc.)</td> -</tr> -<tr> -<td class='confluenceTd'>desc</td> -<td class='confluenceTd'>yes</td> -<td class='confluenceTd'>Description of the element</td> -</tr> -</tbody></table> - -<p><b>method</b> and <b>event</b> records contain a main field table that describes the method or header followed by zero or more field tables describing arguments. The main field table contains the following fields:</p> - -<table class='confluenceTable'><tbody> -<tr> -<td class='confluenceTd'><b>field name</b></td> -<td class='confluenceTd'><b>optional</b></td> -<td class='confluenceTd'><b>description</b></td> -</tr> -<tr> -<td class='confluenceTd'>name</td> -<td class='confluenceTd'>no</td> -<td class='confluenceTd'>Name of the method or event</td> -</tr> -<tr> -<td class='confluenceTd'>argCount</td> -<td class='confluenceTd'>no</td> -<td class='confluenceTd'>Number of argument records to follow</td> -</tr> -<tr> -<td class='confluenceTd'>desc</td> -<td class='confluenceTd'>yes</td> -<td class='confluenceTd'>Description of the method or event</td> -</tr> -</tbody></table> - -<p>Argument field tables contain the following fields:</p> - -<table class='confluenceTable'><tbody> -<tr> -<td class='confluenceTd'><b>field name</b></td> -<td class='confluenceTd'><b>method</b></td> -<td class='confluenceTd'><b>event</b></td> -<td class='confluenceTd'><b>optional</b></td> -<td class='confluenceTd'><b>description</b></td> -</tr> -<tr> -<td class='confluenceTd'>name</td> -<td class='confluenceTd'>yes</td> -<td class='confluenceTd'>yes</td> -<td class='confluenceTd'>no</td> -<td class='confluenceTd'>Argument name</td> -</tr> -<tr> -<td class='confluenceTd'>type</td> -<td class='confluenceTd'>yes</td> -<td class='confluenceTd'>yes</td> -<td class='confluenceTd'>no</td> -<td class='confluenceTd'>Type code for the argument</td> -</tr> -<tr> -<td class='confluenceTd'>dir</td> -<td class='confluenceTd'>yes</td> -<td class='confluenceTd'>no</td> -<td class='confluenceTd'>yes</td> -<td class='confluenceTd'>Direction code for method arguments</td> -</tr> -<tr> -<td class='confluenceTd'>unit</td> -<td class='confluenceTd'>yes</td> -<td class='confluenceTd'>yes</td> -<td class='confluenceTd'>yes</td> -<td class='confluenceTd'>Units for numeric values (i.e. seconds, bytes, etc.)</td> -</tr> -<tr> -<td class='confluenceTd'>min</td> -<td class='confluenceTd'>yes</td> -<td class='confluenceTd'>no</td> -<td class='confluenceTd'>yes</td> -<td class='confluenceTd'>Minimum value for numerics</td> -</tr> -<tr> -<td class='confluenceTd'>max</td> -<td class='confluenceTd'>yes</td> -<td class='confluenceTd'>no</td> -<td class='confluenceTd'>yes</td> -<td class='confluenceTd'>Maximum value for numerics</td> -</tr> -<tr> -<td class='confluenceTd'>maxlen</td> -<td class='confluenceTd'>yes</td> -<td class='confluenceTd'>no</td> -<td class='confluenceTd'>yes</td> -<td class='confluenceTd'>Maximum length for strings</td> -</tr> -<tr> -<td class='confluenceTd'>desc</td> -<td class='confluenceTd'>yes</td> -<td class='confluenceTd'>yes</td> -<td class='confluenceTd'>yes</td> -<td class='confluenceTd'>Description of the argument</td> -</tr> -<tr> -<td class='confluenceTd'>default</td> -<td class='confluenceTd'>yes</td> -<td class='confluenceTd'>no</td> -<td class='confluenceTd'>yes</td> -<td class='confluenceTd'>Default value for the argument</td> -</tr> -</tbody></table> - -<p><b>type codes</b> are numerics with the following values:</p> - -<table class='confluenceTable'><tbody> -<tr> -<td class='confluenceTd'><b>value</b></td> -<td class='confluenceTd'><b>type</b></td> -</tr> -<tr> -<td class='confluenceTd'>1</td> -<td class='confluenceTd'>uint8</td> -</tr> -<tr> -<td class='confluenceTd'>2</td> -<td class='confluenceTd'>uint16</td> -</tr> -<tr> -<td class='confluenceTd'>3</td> -<td class='confluenceTd'>uint32</td> -</tr> -<tr> -<td class='confluenceTd'>4</td> -<td class='confluenceTd'>uint64</td> -</tr> -<tr> -<td class='confluenceTd'>6</td> -<td class='confluenceTd'>short string</td> -</tr> -<tr> -<td class='confluenceTd'>7</td> -<td class='confluenceTd'>long string</td> -</tr> -</tbody></table> - -<p><b>access codes</b> are numerics with the following values:</p> - -<table class='confluenceTable'><tbody> -<tr> -<td class='confluenceTd'><b>value</b></td> -<td class='confluenceTd'><b>access</b></td> -</tr> -<tr> -<td class='confluenceTd'>1</td> -<td class='confluenceTd'>Read-Create access</td> -</tr> -<tr> -<td class='confluenceTd'>2</td> -<td class='confluenceTd'>Read-Write access</td> -</tr> -<tr> -<td class='confluenceTd'>3</td> -<td class='confluenceTd'>Read-Only access</td> -</tr> -</tbody></table> - -<p><b>direction codes</b> are numerics with the following values:</p> - -<table class='confluenceTable'><tbody> -<tr> -<td class='confluenceTd'><b>value</b></td> -<td class='confluenceTd'><b>direction</b></td> -</tr> -<tr> -<td class='confluenceTd'>1</td> -<td class='confluenceTd'>Input (from client to broker)</td> -</tr> -<tr> -<td class='confluenceTd'>2</td> -<td class='confluenceTd'>Output (from broker to client)</td> -</tr> -<tr> -<td class='confluenceTd'>3</td> -<td class='confluenceTd'>IO (bidirectional)</td> -</tr> -</tbody></table> - -<h3><a name="ManagementDesignnotes-ConfigurationandInstrumentationContentMessages"></a>Configuration and Instrumentation Content Messages</h3> - -<p>Content messages are published when changes are made to the values of content or instrumentation elements or when new management clients bind a queue to the management exchange.</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre> +-----+-----+-----+-----+-----+-----+
- | 'A' | 'M' | '0' | '1' | 'C' | cls |
- +-----+-----+-----+-----+-----+-----+----------------------+
- | packageName (short string) |
- +----------------------------------------------------------+
- | className (short string) |
- +----------------------------------------------------------+
- | class hash (bin128) |
- +-----+-----+-----+-----+-----+-----+-----+-----+----------+
- | timestamp of current sample (datetime) |
- +-----+-----+-----+-----+-----+-----+-----+-----+
- | time object was created (datetime) |
- +-----+-----+-----+-----+-----+-----+-----+-----+
- | time object was deleted (datetime) |
- +-----+-----+-----+-----+-----+-----+-----+-----+
- | objectId (uint64) |
- +-----+-----+-----+-----+-----+-----+-----+-----+------------------------+
- | config/inst values (in schema order) |
- +------------------------------------------------------------------------+
-</pre> -</div></div> - -<p>All timestamps are uint64 values representing nanoseconds since the epoch (January 1, 1970). The objectId is a uint64 value that uniquely identifies this object instance.</p> - -<p>The element values are encoded by their type into the message in the order in which they appeared in the schema message.</p> - -<h3><a name="ManagementDesignnotes-MethodRequestandReplyMessages"></a>Method Request and Reply Messages</h3> - -<p>Method request messages have the following structure. The sequence number is opaque to the management agent. It is returned unchanged in the method reply so the calling client can correctly associate the reply to the request. The objectId is the unique ID of the object on which the method is to be executed.</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre> +-----+-----+-----+-----+-----+-----+
- | 'A' | 'M' | '0' | '1' | 'M' | 0 |
- +-----+-----+-----+-----+-----+-----+
- | sequence number |
- +-----------------------+-----------------------+
- | objectId |
- +-----------------------------------------------+------------------------+
- | input and bidirectional argument values (in schema order) |
- +------------------------------------------------------------------------+
-</pre> -</div></div> - -<p>Method reply messages have the following structure. The sequence number is identical to that supplied in the method request. The status code (and text) indicate whether or not the method was successful and if not, what the error was. Output and bidirectional arguments are only included if the status code was 0 (STATUS_OK).</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre> +-----+-----+-----+-----+-----+-----+
- | 'A' | 'M' | '0' | '1' | 'R' | 0 |
- +-----+-----+-----+-----+-----+-----+
- | sequence number |
- +-----------------------+
- | status code |
- +-----------------------+----------------------------------+
- | status text (short string) |
- +-----------------------+----------------------------------+-------------+
- | output and bidirectional argument values (in schema order) |
- +------------------------------------------------------------------------+
-</pre> -</div></div> - -<p><b>status code</b> values are:</p> - -<table class='confluenceTable'><tbody> -<tr> -<td class='confluenceTd'><b>value</b></td> -<td class='confluenceTd'><b>description</b></td> -</tr> -<tr> -<td class='confluenceTd'>0</td> -<td class='confluenceTd'> STATUS_OK - successful completion</td> -</tr> -<tr> -<td class='confluenceTd'>1</td> -<td class='confluenceTd'> STATUS_UNKNOWN_OBJECT - objectId not found in the agent</td> -</tr> -<tr> -<td class='confluenceTd'>2</td> -<td class='confluenceTd'> STATUS_UNKNOWN_METHOD - method is not known by the object type</td> -</tr> -<tr> -<td class='confluenceTd'>3</td> -<td class='confluenceTd'> STATUS_NOT_IMPLEMENTED - method is not currently implemented</td> -</tr> -</tbody></table> - - <br/> - <div class="tabletitle"> - <a name="attachments">Attachments:</a> - </div> - - <div class="greybox" align="left"> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="Management Design notes_attachments/QpidMgmtSchema.xml">QpidMgmtSchema.xml</a> (text/xml) - <br/> - </div> - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Management Design notes_attachments/QpidMgmtSchema.xml b/content/xdocs/Management Design notes_attachments/QpidMgmtSchema.xml deleted file mode 100755 index 3158a5fd71..0000000000 --- a/content/xdocs/Management Design notes_attachments/QpidMgmtSchema.xml +++ /dev/null @@ -1,268 +0,0 @@ -<schema version="0.1" date="10/22/2007"> - -<!-- - 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. ---> - - <!-- Type information: - - Numeric types with "_wm" suffix are watermarked numbers. These are compound - values containing a current value, and a low and high water mark for the reporting - interval. The low and high water marks are set to the current value at the - beginning of each interval and track the minimum and maximum values of the statistic - over the interval respectively. - - Access rights for configuration elements: - - RO => Read Only - RC => Read/Create, can be set at create time only, read-only thereafter - RW => Read/Write - - If access rights are omitted for a configElement, they are assumed to be RO. - - --> - - <!-- Questions: Does C++ broker round-robin dests on queues? --> - - <!-- - =============================================================== - System - =============================================================== - --> - <object name="system" schemaId="1"> - <configElement name="sysId" type="string"/> - - <!-- RT config/instrumentation TBD --> - - </object> - - <!-- - =============================================================== - Broker - =============================================================== - --> - <object name="broker" schemaId="2"> - <configElement name="sysId" type="string" access="RO" index="y" desc="System ID"/> - <configElement name="port" type="uint16" access="RO" desc="TCP Port for AMQP Service"/> - <configElement name="workerThreads" type="uint16" access="RO" desc="Thread pool size"/> - <configElement name="maxConns" type="uint16" access="RO" desc="Maximum allowed connections"/> - <configElement name="connBacklog" type="uint16" access="RO" desc="Connection backlog limit for listening socket"/> - <configElement name="stagingThreshold" type="uint32" access="RO" desc="Broker stages messages over this size to disk"/> - <configElement name="storeLib" type="string" access="RO" desc="Name of persistent storage library"/> - <configElement name="asyncStore" type="bool" access="RO" desc="Use async persistent store"/> - <configElement name="mgmtPubInterval" type="uint16" min="1" access="RW" unit="second" desc="Interval for management broadcasts"/> - <configElement name="initialDiskPageSize" type="uint32" access="RO" desc="Number of disk pages allocated for storage"/> - <configElement name="initialPagesPerQueue" type="uint32" access="RO" desc="Number of disk pages allocated per queue"/> - <configElement name="clusterName" type="string" access="RO" - desc="Name of cluster this server is a member of, zero-length for standalone server"/> - <configElement name="version" type="string" access="RO" desc="Running software version"/> - - <method name="joinCluster"> - <arg name="clusterName" type="string"/> - </method> - - <method name="leaveCluster"/> - </object> - - <!-- - =============================================================== - Virtual Host - =============================================================== - --> - <object name="vhost" schemaId="3"> - <configElement name="name" type="string" access="RC" index="y"/> - </object> - - <!-- - =============================================================== - Queue - =============================================================== - --> - <object name="queue" schemaId="4"> - <configElement name="vhostRef" type="string" access="RC" index="y"/> - <configElement name="name" type="string" access="RC" index="y"/> - - <configElement name="durable" type="bool" access="RC"/> - <configElement name="autoDelete" type="bool" access="RC"/> - <configElement name="exclusive" type="bool" access="RC"/> - <configElement name="pageMemoryLimit" type="uint32" access="RO"/> - - <instElement name="diskPageSize" type="uint32"/> - <instElement name="diskPages" type="uint32"/> - <instElement name="diskAvailableSize" type="uint32"/> - - <instElement name="msgTotalEnqueues" type="uint64" unit="message" desc="Total messages enqueued"/> - <instElement name="msgTotalDequeues" type="uint64" unit="message" desc="Total messages dequeued"/> - <instElement name="msgTxnEnqueues" type="uint64" unit="message" desc="Transactional messages enqueued"/> - <instElement name="msgTxnDequeues" type="uint64" unit="message" desc="Transactional messages dequeued"/> - <instElement name="msgPersistEnqueues" type="uint64" unit="message" desc="Persistent messages enqueued"/> - <instElement name="msgPersistDequeues" type="uint64" unit="message" desc="Persistent messages dequeued"/> - <instElement name="msgDepth" type="uint32_wm" unit="message" desc="Current size of queue in messages"/> - <instElement name="byteTotalEnqueues" type="uint64" unit="octet" desc="Total messages enqueued"/> - <instElement name="byteTotalDequeues" type="uint64" unit="octet" desc="Total messages dequeued"/> - <instElement name="byteTxnEnqueues" type="uint64" unit="octet" desc="Transactional messages enqueued"/> - <instElement name="byteTxnDequeues" type="uint64" unit="octet" desc="Transactional messages dequeued"/> - <instElement name="bytePersistEnqueues" type="uint64" unit="octet" desc="Persistent messages enqueued"/> - <instElement name="bytePersistDequeues" type="uint64" unit="octet" desc="Persistent messages dequeued"/> - <instElement name="byteDepth" type="uint32_wm" unit="octet" desc="Current size of queue in bytes"/> - <instElement name="enqueueTxnStarts" type="uint64" unit="transaction" desc="Total enqueue transactions started "/> - <instElement name="enqueueTxnCommits" type="uint64" unit="transaction" desc="Total enqueue transactions committed"/> - <instElement name="enqueueTxnRejects" type="uint64" unit="transaction" desc="Total enqueue transactions rejected"/> - <instElement name="enqueueTxnCount" type="uint32_wm" unit="transaction" desc="Current pending enqueue transactions"/> - <instElement name="dequeueTxnStarts" type="uint64" unit="transaction" desc="Total dequeue transactions started"/> - <instElement name="dequeueTxnCommits" type="uint64" unit="transaction" desc="Total dequeue transactions committed"/> - <instElement name="dequeueTxnRejects" type="uint64" unit="transaction" desc="Total dequeue transactions rejected"/> - <instElement name="dequeueTxnCount" type="uint32_wm" unit="transaction" desc="Current pending dequeue transactions"/> - <instElement name="consumers" type="uint32_wm" unit="consumer" desc="Current consumers on queue"/> - <instElement name="bindings" type="uint32_wm" unit="binding" desc="Current bindings"/> - <instElement name="unackedMessages" type="uint32_wm" unit="message" desc="Messages consumed but not yet acked"/> - - <method name="purge" desc="Discard all messages on queue"/> - <method name="increaseDiskSize" desc="Increase number of disk pages allocated for this queue"> - <arg name="pages" type="uint32" desc="New total page allocation"/> - </method> - </object> - - <!-- - =============================================================== - Exchange - =============================================================== - --> - <object name="exchange" schemaId="5"> - <configElement name="vhostRef" type="string" access="RC" index="y"/> - <configElement name="name" type="string" access="RC" index="y"/> - <configElement name="type" type="string" access="RC"/> - - <instElement name="producers" type="uint32_wm" desc="Current producers on exchange"/> - <instElement name="bindings" type="uint32_wm" desc="Current bindings"/> - <instElement name="msgReceives" type="uint64" desc="Total messages received"/> - <instElement name="msgDrops" type="uint64" desc="Total messages dropped (no matching key)"/> - <instElement name="msgRoutes" type="uint64" desc="Total routed messages"/> - <instElement name="byteReceives" type="uint64" desc="Total bytes received"/> - <instElement name="byteDrops" type="uint64" desc="Total bytes dropped (no matching key)"/> - <instElement name="byteRoutes" type="uint64" desc="Total routed bytes"/> - </object> - - <!-- - =============================================================== - Binding - =============================================================== - --> - <object name="binding" schemaId="6"> - <configElement name="queueRef" type="string" access="RC" index="y"/> - <configElement name="exchangeRef" type="string" access="RC" index="y"/> - <configElement name="bindingKey" type="string" access="RC"/> - <configElement name="arguments" type="fieldTable" access="RC"/> - - <instElement name="msgMatched" type="uint64"/> - </object> - - <!-- - =============================================================== - Client - =============================================================== - --> - <object name="client" schemaId="7"> - <configElement name="vhostRef" type="string" index="y"/> - <configElement name="ipAddr" type="ipAddress" index="y"/> - <configElement name="port" type="uint16" index="y"/> - - <instElement name="authIdentity" type="string"/> - <instElement name="msgsProduced" type="uint64"/> - <instElement name="msgsConsumed" type="uint64"/> - <instElement name="bytesProduced" type="uint64"/> - <instElement name="bytesConsumed" type="uint64"/> - - <method name="close"/> - <method name="detach"/> - </object> - - <!-- - =============================================================== - Session - =============================================================== - --> - <object name="session" schemaId="8"> - <configElement name="vhostRef" type="string" index="y"/> - <configElement name="name" type="string" index="y"/> - <configElement name="clientRef" type="string" access="RO"/> - <configElement name="detachedLifespan" type="uint32" access="RO"/> - - <instElement name="attached" type="bool"/> - <instElement name="remainingLifespan" type="uint32"/> - <instElement name="framesOutstanding" type="uint32"/> - - <method name="solicitAck"/> - <method name="detach"/> - <method name="resetLifespan"/> - <method name="close"/> - </object> - - <!-- - =============================================================== - Destination - =============================================================== - --> - <object name="destination" schemaId="9"> - <configElement name="sessionRef" type="string" index="y"/> - <configElement name="name" type="string" index="y"/> - - <instElement name="flowMode" type="enum(credit,window)"/> - <instElement name="maxMsgCredits" type="uint32"/> - <instElement name="maxByteCredits" type="uint32"/> - - <instElement name="msgCredits" type="uint32"/> - <instElement name="byteCredits" type="uint32"/> - - <method name="throttle" desc="Apply extra rate limiting to destination: 0 = Normal, 10 = Maximum"> - <arg name="strength" type="uint8" min="0" max="10"/> - </method> - <method name="stop"/> - <method name="start"/> - </object> - - <!-- - =============================================================== - Producer - =============================================================== - --> - <object name="producer" schemaId="10"> - <configElement name="destinationRef" type="string" index="y"/> - <configElement name="exchangeRef" type="string" index="y"/> - - <instElement name="msgsProduced" type="uint64"/> - <instElement name="bytesProduced" type="uint64"/> - </object> - - <!-- - =============================================================== - Consumer - =============================================================== - --> - <object name="consumer" schemaId="11"> - <configElement name="destinationRef" type="string" index="y"/> - <configElement name="queueRef" type="string" index="y"/> - - <instElement name="msgsConsumed" type="uint64"/> - <instElement name="bytesConsumed" type="uint64"/> - <instElement name="unackedMessages" type="uint32_wm" desc="Messages consumed but not yet acked"/> - - <method name="close"/> - </object> -</schema> - diff --git a/content/xdocs/Management Tools.html b/content/xdocs/Management Tools.html deleted file mode 100755 index 7cf41fd335..0000000000 --- a/content/xdocs/Management Tools.html +++ /dev/null @@ -1,45 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Management Tools</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Management Tools - </span> - </div> - <div class="pagesubheading"> - This page last changed on Jul 04, 2007 by <font color="#0050B2">ritchiem</font>. - </div> - - <h2><a name="ManagementTools-CurrentManagementTools"></a>Current Management Tools</h2> - -<p>This is a list of the current managment tools available for the Qpid Java Broker.</p> - -<ul> - <li><a href="JMX Management Console.html" title="JMX Management Console">JMX Management Console </a></li> - <li><a href="MessageStore Tool.html" title="MessageStore Tool">MessageStore Tool</a></li> -</ul> - - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/MartinRitchie.html b/content/xdocs/MartinRitchie.html deleted file mode 100755 index 2586c3b3bd..0000000000 --- a/content/xdocs/MartinRitchie.html +++ /dev/null @@ -1,36 +0,0 @@ -<html> - <head> - <title>Apache Qpid : MartinRitchie</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : MartinRitchie - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 14, 2008 by <font color="#0050B2">ritchiem</font>. - </div> - - <p>This is just a sandbox test area for Martin Ritchie</p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/MemoryMessageStore.html b/content/xdocs/MemoryMessageStore.html deleted file mode 100755 index 39a7693291..0000000000 --- a/content/xdocs/MemoryMessageStore.html +++ /dev/null @@ -1,38 +0,0 @@ -<html> - <head> - <title>Apache Qpid : MemoryMessageStore</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : MemoryMessageStore - </span> - </div> - <div class="pagesubheading"> - This page last changed on Jul 04, 2007 by <font color="#0050B2">ritchiem</font>. - </div> - - <h2><a name="MemoryMessageStore-MemoryMessageStore"></a>MemoryMessageStore</h2> - -<p>This is the default MemoryStore it performs no persistence between broker restarts.</p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Message API Design.html b/content/xdocs/Message API Design.html deleted file mode 100755 index 5eaa5c6a13..0000000000 --- a/content/xdocs/Message API Design.html +++ /dev/null @@ -1,182 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Message API Design</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Message API Design - </span> - </div> - <div class="pagesubheading"> - This page last changed on Aug 15, 2007 by <font color="#0050B2">rajith</font>. - </div> - - <h1><a name="MessageAPIDesign-MessageAPIDesign"></a>Message API Design</h1> - -<p>This document describes the new message API for the restructured client.</p> - -<ul> - <li>Sending Messages</li> - <li>Receiving Messages</li> - <li>Message abstraction</li> - <li><a href="http://people.apache.org/~rajith/qpid_docs/client_api/" title="Visit page outside Confluence">Java Doc</a></li> -</ul> - - -<h2><a name="MessageAPIDesign-SendingMessages"></a>Sending Messages</h2> -<p>The Session class provides the following methods to send messages.</p> - -<div class="code" style="border-style: solid; "><div class="codeContent"> -<pre class="code-java"><span class="code-keyword">public</span> <span class="code-keyword">interface</span> Session{
-.........
-
-<span class="code-comment">//Option1 - <span class="code-keyword">for</span> small messages
-</span><span class="code-keyword">public</span> void messageTransfer(<span class="code-object">String</span> destination, Message msg, <span class="code-object">short</span> confirmMode, <span class="code-object">short</span> acquireMode)<span class="code-keyword">throws</span> IOException;
-
-<span class="code-comment">//Option2 - <span class="code-keyword">for</span> large messages
-</span><span class="code-keyword">public</span> void messageStream(<span class="code-object">String</span> destination, Message msg, <span class="code-object">short</span> confirmMode, <span class="code-object">short</span> acquireMode)<span class="code-keyword">throws</span> IOException;
-
-<span class="code-comment">//Option3 - can use it with any message size, recomended <span class="code-keyword">for</span> large messages
-</span><span class="code-keyword">public</span> void messageTransfer(<span class="code-object">String</span> destination, <span class="code-object">short</span> confirmMode, <span class="code-object">short</span> acquireMode);
-<span class="code-keyword">public</span> void headers(Struct... headers);
-<span class="code-keyword">public</span> void data(<span class="code-object">byte</span>[] data);
-<span class="code-keyword">public</span> void data(ByteBuffer buf);
-<span class="code-keyword">public</span> void data(<span class="code-object">String</span> str);
-<span class="code-keyword">public</span> void endData();
-
-.........
-
-}</pre> -</div></div> - -<h3><a name="MessageAPIDesign-SendingsmallMessages"></a>Sending small Messages </h3> -<p>Option1 provides a convinience method to send small messages.<br/> -You could use the ByteBufferMessage to create small in memory messages (or your own implementation).<br/> -Underneath it maps onto methods defined under option3</p> - -<h3><a name="MessageAPIDesign-SendinglargeMessages"></a>Sending large Messages</h3> -<p>You have two options for sending large messages, using either pull style or push style semantics</p> - -<h4><a name="MessageAPIDesign-UsingtheSessionclassmethods%28Option3%29"></a>Using the Session class methods (Option3)</h4> -<p>Option3 provides a more natural AMQP style set of methods<br/> -You can stream data using Option3 by pushing your data using one of the data methods defined in the session class.</p> - -<h4><a name="MessageAPIDesign-UsingOption2%28pullstyle%29"></a>Using Option2 (pull style)</h4> -<p>The messageStream method will pull data from the message and stream using the methods defined in option3.<br/> -You could use FileMessage or StreamingMessage or your own Message implementation that backs a large data stream.</p> - -<ul> - <li>FileMessage takes in a FileInputStream and create a nio FileChannel. It then uses a MappedByteBuffer to map a region of the file when the readData method is invoked. You could specify a chunksize in the constructor to control how much data is mapped each time.</li> -</ul> - - -<ul> - <li>StreamingMessage takes in a SocketChannel and reads a chunk of data at a time until the SocketChannel is closed. This could be useful when u need to transfer a data stream received from a legacy application or a hardware device. In such cases the StreamingMessage provides a convinient abstraction to stream the data without any intermediate copying.</li> -</ul> - - -<h2><a name="MessageAPIDesign-ReceivingMessages"></a>Receiving Messages</h2> -<p>To receive messages you can subscribe using the following method</p> -<div class="code" style="border-style: solid; "><div class="codeContent"> -<pre class="code-java"><span class="code-keyword">public</span> <span class="code-keyword">interface</span> Session{
-.........
-
-<span class="code-keyword">public</span> void messageSubscribe(<span class="code-object">String</span> queue, <span class="code-object">String</span> destination, <span class="code-object">short</span> confirmMode, <span class="code-object">short</span> acquireMode,
- MessagePartListener listener, Map<<span class="code-object">String</span>, ?> filter, Option... options);
------
-}</pre> -</div></div> - -<p>The API provides support for receiving messages in parts as and when they arrive using the MessagePartListener.<br/> -This enables the user to start consuming the message while it is being streamed.</p> -<div class="code" style="border-style: solid; "><div class="codeContent"> -<pre class="code-java"><span class="code-keyword">public</span> <span class="code-keyword">interface</span> MessagePartListener{
-
-<span class="code-keyword">public</span> void messageTransfer(<span class="code-object">long</span> transferId);
-
-<span class="code-keyword">public</span> void messageHeaders(Struct... headers);
-
-<span class="code-keyword">public</span> void data(ByteBuffer src);
-
-<span class="code-keyword">public</span> void messageReceived();
-
-}</pre> -</div></div> - -<p>The messageTransfer method signals the start of a transfer and passes the transferId.<br/> -The Transfer Id is used for the following operations defined in the Session API.</p> -<ul> - <li>to Acquire the message (if the message was transfered in no-acquire mode)</li> - <li>to release the message ( if already acquired)</li> - <li>to Reject or Acknowledge the message</li> -</ul> - - -<p>The data method will be called each time Frame arrives. The messageReceived method will signal the end of the message.</p> - -<h3><a name="MessageAPIDesign-Consumingsmallmessages"></a>Consuming small messages</h3> -<p>The API also provides a convinient way for consuming small messages through the MessageListener interface and the MessagePartListenerAdapter.<br/> -The MessagePartListenerAdapter will build the message and will notify the user through MessageListener when the message is complete.</p> -<div class="code" style="border-style: solid; "><div class="codeContent"> -<pre class="code-java"><span class="code-keyword">public</span> <span class="code-keyword">interface</span> MessageListener{
-
- <span class="code-keyword">public</span> void onMessage(Message message);
-
-}</pre> -</div></div> - -<p>you can use it the following way.</p> -<div class="code" style="border-style: solid; "><div class="codeContent"> -<pre class="code-java">.........
-
- MessageListener myMessageListener ....
-
- session.messageSubscribe(....,<span class="code-keyword">new</span> MessagePartListenerDapter(myMessageListener),...);
------</pre> -</div></div> - - -<h2><a name="MessageAPIDesign-Messageabstraction"></a>Message abstraction</h2> -<p>Message Interface provides an abstraction for creating messages from different data streams.<br/> -Please read the java doc for a complete description of each method.</p> - -<div class="code" style="border-style: solid; "><div class="codeContent"> -<pre class="code-java"><span class="code-keyword">public</span> <span class="code-keyword">interface</span> Message{
-
-<span class="code-keyword">public</span> MessageProperties getMessageProperties();
-<span class="code-keyword">public</span> DeliveryProperties getDeliveryProperties();
-
-<span class="code-keyword">public</span> void appendData(<span class="code-object">byte</span>[] src) <span class="code-keyword">throws</span> IOException;
-<span class="code-keyword">public</span> void appendData(ByteBuffer src) <span class="code-keyword">throws</span> IOException;
-
-<span class="code-keyword">public</span> void readData(<span class="code-object">byte</span>[] target) <span class="code-keyword">throws</span> IOException;
-<span class="code-keyword">public</span> ByteBuffer readData() <span class="code-keyword">throws</span> IOException;
-
-<span class="code-keyword">public</span> void clearData();
-<span class="code-keyword">public</span> <span class="code-object">long</span> getMessageTransferId();
-
-}</pre> -</div></div> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/MessageStore Tool.html b/content/xdocs/MessageStore Tool.html deleted file mode 100755 index 39578c735a..0000000000 --- a/content/xdocs/MessageStore Tool.html +++ /dev/null @@ -1,115 +0,0 @@ -<html> - <head> - <title>Apache Qpid : MessageStore Tool</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : MessageStore Tool - </span> - </div> - <div class="pagesubheading"> - This page last changed on Jul 05, 2007 by <font color="#0050B2">ritchiem</font>. - </div> - - <p>h2 MessageStore Tool</p> - -<p>We have a number of implementations of MessageStore this tool allows the interrogation of these stores while the broker is offline. </p> - -<h3><a name="MessageStoreTool-MessageStoreImplementations"></a>MessageStore Implementations</h3> -<ul><li><a href="BDBMessageStore (3rd Party).html" title="BDBMessageStore (3rd Party)">BDBMessageStore (3rd Party)</a></li><li><a href="JDBCStore.html" title="JDBCStore">JDBCStore</a></li><li><a href="MemoryMessageStore.html" title="MemoryMessageStore">MemoryMessageStore</a></li></ul> - - -<h3><a name="MessageStoreTool-Introduction"></a>Introduction</h3> -<p>Each of the MessageStore implementations provide different back end storage for their messages and so would need a different tool to be able to interrogate their contents. What this tool does is to utilise the Java broker code base to access the contents of the storage providing the user with a consistent means to inspect the storage contents. The tool allows the current messages in the store to be inspected and copied/moved between queues.</p> - - -<h3><a name="MessageStoreTool-Usage"></a>Usage</h3> - -<p>The tools-distribution currently includes a unix shell command 'msTool.sh' this script will launch the java tool.</p> - -<p>The tool loads $QPID_HOME/etc/config.xml by default. If an alternative broker configuration is required this should be provided on the command line as would be done for the broker.</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre>msTool.sh -c <path to different config.xml>
-</pre> -</div></div> - -<p>On startup the user is present with a command prompt</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre>$ msTool.sh
-MessageStoreTool - for examining Persistent Qpid Broker MessageStore instances
-bdb$
-</pre> -</div></div> - -<h3><a name="MessageStoreTool-AvailableCommands"></a>Available Commands</h3> - -<p>The available commands in the tool can be seen through the use of the 'help' command.</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre>bdb$ help
-+----------------------------------------------------------------+
-| Available Commands |
-+----------------------------------------------------------------+
-| Command | Description |
-+----------------------------------------------------------------+
-| quit | Quit the tool. |
-| list | list available items. |
-| dump | Dump selected message content. Default: show=content |
-| load | Loads specified broker configuration file. |
-| clear | Clears any selection. |
-| show | Shows the messages headers. |
-| select | Perform a selection. |
-| help | Provides detailed help on commands. |
-+----------------------------------------------------------------+
-bdb$
-</pre> -</div></div> - - -<p>A brief description is displayed and further usage information is shown with 'help <command>'</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre>bdb$ help list
-list availble items.
-Usage:list queues [<exchange>] | exchanges | bindings [<exchange>] | all
-bdb$
-</pre> -</div></div> - - -<h3><a name="MessageStoreTool-FutureWork"></a>Future Work</h3> - -<p>Currently the tool only works whilst the broker is offline. If this functionality was incorporated into the broker then a telnet functionality could be provided allowing online management.</p> - - - - - - - - - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/MgmtC++.html b/content/xdocs/MgmtC++.html deleted file mode 100755 index 9aae04d028..0000000000 --- a/content/xdocs/MgmtC++.html +++ /dev/null @@ -1,333 +0,0 @@ -<html> - <head> - <title>Apache Qpid : MgmtC++</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : MgmtC++ - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 15, 2008 by <font color="#0050B2">cctrieloff</font>. - </div> - - <h2><a name="MgmtC%2B%2B-ManagingtheC%5CBroker"></a>Managing the C++ Broker</h2> - -<p>There are quite a few ways to interact with the C++ broker. The command line tools<br/> -include:</p> -<ul> - <li>qpid-route - used to configure federation (a set of federated brokers)</li> - <li>qpid-config - used to configure queues, exchanges, bindings and list them etc</li> - <li>qpid-tool - used to view management information/statistics and call any management actions on the broker</li> -</ul> - - -<h3><a name="MgmtC%2B%2B-Usingqpidconfig"></a>Using qpid-config</h3> - -<p>This utility can be used to create queues exchanges and bindings, both durable and transient. Always check for latest options by running --help command.</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">$ ./qpid-config --help
-Usage: qpid-config OPTIONS
- qpid-config OPTIONS exchanges filter-string
- qpid-config OPTIONS queues filter-string
- qpid-config OPTIONS add exchange <type> <name> AddExchangeOptions
- qpid-config OPTIONS del exchange <name>
- qpid-config OPTIONS add queue <name> AddQueueOptions
- qpid-config OPTIONS del queue <name>
- qpid-config OPTIONS bind <exchange-name> <queue-name> binding-key
- qpid-config OPTIONS unbind <exchange-name> <queue-name> binding-key
-Options:
- -b [ --bindings ] Show bindings in queue or exchange list
- -a [ --broker-addr ] Address (localhost) Address of qpidd broker
- broker-addr is in the form: hostname | ip-address :<port>
- ex: localhost, 10.1.1.7:10000, broker-host:10000
- -s [ --spec-file] Path (/usr/share/amqp/amqp.0-10-preview.xml)
- AMQP specification file
-Add Queue Options:
- --durable Queue is durable
-
-Add Exchange Options:
- --durable Exchange is durable</pre> -</div></div> -<p>Get the summary page</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">./qpid-config
-Total Exchanges: 6
- topic: 2
- headers: 1
- fanout: 1
- direct: 2
- Total Queues: 7
- durable: 0
- non-durable: 7</pre> -</div></div> -<p>List the queues</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">$ ./qpid-config queues
- Store Size
-Durable AutoDel Excl Bindings (files x file pages) Queue Name
-===========================================================================================
- N N N 1 pub_start
- N N N 1 pub_done
- N N N 1 sub_ready
- N N N 1 sub_done
- N N N 1 perftest0
- N Y N 2 mgmt-3206ff16-fb29-4a30-82ea-e76f50dd7d15
- N Y N 2 repl-3206ff16-fb29-4a30-82ea-e76f50dd7d15
- N Y N 2 mgmt-df06c7a6-4ce7-426a-9f66-da91a2a6a837
- N Y N 2 repl-df06c7a6-4ce7-426a-9f66-da91a2a6a837</pre> -</div></div> -<p>List the exchanges with bindings</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">$ ./qpid-config -b exchanges
-Exchange '' (direct)
- bind pub_start => pub_start
- bind pub_done => pub_done
- bind sub_ready => sub_ready
- bind sub_done => sub_done
- bind perftest0 => perftest0
- bind mgmt-3206ff16-fb29-4a30-82ea-e76f50dd7d15 => mgmt-3206ff16-fb29-4a30-82ea-e76f50dd7d15
- bind repl-3206ff16-fb29-4a30-82ea-e76f50dd7d15 => repl-3206ff16-fb29-4a30-82ea-e76f50dd7d15
-Exchange 'amq.direct' (direct)
- bind repl-3206ff16-fb29-4a30-82ea-e76f50dd7d15 => repl-3206ff16-fb29-4a30-82ea-e76f50dd7d15
- bind repl-df06c7a6-4ce7-426a-9f66-da91a2a6a837 => repl-df06c7a6-4ce7-426a-9f66-da91a2a6a837
- bind repl-c55915c2-2fda-43ee-9410-b1c1cbb3e4ae => repl-c55915c2-2fda-43ee-9410-b1c1cbb3e4ae
-Exchange 'amq.topic' (topic)
-Exchange 'amq.fanout' (fanout)
-Exchange 'amq.match' (headers)
-Exchange 'qpid.management' (topic)
- bind mgmt.# => mgmt-3206ff16-fb29-4a30-82ea-e76f50dd7d15</pre> -</div></div> - -<h3><a name="MgmtC%2B%2B-Usingqpidroute"></a>Using qpid-route</h3> - -<p>This utility is to create federated networks of brokers, This allows you for forward messages between brokers in a network. Think of it like an IP network and static routes are configured with direct exchanges, and dynamic routes configured with the topic exchanges. The '*' and '#' can be used to create IP masking type pattern as you would with IP address except you are using the topic names.</p> - -<p>The utility thus looks much like iproute <img class="emoticon" src="./icons/emoticons/smile.gif" height="20" width="20" align="absmiddle" alt="" border="0"/></p> -<div class="code"><div class="codeContent"> -<pre class="code-java">$ ./qpid-route --help
-Usage: qpid-route OPTIONS add <dest-broker> <src-broker> <exchange> <routing-key>
- qpid-route OPTIONS del <dest-broker> <src-broker> <exchange> <routing-key>
- qpid-route OPTIONS list <dest-broker>
- qpid-route OPTIONS flush <dest-broker>
-Options:
- -s [ --spec-file ] PATH (/usr/share/amqp/amqp.0-10.xml)
- -v [ --verbose ] Verbose output
- -q [ --quiet ] Quiet output, don't print duplicate warnings
- dest-broker and src-broker are in the form: hostname | ip-address :<port>
- ex: localhost, 10.1.1.7:10000, broker-host:10000</pre> -</div></div> -<p>A few examples:</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">./qpidd_route -v add host1 host2 hub1.topic hub2.topic.stock.buy
-./qpidd_route -v add host1 host2 hub1.topic hub2.topic.stock.sell
-./qpidd_route -v add host1 host2 hub1.topic 'hub2.topic.stock.#'
-./qpidd_route -v add host1 host2 hub1.topic 'hub2.#'
-./qpidd_route -v add host1 host2 hub1.topic 'hub2.topic.#'
-./qpidd_route -v add host1 host2 hub1.topic 'hub2.global.#'</pre> -</div></div> - -<h3><a name="MgmtC%2B%2B-Usingqpidtool"></a>Using qpid-tool</h3> - -<p>This utility provided a telnet style interface to be able to view, list all stats and action<br/> -all the methods. Simple capture below. Best to just play with it and mail the list if you have<br/> -questions or want features added.</p> - -<div class="code"><div class="codeContent"> -<pre class="code-java">qpid:
-qpid: help
-Management Tool <span class="code-keyword">for</span> QPID
-Commands:
- list - Print summary of existing objects by class
- list <className> - Print list of objects of the specified class
- list <className> all - Print contents of all objects of specified class
- list <className> active - Print contents of all non-deleted objects of specified class
- list <list-of-IDs> - Print contents of one or more objects (infer className)
- list <className> <list-of-IDs> - Print contents of one or more objects
- list is space-separated, ranges may be specified (i.e. 1004-1010)
- call <ID> <methodName> <args> - Invoke a method on an object
- schema - Print summary of object classes seen on the target
- schema <className> - Print details of an object class
- set time-format <span class="code-object">short</span> - Select <span class="code-object">short</span> timestamp format (<span class="code-keyword">default</span>)
- set time-format <span class="code-object">long</span> - Select <span class="code-object">long</span> timestamp format
- quit or ^D - Exit the program
-qpid: list
-Management <span class="code-object">Object</span> Types:
- ObjectType Active Deleted
- ================================
- qpid.binding 21 0
- qpid.broker 1 0
- qpid.client 1 0
- qpid.exchange 6 0
- qpid.queue 13 0
- qpid.session 4 0
- qpid.system 1 0
- qpid.vhost 1 0
-qpid: list qpid.system
-Objects of type qpid.system
- ID Created Destroyed Index
- ==================================
- 1000 21:00:02 - host
-qpid: list 1000
-<span class="code-object">Object</span> of type qpid.system: (last sample time: 21:26:02)
- Type Element 1000
- =======================================================
- config sysId host
- config osName Linux
- config nodeName localhost.localdomain
- config release 2.6.24.4-64.fc8
- config version #1 SMP Sat Mar 29 09:15:49 EDT 2008
- config machine x86_64
-qpid: schema queue
-Schema <span class="code-keyword">for</span> class 'qpid.queue':
- Element Type Unit Access Notes Description
- ===================================================================================================================
- vhostRef reference ReadCreate index
- name <span class="code-object">short</span>-string ReadCreate index
- durable <span class="code-object">boolean</span> ReadCreate
- autoDelete <span class="code-object">boolean</span> ReadCreate
- exclusive <span class="code-object">boolean</span> ReadCreate
- arguments field-table ReadOnly Arguments supplied in queue.declare
- storeRef reference ReadOnly Reference to persistent queue (<span class="code-keyword">if</span> durable)
- msgTotalEnqueues uint64 message Total messages enqueued
- msgTotalDequeues uint64 message Total messages dequeued
- msgTxnEnqueues uint64 message Transactional messages enqueued
- msgTxnDequeues uint64 message Transactional messages dequeued
- msgPersistEnqueues uint64 message Persistent messages enqueued
- msgPersistDequeues uint64 message Persistent messages dequeued
- msgDepth uint32 message Current size of queue in messages
- msgDepthHigh uint32 message Current size of queue in messages (High)
- msgDepthLow uint32 message Current size of queue in messages (Low)
- byteTotalEnqueues uint64 octet Total messages enqueued
- byteTotalDequeues uint64 octet Total messages dequeued
- byteTxnEnqueues uint64 octet Transactional messages enqueued
- byteTxnDequeues uint64 octet Transactional messages dequeued
- bytePersistEnqueues uint64 octet Persistent messages enqueued
- bytePersistDequeues uint64 octet Persistent messages dequeued
- byteDepth uint32 octet Current size of queue in bytes
- byteDepthHigh uint32 octet Current size of queue in bytes (High)
- byteDepthLow uint32 octet Current size of queue in bytes (Low)
- enqueueTxnStarts uint64 transaction Total enqueue transactions started
- enqueueTxnCommits uint64 transaction Total enqueue transactions committed
- enqueueTxnRejects uint64 transaction Total enqueue transactions rejected
- enqueueTxnCount uint32 transaction Current pending enqueue transactions
- enqueueTxnCountHigh uint32 transaction Current pending enqueue transactions (High)
- enqueueTxnCountLow uint32 transaction Current pending enqueue transactions (Low)
- dequeueTxnStarts uint64 transaction Total dequeue transactions started
- dequeueTxnCommits uint64 transaction Total dequeue transactions committed
- dequeueTxnRejects uint64 transaction Total dequeue transactions rejected
- dequeueTxnCount uint32 transaction Current pending dequeue transactions
- dequeueTxnCountHigh uint32 transaction Current pending dequeue transactions (High)
- dequeueTxnCountLow uint32 transaction Current pending dequeue transactions (Low)
- consumers uint32 consumer Current consumers on queue
- consumersHigh uint32 consumer Current consumers on queue (High)
- consumersLow uint32 consumer Current consumers on queue (Low)
- bindings uint32 binding Current bindings
- bindingsHigh uint32 binding Current bindings (High)
- bindingsLow uint32 binding Current bindings (Low)
- unackedMessages uint32 message Messages consumed but not yet acked
- unackedMessagesHigh uint32 message Messages consumed but not yet acked (High)
- unackedMessagesLow uint32 message Messages consumed but not yet acked (Low)
- messageLatencySamples delta-time nanosecond Broker latency through <span class="code-keyword">this</span> queue (Samples)
- messageLatencyMin delta-time nanosecond Broker latency through <span class="code-keyword">this</span> queue (Min)
- messageLatencyMax delta-time nanosecond Broker latency through <span class="code-keyword">this</span> queue (Max)
- messageLatencyAverage delta-time nanosecond Broker latency through <span class="code-keyword">this</span> queue (Average)
-Method 'purge' Discard all messages on queue
-qpid: list queue
-Objects of type qpid.queue
- ID Created Destroyed Index
- ===========================================================================
- 1012 21:08:13 - 1002.pub_start
- 1014 21:08:13 - 1002.pub_done
- 1016 21:08:13 - 1002.sub_ready
- 1018 21:08:13 - 1002.sub_done
- 1020 21:08:13 - 1002.perftest0
- 1038 21:09:08 - 1002.mgmt-3206ff16-fb29-4a30-82ea-e76f50dd7d15
- 1040 21:09:08 - 1002.repl-3206ff16-fb29-4a30-82ea-e76f50dd7d15
- 1046 21:09:32 - 1002.mgmt-df06c7a6-4ce7-426a-9f66-da91a2a6a837
- 1048 21:09:32 - 1002.repl-df06c7a6-4ce7-426a-9f66-da91a2a6a837
- 1054 21:10:01 - 1002.mgmt-c55915c2-2fda-43ee-9410-b1c1cbb3e4ae
- 1056 21:10:01 - 1002.repl-c55915c2-2fda-43ee-9410-b1c1cbb3e4ae
- 1063 21:26:00 - 1002.mgmt-8d621997-6356-48c3-acab-76a37081d0f3
- 1065 21:26:00 - 1002.repl-8d621997-6356-48c3-acab-76a37081d0f3
-qpid: list 1020
-<span class="code-object">Object</span> of type qpid.queue: (last sample time: 21:26:02)
- Type Element 1020
- ==========================================================================
- config vhostRef 1002
- config name perftest0
- config durable False
- config autoDelete False
- config exclusive False
- config arguments {'qpid.max_size': 0, 'qpid.max_count': 0}
- config storeRef NULL
- inst msgTotalEnqueues 500000 messages
- inst msgTotalDequeues 500000
- inst msgTxnEnqueues 0
- inst msgTxnDequeues 0
- inst msgPersistEnqueues 0
- inst msgPersistDequeues 0
- inst msgDepth 0
- inst msgDepthHigh 0
- inst msgDepthLow 0
- inst byteTotalEnqueues 512000000 octets
- inst byteTotalDequeues 512000000
- inst byteTxnEnqueues 0
- inst byteTxnDequeues 0
- inst bytePersistEnqueues 0
- inst bytePersistDequeues 0
- inst byteDepth 0
- inst byteDepthHigh 0
- inst byteDepthLow 0
- inst enqueueTxnStarts 0 transactions
- inst enqueueTxnCommits 0
- inst enqueueTxnRejects 0
- inst enqueueTxnCount 0
- inst enqueueTxnCountHigh 0
- inst enqueueTxnCountLow 0
- inst dequeueTxnStarts 0
- inst dequeueTxnCommits 0
- inst dequeueTxnRejects 0
- inst dequeueTxnCount 0
- inst dequeueTxnCountHigh 0
- inst dequeueTxnCountLow 0
- inst consumers 0 consumers
- inst consumersHigh 0
- inst consumersLow 0
- inst bindings 1 binding
- inst bindingsHigh 1
- inst bindingsLow 1
- inst unackedMessages 0 messages
- inst unackedMessagesHigh 0
- inst unackedMessagesLow 0
- inst messageLatencySamples 0
- inst messageLatencyMin 0
- inst messageLatencyMax 0
- inst messageLatencyAverage 0
-qpid:</pre> -</div></div> - -<p>You get the idea... have fun!</p> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Multiple AMQP Version Support.html b/content/xdocs/Multiple AMQP Version Support.html deleted file mode 100755 index 22a1c09801..0000000000 --- a/content/xdocs/Multiple AMQP Version Support.html +++ /dev/null @@ -1,192 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Multiple AMQP Version Support</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Multiple AMQP Version Support - </span> - </div> - <div class="pagesubheading"> - This page last changed on Oct 30, 2006 by <font color="#0050B2">kpvdr</font>. - </div> - - <style type='text/css'>/*<![CDATA[*/ -div.rbtoc1208857652225 {margin-left: 1.5em;padding: 0px;} -div.rbtoc1208857652225 ul {margin-left: 0px;padding-left: 20px;} -div.rbtoc1208857652225 li {margin-left: 0px;padding-left: 0px;} - -/*]]>*/</style><div class='rbtoc1208857652225'> -<ul> - <li><a href='#MultipleAMQPVersionSupport-MultipleAMQPVersionSupportinQpid'>Multiple-AMQP Version Support in Qpid </a> -<ul> - <li><a href='#MultipleAMQPVersionSupport-1.CurrentGeneratorStatus'>1. Current Generator Status </a></li> - <li><a href='#MultipleAMQPVersionSupport-2.GeneratorDescription'>2. Generator Description </a> -<ul> - <li><a href='#MultipleAMQPVersionSupport-2.1.Overview'>2.1. Overview </a></li> - <li><a href='#MultipleAMQPVersionSupport-2.2.AMQPverionmodel'>2.2. AMQP verion model </a></li> -</ul></li> - <li><a href='#MultipleAMQPVersionSupport-3.CodeGeneration'>3. Code Generation </a> -<ul> - <li><a href='#MultipleAMQPVersionSupport-3.1.DifferenceModes'>3.1. Difference Modes </a></li> - <li><a href='#MultipleAMQPVersionSupport-3.2JavaGeneration'>3.2 Java Generation</a></li> - <li><a href='#MultipleAMQPVersionSupport-3.3.CGeneration'>3.3. C++ Generation</a></li> -</ul></li> -</ul></li> -</ul></div> -<h1><a name="MultipleAMQPVersionSupport-MultipleAMQPVersionSupportinQpid"></a>Multiple-AMQP Version Support in Qpid </h1> -<p>This page describes an effort to allow multiple AMQP versions to be supported in the broker. This implies:</p> -<ul> - <li>that a broker will be able to accept a connection from clients requesting a variety of versions of the AMQ protocol;</li> - <li>The versions to be supported in this manner are determined at compile time;</li> - <li>A code generator generates the framing classes directly from the XML specification file(s), allowing generated classes to support any of the supported versions.</li> - <li>Each of these classes need only the major and minor version numbers at instantiation to represent a frame from that protocol version.</li> -</ul> - - -<p>The thinking behind the following generator description is described in <a href="AMQPVersion.1.html" title="AMQPVersion.1">AMQPVersion.1</a>. Option 3 (Intelligent Generation) was selected for this implementation.</p> - -<h2><a name="MultipleAMQPVersionSupport-1.CurrentGeneratorStatus"></a>1. Current Generator Status </h2> -<p>The Java generator is more-or-less complete and has been checked into subversion under the gentools directory for initial review. It has <b>not</b> been integrated into the Qpid project as yet; I would like to complete the C++ generation first. However, while the C++ work is in progress, the Java generator is available for review and comment. For instructions on installing and running, see the README file in the gentools directory.</p> - -<h2><a name="MultipleAMQPVersionSupport-2.GeneratorDescription"></a>2. Generator Description </h2> -<h3><a name="MultipleAMQPVersionSupport-2.1.Overview"></a>2.1. Overview </h3> -<p>The generator first reads in all the listed specification files and constructs from them a memory model (structure) of the specifications "superimposed" on top of each other so that the differences between them are easy to determine. A domain map (which maps all domain names to their simple domain types) is also constructed.</p> - -<p>The generator then uses the model to perform code generation. This is achieved by using templates which contain the static parts of the code (which are simply reproduced) and in which are embedded tokens. These tokens, when encounted in the template, are passed on to the generator class, which then uses the context and model to generate specific the version-dependent sections of the code.</p> - -<p>Both of these are discussed in more detail below.</p> - -<h3><a name="MultipleAMQPVersionSupport-2.2.AMQPverionmodel"></a>2.2. AMQP verion model </h3> -<p>The memory model has two parts - the <b>domain map</b> and the <b>model</b> (specification structure) itself.</p> - -<p><ins><b>Domain Map</b></ins></p> - -<p>The domain map is a two-level map. The lowest level maps the simple domain types to the AMQP versions in which they are defined. The upper level maps the domain names to the simple domain type.</p> - -<p>In the following hypothetical example, the <em><b>class-id</b></em> domain is changed from <em>short</em> in v.0.8 to <em>long</em> in v.0.9, then back to <em>short</em> in v.0.10. The <em><b>queue-type</b></em> domain was introduced in v.0.10, while the <em><b>redirected</b></em> was removed in v0.9.</p> -<div class="preformatted" style="border-style: solid; "><div class="preformattedContent"> -<pre>access-ticket --- shortstr --- V[0.8, 0.9, 0.10]
-
-class-id -+------ short ------ V[0.8, 0.10]
- +------ long ------- V[0.9]
-
-queue-type ------ shortstr --- V[0.10]
-
-redirected ------ bit -------- V[0.8]
-</pre> -</div></div> - -<p>A simplified version of the object model is as follows:</p> -<div class="panel" style="border-style: solid; "><div class="panelHeader" style="border-bottom-style: solid; background-color: #FFEFEF; "><b>Domain Map class diagram</b></div><div class="panelContent" style="background-color: #FFFFEF; "> -<p> <img src="Multiple AMQP Version Support_attachments/AmqpDomainMap.png" align="absmiddle" border="0" /> </p> -</div></div> - -<p><ins><b>Specification Model</b></ins></p> - -<p>The specification model consists of a series of embedded maps in the same logical structure as the XML specification elements themsleves: the model contains a map of class maps; class maps contain field and method maps; method maps contain field maps. At the lowest level, there is a map to a set of AMQP versions.</p> - -<p>The following illustrates a small portion of a model.<br/> -The <em><b>Access</b></em> class has an index of <em>30</em> for versions 0.8 - 0.10. The <em><b>request</b></em> method has index <em>10</em> in v.0.8 and 0.9, but was changed to <em>20</em> in v.0.10. This method has a <em><b>active</b></em> field in ordinal <em>1</em> and a <em><b>realm</b></em> field in ordinal <em>0</em> for all versions. The <em>realm</em> field is of domain <em><b>path</b></em> for version 0.8, but was changed to <em>domain</em> shortstr in versions 0.9 ans 0.10. <b>NOTE:</b> The domains in this model are the domain names, not the domain types. The Domain Map above is used to look up the domain type.</p> -<div class="preformatted" style="border-style: solid; "><div class="preformattedContent"> -<pre>C Access -+---- I 30 ---------- V[0.8, 0.9, 0.10]
- +---- M request -+-+- I 10 -------- V[0.8, 0.9]
- | +- I 20 -------- V[0.10]
- +-+- F active --+- O 1 ---------- V[0.8, 0.9, 0.10]
- | +- D bit -------- V[0.8, 0.9, 0.10]
- +- F realm -+--- O 0 ---------- V[0.8, 0.9, 0.10]
- +-+- D path ------- V[0.8]
- +- D shortstr --- V[0.9, 0.10]
-
-C = class; M = method; F = field; D = domain name; I = index; O = ordinal; V = version(s)
-</pre> -</div></div> - -<p>An <em><b>ordinal</b></em> is the index number of a field implied by its relative position in the XML specification file. The first field in a class or method has ordinal 0, the second ordinal 1, etc.</p> - -<p>A simplified version of the object model is as follows:</p> -<div class="panel" style="border-style: solid; "><div class="panelHeader" style="border-bottom-style: solid; background-color: #FFEFEF; "><b>Model class diagram</b></div><div class="panelContent" style="background-color: #FFFFEF; "> -<p> <img src="Multiple AMQP Version Support_attachments/AmqpModel.png" align="absmiddle" border="0" /> </p> -</div></div> - -<p><ins><b>Generation</b></ins></p> - -<p>The Generator itself consists of a template passer and large number of code-generating methods for handling the various tokens that are embedded in the templates.</p> - -<p>Templates contain three types of tokens:</p> -<ol> - <li>Filename tokens, which determine the name of the file to be generated;</li> - <li>Simple Class/Method/Field replacement tokens in which the name of these elements are used to replace the token (e.g. "${CLASS}${METHOD}Body" becomes "BasicConsumeBody");</li> - <li>List tokens, in which a code snippet is generated once for each item in the list. A second token on the same line determines the code snippet that will be generated. The list tokens cannot be combined or embedded within each other. There are four list tokens: - <ol> - <li>%{VLIST} which generates once per version;</li> - <li>%{CLIST} which generates once per class;</li> - <li>%{MLIST} which generates once per method;</li> - <li>%{FLIST} which generates once per field.</li> - </ol> - </li> -</ol> - - -<h2><a name="MultipleAMQPVersionSupport-3.CodeGeneration"></a>3. Code Generation </h2> -<h3><a name="MultipleAMQPVersionSupport-3.1.DifferenceModes"></a>3.1. Difference Modes </h3> -<p>The following changes may take place between one version and the next:</p> -<ul> - <li>Addition of classes, methods, fields or domains;</li> - <li>Deletion of classes, methods, fields or domains;</li> - <li>Modification of field domains or domain types;</li> - <li>Modification of the ordinal position of fields;</li> - <li>Modification of the index of classes or methods;</li> -</ul> - - -<h3><a name="MultipleAMQPVersionSupport-3.2JavaGeneration"></a>3.2 Java Generation</h3> -<h4><a name="MultipleAMQPVersionSupport-3.2.1.MethodBodyclasses"></a>3.2.1. MethodBody classes </h4> -<p>MethodBody classes here.</p> - -<h4><a name="MultipleAMQPVersionSupport-3.2.2.PropertyContentHeaderclasses"></a>3.2.2. PropertyContentHeader classes </h4> -<p>PropertyContentHeader classes here.</p> - -<h4><a name="MultipleAMQPVersionSupport-3.2.3.Registryclasses"></a>3.2.3. Registry classes </h4> -<p>Registry classes here.</p> - -<h3><a name="MultipleAMQPVersionSupport-3.3.CGeneration"></a>3.3. C++ Generation</h3> -<p>Watch this space...</p> - - <br/> - <div class="tabletitle"> - <a name="attachments">Attachments:</a> - </div> - - <div class="greybox" align="left"> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="Multiple AMQP Version Support_attachments/AmqpDomainMap.png">AmqpDomainMap.png</a> (image/png) - <br/> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="Multiple AMQP Version Support_attachments/AmqpDomainMap.png">AmqpDomainMap.png</a> (image/png) - <br/> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="Multiple AMQP Version Support_attachments/AmqpModel.png">AmqpModel.png</a> (image/png) - <br/> - </div> - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Multiple AMQP Version Support_attachments/AmqpDomainMap.png b/content/xdocs/Multiple AMQP Version Support_attachments/AmqpDomainMap.png Binary files differdeleted file mode 100755 index 9415923f6f..0000000000 --- a/content/xdocs/Multiple AMQP Version Support_attachments/AmqpDomainMap.png +++ /dev/null diff --git a/content/xdocs/Multiple AMQP Version Support_attachments/AmqpModel.png b/content/xdocs/Multiple AMQP Version Support_attachments/AmqpModel.png Binary files differdeleted file mode 100755 index 5282c8d2ec..0000000000 --- a/content/xdocs/Multiple AMQP Version Support_attachments/AmqpModel.png +++ /dev/null diff --git a/content/xdocs/Navigation.html b/content/xdocs/Navigation.html deleted file mode 100755 index ff44323cb8..0000000000 --- a/content/xdocs/Navigation.html +++ /dev/null @@ -1,77 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Navigation</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Navigation - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 15, 2008 by <font color="#0050B2">ritchiem</font>. - </div> - - <div class="panel" style="border-style: solid; border-color: #202080; "><div class="panelContent" style="background-color: E0E0FF; "> -<p><img src="Navigation_attachments/apache-incubator-logo-small.png" align="absmiddle" border="0" /></p> - -<h3><a name="Navigation-ApacheQpid"></a>Apache Qpid</h3> -<p> <a href="Index.html" title="Index">Home</a><br/> - <a href="People.html" title="People">People</a><br/> - <a href="Project Status.html" title="Project Status">Project Status</a></p> - -<p> <a href="Download.html" title="Download">Download</a><br/> - <a href="Getting Started.html" title="Getting Started">Getting Started</a> <br/> - <a href="Mailing Lists.html" title="Mailing Lists">Mailing Lists</a><br/> - <a href="License.html" title="License">License</a></p> - -<h3><a name="Navigation-Resources"></a>Resources</h3> -<p> <a href="Getting Involved.html" title="Getting Involved">Getting Involved</a><br/> - <a href="Source Repository.html" title="Source Repository">Source Repository</a><br/> - <a href="Building.html" title="Building">Building Qpid</a></p> - -<p> <a href="http://issues.apache.org/jira/browse/qpid" title="Visit page outside Confluence">Issue Reporting</a><br/> - <a href="Developer Pages.html" title="Developer Pages">Developer Pages</a><br/> - <a href="Acknowledgment.html" title="Acknowledgment">Acknowledgment</a></p> - -<h3><a name="Navigation-AboutAMQP"></a>About AMQP</h3> -<p> <a href="http://www.amqp.org" title="Visit page outside Confluence">What is the AMQProtocol?</a></p> - -<p> <a href="https://jira.amqp.org/confluence/display/AMQP/Download" title="Visit page outside Confluence">AMQProtocol Specification Download</a></p> - -<p><img src="Navigation_attachments/AMQP_logo_71px-small.jpg" align="absmiddle" border="0" /></p> -</div></div> - - <br/> - <div class="tabletitle"> - <a name="attachments">Attachments:</a> - </div> - - <div class="greybox" align="left"> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="Navigation_attachments/AMQP_logo_71px-small.jpg">AMQP_logo_71px-small.jpg</a> (image/jpeg) - <br/> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="Navigation_attachments/apache-incubator-logo-small.png">apache-incubator-logo-small.png</a> (image/png) - <br/> - </div> - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Navigation_attachments/AMQP_logo_71px-small.jpg b/content/xdocs/Navigation_attachments/AMQP_logo_71px-small.jpg Binary files differdeleted file mode 100755 index 655766e3fc..0000000000 --- a/content/xdocs/Navigation_attachments/AMQP_logo_71px-small.jpg +++ /dev/null diff --git a/content/xdocs/Navigation_attachments/apache-incubator-logo-small.png b/content/xdocs/Navigation_attachments/apache-incubator-logo-small.png Binary files differdeleted file mode 100755 index e16f3f90eb..0000000000 --- a/content/xdocs/Navigation_attachments/apache-incubator-logo-small.png +++ /dev/null diff --git a/content/xdocs/NeverUseStaticLocalVariables.html b/content/xdocs/NeverUseStaticLocalVariables.html deleted file mode 100755 index 1a3b73b9fd..0000000000 --- a/content/xdocs/NeverUseStaticLocalVariables.html +++ /dev/null @@ -1,48 +0,0 @@ -<html> - <head> - <title>Apache Qpid : NeverUseStaticLocalVariables</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : NeverUseStaticLocalVariables - </span> - </div> - <div class="pagesubheading"> - This page last changed on Oct 19, 2006 by <font color="#0050B2">mmccorma</font>. - </div> - - <p>Never do this:</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">void f() {
- <span class="code-keyword">static</span> <span class="code-object">int</span> x = 10;
-}</pre> -</div></div> - -<p>Static on a local variable means the compiler is supposed initialize it the first time the function is entered, but it holds its value on subsequent calls. It's sometimes used for local counters, or in the "Myers Singleton" approach to singletons. </p> - -<p>The problem is that the C++ standard does not require compilers to make this initialization thread safe, and almost none do. So in a multi threaded program if there are concurrent first calls to f there will be a disaster. Using this for singletons is particularly prone to multi-threaded collisions.</p> - -<p>So use the less elegant but safer options: make the variable a class member for member functions or a file-private global for non-member functions.</p> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/NoUsingNamespaceInHeaders.html b/content/xdocs/NoUsingNamespaceInHeaders.html deleted file mode 100755 index 7545bbfdd3..0000000000 --- a/content/xdocs/NoUsingNamespaceInHeaders.html +++ /dev/null @@ -1,49 +0,0 @@ -<html> - <head> - <title>Apache Qpid : NoUsingNamespaceInHeaders</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : NoUsingNamespaceInHeaders - </span> - </div> - <div class="pagesubheading"> - This page last changed on Oct 19, 2006 by <font color="#0050B2">mmccorma</font>. - </div> - - <p>Don't use the{{using namespace ...}} or <tt>using ...</tt> constructs in a header file. It might save you some typing but it also forces the namespaces you use onto every <tt>.cpp</tt> file that directly or indirectly includes your headers. That could create name clashes with names in some other namespace that the author of the <tt>.cpp</tt> file wants to use. Use fully qualified names, painful as it might be.</p> - -<p>There is one exception. It's sometimes handy to "import" names from one namespace to another. For example suppose some C++ compiler doesn't provide the <tt>std::tr1::auto_ptr</tt> template, which is used in qpid. <a href="http://www.boost.org" title="Visit page outside Confluence">Boost</a> does provide a compatible <tt>boost::auto_ptr</tt> but it's in the boost namespace and qpid expects it in <tt>std::tr1</tt>. No problem, we create our own tr1/memory header file:</p> - -<div class="code"><div class="codeContent"> -<pre class="code-java">#include <boost/memory>
-namespace std {
- namespace tr1 {
- using boost::auto_ptr;
- }
-}</pre> -</div></div> - -<p>This makes the boost template available in the standard namespace. (Actually you don't need to do this yourself, boost provides a set of adapter headers for all the tr1 stuff.)</p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/OSVC.html b/content/xdocs/OSVC.html deleted file mode 100755 index 11986b7480..0000000000 --- a/content/xdocs/OSVC.html +++ /dev/null @@ -1,137 +0,0 @@ -<html> - <head> - <title>Apache Qpid : OSVC</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : OSVC - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 11, 2008 by <font color="#0050B2">cctrieloff</font>. - </div> - - <h3><a name="OSVC-ARHEL4Grimoire"></a>A RHEL4 Grimoire</h3> - -<p>by Michael Goulish on this 11th day of April, 2008</p> - -<h2><a name="OSVC-Introduction"></a>Introduction</h2> - -<p>Programmer! Turn back now, if you can, to the daylit world!</p> - -<p>But if you must walk this road - take with you this map! Do not stray into the mires and pits where I have wandered and despaired.</p> - -<p>Herein I will describe what I can of the perils I have encountered in the antique land of RHEL4.</p> - -<h2><a name="OSVC-Iteratorsandthe%22%3E%22operator."></a>Iterators and the "->" operator.</h2> - -<p>I believe this is a compiler problem with the -> operator, in the neighborhood of any kind of iterators.</p> - -<p>Code like this will not compile:</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">ConsumerImplMap::iterator i = consumers.find(delivery.getTag()); - -<span class="code-keyword">if</span> (i != consumers.end()) -{ get_pointer(i)->acknowledged(delivery); <span class="code-comment">// <--- Bad! }</span></pre> -</div></div> - -<p>Do this instead:</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">ConsumerImplMap::iterator i = consumers.find(delivery.getTag()); - -<span class="code-keyword">if</span> (i != consumers.end()) -{ (*i).second->complete(delivery); <span class="code-comment">// <--- Good! }</span></pre> -</div></div> - -<p>( Thanks, Kim! )</p> - -<h2><a name="OSVC-Don%27tuseBOOSTFIXTURETESTCASE"></a>Don't use BOOST_FIXTURE_TEST_CASE</h2> - -<p>Because it Doesn't Exist.</p> - -<p>All it does is allow you to use a class (or struct) declaration in many test cases without declaring it in every one.</p> - -<p>So what? Big deal! Just declare your structure in each test case, and use the QPID_AUTO_TEST_CASE macro instead!</p> - -<p>If you have this struct:</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">struct ClientSessionFixture : <span class="code-keyword">public</span> Foo -{ <span class="code-object">int</span> bar; }</pre> -</div></div> - -<p>Don't do this:</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">BOOST_FIXTURE_TEST_CASE(testQueueQuery, ClientSessionFixture) -{ bar = 666; BOOST_CHECK_EQUAL ( bar, 666 ); }</pre> -</div></div> - -<p>Do do this:</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">QPID_AUTO_TEST_CASE(testQueueQuery) -{ ClientSessionFixture fix; fix.bar = 666; BOOST_CHECK_EQUAL ( fix.bar, 666 ); }</pre> -</div></div> - -<p>(Thanks, Alan!)</p> - -<h2><a name="OSVC-Don%27tusetheBOOST%5C%7B%7DTEST%7B%7Dmacros%5C%21"></a>Don't use the BOOST_<b><em>TEST</em></b> macros !</h2> - -<p>If you are tempted to use</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">BOOST_AUTO_TEST_SUITE, or - -BOOST_AUTO_TEST_CASE, or - -BOOST_AUTO_TEST_SUITE_END,</pre> -</div></div> -<p>dont!</p> - -<p>Use instead:</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">QPID_AUTO_TEST_SUITE, or - -QPID_AUTO_TEST_CASE, or - -QPID_AUTO_TEST_SUITE_END !</pre> -</div></div> -<p>They turn into Appropriate Things depending on the version of Boost you are using.</p> - -<p>Sometimes the Appropriate Thing is whitespace...</p> - -<p>(Thanks, Alan and Kim !)</p> - -<h2><a name="OSVC-Don%27tuseboost%3A%3Aiostreams."></a>Don't use boost::iostreams.</h2> - -<p>They don't exist.</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">/usr/include/boost/iostreams/: No such file or directory</pre> -</div></div> -<p>Instead, use low-level Unix IO, from the Dawn of Time.</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">open() - -read() - -write()</pre> -</div></div> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Old Clustering Design Note.html b/content/xdocs/Old Clustering Design Note.html deleted file mode 100755 index 59e425533f..0000000000 --- a/content/xdocs/Old Clustering Design Note.html +++ /dev/null @@ -1,185 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Old Clustering Design Note</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Old Clustering Design Note - </span> - </div> - <div class="pagesubheading"> - This page last changed on Mar 08, 2007 by <font color="#0050B2">aconway</font>. - </div> - - <h1><a name="OldClusteringDesignNote-Overview"></a>Overview </h1> - -<p>The following is a proposal for the design of a clustering solution to increase the scalability of the Qpid AMQP broker by allowing multiple broker processes to collaborate to provide services to application clients connected to any one of these processes. By spreading the connections across different processes more clients can be supported.</p> - -<h2><a name="OldClusteringDesignNote-Terms%26Definitions"></a>Terms & Definitions </h2> - -<p>A cluster consists of any number of brokers in a fixed order. Each broker in the cluster has a unique name. All brokers in the cluster know the set of brokers in their cluster and agree on the ordering of those brokers. The first broker in the cluster is the leader; all brokers agree on the current leader. The mechanisms for achieving and maintaining this structure will be described below.</p> - -<p>Each client is connected to one broker in the cluster, to whom it sends its requests in the same way it would were it connected to a broker that was not part of a cluster. Clients that implement the AMQP specification should be able to work with a clustered broker unaltered. However, when in a cluster, a broker will need to alter its response to certain client requests. An objective of the design is to minimise the scope and complexity of this altered behaviour.</p> - -<p>Brokers in a cluster all connect to each other. Though one socket between any two brokers would suffice, it is simpler to implement if we assume that each broker will be a client of each other broker. Thus there will in fact be two connections between any two members, one in each 'direction'. This way we can reuse as much of a non-clustered brokers behaviour as possible.</p> - -<p>A broker will need to distinguish between sessions with an application client and sessions where the 'client' of the socket in a session is actually another broker.</p> - -<h2><a name="OldClusteringDesignNote-OutlineofApproachforClustering"></a>Outline of Approach for Clustering </h2> - -<p>Stated simply, the cluster will:</p> - -<ul> - <li>replicate exchanges by broadcasting the original Exchange.Declare and Exchange.Delete messages to all members of the cluster.</li> -</ul> - - -<ul> - <li>replicate queues by broadcasting the original Queue.Declare and Queue.Delete messages to all members of the cluster</li> -</ul> - - -<ul> - <li>replicate bindings by broadcasting Queue.Bind messages to all members of the cluster</li> -</ul> - - -<ul> - <li>relay messages from a copy of an exchange in one broker to the equivalent exchange in another broker where necessary to ensure that consumers on any broker in the cluster receive messages that are published to any broker in the cluster</li> -</ul> - - -<p>Private queues exist in real form in only one broker; the broker that receives the original declaration from a client. All the other brokers in the cluster set up a proxy for this queue. This proxy can be bound to exchanges as a normal queue can, but whenever a message is routed to it, that message is simply relayed on to the broker in which the real queue exists. However, though multiple queue proxies may exist with the same target member, if these are bound such that all of them match a given message, only one copy of that message should be relayed to the target member.</p> - -<p>Copies of shared queues will exist at each broker in the cluster. These are bound to exchanges as usual and can have consumers registered with them. In addition to consumers from the application clients, these shared queue copies track the number of consumer for that queue that are held on other brokers. They use this information to fairly distribute messages between all consumers.</p> - -<p>The clustering in general involves propagation of certain methods received by one broker in the cluster from a client to all the other cluster members. Specifically those methods concerned with the setup of routing information are propagated allowing all members of the cluster to play their part in the routing of messages from and to clients distributed across the cluster. </p> - -<p>In particular the cluster will propagate all Exchange.Declare, Exchange.Delete, Queue.Declare, Queue.Delete and Queue.Bind messages. It will also propagate Basic.Consume and Basic.Cancel messages that refer to shared queues.</p> - -<p>The propagation can be carried out synchronously or asynchronously with respect to the original client request. In other words the broker that receives one of these messages from a client will send an equivalent message to the other brokers and can then wait until it receives responses from these brokers before it sends the confirmation message back to the client. Alternatively it could return a response to the client immediately. A hybrid approach could also be used. In general the originating broker waits for n responses, where 0 < n < number of members in the cluster. The value of n to be used will be set through policies to achieve the required latency v. consistency trade offs for a particular situation.<br/> -Cluster Management</p> - -<p>As mentioned above the cluster is defined to be an agreed set of member brokers in an agreed order. This helps reasoning about consistency. The 'first' member of the group acts as the leader and issues authoritative statements on who is in or out of the cluster. All brokers in the cluster store the last received membership announcement from which they can infer the current leader.</p> - -<p>Ordering is maintained by requiring that new members join through the leader. A prospective new member can connect to any other member in the cluster, but these other members should pass on the join request to the leader. </p> - -<p>Once connected to a member of the group the new member issues a join request, to which the leader responds by sending a new membership announcement to all members including the new member. It will also initiate the replay messages required to replicate cluster state to the new member; the other cluster members also participate in this message replay. Once it has processed all the replayed messages and is therefore up to date with respect to cluster state, the new member can start accepting client connections.</p> - -<p>State is transferred through (a) Exchange.Declare methods for all exchanges, (b) Queue.Declare messages for all queues, (c) Queue.Bind requests for all queue bindings in all exchanges and (d) Basic.Consume requests for all consumers of shared queues at each node. The leader is responsible for replicating all exchanges, shared queues and their bindings. Other members are responsible for replicating private queues hosted by them and the bindings for these queues as well as consumer counts for shared queues. The replay of messages from the leader must be processed before those from other cluster members (as e.g. bindings for private queues require that the exchanges have already been declared). The completion of the required replay of messages from a broker is signaled by a Cluster.Synch message. Messages received after this are 'live' messages received through the receiving broker being treated as a normal member.</p> - -<p>Failure of a broker may be detected by any other broker in the cluster in the course of trying to communicate with that broker. Failures are handled by sending a suspect message to the leader of the cluster, who verifies the suspected broker is down and issues a new announcement of membership, with the failed broker removed if the failure is verified. In addition to discovery of failure during normal communication, each broker member is responsible for periodically pinging the 'previous' broker (i.e. the broker that occurs just before itself in the ordered membership list). The leader will assume responsibility for pinging the last member to join the group.</p> - -<p>The leader may itself fail. This may be detected by the next broker in the list, in which case that broker responds by assuming leadership and sending an announcement of the new membership list with the old leader removed. It may also be detected by other brokers. As they cannot send a suspect warning to the leader, they send it to the broker next to the leader.<br/> -Message Handling Changes and Protocol Extensions</p> - -<p>To incorporate clustering while reusing the same communication channel for intra-cluster communications and extension to the protocol is proposed. It is not necessary for clients to know about this extension so it has no impact on the compliance of the broker and can be treated as a proprietary extension for Qpid. The extension consists of a new class of messages, Cluster, which has the following methods:</p> - -<h3><a name="OldClusteringDesignNote-Cluster.Join"></a>Cluster.Join </h3> - -<p>Sent by a new member to the leader of the cluster to initiate the joining process. On receiving a join the leader will try to establish its own connection back to the new member. It will then send a membership announcement and various messages to ensure the new member has the required state built up.</p> - -<h3><a name="OldClusteringDesignNote-Cluster.Membership"></a>Cluster.Membership </h3> - -<p>Sent by the leader of the cluster whenever there is a change in the membership of the cluster either through a new broker joining or through a broker leaving or failing. All brokers should store the membership information sent. If they are waiting for responses from a member that is no longer part of the cluster they can handle the fact that that broker has failed. If it contains a member to whom they have not connected they can connect (or reconnect).</p> - -<h3><a name="OldClusteringDesignNote-Cluster.Leave"></a>Cluster.Leave </h3> - -<p>Sent to the leader by a broker that is leaving the cluster in an orderly fashion. The leader responds by sending a new membership announcement.</p> - -<h3><a name="OldClusteringDesignNote-Cluster.Suspect"></a>Cluster.Suspect </h3> - -<p>Sent by brokers in the cluster to the leader of the cluster to inform the leader that they suspect another member has failed. The leader will attempt to verify the falure and then issue a new Cluster.Membership message excluding the suspected broker if it has failed leaving it in if it seems to be responding.</p> - -<h3><a name="OldClusteringDesignNote-Cluster.Synch"></a>Cluster.Synch </h3> - -<p>Sent to complete a batch of message replayed to a new member to allow it to build up the correct state.</p> - -<h3><a name="OldClusteringDesignNote-Cluster.Ping"></a>Cluster.Ping </h3> - -<p>Sent between brokers in a cluster to give or request a heart beat and to exchange information about loading. A ping has a flag that indicates whether it expects a response or not. On receiving a ping a broker updates its local view of the load on that server and if required sends its own ping in response.</p> - -<p>In addition to this new class, the handling of the following is also altered. The handling of each message may depend on whether it is received from an application client or from another broker.</p> - -<h3><a name="OldClusteringDesignNote-Connection.Open"></a>Connection.Open </h3> - -<p>A broker needs to detect whether the open request is from an application client or another broker in the cluster. It will use the capabilities field to do this; brokers acting as clients on other brokers require the 'cluster-peer' capability.</p> - -<p>If a broker receives a Connection.Open from an application client (i.e. if the cluster-peer capability is not required) it may issue a Connection.Redirect if it feels its loading is greater than the loading of other members in the cluster.</p> - -<h3><a name="OldClusteringDesignNote-Exchange.Declare"></a>Exchange.Declare </h3> - -<p>On receiving this message a broker propagates it to all other brokers in the cluster, possibly waiting for responses before responding with an Exchange.Declare-Ok.</p> - -<h3><a name="OldClusteringDesignNote-Queue.Declare"></a>Queue.Declare </h3> - -<p>On receiving this message a broker propagates it to all other brokers in the cluster, possibly waiting for responses before responding with a Queue.Declare-Ok. </p> - -<h3><a name="OldClusteringDesignNote-Queue.Bind"></a>Queue.Bind </h3> - -<p>Again, this is replicated to all other brokers, possibly waiting for responses before sending back a Queue.Bind-Ok to the client. </p> - -<h3><a name="OldClusteringDesignNote-Queue.Delete"></a>Queue.Delete </h3> - -<p>On receiving this message a broker propagates it to all other brokers in the cluster, optionally waiting for responses before responding to the client.</p> - -<h3><a name="OldClusteringDesignNote-Basic.Consume"></a>Basic.Consume </h3> - -<p>If the consume request is for a private queue, no alteration to the processing is required. However, if it is for a shared queue then the broker must additionally replicate the message to all other brokers.</p> - -<h3><a name="OldClusteringDesignNote-Basic.Cancel"></a>Basic.Cancel </h3> - -<p>If the cancel request is for a subscription to a private queue, no alteration to the processing is required. However, if it is for a shared queue then the broker must additionally replicate the message to all other brokers.</p> - -<h3><a name="OldClusteringDesignNote-Basic.Publish"></a>Basic.Publish </h3> - -<p>The handling of Basic.Publish only differs from the non-clustered case where (a) it ends up in a shared queue or (b) it ends up in a 'proxy' for a private queue that is hosted within another member of the cluster.</p> - -<p>When the published message ends up in a shared queue, the broker must be aware of whether the message was published to it by another broker or by an application client. Messages that come from other brokers are dispatched to the local brokers own application client subscribers. Messages that come from application clients are either dispatched to the next application client or relayed to another broker. A round-robin scheme applies here where each subscriber, whether a 'real' subscriber or a consumer in a relay link to another broker, gets its 'turn'.</p> - -<p>In other words the allocation of a message to a consumer on a shared queue happens at the first broker to receive the publish request from the application. All brokers signal their local consumer count by propagating the Basic.Consume (and Basic.Cancel) messages they receive from clients so each broker has a local view of the cluster wide distribution of consumers which can be used to achieve a fair distribution of messages received by that broker.</p> - -<p>As each broker can receive messages from the application, strict round-robin delivery is not guaranteed, but in general a fair distribution will result. Brokers should remember the next consumer to receive messages from the application and also the next consumer to receive messages from the cluster.</p> - -<p>A local broker's view of consumer distribution is updated asynchronously with respect to message publishing and dispatch. This means that the view might be stale with regard to the remote consumer counts when the next consumer for a message is determined. It is therefore possible that one broker directs a message to a broker that it thinks has a consumer, but when that message arrives at the remote broker the consumer has disconnected. How this is handled should be controlled through different policies: pass it on to another broker, possibly with the redelivered flag set (particularly if it goes back to the broker it came from), discard the message or hold on to it for a finite period of time and deliver it to any application consumer that subscribes in that time.</p> - -<p>The situation just described is essentially the same situation as in a non-clustered case where a consumer disconnects after a message has been sent to it, but before it has processed that message. Where acknowledgements aren't used the message will be lost, where acknowledgements or transactions are used the message should be redelivered, possible out of sequence. Of course in the clustered case there is a wider window in which this scenario can arise.</p> - -<p>Where the messages is delivered to a proxied private queue, that message is merely relayed on to the relevant broker. However, It is important that where more than one proxied queue to the same target broker are bound to the same exchange, the message only be relayed once. The broker handling the Basic.Publish must therefore track the relaying of the message to its peers.</p> - -<h2><a name="OldClusteringDesignNote-FailureAnalysis"></a>Failure Analysis </h2> - -<p>As mentioned above, the primary objective of this phase of the clustering design is to enable the scaling of a system by adding extra broker processes that cooperate to serve a larger number of clients than could be handle by one broker. </p> - -<p>Though fault tolerance is not a specific objective yet, the cluster must allow for the failure of brokers without bringing the whole system to a halt.</p> - -<p>The current design (and implementation) only handles process failures entirely satisfactorily. Network failures* result in the exclusion of brokers from the cluster and will behave reasonably only where the view of reachability is consistent across the cluster. Network partitions between the cluster nodes will result in independent clusters being formed and there is currently no provision for merging these once the partition heals.</p> - -<ul> - <li>failures here means anything that causes a tcp stream to fail; a relatively straightforward improvement would be to buffered unacknowledged requests that have been broadcast allowing attempts to re-establish a tcp connection on failure and replaying the messages (assuming idempotent messages)</li> -</ul> - - -<p>The group abstraction described above does not provide virtual synchrony. When a broker fails while performing a broadcast to the group, the result will not be uniform across the other members. Where synchronous propagation is used, the client will be ware of this state as it will not have received the response from the broker and will reissue the request on failing over to another broker. (The current failover as implemented in the Qpid client will actually recreate all state required by the client).</p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/People.html b/content/xdocs/People.html deleted file mode 100755 index 887fcc4a77..0000000000 --- a/content/xdocs/People.html +++ /dev/null @@ -1,110 +0,0 @@ -<html> - <head> - <title>Apache Qpid : People</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : People - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 12, 2008 by <font color="#0050B2">cctrieloff</font>. - </div> - - <p>Apache Qpid Committers</p> - -<p>The people listed below have made significant contributions to Qpid by working long and hard to make quality software for the rest of the world to use.</p> - -<p>In addition to providing us contribuions, or being commmitters some of the following people are also members of the Project Management Committee (PPMC - as we are still in incubator). Refer to the How the ASF works for details on meritocracy.</p> - -<p>If you would like to contribute to Qpid please look at the Get Involved page to see how you can contribute.</p> - - -<table class='confluenceTable'><tbody> -<tr> -<td class='confluenceTd'>Aidan Skinner</td> -<td class='confluenceTd'>Alan Conway</td> -<td class='confluenceTd'>Arnaud Simon</td> -<td class='confluenceTd'>Andrew Stitcher</td> -</tr> -<tr> -<td class='confluenceTd'>Carl Trieloff</td> -<td class='confluenceTd'>Gordon Sim</td> -<td class='confluenceTd'>Jim Meyering</td> -<td class='confluenceTd'>John O'Hara</td> -</tr> -<tr> -<td class='confluenceTd'>Kim van der Riet</td> -<td class='confluenceTd'>Marnie McCormack</td> -<td class='confluenceTd'>Martin Ritchie</td> -<td class='confluenceTd'>Nuno Santos</td> -</tr> -<tr> -<td class='confluenceTd'>Paul Fremantle</td> -<td class='confluenceTd'>Rafael Schloming</td> -<td class='confluenceTd'>Rajith Attapattu</td> -<td class='confluenceTd'>Robert Godfrey</td> -</tr> -<tr> -<td class='confluenceTd'>Robert Greig</td> -<td class='confluenceTd'>Rupert Smith</td> -<td class='confluenceTd'>Yoav Shapira</td> -<td class='confluenceTd'> </td> -</tr> -</tbody></table> - -<p>Many thanks to the following people for providing contributions:</p> - -<table class='confluenceTable'><tbody> -<tr> -<td class='confluenceTd'>Colin Crist</td> -<td class='confluenceTd'>Bhupendra Bhardwaj</td> -<td class='confluenceTd'>Kevin Smith</td> -<td class='confluenceTd'>Steve Vinoski</td> -</tr> -<tr> -<td class='confluenceTd'>Steven Shaw</td> -<td class='confluenceTd'>Tomas Restrepo</td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> </td> -</tr> -</tbody></table> - -<p>And many thanks to our project's mentors:</p> - -<table class='confluenceTable'><tbody> -<tr> -<td class='confluenceTd'>Cliff Schmidt</td> -<td class='confluenceTd'>Paul Fremantle</td> -<td class='confluenceTd'>Yoav Shapira</td> -<td class='confluenceTd'>Scott Deboy</td> -</tr> -<tr> -<td class='confluenceTd'>Criag Russel</td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> </td> -</tr> -</tbody></table> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Performance Testing for C++.html b/content/xdocs/Performance Testing for C++.html deleted file mode 100755 index 5cc78d9146..0000000000 --- a/content/xdocs/Performance Testing for C++.html +++ /dev/null @@ -1,155 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Performance Testing for C++</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Performance Testing for C++ - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 15, 2008 by <font color="#0050B2">cctrieloff</font>. - </div> - - <h2><a name="PerformanceTestingforC%2B%2B-Howtomeasureperformanceofmyhardware"></a>How to measure performance of my hardware</h2> - -<p> <b>Overview</b></p> - -<p>Brief page on how to get perf data for your configuration. Note that per data is affected greatly by hardware, and OS tuning. So tune your OS and baseline your hardware. You should be able to get perftest 'below' to within 5%-8% of the max for the baseline of a well setup config. If you can't - welcome to mail the list.</p> - -<p> <b>Basic tuning</b></p> - -<p>Tuning will increase your throughput and increase your determinism. The simple things are turn off cpuspeed, irqbalance etc and set timer resolution for the processors you use.... All the standard stuff.</p> - -<p> <b>Sample Data</b></p> - -<p>Some sample results running on the out of date lump in the corner, running on current hardware you should easily beat these.</p> - -<p> <ins>1K block Size</ins></p> -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'> clients </th> -<th class='confluenceTh'> pubs/sec </th> -<th class='confluenceTh'> subs/sec </th> -<th class='confluenceTh'> transfers/sec </th> -<th class='confluenceTh'> Mbytes/sec </th> -</tr> -<tr> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> </td> -</tr> -</tbody></table> -<p>..</p> - -<p>more data. to illustrate point .... TODO</p> - -<p>...</p> - -<p>Note that there will be two limits, one is the size of the pipe, the other will be how many IO's per-second the hardware can do. On small messages 64bytes or less you will hit the IO limit, on larger messages you will hit the network bandwidth, then scale with more NICs. You can get more 'batch' if you like to get the number up when you hit the IO's per second limit with AMQP-0-10 sync points etc... play with perftest + baseline tools like netperf.</p> - -<p>The following tool is including, or can be located in 'cpp/src/tests/' Run with --help to check the options on the latest version.</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">$ ./perftest --help
-
-N4qpid7Options9ExceptionE: Test Options:
- -h [ --host ] HOST (localhost) Broker host to connect to
- -b [ --broker ] HOST (localhost) Broker host to connect to
- -p [ --port ] PORT (5672) Broker port to connect to
- -v [ --virtualhost ] VHOST virtual host
- -n [ --clientname ] ID (cpp) unique client identifier
- --username USER (guest) user name <span class="code-keyword">for</span> broker log in.
- --password USER (guest) password <span class="code-keyword">for</span> broker log in.
- --help print <span class="code-keyword">this</span> usage statement
- --setup Create shared queues.
- --control Run test, print report.
- --publish Publish messages.
- --subscribe Subscribe <span class="code-keyword">for</span> messages.
- --mode shared|fanout|topic (shared) Test mode.
- shared: --qt queues, --npubs publishers
- and --nsubs subscribers per queue.
-
- fanout: --npubs publishers, --nsubs subs
- cribers, fanout exchange.
- topic: --qt topics, --npubs publishers a
- nd --nsubs subscribers per topic.
-
- --npubs N (1) Create N publishers.
- --count N (500000) Each publisher sends N messages.
- --size BYTES (1024) Size of messages in bytes.
- --pub-confirm yes|no (1) Publisher use confirm-mode.
- --durable yes|no (0) Publish messages as durable.
- --unique-data yes|no (0) Make data <span class="code-keyword">for</span> each message unique.
- --nsubs N (1) Create N subscribers.
- --sub-ack N (0) N>0: Subscriber acks batches of N.
- N==0: Subscriber uses unconfirmed mode
- --qt N (1) Create N queues or topics.
- --iterations N (1) Desired number of iterations of the test
- .
- -s [ --summary ] Summary output: pubs/sec subs/sec transf
- ers/sec Mbytes/sec
- --queue_max_count N (0) queue policy: count to trigger 'flow to
- disk'
- --queue_max_size N (0) queue policy: accumulated size to trigge
- r 'flow to disk'
- --interval_sub ms (0) >=0 delay between msg consume
- --interval_pub ms (0) >=0 delay between msg publish
-
-Logging options:
- --log-output FILE (stderr) Send log output to FILE. FILE can be a file name
- or one of the special values:
- stderr, stdout, syslog
- -t [ --trace ] Enables all logging
- --log-enable RULE (error+) Enables logging <span class="code-keyword">for</span> selected levels and component
- s. RULE is in the form 'LEVEL[+][:PATTERN]'
- Levels are one of:
- trace debug info notice warning error critical
- For example:
- '--log-enable warning+' logs all warning, error
- and critical messages.
- '--log-enable debug:framing' logs debug messages
- from the framing namespace. This option can be
- used multiple times
- --log-time yes|no (1) Include time in log messages
- --log-level yes|no (1) Include severity level in log messages
- --log-source yes|no (0) Include source file:line in log messages
- --log-thread yes|no (0) Include thread ID in log messages
- --log-function yes|no (0) Include function signature in log messages
-
-
-There are two ways to use perftest: single process or multi-process.
-
-If none of the --setup, --publish, --subscribe or --control options
-are given perftest will run a single-process test.
-For a multi-process test first run:
- perftest --setup <other options>
-and wait <span class="code-keyword">for</span> it to complete. The remaining process should run concurrently::
-Run --npubs times: perftest --publish <other options>
-Run --nsubs times: perftest --subscribe <other options>
-Run once: perftest --control <other options>
-Note the <other options> must be identical <span class="code-keyword">for</span> all processes.</pre> -</div></div> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/PrivateLocking.html b/content/xdocs/PrivateLocking.html deleted file mode 100755 index 9207dad803..0000000000 --- a/content/xdocs/PrivateLocking.html +++ /dev/null @@ -1,40 +0,0 @@ -<html> - <head> - <title>Apache Qpid : PrivateLocking</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : PrivateLocking - </span> - </div> - <div class="pagesubheading"> - This page last changed on Oct 19, 2006 by <font color="#0050B2">mmccorma</font>. - </div> - - <p>The only way to write thread safe code without losing your mind is to keep your synchronisation simple and small. You cannot test for thread safety. Really you can't. If synchronization is complicated or spread out it's pretty much impossible to know by inspection whether it's correct.</p> - -<p>A key technique is to encapsulate synchronization <em>inside</em> thread-safe classes. Every public member function should protect <em>itself</em> from concurrent access by using private locks or other synchronization objects. You can verify the synchronization of just that class in isolation. It's much easier to build complicated thread-safe code from simple pieces that you know to be individually thread-safe.</p> - -<p>It's very dangerous to provide public access to locks because now to establish thread safety for a class you have to inspect <em>every potential use</em> of that class. Not to mention every change to or addition of code using the class. Did I mention losing your mind?</p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Project Status.html b/content/xdocs/Project Status.html deleted file mode 100755 index a3e511e0ba..0000000000 --- a/content/xdocs/Project Status.html +++ /dev/null @@ -1,120 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Project Status</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Project Status - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 12, 2008 by <font color="#0050B2">cctrieloff</font>. - </div> - - <p><img src="Project Status_attachments/apache-incubator-logo.png" align="absmiddle" border="0" /></p> - -<h3><a name="ProjectStatus-Status"></a>Status</h3> - -<p>Qpid is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Incubator PMC. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF</p> - -<p><a href="http://incubator.apache.org/projects/qpid.html" title="Visit page outside Confluence">Project Incubation Status Page </a></p> - -<h3><a name="ProjectStatus-Graduation"></a>Graduation</h3> - -<p>We are actively working toward graduation. In our last graduation vote we had thought that we needed a diverse committer base (which we have), however we came to learn that the PMC also needs good diversity (yes - thinking about this it is logical). So we stopped our graduation vote in order to add representation on our PPMC.</p> - -<p>If you would like to become a committer and join the PPMC, <a href="Getting Involved.html" title="Getting Involved">this is how we do it</a>. We would love to have you on the project!</p> - -<p>Here is a copy of our current resolution:</p> -<div class="panel"><div class="panelContent"> -<p> WHEREAS, the Board of Directors deems it to be in the best<br/> - interests of the Foundation and consistent with the<br/> - Foundation's purpose to establish a Project Management<br/> - Committee charged with the creation and maintenance <br/> - of open-source software related to distributed messaging, <br/> - for distribution at no charge to the public.</p> - -<p> NOW, THEREFORE, BE IT RESOLVED, that a Project Management<br/> - Committee (PMC), to be known as the "Apache Qpid Project",<br/> - be and hereby is established pursuant to Bylaws of the<br/> - Foundation; and be it further</p> - -<p> RESOLVED, that the Apache Qpid Project be and hereby is<br/> - responsible for the creation and maintenance of software<br/> - related to distributed messaging; a multiple language <br/> - implementation providing daemons and APIs for publish & <br/> - subscribe, eventing and a wide range of message distribution patterns <br/> - based on the Advanced Message Queuing Protocol (AMQP) and <br/> - related technologies such as (transaction management, federation, <br/> - security, management); and be it further</p> - -<p> RESOLVED, that the office of "Vice President, Qpid" be and<br/> - hereby is created, the person holding such office to serve at<br/> - the direction of the Board of Directors as the chair of the<br/> - Apache Qpid Project, and to have primary responsibility for<br/> - management of the projects within the scope of responsibility<br/> - of the Apache Qpid Project; and be it further</p> - -<p> RESOLVED, that the persons listed immediately below be and<br/> - hereby are appointed to serve as the initial members of the<br/> - Apache Qpid Project:</p> - -<ul> - <li>Alan Conway</li> - <li>Arnaud Simon</li> - <li>Carl Trieloff</li> - <li>Gordon Sim</li> - <li>John O'Hara</li> - <li>Marnie McCormack</li> - <li>Martin Ritchie</li> - <li>Paul Fremantle</li> - <li>Rajith Attapattu</li> - <li>Robert Greig</li> - <li>Robert Godfrey</li> - <li>Yoav Shapira</li> -</ul> - - -<p> NOW, THEREFORE, BE IT FURTHER RESOLVED, that <br/> - Carl Trieloff be appointed to the office of Vice President,<br/> - Qpid, to serve in accordance with and subject to the<br/> - direction of the Board of Directors and the Bylaws of the<br/> - Foundation until death, resignation, retirement, removal or<br/> - disqualification, or until a successor is appointed; and be it<br/> - further</p> - -<p> RESOLVED, that all responsibility pertaining to the Qpid<br/> - encumbered upon the Apache Incubator be hereafter discharged.</p> -</div></div> - - <br/> - <div class="tabletitle"> - <a name="attachments">Attachments:</a> - </div> - - <div class="greybox" align="left"> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="Project Status_attachments/apache-incubator-logo.png">apache-incubator-logo.png</a> (image/png) - <br/> - </div> - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Project Status_attachments/apache-incubator-logo.png b/content/xdocs/Project Status_attachments/apache-incubator-logo.png Binary files differdeleted file mode 100755 index 81fb31ec71..0000000000 --- a/content/xdocs/Project Status_attachments/apache-incubator-logo.png +++ /dev/null diff --git a/content/xdocs/Properties.xml b/content/xdocs/Properties.xml deleted file mode 100755 index 1294d01468..0000000000 --- a/content/xdocs/Properties.xml +++ /dev/null @@ -1,124 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!DOCTYPE article PUBLIC "-//OASIS//DTD Simplified DocBook XML V1.0//EN" -"http://www.oasis-open.org/docbook/xml/simple/1.0/sdocbook.dtd"> -<article> - <title>Explanation of System properties used in Qpid</title> - <para> - This page documents the various System Properties that are currently used in the Qpid Java code base. - </para> - <section> - <title>Client Properties</title> - <section> - <title>STRICT_AMQP</title> - <para>Default:FALSE</para> - <para>This forces the client to only send AMQP compliant frames. This will disable a number of JMS features.</para> - <itemizedlist> - <title>Features disabled by STRICT_AMQP</title> - <listitem><para>Queue Browser</para></listitem> - <listitem><para>Message Selectors</para></listitem> - <listitem><para>Durable Subscriptions</para></listitem> - <listitem><para>Session Recover may result in duplicate message delivery</para></listitem> - <listitem><para>Destination validation, so no InvalidDestinationException will be thrown</para></listitem> - </itemizedlist> - <para>This is associated with property STRICT_AMQP_FATAL</para> - </section> - - <section> - <title>STRICT_AMQP_FATAL</title> - <para>Default:FALSE</para> - <para>This will cause any attempt to utilise an enhanced feature to throw and UnsupportedOperationException. When set to false then the exception will not occur but the feature will be disabled.</para> - <example> - <para>The Queue Browser will always show no messages.</para> - <para>Any message selector will be removed.</para> - </example> - </section> - - <section> - <title>IMMEDIATE_PREFETCH</title> - <para>Default:FALSE</para> - <para>The default with AMQP is to start prefetching messages. However, with certain 3rd party Java tools, such as Mule this can cause a problem. Mule will create a consumer but never consume from it so any any prefetched messages will be stuck until that session is closed. This property is used to re-instate the default AMQP behaviour. The default Qpid behaviour is to prevent prefetch occurring, by starting the connection Flow Controlled, until a request for a message is made on the consumer either via a receive() or setting a message listener.</para> - </section> - - - <section> - <title>amq.dynamicsaslregistrar.properties</title> - <para>The name of the SASL configuration properties file.</para> - </section> - - <section> - <title>amqj.heartbeat.timeoutFactor</title> - <para>Float</para> - <para>The factor used to get the timeout from the delay between heartbeats</para> - </section> - - <section> - <title>amqj.tcpNoDelay</title> - <para>Default:TRUE</para> - <para>Disable Nagle's algorithm on the TCP connection.</para> - </section> - - <section> - <title>amqj.sendBufferSize</title> - <para>DEFAULT_BUFFER_SIZE = 32k</para> - <para>This is the default buffer sized created by Mina.</para> - </section> - - <section> - <title>amqj.receiveBufferSize</title> - <para>DEFAULT_BUFFER_SIZE = 32k</para> - <para>This is the default buffer sized created by Mina.</para> - </section> - - <section> - <title>amqj.protocolprovider.class</title> - <para>DEFAULT:org.apache.qpid.server.protocol.AMQPFastProtocolHandler</para> - <para>This specifies the default IoHandlerAdapter that represents the InVM broker. The IoHandlerAdapter must have a constructor that takes a single Integer that represents the InVM port number.</para> - </section> - - <section> - <title>jboss.host</title> - <para>Used by the JBossConnectionFactoryInitialiser to specify the host to connect to perform JNDI lookups.</para> - </section> - - <section> - <title>jboss.port</title> - <para>Used by the JBossConnectionFactoryInitialiser to specify the port to connect to perform JNDI lookups.</para> - </section> - - </section> - - - <section> - <title>Management Properties</title> - - <section> - <title>security</title> - <para>Default: null</para> - <para>String representing the Security level to be used to on the connection to the broker. The null default results in no security or PLAIN. When used with jmxconnector 'javax.management.remote.jmxmp.JMXMPConnector' a security value of 'CRAM-MD5' will result in all communication to the broker being encrypted.</para> - </section> - - <section> - <title>jmxconnector</title> - <para>Default: null</para> - <para>String representing the JMXConnector class used to perform the connection to the broker. The null default results in the standard JMX connector. Utilising 'javax.management.remote.jmxmp.JMXMPConnector' and security 'CRAM-MD5' will result in all communication to the broker being encrypted.</para> - </section> - - <section> - <title>timeout</title> - <para>Default: 5000</para> - <para>Long value representing the milli seconds before connection to the broker should timeout.</para> - </section> - </section> - - - <section> - <title>Properties used in Examples</title> - - <section> - <title>archivepath</title> - <para>Used in : FileMessageDispatcher</para> - <para>This property specifies the archive directory to move payload file(s) after a successful transfer.</para> - </section> - </section> - -</article> diff --git a/content/xdocs/PythonBrokerTest.html b/content/xdocs/PythonBrokerTest.html deleted file mode 100755 index 94b1f0598b..0000000000 --- a/content/xdocs/PythonBrokerTest.html +++ /dev/null @@ -1,66 +0,0 @@ -<html> - <head> - <title>Apache Qpid : PythonBrokerTest</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : PythonBrokerTest - </span> - </div> - <div class="pagesubheading"> - This page last changed on Oct 19, 2006 by <font color="#0050B2">mmccorma</font>. - </div> - - <h2><a name="PythonBrokerTest-PythonBrokerSystemTestSuite"></a>Python Broker System Test Suite </h2> - -<p>This is a suite of python client tests that exercise and verify broker functionality. Python allows us to rapidly develop client test scenarios and provides a 'neutral' set of tests that can run against any AMQP-compliant broker.</p> - -<p>The python/tests directory contains a collection of python modules, each containing several unittest classes, each containing a set of test methods that represent some test scenario. Test classes inheirt <tt>qpid.TestBas</tt> from <tt>qpid/testlib.py</tt>, it inherits <tt>unittest.TestCase</tt> but adds some qpid-specific <tt>setUp/tearDown</tt> and convenience functions. </p> - -<p>TODO: get pydoc generated up to qpid wiki or website automatically?</p> - -<h3><a name="PythonBrokerTest-Runningthetests"></a>Running the tests </h3> - -<p>Simplest way to run the tests:</p> - -<ul> - <li>Run a broker on the default port</li> - <li><tt>./run_tests</tt></li> -</ul> - - -<p>For additional options: <tt>./run_tests --help</tt></p> - -<h3><a name="PythonBrokerTest-Expectedfailures"></a>Expected failures </h3> - -<p>Until we complete functionality, tests may fail because the tested<br/> -functionality is missing in the broker. To skip expected failures<br/> -in the C++ or Java brokers:</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">./run_tests -I cpp_failing.txt
- ./run_tests -I java_failing.txt</pre> -</div></div> -<p>If you fix a failure, please remove it from the corresponding list.</p> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid 'C++' Documentation.html b/content/xdocs/Qpid 'C++' Documentation.html deleted file mode 100755 index a95a97dfc7..0000000000 --- a/content/xdocs/Qpid 'C++' Documentation.html +++ /dev/null @@ -1,65 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Qpid 'C++' Documentation</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Qpid 'C++' Documentation - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 11, 2008 by <font color="#0050B2">cctrieloff</font>. - </div> - - <h2><a name="Qpid%27C%2B%2B%27Documentation-Introduction"></a>Introduction </h2> - -<p>Contributors should read:</p> -<ul> - <li><a href="https://svn.apache.org/repos/asf/incubator/qpid/trunk/qpid/cpp/README" title="Visit page outside Confluence">README</a> in subversion for build instructions.</li> - <li><a href="CppTips.html" title="CppTips">C++ coding tips</a></li> - <li><a href="CppStyleGuide.html" title="CppStyleGuide">C++ style guide</a></li> - <li><a href="CppApiGuide.html" title="CppApiGuide">C++ public API guidelines</a></li> - <li><a href="OSVC.html" title="OSVC">OS version considerations</a></li> -</ul> - - -<p>Testing guidelines: </p> -<ul> - <li>All classes should be unit tested with <a href="http://www.boost.org/libs/test/doc/index.html" title="Visit page outside Confluence">Boost.Test</a> (Some tests are still using <a href="http://cppunit.sourceforge.net/cppunit-wiki" title="Visit page outside Confluence">CppUnit</a>, they will be converted.)</li> - <li>Broker should pass <a href="PythonBrokerTest.html" title="PythonBrokerTest">PythonBrokerTest</a> with <div class="preformatted"><div class="preformattedContent"> -<pre>./run-tests -I cpp_ignore.tests</pre> -</div></div></li> -</ul> - - -<p>Currently built/tested with g++ on Linux using GNU make.</p> - -<h2><a name="Qpid%27C%2B%2B%27Documentation-DesignNotes"></a>Design Notes</h2> -<ul> - <li><a href="CppHandlerChains.html" title="CppHandlerChains">C++ handler chaining</a></li> - <li><a href="Management Design notes.html" title="Management Design notes">Management Design notes</a></li> -</ul> - - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid .Net Documentation.html b/content/xdocs/Qpid .Net Documentation.html deleted file mode 100755 index a560b801c7..0000000000 --- a/content/xdocs/Qpid .Net Documentation.html +++ /dev/null @@ -1,68 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Qpid .Net Documentation</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Qpid .Net Documentation - </span> - </div> - <div class="pagesubheading"> - This page last changed on Aug 02, 2007 by <font color="#0050B2">ritchiem</font>. - </div> - - <h2><a name="Qpid.NetDocumentation-Purpose"></a>Purpose</h2> - -<h2><a name="Qpid.NetDocumentation-Introduction"></a>Introduction</h2> - -<p>Currently the .NET code base only provides a client API. You will need an AMQP broker to fully use this API.<br/> -Qpid currently provide two broker implementations, C++ and Java.</p> - -<h3><a name="Qpid.NetDocumentation-BrokerGuides"></a>Broker Guides</h3> - -<h4><a name="Qpid.NetDocumentation-JavaBroker"></a>Java Broker</h4> -<ul> - <li><a href="Qpid Java FAQ.html" title="Qpid Java FAQ">Qpid Java FAQ</a></li> - <li><a href="Getting Started Guide.html" title="Getting Started Guide">Java getting started guide for Java broker</a></li> - <li><a href="Qpid Troubleshooting Guide.html" title="Qpid Troubleshooting Guide">Troubleshooting Guide</a></li> - <li><a href="Qpid Java Run Scripts.html" title="Qpid Java Run Scripts">Qpid Java Run Scripts</a></li> -</ul> - - -<h4><a name="Qpid.NetDocumentation-CBroker"></a>C++ Broker</h4> - -<h3><a name="Qpid.NetDocumentation-UserGuide"></a>User Guide</h3> - -<p>.NET User Guide</p> - -<h3><a name="Qpid.NetDocumentation-DeveloperInformation"></a>Developer Information</h3> - -<ul> - <li><a href="Qpid Developer Documentation.html" title="Qpid Developer Documentation">Qpid Developer Documentation</a></li> - <li>Coding Standards</li> - <li>How Tos -<ul><li><a href="Build .NET Client.html" title="Build .NET Client">Build .NET Client</a></li><li><a href="Setup .Net Client on Windows.html" title="Setup .Net Client on Windows">Setup .Net Client on Windows</a></li></ul></li> -</ul> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid .Net How To.html b/content/xdocs/Qpid .Net How To.html deleted file mode 100755 index 24893aa85b..0000000000 --- a/content/xdocs/Qpid .Net How To.html +++ /dev/null @@ -1,41 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Qpid .Net How To</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Qpid .Net How To - </span> - </div> - <div class="pagesubheading"> - This page last changed on Aug 02, 2007 by <font color="#0050B2">ritchiem</font>. - </div> - - <h3><a name="Qpid.NetHowTo-CollectionofHowTos"></a>Collection of How Tos</h3> - -<ul> - <li><a href="Build .NET Client.html" title="Build .NET Client">Build .NET Client</a></li> -</ul> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid Cpp Build How To.html b/content/xdocs/Qpid Cpp Build How To.html deleted file mode 100755 index 6cd43ab196..0000000000 --- a/content/xdocs/Qpid Cpp Build How To.html +++ /dev/null @@ -1,80 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Qpid Cpp Build How To</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Qpid Cpp Build How To - </span> - </div> - <div class="pagesubheading"> - This page last changed on Jan 08, 2007 by <font color="#0050B2">aconway</font>. - </div> - - <h2><a name="QpidCppBuildHowTo-Checkoutthesource"></a>Check out the source</h2> - -<p>Firstly, check the source for Qpid java out of our subversion repository:</p> - -<p><a href="https://svn.apache.org/repos/asf/incubator/qpid/trunk/qpid/" title="Visit page outside Confluence">https://svn.apache.org/repos/asf/incubator/qpid/trunk/qpid/</a></p> - -<h2><a name="QpidCppBuildHowTo-Prerequisites"></a>Prerequisites</h2> - -<p>For the gentools need JDK 1.5 or later. You should set JAVA_HOME and include the bin directory in your PATH.</p> - -<p>Check it's ok by executing java -v !</p> - -<p>For build tools you need to get the correct set of tooling for Linux/ Unix or cygwin. run</p> -<div class="preformatted"><div class="preformattedContent"> -<pre>./qpid-autotools-install -</pre> -</div></div> - -<h1><a name="QpidCppBuildHowTo-BuildInstructionsTrunk"></a>Build Instructions - Trunk</h1> - - -<h2><a name="QpidCppBuildHowTo-Autoconfandautobuild"></a>Autoconf and auto build</h2> - -<p>First you need to create the gentools and initial set of files for automake and autoconf. Run:</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre>./bootstrap -</pre> -</div></div> -<p>To build Qpid now run</p> -<div class="preformatted"><div class="preformattedContent"> -<pre>./configure -make -</pre> -</div></div> - -<p>and finally to make sure all the test pass both C++ and Pyhton run</p> -<div class="preformatted"><div class="preformattedContent"> -<pre>make check -</pre> -</div></div> -<p>As a convenient shortcut you can do all of the above steps in one command with:</p> -<div class="code"><div class="codeContent"> -<pre class="code-java"> ./bootstrap -build</pre> -</div></div> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid Design - Access Control Lists.html b/content/xdocs/Qpid Design - Access Control Lists.html deleted file mode 100755 index c04d6e021c..0000000000 --- a/content/xdocs/Qpid Design - Access Control Lists.html +++ /dev/null @@ -1,44 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Qpid Design - Access Control Lists</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Qpid Design - Access Control Lists - </span> - </div> - <div class="pagesubheading"> - This page last changed on Dec 06, 2007 by <font color="#0050B2">ritchiem</font>. - </div> - - <h3><a name="QpidDesign-AccessControlLists-Overview"></a>Overview</h3> - -<p>The AMQ Protocol specification has not yet formaly specified how access control lists should be specified or implemented as a result this is subject to change</p> - -<p>The Java Qpid provides an authentication framework based on SASL, that provides the ability to plug in arbitrary user (or more strictly <em>principal</em>) databases and different SASL-compliant mechanisms. This mechanism has been extended as a proof of concept to allow access rights to a virtual host. What this page will present is an extension of this early work to include full access control across all objects in the system.</p> - - -<p>The current access file would be modified to provide additional objects for control:</p> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid Design - Application Registry.html b/content/xdocs/Qpid Design - Application Registry.html deleted file mode 100755 index 56cf5a2062..0000000000 --- a/content/xdocs/Qpid Design - Application Registry.html +++ /dev/null @@ -1,52 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Qpid Design - Application Registry</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Qpid Design - Application Registry - </span> - </div> - <div class="pagesubheading"> - This page last changed on Oct 19, 2006 by <font color="#0050B2">rgreig</font>. - </div> - - <p>The Application Registry is a more sophisticated version of the widely used singleton pattern. It allows the registration of services with a central component that manages the lifecycle of those services.</p> - -<h4><a name="QpidDesign-ApplicationRegistry-IApplicationRegistry"></a>IApplicationRegistry</h4> - -<p>The interface <tt>IApplicationRegistry</tt> provides accessors for the following:</p> -<ul> - <li><a href="Qpid Design - Configuration.html#QpidDesign-Configuration-ConfiguredObjects" title="ConfiguredObjects on Qpid Design - Configuration">Configured Objects</a></li> - <li>the raw <a href="Qpid Design - Configuration.html#QpidDesign-Configuration-Configuration" title="Configuration on Qpid Design - Configuration">Configuration</a></li> - <li>various services such as the queue registry and exchange registry</li> -</ul> - - -<h4><a name="QpidDesign-ApplicationRegistry-ApplicationRegistry"></a>ApplicationRegistry</h4> - -<p>The abstract class <tt>ApplicationRegistry</tt> is a partial implementation of <tt>IApplicationRegistry</tt> that provides an implementation of the configured object cache as well as providing singleton access to the concrete application registry.</p> - -<p>Subclasses should instantiate the appropriate services in order to provide access to them. Initialisation of these must be done in the <tt>initialise</tt> method so that those services can use the <tt>ApplicationRegistry</tt> themselves - attempting to initialise services in the constructor can result in <tt>NullPointerExceptions</tt> if they use the registry.</p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid Design - Authentication.html b/content/xdocs/Qpid Design - Authentication.html deleted file mode 100755 index da9d1b5913..0000000000 --- a/content/xdocs/Qpid Design - Authentication.html +++ /dev/null @@ -1,160 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Qpid Design - Authentication</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Qpid Design - Authentication - </span> - </div> - <div class="pagesubheading"> - This page last changed on Jun 09, 2007 by <font color="#0050B2">rgreig</font>. - </div> - - <h3><a name="QpidDesign-Authentication-Overview"></a>Overview</h3> - -<p>The AMQ Protocol specifies that SASL is used to exchange authentication information. However, SASL on its own is only a small part of any authentication solution.</p> - -<p>QPID provides an authentication framework based on SASL, that provides the ability to plug in arbitrary user (or more strictly <em>principal</em>) databases and different SASL-compliant mechanisms. This section describes how to configure both the client and broker and how to add new providers.</p> - -<p>It is strongly recommended that any developer who needs to write a security provider or understand this in depth reads the <a href="http://java.sun.com/j2se/1.5.0/docs/guide/security/sasl/sasl-refguide.html" title="Visit page outside Confluence">SASL Guide</a> that is included with the JDK documentation.</p> - -<h3><a name="QpidDesign-Authentication-PrincipalDatabases"></a>Principal Databases</h3> - -<h5><a name="QpidDesign-Authentication-Classes"></a>Classes</h5> - -<p>Ignoring the exchange of credentials, a key thing that needs to be done is validate that the credentials are valid. The simple example is checking the username and password match those in a password file.</p> - -<p>The interface <tt>org.apache.qpid.server.security.auth.PrincipalDatabase</tt> must be implemented by any "user database". It contains a single method, which takes the <tt>Principal</tt> and the <tt>javax.security.auth.callback.PasswordCallback</tt> that wants to receive the password. This might seem odd, since the obvious approach would be a store that took a principal and some credentials and returned a true or false indicating whether the credentials are valid. However, this approach is required to fit in with the SASL APIs which use callbacks exclusively.</p> - -<p>The only implementation currently provided is <tt>PasswordFilePrincipalDatabase</tt>. This expects to read password from a file which is in the format username:password where the password is in plaintext and a carriage return separates each username and password pair.</p> - -<h5><a name="QpidDesign-Authentication-Configuration"></a>Configuration</h5> - -<p>Clearly different databases will potentially require different configuration options. For example the <tt>PasswordFilePrincipalDatabase</tt> needs to be configured with the location of a password file whereas a Kerberos realm database would need to know the location of a keytab file (for example).</p> - -<p>Configuration is specified in the configuration file like this:</p> -<div class="code" style="border-style: solid; "><div class="codeHeader" style="border-bottom-style: solid; "><b>config.xml</b></div><div class="codeContent"> -<pre class="code-xml"><span class="code-tag"><security></span>
- <span class="code-tag"><principal-databases></span>
- <span class="code-tag"><principal-database></span>
- <span class="code-tag"><name></span>passwordfile<span class="code-tag"></name></span>
- <span class="code-tag"><class></span>org.apache.qpid.server.security.auth.PasswordFilePrincipalDatabase<span class="code-tag"></class></span>
- <span class="code-tag"><attributes></span>
- <span class="code-tag"><attribute></span>
- <span class="code-tag"><name></span>passwordFile<span class="code-tag"></name></span>
- <span class="code-tag"><value></span>broker/etc/passwd<span class="code-tag"></value></span>
- <span class="code-tag"></attribute></span>
- <span class="code-tag"></attributes></span>
- <span class="code-tag"></principal-database></span>
- <span class="code-tag"></principal-databases></span>
-<span class="code-tag"></security></span></pre> -</div></div> -<p>After instantiating the class specified by the <tt>class</tt> element, for each <tt>attribute</tt> an attempt is made to invoke a setter method with value passed in as an argument. In the above example, the method with signature void <tt>setPasswordFile(String arg)</tt> is invoked.</p> - -<p>The name element is significant and must be unique. The name is passed as an argument to the SASL provider implementations (described below).</p> - -<h3><a name="QpidDesign-Authentication-AuthenticationProviders"></a>Authentication Providers</h3> - -<p>The authentication process as described in the AMQ protocol specification is as follows:</p> -<ol> - <li>Broker sends list of authentication mechanisms to the client, in order of preference</li> - <li>Client responds with chosen mechanism plus any initial response</li> - <li>Broker evaluates response and determines whether authentication has succeeded. If authentication is not yet complete, another set of challenge/responses takes place until authentication is completed (with either success or failure).</li> -</ol> - - -<p>The broker configuration allows the administrator to configure the set of supported authentication mechanisms and the principal database used by each mechanism. It also allows the dynamic registration of additional SASL providers (this avoids the need to modify the JRE configuration).</p> - -<h5><a name="QpidDesign-Authentication-AuthenticationProviderInitialiser"></a>AuthenticationProviderInitialiser</h5> - -<p>The <tt>org.apache.qpid.server.security.auth.sasl.AuthenticationProviderInitialiser</tt> interface must be implemented for each mechanism. Note this includes the SASL mechanisms that are supported by default by the JRE (e.g. CRAM-MD5). In particular, the interface allows arbitrary configuration (since each provider may have its own specialised configuration requirements), the specification of a callback handler and a factory class for JCA registration.</p> - -<h5><a name="QpidDesign-Authentication-Configuration"></a>Configuration</h5> - -<p>The following example section from the configuration file illustrates how it might be used:</p> -<div class="code" style="border-style: solid; "><div class="codeHeader" style="border-bottom-style: solid; "><b>config.xml</b></div><div class="codeContent"> -<pre class="code-xml"><span class="code-tag"><sasl></span>
- <span class="code-tag"><mechanisms></span>
- <span class="code-tag"><mechanism></span>
- <span class="code-tag"><initialiser></span>
- <span class="code-tag"><class></span>org.apache.qpid.server.security.auth.CRAMMD5Initialiser<span class="code-tag"></class></span>
- <span class="code-tag"><principal-database></span>passwordfile<span class="code-tag"></principal-database></span>
- <span class="code-tag"></initialiser></span>
- <span class="code-tag"></mechanism></span>
- <span class="code-tag"><mechanism></span>
- <span class="code-tag"><initialiser></span>
- <span class="code-tag"><class></span>org.apache.qpid.server.security.auth.amqplain.AmqPlainInitialiser<span class="code-tag"></class></span>
- <span class="code-tag"><principal-database></span>passwordfile<span class="code-tag"></principal-database></span>
- <span class="code-tag"></initialiser></span>
- <span class="code-tag"></mechanism></span>
- <span class="code-tag"></mechanisms></span>
-<span class="code-tag"></sasl></span></pre> -</div></div> -<p>The above section defines two authentication mechanisms: CRAM-MD5 and AMQPLAIN. Since CRAM-MD5 appears first it will appear on the list of mechanisms offered to the client first. Both mechanisms are configured to use the principal database named "passwordfile" which must be defined in the appropriate section in the config file.</p> - -<h5><a name="QpidDesign-Authentication-CallbackHandlers"></a>CallbackHandlers</h5> - -<p>Each SASL provider works with CallbackHandlers. This enables the provider to obtain information (e.g. the password) from the application as well as set the result of authentication (such as the canonical name of the principal just authenticed). The particular CallbackHandlers vary depending on the mechanism being used. The method <tt>getCallbackHandler</tt> in the <tt>AuthenticationProviderInitialiser</tt> class must return the appropriate handler for the mechanism.</p> - -<h5><a name="QpidDesign-Authentication-AuthenticationProviderInitialiserConfiguration"></a>AuthenticationProviderInitialiser Configuration</h5> - -<p>Since the initialisation of an authentication provider will require potentially arbitrary configuration, the interface supplies to the initialiser the Configuration object as well as the base path into the configuration file so that the initialiser can look for arbitrary configuration elements.</p> - -<h3><a name="QpidDesign-Authentication-ClientAuthentication"></a>Client Authentication</h3> - -<p>Client authentication is similar although it is made simpler by the fact that there is no need for a <tt>PrincipalDatabase</tt>. Since we do not use any heavyweight configuration mechanism (such as the Apache Commons Configuration used by the broker) on the client side, we also need an alternative way to configure providers.</p> - -<h5><a name="QpidDesign-Authentication-CallbackHandlerRegistry"></a>CallbackHandlerRegistry</h5> - -<p>The most important things needed on the client are:</p> -<ol> - <li>a way to specify which SASL mechanisms we want to use, in order of preference</li> - <li>a way to associate a callback handler with a mechanism (remember that different mechanisms require or support different callbacks)</li> -</ol> - - -<p>The <tt>CallbackHandlerRegistry</tt> provides a way to do this. Using a properties file to provide the configuration information, it maps from mechanisms to <tt>AMQCallbackHandler</tt> instances.</p> - -<p><tt>AMQCallbackHandler</tt> extends <tt>javax.security.auth.CallbackHandler</tt> and only adds one method, which associates a protocol session with a callback handler. This enables the callback handler to retrieve any specific information from the <tt>AMQProtocolSession</tt> and by extension from the <tt>javax.jms.Connection</tt>. The obvious example is the username and password.</p> - -<p>To specify callback handlers a property file is used. The default property contains this:</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">CallbackHandler.CRAM-MD5=org.apache.qpid.client.security.UsernamePasswordCallbackHandler
-CallbackHandler.AMQPLAIN=org.apache.qpid.client.security.UsernamePasswordCallbackHandler</pre> -</div></div> -<p>The default callbackhandler registry initialises handlers for CRAM-MD5 and AMQPLAIN. To specify your own propertyfile use the java system property <tt>amq.callbackhandler.properties</tt>.</p> - -<h5><a name="QpidDesign-Authentication-DynamicSaslRegistrar"></a>DynamicSaslRegistrar</h5> - -<p>For SASL providers that are part of the JRE or have been added manually to the JRE security configuration all that is required is the creation of an <tt>AMQCallbackHandler</tt>. However, if you need to use a custom SASL provider it needs to be registered with JCA. Rather than place the burden for doing this on the application developer, we provide a <tt>DynamicSaslRegistrar</tt> which does this.</p> - -<p>To configure Sasl providers, you need to create a properties file in this format:</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">AMQPLAIN=org.apache.qpid.client.security.amqplain.AmqPlainSaslClientFactory</pre> -</div></div> -<p>The key is the mechanism name and the value is the Sasl client factory (which must implement <tt>javax.security.sasl.SaslClientFactory</tt>).</p> - -<p>The default properties file registers only the AMQPLAIN mechanism; you can specify a custom property file using the system property <tt>amq.dynamicsaslregistrar.properties</tt>.</p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid Design - Configuration.html b/content/xdocs/Qpid Design - Configuration.html deleted file mode 100755 index 34c2b38f25..0000000000 --- a/content/xdocs/Qpid Design - Configuration.html +++ /dev/null @@ -1,166 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Qpid Design - Configuration</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Qpid Design - Configuration - </span> - </div> - <div class="pagesubheading"> - This page last changed on Oct 19, 2006 by <font color="#0050B2">rgreig</font>. - </div> - - <h3><a name="QpidDesign-Configuration-ConfigurationMethods"></a>Configuration Methods</h3> - -<p>QPID supports two methods of configuration:</p> -<ol> - <li>command line switches (e.g. passing a -p flag on startup to specify the port)</li> - <li>configuration file</li> -</ol> - - -<p>It is intended that the configuration file will be used for nearly all configuration but that some very common or useful options are exposed using command line switches.</p> - -<h3><a name="QpidDesign-Configuration-CLI"></a>CLI</h3> - -<p>QPID uses <a href="http://jakarta.apache.org/commons/cli" title="Visit page outside Confluence">Commons CLI</a> to parse command line arguments. It provides the following features:</p> -<ul> - <li>Ability to parse both short and long flags (e.g. -p and --port) and treat them as the same logical option</li> - <li>Generation of well formatted usage messages</li> - <li>Ability to specify configuration options in different ways, such as from files or from system properties, which can help when writing unit tests</li> -</ul> - - -<p>The result of parsing options, however they are specified, is a CommandLine object which can then be queried to find out specific values. Currently this is done in org.openamq.broker.Main and the CommandLine object is not exposed elsewhere but if it does require to be more widely used it could be added to the ApplicationRegistry. However it is strongly recommended that the configuration approach in the follow section is used where possible.</p> - -<h3><a name="QpidDesign-Configuration-ConfigurationFile"></a>Configuration File</h3> - -<p>QPID uses <a href="http://jakarta.apache.org/commons/configuration" title="Visit page outside Confluence">Commons Configuration</a> to handle nearly all configuration. It provides methods that allow parsing of options from a range of sources, including configuration files, system properties or simply hard coded classes of values (which is very useful in unit test cases).</p> - -<p>The file format used by QPID is XML, and Commons Configuration allows a very simple XPath-like syntax to query individual elements from the configuration file.</p> - -<p>In order to make using configuration as non-intrusive, flexible and strongly-typed as possible we do the following:</p> -<ul> - <li><a name="QpidDesign-Configuration-ConfiguredObjects"></a> Create classes representing configuration options for a particular component. For example, we have an object to represent all the connection (transport) configuration options. That object is used by the transport-related code rather than dealing with the Commons Configuration objects directly. As well as being strongly typed and easily used in unit tests, this means that a developer can see all the configuration options related to a particular feature in one place.</li> - <li>To make it easier to map between elements in the configuration file and fields in the configuration objects, a Configurable annotation (Java 5 annotation) is applied to the fields in the configuration object which contains the path expression in the configuration file, and default values should no value be specified</li> - <li>The configuration objects are stored in the ApplicationRegistry</li> - <li><a name="QpidDesign-Configuration-Configuration"></a>The commons configuration object is stored in the ApplicationRegistry allowing "direct access" to the raw options should this be required</li> -</ul> - - -<h3><a name="QpidDesign-Configuration-Example"></a>Example</h3> - -<p>An example should make this clearer. Consider a (fictional) configuration file containing the following XM</p> -<div class="code"><div class="codeContent"> -<pre class="code-java"><qpid>
- <connector>
- <ssl><span class="code-keyword">true</span></ssl>
- <port>5672</port>
- </connector>
-</qpid></pre> -</div></div> -<p>To use this in the application we would define a class to represent it:</p> -<div class="code"><div class="codeContent"> -<pre class="code-java"><span class="code-keyword">public</span> class ConnectionConfig
-{
- <span class="code-keyword">public</span> <span class="code-keyword">static</span> <span class="code-keyword">final</span> <span class="code-object">String</span> SSL_PORT = <span class="code-quote">"8672"</span>;
-
- @Configured(path = <span class="code-quote">"connector.port"</span>,
- defaultValue = DEFAULT_PORT)
- <span class="code-keyword">public</span> <span class="code-object">int</span> port;
-
- @Configured(path = <span class="code-quote">"connector.ssl"</span>,
- defaultValue = <span class="code-quote">"<span class="code-keyword">false</span>"</span>)
- <span class="code-keyword">public</span> <span class="code-object">boolean</span> enableSSL;
-}</pre> -</div></div> -<p>Note the use of @Configured to define the mapping between the configuration file and the field values.</p> - -<p>All we need to do the access this configuration object <em>anywhere within the application</em> is call:</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">ConnectionConfig cfg = ApplicationRegistry.getInstance().getConfiguredObject(ConnectionConfig.class);</pre> -</div></div> -<p>The ApplicationRegistry is documented elsewhere but from the configuration perspective all you need to know is that the first time getConfiguredObject is called for a particular class, the configuration file is parsed and the configuration object is stored for future use. Subsequent calls to getConfiguredObject for the same class are very cheap since only a hash table lookup is done.</p> - -<h3><a name="QpidDesign-Configuration-CommandLineOptions"></a>Command Line Options</h3> - -<p>The following options are available:</p> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'>Option</th> -<th class='confluenceTh'>Long Option</th> -<th class='confluenceTh'>Description</th> -</tr> -<tr> -<td class='confluenceTd'>b</td> -<td class='confluenceTd'>bind</td> -<td class='confluenceTd'>Bind to the specified address overriding any value in the config file</td> -</tr> -<tr> -<td class='confluenceTd'>c</td> -<td class='confluenceTd'>config</td> -<td class='confluenceTd'>Use the given configuration file</td> -</tr> -<tr> -<td class='confluenceTd'>h</td> -<td class='confluenceTd'>help</td> -<td class='confluenceTd'>Prints list of options</td> -</tr> -<tr> -<td class='confluenceTd'>l</td> -<td class='confluenceTd'>logconfig</td> -<td class='confluenceTd'>Use the specified log4j.xml file rather than that in the etc directory</td> -</tr> -<tr> -<td class='confluenceTd'>p</td> -<td class='confluenceTd'>port</td> -<td class='confluenceTd'>Specify port to listen on. Overrides value in config file</td> -</tr> -<tr> -<td class='confluenceTd'>v</td> -<td class='confluenceTd'>version</td> -<td class='confluenceTd'>Print version information and exit</td> -</tr> -<tr> -<td class='confluenceTd'>w</td> -<td class='confluenceTd'>logwatch</td> -<td class='confluenceTd'>Specify interval for checking for logging config changes. Zero means no checking</td> -</tr> -</tbody></table> - -<h3><a name="QpidDesign-Configuration-Logging"></a>Logging</h3> - -<p>Logging is handled slightly differently. The main reason for this is that logging is something we want configured before the main configuration file is processed.</p> - -<p>The broker uses log4j as the logging implementation, and configuration must be done using the more expressive XML format. A couple of command line switches are used to configure logging:</p> -<ul> - <li>-l, --logconfig specifies the log configuration file to use. By default it looks for a file called log4j.xml located in the same directory as the config.xml file</li> - <li>-w, --logwatch the interval in seconds to poll the log configuration file for changes. The default is 60 seconds and zero means do not poll for changes.</li> -</ul> - - -<p>By using the logwatch option it is possible to make changes to the logging configuration at runtime without restarting the broker. (For example, enabling more logging on certain packages in order to diagnose a problem).</p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid Design - Framing.html b/content/xdocs/Qpid Design - Framing.html deleted file mode 100644 index 41a3250f13..0000000000 --- a/content/xdocs/Qpid Design - Framing.html +++ /dev/null @@ -1,75 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Qpid Design - Framing</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Qpid Design - Framing - </span> - </div> - <div class="pagesubheading"> - This page last changed on Oct 19, 2006 by <font color="#0050B2">rgreig</font>. - </div> - - <h3><a name="QpidDesign-Framing-FrameClasses"></a>Frame Classes</h3> - -<p>The framing definition in the protocol specification maps quite nicely to an object-oriented representation. The class diagram is shown below:</p> - -<p><img src="Qpid Design - Framing_attachments/FramingClassDiagram.gif" align="absmiddle" border="0" /></p> - -<p>The <tt>AMQDataBlock</tt> at the root of the hierarchy defines a <tt>writePayload</tt> method that subclasses implement in order to be able to transform themselves into bytes. This is called by the encoder, documented below. The decoding (from bytes into objects) is slightly more complex since it involves factories for the instantiation of the correct objects (again documented below).</p> - -<p>An <tt>AMQFrame</tt> is the basic unit transmitted over the network, and contains a body which is the real payload. There are numerous method frames, which are subclasses of <tt>AMQMethodBody</tt>. The method body subclasses are all code generated using XSLT from the protocol specification. The ContentHeaderBody can support different types of content properties or metadata (examples being file or stream in addition to <em>basic</em> which is standard JMS-style messaging).</p> - -<p><tt>ContentBody</tt> is a lightweight wrapper for message data.</p> - -<h3><a name="QpidDesign-Framing-Encoding"></a>Encoding</h3> - -<p>Encoding is a straightforward process. The <tt>AMQDataBlock</tt> class has only two method: <tt>getSize()</tt> and <tt>writePayloadToBuffer(ByteBuffer)</tt>. The encoder simply needs to ask the data block its size, allocate a buffer of that size, then ask the data block to write itself into the buffer.</p> - -<h3><a name="QpidDesign-Framing-Decoding"></a>Decoding</h3> - -<p>The classes involved in decoding are illustrated in this UML class diagram:</p> - -<p><img src="Qpid Design - Framing_attachments/DecodingClasses.gif" align="absmiddle" border="0" /></p> - -<p>The <tt>AMQDataBlockDecoder</tt> has only two methods: <tt>decodable()</tt> in which it attempts to read enough information from the supplied buffer to determine whether it has all the data and whether it appears to represent a known data block. If it needs more data, it return false. If the frame appears to be invalid it throws an exception.</p> - -<p>The decoder stores the factories for the known frame types in a hash table, keyed on type. Assuming the <tt>decodable()</tt> method return true, the decoder constructs an <tt>AMQFrame</tt>, looks up the body factory based on the body type read from the buffer and calls <tt>populateFromBuffer</tt> on the frame, passing in the factory. The result of that call is either a fully populated frame or an exception being thrown if data is invalid or inconsistent.</p> - -<p>The <tt>MethodBodyDecoderRegistry</tt> is generated from the ASL version of the protocol specification. (ASL is simply an XML format for describing the protocol). Each method is registered by protocol class and protocol method and when looked up by the <tt>AMQMethodBodyFactory</tt> an instance of the appropriate method body is returned. The generated code for the methods handles the reading and writing of the bytes to and from ByteBuffers as well as calculation of the size of the populated method bodies.</p> - - <br/> - <div class="tabletitle"> - <a name="attachments">Attachments:</a> - </div> - - <div class="greybox" align="left"> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="Qpid Design - Framing_attachments/FramingClassDiagram.gif">FramingClassDiagram.gif</a> (image/gif) - <br/> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="Qpid Design - Framing_attachments/DecodingClasses.gif">DecodingClasses.gif</a> (image/gif) - <br/> - </div> - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid Design - Framing_attachments/DecodingClasses.gif b/content/xdocs/Qpid Design - Framing_attachments/DecodingClasses.gif Binary files differdeleted file mode 100755 index 733e9885ff..0000000000 --- a/content/xdocs/Qpid Design - Framing_attachments/DecodingClasses.gif +++ /dev/null diff --git a/content/xdocs/Qpid Design - Framing_attachments/FramingClassDiagram.gif b/content/xdocs/Qpid Design - Framing_attachments/FramingClassDiagram.gif Binary files differdeleted file mode 100755 index d22c8ffd09..0000000000 --- a/content/xdocs/Qpid Design - Framing_attachments/FramingClassDiagram.gif +++ /dev/null diff --git a/content/xdocs/Qpid Design - Management.html b/content/xdocs/Qpid Design - Management.html deleted file mode 100755 index 9e29793cd2..0000000000 --- a/content/xdocs/Qpid Design - Management.html +++ /dev/null @@ -1,45 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Qpid Design - Management</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Qpid Design - Management - </span> - </div> - <div class="pagesubheading"> - This page last changed on Oct 19, 2006 by <font color="#0050B2">rgreig</font>. - </div> - - <p>This page is a placeholder for more detailed information.</p> - -<h4><a name="QpidDesign-Management-JVMflags"></a>JVM flags</h4> - -<p>The following system properties need to be set to enable connection to the platform MBean server on the JVM running the broker:</p> -<div class="panel"><div class="panelContent"> -<p>-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=8999 -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false</p> -</div></div> - -<p>This obviously isn't secure but is a useful way just to get it up and running in development.</p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid Design - Message Acknowledgement.html b/content/xdocs/Qpid Design - Message Acknowledgement.html deleted file mode 100755 index 027cdf3452..0000000000 --- a/content/xdocs/Qpid Design - Message Acknowledgement.html +++ /dev/null @@ -1,118 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Qpid Design - Message Acknowledgement</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Qpid Design - Message Acknowledgement - </span> - </div> - <div class="pagesubheading"> - This page last changed on Dec 01, 2006 by <font color="#0050B2">mmccorma</font>. - </div> - - <p><b>This page is under review for accuracy</b></p> - -<h3><a name="QpidDesign-MessageAcknowledgement-MessageAcknowledgementsandDeliveryModes"></a>Message Acknowledgements and Delivery Modes</h3> - -<p>When implementing the JMS client it became apparent that the JMS specification offered a considerable degree of latitude for interpreting the precise semantics of acknowledgement modes and it also did not cover all acknowledgement modes that are of interest.</p> - -<p>Here we describe the precise semantics of the JMS acknowledgement modes and the additional modes that the JMS client provides.</p> - -<p>In this discussion, "the client" refers to the JMS client implementation and "the user" refers to code that is part of the client application (i.e. code written by the end-user developer).</p> - -<h4><a name="QpidDesign-MessageAcknowledgement-AUTOACKNOWLEDGE%28JMS%29"></a>AUTO_ACKNOWLEDGE (JMS)</h4> - -<p>In this mode, the client acknowledges each message once it has been received by the user. In the case of an asynchronous message consumer, this means that an acknowledgement is sent once the onMessage method of a message listener has completed without throwing an exception of any sort. For a synchronous consumer, it means when the receive() method has returned the message to the user.</p> - -<p>In this mode, each HANDLE NOTIFY sent from the server to the client will result in one CHANNEL ACK being sent from the client to the server.</p> - -<h4><a name="QpidDesign-MessageAcknowledgement-CLIENTACKNOWLEDGE%28JMS%29"></a>CLIENT_ACKNOWLEDGE (JMS)</h4> - -<p>In this mode, the user acknowledges messages manually by calling the acknowledge() method. The user does not have to acknowledge each message therefore the user can decide on a batching strategy in order to reduce network traffic.</p> - -<p>The JMS does not say how many message a client is allowed to receive before acknowledging. However, it does talk in vague terms about implementations making sure clients don't go too long without acknowledging to avoid resource exhaustion.</p> - -<p>Qpid introduces a "prefetch" which specifies, for a particular destination, how many messages the client can read without sending an acknowldgement. The method Session.setDefaultPrefetch(int) allows a default value to be configured at the session level and an overloaded createConsumer() method exists allowing it to be specified at the point of consumer construction.</p> - -<p>Calling Message.acknowledge() sends a CHANNEL ACK to be sent from the client to the server. This acknowledges the receipt of all messages up to and including this one.</p> - -<h4><a name="QpidDesign-MessageAcknowledgement-DUPSOKACKNOWLEDGE%28JMS%29"></a>DUPS_OK_ACKNOWLEDGE (JMS)</h4> - -<p>In this mode, the client acknowledges message receipt as in the case of AUTO_ACKNOWLEDGE but is not obliged to acknowledge each message immediately upon successful completion of the onMessage() or receive() methods.</p> - -<p>This means that the client can have an "acknowledgement strategy" that can provide higher performance at the expense of potential redelivery of messages in the event of a failure.</p> - -<p>Qpid provides a default configurable strategy parameterised on number of messages received and elapsed time since last acknowledgement. The user can configure the client to send acknowledgements every n messages (where n <= the prefetch value for the consumer) or every k milliseconds whichever is reached sooner. Values of zero for either n or k means that component of the trigger is disabled. Setting n = 0 and k = 0 results in behaviour identical to CLIENT_ACKNOWLEDGE. Setting n = 1 and k = 0 results in behaviour identical to AUTO_ACKNOWLEDGE.</p> - -<h4><a name="QpidDesign-MessageAcknowledgement-PREACKNOWLEDGE%28nonJMS%29"></a>PRE_ACKNOWLEDGE (non-JMS)</h4> - -<p>A mode not covered by the JMS specification is one where the client acknowledges a message before calling the onMessage() or receive() methods. This method results in the server receiving one CHANNEL ACK per HANDLE NOTIFY as in AUTO_ACKNOWLEDGE but the difference is that the ack will/can(? - this choice could cause a 'DUP' effect) be sent even if user code can throws an error.</p> - -<p>This is useful where the user does not want to trigger redelivery of a message if user code fails or where synchronous operation is used and it is expected that there is some delay before receive() is called (which would in turn cause the server to have to wait some time before receiving the ack).</p> - -<p>The constant Session.PRE_ACKNOWLEDGE defines this mode.</p> - -<h4><a name="QpidDesign-MessageAcknowledgement-NOACKNOWLEDGE%28nonJMS%29"></a>NO_ACKNOWLEDGE (non-JMS)</h4> - -<p>Certain data may be time sensitive in the sense that redelivery is pointless - if the client cannot process it at the instant it is sent there is no point in redelivering it.</p> - -<p>In this case, acks are redundant. Since TCP means that the server can be sure the client received the message the only problem could be client error.</p> - -<p>Setting NO_ACKNOWLEDGE means that the client never needs to send CHANNEL_ACK messages. The constant Session.NO_ACKNOWLEDGE defines this mode.</p> - -<h3><a name="QpidDesign-MessageAcknowledgement-DeliveryModes"></a>Delivery Modes</h3> - -<p>For message production, similar considerations apply. JMS defines two delivery modes, PERSISTENT and NON_PERSISTENT which allow the implmentor considerable freedom of implementation.</p> - -<p>Unfortunately the JMS specification addresses what are really two separate reliability concerns with a single delivery mode. OpenAMQ adds an additional mode to give the user the ability to have finer control over the tradeoff between performance and reliability.</p> - -<p>The default delivery mode can be set on a producer. This can be overridden on each message sent.</p> - -<h4><a name="QpidDesign-MessageAcknowledgement-PERSISTENT%28JMS%29"></a>PERSISTENT (JMS)</h4> - -<p>Persistent is the straightforward option. Messages are sent with the persistent flag set to true which means that they will be committed to stable storage. HANDLE SEND frames are sent with the confirm tag set to true. When the client receives the HANDLE REPLY frame it knows that the message has been committed to stable storage on the broker.</p> - -<p><b>We need to clarify with Pieter what confirm tags really mean. Do they mean pure physical receipt of the message or receipt & completion of all necessary processing? The semantics of 'processing' will vary from message-type to message-type. For example would 'HANDLE SEND' mean delivery to all end points (clients)... unlikely... or delivery to all the data-structures - queues, topics etc, or just delivery to the mux?</b></p> - -<p><b>In this particular case 'processing' would probably mean writing to some persistent storage. Whatever the 'rule', it should be unambiguous, understood by all developers and enforced. Perhaps a 'processed' flag could be associated with the tag to indicate that it should only be generated when processing has also completed? Alternatively this could be a field that can optionally piggy-back in the confirm tag indicating that the confirm tag is also acknowledgement of completion of all necessary processing. If it does not contain that flag, then a separate acknowledgement message may be generated some time later. This gives the broker some implementation freedom.</b></p> - -<p>The MessageProducer.send() method blocks until the HANDLE REPLY has been received therefore the user can know that a message has been reliably sent to the broker.</p> - -<h4><a name="QpidDesign-MessageAcknowledgement-NONPERSISTENT%28JMS%29"></a>NON_PERSISTENT (JMS)</h4> - -<p>Non persistent gives maximum performance with least guarantees. The persistent flag is set to false in each message which means that if the broker dies all messages that have no been delivered at that point are lost irretrievably.</p> - -<p>Also no acks are requested in the HANDLE SEND. Acks are pointless in this case since after sending the ack the server could die and the message would be lost.</p> - -<h4><a name="QpidDesign-MessageAcknowledgement-PERSISTENTGROUPACK%28nonJMS%29"></a>PERSISTENT_GROUPACK (non-JMS)</h4> - -<p>An ack means that the client knows that the last message it sent was received successfully. However, acks have a considerable performance overhead. A client may want to be able to send message quickly but also have the guarantee that if the broker dies the messages will not be lost.</p> - -<p>PERSISTENT_GROUPACK means that messages are written to stable storage, which incurs an overhead, but the client only requests an ack every n messages. The Session.setGroupAckThreshold() method allows the client to specify the ack frequency.</p> - -<p>Note that this is different to a transacted commit since in this mode, messages can be delivered to client before the group-ack. Transacted messages are not available to clients until the commit.</p> - -<p>TODO: define some API to allow the client to determine the set of mesages not acked in the event of failure.</p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid Design - Threading.html b/content/xdocs/Qpid Design - Threading.html deleted file mode 100755 index c52adc2e46..0000000000 --- a/content/xdocs/Qpid Design - Threading.html +++ /dev/null @@ -1,74 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Qpid Design - Threading</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Qpid Design - Threading - </span> - </div> - <div class="pagesubheading"> - This page last changed on Oct 19, 2006 by <font color="#0050B2">rgreig</font>. - </div> - - <p>The following diagram shows the threading model used in QPID:</p> - -<p><img src="Qpid Design - Threading_attachments/QpidThreadingModel.gif" align="absmiddle" border="0" /></p> - -<h3><a name="QpidDesign-Threading-Sessions"></a>Sessions</h3> - -<p>A session is the encapsulation of a client connection. A session has independent state associated with it.</p> - -<h3><a name="QpidDesign-Threading-EventQueues"></a>Event Queues</h3> - -<p>The thread pool cannot simply be a generic pool that takes arbitrary work to process. Doing so would mean that no guarantees could be made for message ordering.</p> - -<p>Each session has a single read event queue and it is populated by the single socket IO processor associated with the session. (Several sessions can be bound to a single IO processor; the standard select/poll mechanism is used to check for activity). Only one worker (event processing) thread can be processing the event queue for a given session but the particular thread can change over time. If more events come in while the queue is being processed, they are added to the queue being processed, and the worker thread only processes up to <em>n</em> events for fairness.</p> - -<p>Similarly, for write events there is a separate queue that behaves analogously to the read queue.</p> - -<p>One of the main benefits of this approach is that it allows enough parallelism while avoiding excessive context switching. The socket I/O processor reads as much data as it can - it does very little apart from polls and reads (side note: this makes it very straightforward to move to AIO if support is available). Message decoding (i.e. going from raw bytes to objects) and routing occurs in a worker thread but the entire dispatch process - including encoding but excluding the socket I/O - occurs on a separate worker thread. This means that on a suitable SMP box the following activities can all take place in parallel:</p> -<ul> - <li>network reading and writing for a given session</li> - <li>data decoding and routing</li> - <li>response encoding</li> -</ul> - - -<p>A further improvement would be to allow reading and writing in parallel by splitting that into separate IO processor threads, and this is being investigated (along with AIO).</p> - -<h3><a name="QpidDesign-Threading-MessageDelivery"></a>Message Delivery</h3> - -<p>Messages delivered to an AMQQueue are delivered directly if possible (i.e. a write request is written to the consumers session by the thread processing the publish request). This reduces context switch or the overhead of adding and removing messages to a queue. However if there are no consumers then the message needs to be queued. In this case delivery will be done by a 'message pump' thread and direct delivery has to be stopped until the backlog of messages is processed in order to ensure that the ordering is not violated.</p> - - <br/> - <div class="tabletitle"> - <a name="attachments">Attachments:</a> - </div> - - <div class="greybox" align="left"> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="Qpid Design - Threading_attachments/QpidThreadingModel.gif">QpidThreadingModel.gif</a> (image/gif) - <br/> - </div> - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid Design - Threading_attachments/QpidThreadingModel.gif b/content/xdocs/Qpid Design - Threading_attachments/QpidThreadingModel.gif Binary files differdeleted file mode 100755 index 6894647a2a..0000000000 --- a/content/xdocs/Qpid Design - Threading_attachments/QpidThreadingModel.gif +++ /dev/null diff --git a/content/xdocs/Qpid Developer Documentation.html b/content/xdocs/Qpid Developer Documentation.html deleted file mode 100755 index 3e7d98baa4..0000000000 --- a/content/xdocs/Qpid Developer Documentation.html +++ /dev/null @@ -1,38 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Qpid Developer Documentation</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Qpid Developer Documentation - </span> - </div> - <div class="pagesubheading"> - This page last changed on Oct 19, 2006 by <font color="#0050B2">rgreig</font>. - </div> - - <p>The child pages contain design notes on the broker and client.</p> - -<ul><li><a href="Java Architecture Overview.html" title="Java Architecture Overview">Java Architecture Overview</a></li><li><a href="Java Broker Design - MessageStore.html" title="Java Broker Design - MessageStore">Java Broker Design - MessageStore</a></li><li><a href="Message API Design.html" title="Message API Design">Message API Design</a></li><li><a href="Qpid Design - Access Control Lists.html" title="Qpid Design - Access Control Lists">Qpid Design - Access Control Lists</a></li><li><a href="Qpid Design - Application Registry.html" title="Qpid Design - Application Registry">Qpid Design - Application Registry</a></li><li><a href="Qpid Design - Authentication.html" title="Qpid Design - Authentication">Qpid Design - Authentication</a></li><li><a href="Qpid Design - Configuration.html" title="Qpid Design - Configuration">Qpid Design - Configuration</a></li><li><a href="Qpid Design - Framing.html" title="Qpid Design - Framing">Qpid Design - Framing</a></li><li><a href="Qpid Design - Management.html" title="Qpid Design - Management">Qpid Design - Management</a></li><li><a href="Qpid Design - Message Acknowledgement.html" title="Qpid Design - Message Acknowledgement">Qpid Design - Message Acknowledgement</a></li><li><a href="Qpid Design - Threading.html" title="Qpid Design - Threading">Qpid Design - Threading</a></li><li><a href="Restructuring Java Broker and Client Design.html" title="Restructuring Java Broker and Client Design">Restructuring Java Broker and Client Design</a></li><li><a href="The AMQP Distributed Transaction Classes.html" title="The AMQP Distributed Transaction Classes">The AMQP Distributed Transaction Classes</a></li></ul> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid IBM JMS Performance Test Results.html b/content/xdocs/Qpid IBM JMS Performance Test Results.html deleted file mode 100755 index 22e9a1abc4..0000000000 --- a/content/xdocs/Qpid IBM JMS Performance Test Results.html +++ /dev/null @@ -1,129 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Qpid IBM JMS Performance Test Results</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Qpid IBM JMS Performance Test Results - </span> - </div> - <div class="pagesubheading"> - This page last changed on Oct 13, 2006 by <font color="#0050B2">mmccorma</font>. - </div> - - <h1><a name="QpidIBMJMSPerformanceTestResults-QpidIBMJMSPerformanceTestResults"></a>Qpid IBM JMS Performance Test Results</h1> - -<p>This page is a summary of the results shown from the <a href="http://www.alphaworks.ibm.com/tech/perfharness" title="Visit page outside Confluence">IBM JMS performance harness</a>.</p> - -<p>This page is limited to qpid-commiters.</p> - -<p>There are few things that you should bare in mind when looking at these values.</p> - -<ol> - <li>The messages are 100bytes.</li> - <li>The Java Broker was used for the tests.</li> - <li>The Broker is run on an 8-way opteron (32G Total RAM) during the tests there were other process in action. -<div class="preformatted"><div class="preformattedContent"> -<pre>qpid-server -c <config file to specify type of store></pre> -</div></div></li> - <li>The Client is run on a 4 way opteron (16G Total RAM) -<div class="preformatted"><div class="preformattedContent"> -<pre>qpid-run JMSPerfHarness -pc JNDI -ii com.sun.jndi.fscontext.RefFSContextFactory -iu file:///tmp/IBMPerfTestsJNDI/ -cf amq.ConnectionFactory.5670 -d amq.Queue -tc jms.r11.PutGet -nt 6 -rl 60</pre> -</div></div></li> - <li>The two boxes are linked via private Gigabit ethernet.</li> -</ol> - - - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'>Revision</th> -<th class='confluenceTh'>Test</th> -<th class='confluenceTh'>Options</th> -<th class='confluenceTh'>Average Throughput(msgs/sec)</th> -</tr> -<tr> -<td class='confluenceTd'>v452339</td> -<td class='confluenceTd'>IBM-PutGet.sh</td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'>5289.80</td> -</tr> -<tr> -<td class='confluenceTd'>v452533</td> -<td class='confluenceTd'>IBM-PutGet.sh</td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'>5414.87</td> -</tr> -<tr> -<td class='confluenceTd'>v462764</td> -<td class='confluenceTd'>IBM-PutGet.sh</td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'>14911.41</td> -</tr> -<tr> -<td class='confluenceTd'>v452339</td> -<td class='confluenceTd'>IBM-PutGet.sh</td> -<td class='confluenceTd'>-tx</td> -<td class='confluenceTd'>2708.56</td> -</tr> -<tr> -<td class='confluenceTd'>v452533</td> -<td class='confluenceTd'>IBM-PutGet.sh</td> -<td class='confluenceTd'>-tx</td> -<td class='confluenceTd'>3016.97</td> -</tr> -<tr> -<td class='confluenceTd'>v462764</td> -<td class='confluenceTd'>IBM-PutGet.sh</td> -<td class='confluenceTd'>-tx</td> -<td class='confluenceTd'>3084.16</td> -</tr> -</tbody></table> - -<p><b>Otions</b>: -tx = Transactional</p> - -<p><b>Note</b>: There are no values for persistent messages as the MemoryMessageStore is not persistent.</p> - - -<h2><a name="QpidIBMJMSPerformanceTestResults-Whatdothetestsdo."></a>What do the tests do.</h2> - -<p>It is worth explaining what each of the tests do so the reader can put the results in context.</p> - -<p>The results shown above are the</p> - -<h3><a name="QpidIBMJMSPerformanceTestResults-IBMPutGet.sh"></a>IBM-PutGet.sh</h3> - -<p>The following pseudo code describes the main work of this test. There are additional timing threads and statistic threads that calculate the message throughout.</p> - -<div class="code"><div class="codeHeader"><b>PutGet pseudo code</b></div><div class="codeContent"> -<pre class="code-java">send Message
-<span class="code-keyword">if</span>(using_transactions)
- commit()
-receive Message
-<span class="code-keyword">if</span>(using_transactions)
- commit()</pre> -</div></div> - - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid Java Build How To.html b/content/xdocs/Qpid Java Build How To.html deleted file mode 100755 index d56c62af30..0000000000 --- a/content/xdocs/Qpid Java Build How To.html +++ /dev/null @@ -1,318 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Qpid Java Build How To</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Qpid Java Build How To - </span> - </div> - <div class="pagesubheading"> - This page last changed on Oct 25, 2007 by <font color="#0050B2">rgreig</font>. - </div> - - <h1><a name="QpidJavaBuildHowTo-BuildInstructionsGeneral"></a>Build Instructions - General</h1> - -<h2><a name="QpidJavaBuildHowTo-Checkoutthesource"></a>Check out the source</h2> - -<p>Firstly, check the source for Qpid java out of our subversion repository:</p> - -<p><a href="https://svn.apache.org/repos/asf/incubator/qpid/trunk/qpid/java" title="Visit page outside Confluence">https://svn.apache.org/repos/asf/incubator/qpid/trunk/qpid/java</a></p> - -<p>You will also need to checkout the gentools directory at the same level:</p> - -<p><a href="https://svn.apache.org/repos/asf/incubator/qpid/trunk/qpid/gentools" title="Visit page outside Confluence">https://svn.apache.org/repos/asf/incubator/qpid/trunk/qpid/gentools</a></p> - -<p>and python:</p> - -<p><a href="https://svn.apache.org/repos/asf/incubator/qpid/trunk/qpid/python" title="Visit page outside Confluence">https://svn.apache.org/repos/asf/incubator/qpid/trunk/qpid/python</a></p> - -<p>and finally the protocol specification:</p> - -<p><a href="https://svn.apache.org/repos/asf/incubator/qpid/trunk/qpid/specs" title="Visit page outside Confluence">https://svn.apache.org/repos/asf/incubator/qpid/trunk/qpid/specs</a></p> - -<h2><a name="QpidJavaBuildHowTo-Prerequisites"></a>Prerequisites</h2> - -<p>For the broker code you need JDK 1.5 or later. You should set JAVA_HOME and include the bin directory in your PATH.</p> - -<p>Check it's ok by executing java -v !</p> - -<p>If you are wanting to run the python tests against the broker you will of course need a version of python.</p> - - -<h1><a name="QpidJavaBuildHowTo-BuildInstructionsTrunk%28M2%29"></a>Build Instructions - Trunk (M2+)</h1> - -<h2><a name="QpidJavaBuildHowTo-MavenBuildSystem"></a>Maven Build System</h2> - -<h3><a name="QpidJavaBuildHowTo-UsefulMavenlinks"></a>Useful Maven links </h3> -
-
-<head>
-<style type="text/css">
-.delicious-posts
-</style>
-</head>
-
-<script type="text/javascript" src="http://del.icio.us/feeds/js/rupertlssmith/maven?tags;extended;count=200;sort=alpha;title=Maven%20Links;bullet=%C2%BB;icon"></script>
-<noscript><a href="http://del.icio.us/rupertlssmith/maven">Maven Links</a></noscript>
-
- - -<h3><a name="QpidJavaBuildHowTo-InstallMaven2"></a>Install Maven 2</h3> -<p>Firstly, you need to install Maven 2 from <a href="http://maven.apache.org/download.html" title="Visit page outside Confluence">here</a>).</p> - -<p>You can find out how to set Maven up by following their <a href="http://maven.apache.org/guides/getting-started/maven-in-five-minutes.html" title="Visit page outside Confluence">quick guide</a>.</p> - -<p>Some of the relevant Maven targets (in Maven speak 'lifecycle phases') are as follows:</p> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'>Phase</th> -<th class='confluenceTh'>Description</th> -</tr> -<tr> -<td class='confluenceTd'>compile</td> -<td class='confluenceTd'>compile the source code of the project</td> -</tr> -<tr> -<td class='confluenceTd'>test</td> -<td class='confluenceTd'>test the compiled source code using a suitable unit testing framework</td> -</tr> -<tr> -<td class='confluenceTd'>install</td> -<td class='confluenceTd'>compiles & installs the package into the local repository & generates JAR files</td> -</tr> -<tr> -<td class='confluenceTd'>clean</td> -<td class='confluenceTd'>cleans up artifacts created by prior builds</td> -</tr> -</tbody></table> - -<p>You can run the install phase but skip the tests by running:</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre>mvn -Pfastinstall
-</pre> -</div></div> - -<p>to specify the fastinstall profile.</p> - -<p>You can just skip the python broker tests by adding this -D option. This is done when using the fastinstall profile above.</p> -<div class="preformatted"><div class="preformattedContent"> -<pre>-Dskip.python.tests
-</pre> -</div></div> - - -<p><b>NOTE</b> When running under cygwin on windows the version of python that runs can give the following error "c:\windows\system32\ntvdm.exe Error while setting up environment for the application. Chose 'close' to terminate the application."<br/> -This is due to the windows python being picked up rather than the cygwin version. When run from a cmd.exe window everything should work. If you wish to run it from a cygwin window the following option should be added to your mvn command line.</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre>-Dcommand="bash -c 'python run-tests -v -I java_failing.txt'"
-</pre> -</div></div> - -<p>You can now also run the install phase with retrotranslator (for building the Java client in JDK 1.4) running:</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre>mvn -Pretrotranslator
-</pre> -</div></div> - -<h3><a name="QpidJavaBuildHowTo-BuildQpidJava"></a>Build Qpid Java</h3> - -<p>To compile & install Qpid, cd into the java directory of your checkout and then:</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre>mvn clean
-mvn install
-</pre> -</div></div> - -<p>If you wish to build an archive of Qpid for installing somewhere then:</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre>cd distribution
-mvn
-</pre> -</div></div> - -<p><b>NB:</b> executing Maven in the distribution directory does NOT force a clean build or a re-JAR, but uses the jars from your repository. You must be sure to execute a clean install in the java directory first (up one level from the distribution directory) to get a clean distribution. Best to check that the jars in your repository are current before building a dist!</p> - -<h3><a name="QpidJavaBuildHowTo-Build%2FDebugCycle"></a>Build/Debug Cycle</h3> - -<p>If you're changing code as part of a debugging effort and want to quickly rebuild and then run the broker for manual testing, you can use the following commands, starting in the top-level <tt>java</tt> directory:</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre>mvn -Pfastinstall
-cd distribution
-mvn assembly:directory
-</pre> -</div></div> - -<p>The first command above builds everything but skips the tests. The last command above builds the normal distribution but also creates a directory holding the contents of the Java bin assembly. You can run the broker directly from that directory by setting <tt>QPID_HOME</tt> to point to it. For example, for the Qpid incubating 1.0 M2 snapshot version, the assembly directory resulting from running the final command above is:</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre>target/qpid-1.0-incubating-M2-SNAPSHOT-java-bin
-</pre> -</div></div> - -<p>If you set the <tt>QPID_HOME</tt> environment variable to the directory contained within the directory named above, i.e.:</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre>target/qpid-1.0-incubating-M2-SNAPSHOT-java-bin/qpid-1.0-incubating-M2-SNAPSHOT
-</pre> -</div></div> - -<p>and add <tt>$QPID_HOME/bin</tt> (UNIX) or <tt>%QPID_HOME%\bin</tt> (Windows) to your <tt>PATH</tt>, you can then run the broker by executing the <tt>qpid-server</tt> script.</p> - -<p>You can also control where the assembly directory is built via the <tt>qpid.targetDir</tt> property, like this:</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre>mvn -Dqpid.targetDir=/tmp/xyz assembly:directory
-</pre> -</div></div> - -<p>This will create the assembly directory and the various tar and zip files in directory <tt>/tmp/xyz</tt>.</p> - -<p>In summary, with <tt>QPID_HOME</tt> set as described above, the edit/build/debug cycle becomes a matter of first rebuilding the appropriate artifacts, either from the top level or within the specific subdirectory for a single modified artifact, changing to the <tt>distribution</tt> directory, and creating the assembly directory as described above. You can then run the broker via <tt>qpid-server</tt> and perform your debugging, testing, etc.</p> - -<h3><a name="QpidJavaBuildHowTo-BuildingProjectFiles"></a>Building Project Files</h3> - -<p>You can build project files for IntelliJ IDEA and Eclipse IDEs by executing the appropriate command in the java directory:</p> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'>Command</th> -<th class='confluenceTh'>Result</th> -</tr> -<tr> -<td class='confluenceTd'>mvn idea:idea</td> -<td class='confluenceTd'>Builds .ipr and .iml files with appropriate project settings for classpath etc</td> -</tr> -<tr> -<td class='confluenceTd'>mvn eclipse:eclipse</td> -<td class='confluenceTd'>Builds Eclipse project files with settings</td> -</tr> -</tbody></table> - -<p>To get started with Eclipse, use the <tt>setup.eclipse</tt> profile:</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre>mvn -Psetup.eclipse
-</pre> -</div></div> - -<p>The <tt>setup.eclipse</tt> profile will by default create an Eclipse workspace in the <tt>../workspace</tt> directory. You then go into Eclipse, switch to the new workspace, and then import the Qpid projects by selecting File -> Import -> Existing projects into workspace.</p> - -<p>If you want to set up a workspace other than <tt>../workspace</tt>, you can specify it on the command line via the <tt>eclipse.workspace.dir</tt> property:</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre>mvn -Declipse.workspace.dir=/path/to/workspace -Psetup.eclipse
-</pre> -</div></div> - -<h1><a name="QpidJavaBuildHowTo-BuildInstructionsM1branch"></a>Build Instructions - M1 branch</h1> - -<h2><a name="QpidJavaBuildHowTo-AntBuildScripts"></a>Ant Build Scripts</h2> - -<p>Currently the Qpid java project builds using ant.</p> - -<p>The ant build system is set up in a modular way, with a top level build script and template for module builds and then a module level build script which inherits from the template.</p> - -<p>So, at the top level there are:</p> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'>File</th> -<th class='confluenceTh'>Description</th> -</tr> -<tr> -<td class='confluenceTd'>build.xml</td> -<td class='confluenceTd'>Top level build file for the project which defines all the build targets</td> -</tr> -<tr> -<td class='confluenceTd'>common.xml</td> -<td class='confluenceTd'>Common properties used throughout the build system</td> -</tr> -<tr> -<td class='confluenceTd'>module.xml</td> -<td class='confluenceTd'>Template used by all modules which sets up properties for module builds</td> -</tr> -</tbody></table> - -<p>Then, in each module subdirectory there is:</p> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'>File</th> -<th class='confluenceTh'>Description</th> -</tr> -<tr> -<td class='confluenceTd'>build-module.xml</td> -<td class='confluenceTd'>Defines all the module values for template properties</td> -</tr> -</tbody></table> - -<h2><a name="QpidJavaBuildHowTo-Buildtargets"></a>Build targets</h2> - -<p>The main build targets you are probably interested in are:</p> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'>Target</th> -<th class='confluenceTh'>Description</th> -</tr> -<tr> -<td class='confluenceTd'>build</td> -<td class='confluenceTd'>Builds all source code for Qpid java</td> -</tr> -<tr> -<td class='confluenceTd'>archive</td> -<td class='confluenceTd'>Generates all distribution archives for Qpid java</td> -</tr> -</tbody></table> - -<p>So, if you just want to compile everything you should run the build target in the top level build.xml file.</p> - -<p>If you want to build an installable version of Qpid java, run the archive task from the top level build.xml file.</p> - -<p>If you want to compile an individual module, simply run the build target from the appropriate build-module.xml e.g. to compile the broker source, simply run the build target in the java/broker/build-module.xml file.</p> - -<h2><a name="QpidJavaBuildHowTo-Whatnext%3F"></a>What next ?</h2> - -<p>If you want to run your built Qpid package, see our <a href="Getting Started Guide.html" title="Getting Started Guide">Getting Started Guide</a> for details of how to do that.</p> - -<p>If you want to run our tests, you can use the ant test or testreport (produces a useful report) targets.</p> - - <br/> - <div class="tabletitle"> - <a name="attachments">Attachments:</a> - </div> - - <div class="greybox" align="left"> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="Qpid Java Build How To_attachments/mavenlinks.html">mavenlinks.html</a> (text/html) - <br/> - </div> - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid Java Build How To_attachments/mavenlinks.html b/content/xdocs/Qpid Java Build How To_attachments/mavenlinks.html deleted file mode 100755 index d0b92fafec..0000000000 --- a/content/xdocs/Qpid Java Build How To_attachments/mavenlinks.html +++ /dev/null @@ -1,11 +0,0 @@ -<html>
-<head>
-<style type="text/css">
-.delicious-posts
-</style>
-</head>
-<body>
-<script type="text/javascript" src="http://del.icio.us/feeds/js/rupertlssmith/maven?tags;extended;count=200;sort=alpha;title=Maven%20Links;bullet=%C2%BB;icon"></script>
-<noscript><a href="http://del.icio.us/rupertlssmith/maven">Maven Links</a></noscript>
-</body>
-</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid Java Client refactoring.html b/content/xdocs/Qpid Java Client refactoring.html deleted file mode 100755 index 1e23dbfa4a..0000000000 --- a/content/xdocs/Qpid Java Client refactoring.html +++ /dev/null @@ -1,59 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Qpid Java Client refactoring</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Qpid Java Client refactoring - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 02, 2007 by <font color="#0050B2">ritchiem</font>. - </div> - - <p>Summary<br/> ----------<br/> -The goals of the re-factoring are as follows.</p> - -<p>1. Provide an AMQP protocol level API.<br/> -2. Achieve a clear separation of concerns.<br/> -3. Implement proper state and event handling.<br/> -4. Provide extensibility to extend the API at any level.<br/> -5. Provide a unified interface for configuration through jvm<br/> -arguments,xml ..etc. (Used commons configuration)</p> - -<p>The Prototype is available here <a href="https://svn.apache.org/repos/asf/incubator/qpid/branches/client_restructure/java/newclient/" title="Visit page outside Confluence">https://svn.apache.org/repos/asf/incubator/qpid/branches/client_restructure/java/newclient/</a></p> - -<p>The following document describes the design. <a href="http://cwiki.apache.org/confluence/download/attachments/50583/java_amqp_client_design.pdf?version=1" title="java_amqp_client_design.pdf attached to Qpid Java Client refactoring">java_amqp_client_design.pdf</a></p> - - <br/> - <div class="tabletitle"> - <a name="attachments">Attachments:</a> - </div> - - <div class="greybox" align="left"> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="Qpid Java Client refactoring_attachments/java_amqp_client_design.pdf">java_amqp_client_design.pdf</a> (application/pdf) - <br/> - </div> - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid Java Client refactoring_attachments/java_amqp_client_design.pdf b/content/xdocs/Qpid Java Client refactoring_attachments/java_amqp_client_design.pdf Binary files differdeleted file mode 100755 index bbe7e4b276..0000000000 --- a/content/xdocs/Qpid Java Client refactoring_attachments/java_amqp_client_design.pdf +++ /dev/null diff --git a/content/xdocs/Qpid Java Documentation.html b/content/xdocs/Qpid Java Documentation.html deleted file mode 100755 index 9fc55b8fd8..0000000000 --- a/content/xdocs/Qpid Java Documentation.html +++ /dev/null @@ -1,108 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Qpid Java Documentation</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Qpid Java Documentation - </span> - </div> - <div class="pagesubheading"> - This page last changed on Oct 25, 2007 by <font color="#0050B2">cctrieloff</font>. - </div> - - <h1><a name="QpidJavaDocumentation-Purpose"></a>Purpose</h1> - -<p>This is the index of all Qpid Java Documentation.</p> - -<h2><a name="QpidJavaDocumentation-Introduction"></a>Introduction</h2> - -<p>The Qpid pure Java broker currently supports the following features:</p> - -<ul> - <li>All features required by the Sun JMS 1.1 specification</li> - <li>Transaction support</li> - <li>Persistence using a pluggable layer</li> - <li>Pluggable security using SASL. Any Java SASL provider should be capable of working with Qpid.</li> - <li>Management using JMX and an Eclipse RCP application</li> - <li>Clustering for scalability</li> - <li>High performance header-based routing for messages</li> -</ul> - - -<h2><a name="QpidJavaDocumentation-UsefulLinks"></a>Useful Links</h2> - -<h3><a name="QpidJavaDocumentation-GeneralUserGuides"></a>General User Guides</h3> - -<ul> - <li><a href="Qpid Java FAQ.html" title="Qpid Java FAQ">FAQ</a></li> - <li><a href="Getting Started Guide.html" title="Getting Started Guide">Getting Started Guide</a></li> - <li><a href="Qpid Troubleshooting Guide.html" title="Qpid Troubleshooting Guide">Troubleshooting Guide</a></li> - <li><a href="URL Formats.html" title="URL Formats">URL Formats for Qpid</a></li> - <li><a href="Example Classes.html" title="Example Classes">Example Classes</a></li> - <li>How Tos -<ul><li><a href="Configure ACLs.html" title="Configure ACLs">Configure ACLs</a></li><li><a href="Configure Java Qpid to use a SSL connection..html" title="Configure Java Qpid to use a SSL connection.">Configure Java Qpid to use a SSL connection.</a></li><li><a href="Configure the Broker via config.xml.html" title="Configure the Broker via config.xml">Configure the Broker via config.xml</a></li><li><a href="Configure the Virtual Hosts via virtualhosts.xml.html" title="Configure the Virtual Hosts via virtualhosts.xml">Configure the Virtual Hosts via virtualhosts.xml</a></li><li><a href="How to Use JNDI.html" title="How to Use JNDI">How to Use JNDI</a></li><li><a href="Qpid Java Build How To.html" title="Qpid Java Build How To">Qpid Java Build How To</a></li></ul></li> -</ul> - - -<h3><a name="QpidJavaDocumentation-ManagementTools"></a>Management Tools</h3> -<ul><li><a href="JMX Management Console.html" title="JMX Management Console">JMX Management Console</a></li><li><a href="MessageStore Tool.html" title="MessageStore Tool">MessageStore Tool</a></li></ul> -<ul> - <li><a href="Management Design notes.html" title="Management Design notes">Management Design notes</a></li> -</ul> - - -<h3><a name="QpidJavaDocumentation-DeveloperInformation"></a>Developer Information</h3> - -<ul> - <li><a href="Qpid Java Build How To.html" title="Qpid Java Build How To">Build How To</a></li> - <li><a href="Qpid Java Run Scripts.html" title="Qpid Java Run Scripts">Qpid Java Run Scripts</a></li> - <li><a href="Qpid Developer Documentation.html" title="Qpid Developer Documentation">Qpid Developer Documentation</a></li> - <li><a href="Java Coding Standards.html" title="Java Coding Standards">Coding Standards</a></li> - <li><a href="Multiple AMQP Version Support.html" title="Multiple AMQP Version Support">AMQP Version Handling</a></li> - <li><a href="URL Formats.html" title="URL Formats">URL format for Connections and Binding</a></li> - <li><a href="Java Unit Tests with InVM Broker.html" title="Java Unit Tests with InVM Broker">Creating Java unit tests with InVM broker</a></li> -</ul> - - -<h3><a name="QpidJavaDocumentation-Testing"></a>Testing</h3> - -<h4><a name="QpidJavaDocumentation-InteroperabilityTesting"></a>Interoperability Testing</h4> - -<h4><a name="QpidJavaDocumentation-PerformanceTesting"></a>Performance Testing</h4> - -<ul> - <li><a href="Sustained Tests.html" title="Sustained Tests">Sustained Tests</a></li> - <li><a href="Qpid IBM JMS Performance Test Results.html" title="Qpid IBM JMS Performance Test Results">IBM JMS Performance Test Results</a></li> -</ul> - - -<h3><a name="QpidJavaDocumentation-ReleasePlans"></a>Release Plans</h3> - -<ul> - <li><a href="Release Plans.html" title="Release Plans">Release Plans</a></li> -</ul> - - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid Java FAQ.html b/content/xdocs/Qpid Java FAQ.html deleted file mode 100755 index 36cc135152..0000000000 --- a/content/xdocs/Qpid Java FAQ.html +++ /dev/null @@ -1,330 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Qpid Java FAQ</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Qpid Java FAQ - </span> - </div> - <div class="pagesubheading"> - This page last changed on Mar 10, 2008 by <font color="#0050B2">ritchiem</font>. - </div> - - - -<h2><a name="QpidJavaFAQ-WhatisQpid%3F"></a><span id='tgl_content_q1' class='cloakToggle'></span> What is Qpid ?</h2> -<span id='content_q1' class='cloak' style='display: none'> - -<p>The java implementation of Qpid is a pure Java message broker that implements the AMQP protocol. Essentially, Qpid is a robust, performant middleware component that can handle your messaging traffic.</p> - -<p>It currently supports the following features:</p> - -<ul> - <li>High performance header-based routing for messages</li> - <li>All features required by the JMS 1.1 specification. Qpid passes all tests in the Sun JMS compliance test suite</li> - <li>Transaction support</li> - <li>Persistence using the high performance Berkeley DB Java Edition. The persistence layer is also pluggable should an alternative implementation be required. The BDB store is available from the <a href="3rd Party Libraries.html" title="3rd Party Libraries">3rd Party Libraries</a> page</li> - <li>Pluggable security using SASL. Any Java SASL provider can be used</li> - <li>Management using JMX and a custom management console built using Eclipse RCP</li> - <li>Naturally, interoperability with other clients including the Qpid .NET, Python, Ruby and C++ implementations -</span></li> -</ul> - - -<h2><a name="QpidJavaFAQ-CanyouhelpmegetstartedwithQpid%3F"></a><span id='tgl_content_q2' class='cloakToggle'></span> Can you help me get started with Qpid?</h2> -<span id='content_q2' class='cloak' style='display: none'> -<p>Have a look at our <a href="Getting Started Guide.html" title="Getting Started Guide">Getting Started Guide</a></p> -</span> - -<h2><a name="QpidJavaFAQ-HowdoIinstalltheQpidbroker%3F"></a><span id='tgl_content_q3' class='cloakToggle'></span> How do I install the Qpid broker ?</h2> -<span id='content_q3' class='cloak' style='display: none'> -<p>Please follow the instructions provided on our <a href="Getting Started Guide.html" title="Getting Started Guide">Getting Started Guide</a>.</p> -</span> - -<h2><a name="QpidJavaFAQ-HowdoIruntheQpidbroker%3F"></a><span id='tgl_content_q4' class='cloakToggle'></span> How do I run the Qpid broker ?</h2> -<span id='content_q4' class='cloak' style='display: none'> -<p>The broker comes with a script for unix/linux/cygwin called qpid-server, which can be found in the bin directory of the installed package. This command can be executed without any paramters and will then use the default configuration file provided on install.</p> - -<p>For the Windows OS, please use qpid-server.bat.</p> - -<p>There's no need to set your classpath for QPID as the scripts take care of that by adding jar's with classpath defining manifest files to your classpath.</p> - -<p>For more information on running the broker please see our <a href="Getting Started.html" title="Getting Started">Getting Started</a> page.</p> -</span> - -<h2><a name="QpidJavaFAQ-HowcanIcreateaconnectionusingaURL%3F"></a><span id='tgl_content_q5' class='cloakToggle'></span> How can I create a connection using a URL ?</h2> -<span id='content_q5' class='cloak' style='display: none'> -<p>The format for connection URL in QPID is as follows:</p> -<div class="preformatted"><div class="preformattedContent"> -<pre>amqp://[user:pass@][clientid]/virtualhost?brokerlist='[transport://]host[:port][?option='value'[&option='value']];'
- [&failover='method[?option='value'[&option='value']]']
- [&option='value']"
-</pre> -</div></div> -<p>Don't be alarmed - it's really not that complex !</p> - -<p>You could use a URL which looks something like this:</p> - -<p><tt>amqp://guest:guest@client1/development?brokerlist='tcp://localhost:5672'</tt></p> - -<p>Breaking this example down, here's what it all means:</p> - -<p>amqp = the protocol we're using</p> - -<p>guest:guest@localhost = username:password@clientid where the clientid is the name of your server (used under the covers but don't worry about this for now). Always use the guest:guest combination at the moment.</p> - -<p>development = the name of the virtualhost, where the virtualhost is a path which acts as a namespace. You can effectively use any value here so long as you're consistent throughout. The virtualhost must start with a slash "/" and continue with names separated by slashes. A name consists of any combination of at least one of [A-Za-z0-9] plus zero or more of [.-_+!=:].</p> - -<p>brokerlist = this is the host address and port for the broker you want to connect to. The connection factory will assume tcp if you don't specify a transport protocol. The port also defaults to 5672. Naturally you have to put at least one broker in this list.</p> - -<p>This example is not using failover so only provides one host for the broker. If you do wish to connect using failover you can provide two (or more) brokers in the format:</p> - -<p>brokerlist='tcp://host1;tcp://host2:5673'</p> - -<p>The default failover setup will automatically retry each broker once after a failed connection. If the brokerlist contains more than one server then these servers are tried in a round robin. Details on how to modifiy this behaviour will follow soon !</p> -</span> -<h2><a name="QpidJavaFAQ-HowdoIrepresentaJMSDestinationstringwithQPID%3F"></a><span id='tgl_content_q6' class='cloakToggle'></span> How do I represent a JMS Destination string with QPID ?</h2> -<span id='content_q6' class='cloak' style='display: none'> -<h4><a name="QpidJavaFAQ-Queues"></a>Queues</h4> - -<p>A queue can be created in QPID using the following URL format.</p> - -<p><tt>direct://amq.direct//<Queue Name></tt></p> - -<p>For example: <tt>direct://amq.direct//simpleQueue</tt></p> - -<p>Queue names may consist of any mixture of digits, letters, and underscores.</p> - -<h4><a name="QpidJavaFAQ-Topics"></a>Topics</h4> - -<p>A topic can be created in QPID using the following URL format.</p> - -<p><tt>topic://amq.topic/<Topic Subscription>/</tt></p> - -<p>The topic subscription may only contain the letters A-Z and a-z and digits 0-9.</p> - -<p>cloak.memory.duration = 0</p> - -<span id='content_q6_hiddentillqpid-3isdone' class='cloak' style='display: none'> -<p>The topic subscription is formed from a series of words that may only contain the letters A-Z and a-z and digits 0-9.<br/> -The words are delimited by dots. Each dot represents a new level.</p> - -<p>For example: <tt>stocks.nyse.ibm</tt></p> - -<p>Wildcards can be used on subscription with the following meaning.</p> -<ul> - <li>match a single level<br/> -<tt>#</tt> match zero or more levels</li> -</ul> - - -<p>For example:<br/> -With two clients<br/> -1 - <tt>stocks.*.ibm</tt><br/> -2 - <tt>stocks.#.ibm</tt></p> - -<p>Publishing <tt>stocks.nyse.ibm</tt> will be received by both clients but <tt>stocks.ibm</tt> and <tt>stocks.world.us.ibm</tt> will only be received by client 2.</p> - -<p>The topic currently does not support wild cards.</p> -</span> -</span> -<h2><a name="QpidJavaFAQ-HowdoIconnecttothebrokerusingJNDI%3F"></a><span id='tgl_content_q7' class='cloakToggle'></span> How do I connect to the broker using JNDI ?</h2> -<span id='content_q7' class='cloak' style='display: none'> -<p>see <a href="How to use JNDI.html" title="How to Use JNDI">How to use JNDI</a></p> - -</span> -<h2><a name="QpidJavaFAQ-I%27musingSpringandWeblogiccanyouhelpmewiththeconfigurationformovingovertoQpid%3F"></a><span id='tgl_content_q8' class='cloakToggle'></span> I'm using Spring and Weblogic - can you help me with the configuration for moving over to Qpid ?</h2> -<span id='content_q8' class='cloak' style='display: none'> -<p>Here is a donated Spring configuration file <a href="http://cwiki.apache.org/confluence/download/attachments/28400/appContext.zip?version=1" title="appContext.zip attached to Qpid Java FAQ">appContext.zip</a> which shows the config for Qpid side by side with Weblogic. HtH !</p> -</span> -<h2><a name="QpidJavaFAQ-HowdoIconfigurethelogginglevelforQpid%3F"></a><span id='tgl_content_q9' class='cloakToggle'></span> How do I configure the logging level for Qpid ?</h2> -<span id='content_q9' class='cloak' style='display: none'> -<p>The system property <div class="preformatted"><div class="preformattedContent"> -<pre>amqj.logging.level</pre> -</div></div> can be used to configure the logging level. </p> - -<p>For the broker, you can use the environment variable AMQJ_LOGGING_LEVEL which is picked up by the qpid-run script (called by qpid-server to start the broker) at runtime.</p> - -<p>For client code that you've written, simply pass in a system property to your command line to set it to the level you'd like i.e. </p> -<div class="preformatted"><div class="preformattedContent"> -<pre>-Damqj.logging.level=INFO
-</pre> -</div></div> - -<p>The log level for the broker defaults to INFO if the env variable is not set, but you may find that your log4j properties affect this. Setting the property noted above should address this.</p> -</span> -<h2><a name="QpidJavaFAQ-HowcanIconfigurethebroker%3F"></a><span id='tgl_content_q10' class='cloakToggle'></span> How can I configure the broker ?</h2> -<span id='content_q10' class='cloak' style='display: none'> -<p>The broker configuration is contained in the <installed-dir>/etc/config.xml file. You can copy and edit this file and then specify your own configuration file as a parameter to the startup script using the -c flag i.e. qpid-server -c <your_config_file's_path></p> - -<p>For more detailed information on configuration, please see <a href="Qpid Design - Configuration.html" title="Qpid Design - Configuration">Qpid Design - Configuration</a></p> -</span> -<h2><a name="QpidJavaFAQ-HowcanIchangetheportthebrokerusesatruntime%3F"></a><span id='tgl_content_q11' class='cloakToggle'></span> How can I change the port the broker uses at runtime ?</h2> -<span id='content_q11' class='cloak' style='display: none'> -<p>The broker defaults to use port 5672 at startup.</p> - -<p>To change this, use the -p flag at startup i.e. qpid-server -p <port_number_to_use></p> - -<p>Use this to get round any issues on your host server with port 5672 being in use/unavailable.</p> - -<p>For more detailed information on configuration, please see <a href="Qpid Design - Configuration.html" title="Qpid Design - Configuration">Qpid Design - Configuration</a></p> -</span> -<h2><a name="QpidJavaFAQ-WhatcommandlineoptionscanIpassintotheqpidserverscript%3F"></a><span id='tgl_content_q12' class='cloakToggle'></span> What command line options can I pass into the qpid-server script ?</h2> -<span id='content_q12' class='cloak' style='display: none'> -<p>The following options are available:</p> -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'> Option </th> -<th class='confluenceTh'> Long Option </th> -<th class='confluenceTh'> Description </th> -</tr> -<tr> -<td class='confluenceTd'> b </td> -<td class='confluenceTd'> bind </td> -<td class='confluenceTd'> Bind to the specified address overriding any value in the config file </td> -</tr> -<tr> -<td class='confluenceTd'> c </td> -<td class='confluenceTd'> config </td> -<td class='confluenceTd'> Use the given configuration file </td> -</tr> -<tr> -<td class='confluenceTd'> h </td> -<td class='confluenceTd'> help </td> -<td class='confluenceTd'> Prints list of options </td> -</tr> -<tr> -<td class='confluenceTd'> l </td> -<td class='confluenceTd'> logconfig </td> -<td class='confluenceTd'> Use the specified log4j.xml file rather than that in the etc directory </td> -</tr> -<tr> -<td class='confluenceTd'> p </td> -<td class='confluenceTd'> port </td> -<td class='confluenceTd'> Specify port to listen on. Overrides value in config file </td> -</tr> -<tr> -<td class='confluenceTd'> v </td> -<td class='confluenceTd'> version </td> -<td class='confluenceTd'> Print version information and exit </td> -</tr> -<tr> -<td class='confluenceTd'> w </td> -<td class='confluenceTd'> logwatch </td> -<td class='confluenceTd'> Specify interval for checking for logging config changes. Zero means no checking </td> -</tr> -</tbody></table> - -<p>For more detailed information on configuration, please see <a href="Qpid Design - Configuration.html" title="Qpid Design - Configuration">Qpid Design - Configuration</a></p> -</span> -<h2><a name="QpidJavaFAQ-HowdoIauthenticatewiththebroker%3FWhatuserid%26passwordshouldIuse%3F"></a><span id='tgl_content_q13' class='cloakToggle'></span> How do I authenticate with the broker ? What user id & password should I use ?</h2> -<span id='content_q13' class='cloak' style='display: none'> -<p>You should login as user guest with password guest</p> -</span> -<h2><a name="QpidJavaFAQ-HowdoIcreatequeuesthatwillalwaysbeinstantiatedatbrokerstartup%3F"></a><span id='tgl_content_q14' class='cloakToggle'></span> How do I create queues that will always be instantiated at broker startup ?</h2> -<span id='content_q14' class='cloak' style='display: none'> -<p>You can configure queues which will be created at broker startup by tailoring a copy of the virtualhosts.xml file provided in the installed qpid-version/etc directory.</p> - -<p>So, if you're using a queue called 'devqueue' you can ensure that it is created at startup by using an entry something like this:</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre><virtualhosts>
- <default>test</default>
- <virtualhost>
- <name>test</name>
- <test>
- <queue>
- <name>devqueue</name>
- <devqueue>
- <exchange>amq.direct</exchange>
- <maximumQueueDepth>4235264</maximumQueueDepth> <!-- 4Mb -->
- <maximumMessageSize>2117632</maximumMessageSize> <!-- 2Mb -->
- <maximumMessageAge>600000</maximumMessageAge> <!-- 10 mins -->
- </devqueue>
- </queue>
- </test>
- </virtualhost>
-</virtualhosts>
-</pre> -</div></div> - -<p>Note that the name (in thie example above the name is 'test') element should match the virtualhost that you're using to create connections to the broker. This is effectively a namespace used to prevent queue name clashes etc. You can also see that we've set the 'test' virtual host to be the default for any connections which do not specify a virtual host (in the <default> tag).</p> - -<p>You can amend the config.xml to point at a different virtualhosts.xml file by editing the <virtualhosts/> element.</p> - -<p>So, for example, you could tell the broker to use a file in your home directory by creating a new config.xml file with the following entry:</p> - -<p><virtualhosts>/home/myhomedir/virtualhosts.xml</virtualhosts></p> - -<p>You can then pass this amended config.xml into the broker at startup using the -c flag i.e.<br/> -qpid-server -c <path>/config.xml</p> -</span> - -<h2><a name="QpidJavaFAQ-Wheredoundeliverablemessagesendup%3F"></a><span id='tgl_content_q16' class='cloakToggle'></span> Where do undeliverable messages end up ?</h2> -<span id='content_q16' class='cloak' style='display: none'> -<p>At present, messages with an invalid routing key will be returned to the sender. If you register an exception listener for your publisher (easiest to do by making your publisher implement the ExceptionListener interface and coding the onException method) you'll see that you end up in onException in this case. You can expect to be catching a subclass of org.apache.qpid.AMQUndeliveredException.</p> -</span> - -<h2><a name="QpidJavaFAQ-CanIconfigurethenameoftheQpidbrokerlogfileatruntime%3F"></a><span id='tgl_content_q17' class='cloakToggle'></span> Can I configure the name of the Qpid broker log file at runtime ?</h2> -<span id='content_q17' class='cloak' style='display: none'> -<p>If you simply start the Qpid broker using the default configuration, then the log file is written to $QPID_WORK/log/qpid.log</p> - -<p>This is not ideal if you want to run several instances from one install, or acrhive logs to a shared drive from several hosts.</p> - -<p>To make life easier, there are two optional ways to configure the naming convention used for the broker log.</p> - -<h3><a name="QpidJavaFAQ-Settingaprefixorsuffix"></a>Setting a prefix or suffix</h3> - -<p>Users should set the following environment variables before running qpid-server:</p> - -<p>QPID_LOG_PREFIX - will prefix the log file name with the specified value e.g. if you set this value to be the name of your host (for example) it could look something like host123qpid.log</p> - -<p>QPID_LOG_SUFFIX - will suffix the file name with the specified value e.g. if you set this value to be the name of your application (for example) if could look something like qpidMyApp.log</p> - -<h3><a name="QpidJavaFAQ-IncludingthePID"></a>Including the PID</h3> - -<p>Setting either of these variables to the special value PID will introduce the process id of the java process into the file name as a prefix or suffix as specified**</p> -</span> - -<h2><a name="QpidJavaFAQ-Myclientapplicationappearstohavehung%3F"></a><span id='tgl_content_q14b' class='cloakToggle'></span> My client application appears to have hung?</h2> -<span id='content_q14b' class='cloak' style='display: none'> -<p>The client code currently has various timeouts scattered throughout the code. These can cause your client to appear like it has hung when it is actually waiting for the timeout ot compelete. One example is when the broker becomes non-responsive, the client code has a hard coded 2 minute timeout that it will wait when closing a connection. These timeouts need to be consolidated and exposed. see <a href="https://issues.apache.org/jira/browse/QPID-429" title="Visit page outside Confluence">QPID-429</a></p> -</span> - -<h2><a name="QpidJavaFAQ-HowdoIcontacttheQpidteam%3F"></a><span id='tgl_content_q15' class='cloakToggle'></span> How do I contact the Qpid team ?</h2> -<span id='content_q15' class='cloak' style='display: none'> -<p>For now, subscribe to our developer list (email qpid-dev-subscribe@incubator.apache.com). A users list is currently being set up!</p> -</span> - - <br/> - <div class="tabletitle"> - <a name="attachments">Attachments:</a> - </div> - - <div class="greybox" align="left"> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="Qpid Java FAQ_attachments/appContext.zip">appContext.zip</a> (application/x-zip-compressed) - <br/> - </div> - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid Java FAQ_attachments/appContext.zip b/content/xdocs/Qpid Java FAQ_attachments/appContext.zip Binary files differdeleted file mode 100755 index ab97d5f1f5..0000000000 --- a/content/xdocs/Qpid Java FAQ_attachments/appContext.zip +++ /dev/null diff --git a/content/xdocs/Qpid Java How To.html b/content/xdocs/Qpid Java How To.html deleted file mode 100755 index aa141a689f..0000000000 --- a/content/xdocs/Qpid Java How To.html +++ /dev/null @@ -1,41 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Qpid Java How To</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Qpid Java How To - </span> - </div> - <div class="pagesubheading"> - This page last changed on Nov 22, 2006 by <font color="#0050B2">ritchiem</font>. - </div> - - <h3><a name="QpidJavaHowTo-CollectionofHowTos"></a>Collection of How Tos</h3> - -<ul> - <li><a href="How to Use JNDI.html" title="How to Use JNDI">Use JNDI in my application</a></li> -</ul> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid Java M1 Release Notes.html b/content/xdocs/Qpid Java M1 Release Notes.html deleted file mode 100755 index 3437cc1194..0000000000 --- a/content/xdocs/Qpid Java M1 Release Notes.html +++ /dev/null @@ -1,66 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Qpid Java M1 Release Notes</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Qpid Java M1 Release Notes - </span> - </div> - <div class="pagesubheading"> - This page last changed on Nov 10, 2006 by <font color="#0050B2">mmccorma</font>. - </div> - - <p><b>This is the list of JIRA tasks completed for M1</b></p> - -<p>Bugs<br/> -<a href="http://issues.apache.org/jira/browse/QPID-4" title="Visit page outside Confluence">QPID-4</a> - Remove '/' and ':' from generated queue names<br/> -<a href="http://issues.apache.org/jira/browse/QPID-7" title="Visit page outside Confluence">QPID-7</a> - Occasionally messages are ack'd more than once<br/> -<a href="http://issues.apache.org/jira/browse/QPID-10" title="Visit page outside Confluence">QPID-10</a>- Broker throughput falls off with transactions<br/> -<a href="http://issues.apache.org/jira/browse/QPID-56" title="Visit page outside Confluence">QPID-56</a> - AMQQueueMBean - MessageCount on the management interface is not correct.<br/> -<a href="http://issues.apache.org/jira/browse/QPID-58" title="Visit page outside Confluence">QPID-58</a> - Creating a QueueReceiver results in ClassCastException<br/> -<a href="http://issues.apache.org/jira/browse/QPID-66" title="Visit page outside Confluence">QPID-66</a> - AMQSession implementation of TopicSession and QueueSession interfaces not JMS compliant<br/> -<a href="http://issues.apache.org/jira/browse/QPID-68" title="Visit page outside Confluence">QPID-68</a> - Ant build system fails if the project path contains a space<br/> -<a href="http://issues.apache.org/jira/browse/QPID-69" title="Visit page outside Confluence">QPID-69</a> - Race condition in Delivery Manager </p> - -<p>Improvements<br/> -<a href="http://issues.apache.org/jira/browse/QPID-36" title="Visit page outside Confluence">QPID-36</a> - Add high and low watermark to flow control<br/> -<a href="http://issues.apache.org/jira/browse/QPID-44" title="Visit page outside Confluence">QPID-44</a> - Add high and low watermark to flow control<br/> -<a href="http://issues.apache.org/jira/browse/QPID-57" title="Visit page outside Confluence">QPID-57</a> - AMQQueueMBean - Message header attributes should be sent along with message content.</p> - - -<p>New Features<br/> -<a href="http://issues.apache.org/jira/browse/QPID-13" title="Visit page outside Confluence">QPID-13</a> - Add option to include prefix and suffix in log file name for broker<br/> -<a href="http://issues.apache.org/jira/browse/QPID-23" title="Visit page outside Confluence">QPID-23</a> - Extend JNDI support provided to include initial context factory<br/> -<a href="http://issues.apache.org/jira/browse/QPID-29" title="Visit page outside Confluence">QPID-29</a> - Provide support for using Qpid JMX with Tivoli for application monitoring<br/> -<a href="http://issues.apache.org/jira/browse/QPID-30" title="Visit page outside Confluence">QPID-30</a> - Allow configuration of working/log directories written to by broker<br/> -<a href="http://issues.apache.org/jira/browse/QPID-40" title="Visit page outside Confluence">QPID-40</a> - Implement tx.select, tx.commit & tx.rollback from AMQP</p> - - -<p>Tasks<br/> -<a href="http://issues.apache.org/jira/browse/QPID-18" title="Visit page outside Confluence">QPID-18</a> - Update Java client and broker to MINA 1.0 release<br/> -<a href="http://issues.apache.org/jira/browse/QPID-73" title="Visit page outside Confluence">QPID-73</a> - Create Build Artifacts for release process using ant/maven<br/> -<a href="http://issues.apache.org/jira/browse/QPID-74" title="Visit page outside Confluence">QPID-74</a> - Create source distribtuion using build system<br/> -<a href="http://issues.apache.org/jira/browse/QPID-75" title="Visit page outside Confluence">QPID-75</a> - Create Standard Binary distribution using build system</p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid Java Meeting Minutes 04-04-2008.html b/content/xdocs/Qpid Java Meeting Minutes 04-04-2008.html deleted file mode 100755 index fc0c5c596f..0000000000 --- a/content/xdocs/Qpid Java Meeting Minutes 04-04-2008.html +++ /dev/null @@ -1,559 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Qpid Java Meeting Minutes 04-04-2008</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Qpid Java Meeting Minutes 04-04-2008 - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 04, 2008 by <font color="#0050B2">godfrer</font>. - </div> - - <h2><a name="QpidJavaMeetingMinutes04-04-2008-Agenda"></a>Agenda</h2> - -<ul> - <li>ApacheCon Europe</li> - <li>Update on M2.1 release process</li> - <li>Review of code commits</li> - <li>Review of new JIRAs</li> - <li>Update on GSoC projects</li> -</ul> - - - -<h2><a name="QpidJavaMeetingMinutes04-04-2008-Attendees"></a>Attendees</h2> - -<h2><a name="QpidJavaMeetingMinutes04-04-2008-ApacheConEurope"></a>ApacheCon Europe</h2> - -<p>No-one available to travel on those dates</p> - -<h2><a name="QpidJavaMeetingMinutes04-04-2008-UpdateonM2.1releaseprocess"></a>Update on M2.1 release process</h2> - -<p>Need to update the release notes in the release<br/> -Taking out the .svn directories<br/> -May cause the release to slip by a couple of days</p> - -<h2><a name="QpidJavaMeetingMinutes04-04-2008-Reviewofcodecommits"></a>Review of code commits</h2> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'> Revision </th> -<th class='confluenceTh'> Committer </th> -<th class='confluenceTh'> Date </th> -<th class='confluenceTh'> Comment (1st line) </th> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=642346" title="Visit page outside Confluence">r642346 </a> </td> -<td class='confluenceTd'> gsim </td> -<td class='confluenceTd'> 2008-03-28 </td> -<td class='confluenceTd'> Prefer binding key for unbind if specified. </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=642375" title="Visit page outside Confluence">r642375 </a> </td> -<td class='confluenceTd'> nsantos </td> -<td class='confluenceTd'> 2008-03-28 </td> -<td class='confluenceTd'> QPID-885: patch from Ted Ross </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=642959" title="Visit page outside Confluence">r642959 </a> </td> -<td class='confluenceTd'> gsim </td> -<td class='confluenceTd'> 2008-03-31 </td> -<td class='confluenceTd'> Prevent broker exit on receiving connection with invalid protocol version. </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=642981" title="Visit page outside Confluence">r642981 </a> </td> -<td class='confluenceTd'> gsim </td> -<td class='confluenceTd'> 2008-03-31 </td> -<td class='confluenceTd'> Re-introduced old 'no-local' behaviour for exclusive queues via a proprietary arg to queue.declare. </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=643032" title="Visit page outside Confluence">r643032 </a> </td> -<td class='confluenceTd'> ritchiem </td> -<td class='confluenceTd'> 2008-03-31 </td> -<td class='confluenceTd'> QPID-890 : Removed old references to VHostPrincipalDatabase and an errant old.PrincipalDatabaseAccessManager change. </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=643067" title="Visit page outside Confluence">r643067 </a> </td> -<td class='confluenceTd'> gsim </td> -<td class='confluenceTd'> 2008-03-31 </td> -<td class='confluenceTd'> Updated xml fragment to reflect correct types for connection.start.mechanisms, connection.start.locales and connection.open.capabilities </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=643086" title="Visit page outside Confluence">r643086 </a> </td> -<td class='confluenceTd'> gsim </td> -<td class='confluenceTd'> 2008-03-31 </td> -<td class='confluenceTd'> Allow zero sized arrays (with no typecode or count) </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=643153" title="Visit page outside Confluence">r643153 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-03-31 </td> -<td class='confluenceTd'> Add licensces </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=643154" title="Visit page outside Confluence">r643154 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-03-31 </td> -<td class='confluenceTd'> Created prematurely, will recreate from release branch </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=643155" title="Visit page outside Confluence">r643155 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-03-31 </td> -<td class='confluenceTd'> Branch for M2.1 release </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=643162" title="Visit page outside Confluence">r643162 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-03-31 </td> -<td class='confluenceTd'> Update version in poms </td> -<td class='confluenceTd'> Some versions are wrong in the poms, need correcting (fixed later) </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=643165" title="Visit page outside Confluence">r643165 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-03-31 </td> -<td class='confluenceTd'> Tag RC1 </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=643442" title="Visit page outside Confluence">r643442 </a> </td> -<td class='confluenceTd'> nsantos </td> -<td class='confluenceTd'> 2008-04-01 </td> -<td class='confluenceTd'> QPID-892: Make qpidd daemon not run as root (rpm install) </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=643472" title="Visit page outside Confluence">r643472 </a> </td> -<td class='confluenceTd'> gsim </td> -<td class='confluenceTd'> 2008-04-01 </td> -<td class='confluenceTd'> Fix some erroneous definitions in the transitional xml fragment for 0-10. </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=643478" title="Visit page outside Confluence">r643478 </a> </td> -<td class='confluenceTd'> gsim </td> -<td class='confluenceTd'> 2008-04-01 </td> -<td class='confluenceTd'> Added a dump method to buffer for debugging io (patch from rafaels@redhat.com) </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=643482" title="Visit page outside Confluence">r643482 </a> </td> -<td class='confluenceTd'> gsim </td> -<td class='confluenceTd'> 2008-04-01 </td> -<td class='confluenceTd'> Further correction to transitional xml def for final 0-10 (using old schema) </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=643582" title="Visit page outside Confluence">r643582 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-01 </td> -<td class='confluenceTd'> Add my gpg key </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=643597" title="Visit page outside Confluence">r643597 </a> </td> -<td class='confluenceTd'> nsantos </td> -<td class='confluenceTd'> 2008-04-01 </td> -<td class='confluenceTd'> QPID-892 - use daemon params instead of runuser; store pid of qpidd daemon to kill single instance </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=643613" title="Visit page outside Confluence">r643613 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-01 </td> -<td class='confluenceTd'> Set version to M2.1 for all, it's release time </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=643624" title="Visit page outside Confluence">r643624 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-01 </td> -<td class='confluenceTd'> Tag the first M2.1 to get voted on </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=643822" title="Visit page outside Confluence">r643822 </a> </td> -<td class='confluenceTd'> arnaudsimon </td> -<td class='confluenceTd'> 2008-04-02 </td> -<td class='confluenceTd'> QPID-829 Remove 0.10 specific URL. The code path is now selected based on broker response. We first try the highest protocol version and update the handler if the broker replies with a different protocol version. NOTE that we need to update the current java broker and 0.8 client for handling protocol headers. This should happen with the M2.1 merge. For the moment we only support an in VM 0.8 broker. Moreover, we'll need to migrate to a 0.10 vs 99.0 protocol version. </td> -<td class='confluenceTd'> Question coding standards on import statements (amend to allow .* ; remove unneeded imports ) ; Should probably add ability to set explicit AMQP version</td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=643891" title="Visit page outside Confluence">r643891 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-02 </td> -<td class='confluenceTd'> Fix gcc 4.3 warnings. </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=643894" title="Visit page outside Confluence">r643894 </a> </td> -<td class='confluenceTd'> arnaudsimon </td> -<td class='confluenceTd'> 2008-04-02 </td> -<td class='confluenceTd'> QPID-884 Updated ant for using a profile. I have created a default profile that runs the tests against an 0.8 in VM broker and cpp-async and cpp-sync that respectively runs the test against an 0.10 cpp broker with async store and with sync store. </td> -<td class='confluenceTd'> Update wiki documents to discuss the availble stores ; document where to put them ; make another test which refers to no store </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=643900" title="Visit page outside Confluence">r643900 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-02 </td> -<td class='confluenceTd'> Fix doxygen warnings. </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=643914" title="Visit page outside Confluence">r643914 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-02 </td> -<td class='confluenceTd'> Fix gcc 4.3 warnings. </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=643924" title="Visit page outside Confluence">r643924 </a> </td> -<td class='confluenceTd'> arnaudsimon </td> -<td class='confluenceTd'> 2008-04-02 </td> -<td class='confluenceTd'> QPID-884 made ant task test alton/error/failure configurable from profile file </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=643957" title="Visit page outside Confluence">r643957 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-02 </td> -<td class='confluenceTd'> Fixed logger warning on F9. </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=643995" title="Visit page outside Confluence">r643995 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-02 </td> -<td class='confluenceTd'> Encoding/decoding for new types: amqp_0_10::Map, amqp_0_10:UnknownType </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=644005" title="Visit page outside Confluence">r644005 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-02 </td> -<td class='confluenceTd'> Fix compile error on rhel5. </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=644125" title="Visit page outside Confluence">r644125 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-03 </td> -<td class='confluenceTd'> Fix serialize test failure on 64 bit architerctures. </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=644245" title="Visit page outside Confluence">r644245 </a> </td> -<td class='confluenceTd'> arnaudsimon </td> -<td class='confluenceTd'> 2008-04-03 </td> -<td class='confluenceTd'> QPID-897 this test was intermittently failing because of too short timeouts. This fix is a temporary measure until we agree about using a configurable receive timeout. </td> -<td class='confluenceTd'> hold off on permanent fix until after merge</td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=644287" title="Visit page outside Confluence">r644287 </a> </td> -<td class='confluenceTd'> kpvdr </td> -<td class='confluenceTd'> 2008-04-03 </td> -<td class='confluenceTd'> Patch from Ted Ross (see QPID-893): This patch enables management of plugged-in store modules. </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=644308" title="Visit page outside Confluence">r644308 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-03 </td> -<td class='confluenceTd'> amqp_0_10/built_in_types.h </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=644413" title="Visit page outside Confluence">r644413 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-03 </td> -<td class='confluenceTd'> src/qpid/amqp_0_10/Map.h,.cpp: use preview encoding temporarily. </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=644461" title="Visit page outside Confluence">r644461 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-03 </td> -<td class='confluenceTd'> rubygen/0-10/exceptions.rb: </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?view=rev&revision=644533" title="Visit page outside Confluence">r644533 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-03 </td> -<td class='confluenceTd'> qpid/Serializer.h, qpid/amqp_0_10/Codec.h: </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?rev=644688&view=rev" title="Visit page outside Confluence">r644688 </a> </td> -<td class='confluenceTd'> arnaudsimon </td> -<td class='confluenceTd'> 2008-04-04 </td> -<td class='confluenceTd'> QPID-796: Added ability to enable/disable message prefetching. Prefetching is controlled through the property max_prefetch, it is turned off when max_prefetch =0. (this is 0.10 code path change) </td> -<td class='confluenceTd'>`Rauise JIRA for spelling mistakes in classes (e.g. BasicMessageConsumer_0_10 strated() BasicMessageConsumer, etc ; startDistpatcher ... Replace ClientProperties.MAX_PREFETCH == 0 with method e.g. disallowMessagePrefetch() ... maybe make a connection URL property </td> -</tr> -<tr> -<td class='confluenceTd'><a href="http://svn.apache.org/viewvc?rev=644689&view=rev" title="Visit page outside Confluence">r644689 </a> </td> -<td class='confluenceTd'> arnaudsimon </td> -<td class='confluenceTd'> 2008-04-04 </td> -<td class='confluenceTd'> QPID-798 Added boolean property fully_sync when true a sync is sent after a persistent message is transfered. </td> -<td class='confluenceTd'> Make property per connection, rather than system wide; maybe change name to SYNC_PERSISTENT to denote only used on persistent messages </td> -</tr> -</tbody></table> - - -<h2><a name="QpidJavaMeetingMinutes04-04-2008-ReviewofnewJIRAs"></a>Review of new JIRAs</h2> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'>Key</th> -<th class='confluenceTh'>Component/s</th> -<th class='confluenceTh'>Affects Version/s</th> -<th class='confluenceTh'>Summary</th> -<th class='confluenceTh'>Status</th> -<th class='confluenceTh'>Assignee</th> -<th class='confluenceTh'>Reporter</th> -</tr> -<tr> -<td class='confluenceTd'><a href="https://issues.apache.org/jira/browse/QPID-902" title="Visit page outside Confluence">QPID-902</a> </td> -<td class='confluenceTd'>C++ Broker, Python Client</td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'>Management Improvements for C++ Broker</td> -<td class='confluenceTd'>Open</td> -<td class='confluenceTd'>Unassigned</td> -<td class='confluenceTd'>Ted Ross</td> -</tr> -<tr> -<td class='confluenceTd'><a href="https://issues.apache.org/jira/browse/QPID-901" title="Visit page outside Confluence">QPID-901</a> </td> -<td class='confluenceTd'>Java Client</td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'>update the java client to the 0-10 final spec</td> -<td class='confluenceTd'>Open</td> -<td class='confluenceTd'>Rafael H. Schloming</td> -<td class='confluenceTd'>Rafael H. Schloming</td> -</tr> -<tr> -<td class='confluenceTd'><a href="https://issues.apache.org/jira/browse/QPID-900" title="Visit page outside Confluence">QPID-900</a> </td> -<td class='confluenceTd'>Java Common</td> -<td class='confluenceTd'>M2.1</td> -<td class='confluenceTd'>Java Common AMQShortString should not create new byte[] backing when based off a heap buffer</td> -<td class='confluenceTd'>Open</td> -<td class='confluenceTd'>Rob Godfrey</td> -<td class='confluenceTd'>Rob Godfrey</td> -</tr> -<tr> -<td class='confluenceTd'><a href="https://issues.apache.org/jira/browse/QPID-899" title="Visit page outside Confluence">QPID-899</a> </td> -<td class='confluenceTd'>Java Common</td> -<td class='confluenceTd'>M2.1</td> -<td class='confluenceTd'>Java Common Bug in AMQShortString on tokenized substrings</td> -<td class='confluenceTd'>Open</td> -<td class='confluenceTd'>Rob Godfrey</td> -<td class='confluenceTd'>Rob Godfrey</td> -</tr> -<tr> -<td class='confluenceTd'><a href="https://issues.apache.org/jira/browse/QPID-898" title="Visit page outside Confluence">QPID-898</a> </td> -<td class='confluenceTd'>Ant Build System</td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'>remove .tar.bz2 from release target</td> -<td class='confluenceTd'>Open</td> -<td class='confluenceTd'>Unassigned</td> -<td class='confluenceTd'>Nuno Santos</td> -</tr> -<tr> -<td class='confluenceTd'><a href="https://issues.apache.org/jira/browse/QPID-897" title="Visit page outside Confluence">QPID-897</a> </td> -<td class='confluenceTd'>Java Tests</td> -<td class='confluenceTd'>M3</td> -<td class='confluenceTd'>Configurable receive timeout</td> -<td class='confluenceTd'>Open</td> -<td class='confluenceTd'>Unassigned</td> -<td class='confluenceTd'>Arnaud Simon</td> -</tr> -<tr> -<td class='confluenceTd'><a href="https://issues.apache.org/jira/browse/QPID-896" title="Visit page outside Confluence">QPID-896</a> </td> -<td class='confluenceTd'>Java Client</td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'>Provide Simple Pub/Sub examples that do not use extends</td> -<td class='confluenceTd'>Open</td> -<td class='confluenceTd'>Martin Ritchie</td> -<td class='confluenceTd'>Martin Ritchie</td> -</tr> -<tr> -<td class='confluenceTd'><a href="https://issues.apache.org/jira/browse/QPID-895" title="Visit page outside Confluence">QPID-895</a> </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'>FailoverSingleServer delays on first connection.</td> -<td class='confluenceTd'>Open</td> -<td class='confluenceTd'>Unassigned</td> -<td class='confluenceTd'>Martin Ritchie</td> -</tr> -<tr> -<td class='confluenceTd'><a href="https://issues.apache.org/jira/browse/QPID-894" title="Visit page outside Confluence">QPID-894</a> </td> -<td class='confluenceTd'>Java Common</td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'>Dependency on commons-lang: real need for 2.2, or can use 2.1?</td> -<td class='confluenceTd'>Open</td> -<td class='confluenceTd'>Rafael H. Schloming</td> -<td class='confluenceTd'>Nuno Santos</td> -</tr> -<tr> -<td class='confluenceTd'><a href="https://issues.apache.org/jira/browse/QPID-893" title="Visit page outside Confluence">QPID-893</a> </td> -<td class='confluenceTd'>C++ Broker</td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'>Enable management of plugged-in store module</td> -<td class='confluenceTd'>Closed</td> -<td class='confluenceTd'>Unassigned</td> -<td class='confluenceTd'>Ted Ross</td> -</tr> -<tr> -<td class='confluenceTd'><a href="https://issues.apache.org/jira/browse/QPID-892" title="Visit page outside Confluence">QPID-892</a> </td> -<td class='confluenceTd'>C++ Broker</td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'>Make qpidd daemon not run as root (rpm install)</td> -<td class='confluenceTd'>Resolved</td> -<td class='confluenceTd'>Unassigned</td> -<td class='confluenceTd'>Nuno Santos</td> -</tr> -<tr> -<td class='confluenceTd'><a href="https://issues.apache.org/jira/browse/QPID-891" title="Visit page outside Confluence">QPID-891</a> </td> -<td class='confluenceTd'>Java Broker</td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'>QueueDeclare reports incorrect message count on queue</td> -<td class='confluenceTd'>Open</td> -<td class='confluenceTd'>Unassigned</td> -<td class='confluenceTd'>Martin Ritchie</td> -</tr> -<tr> -<td class='confluenceTd'><a href="https://issues.apache.org/jira/browse/QPID-890" title="Visit page outside Confluence">QPID-890</a> </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'>M2.1</td> -<td class='confluenceTd'>Broker transient_config.xml still contains reference to outdated principal database :PlainPasswordVhostFilePrincipalDatabase</td> -<td class='confluenceTd'>Resolved</td> -<td class='confluenceTd'>Martin Ritchie</td> -<td class='confluenceTd'>Martin Ritchie</td> -</tr> -<tr> -<td class='confluenceTd'><a href="https://issues.apache.org/jira/browse/QPID-889" title="Visit page outside Confluence">QPID-889</a> </td> -<td class='confluenceTd'>Java Broker</td> -<td class='confluenceTd'>M2, M2.1</td> -<td class='confluenceTd'>Requirement for _reapingStoreContext should be removed.</td> -<td class='confluenceTd'>Open</td> -<td class='confluenceTd'>Martin Ritchie</td> -<td class='confluenceTd'>Martin Ritchie</td> -</tr> -<tr> -<td class='confluenceTd'><a href="https://issues.apache.org/jira/browse/QPID-888" title="Visit page outside Confluence">QPID-888</a> </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'>M2, M2.1</td> -<td class='confluenceTd'>Management methods don't correctly protect _lock from being lost on error</td> -<td class='confluenceTd'>Open</td> -<td class='confluenceTd'>Unassigned</td> -<td class='confluenceTd'>Martin Ritchie</td> -</tr> -<tr> -<td class='confluenceTd'><a href="https://issues.apache.org/jira/browse/QPID-887" title="Visit page outside Confluence">QPID-887</a> </td> -<td class='confluenceTd'>Java Broker</td> -<td class='confluenceTd'>M2, M2.1</td> -<td class='confluenceTd'>QueueHousekeeping threads are poorly named</td> -<td class='confluenceTd'>Open</td> -<td class='confluenceTd'>Unassigned</td> -<td class='confluenceTd'>Martin Ritchie</td> -</tr> -<tr> -<td class='confluenceTd'><a href="https://issues.apache.org/jira/browse/QPID-886" title="Visit page outside Confluence">QPID-886</a> </td> -<td class='confluenceTd'>Java Broker</td> -<td class='confluenceTd'>M2, M2.1</td> -<td class='confluenceTd'>CSDM.removeExpired() doesn't relinquish lock causing broker hang.</td> -<td class='confluenceTd'>Open</td> -<td class='confluenceTd'>Martin Ritchie</td> -<td class='confluenceTd'>Martin Ritchie</td> -</tr> -<tr> -<td class='confluenceTd'><a href="https://issues.apache.org/jira/browse/QPID-885" title="Visit page outside Confluence">QPID-885</a> </td> -<td class='confluenceTd'>Python Client</td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'>Broker configuration utility</td> -<td class='confluenceTd'>Closed</td> -<td class='confluenceTd'>Unassigned</td> -<td class='confluenceTd'>Ted Ross</td> -</tr> -<tr> -<td class='confluenceTd'><a href="https://issues.apache.org/jira/browse/QPID-884" title="Visit page outside Confluence">QPID-884</a> </td> -<td class='confluenceTd'>Java Tests</td> -<td class='confluenceTd'>M3</td> -<td class='confluenceTd'>Improve ant task test configuration</td> -<td class='confluenceTd'>Closed</td> -<td class='confluenceTd'>Arnaud Simon</td> -<td class='confluenceTd'>Arnaud Simon</td> -</tr> -<tr> -<td class='confluenceTd'><a href="https://issues.apache.org/jira/browse/QPID-883" title="Visit page outside Confluence">QPID-883</a> </td> -<td class='confluenceTd'>Python Client</td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'>Synchronous API in management.py</td> -<td class='confluenceTd'>Closed</td> -<td class='confluenceTd'>Unassigned</td> -<td class='confluenceTd'>Ted Ross</td> -</tr> -<tr> -<td class='confluenceTd'><a href="https://issues.apache.org/jira/browse/QPID-882" title="Visit page outside Confluence">QPID-882</a> </td> -<td class='confluenceTd'>Java Client</td> -<td class='confluenceTd'>M3</td> -<td class='confluenceTd'>XAResource does not check pre and post-conditions</td> -<td class='confluenceTd'>Open</td> -<td class='confluenceTd'>Arnaud Simon</td> -<td class='confluenceTd'>Arnaud Simon</td> -</tr> -<tr> -<td class='confluenceTd'><a href="https://issues.apache.org/jira/browse/QPID-881" title="Visit page outside Confluence">QPID-881</a> </td> -<td class='confluenceTd'>Java Client</td> -<td class='confluenceTd'>M3</td> -<td class='confluenceTd'>Commands waiting on a future are not notified of a connection closed event</td> -<td class='confluenceTd'>Open</td> -<td class='confluenceTd'>Rafael H. Schloming</td> -<td class='confluenceTd'>Arnaud Simon</td> -</tr> -<tr> -<td class='confluenceTd'><a href="https://issues.apache.org/jira/browse/QPID-880" title="Visit page outside Confluence">QPID-880</a> </td> -<td class='confluenceTd'>Java Client</td> -<td class='confluenceTd'>M2,M2.1</td> -<td class='confluenceTd'>Client is still using broker set temporary queue names</td> -<td class='confluenceTd'>Open</td> -<td class='confluenceTd'>Unassigned</td> -<td class='confluenceTd'>Martin Ritchie</td> -</tr> -<tr> -<td class='confluenceTd'><a href="https://issues.apache.org/jira/browse/QPID-879" title="Visit page outside Confluence">QPID-879</a> </td> -<td class='confluenceTd'>C++ Broker</td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'>Adding support for XML-based routing</td> -<td class='confluenceTd'>Open</td> -<td class='confluenceTd'>Unassigned</td> -<td class='confluenceTd'>Jonathan Robie</td> -</tr> -<tr> -<td class='confluenceTd'><a href="https://issues.apache.org/jira/browse/QPID-878" title="Visit page outside Confluence">QPID-878</a> </td> -<td class='confluenceTd'>Java Tests</td> -<td class='confluenceTd'>M3</td> -<td class='confluenceTd'>Some tests are not run by ant as their class name does not end by Test</td> -<td class='confluenceTd'>Closed</td> -<td class='confluenceTd'>Arnaud Simon</td> -<td class='confluenceTd'>Arnaud Simon</td> -</tr> -<tr> -<td class='confluenceTd'><a href="https://issues.apache.org/jira/browse/QPID-877" title="Visit page outside Confluence">QPID-877</a> </td> -<td class='confluenceTd'>C++ Broker, Python Client</td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'>Management protocol and API improvements</td> -<td class='confluenceTd'>Closed</td> -<td class='confluenceTd'>Unassigned</td> -<td class='confluenceTd'>Ted Ross</td> -</tr> -</tbody></table> - - - - -<h2><a name="QpidJavaMeetingMinutes04-04-2008-UpdateonGSoCprojects"></a>Update on GSoC projects</h2> - -<p>Had some interest, not all have been submitted.</p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid Java Meeting Minutes 11-04-2008.html b/content/xdocs/Qpid Java Meeting Minutes 11-04-2008.html deleted file mode 100755 index 26fc541cb9..0000000000 --- a/content/xdocs/Qpid Java Meeting Minutes 11-04-2008.html +++ /dev/null @@ -1,513 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Qpid Java Meeting Minutes 11-04-2008</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Qpid Java Meeting Minutes 11-04-2008 - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 11, 2008 by <font color="#0050B2">ritchiem</font>. - </div> - - <h2><a name="QpidJavaMeetingMinutes11-04-2008-Agenda"></a>Agenda</h2> - -<ul> - <li>Update on M2.1 release process</li> - <li>Review of code commits</li> - <li>Review of new JIRAs</li> - <li>Update on GSoC projects</li> -</ul> - - -<h2><a name="QpidJavaMeetingMinutes11-04-2008-Attendees"></a>Attendees</h2> - -<p>Rob Godfrey<br/> -Aidan Skinner<br/> -Marnie McCormack<br/> -Martin Ritchie<br/> -Carl Trieloff<br/> -Rajith Attapatu<br/> -Rafael Schloming<br/> -Gordon Sim</p> - -<h2><a name="QpidJavaMeetingMinutes11-04-2008-UpdateonM2.1releaseprocess"></a>Update on M2.1 release process</h2> - -<p>RC3 is out, release instructions need to be updated.<br/> -C++ documentation should exist</p> - -<h2><a name="QpidJavaMeetingMinutes11-04-2008-Reviewofcodecommits"></a>Review of code commits</h2> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'> revision </th> -<th class='confluenceTh'> committer </th> -<th class='confluenceTh'> date </th> -<th class='confluenceTh'> comment </th> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=644689" title="Visit page outside Confluence">r644689 </a> </td> -<td class='confluenceTd'> arnaudsimon </td> -<td class='confluenceTd'> 2008-04-04 13:11:38 +0100 (Fri, 04 Apr 2008) </td> -<td class='confluenceTd'> QPID-798 Added boolean property fully_sync when true a sync is sent after a persistent message is transfered. . </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=644727" title="Visit page outside Confluence">r644727 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-04 15:42:36 +0100 (Fri, 04 Apr 2008) </td> -<td class='confluenceTd'> src/qpid/amqp_0_10/Assembly.cpp,.h: </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=644732" title="Visit page outside Confluence">r644732 </a> </td> -<td class='confluenceTd'> nsantos </td> -<td class='confluenceTd'> 2008-04-04 15:58:01 +0100 (Fri, 04 Apr 2008) </td> -<td class='confluenceTd'> QPID-898: move bz2 generation from the release target to a new release-all target </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=644806" title="Visit page outside Confluence">r644806 </a> </td> -<td class='confluenceTd'> kpvdr </td> -<td class='confluenceTd'> 2008-04-04 19:14:42 +0100 (Fri, 04 Apr 2008) </td> -<td class='confluenceTd'> Patch from Ted Ross (see QPID-902): This patch contains the following improvements for management:\n1) Schema display cleaned up in the python mgmt-cli\n2) Locking added automatically to management object accessors (manual<br clear="all" /> - locking removed from broker/Queue.cpp)\n3) Schemas are now pre-registered with the management agent using a package initializer. This allows management consoles to get schema information for a class even if no instances of the class exist. </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=644812" title="Visit page outside Confluence">r644812 </a> </td> -<td class='confluenceTd'> kpvdr </td> -<td class='confluenceTd'> 2008-04-04 19:25:08 +0100 (Fri, 04 Apr 2008) </td> -<td class='confluenceTd'> Additional files for Ted Ross's checkin </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=644845" title="Visit page outside Confluence">r644845 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-04 20:35:14 +0100 (Fri, 04 Apr 2008) </td> -<td class='confluenceTd'> Minor cleanup of base Exception and python_tests script. </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=644917" title="Visit page outside Confluence">r644917 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-04 22:00:40 +0100 (Fri, 04 Apr 2008) </td> -<td class='confluenceTd'> src/qpid/amqp_0_10/Exception.h </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=645470" title="Visit page outside Confluence">r645470 </a> </td> -<td class='confluenceTd'> gsim </td> -<td class='confluenceTd'> 2008-04-07 12:51:07 +0100 (Mon, 07 Apr 2008) </td> -<td class='confluenceTd'> AsynchIoAcceptor.cpp: Limit output from codec to one buffer per 'idle' call. </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=645593" title="Visit page outside Confluence">r645593 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-07 17:27:20 +0100 (Mon, 07 Apr 2008) </td> -<td class='confluenceTd'> Add toplevel NOTICE and LICENSE files, add Felix to java/resources/NOTICE, make sure all spec files are included in java source distribution </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=645663" title="Visit page outside Confluence">r645663 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-07 21:12:31 +0100 (Mon, 07 Apr 2008) </td> -<td class='confluenceTd'> Encoding/decoding for packed structs and optional members. </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=645664" title="Visit page outside Confluence">r645664 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-07 21:13:59 +0100 (Mon, 07 Apr 2008) </td> -<td class='confluenceTd'> Missing from last commit. </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=645670" title="Visit page outside Confluence">r645670 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-07 21:42:28 +0100 (Mon, 07 Apr 2008) </td> -<td class='confluenceTd'> Fix rhel5 build errors. </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=645685" title="Visit page outside Confluence">r645685 </a> </td> -<td class='confluenceTd'> astitcher </td> -<td class='confluenceTd'> 2008-04-07 21:59:02 +0100 (Mon, 07 Apr 2008) </td> -<td class='confluenceTd'> Fixed time classes for some changes that misunderstood how they are supposed </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=645699" title="Visit page outside Confluence">r645699 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-07 22:16:48 +0100 (Mon, 07 Apr 2008) </td> -<td class='confluenceTd'> rubygen/0-10/specification.rb </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=645731" title="Visit page outside Confluence">r645731 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-08 00:05:28 +0100 (Tue, 08 Apr 2008) </td> -<td class='confluenceTd'> Update release notes </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=645732" title="Visit page outside Confluence">r645732 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-08 00:07:50 +0100 (Tue, 08 Apr 2008) </td> -<td class='confluenceTd'> Tag M2.1 RC3 </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=645733" title="Visit page outside Confluence">r645733 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-08 00:22:36 +0100 (Tue, 08 Apr 2008) </td> -<td class='confluenceTd'> src/qpid/amqp_0_10/Body.h, Header.h: placeholders. </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=645804" title="Visit page outside Confluence">r645804 </a> </td> -<td class='confluenceTd'> gsim </td> -<td class='confluenceTd'> 2008-04-08 10:18:10 +0100 (Tue, 08 Apr 2008) </td> -<td class='confluenceTd'> Fixed compilation error from ignored qualifier on function return type. </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=645826" title="Visit page outside Confluence">r645826 </a> </td> -<td class='confluenceTd'> gsim </td> -<td class='confluenceTd'> 2008-04-08 11:16:32 +0100 (Tue, 08 Apr 2008) </td> -<td class='confluenceTd'> Removed out-of-date and misleading comment. </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=645951" title="Visit page outside Confluence">r645951 </a> </td> -<td class='confluenceTd'> gsim </td> -<td class='confluenceTd'> 2008-04-08 15:48:25 +0100 (Tue, 08 Apr 2008) </td> -<td class='confluenceTd'> QPID-903: changed read-write lock to mutex (currently recursive) to avoid deadlocking when adding bridge. </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=646045" title="Visit page outside Confluence">r646045 </a> </td> -<td class='confluenceTd'> kpvdr </td> -<td class='confluenceTd'> 2008-04-08 20:29:08 +0100 (Tue, 08 Apr 2008) </td> -<td class='confluenceTd'> Patch from Ted Ross: QPID-907: Management Improvements for C++ Broker and Store </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=646054" title="Visit page outside Confluence">r646054 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-08 20:53:07 +0100 (Tue, 08 Apr 2008) </td> -<td class='confluenceTd'> Summary: added 0-10 Array encoding and decoding. </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=646071" title="Visit page outside Confluence">r646071 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-08 22:02:14 +0100 (Tue, 08 Apr 2008) </td> -<td class='confluenceTd'> Touched existing template so new template allSegmentTypes.rb will be noticed. </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=646093" title="Visit page outside Confluence">r646093 </a> </td> -<td class='confluenceTd'> cctrieloff </td> -<td class='confluenceTd'> 2008-04-08 22:51:17 +0100 (Tue, 08 Apr 2008) </td> -<td class='confluenceTd'> QPID-908 from tross </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=646099" title="Visit page outside Confluence">r646099 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-08 23:11:40 +0100 (Tue, 08 Apr 2008) </td> -<td class='confluenceTd'> Fix packaing problem with generated file allSegmentTypes.h </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=646113" title="Visit page outside Confluence">r646113 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-08 23:46:06 +0100 (Tue, 08 Apr 2008) </td> -<td class='confluenceTd'> Nuke </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=646114" title="Visit page outside Confluence">r646114 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-08 23:46:10 +0100 (Tue, 08 Apr 2008) </td> -<td class='confluenceTd'> use svnexe for uploading, generate source jars </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=646115" title="Visit page outside Confluence">r646115 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-08 23:46:26 +0100 (Tue, 08 Apr 2008) </td> -<td class='confluenceTd'> Tag M2.1 RC3 </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=646376" title="Visit page outside Confluence">r646376 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-09 15:25:09 +0100 (Wed, 09 Apr 2008) </td> -<td class='confluenceTd'> Improved diagnostics in allSegmentTypes test. </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=646452" title="Visit page outside Confluence">r646452 </a> </td> -<td class='confluenceTd'> gsim </td> -<td class='confluenceTd'> 2008-04-09 18:59:38 +0100 (Wed, 09 Apr 2008) </td> -<td class='confluenceTd'> Handle the set-redelivered flag on the final version of the message.release command. </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=646505" title="Visit page outside Confluence">r646505 </a> </td> -<td class='confluenceTd'> gsim </td> -<td class='confluenceTd'> 2008-04-09 20:52:44 +0100 (Wed, 09 Apr 2008) </td> -<td class='confluenceTd'> Fixes and automated tests for federation function. </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=646519" title="Visit page outside Confluence">r646519 </a> </td> -<td class='confluenceTd'> rajith </td> -<td class='confluenceTd'> 2008-04-09 21:31:28 +0100 (Wed, 09 Apr 2008) </td> -<td class='confluenceTd'> This is a fix for QPID-911. When the message id is set, _hasBeenUpdated will be set to true. </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=646778" title="Visit page outside Confluence">r646778 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-10 13:36:58 +0100 (Thu, 10 Apr 2008) </td> -<td class='confluenceTd'> Invocation handlers, see src/tests/amqp_0_10/handlers.cpp for example. </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=646783" title="Visit page outside Confluence">r646783 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-10 14:00:04 +0100 (Thu, 10 Apr 2008) </td> -<td class='confluenceTd'> Use "Exception" instead of typeid.name() as default exception name. Mangled type names are too confusing. </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=646791" title="Visit page outside Confluence">r646791 </a> </td> -<td class='confluenceTd'> kpvdr </td> -<td class='confluenceTd'> 2008-04-10 14:17:44 +0100 (Thu, 10 Apr 2008) </td> -<td class='confluenceTd'> Minor change to format of log message when exception is thrown </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=646943" title="Visit page outside Confluence">r646943 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-10 21:15:08 +0100 (Thu, 10 Apr 2008) </td> -<td class='confluenceTd'> amqp_0_10: Encoding for packed structs. </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=647099" title="Visit page outside Confluence">r647099 </a> </td> -<td class='confluenceTd'> gsim </td> -<td class='confluenceTd'> 2008-04-11 11:02:49 +0100 (Fri, 11 Apr 2008) </td> -<td class='confluenceTd'> QPID-913: committed patch from tross@redhat.com </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=647123" title="Visit page outside Confluence">r647123 </a> </td> -<td class='confluenceTd'> gsim </td> -<td class='confluenceTd'> 2008-04-11 12:44:12 +0100 (Fri, 11 Apr 2008) </td> -<td class='confluenceTd'> Set executable property for commands </td> -</tr> -</tbody></table> -<ul> - <li>Attempt to achieve consensus on qpid-dev that all (C++) commits have a JIRA at the start</li> - <li>AS to fix release notes, again</li> - <li>r646519 should use updated(), check if QPID-911 affects M2.1, audit class for other usages of hasUpdated directly</li> -</ul> - - -<h2><a name="QpidJavaMeetingMinutes11-04-2008-ReviewofnewJIRAs"></a>Review of new JIRAs</h2> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'> Key </th> -<th class='confluenceTh'> Component/s </th> -<th class='confluenceTh'> Affects Version/s </th> -<th class='confluenceTh'> Summary </th> -<th class='confluenceTh'> Status </th> -<th class='confluenceTh'> Assignee </th> -<th class='confluenceTh'> Reporter </th> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-913" title="Visit page outside Confluence">QPID-913</a> </td> -<td class='confluenceTd'> Python Client </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> Reorganization of python utilities + a bug fix </td> -<td class='confluenceTd'> Open </td> -<td class='confluenceTd'> Unassigned </td> -<td class='confluenceTd'> Ted Ross </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-912" title="Visit page outside Confluence">QPID-912</a> </td> -<td class='confluenceTd'> Java Client </td> -<td class='confluenceTd'> M2,M2.1 </td> -<td class='confluenceTd'> AMQSession.getQueueDepth should better describe its failure conditions. </td> -<td class='confluenceTd'> Open </td> -<td class='confluenceTd'> Unassigned </td> -<td class='confluenceTd'> Martin Ritchie </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-911" title="Visit page outside Confluence">QPID-911</a> </td> -<td class='confluenceTd'> Java Client </td> -<td class='confluenceTd'> M3 </td> -<td class='confluenceTd'> MessageID is not set for outgoing messages if that is the only property set </td> -<td class='confluenceTd'> Resolved </td> -<td class='confluenceTd'> Rajith Attapattu </td> -<td class='confluenceTd'> Rajith Attapattu </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-910" title="Visit page outside Confluence">QPID-910</a> </td> -<td class='confluenceTd'> Java Broker,Java Client </td> -<td class='confluenceTd'> M2.1 </td> -<td class='confluenceTd'> Some poms reference inappropriate mvn repos </td> -<td class='confluenceTd'> Open </td> -<td class='confluenceTd'> Aidan Skinner </td> -<td class='confluenceTd'> Aidan Skinner </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-909" title="Visit page outside Confluence">QPID-909</a> </td> -<td class='confluenceTd'> Java Tests </td> -<td class='confluenceTd'> M2.1 </td> -<td class='confluenceTd'> DurationTestDecorator doesn't work in conjunction with the ScaledTestDecorator </td> -<td class='confluenceTd'> Open </td> -<td class='confluenceTd'> Unassigned </td> -<td class='confluenceTd'> Martin Ritchie </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-908" title="Visit page outside Confluence">QPID-908</a> </td> -<td class='confluenceTd'> Python Client </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> Python command utility for federation routes </td> -<td class='confluenceTd'> Closed </td> -<td class='confluenceTd'> Unassigned </td> -<td class='confluenceTd'> Ted Ross </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-907" title="Visit page outside Confluence">QPID-907</a> </td> -<td class='confluenceTd'> C++ Broker,Python Client </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> Management Improvements for C++ Broker and Store </td> -<td class='confluenceTd'> Closed </td> -<td class='confluenceTd'> Unassigned </td> -<td class='confluenceTd'> Ted Ross </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-906" title="Visit page outside Confluence">QPID-906</a> </td> -<td class='confluenceTd'> Java Client </td> -<td class='confluenceTd'> M2.1 </td> -<td class='confluenceTd'> java.lang.NumberFormatException silently ignored in MessageListener.onMessage(Message message) </td> -<td class='confluenceTd'> Open </td> -<td class='confluenceTd'> Unassigned </td> -<td class='confluenceTd'> Alasdair MacLeod </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-905" title="Visit page outside Confluence">QPID-905</a> </td> -<td class='confluenceTd'> Java Client </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> org.apache.qpid.client.ClientProperties dies ungracefully when max_prefetch is not set to a valid number </td> -<td class='confluenceTd'> Open </td> -<td class='confluenceTd'> Unassigned </td> -<td class='confluenceTd'> Rafael H. Schloming </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-904" title="Visit page outside Confluence">QPID-904</a> </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> broker.clean is not set properly in any of the test profiles </td> -<td class='confluenceTd'> Open </td> -<td class='confluenceTd'> Unassigned </td> -<td class='confluenceTd'> Rafael H. Schloming </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-903" title="Visit page outside Confluence">QPID-903</a> </td> -<td class='confluenceTd'> C++ Broker </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> Federation (inter-broker) links cause C++ broker to hang </td> -<td class='confluenceTd'> Closed </td> -<td class='confluenceTd'> Unassigned </td> -<td class='confluenceTd'> Ted Ross </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-902" title="Visit page outside Confluence">QPID-902</a> </td> -<td class='confluenceTd'> C++ Broker,Python Client </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> Management Improvements for C++ Broker </td> -<td class='confluenceTd'> Closed </td> -<td class='confluenceTd'> Unassigned </td> -<td class='confluenceTd'> Ted Ross </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-901" title="Visit page outside Confluence">QPID-901</a> </td> -<td class='confluenceTd'> Java Client </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> update the java client to the 0-10 final spec </td> -<td class='confluenceTd'> Open </td> -<td class='confluenceTd'> Rafael H. Schloming </td> -<td class='confluenceTd'> Rafael H. Schloming </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-900" title="Visit page outside Confluence">QPID-900</a> </td> -<td class='confluenceTd'> Java Common </td> -<td class='confluenceTd'> M2.1 </td> -<td class='confluenceTd'> Java Common AMQShortString should not create new byte[] backing when based off a heap buffer </td> -<td class='confluenceTd'> Open </td> -<td class='confluenceTd'> Rob Godfrey </td> -<td class='confluenceTd'> Rob Godfrey </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-899" title="Visit page outside Confluence">QPID-899</a> </td> -<td class='confluenceTd'> Java Common </td> -<td class='confluenceTd'> M2.1 </td> -<td class='confluenceTd'> Java Common Bug in AMQShortString on tokenized substrings </td> -<td class='confluenceTd'> Open </td> -<td class='confluenceTd'> Rob Godfrey </td> -<td class='confluenceTd'> Rob Godfrey </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-898" title="Visit page outside Confluence">QPID-898</a> </td> -<td class='confluenceTd'> Ant Build System </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> remove .tar.bz2 from release target </td> -<td class='confluenceTd'> Resolved </td> -<td class='confluenceTd'> Unassigned </td> -<td class='confluenceTd'> Nuno Santos </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-897" title="Visit page outside Confluence">QPID-897</a> </td> -<td class='confluenceTd'> Java Tests </td> -<td class='confluenceTd'> M3 </td> -<td class='confluenceTd'> Configurable receive timeout </td> -<td class='confluenceTd'> Open </td> -<td class='confluenceTd'> Unassigned </td> -<td class='confluenceTd'> Arnaud Simon </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-896" title="Visit page outside Confluence">QPID-896</a> </td> -<td class='confluenceTd'> Java Client </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> Provide Simple Pub/Sub examples that do not use extends </td> -<td class='confluenceTd'> Open </td> -<td class='confluenceTd'> Martin Ritchie </td> -<td class='confluenceTd'> Martin Ritchie </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-895" title="Visit page outside Confluence">QPID-895</a> </td> -<td class='confluenceTd'> Java Client </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> FailoverSingleServer delays on first connection. </td> -<td class='confluenceTd'> Open </td> -<td class='confluenceTd'> Unassigned </td> -<td class='confluenceTd'> Martin Ritchie </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-894" title="Visit page outside Confluence">QPID-894</a> </td> -<td class='confluenceTd'> Java Common </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> "Dependency on commons-lang: real need for 2.2, or can use 2.1?" </td> -<td class='confluenceTd'> Open </td> -<td class='confluenceTd'> Rafael H. Schloming </td> -<td class='confluenceTd'> Nuno Santos </td> -</tr> -</tbody></table> - - -<ul> - <li>RS - new JIRA to moving try catch to just around onMessage()</li> - <li>RS - Take QPID-906 and check that it is JMS Spec compliant</li> - <li>CT - find cruise control files</li> - <li>CT - JIRA time tracking is broken, normalises 1d is 24h should be 8h</li> -</ul> - - -<h2><a name="QpidJavaMeetingMinutes11-04-2008-UpdateonGSoCprojects"></a>Update on GSoC projects</h2> - -<p>We discusssed our project proposals</p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid Java Meeting Minutes 2008-04-18.html b/content/xdocs/Qpid Java Meeting Minutes 2008-04-18.html deleted file mode 100755 index 022ae98dc8..0000000000 --- a/content/xdocs/Qpid Java Meeting Minutes 2008-04-18.html +++ /dev/null @@ -1,945 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Qpid Java Meeting Minutes 2008-04-18</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Qpid Java Meeting Minutes 2008-04-18 - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 18, 2008 by <font color="#0050B2">godfrer</font>. - </div> - - <h2><a name="QpidJavaMeetingMinutes2008-04-18-Agenda"></a>Agenda</h2> - -<ul> - <li>Update on Merge</li> - <li>Update on M2.1 release process</li> - <li>Review of code commits</li> - <li>Review of new JIRAs</li> - <li>Update on GSoC projects</li> -</ul> - - -<h2><a name="QpidJavaMeetingMinutes2008-04-18-Attendees"></a>Attendees</h2> - - -<p>Aidan Skinner<br/> -Arnaud Simon<br/> -Carl Trieloff<br/> -Martin Ritchie<br/> -Robert Godfrey</p> - - -<h3><a name="QpidJavaMeetingMinutes2008-04-18-Apologies"></a>Apologies</h3> - -<p>Gordon Sim</p> - - - -<h2><a name="QpidJavaMeetingMinutes2008-04-18-UpdateonM2.1releaseprocess"></a>Update on M2.1 release process</h2> - - - -<h2><a name="QpidJavaMeetingMinutes2008-04-18-Reviewofcodecommits"></a>Review of code commits</h2> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'> Revision </th> -<th class='confluenceTh'> Committer </th> -<th class='confluenceTh'> Date </th> -<th class='confluenceTh'> Commit Comment </th> -<th class='confluenceTh'> Review Points </th> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=647227" title="Visit page outside Confluence">r647227 </a> </td> -<td class='confluenceTd'> rhs </td> -<td class='confluenceTd'> 2008-04-11 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-901" title="Visit page outside Confluence">QPID-901 </a>: temporary workaround for AMQP-218 </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=647270" title="Visit page outside Confluence">r647270 </a> </td> -<td class='confluenceTd'> kpvdr </td> -<td class='confluenceTd'> 2008-04-11 </td> -<td class='confluenceTd'> Patch from Ted Ross: added set methods to hilo types in generated management classes </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=647616" title="Visit page outside Confluence">r647616 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-13 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-916" title="Visit page outside Confluence">QPID-916 </a> Correct release notes </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=647620" title="Visit page outside Confluence">r647620 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-13 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-916" title="Visit page outside Confluence">QPID-916 </a> tag RC4 </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=647704" title="Visit page outside Confluence">r647704 </a> </td> -<td class='confluenceTd'> gsim </td> -<td class='confluenceTd'> 2008-04-14 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-917" title="Visit page outside Confluence">QPID-917 </a>: Use PLAIN (rather than the non-standard AMQPLAIN) as the SASL mechanism when authenticating python test clients. </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=647710" title="Visit page outside Confluence">r647710 </a> </td> -<td class='confluenceTd'> gsim </td> -<td class='confluenceTd'> 2008-04-14 </td> -<td class='confluenceTd'> Correction to release notes (now support AMQP 0-9) </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=647716" title="Visit page outside Confluence">r647716 </a> </td> -<td class='confluenceTd'> gsim </td> -<td class='confluenceTd'> 2008-04-14 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-648" title="Visit page outside Confluence">QPID-648 </a>: Initial support for sasl authentication for c++ broker. From patch submitted by mfarrellee@redhat.com. Authentication is optional at compile time (based on user selection or availability of ... </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=647726" title="Visit page outside Confluence">r647726 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-14 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-832" title="Visit page outside Confluence">QPID-832 </a> delete for resync with trunk (cpp, ruby) and M2.1 (java/broker) </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=647727" title="Visit page outside Confluence">r647727 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-14 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-832" title="Visit page outside Confluence">QPID-832 </a> sync cpp with trunk </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=647728" title="Visit page outside Confluence">r647728 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-14 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-832" title="Visit page outside Confluence">QPID-832 </a> sync ruby from trunk </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=647730" title="Visit page outside Confluence">r647730 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-14 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-832" title="Visit page outside Confluence">QPID-832 </a> sync broker with M2.1 </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=647800" title="Visit page outside Confluence">r647800 </a> </td> -<td class='confluenceTd'> gsim </td> -<td class='confluenceTd'> 2008-04-14 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-648" title="Visit page outside Confluence">QPID-648 </a>: keep the sasl_conn member in the handler to avoid the need for friend declaration </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=647825" title="Visit page outside Confluence">r647825 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-14 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-916" title="Visit page outside Confluence">QPID-916 </a> Tag RC5, with correct C++ release notes </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=647887" title="Visit page outside Confluence">r647887 </a> </td> -<td class='confluenceTd'> rhs </td> -<td class='confluenceTd'> 2008-04-14 </td> -<td class='confluenceTd'> fixed encode/decode of structs in command/control arguments to include the type code when specified </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=647903" title="Visit page outside Confluence">r647903 </a> </td> -<td class='confluenceTd'> gsim </td> -<td class='confluenceTd'> 2008-04-14 </td> -<td class='confluenceTd'> Use the errata file for final 0-10 that has a type code for xids without which dtx.recover can't work. Return the indoubt xids as an array of struct32s each of which contains an encoded xid. </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=647937" title="Visit page outside Confluence">r647937 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-14 </td> -<td class='confluenceTd'> <a href="https://bugzilla.redhat.com/show_bug.cgi?id=441080" title="Visit page outside Confluence">https://bugzilla.redhat.com/show_bug.cgi?id=441080</a> from Ville Skyttä (ville.skytta@iki.fi) qpidc's build does not use $RPM_OPT_FLAGS so it misses some compiler security features, and strips installed ... </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=647940" title="Visit page outside Confluence">r647940 </a> </td> -<td class='confluenceTd'> gsim </td> -<td class='confluenceTd'> 2008-04-14 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-648" title="Visit page outside Confluence">QPID-648 </a>: more flexible sasl implementation (patch provided by mfarrellee@redhat.com) </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=647990" title="Visit page outside Confluence">r647990 </a> </td> -<td class='confluenceTd'> gsim </td> -<td class='confluenceTd'> 2008-04-14 </td> -<td class='confluenceTd'> Fix to struct32 encoding </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=647999" title="Visit page outside Confluence">r647999 </a> </td> -<td class='confluenceTd'> gsim </td> -<td class='confluenceTd'> 2008-04-14 </td> -<td class='confluenceTd'><ul> - <li>Fix interpretation of accept-mode, 0 == EXPLICIT * Ensure accepts are taken into account in command sequence</li> -</ul> -</td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648013" title="Visit page outside Confluence">r648013 </a> </td> -<td class='confluenceTd'> nsantos </td> -<td class='confluenceTd'> 2008-04-14 </td> -<td class='confluenceTd'> fix home dir permissions </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648095" title="Visit page outside Confluence">r648095 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-15 </td> -<td class='confluenceTd'> Struct32 encoding </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648194" title="Visit page outside Confluence">r648194 </a> </td> -<td class='confluenceTd'> gsim </td> -<td class='confluenceTd'> 2008-04-15 </td> -<td class='confluenceTd'> Remove deleted file from distribution list. </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648196" title="Visit page outside Confluence">r648196 </a> </td> -<td class='confluenceTd'> gsim </td> -<td class='confluenceTd'> 2008-04-15 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-648" title="Visit page outside Confluence">QPID-648 </a>: Get list of supported mechanisms from sasl lib. (Patch from mfarrellee@redhat.com) </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648207" title="Visit page outside Confluence">r648207 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-15 </td> -<td class='confluenceTd'> Merged revisions 631979-647797 via svnmerge from <a href="https://svn.apache.org/repos/asf/incubator/qpid/trunk" title="Visit page outside Confluence">https://svn.apache.org/repos/asf/incubator/qpid/trunk</a> ........ r631987 - aconway - 2008-02-28 14:47:59 +0000 (Thu, 28 Feb 2008) - 2 lines Fixe ... </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648216" title="Visit page outside Confluence">r648216 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-15 </td> -<td class='confluenceTd'> Merged revisions 627417-648207 via svnmerge from <a href="https://svn.apache.org/repos/asf/incubator/qpid/branches/M2.1" title="Visit page outside Confluence">https://svn.apache.org/repos/asf/incubator/qpid/branches/M2.1</a> ........ r627552 - rgodfrey - 2008-02-13 18:10:53 +0000 (Wed, 13 Feb 2008) - 1 line ... </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648218" title="Visit page outside Confluence">r648218 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-15 </td> -<td class='confluenceTd'> Merged revisions 647798-648216 via svnmerge from <a href="https://svn.apache.org/repos/asf/incubator/qpid/trunk" title="Visit page outside Confluence">https://svn.apache.org/repos/asf/incubator/qpid/trunk</a> ........ r647800 - gsim - 2008-04-14 14:57:36 +0100 (Mon, 14 Apr 2008) - 3 lines <a href="https://issues.apache.org/jira/browse/QPID-64" title="Visit page outside Confluence">QPID-64 </a> ... </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648272" title="Visit page outside Confluence">r648272 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-15 </td> -<td class='confluenceTd'> Fix build error: MapValue SIZE was too small for Struct32. </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648288" title="Visit page outside Confluence">r648288 </a> </td> -<td class='confluenceTd'> astitcher </td> -<td class='confluenceTd'> 2008-04-15 </td> -<td class='confluenceTd'> Refactored the IO framework that sits on top of Poller so that it uses a generalised IOHandle. This means that you can define new classes derived from IOHandle (other than Socket) that can also be add ... </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648292" title="Visit page outside Confluence">r648292 </a> </td> -<td class='confluenceTd'> nsantos </td> -<td class='confluenceTd'> 2008-04-15 </td> -<td class='confluenceTd'> add svn revision include to specfile </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648297" title="Visit page outside Confluence">r648297 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-15 </td> -<td class='confluenceTd'> Cleanup of size calculations and handling UnknownStruct </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648308" title="Visit page outside Confluence">r648308 </a> </td> -<td class='confluenceTd'> nsantos </td> -<td class='confluenceTd'> 2008-04-15 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-921" title="Visit page outside Confluence">QPID-921 </a>: applied qpid-patch36.diff on behalf of Ted Ross </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648314" title="Visit page outside Confluence">r648314 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-15 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-831" title="Visit page outside Confluence">QPID-831 </a> fix pom version </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648328" title="Visit page outside Confluence">r648328 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-15 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-831" title="Visit page outside Confluence">QPID-831 </a> Remove some broker introspection stuff and transaction bumpf </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648329" title="Visit page outside Confluence">r648329 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-15 </td> -<td class='confluenceTd'> Disabled failing tests, working on fixing the issues. </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648338" title="Visit page outside Confluence">r648338 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-15 </td> -<td class='confluenceTd'> Comment out failing test, repairing. </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648362" title="Visit page outside Confluence">r648362 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-15 </td> -<td class='confluenceTd'> Correct Struct32 encoding: size/code/data. Proper re-encoding for unknown struct codes. </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648418" title="Visit page outside Confluence">r648418 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-15 </td> -<td class='confluenceTd'> Fix build error - missing op << for Struct32. </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648614" title="Visit page outside Confluence">r648614 </a> </td> -<td class='confluenceTd'> rgodfrey </td> -<td class='confluenceTd'> 2008-04-16 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-899" title="Visit page outside Confluence">QPID-899 </a> : Bug in AMQShortString on tokenized substrings </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648617" title="Visit page outside Confluence">r648617 </a> </td> -<td class='confluenceTd'> rgodfrey </td> -<td class='confluenceTd'> 2008-04-16 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-900" title="Visit page outside Confluence">QPID-900 </a> : Re-use byte[] of buffer for backing of AMQShortString </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648637" title="Visit page outside Confluence">r648637 </a> </td> -<td class='confluenceTd'> rgodfrey </td> -<td class='confluenceTd'> 2008-04-16 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-922" title="Visit page outside Confluence">QPID-922 </a> : Selectors on header properties should not convert AMQShortStrings to Strings on every evaluation </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648639" title="Visit page outside Confluence">r648639 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-16 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-916" title="Visit page outside Confluence">QPID-916 </a> add DISCLAIMER to top-level, make sure C++ and .Net archives are named correctly </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648642" title="Visit page outside Confluence">r648642 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-16 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-916" title="Visit page outside Confluence">QPID-916 </a> tag RC6 </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648645" title="Visit page outside Confluence">r648645 </a> </td> -<td class='confluenceTd'> rgodfrey </td> -<td class='confluenceTd'> 2008-04-16 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-925" title="Visit page outside Confluence">QPID-925 </a> : Only begin store transactions when there is a persistent message to be committed </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648648" title="Visit page outside Confluence">r648648 </a> </td> -<td class='confluenceTd'> rgodfrey </td> -<td class='confluenceTd'> 2008-04-16 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-926" title="Visit page outside Confluence">QPID-926 </a> : Perform all store operations associated with an acknowledge in a single store transaction </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648652" title="Visit page outside Confluence">r648652 </a> </td> -<td class='confluenceTd'> rgodfrey </td> -<td class='confluenceTd'> 2008-04-16 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-927" title="Visit page outside Confluence">QPID-927 </a> : Multiple acknowledgements should be coalesced into single multiple ack </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648658" title="Visit page outside Confluence">r648658 </a> </td> -<td class='confluenceTd'> rgodfrey </td> -<td class='confluenceTd'> 2008-04-16 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-929" title="Visit page outside Confluence">QPID-929 </a> : Exchange.Declare being sent prior to every message when publishing to explicit destination </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648661" title="Visit page outside Confluence">r648661 </a> </td> -<td class='confluenceTd'> arnaudsimon </td> -<td class='confluenceTd'> 2008-04-16 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-928" title="Visit page outside Confluence">QPID-928 </a> Added a pause period for letting the finalyzer a chance to notify all the Mina connector threads before we check for spurious threads. </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648666" title="Visit page outside Confluence">r648666 </a> </td> -<td class='confluenceTd'> rgodfrey </td> -<td class='confluenceTd'> 2008-04-16 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-931" title="Visit page outside Confluence">QPID-931 </a> : Always use exclusive consumers when subscribing to topics </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648669" title="Visit page outside Confluence">r648669 </a> </td> -<td class='confluenceTd'> rgodfrey </td> -<td class='confluenceTd'> 2008-04-16 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-932" title="Visit page outside Confluence">QPID-932 </a> : Remove references to unusued constructor argument "browsedAcks" of NonTransactionalContext </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648670" title="Visit page outside Confluence">r648670 </a> </td> -<td class='confluenceTd'> rgodfrey </td> -<td class='confluenceTd'> 2008-04-16 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-932" title="Visit page outside Confluence">QPID-932 </a> : Remove references to unusued constructor argument "browsedAcks" of NonTransactionalContext </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648672" title="Visit page outside Confluence">r648672 </a> </td> -<td class='confluenceTd'> rgodfrey </td> -<td class='confluenceTd'> 2008-04-16 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-933" title="Visit page outside Confluence">QPID-933 </a> : performance tweaks </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648678" title="Visit page outside Confluence">r648678 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-16 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-916" title="Visit page outside Confluence">QPID-916 </a> update dotnet NOTICE to include log4net, make sure DISCLAIMER is including in c++ </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648679" title="Visit page outside Confluence">r648679 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-16 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-916" title="Visit page outside Confluence">QPID-916 </a> delete, about to recreate </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648680" title="Visit page outside Confluence">r648680 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-16 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-916" title="Visit page outside Confluence">QPID-916 </a> tag RC6 </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648681" title="Visit page outside Confluence">r648681 </a> </td> -<td class='confluenceTd'> arnaudsimon </td> -<td class='confluenceTd'> 2008-04-16 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-897" title="Visit page outside Confluence">QPID-897 </a>: this test was intermittently timing out when messages are not prefetched. This is a temporary fix until we use a configurable timeout. </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648692" title="Visit page outside Confluence">r648692 </a> </td> -<td class='confluenceTd'> rhs </td> -<td class='confluenceTd'> 2008-04-16 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-901" title="Visit page outside Confluence">QPID-901 </a>: updates to the java client to use the 0-10 final spec instead of the 0-10 preview spec; this includes improvements to the codegen process as well as some modifications to the shared code pat ... </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648699" title="Visit page outside Confluence">r648699 </a> </td> -<td class='confluenceTd'> rhs </td> -<td class='confluenceTd'> 2008-04-16 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-901" title="Visit page outside Confluence">QPID-901 </a>: add back ExceptionHelper.java to fix the build </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648706" title="Visit page outside Confluence">r648706 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-16 </td> -<td class='confluenceTd'> Fix bug in Blob::assign assigning from an empty blob. </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648724" title="Visit page outside Confluence">r648724 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-16 </td> -<td class='confluenceTd'> Fix encoding for sized structs. </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648726" title="Visit page outside Confluence">r648726 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-16 </td> -<td class='confluenceTd'> Separate new codec from liqqpidcommon to improve link times. To be included in libqpidcommon when we are ready to replace framing codec. </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648735" title="Visit page outside Confluence">r648735 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-16 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-832" title="Visit page outside Confluence">QPID-832 </a> fix exception constructors </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648740" title="Visit page outside Confluence">r648740 </a> </td> -<td class='confluenceTd'> ritchiem </td> -<td class='confluenceTd'> 2008-04-16 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-886" title="Visit page outside Confluence">QPID-886 </a> : In order to allow the test to be written that highlights the failure we need to be able to provide a Config object not a file. So made the method public that reads the file and added constr ... </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648764" title="Visit page outside Confluence">r648764 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-16 </td> -<td class='confluenceTd'> Rename in case of further M2-based releases </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648770" title="Visit page outside Confluence">r648770 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-16 </td> -<td class='confluenceTd'> Removed complex_types.h from Makefile.am. </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648771" title="Visit page outside Confluence">r648771 </a> </td> -<td class='confluenceTd'> rhs </td> -<td class='confluenceTd'> 2008-04-16 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-901" title="Visit page outside Confluence">QPID-901 </a>: don't depend on constant values matching up when converting between JMS and AMQP delivery modes </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648782" title="Visit page outside Confluence">r648782 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-16 </td> -<td class='confluenceTd'> Add missing files to packaging. </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648784" title="Visit page outside Confluence">r648784 </a> </td> -<td class='confluenceTd'> rhs </td> -<td class='confluenceTd'> 2008-04-16 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-901" title="Visit page outside Confluence">QPID-901 </a>: updated the JMS examples to use legal delivery mode values as they are now checked with the 0-10 final updates </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648834" title="Visit page outside Confluence">r648834 </a> </td> -<td class='confluenceTd'> rgodfrey </td> -<td class='confluenceTd'> 2008-04-16 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-156" title="Visit page outside Confluence">QPID-156 </a> : Add an Apache licensed store - created an experimental Derby based store </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=648904" title="Visit page outside Confluence">r648904 </a> </td> -<td class='confluenceTd'> astitcher </td> -<td class='confluenceTd'> 2008-04-17 </td> -<td class='confluenceTd'> Refactored IO Thread creation so that it happens in the Broker class - There is now a single Poller created by the Broker class that is passed to the Acceptor for use in network IO. It can also now ... </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=649016" title="Visit page outside Confluence">r649016 </a> </td> -<td class='confluenceTd'> arnaudsimon </td> -<td class='confluenceTd'> 2008-04-17 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-919" title="Visit page outside Confluence">QPID-919 </a> Changed AMQBrokerDetails to throw an URL exception when the port number is not specified. </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=649055" title="Visit page outside Confluence">r649055 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-17 </td> -<td class='confluenceTd'> Track changes from M2.x now </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=649057" title="Visit page outside Confluence">r649057 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-17 </td> -<td class='confluenceTd'> Track changes from M2.x now </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=649058" title="Visit page outside Confluence">r649058 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-17 </td> -<td class='confluenceTd'> Track changes from M2.x now, with right svn </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=649059" title="Visit page outside Confluence">r649059 </a> </td> -<td class='confluenceTd'> gsim </td> -<td class='confluenceTd'> 2008-04-17 </td> -<td class='confluenceTd'> Some fixes to the transitional spec defs. </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=649070" title="Visit page outside Confluence">r649070 </a> </td> -<td class='confluenceTd'> arnaudsimon </td> -<td class='confluenceTd'> 2008-04-17 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-796" title="Visit page outside Confluence">QPID-796 </a> Made connection URL property + use session level method </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=649099" title="Visit page outside Confluence">r649099 </a> </td> -<td class='confluenceTd'> arnaudsimon </td> -<td class='confluenceTd'> 2008-04-17 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-884" title="Visit page outside Confluence">QPID-884 </a> Added cpp profile that does not use a store. Also updated profile for taking auth into account and updated broker.clean as per <a href="https://issues.apache.org/jira/browse/QPID-904" title="Visit page outside Confluence">QPID-904 </a> </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=649126" title="Visit page outside Confluence">r649126 </a> </td> -<td class='confluenceTd'> nsantos </td> -<td class='confluenceTd'> 2008-04-17 </td> -<td class='confluenceTd'> add full path to qpidd in init script, as it fails in some environments with just the command name </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=649130" title="Visit page outside Confluence">r649130 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-17 </td> -<td class='confluenceTd'> Added missing .h files to Makefile.am to fix make rpmbuild. Add non-const Message::data() Make log/Statement.h public. </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=649132" title="Visit page outside Confluence">r649132 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-17 </td> -<td class='confluenceTd'> Merged revisions 632071-649058 via svnmerge from <a href="https://svn.apache.org/repos/asf/incubator/qpid/branches/M2.x" title="Visit page outside Confluence">https://svn.apache.org/repos/asf/incubator/qpid/branches/M2.x</a> ........ r632363 - ritchiem - 2008-02-29 16:00:19 +0000 (Fri, 29 Feb 2008) - 1 line ... </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=649141" title="Visit page outside Confluence">r649141 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-17 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-831" title="Visit page outside Confluence">QPID-831 </a> fix compile errors </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=649159" title="Visit page outside Confluence">r649159 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-17 </td> -<td class='confluenceTd'> src/Makefile.am: Fix problems with rpmbuild. src/tests/README: Updated information about boost test. </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=649294" title="Visit page outside Confluence">r649294 </a> </td> -<td class='confluenceTd'> astitcher </td> -<td class='confluenceTd'> 2008-04-17 </td> -<td class='confluenceTd'> Patch for improved compatibility with gcc 3.4 and boost 1.33 </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=649339" title="Visit page outside Confluence">r649339 </a> </td> -<td class='confluenceTd'> aconway </td> -<td class='confluenceTd'> 2008-04-18 </td> -<td class='confluenceTd'> src/tests/python_tests: fix exit status if QPID_NO_PREVIEW is set. src/qpid/framing/AMQFrame.h: frame header setters/getters with 0-10 naming. </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=649409" title="Visit page outside Confluence">r649409 </a> </td> -<td class='confluenceTd'> arnaudsimon </td> -<td class='confluenceTd'> 2008-04-18 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-798" title="Visit page outside Confluence">QPID-798 </a> Make property per connection and/or system wide; change name to SYNC_PERSISTENT to denote only used on persistent messages </td> -<td class='confluenceTd'> Add accessor to Qpid test Case to allow prefetch to be turned on / off </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=649432" title="Visit page outside Confluence">r649432 </a> </td> -<td class='confluenceTd'> aidan </td> -<td class='confluenceTd'> 2008-04-18 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-832" title="Visit page outside Confluence">QPID-832 </a> default protocol version to 0-9 </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=649436" title="Visit page outside Confluence">r649436 </a> </td> -<td class='confluenceTd'> arnaudsimon </td> -<td class='confluenceTd'> 2008-04-18 </td> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-936" title="Visit page outside Confluence">QPID-936 </a>: added missing session close op </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="http://svn.apache.org/viewvc/?view=rev&revision=649479" title="Visit page outside Confluence">r649479 </a> </td> -<td class='confluenceTd'> kpvdr </td> -<td class='confluenceTd'> 2008-04-18 </td> -<td class='confluenceTd'> Fix to prevent possible Timer deadlocks by holding onto mutex while calling fire() </td> -<td class='confluenceTd'> </td> -</tr> -</tbody></table> - -<h2><a name="QpidJavaMeetingMinutes2008-04-18-ReviewofNewJIRAs"></a>Review of New JIRAs</h2> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'> Key </th> -<th class='confluenceTh'> Component(s) </th> -<th class='confluenceTh'> Affects Version/s</th> -<th class='confluenceTh'> Summary </th> -<th class='confluenceTh'> Status </th> -<th class='confluenceTh'> Assignee </th> -<th class='confluenceTh'> Reporter </th> -<th class='confluenceTh'> Review Comments </th> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-914" title="Visit page outside Confluence">QPID-914 </a> </td> -<td class='confluenceTd'> Python Client </td> -<td class='confluenceTd'> M3 </td> -<td class='confluenceTd'> (QPID-914) Separate python management component from core python client </td> -<td class='confluenceTd'> Open </td> -<td class='confluenceTd'> Rafael H. Schloming </td> -<td class='confluenceTd'> Gordon Sim </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-915" title="Visit page outside Confluence">QPID-915 </a> </td> -<td class='confluenceTd'> C++ Broker </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> (QPID-915) A list of ways to avoid c++ and Python problems on the RHEL4 platform This is HTML, i.e. for a Wiki page. </td> -<td class='confluenceTd'> Closed </td> -<td class='confluenceTd'> Unassigned </td> -<td class='confluenceTd'> michael goulish </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-916" title="Visit page outside Confluence">QPID-916 </a> </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> M2.1 </td> -<td class='confluenceTd'> (QPID-916) Release M2.1 </td> -<td class='confluenceTd'> Open </td> -<td class='confluenceTd'> Aidan Skinner </td> -<td class='confluenceTd'> Aidan Skinner </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-917" title="Visit page outside Confluence">QPID-917 </a> </td> -<td class='confluenceTd'> Python Client </td> -<td class='confluenceTd'> M1, M2, M2.1, M3 </td> -<td class='confluenceTd'> (QPID-917) python tests use the default, non-standard 'AMQPLAIN' as SASL mechanism </td> -<td class='confluenceTd'> Resolved </td> -<td class='confluenceTd'> Gordon Sim </td> -<td class='confluenceTd'> Gordon Sim </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-918" title="Visit page outside Confluence">QPID-918 </a> </td> -<td class='confluenceTd'> C++ Broker </td> -<td class='confluenceTd'> M3 </td> -<td class='confluenceTd'> (QPID-918) Authentication password is logged when "trace" is enabled </td> -<td class='confluenceTd'> Open </td> -<td class='confluenceTd'> Unassigned </td> -<td class='confluenceTd'> Ted Ross </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-919" title="Visit page outside Confluence">QPID-919 </a> </td> -<td class='confluenceTd'> Java Client </td> -<td class='confluenceTd'> M3 </td> -<td class='confluenceTd'> (QPID-919) Wrong exception thrown when the connection URL contains a broker name followed by ":" but no port number is specified. </td> -<td class='confluenceTd'> Open </td> -<td class='confluenceTd'> Arnaud Simon </td> -<td class='confluenceTd'> Arnaud Simon </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-920" title="Visit page outside Confluence">QPID-920 </a> </td> -<td class='confluenceTd'> C++ Client </td> -<td class='confluenceTd'> M3 </td> -<td class='confluenceTd'> (QPID-920) Convert c++ client to final 0-10 spec </td> -<td class='confluenceTd'> Open </td> -<td class='confluenceTd'> Gordon Sim </td> -<td class='confluenceTd'> Gordon Sim </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-921" title="Visit page outside Confluence">QPID-921 </a> </td> -<td class='confluenceTd'> C++ Broker, Python Client </td> -<td class='confluenceTd'> M3 </td> -<td class='confluenceTd'> (QPID-921) Management: persistent object-ids, SASL support, System-ID </td> -<td class='confluenceTd'> Closed </td> -<td class='confluenceTd'> Unassigned </td> -<td class='confluenceTd'> Ted Ross </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-922" title="Visit page outside Confluence">QPID-922 </a> </td> -<td class='confluenceTd'> Java Broker </td> -<td class='confluenceTd'> M2.1 </td> -<td class='confluenceTd'> (QPID-922) (Java Broker) Selectors comparing header properties to constants always convert the property from AMQShortString to String, rather than converting the constant once </td> -<td class='confluenceTd'> Resolved </td> -<td class='confluenceTd'> Rob Godfrey </td> -<td class='confluenceTd'> Rob Godfrey </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-923" title="Visit page outside Confluence">QPID-923 </a> </td> -<td class='confluenceTd'> Python Test Suite </td> -<td class='confluenceTd'> M2.1 </td> -<td class='confluenceTd'> (QPID-923) Python tests are not spec version aware </td> -<td class='confluenceTd'> Open </td> -<td class='confluenceTd'> Unassigned </td> -<td class='confluenceTd'> Martin Ritchie </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-924" title="Visit page outside Confluence">QPID-924 </a> </td> -<td class='confluenceTd'> Ruby Test Suite </td> -<td class='confluenceTd'> M2.1 </td> -<td class='confluenceTd'> (QPID-924) Ruby test.rb use of '0.0.0.0' for localhost doesn't work under cygwin </td> -<td class='confluenceTd'> Open </td> -<td class='confluenceTd'> Unassigned </td> -<td class='confluenceTd'> Martin Ritchie </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-925" title="Visit page outside Confluence">QPID-925 </a> </td> -<td class='confluenceTd'> Java Broker </td> -<td class='confluenceTd'> M2.1 </td> -<td class='confluenceTd'> (QPID-925) (Java Broker) Only begin store transactions when there is a persistent message to be committed </td> -<td class='confluenceTd'> Resolved </td> -<td class='confluenceTd'> Rob Godfrey </td> -<td class='confluenceTd'> Rob Godfrey </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-926" title="Visit page outside Confluence">QPID-926 </a> </td> -<td class='confluenceTd'> Java Broker </td> -<td class='confluenceTd'> M2.1 </td> -<td class='confluenceTd'> (QPID-926) (Java Broker) Perform all store operations associated with an acknowledge in a single store transaction </td> -<td class='confluenceTd'> Open </td> -<td class='confluenceTd'> Rob Godfrey </td> -<td class='confluenceTd'> Rob Godfrey </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-927" title="Visit page outside Confluence">QPID-927 </a> </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> M2.1 </td> -<td class='confluenceTd'> (QPID-927) (Java Client) Multiple acknowledgements should be coalesced into single multiple ack, rather than each being sent individually </td> -<td class='confluenceTd'> Resolved </td> -<td class='confluenceTd'> Rob Godfrey </td> -<td class='confluenceTd'> Rob Godfrey </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-928" title="Visit page outside Confluence">QPID-928 </a> </td> -<td class='confluenceTd'> Java Tests </td> -<td class='confluenceTd'> M3 </td> -<td class='confluenceTd'> (QPID-928) Test org.apache.qpid.test.unit.client.connection.ConnectionCloseTest intermittently failing </td> -<td class='confluenceTd'> Open </td> -<td class='confluenceTd'> Unassigned </td> -<td class='confluenceTd'> Arnaud Simon </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-929" title="Visit page outside Confluence">QPID-929 </a> </td> -<td class='confluenceTd'> Java Client </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> (QPID-929) (Java Client) Exchange.Declare being sent prior to every message when publishing to explicit destination </td> -<td class='confluenceTd'> Resolved </td> -<td class='confluenceTd'> Rob Godfrey </td> -<td class='confluenceTd'> Rob Godfrey </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-930" title="Visit page outside Confluence">QPID-930 </a> </td> -<td class='confluenceTd'> Ruby Client </td> -<td class='confluenceTd'> M1, M2, M2.1, M3 </td> -<td class='confluenceTd'> (QPID-930) ruby channel_close test issues </td> -<td class='confluenceTd'> Open </td> -<td class='confluenceTd'> Unassigned </td> -<td class='confluenceTd'> Gordon Sim </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-931" title="Visit page outside Confluence">QPID-931 </a> </td> -<td class='confluenceTd'> Java Client </td> -<td class='confluenceTd'> M2.1 </td> -<td class='confluenceTd'> (QPID-931) (Java Client) Always use exclusive consumers when subscribing to topics </td> -<td class='confluenceTd'> Resolved </td> -<td class='confluenceTd'> Rob Godfrey </td> -<td class='confluenceTd'> Rob Godfrey </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-932" title="Visit page outside Confluence">QPID-932 </a> </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> M2.1 </td> -<td class='confluenceTd'> (QPID-932) (Java) Remove references to unusued constructor argument "browsedAcks" of NonTransactionalContext </td> -<td class='confluenceTd'> Open </td> -<td class='confluenceTd'> Rob Godfrey </td> -<td class='confluenceTd'> Rob Godfrey </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-933" title="Visit page outside Confluence">QPID-933 </a> </td> -<td class='confluenceTd'> Java Broker, Java Client, Java Common </td> -<td class='confluenceTd'> M2.1 </td> -<td class='confluenceTd'> (QPID-933) (Java Performance) reduce memory copies, boxing/unboxing and needless iterating </td> -<td class='confluenceTd'> Resolved </td> -<td class='confluenceTd'> Rob Godfrey </td> -<td class='confluenceTd'> Rob Godfrey </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-934" title="Visit page outside Confluence">QPID-934 </a> </td> -<td class='confluenceTd'> C++ Broker </td> -<td class='confluenceTd'> M3 </td> -<td class='confluenceTd'> (QPID-934) Federation tests fail intermittently </td> -<td class='confluenceTd'> Open </td> -<td class='confluenceTd'> Unassigned </td> -<td class='confluenceTd'> Ted Ross </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-935" title="Visit page outside Confluence">QPID-935 </a> </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> (QPID-935) patch to make trunk code work with old boost and gcc versions </td> -<td class='confluenceTd'> Open </td> -<td class='confluenceTd'> Unassigned </td> -<td class='confluenceTd'> michael goulish </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-936" title="Visit page outside Confluence">QPID-936 </a> </td> -<td class='confluenceTd'> Java Tests </td> -<td class='confluenceTd'> M3 </td> -<td class='confluenceTd'> (QPID-936) Test testMigrateDurableSubscriber from org.apache.qpid.test.unit.xa.TopicTest is failing </td> -<td class='confluenceTd'> Open </td> -<td class='confluenceTd'> Unassigned </td> -<td class='confluenceTd'> Arnaud Simon </td> -<td class='confluenceTd'> </td> -</tr> -<tr> -<td class='confluenceTd'> <a href="https://issues.apache.org/jira/browse/QPID-937" title="Visit page outside Confluence">QPID-937 </a> </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> </td> -<td class='confluenceTd'> (QPID-937) Typo in getting-started page of the site </td> -<td class='confluenceTd'> Open </td> -<td class='confluenceTd'> Unassigned </td> -<td class='confluenceTd'> Suran Jayathilaka </td> -<td class='confluenceTd'> </td> -</tr> -</tbody></table> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid Java Meeting Minutes 28-03-2008.html b/content/xdocs/Qpid Java Meeting Minutes 28-03-2008.html deleted file mode 100755 index 7f23f7da68..0000000000 --- a/content/xdocs/Qpid Java Meeting Minutes 28-03-2008.html +++ /dev/null @@ -1,111 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Qpid Java Meeting Minutes 28-03-2008</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Qpid Java Meeting Minutes 28-03-2008 - </span> - </div> - <div class="pagesubheading"> - This page last changed on Mar 28, 2008 by <font color="#0050B2">godfrer</font>. - </div> - - <h2><a name="QpidJavaMeetingMinutes28-03-2008-Attendees"></a>Attendees</h2> - -<p>Rob Godfrey<br/> -Arnaud Simon<br/> -Aidan Skinner<br/> -Marnie McCormack<br/> -Rafi Schloming</p> - -<h2><a name="QpidJavaMeetingMinutes28-03-2008-UpdateonM2.1releaseprocess"></a>Update on M2.1 release process</h2> - -<p>Tagged RC1 yesterday<br/> -Going to run RAT, push out over the weekend<br/> -Need to schedule updates to documentation</p> - -<h2><a name="QpidJavaMeetingMinutes28-03-2008-UpdateonGSoCprojects"></a>Update on GSoC projects</h2> - -<p>Had a large number of students, need to get mentors<br/> -Need to distribute the load</p> - -<p>Also have interest from external parties helping with management bridge</p> - -<p>Need to follow the timeline; process</p> - -<h2><a name="QpidJavaMeetingMinutes28-03-2008-ApacheConnEurope"></a>Apache Conn Europe</h2> - -<p>Qpid has a 15 min slot Amsterdam, Wednesday 9th April. Any volunteers?</p> - -<h2><a name="QpidJavaMeetingMinutes28-03-2008-Reviewofthepreviousweek%27scommits"></a>Review of the previous week's commits</h2> -<p> <a href="http://markmail.org/search/?q=type%3Acheckins+list%3Aorg.apache.incubator.qpid-commits+order%3Adate-forward+date%3A200803+#query:type%3Acheckins%20list%3Aorg.apache.incubator.qpid-commits%20order%3Adate-forward%20date%3A200803%20+page:13+mid:ewgbylgldnbmmqgw+state:results" title="Visit page outside Confluence">http://markmail.org/search/?q=type%3Acheckins+list%3Aorg.apache.incubator.qpid-commits+order%3Adate-forward+date%3A200803+#query:type%3Acheckins%20list%3Aorg.apache.incubator.qpid-commits%20order%3Adate-forward%20date%3A200803%20+page:13+mid:ewgbylgldnbmmqgw+state:results</a></p> - -<p>r639619 : Rafi comments that there is a base class on trunk which should close all connections<br/> -r640117 : We should standardize the comments on checkin to have QPID-xxx first, ensure case is correct<br/> -r640422 : Should make timeouts a configuration parameter rather than picking arbitrary values; also allow non-timeout path coverage;<br/> -r640434 : Need to look at logging levels for M3<br/> -r640503 : no JIRA number associated with the checkin!<br/> -r641212 : no need to be so generic, only need 32 bit serial numbers<br/> -r641232 : incorrect capitalization</p> - - - -<h2><a name="QpidJavaMeetingMinutes28-03-2008-ReviewnewlyraisedJIRAs"></a>Review newly raised JIRAs</h2> - -<p><a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&&type=-2&pid=12310520&created%3Aprevious=-1w+3d&sorter/field=issuekey&sorter/order=DESC" title="Visit page outside Confluence">https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&&type=-2&pid=12310520&created%3Aprevious=-1w+3d&sorter/field=issuekey&sorter/order=DESC</a></p> - -<h2><a name="QpidJavaMeetingMinutes28-03-2008-Updateonwhatpeoplearecurrentlyworkingon"></a>Update on what people are currently working on</h2> - -<p>MM: Looking at priorities for M3</p> - -<p>AS: M2.1 and Merge</p> - -<p>RG: Broker Refactoring<br/> - Headers/Exchange</p> - -<p>ASimon: Adding DTX tests<br/> - See QPID-884<br/> - Fix the URL for backwards compatability - check version in protocol initiation<br/> - Configuration for prefetch in 0-10</p> - -<p>RS: Updating 0-10 client to use correct 0-10 spec<br/> - large commit next week</p> - -<h2><a name="QpidJavaMeetingMinutes28-03-2008-UpdateonthemergefromM2.1totrunk%28Aidan%29"></a>Update on the merge from M2.1 to trunk (Aidan)</h2> - -<p>Will resynch broker / client after M2.1 finalised</p> - -<h2><a name="QpidJavaMeetingMinutes28-03-2008-Testing"></a>Testing</h2> - -<p>Marnie will put up test spec<br/> -Need to review to make sure all use cases covered.<br/> -Need stress tests and soak tests<br/> -Arnaud - should look at the Sonic test suite</p> - - -<p>Meeting closed 15:30 UK</p> - - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid Java Run Scripts.html b/content/xdocs/Qpid Java Run Scripts.html deleted file mode 100644 index 99ee1788fd..0000000000 --- a/content/xdocs/Qpid Java Run Scripts.html +++ /dev/null @@ -1,178 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Qpid Java Run Scripts</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Qpid Java Run Scripts - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 06, 2007 by <font color="#0050B2">mmccorma</font>. - </div> - - <h1><a name="QpidJavaRunScripts-QpidJavaBrokerRunScripts"></a>Qpid Java Broker Run Scripts</h1> - -<p>The following scripts are used to run the Qpid broker:</p> - -<p>qpid-server<br/> -qpid-server.bat<br/> -qpid-run</p> - -<p>These scripts are described in more detail below. </p> - -<h2><a name="QpidJavaRunScripts-qpidserver"></a>qpid-server</h2> - -<h3><a name="QpidJavaRunScripts-Overview"></a>Overview</h3> - -<p>This script starts the Qpid Java Broker on Linux/Solaris/Cygwin platforms.</p> - -<p>It is extremely simple, delegating the real work to the qpid-run script.</p> - -<p>In fact, all it really provides is the main class to execute and passes through any command line arguments to qpid-run i.e.</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre>. qpid-run org.apache.qpid.server.Main "$@"
-</pre> -</div></div> - -<h2><a name="QpidJavaRunScripts-qpidserver.bat"></a>qpid-server.bat</h2> - -<h3><a name="QpidJavaRunScripts-Overview"></a>Overview</h3> - -<p>This script starts the Qpid Java Broker on Windows platforms. It provides a limited version of the qpid-run functionality, though is not nearly as sophisticated i.e. does not support run arguments or the full set of argument variables.</p> - -<p>However, it does support the following features:</p> - -<ul> - <li>validates that JAVA_HOME is set</li> - <li>validates that QPID_HOME is set</li> - <li>passes any command line arguments to the main broker class</li> - <li>supports the use of QPID_OPTS to pass through java system properties</li> -</ul> - - -<p>Note that a JIRA exists for enhancing the features this script supports <a href="http://issues.apache.org/jira/browse/QPID-168" title="Visit page outside Confluence">http://issues.apache.org/jira/browse/QPID-168</a></p> - -<h2><a name="QpidJavaRunScripts-qpidrun"></a>qpid-run</h2> - -<h3><a name="QpidJavaRunScripts-Overview"></a>Overview</h3> - -<p>The qpid-run script allows the calling program to run any given command, and provides a flexible surround supporting configurable runtime arguments for the script itself, the broker and java arguments.</p> - -<h3><a name="QpidJavaRunScripts-EnvironmentVariablesandDefaulting"></a>Environment Variables and Defaulting</h3> - -<p>The variables noted below are used by the qpid-run script. Any default value used if not </p> - -<p>specified is noted below.</p> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'>Variable</th> -<th class='confluenceTh'>Description</th> -<th class='confluenceTh'>Default</th> -</tr> -<tr> -<td class='confluenceTd'>QPID_HOME</td> -<td class='confluenceTd'>Used as root for installed application path. Mandatory that users set this</td> -<td class='confluenceTd'>None</td> -</tr> -<tr> -<td class='confluenceTd'>QPID_WORK</td> -<td class='confluenceTd'>Used as root for any working directories to which the Qpid broker writes, for <br/> -logging and bdb etc</td> -<td class='confluenceTd'>Current User's Homedir</td> -</tr> -<tr> -<td class='confluenceTd'>AMQJ_LOGGING_LEVEL</td> -<td class='confluenceTd'>Logging level for broker code</td> -<td class='confluenceTd'>info</td> -</tr> -<tr> -<td class='confluenceTd'>QPID_LOG_PREFIX</td> -<td class='confluenceTd'>Used as a prefix for qpid broker log, see FAQ for more details</td> -<td class='confluenceTd'>None</td> -</tr> -<tr> -<td class='confluenceTd'>QPID_LOG_SUFFIX</td> -<td class='confluenceTd'>Used as a suffix for qpid broker log, see FAQ for more details</td> -<td class='confluenceTd'>None</td> -</tr> -<tr> -<td class='confluenceTd'>JPDA_OPTS</td> -<td class='confluenceTd'>If set and -run:jpda argument provided used for debugging props, see below</td> -<td class='confluenceTd'>None</td> -</tr> -<tr> -<td class='confluenceTd'>QPID_OPTS</td> -<td class='confluenceTd'>Use to pass custom system properties, including management console connection <br/> -info</td> -<td class='confluenceTd'>None</td> -</tr> -<tr> -<td class='confluenceTd'>JAVA_OPTS</td> -<td class='confluenceTd'>Use to pass custom Java options, for example gc options etc</td> -<td class='confluenceTd'>None</td> -</tr> -</tbody></table> - -<h3><a name="QpidJavaRunScripts-RunArguments"></a>Run Arguments</h3> - -<p>You can provide run arguments to the qpid-run script using the syntax</p> - -<div class="preformatted"><div class="preformattedContent"> -<pre>-run:argument
-</pre> -</div></div> - -<p>The table below provides details of the available arguments.</p> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'>Argument</th> -<th class='confluenceTh'>Description</th> -</tr> -<tr> -<td class='confluenceTd'>debug</td> -<td class='confluenceTd'>Prints classpath and command before running it</td> -</tr> -<tr> -<td class='confluenceTd'>jpda</td> -<td class='confluenceTd'>Adds remote debugging info using JPDA_OPTS. Use JPDA_TRANSPORT and JPDA_ADDRESS to <br/> -customize, JPDA_OPTS to override</td> -</tr> -<tr> -<td class='confluenceTd'>external-classpath</td> -<td class='confluenceTd'>Valid values are: ignore, first, last and only. See below for more info</td> -</tr> -<tr> -<td class='confluenceTd'>print-classpath</td> -<td class='confluenceTd'>Prints classpath before running command</td> -</tr> -<tr> -<td class='confluenceTd'>help</td> -<td class='confluenceTd'>Prints Usage information</td> -</tr> -</tbody></table> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid Management Features.html b/content/xdocs/Qpid Management Features.html deleted file mode 100755 index 654643d53e..0000000000 --- a/content/xdocs/Qpid Management Features.html +++ /dev/null @@ -1,100 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Qpid Management Features</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Qpid Management Features - </span> - </div> - <div class="pagesubheading"> - This page last changed on Jul 04, 2007 by <font color="#0050B2">ritchiem</font>. - </div> - - <p><b>Management tool:</b> Currently the management tool being used in development is JConsole.<br/> -However, see this our <a href="JMX Management Console.html" title="JMX Management Console">Management Console page</a> for details of how to use various console options with the Qpid management features.</p> - -<p>The management of QPID is categorised into following types-</p> -<ol> - <li>Exchange</li> - <li>Queue</li> - <li>Connection</li> - <li>Broker</li> -</ol> - - -<p> <b>1) Managing and Monitoring Exchanges</b>: Following is the list of features, which we can have available for managing and monitoring an Exchange running on a Qpid Server Domain-</p> -<ol> - <li>Displaying the following information for monitoring purpose- - <ol> - <li>The list of queues bound to the exchange along with the routing keys.</li> - <li><font color="#000000">General Exchange properties(like name, durable etc).</font></li> - </ol> - </li> - <li><font color="#000000">Binding an existing queue with the exchange.</font></li> -</ol> - - -<p><font color="#000000"><b>2) Managing and Monitoring Queues</b></font><font color="#000000">: Following are the features, which we can have for a Queue on a Qpid Server Domain-</font></p> -<ol> - <li><font color="#000000">Displaying the following information about the queue for monitoring purpose-</font> - <ol> - <li><font color="#000000">General Queue properties(like name, durable, etc.)</font></li> - <li><font color="#000000">The maximum size of a message that can be accepted from the message producer.</font></li> - <li><font color="#000000">The number of the active consumers accessing the Queue.</font></li> - <li><font color="#000000">The total number of consumers (Active and Suspended).</font></li> - <li><font color="#000000">The number of undelivered messages in the Queue.</font></li> - <li><font color="#000000">The total number of messages received on the Queue since startup.</font></li> - <li><font color="#000000">The maximum number of bytes for the Queue that can be stored on the Server.</font></li> - <li>The maximum number of messages for the Queue that can be stored on the Server.</li> - </ol> - </li> - <li><font color="#000000">Viewing the messages on the Queue.</font></li> - <li><font color="#000000">Deleting message from top of the Queue.</font></li> - <li><font color="#000000">Clearing the Queue.</font></li> - <li><font color="#000000">Browsing the DeadMessageQueue - Messages which are expired or undelivered because of some reason are routed to the DeadMessageQueue. This queue can not be deleted. [Note: The is open because it depends on how these kind of messages will be handeled?]</font></li> -</ol> - - -<p><font color="#000000"><b>3) Managing and Monitoring Connections</b></font><font color="#000000">: Following are the features, which we can have for a connection on a QPID Server Domain-</font></p> -<ol> - <li><font color="#000000">Displaying general connection properties(like remote address, etc.).</font></li> - <li>Setting maximum number of channels allowed for a connection.</li> - <li>View all related channels and channel properties.</li> - <li>Closing a channel.</li> - <li>Commit or Rollback transactions of a channel, if the channel is transactional.</li> - <li>Notification for exceeding the maximum number of channels.</li> - <li>Dropping a connection.</li> -</ol> - - -<p><b>4) Managing the Broker</b>: Features for the Broker-</p> -<ol> - <li>Creating an Exchange.</li> - <li>Unregistering an Exchange.</li> - <li>Creating a Queue.</li> - <li>Deleting a Queue. </li> -</ol> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid Python Documentation.html b/content/xdocs/Qpid Python Documentation.html deleted file mode 100755 index 601dedf42f..0000000000 --- a/content/xdocs/Qpid Python Documentation.html +++ /dev/null @@ -1,40 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Qpid Python Documentation</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Qpid Python Documentation - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 13, 2008 by <font color="#0050B2">aidan</font>. - </div> - - <p>Qpid provides a python client library for sending messages over AMQP. </p> - -<p>To use it, import qpid.*</p> - -<p>See tests/basic.py for some trivial examples</p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid Release Notes.html b/content/xdocs/Qpid Release Notes.html deleted file mode 100755 index cecf6489a5..0000000000 --- a/content/xdocs/Qpid Release Notes.html +++ /dev/null @@ -1,36 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Qpid Release Notes</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Qpid Release Notes - </span> - </div> - <div class="pagesubheading"> - This page last changed on Nov 10, 2006 by <font color="#0050B2">mmccorma</font>. - </div> - - <p><a href="Qpid Java M1 Release Notes.html" title="Qpid Java M1 Release Notes">Qpid Java M1 Release Notes</a></p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid Release Page.html b/content/xdocs/Qpid Release Page.html deleted file mode 100755 index 59a027e1d3..0000000000 --- a/content/xdocs/Qpid Release Page.html +++ /dev/null @@ -1,60 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Qpid Release Page</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Qpid Release Page - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 19, 2007 by <font color="#0050B2">mmccorma</font>. - </div> - - <h1><a name="QpidReleasePage-QpidReleasePage"></a>Qpid Release Page </h1> - -<h2><a name="QpidReleasePage-GeneralInformation"></a>General Information </h2> -<p>This page contains details about the Qpid release process.</p> -<ul> - <li><a href="QpidReleaseProcess.html" title="QpidReleaseProcess">QpidReleaseProcess</a></li> - <li>Release guidlines for Incubator projects - <ul> - <li><a href="http://incubator.apache.org/incubation/Incubation_Policy.html" title="Visit page outside Confluence">http://incubator.apache.org/incubation/Incubation_Policy.html</a></li> - <li><a href="http://incubator.apache.org/guides/releasemanagement.html" title="Visit page outside Confluence">http://incubator.apache.org/guides/releasemanagement.html</a></li> - <li><a href="http://incubator.apache.org/guides/sites.html" title="Visit page outside Confluence">http://incubator.apache.org/guides/sites.html</a></li> - </ul> - </li> -</ul> - - -<h2><a name="QpidReleasePage-QpidReleasePages"></a>Qpid Release Pages </h2> -<p>These pages capture the requirments/feature list for each release.</p> -<ul> - <li><a href="M2 Release.html" title="M2 Release">M2 Release</a></li> - <li><a href="M1 Release.html" title="M1 Release">M1 Release</a></li> - <li><a href="RC Multi-Platform Testing.html" title="RC Multi-Platform Testing">RC Multi-Platform Testing</a></li> -</ul> - - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid Ruby Documentation.html b/content/xdocs/Qpid Ruby Documentation.html deleted file mode 100755 index 581e3c015b..0000000000 --- a/content/xdocs/Qpid Ruby Documentation.html +++ /dev/null @@ -1,36 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Qpid Ruby Documentation</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Qpid Ruby Documentation - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 13, 2008 by <font color="#0050B2">aidan</font>. - </div> - - <p>Qpid supplies a ruby client for making AMQP connections to a compliant broker, require qpid.rb to get everything you need. tests/basic.rb has a simple example. </p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid Testing.html b/content/xdocs/Qpid Testing.html deleted file mode 100755 index be35e8ee7a..0000000000 --- a/content/xdocs/Qpid Testing.html +++ /dev/null @@ -1,88 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Qpid Testing</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Qpid Testing - </span> - </div> - <div class="pagesubheading"> - This page last changed on Oct 30, 2006 by <font color="#0050B2">ritchiem</font>. - </div> - - <h3><a name="QpidTesting-Overview"></a>Overview</h3> - -<p>This is page summarises the various benchmark test that are actively run with Qpid.</p> - -<h3><a name="QpidTesting-Tests"></a>Tests</h3> - -<ul> - <li><a href="#QpidTesting-topictest" title="topic-test on Qpid Testing">Topic Test</a></li> - <li><a href="#QpidTesting-ibmputget" title="ibm-putget on Qpid Testing">IBM PutGet Test</a></li> - <li><a href="#QpidTesting-ibmsendreceive" title="ibm-send-receive on Qpid Testing">IBM Sender/Receiver Test</a></li> -</ul> - - -<h3><a name="QpidTesting-Servers"></a>Servers</h3> - -<p>The results of the tests mean nothing without knowing what they were run on. Here is a list of the servers the project has available for testing use.<br/> -The machines should be refered to in all tests.</p> - - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'>Server</th> -<th class='confluenceTh'>Spec</th> -</tr> -<tr> -<td class='confluenceTd'><a href="Test Server 1.html" title="Test Server 1">1</a></td> -<td class='confluenceTd'>2.6.9-22.0.1.ELsmp - 8 - Way Opteron - 32 Gig Ram </td> -</tr> -<tr> -<td class='confluenceTd'><a href="Test Server 2.html" title="Test Server 2">2</a></td> -<td class='confluenceTd'>2.4.21-15.0.4.ELhugemem - 4 - Way Opteron - 12 Gig Ram </td> -</tr> -</tbody></table> - -<h4><a name="QpidTesting-TopicTest"></a><a href="Topic Test.html" title="Topic Test">Topic Test</a> <a name="QpidTesting-topictest"></a></h4> -<p>Last Run : 2006-10-23</p> - -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'>Servers</th> -<th class='confluenceTh'>Timing</th> -</tr> -<tr> -<td class='confluenceTd'>b1,c2</td> -<td class='confluenceTd'>avg: 778</td> -</tr> -</tbody></table> - -<h4><a name="QpidTesting-IBMPutGetTest"></a>IBM PutGet Test <a name="QpidTesting-ibmputget"></a></h4> -<p>Last Run : </p> - -<h4><a name="QpidTesting-IBMSender%2FReceiverTest"></a>IBM Sender/Receiver Test <a name="QpidTesting-ibmsendreceive"></a></h4> -<p>Last Run : </p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Qpid Troubleshooting Guide.html b/content/xdocs/Qpid Troubleshooting Guide.html deleted file mode 100755 index 53f081604f..0000000000 --- a/content/xdocs/Qpid Troubleshooting Guide.html +++ /dev/null @@ -1,83 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Qpid Troubleshooting Guide</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Qpid Troubleshooting Guide - </span> - </div> - <div class="pagesubheading"> - This page last changed on Oct 19, 2006 by <font color="#0050B2">mmccorma</font>. - </div> - - <h2><a name="QpidTroubleshootingGuide-I%27mgettingajava.lang.UnsupportedClassVersionErrorwhenItrytostartthebroker.Whatdoesthismean%3F"></a>I'm getting a java.lang.UnsupportedClassVersionError when I try to start the broker. What does this mean ?</h2> - -<p>The QPID broker requires JDK 1.5 or later. If you're seeing this exception you don't have that version in your path. Set JAVA_HOME to the correct version and ensure the bin directory is on your path.</p> - -<p>java.lang.UnsupportedClassVersionError: org/apache/qpid/server/Main (Unsupported major.minor version 49.0)<br/> -at java.lang.ClassLoader.defineClass(Ljava.lang.String;[BIILjava.security.ProtectionDomain;)Ljava.lang.Class;(Unknown Source)<br/> -at java.security.SecureClassLoader.defineClass(Ljava.lang.String;[BIILjava.security.CodeSource;)Ljava.lang.Class;(SecureClassLoader.java:123)<br/> -at java.net.URLClassLoader.defineClass(Ljava.lang.String;Lsun.misc.Resource;)Ljava.lang.Class;(URLClassLoader.java:251)<br/> -at java.net.URLClassLoader.access$100(Ljava.net.URLClassLoader;Ljava.lang.String;Lsun.misc.Resource;)Ljava.lang.Class;(URLClassLoader.java:55)<br/> -at java.net.URLClassLoader$1.run()Ljava.lang.Object;<br/> -(URLClassLoader.java:194)<br/> -at jrockit.vm.AccessController.do_privileged_exc(Ljava.security.PrivilegedExceptionAction;Ljava.security.AccessControlContext;I)Ljava.lang.Object;(Unknown Source)<br/> -at jrockit.vm.AccessController.doPrivileged(Ljava.security.PrivilegedExceptionAction;Ljava.security.AccessControlContext;)Ljava.lang.Object;(Unknown Source)<br/> -at java.net.URLClassLoader.findClass(Ljava.lang.String;)Ljava.lang.Class;(URLClassLoader.java:187)<br/> -at java.lang.ClassLoader.loadClass(Ljava.lang.String;Z)Ljava.lang.Class; (Unknown Source)<br/> -at sun.misc.Launcher$AppClassLoader.loadClass(Ljava.lang.String;Z)Ljava.lang.Class;(Launcher.java:274)<br/> -at java.lang.ClassLoader.loadClass(Ljava.lang.String;)Ljava.lang.Class;<br/> -(Unknown Source)<br/> -at java.lang.ClassLoader.loadClassFromNative(II)Ljava.lang.Class;<br/> -(Unknown Source)</p> - -<h2><a name="QpidTroubleshootingGuide-I%27mhavingaproblembindingtotherequiredhost%3Aportatbrokerstartup%3F"></a>I'm having a problem binding to the required host:port at broker startup ?</h2> - -<p>This error probably indicates that another process is using the port you the broker is trying to listen on. If you haven't amended the default configuration this will be 5672. To check what process is using the port you can use 'netstat -an |grep 5672'.</p> - -<p>To change the port your broker uses, either edit the config.xml you are using. You can specify an alternative config.xml from the one provided in /etc by using the -c flag i.e. qpid-server -c <my config file path>.</p> - -<p>You can also amend the port more simply using the -p option to qpid-server i.e. qpid-server -p <my port number'</p> - -<h2><a name="QpidTroubleshootingGuide-I%27mhavingproblemswithmyclasspath.HowcanIensurethatmyclasspathisok%3F"></a>I'm having problems with my classpath. How can I ensure that my classpath is ok ?</h2> - -<p>When you are running the broker the classpath is taken care of for you, via the manifest entries in the launch jars that the qpid-server configuration file adds to the classpath.</p> - -<p>However, if you are running your own client code and experiencing classspath errors you need to ensure that the client-launch.jar from the installed Qpid lib directory is on your classpath. The manifest for this jar includes the common-launch.jar, and thus all the code you need to run a client application.</p> - -<h2><a name="QpidTroubleshootingGuide-Ican%27tgetthebrokertostart.HowcanIdiagnosetheproblem%3F"></a>I can't get the broker to start. How can I diagnose the problem ?</h2> - -<p>Firstly have a look at the broker log file - either on stdout or in $QPID_WORK/log/qpid.log or in $HOME/log/qpid.log if you haven't set QPID_WORK.</p> - -<p>You should see the problem logged in here via log4j and a stack trace. Have a look at the other entries on this page for common problems. If the log file includes a line like:</p> - -<p>"2006-10-13 09:58:14,672 INFO [main] server.Main (Main.java:343) - Qpid.AMQP listening on non-SSL address 0.0.0.0/0.0.0.0:5672"</p> - -<p>... then you know the broker started up. If not, then it didn't.</p> - -<h2><a name="QpidTroubleshootingGuide-WhenItrytosendmessagestoaqueueI%27mgettingaerrorasthequeuedoesnotexist.WhatcanIdo%3F"></a>When I try to send messages to a queue I'm getting a error as the queue does not exist. What can I do ?</h2> - -<p>In Qpid queues need a consumer before they really exist, unless you have used the virtualhosts.xml file to specify queues which should always be created at broker startup. If you don't want to use this config, then simply ensure that you consume first from queue before staring to publish to it. See the entry on our <a href="Qpid Java FAQ.html" title="Qpid Java FAQ">Qpid Java FAQ</a> for more details of using the virtualhosts.xml route.</p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/QpidReleaseProcess.html b/content/xdocs/QpidReleaseProcess.html deleted file mode 100755 index 4655891f6c..0000000000 --- a/content/xdocs/QpidReleaseProcess.html +++ /dev/null @@ -1,178 +0,0 @@ -<html> - <head> - <title>Apache Qpid : QpidReleaseProcess</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : QpidReleaseProcess - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 14, 2008 by <font color="#0050B2">aidan</font>. - </div> - - <h1><a name="QpidReleaseProcess-QpidReleaseProcessBackground"></a>Qpid Release Process - Background</h1> - -<h2><a name="QpidReleaseProcess-QpidPreReleaseSteps"></a>Qpid Pre Release Steps </h2> - -<p> 1. Create a wiki page and start capturing the feature/bug fix list for the release<br/> - 2. We can start a discussion thread and then come to a concensus on the final list<br/> - 3. These items should be tracked by jira or other means (jira is preffered)<br/> - 4. We can start a parallel thread on the release dates.</p> - -<h2><a name="QpidReleaseProcess-DetailedQpidReleaseProcess"></a>Detailed Qpid Release Process </h2> - -<p> 1. We should do a code freeze and put out a release candidate (ex RC1)<br/> - 2. We should allow a minimum of one week for people to test/check out the RC<br/> - 3. If there are major issues maybe do a RC2 and follow the same process<br/> - 4. If a majority is happy then we can do a code freeze and cut out a release.<br/> - 5. We should provide a 1.4 <a href="http://retrotranslator.sourceforge.net/" title="Visit page outside Confluence">retrotranslator</a> build of the java client (only) with each release we make</p> - -<h1><a name="QpidReleaseProcess-QpidReleaseProcessOurProcessDefinition"></a>Qpid Release Process - Our Process Definition</h1> - -<h2><a name="QpidReleaseProcess-Introduction"></a>Introduction </h2> -<p>This document describes the general release policies used by the Apache Qpid Project to create releases of the Qpid components. As described herein, this policy is not set in stone and may be adjusted by the Release Manager. We'd like to credit the Apache HTTPD project as our heavily borrowed from template for this document - thanks !</p> - -<h2><a name="QpidReleaseProcess-Whocanmakearelease%3F"></a>Who can make a release? </h2> -<p>Technically, any one can make a release of the source code due to the Apache Software License. However, only members of the Apache Qpid Project (committers) can make a release designated with Apache. Other people must call their release something other than "Apache" unless they obtain written permission from the Apache Software Foundation.</p> - -<p>Following our official release policies, we will only accept release binaries from members of the Apache Qpid Project for inclusion on our website. This ensures that our binaries can be supported by members of the project. Other people are free to make binaries, but we will not post them on our website.</p> - -<h2><a name="QpidReleaseProcess-Whoisinchargeofarelease%3F"></a>Who is in charge of a release? </h2> -<p>The release is coordinated by the Release Manager (hereafter, abbreviated as RM). Since this job requires coordination of the development community (and access to SVN), only committers to the project can be RM. However, there is no set RM. Any committer may perform a release at any time. In order to facilitate communication, it is deemed nice to alert the community with your planned release schedule before executing the release. A release should only be made when there is a plan to publicly release it. (A release should not be made only for private distribution. A private release is more suitable for that.)</p> - -<h2><a name="QpidReleaseProcess-WhomaymakeagoodcandidateforanRM%3F"></a>Who may make a good candidate for an RM? </h2> -<p>Someone with lots of time to kill. Being an RM is a very important job in our community because it takes a fair amount of time to produce a stable release. </p> - -<p>If you feel lucky, a release could be distributed without testing, but our experience has shown that this leads to a higher number of dud releases. In general, our experience has shown that a well-coordinated release fares better than non-coordinated releases. For Qpid, we are yet to establish a quality bar for releases but it's on our list of things to do !</p> - -<h2><a name="QpidReleaseProcess-WhendoIknowifitisagoodtimetorelease%3F"></a>When do I know if it is a good time to release? </h2> -<p>In the case of Qpid, we have identified (thus far) release cutoffs when we know that a) our codebase is fairly stable, b) we have made substantial improvements or additions since any previous release and c) we have significant change coming which would preclude a release for a significant period. M2 will be our second release from Qpid so this process is evolving.</p> - -<h2><a name="QpidReleaseProcess-WhatpowerdoestheRMyield%3F"></a>What power does the RM yield? </h2> -<p>Regarding what makes it into a release, the RM is the unquestioned authority. No one can contest what makes it into the release. The community will judge the release's quality after it has been issued, but the community can not force the RM to include a feature that they feel uncomfortable adding. Remember that </p> - -<p>this document is only a guideline to the community and future RMs - each RM may run a release in a different way. If you don't like what an RM is doing, start preparing for your own competing release. Note that for Qpid we do tend to take votes for such items and follow the consensus.</p> - -<h2><a name="QpidReleaseProcess-Howdoesanimpendingreleaseaffectdevelopment%3F"></a>How does an impending release affect development? </h2> -<p>It can not. Let's repeat that: an impending release can not affect development of the project. It is the RM's responsibility to identify what changes should make it into the release. The RM may have an intermediate tag, so the RM can merge in or reject changes as they are committed to the repository's HEAD. For Qpid, we manage our releases using svn branches.</p> - -<p>Committers may voluntarily refrain from committing patches if they wish to ease the burden on the RM, but they are under no obligation to do so. This is one reason why we recommend that the RMs have plenty of time on their hands - they may have to deal with a rapidly changing target. It's not an easy job.</p> - -<h2><a name="QpidReleaseProcess-HowcananRMbeconfidentinarelease%3F"></a>How can an RM be confident in a release? </h2> -<p>The RM may perform sanity checks on release candidates and should always ensure that (at least) the Qpid brokers being released can be started and connected to using test clients, before distributing. All maven available test classes should be run before releasing a distribution. The release candidate should pass all of the relevant tests before making it official. Note that we are currently in the process of defining a simple set of interop tests which ensure that our client/broker combinations can talk to one another.</p> - -<h2><a name="QpidReleaseProcess-Howtodoarelease%3F"></a>How to do a release? </h2> -<p>Once the tree has been suitably tested by the RM and any other interested parties, they should "roll" the release.</p> - -<p>Key points:</p> - -<p>Ensure that the RM's PGP/GPG key <b>?? - How do we do the key bit for Qpid ??</b><br/> -Create an official tag based on the candidate tree <br/> -Run the tools to build the appropriate binaries/source dists - <b>details tbc</b><br/> -Copy the generated release tarballs and signatures to - <b>?</b> <br/> -Email qpid-dev mailing list to inform them of the release</p> - -<h2><a name="QpidReleaseProcess-WhatcanIcallthisrelease%3F"></a>What can I call this release? </h2> -<p>At this point, the release is an alpha. The Qpid Project has three classifications for its releases:</p> - -<p><b>Should we adopt this ??</b><br/> -Alpha <br/> -Beta <br/> -General Availability (GA) </p> - -<p>Alpha indicates that the release is not meant for mainstream usage or may have serious problems that prohibits its use. When a release is initially created, it automatically becomes alpha quality.</p> - -<p>Beta indicates that at least three committers have voted positively for beta status and there were more positive than negative votes for beta designation. </p> - -<p>This indicates that it is expected to compile and perform basic tasks. However, there may be problems with this release that prohibit its widespread adoption.</p> - -<p>General Availability (GA) indicates that at least three committers have voted positively for GA status and that there were more positive than negative votes for GA designation. This release is recommended for production usage.</p> - -<h2><a name="QpidReleaseProcess-Whocanvote%3F"></a>Who can vote? </h2> -<p>Non-committers may cast a vote for a release's quality. In fact, this is extremely encouraged as it provides much-needed feedback to the community about the release's quality. However, only binding votes casted by committers count towards the designation.</p> - -<p>Note that no one may veto a release. Releases may not receive a designation level if a problem is found that inhibits proper functionality. The group may (implicitly or explicitly) revoke all votes on a release if there is a problem. However, if there is a -1 vote for a particular designation and there are greater than 3 positive votes and more positive than negative votes (i.e. majority consensus), the appropriate designation is conferred upon the release.</p> - -<h2><a name="QpidReleaseProcess-Howdowemakeitpublic%3F"></a>How do we make it public? </h2> -<p>Once the release has reached the highest-available designation (as deemed by the RM), the release can be moved to the Qpid distribution directory on apache.org. Approximately 24 to 48 hours after the files have been moved, a public announcement can be made. We wait this period so that the mirrors can </p> - -<p>receive the new release before the announcement. An email can then be sent to the announcements lists (announce@apache.org, announce@httpd.apache.org). Drafts of the announcement are usually posted on the development list before sending the announcement to let the community clarify any issues that we feel should be addressed in the announcement.</p> - -<h2><a name="QpidReleaseProcess-Shouldtheannouncementwaitforbinaries%3F"></a>Should the announcement wait for binaries? </h2> -<p>In short, no. The only files that are required for a public release are the source tarballs (.tar.Z, .tar.gz). Volunteers can provide the Win32 source distribution and binaries, and other esoteric binaries.</p> - -<p>Note that the typical Win32 source distribution differs from the original tarball in that it has generated project files as well as the CRLF line endings required for that platform.</p> - -<h2><a name="QpidReleaseProcess-Oops.Wefoundaproblem."></a>Oops. We found a problem. </h2> -<p>At this point, the release has been created. No code changes can be made in this release. If a problem is found, it will have to be addressed in the next release or a patch can be made available. No changes can be made between alpha, beta, and GA status. The only difference is the file name that is downloaded </p> - -<p>by the users. If an alpha tarball is created, but there was an error that can be resolved by re-rolling the tarball, it may be permissible to re-roll the release. But, the code itself may not change from designation to designation.</p> - -<p>There are two courses of action:</p> - -<p>Revoke the release and immediately create another one that has a fix to this problem. You can take the old release, apply the single patch, and start the voting process again. This is only recommended for critical problems found early on in the release cycle.</p> - -<p>If the problem is less severe, place the patch to the problem in the Qpid patches directory <b>TBC</b>. A link to this directory should be included in the release notes with descriptions as to what problem each patch addresses.</p> - -<h2><a name="QpidReleaseProcess-Suggestions%3F"></a>Suggestions? </h2> -<p>As always, if you have any suggestions or comments on our process, please feel free to email our developer mailing list (qpid-dev@incubator.apache.com) with your comments. We hope you found this document useful.</p> - - -<h2><a name="QpidReleaseProcess-M2.1Releaseprocess"></a>M2.1 Release process</h2> - -<p>This is what I (aidan) ran to make the Qpid release artifacts:</p> - -<p>aidan@contemplation:~/hacking/qpid$ mkdir RC5-artifacts<br/> -aidan@contemplation:~/hacking/qpid$ svn co <a href="https://svn.apache.org/repos/asf/incubator/qpid/tags/M2.1/RC5/" title="Visit page outside Confluence">https://svn.apache.org/repos/asf/incubator/qpid/tags/M2.1/RC5/</a> qpid-M2.1-RC5<br/> -aidan@contemplation:~/hacking/qpid$ ln -s qpid-M2.1-RC5 qpid-1.0-incubating-M2.1 <br/> -aidan@contemplation:~/hacking/qpid$ tar -hzcf RC5-artifacts/qpid-1.0-incubating-M2.1.tar.gz --exclude=.svn qpid-1.0-incubating-M2.1<br/> -aidan@contemplation:~/hacking/qpid$ rm qpid-1.0-incubating-M2.1<br/> -aidan@contemplation:~/hacking/qpid$ tar -zxf RC5-artifacts/qpid-1.0-incubating-M2.1.tar.gz<br/> -aidan@contemplation:~/hacking/qpid$ cd qpid-1.0-incubating-M2.1/cpp<br/> -aidan@contemplation:~/hacking/qpid/qpid-1.0-incubating-M2.1/cpp$ ./bootstrap && ./configure && make dist<br/> -aidan@contemplation:~/hacking/qpid/qpid-1.0-incubating-M2.1/cpp$ cp qpidc-M2.1.tar.gz ../../RC5-artifacts/<br/> -aidan@contemplation:~/hacking/qpid/qpid-1.0-incubating-M2.1/cpp$ cd ../java<br/> -aidan@contemplation:~/hacking/qpid/qpid-1.0-incubating-M2.1/java$ mvn -Pfastinstall && cd distribution/ && mvn assembly:assembly<br/> -aidan@contemplation:~/hacking/qpid/qpid-1.0-incubating-M2.1/java/distribution$ cp target/<b>.gz target/</b>.zip ../../../RC5-artifacts/<br/> -aidan@contemplation:~/hacking/qpid/qpid-1.0-incubating-M2.1/java/distribution$ cd ../../dotnet/<br/> -aidan@contemplation:<sub>/hacking/qpid/qpid-1.0-incubating-M2.1/dotnet$ sh ./build-framing && ./release mono-2.0 aidan@contemplation:</sub>/hacking/qpid/qpid-1.0-incubating-M2.1/dotnet$ cp bin/mono-2.0/release/Qpid.NET-mono-2.0-2008414.zip ../../RC5-artifacts/<br/> -aidan@contemplation:~/hacking/qpid/qpid-1.0-incubating-M2.1/dotnet$ cd ../../<br/> -aidan@contemplation:~/hacking/qpid$ tar -zcf RC5-artifacts/qpid-1.0-incubating-M2.1-python-src.tar.gz qpid-1.0-incubating-M2.1/LICENSE qpid-1.0-incubating-M2.1/NOTICE qpid-1.0-incubating-M2.1/python qpid-1.0-incubating-M2.1/specs <br/> -aidan@contemplation:~/hacking/qpid$ tar -zcf RC5-artifacts/qpid-1.0-incubating-M2.1-ruby-src.tar.gz qpid-1.0-incubating-M2.1/LICENSE qpid-1.0-incubating-M2.1/NOTICE qpid-1.0-incubating-M2.1/ruby qpid-1.0-incubating-M2.1/specs <br/> -aidan@contemplation:~/hacking/qpid$ cd qpid-1.0-incubating-M2.1/java/<br/> -aidan@contemplation:~/hacking/qpid/qpid-1.0-incubating-M2.1/java$ mvn deploy -DaltDeploymentRepository=incubator::default::<a href="file:///home/aidan/hacking/qpid/RC5-artifacts/maven" title="Visit page outside Confluence">file:///home/aidan/hacking/qpid/RC5-artifacts/maven</a> -Pfastinstall<br/> -aidan@contemplation:~/hacking/qpid/qpid-1.0-incubating-M2.1/java$ cd ../../RC5-artifacts/<br/> -aidan@contemplation:~/hacking/qpid/RC5-artifacts$ rm <b>java-src</b> <b>console-unix</b><br/> -aidan@contemplation:~/hacking/qpid/RC5-artifacts$ sha1sum *.zip *.gz > SHA1SUM<br/> -aidan@contemplation:~/hacking/qpid/RC5-artifacts$ for i in `find . | egrep 'jar$|pom$|gz$|zip$|SHA1SUM'`; do gpg --sign --armor --detach $i; done;</p> - -<p>and then rsync it up people.apache.org</p> - -<p>--------------------------------------------------------------------------------</p> - -<p>Copyright © 1999-2007, The Apache Software Foundation </p> - - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Queue Replay.html b/content/xdocs/Queue Replay.html deleted file mode 100755 index 0cbaf38a18..0000000000 --- a/content/xdocs/Queue Replay.html +++ /dev/null @@ -1,190 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Queue Replay</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Queue Replay - </span> - </div> - <div class="pagesubheading"> - This page last changed on Feb 20, 2007 by <font color="#0050B2">ritchiem</font>. - </div> - - <h2><a name="QueueReplay-Background"></a>Background</h2> - -<p>A lengthy discussion on replay in <a href="http://mail-archives.apache.org/mod_mbox/incubator-qpid-dev/200701.mbox/browser" title="Visit page outside Confluence">January 2007</a>(page #7, <a href="http://mail-archives.apache.org/mod_mbox/incubator-qpid-dev/200701.mbox/%3c000d01c73b18$b9e0a670$b092fea9@thinkpad%3e" title="Visit page outside Confluence">Thread</a>) highlighted a number of requirements and possible implementation options for adding replay to Qpid and AMQP. The requirements come from the desire to speed up the rate a consumer can read messages and to simplify its recovery when it starts. This page is to give some background, a proposal and finally some implementation options for discussion.</p> - -<h3><a name="QueueReplay-History"></a>History</h3> - -<p>When a an application updates the state of a single <b>Resource Manager</b>, e.g a database or queue manager, it normally does so within the context of a local <b>Transaction</b> and this transaction exhibits the following ACID properties:</p> - -<ul> - <li><b>Atomicity</b> The result of the transaction are either all commited or all rolled back.</li> - <li><b>Consistency</b> The completed transaction transformed the resource from one known state to another. Inserting a row into a database or removing a message from a queue are common examples.</li> - <li><b>Isolation</b> Changes the the resources state effected by the transaction does not become visible ouside of the transaction until the transaction commits.</li> - <li><b>Durability</b> The changes that reasult from the transactions commitment survive subsequent system or media faulures.</li> -</ul> - - -<h3><a name="QueueReplay-DistributedTransaction"></a>Distributed Transaction</h3> - -<p>A distributed transaction is typically implemented by performing a <b>Two Phase Commit</b> (2PC) over which there are several varients the most well know being the X/Open XA specification. Where both the middleware and the consumer support XA, a separate <b>Transaction Manager</b> isused to coordinate the local transactions. The transaction manager coordinates atomicity at the global level whist each resource manager is responsible for the ACID properties of its local transactions.</p> - -<p>These benefits do not come without cost.</p> - -<ul> - <li>Increased transaction processing latency, typically due to the additional forced disk writes.</li> - <li>Applications can become blocked pending the resolution of an in-doubt global transaction.</li> - <li>Reduced concurrency</li> - <li>Multi-system deadlock</li> - <li>Administration complexity</li> - <li>Backing up the transaction manager involves co-ordinating all transaction logs at the same time or processing must be suspended.</li> -</ul> - - -<h3><a name="QueueReplay-IdempotenceandReplaying"></a>Idempotence and Replaying </h3> - -<p>When a message is being moved from system A to system B (e.g. from WebSphereMQ to ORACLE), distributed transactions can be avoided if;</p> - -<ul> - <li>System B can handle duplicates (or can detect them and deal with them accordingly) - i.e. it is idempotent.</li> - <li>System A can replay messages from a known stable point in history.</li> -</ul> - - -<p>The most common way of doing this is simply managing the local transactions so that system B commits before system A. The start of replay is them the end of the last transaction on system A.</p> - -<p>Typically a MOM will immediately delete a message once it has been commited by all of its consumers.</p> - -<h3><a name="QueueReplay-CommitisNotTheEnd"></a>Commit is Not The End</h3> - -<p>If messages are made available for replay to a consumer after it has been commited, we can stretch the point in time the consumer recovers from back to any point.</p> - -<ul> - <li>A few minutes ago</li> - <li>Trade ID FFS987654321</li> - <li>Start of day</li> - <li>End of yesterday</li> - <li>Friday.</li> -</ul> - - -<p>This larger recovery window lets downstream consumers the flexibility to recover from more failure scenarios.</p> - -<ul> - <li>Retry an end of day batch job.</li> - <li>Replay due to reference data problem in target system.</li> - <li>Replay due to database or application failure.</li> -</ul> - - -<h2><a name="QueueReplay-ReplayasaFirstClassService"></a>Replay as a First Class Service</h2> - -<p>When a traditional queue is opened for reading, it is opened and the next message is the oldest one that has not been destructively read (i.e. read and commited).</p> - -<p>In isolation, a consumer manages its own local transactions with the message broker to confirm when a message or group of messages is processed, stored and <b>stable</b>. The local transaction leads to a <b>disk write</b> in the queue storage to mark the messages as read.</p> - -<p>In this XA free world the consumer relys on the messaging to replay messages from the applications last good known state. As its always reading from a queue, the only extension to the queues semantics is to let it be opened for reading from a known message, irrespective of whether the message has been committed or not and it goes without saying that they should be in the same order in which they were originally delivered.</p> - -<p><div align="center"><img src="Queue Replay_attachments/TraditionalQueue.gif" border="0" /></div></p> - -<p>Many consumers of a guaranteed message flow are writing to a database and this database is the consumers view of its state, it's certainly where the consumer recovers from when it starts up. The traditional model of using a transaction manager, typically XA, to co-ordinate the local transactions on the database and messaging broker is slow and not without its problems. </p> - -<p><div align="center"><img src="Queue Replay_attachments/TraditionalQueueWithTX.gif" border="0" /></div></p> - -<p>Another model is to have the messaging infrastructure support replay of messages from a known point in history i.e. to correlate the current state of the consumers database with a <b>last received</b> message that last caused an update to the database from this channel. This is not an all encompassing pattern but rather compliments other ways to synchronize state between a message broker and a database.</p> - -<p><div align="center"><img src="Queue Replay_attachments/ReplayableQueue.gif" border="0" /></div></p> - -<h2><a name="QueueReplay-Requirements"></a>Requirements</h2> - -<ul> - <li><b>Replay messages</b> from a queue from a given message identified by a message ID or a header property.</li> - <li><b>Administrative support</b> to purge messages from a queue as part of a business process such as <b>End of Day</b></li> - <li><b>Zero impact</b> on other queues and their consumers.</li> -</ul> - - -<h2><a name="QueueReplay-Proposal%3AAReplayableQueue"></a>Proposal: A Replayable Queue</h2> - -<p>Queues are the storage agents in AMQP so are the logical point to provide replay. A Replayable Queue (<b>RQ</b>) is not the default queue behavior but rather has to be <b>explicitly configured</b>. In may ways an RQ is somewhere between a traditional queue and a transaction log such as <a href="http://howl.objectweb.org/" title="Visit page outside Confluence">HOWL</a></p> - -<p>An RQ has the following properties:</p> - -<ul> - <li>An RQ can only have a <b>single consumer</b>. Multiple consumers complicate the problem so I propose discounting them for now.</li> - <li>Messages are <b>not deleted</b> when consumed by a regular consumer. The act of acknowledging the message is just another property on the message. Indeed, the consumer may never acknowledge the message as this implies a write on the message broker to update the messages state.</li> - <li>When an RQ is opened for reading, the consumer must give a selector that will <b>identify a point in the queue</b> to begin message delivery from.</li> - <li>Administratively <b>defined points</b> in the queue exist. These points can be defined by an administration API and associated tooling and used as points to replay from.</li> - <li>Queues are <b>purged of messages</b> by the administration API or associated tooling. This allows external processes such as End of Day to initiate message archiving or deletion when it is safe to do so.</li> - <li>An RQ can be replicated. Implementation options? SAN replication, dual writes?</li> -</ul> - - -<h3><a name="QueueReplay-Benefits"></a>Benefits</h3> - -<ul> - <li>An RQ, by virtue of a single consumer, does not need to be written to when a consumer reads messages as it is the responsibility of the consumer to provide the synchronization point when it first connects. This can significantly speed up the consumer as its bottleneck will be its own database write.</li> -</ul> - - -<ul> - <li>A complete record of all messaging activity is available.</li> -</ul> - - -<h3><a name="QueueReplay-Downsides"></a>Downsides</h3> - -<ul> - <li>The size of the store needs careful management so any implementation details do not cause performance issues.</li> -</ul> - - -<h2><a name="QueueReplay-ImplementationOptionsinQpid."></a>Implementation Options in Qpid.</h2> - -<h3><a name="QueueReplay-Configuration"></a>Configuration</h3> - -<h3><a name="QueueReplay-Storage"></a>Storage</h3> - -<h3><a name="QueueReplay-Management"></a>Management</h3> - -<h3><a name="QueueReplay-UsagefromJMS"></a>Usage from JMS</h3> - - <br/> - <div class="tabletitle"> - <a name="attachments">Attachments:</a> - </div> - - <div class="greybox" align="left"> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="Queue Replay_attachments/TraditionalQueueWithTX.gif">TraditionalQueueWithTX.gif</a> (image/gif) - <br/> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="Queue Replay_attachments/TraditionalQueue.gif">TraditionalQueue.gif</a> (image/gif) - <br/> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="Queue Replay_attachments/ReplayableQueue.gif">ReplayableQueue.gif</a> (image/gif) - <br/> - </div> - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Queue Replay_attachments/ReplayableQueue.gif b/content/xdocs/Queue Replay_attachments/ReplayableQueue.gif Binary files differdeleted file mode 100755 index 69f4744e61..0000000000 --- a/content/xdocs/Queue Replay_attachments/ReplayableQueue.gif +++ /dev/null diff --git a/content/xdocs/Queue Replay_attachments/TraditionalQueue.gif b/content/xdocs/Queue Replay_attachments/TraditionalQueue.gif Binary files differdeleted file mode 100755 index 12e0d45271..0000000000 --- a/content/xdocs/Queue Replay_attachments/TraditionalQueue.gif +++ /dev/null diff --git a/content/xdocs/Queue Replay_attachments/TraditionalQueueWithTX.gif b/content/xdocs/Queue Replay_attachments/TraditionalQueueWithTX.gif Binary files differdeleted file mode 100755 index 040d0c43aa..0000000000 --- a/content/xdocs/Queue Replay_attachments/TraditionalQueueWithTX.gif +++ /dev/null diff --git a/content/xdocs/RAJB.html b/content/xdocs/RAJB.html deleted file mode 100755 index 6e57b201a0..0000000000 --- a/content/xdocs/RAJB.html +++ /dev/null @@ -1,47 +0,0 @@ -<html> - <head> - <title>Apache Qpid : RAJB</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : RAJB - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 11, 2008 by <font color="#0050B2">cctrieloff</font>. - </div> - - -<h2><a name="RAJB-GeneralUserGuidesJava"></a>General User Guides Java</h2> - -<ul> - <li><a href="Qpid Java FAQ.html" title="Qpid Java FAQ">FAQ</a></li> - <li><a href="Getting Started Guide.html" title="Getting Started Guide">Getting Started Guide</a></li> - <li><a href="Qpid Troubleshooting Guide.html" title="Qpid Troubleshooting Guide">Troubleshooting Guide</a></li> - <li><a href="Qpid Java How To.html" title="Qpid Java How To">How To</a></li> - <li><a href="URL Formats.html" title="URL Formats">URL Formats for Qpid</a></li> - <li><a href="Example Classes.html" title="Example Classes">Example Classes</a></li> -</ul> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/RASC.html b/content/xdocs/RASC.html deleted file mode 100755 index 5ae7e2dc49..0000000000 --- a/content/xdocs/RASC.html +++ /dev/null @@ -1,191 +0,0 @@ -<html> - <head> - <title>Apache Qpid : RASC</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : RASC - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 12, 2008 by <font color="#0050B2">cctrieloff</font>. - </div> - - <h2><a name="RASC-RunningtheC%5CBroker"></a>Running the C++ Broker</h2> - -<p>It is really simple, to run cmd line</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">./qpidd</pre> -</div></div> -<p>to run as a daemon process</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">./qpidd --daemon</pre> -</div></div> -<p>stopping the daemon</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">./qpidd --quit</pre> -</div></div> - -<h2><a name="RASC-Mostcommonquestionsgettingqpiddrunning"></a>Most common questions getting qpidd running</h2> - -<p> <b>No data directory</b></p> - -<p>The qpidd broker requires you to setup a data directory or specify --no-data-dir (see help for more details). Best<br/> -is to make sure that you have create a data directory for qpidd that the process has permissions to write to.</p> - -<p>The default location is</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">/lib/<span class="code-keyword">var</span>/qpidd</pre> -</div></div> - -<p>An alternate location can be set with --data-dir</p> - -<p> <b>Starting qpidd and it says the that process is already locked</b></p> - -<p>Note that when qpidd starts it creates a lock file is data directory are being used. If you have a un-controlled exit, please mail<br/> -the trace from the core to the qpid-dev@i.a.o mailing list. To clear the lock run</p> - -<div class="code"><div class="codeContent"> -<pre class="code-java">./qpidd -q</pre> -</div></div> - -<p>It should also be noted that multiple brokers can be run on the same host. To do so set alternate data directories for each qpidd instance.</p> - -<p> <b>Using the conf file</b></p> - -<p>In order to use the conf file, use the same options that are on the command line</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">./qpidd --help</pre> -</div></div> - -<p>but formated in the following way. <br/> - a.) remove the '--' from the beginning of the option. <br/> - b.) place a '=' between the option and the value. <br/> - c.) place one option per line.</p> - -<p> <b>Can I use any Language client with the C++ Broker</b></p> - -<p>Yes, all the clients work with the C++ broker. The only restriction is that the client that matches the AMQP version needed to be used. When running the C++ broker, it is highly recommended to run AMQP 0-10.</p> - -<p>Note that JMS also works with the C++ broker. For more details on using the Java client refer to these pages:</p> -<ul> - <li><a href="How to Use JNDI.html" title="How to Use JNDI">How to Use JNDI</a></li> - <li><a href="URL Formats.html" title="URL Formats">URL Formats for Qpid</a></li> - <li><a href="Example Classes.html" title="Example Classes">Example Classes</a></li> -</ul> - - -<h2><a name="RASC-Slightlymorecomplexconfiguration"></a>Slightly more complex configuration</h2> - -<p>The easiest way to get a full listing of the broker's options are to use the --help command, run it locally for the latest set of options. These options can then be set in the conf file for convenience (see above)</p> - -<div class="code"><div class="codeContent"> -<pre class="code-java">./qpidd --help
-
-Usage: qpidd OPTIONS
-Options:
- -h [ --help ] Displays the help message
- -v [ --version ] Displays version information
- --config FILE (/etc/qpidd.conf) Reads configuration from FILE
-
-Module options:
- --module-dir DIR (/usr/lib/qpidd) Load all .so modules in <span class="code-keyword">this</span> directory
- --load-module FILE Specifies additional module(s) to be loaded
- --no-module-dir Don't load modules from module directory
-
-Broker Options:
- --data-dir DIR (/<span class="code-keyword">var</span>/lib/qpidd) Directory to contain persistent data generated by the broker
- --no-data-dir Don't use a data directory. No persistent
- configuration will be loaded or stored
- -p [ --port ] PORT (5672) Tells the broker to listen on PORT
- --worker-threads N (3) Sets the broker thread pool size
- --max-connections N (500) Sets the maximum allowed connections
- --connection-backlog N (10) Sets the connection backlog limit <span class="code-keyword">for</span> the
- server socket
- --staging-threshold N (5000000) Stages messages over N bytes to disk
- -m [ --mgmt-enable ] yes|no (1) Enable Management
- --mgmt-pub-interval SECONDS (10) Management Publish Interval
- --ack N (0) Send session.ack/solicit-ack at least every
- N frames. 0 disables voluntary ack/solitict
- -ack
-
-Daemon options:
- -d [ --daemon ] Run as a daemon.
- -w [ --wait ] SECONDS (10) Sets the maximum wait time to initialize the
- daemon. If the daemon fails to initialize, prints
- an error and returns 1
- -c [ --check ] Prints the daemon's process ID to stdout and
- returns 0 <span class="code-keyword">if</span> the daemon is running, otherwise
- returns 1
- -q [ --quit ] Tells the daemon to shut down
-Logging options:
- --log-output FILE (stderr) Send log output to FILE. FILE can be a file name
- or one of the special values:
- stderr, stdout, syslog
- -t [ --trace ] Enables all logging
- --log-enable RULE (error+) Enables logging <span class="code-keyword">for</span> selected levels and component
- s. RULE is in the form 'LEVEL+:PATTERN'
- Levels are one of:
- trace debug info notice warning error critical
- For example:
- '--log-enable warning+' logs all warning, error
- and critical messages.
- '--log-enable debug:framing' logs debug messages
- from the framing namespace. This option can be
- used multiple times
- --log-time yes|no (1) Include time in log messages
- --log-level yes|no (1) Include severity level in log messages
- --log-source yes|no (0) Include source file:line in log messages
- --log-thread yes|no (0) Include thread ID in log messages
- --log-function yes|no (0) Include function signature in log messages</pre> -</div></div> - -<h2><a name="RASC-Loadingextramodules"></a>Loading extra modules</h2> - -<p>By default the broker will load all the modules in the module directory, however it will NOT display options for modules that are not loaded. So to see the options for extra modules loaded you need to load the module and then add the help command like this:</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">./qpidd --load-module libbdbstore.so --help
-Usage: qpidd OPTIONS
-Options:
- -h [ --help ] Displays the help message
- -v [ --version ] Displays version information
- --config FILE (/etc/qpidd.conf) Reads configuration from FILE
-
-
- / .... non module options would be here ... /
-
-
-Store Options:
- --store-directory DIR Store directory location <span class="code-keyword">for</span> persistence (overrides
- --data-dir)
- --store-async yes|no (1) Use async persistence storage - <span class="code-keyword">if</span> store supports
- it, enables AIO O_DIRECT.
- --store-force yes|no (0) Force changing modes of store, will delete all
- existing data <span class="code-keyword">if</span> mode is changed. Be SURE you want
- to <span class="code-keyword">do</span> <span class="code-keyword">this</span>!
- --num-jfiles N (8) <span class="code-object">Number</span> of files in persistence journal
- --jfile-size-pgs N (24) Size of each journal file in multiples of read
- pages (1 read page = 64kiB)</pre> -</div></div> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/RC Multi-Platform Testing.html b/content/xdocs/RC Multi-Platform Testing.html deleted file mode 100755 index 690292a2b5..0000000000 --- a/content/xdocs/RC Multi-Platform Testing.html +++ /dev/null @@ -1,48 +0,0 @@ -<html> - <head> - <title>Apache Qpid : RC Multi-Platform Testing</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : RC Multi-Platform Testing - </span> - </div> - <div class="pagesubheading"> - This page last changed on Oct 19, 2006 by <font color="#0050B2">mmccorma</font>. - </div> - - <p>Any QPID release candidate should be tested on the following supported platforms:</p> - -<ul> - <li>Linux 2.6+</li> - <li>Windows XP 5+</li> - <li>Solaris 8 (SunOS 5.8)+</li> - <li>Cygwin v?</li> -</ul> - - -<p>It shall be a quality gateway for any RC that it must run successfully (define tests here ?) on all platforms supported. All scripts will run successfully on these platforms (*.sh on all unix/linux style OSs and *.bat on Windows).</p> - -<p>Multi-platform operability is a key attribute for QPID users and thus we must ensure that changes applied do not compromise this.</p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Release Plans.html b/content/xdocs/Release Plans.html deleted file mode 100755 index 42a7ee30ef..0000000000 --- a/content/xdocs/Release Plans.html +++ /dev/null @@ -1,46 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Release Plans</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Release Plans - </span> - </div> - <div class="pagesubheading"> - This page last changed on Oct 31, 2006 by <font color="#0050B2">mmccorma</font>. - </div> - - <p>Currently we have tentative plans for the following releases of the Qpid Java Broker & Client:</p> - -<p>M1 - November 2006</p> - -<p>The content for this release is available via our JIRA release notes:</p> - -<p><a href="https://issues.apache.org/jira/secure/ReleaseNote.jspa?version=12312115&styleName=Html&projectId=12310520" title="Visit page outside Confluence">https://issues.apache.org/jira/secure/ReleaseNote.jspa?version=12312115&styleName=Html&projectId=12310520</a></p> - -<p>M2 - December 2006</p> - -<p>Details of content tbc shortly. </p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Reliability Requirements.html b/content/xdocs/Reliability Requirements.html deleted file mode 100755 index 9cdf026009..0000000000 --- a/content/xdocs/Reliability Requirements.html +++ /dev/null @@ -1,96 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Reliability Requirements</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Reliability Requirements - </span> - </div> - <div class="pagesubheading"> - This page last changed on Jun 11, 2007 by <font color="#0050B2">aconway</font>. - </div> - - <h1><a name="ReliabilityRequirements-ReliabilityRequirements"></a>Reliability Requirements</h1> - - -<h2><a name="ReliabilityRequirements-Failover%28sessionstate%29"></a>Fail-over (session state)</h2> - -<p>A cluster member informs its clients of backup candidates for each session. It can update the list periodically.</p> - -<p>After an unexpected disconnect the client can connect to one of the candidates and resume its session transparently. All session state is preserved including:</p> -<ul> - <li>Open references</li> - <li>Active consumers</li> - <li>Commands-in-flight</li> - <li>Open transactions (question: Is there any value in fail-over that aborts TX and/or DTX transactions?)</li> -</ul> - - -<p>Sessions <em>do not</em> survive</p> -<ul> - <li>multiple failures that include the current node and all back-up nodes for that session.</li> - <li>shutdown/restart of the cluster.</li> -</ul> - - -<h2><a name="ReliabilityRequirements-ClusterRestart%28durableresources%29"></a>Cluster Restart (durable resources)</h2> - -<p>The AMQP entities that survive a restart are those defined by AMQP to survive broker restart. AMQP defines <em>durable</em> exchanges and queues and <em>persistent</em> messages. Some further definitions:</p> -<ul> - <li><em>durable</em> message: persistent messages on a durable queues.</li> - <li><em>durable</em> enque: act of enqueuing a persistent message on a durable queue.</li> - <li><em>durable</em> binding: binding between durable exchange and durable queue.</li> -</ul> - - -<p>The following are preserved if the entire cluster shuts down/crashes and is re-started:</p> -<ul> - <li><em>Durable</em> wiring: durable exchanges, queues and bindings.</li> - <li><em>Durable</em> messages</li> - <li><em>Prepared</em> DTX transactions</li> -</ul> - - -<p>The following do not survive a restart:</p> -<ul> - <li>Session state</li> - <li>Non-durable wiring</li> - <li>TX transactions are aborted.</li> - <li>Unprepared DTX transactions are aborted.</li> - <li>Non-durable effects of prepared DTX transactions are lost.</li> -</ul> - - -<h3><a name="ReliabilityRequirements-RestartingDTXTransactions"></a>Restarting DTX Transactions</h3> - -<p>On restart, prepared DTX transactions may commit or rollback. In either case the outcome is <em>as if</em> the transaction had comitted or rolled back just <em>before</em> the restart: All durable transaction effects survive the restart, all non-durable effects are lost.</p> - -<p>In particular</p> -<ul> - <li>On <b><em>commit</em></b><b>:</b> <em>non durable</em> messages enqueued in the transaction are <em>lost</em>, as if they had been enqueued before the restart and were lost in the restart.</li> - <li>On <b><em>rollback:</em></b> <em>non durable</em> messages dequeued in the transaction are <em>lost</em>, as if they had been put back on the queue before restart and then lost in the restart.</li> -</ul> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Restructuring Java Broker and Client Design_attachments/AMQ Frame handling b/content/xdocs/Restructuring Java Broker and Client Design_attachments/AMQ Frame handling deleted file mode 100755 index da5d22eb40..0000000000 --- a/content/xdocs/Restructuring Java Broker and Client Design_attachments/AMQ Frame handling +++ /dev/null @@ -1 +0,0 @@ -<stage keygen_seq="2"><pageObj stg="0" pb="0" gr="0" fill="16777215" height="754" width="576"><objects><object order="0" text-horizontal-pos="center" text-vertical-pos="middle" fixed-aspect="false" rot="0" height="329" width="446.95" y="278" x="339" shp_id="6" class="text_shape"><text><![CDATA[<P ALIGN="CENTER"><FONT FACE="Arial" SIZE="96" COLOR="#000000" LETTERSPACING="0" KERNING="0">A new <FONT COLOR="#6CCFF7">Gliffy </FONT>diagram</FONT></P>]]></text></object></objects></pageObj></stage>
\ No newline at end of file diff --git a/content/xdocs/Restructuring Java Broker and Client Design_attachments/ContentHandlerTree.jpg b/content/xdocs/Restructuring Java Broker and Client Design_attachments/ContentHandlerTree.jpg Binary files differdeleted file mode 100755 index 74a4d52c36..0000000000 --- a/content/xdocs/Restructuring Java Broker and Client Design_attachments/ContentHandlerTree.jpg +++ /dev/null diff --git a/content/xdocs/Restructuring Java Broker and Client Design_attachments/DispatchTree.jpg b/content/xdocs/Restructuring Java Broker and Client Design_attachments/DispatchTree.jpg Binary files differdeleted file mode 100755 index 2217045f51..0000000000 --- a/content/xdocs/Restructuring Java Broker and Client Design_attachments/DispatchTree.jpg +++ /dev/null diff --git a/content/xdocs/Restructuring Java Broker and Client Design_attachments/MethodHandlerTree.jpg b/content/xdocs/Restructuring Java Broker and Client Design_attachments/MethodHandlerTree.jpg Binary files differdeleted file mode 100755 index 442843f143..0000000000 --- a/content/xdocs/Restructuring Java Broker and Client Design_attachments/MethodHandlerTree.jpg +++ /dev/null diff --git a/content/xdocs/ReturnStdStringByValue.html b/content/xdocs/ReturnStdStringByValue.html deleted file mode 100755 index e393018fa9..0000000000 --- a/content/xdocs/ReturnStdStringByValue.html +++ /dev/null @@ -1,54 +0,0 @@ -<html> - <head> - <title>Apache Qpid : ReturnStdStringByValue</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : ReturnStdStringByValue - </span> - </div> - <div class="pagesubheading"> - This page last changed on Oct 19, 2006 by <font color="#0050B2">mmccorma</font>. - </div> - - <p>Don't do this: </p> -<div class="code"><div class="codeContent"> -<pre class="code-java">std::string& f();
-<span class="code-keyword">const</span> std::string& g(); <span class="code-comment">// Not much better</span></pre> -</div></div> -<p>Instead do this:</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">std::string f();
-std::string g();</pre> -</div></div> - -<p><tt>std::string</tt> is designed expressly to allow you to treat strings as simple pass-by-value types, like int. It's efficient to return by value rather than reference and it avoids core dumps if the real string hidden away in f gets deleted before the reference. In particular it allows f() to compute once-off values and forget about them, e.g.:</p> - -<div class="code"><div class="codeContent"> -<pre class="code-java">std::string hello(<span class="code-keyword">const</span> std::string& name) { <span class="code-keyword">return</span> <span class="code-quote">"hello "</span> + name; }</pre> -</div></div> - -<p>With the "&" style return this would be an immediate disaster as the returned reference is invalid before the caller even gets it! NB. The last example contains another error! See <a href="BewareOfStringPromotion.html" title="BewareOfStringPromotion">BewareOfStringPromotion</a>.</p> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/ScopedLocking.html b/content/xdocs/ScopedLocking.html deleted file mode 100755 index 95796e6f94..0000000000 --- a/content/xdocs/ScopedLocking.html +++ /dev/null @@ -1,52 +0,0 @@ -<html> - <head> - <title>Apache Qpid : ScopedLocking</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : ScopedLocking - </span> - </div> - <div class="pagesubheading"> - This page last changed on Oct 19, 2006 by <font color="#0050B2">mmccorma</font>. - </div> - - <p>Always use scoped lockers to lock mutexes and the like. Don't do this:</p> -<div class="preformatted"><div class="preformattedContent"> -<pre> lock.acquire();
- do_stuff(); // DANGER: lock never released if exception thrown here.
- lock.release();
-</pre> -</div></div> - -<p>Instead use a "scoped locker". This is simply a class that does the "acquire" in its constructor and the "release" in its destructor:</p> -<div class="preformatted"><div class="preformattedContent"> -<pre> Locker locker(lock);
- do_stuff();
-</pre> -</div></div> - -<p>Not only does this save a bit of typing, it guarantees that the lock will be released even if an exception is thrown, because C++ guarantees to call destructors of all local variables on exit from a scope. This also protects you forgetting to release the lock at every exit point from a function with multiple exit points - the compiler takes care of it for you. This technique applies more generally to any situation where you have to acquire and release resources. <tt>std::auto_ptr</tt> is a similar tool for memory management.</p> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Setup .Net Client on Windows.html b/content/xdocs/Setup .Net Client on Windows.html deleted file mode 100755 index 8bc6836130..0000000000 --- a/content/xdocs/Setup .Net Client on Windows.html +++ /dev/null @@ -1,50 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Setup .Net Client on Windows</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Setup .Net Client on Windows - </span> - </div> - <div class="pagesubheading"> - This page last changed on Aug 02, 2007 by <font color="#0050B2">ritchiem</font>. - </div> - - <h2><a name="Setup.NetClientonWindows-Setup"></a>Setup</h2> - -<p>Install:<br/> - Microsoft Visual Studio 2005 (VS2005)<br/> - NAnt 0.85 - only required for builds outside VS2005 (.net 1.1, .net 2.0, mono 2.0)<br/> - Ant 1.6.5<br/> - Cygwin (or alternatively build via cmd but alter instructions below accordingly)</p> - -<p>Set up PATH to include Nant.exe:</p> - -<p> $ PATH=/cygdrive/c/WINDOWS/Microsoft.NET/Framework/v2.0.50727:$PATH</p> - -<p>Set up PATH to include ant:</p> - -<p> $ PATH=$ANT_HOME/bin:$PATH</p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/SharedPtr.html b/content/xdocs/SharedPtr.html deleted file mode 100755 index 31effc4389..0000000000 --- a/content/xdocs/SharedPtr.html +++ /dev/null @@ -1,71 +0,0 @@ -<html> - <head> - <title>Apache Qpid : SharedPtr</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : SharedPtr - </span> - </div> - <div class="pagesubheading"> - This page last changed on Oct 19, 2006 by <font color="#0050B2">mmccorma</font>. - </div> - - <p>std::tr1::shared_ptr is an almost-standard smart pointer template that<br/> -provides unintrusive reference-counting semantics for any class. It<br/> -almost makes memory management too easy for a C++ programmer.</p> - -<p>It's available in g++ and some other compilers by default. There are<br/> -several open source implementations if we ever port to a compiler that<br/> -doesn't have it.</p> - -<p>The golde rule: if class Foo has shared ownership then never <em>ever</em><br/> -write <tt>Foo*</tt>. Anywhere. Ever. Use shared_ptr in all function<br/> -signatures and variables, use std::tr1::dynamic_pointer_cast and<br/> -friends for casting.</p> - -<p>Qpid will use it for all classes with shared ownership semantics,<br/> -enforced by private constructors and static factory functions. We'll<br/> -also adopt the convention to typedef shared_ptr within the class for<br/> -convenience. E.g.</p> - -<div class="code"><div class="codeContent"> -<pre class="code-java">class Foo {
- Foo() { ... }
-
- <span class="code-keyword">public</span>:
- typedef std::tr1::shared_ptr<Foo> shared_ptr;
- <span class="code-keyword">static</span> shared_ptr create() { <span class="code-keyword">return</span> <span class="code-keyword">new</span> Foo() }
- <span class="code-comment">// .. a create <span class="code-keyword">for</span> each constructor.
-</span>}
-
-Foo::shared_ptr p = Foo::create(); <span class="code-comment">// etc...</span></pre> -</div></div> - - -<p>There's a good article at <a href="http://www.boost.org/libs/smart_ptr/sp_techniques.html" title="Visit page outside Confluence">http://www.boost.org/libs/smart_ptr/sp_techniques.html</a>.</p> - - - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Source Repository.html b/content/xdocs/Source Repository.html deleted file mode 100755 index 71011d2d06..0000000000 --- a/content/xdocs/Source Repository.html +++ /dev/null @@ -1,63 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Source Repository</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Source Repository - </span> - </div> - <div class="pagesubheading"> - This page last changed on Jan 08, 2007 by <font color="#0050B2">cctrieloff</font>. - </div> - - <h2><a name="SourceRepository-WebBrowsingofSVN"></a>Web Browsing of SVN</h2> - -<p>To browse via the web use the ViewVC interface:</p> - -<p><a href="http://svn.apache.org/viewvc/incubator/qpid/trunk/qpid" title="Visit page outside Confluence">http://svn.apache.org/viewvc/incubator/qpid/trunk/qpid</a></p> - -<p>Or to browse the source tree directly:</p> - -<p><a href="https://svn.apache.org/repos/asf/incubator/qpid/trunk/qpid" title="Visit page outside Confluence">https://svn.apache.org/repos/asf/incubator/qpid/trunk/qpid</a></p> - -<h3><a name="SourceRepository-CheckingoutfromSVN"></a>Checking out from SVN</h3> - -<p>The source code can be checked out anonymous over HTTP by doign:</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">svn co http:<span class="code-comment">//svn.apache.org/repos/asf/incubator/qpid/trunk</span></pre> -</div></div> - -<p>Committers can check out the code over HTTPS:</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">svn co https:<span class="code-comment">//svn.apache.org/repos/asf/incubator/qpid/trunk</span></pre> -</div></div> - -<h2><a name="SourceRepository-Settingupyoursubversionclient"></a>Setting up your subversion client</h2> - -<p>When adding files to subversion, it's important that your subversion client is properly setup to the appropriate subversion properties are set. The client can do it automatically by modifying the auto-props section of the subversion config file. Use the contents of:</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">http:<span class="code-comment">//svn.apache.org/repos/asf/incubator/qpid/trunk/etc/svn-auto-props</span></pre> -</div></div> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Sustained Tests.html b/content/xdocs/Sustained Tests.html deleted file mode 100755 index 2e929f4207..0000000000 --- a/content/xdocs/Sustained Tests.html +++ /dev/null @@ -1,98 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Sustained Tests</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Sustained Tests - </span> - </div> - <div class="pagesubheading"> - This page last changed on Jun 27, 2007 by <font color="#0050B2">ritchiem</font>. - </div> - - <h2><a name="SustainedTests-Pub%2FSubSustainedTests"></a>Pub/Sub Sustained Tests</h2> - -<p>We currently have one sustained test for pub / sub messaging. The test is based on the interop testing framework and as such there are two classes that are involve.</p> - -<ol> - <li>org.apache.qpid.sustained.TestClient</li> - <li>org.apache.qpid.sustained.TestCoordinator</li> -</ol> - - -<p>As with the Interop Tests the Test Coordinator collects various clients to work on the specified test. The sustained test suit currently only has one test which is the SustainedTestClient. </p> - -<h3><a name="SustainedTests-SustainedTestClientTest"></a>SustainedTestClient Test</h3> - -<p>This test is a pub/sub test. There is a single publisher that sends batches of messages to a known topic. The clients then receive these messages and report the time required to retrive all of the batch. This reported time is sent to the publisher so that it can adjust its publication rate to ensure that messages are sent at a rate that all clients can maintain.</p> - -<h4><a name="SustainedTests-Usage"></a>Usage</h4> -<p>The coordinator can take a number of parameters.</p> - -<ul class="alternate" type="square"> - <li>numReceives (Default : 2)<br/> -This is the number of receivers each client node should create</li> - <li>batchSize (Default : 1000)<br/> -This is the number of messages to send per batch</li> - <li>ackMode (Default : 1 - AUTO_ACK )<br/> -The acknowledgement mode to use. Currently No_ack (257) appears not to work correctly.</li> -</ul> - - - -<p>The client can take the following system parameters (set via -D properties)<br/> -(These values should be moved to the Coordinator so that you do not need to guess which client will become the sender as these values are only of use to the sending client.)</p> - -<ul class="alternate" type="square"> - <li>sleepPerMessage (Default : false)<br/> -Divides the current _delay value into small sleeps between messages. Useful if your Thread.sleep implementation works at the nanosecond level. Under windows the smallest sleep value is around 10ms.</li> - <li>warmUpBatches (Default : 10)<br/> -Adjusts the number of batches sent before resetting the delay calculations.</li> - <li>stableReportCount (Default : 5)<br/> -The number of reports that need to arrive without changing the delay before reporting the delay is stable.</li> - <li>batchVariance (Default : 3)<br/> -The difference between the batch number sent and the received batch number.</li> -</ul> - - -<p>The client also has one additional parameter. </p> - -<ul class="alternate" type="square"> - <li>"-j" can be used to join an existing test run. Dispite there being only one test case at present this class must be provided as future sustained test classes may be available. -<div class="preformatted"><div class="preformattedContent"> -<pre>java -cp <qpid.jar> org.apache.qpid.sustained.TestClient -n client2 -j org.apache.qpid.performance.sustainedrate.SustainedTestClient
-</pre> -</div></div></li> -</ul> - - -<p>It is important to remember that each cilent must be uniquly named for the test to accurately work. This can be done by ensuring that all clients specify a unique "-n" value. So running</p> -<div class="preformatted"><div class="preformattedContent"> -<pre>java -cp <qpid.jar> org.apache.qpid.sustained.TestClient -n client2
-</pre> -</div></div> - -<p>Will correctly name the client 'client2' and attempt to joint the client to any running SustainedTestClient test. If there is no test running then the client will simply wait for the test to start.</p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Test Server 1.html b/content/xdocs/Test Server 1.html deleted file mode 100755 index 558a94d78e..0000000000 --- a/content/xdocs/Test Server 1.html +++ /dev/null @@ -1,100 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Test Server 1</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Test Server 1 - </span> - </div> - <div class="pagesubheading"> - This page last changed on Oct 30, 2006 by <font color="#0050B2">ritchiem</font>. - </div> - - <h2><a name="TestServer1-unamea"></a>uname -a</h2> -<div class="preformatted"><div class="preformattedContent"> -<pre>Linux amq01.XXXX.com 2.6.9-22.0.1.ELsmp #1 SMP Tue Oct 18 18:39:02 EDT 2005 x86_64 x86_64 x86_64 GNU/Linux
-</pre> -</div></div> - - -<h2><a name="TestServer1-cpuinfo"></a>cpuinfo</h2> -<p>8 times:</p> -<div class="preformatted"><div class="preformattedContent"> -<pre>vendor_id : AuthenticAMD
-cpu family : 15
-model : 33
-model name : AMD Opteron (tm) Processor 850
-stepping : 0
-cpu MHz : 2199.994
-cache size : 1024 KB
-physical id : 0
-siblings : 2
-core id : 0
-cpu cores : 2
-fpu : yes
-fpu_exception : yes
-cpuid level : 1
-wp : yes
-flags : fpu vme de pse tsc msr pae mce cx8 apic sep mtrr pge mca cmov pat pse36 clflush mmx fxsr sse sse2 ht syscall nx mmxext lm 3dnowext 3dnow pni fid
-bogomips : 4325.37
-TLB size : 1088 4K pages
-clflush size : 64
-cache_alignment : 64
-address sizes : 40 bits physical, 48 bits virtual
-power management: ts fid vid ttp
-
-</pre> -</div></div> - -<h2><a name="TestServer1-meminfo"></a>meminfo</h2> -<div class="preformatted"><div class="preformattedContent"> -<pre>MemTotal: 32752424 kB
-MemFree: 12768520 kB
-Buffers: 108600 kB
-Cached: 6014696 kB
-SwapCached: 88572 kB
-Active: 10993568 kB
-Inactive: 5376292 kB
-HighTotal: 0 kB
-HighFree: 0 kB
-LowTotal: 32752424 kB
-LowFree: 12768520 kB
-SwapTotal: 4192956 kB
-SwapFree: 3818360 kB
-Dirty: 764 kB
-Writeback: 0 kB
-Mapped: 10247920 kB
-Slab: 403688 kB
-Committed_AS: 19979696 kB
-PageTables: 31164 kB
-VmallocTotal: 536870911 kB
-VmallocUsed: 3060 kB
-VmallocChunk: 536867383 kB
-HugePages_Total: 1536
-HugePages_Free: 1536
-Hugepagesize: 2048 kB
-</pre> -</div></div> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Test Server 2.html b/content/xdocs/Test Server 2.html deleted file mode 100755 index fb18e8da43..0000000000 --- a/content/xdocs/Test Server 2.html +++ /dev/null @@ -1,98 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Test Server 2</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Test Server 2 - </span> - </div> - <div class="pagesubheading"> - This page last changed on Oct 30, 2006 by <font color="#0050B2">ritchiem</font>. - </div> - - <h2><a name="TestServer2-unamea"></a>uname -a</h2> -<div class="preformatted"><div class="preformattedContent"> -<pre>Linux cc01.XXX.com 2.4.21-15.0.4.ELhugemem #1 SMP Sat Jul 31 01:16:24 EDT 2004 i686 athlon i386 GNU/Linux
-
-</pre> -</div></div> - -<h2><a name="TestServer2-cpuinfo"></a>cpuinfo</h2> -<p>4 times:</p> -<div class="preformatted"><div class="preformattedContent"> -<pre>vendor_id : AuthenticAMD
-cpu family : 15
-model : 5
-model name : AMD Opteron(tm) Processor 852
-stepping : 1
-cpu MHz : 2592.647
-cache size : 1024 KB
-physical id : 0
-siblings : 1
-runqueue : 3
-fdiv_bug : no
-hlt_bug : no
-f00f_bug : no
-coma_bug : no
-fpu : yes
-fpu_exception : yes
-cpuid level : 1
-wp : yes
-flags : fpu vme de pse tsc msr pae mce cx8 apic sep mtrr pge mca cmov pat pse36 clflush mmx fxsr sse sse2 syscall mmxext lm 3dnowext 3dnow
-bogomips : 5177.34
-
-</pre> -</div></div> - -<h2><a name="TestServer2-meminfo"></a>meminfo</h2> -<div class="preformatted"><div class="preformattedContent"> -<pre> total: used: free: shared: buffers: cached:
-Mem: 16854679552 11465375744 5389303808 0 208089088 8931819520
-Swap: 2146689024 0 2146689024
-MemTotal: 16459648 kB
-MemFree: 5262992 kB
-MemShared: 0 kB
-Buffers: 203212 kB
-Cached: 8722480 kB
-SwapCached: 0 kB
-Active: 6059460 kB
-ActiveAnon: 268656 kB
-ActiveCache: 5790804 kB
-Inact_dirty: 2544200 kB
-Inact_laundry: 1869136 kB
-Inact_clean: 132 kB
-Inact_target: 2094584 kB
-HighTotal: 12680640 kB
-HighFree: 3630216 kB
-LowTotal: 3779008 kB
-LowFree: 1632776 kB
-SwapTotal: 2096376 kB
-SwapFree: 2096376 kB
-HugePages_Total: 0
-HugePages_Free: 0
-Hugepagesize: 2048 kB
-</pre> -</div></div> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/The AMQP Distributed Transaction Classes.html b/content/xdocs/The AMQP Distributed Transaction Classes.html deleted file mode 100755 index ef548e7443..0000000000 --- a/content/xdocs/The AMQP Distributed Transaction Classes.html +++ /dev/null @@ -1,83 +0,0 @@ -<html> - <head> - <title>Apache Qpid : The AMQP Distributed Transaction Classes</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : The AMQP Distributed Transaction Classes - </span> - </div> - <div class="pagesubheading"> - This page last changed on May 31, 2007 by <font color="#0050B2">cctrieloff</font>. - </div> - - <p>The distributed transaction classes provide support for the X-Open XA architecture. The dtx-demarcation class is used to demarcate transaction boundaries on a given channel that is subsequently used to perform AMQP native transactional work (produce publish messages). Transaction coordination and recovery operations are provided by the dtx-coordination class.</p> - -<p>A Transaction Manager uses RM Client XA interface to demarcate transaction boundaries and coordinate transaction outcomes. RM Clients use the dtx-demarcation class to associate transactional work with a transactional channel. The transactional channel is exposed to the application driving the transaction. The application can then use the transactional channel to transactionally produce and consume messages. RM clients use dtx-coordination to propagate transaction outcomes and recovery operations to the AMQP broker. A second coordination channel can be used for that purpose.</p> - -<p>More details about can be found at:</p> -<ul class="alternate" type="square"> - <li><a href="https://wiki.108.redhat.com/wiki/index.php/AMQP:Transaction_SIG_dtx_XML" title="Visit page outside Confluence">https://wiki.108.redhat.com/wiki/index.php/AMQP:Transaction_SIG_dtx_XML</a></li> - <li><a href="http://cwiki.apache.org/confluence/download/attachments/55787/dtx-classes-specification-document-v1.2.pdf" title="Visit page outside Confluence">http://cwiki.apache.org/confluence/download/attachments/55787/dtx-classes-specification-document-v1.2.pdf</a></li> - <li><a href="http://cwiki.apache.org/confluence/download/attachments/55787/dtx-classes-presentation-v0.10-PMC-03142007.pdf" title="Visit page outside Confluence">http://cwiki.apache.org/confluence/download/attachments/55787/dtx-classes-presentation-v0.10-PMC-03142007.pdf</a></li> -</ul> - - -<h2><a name="TheAMQPDistributedTransactionClasses-TheQpidImplementation"></a>The Qpid Implementation </h2> -<p>As shown on the following class diagram, there are two protocol specific dtx classes, that is to say DtxDemarcation and DtxCoordination that are highlighted in yellow.</p> - -<p><img src="The AMQP Distributed Transaction Classes_attachments/12358547_thumb_dtx.gif" align="absmiddle" border="0" /></p> - - -<h3><a name="TheAMQPDistributedTransactionClasses-DtxDemarcation"></a>DtxDemarcation</h3> -<p>DtxDemarcation interacts with the corresponding AMQChannel. The operation select creates the corresponding TransactionalContext (a channel has by default a non-transactional context). The operations start and end associate and disassociate a provided xid with the current TransactionalContext that percolates the call to the TransactionManager (operations begin and end respectively). Note that the operation end is responsible for acknowledging the messages against the context i.e. those messages are seen as being consumed under the currently associated xid.</p> - -<h3><a name="TheAMQPDistributedTransactionClasses-DtxCoordination"></a>DtxCoordination</h3> -<p>DtxCoordination directly interacts with the TransactionManager. Note that it is a requirement that the operation end is called on all involved channels (i.e. all the acknowledged messages have been specifically consumed under the provided xid).</p> - -<h3><a name="TheAMQPDistributedTransactionClasses-TransactionalContext"></a>TransactionalContext</h3> -<p>There are three flavours of TransactionalContext: the non transactional one, the local and distributed ones. The distributed and local contexts are very similar and both extend the abstract context. Note that the distributed context does not implement commit and rollback as this is DtxCoordination that is responsible for deciding of a transaction outcome.</p> - -<h3><a name="TheAMQPDistributedTransactionClasses-TransactionManagerandMessageStore"></a>TransactionManager and MessageStore</h3> -<p>Transaction manager and message store are linked as the message store may need to add transaction records to the transaction identified by a given xid. Moreover, the transaction manager may need to use the transactional facilities of the underlying store. This is the case of the JDBCStore and JDBCTransactionManager. The JDBCTransactionManager uses the transaction facilities of the JDBCStore for performing ACID operations during prepare and commit.</p> - -<p>This is the responsibility of the MessageStore to recover queues and exchanges and messages. Note that the JDBCTransactionManager delegates the responsibility of getting the list of in-doubt transactions to the JDBCStore but another implementation of TransactionManager may handle that directly.<br/> -The MessageStore implementation should not load the messages in memory during recovery but only set the messageID. The message header, publish info and payload are lazily loaded. Note that the message payloads are currently loaded in memory. We can however easily implement a direct streaming of message payload on the wire (The MessageStore interface can be extended for supporting that).</p> - - <br/> - <div class="tabletitle"> - <a name="attachments">Attachments:</a> - </div> - - <div class="greybox" align="left"> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="The AMQP Distributed Transaction Classes_attachments/dtx-classes-presentation-v0.10-PMC-03142007.pdf">dtx-classes-presentation-v0.10-PMC-03142007.pdf</a> (application/pdf) - <br/> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="The AMQP Distributed Transaction Classes_attachments/dtx-classes-specification-document-v1.2.pdf">dtx-classes-specification-document-v1.2.pdf</a> (application/pdf) - <br/> - <img src="icons/bullet_blue.gif" height="8" width="8" alt=""/> - <a href="The AMQP Distributed Transaction Classes_attachments/12358547_thumb_dtx.gif">12358547_thumb_dtx.gif</a> (image/gif) - <br/> - </div> - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/The AMQP Distributed Transaction Classes_attachments/12358547_thumb_dtx.gif b/content/xdocs/The AMQP Distributed Transaction Classes_attachments/12358547_thumb_dtx.gif Binary files differdeleted file mode 100755 index e4907ff6e7..0000000000 --- a/content/xdocs/The AMQP Distributed Transaction Classes_attachments/12358547_thumb_dtx.gif +++ /dev/null diff --git a/content/xdocs/The AMQP Distributed Transaction Classes_attachments/dtx-classes-presentation-v0.10-PMC-03142007.pdf b/content/xdocs/The AMQP Distributed Transaction Classes_attachments/dtx-classes-presentation-v0.10-PMC-03142007.pdf Binary files differdeleted file mode 100755 index 811f941b6d..0000000000 --- a/content/xdocs/The AMQP Distributed Transaction Classes_attachments/dtx-classes-presentation-v0.10-PMC-03142007.pdf +++ /dev/null diff --git a/content/xdocs/The AMQP Distributed Transaction Classes_attachments/dtx-classes-specification-document-v1.2.pdf b/content/xdocs/The AMQP Distributed Transaction Classes_attachments/dtx-classes-specification-document-v1.2.pdf Binary files differdeleted file mode 100755 index 1fa4d0e638..0000000000 --- a/content/xdocs/The AMQP Distributed Transaction Classes_attachments/dtx-classes-specification-document-v1.2.pdf +++ /dev/null diff --git a/content/xdocs/Topic Test.html b/content/xdocs/Topic Test.html deleted file mode 100755 index bcaf3399bf..0000000000 --- a/content/xdocs/Topic Test.html +++ /dev/null @@ -1,109 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Topic Test</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Topic Test - </span> - </div> - <div class="pagesubheading"> - This page last changed on Oct 30, 2006 by <font color="#0050B2">ritchiem</font>. - </div> - - <h2><a name="TopicTest-TopicTest"></a>Topic Test</h2> - -<p>This test is tests the time taken for a publisher to send out <em>m</em> messages, to <em>l</em> (ell) listeners and gather their responses. The average time to receive the report from the listeners is displayed at the end of the run. Additional runs or batches can be performed with the average value being displayed at the end of the run.</p> - -<h4><a name="TopicTest-Configuration"></a>Configuration</h4> - -<p>The standard configuration for this test is to use the following:</p> - -<ul> - <li>10 Clients</li> - <li>20 Batches</li> - <li>10,000 Messages</li> -</ul> - - -<p>The broker is setup and run on a seperate box(<a href="Test Server 1.html" title="Test Server 1">b1</a>) connected via Gigabit ethernet. The 10 listeners and the publisher were all run on the same box (<a href="Test Server 2.html" title="Test Server 2">c2</a>)</p> - -<h4><a name="TopicTest-Commandlines"></a>Command lines</h4> - -<p><b>Broker</b></p> -<div class="preformatted"><div class="preformattedContent"> -<pre>./qpid-server -c `pwd`/../etc/config-5670-MMS.xml -l ../etc/log4j.off.xml
-</pre> -</div></div> - -<p><b>Listeners</b></p> -<div class="preformatted"><div class="preformattedContent"> -<pre>./topicListener -host <host>
-</pre> -</div></div> -<p>equivalent to</p> -<div class="preformatted"><div class="preformattedContent"> -<pre> ./run_many.sh 10 lists 'java -server -Dlog4j.configuration=file://`pwd`/../etc/log4j.off.xml -Xmx256m org.apache.qpid.topic.Listener -host <host> -messages 10000'
-</pre> -</div></div> - - -<p><b>Publisher</b></p> -<div class="preformatted"><div class="preformattedContent"> -<pre>./topicPublisher -host <host> -messages 10000 -batch 20 -clients 10
-</pre> -</div></div> -<p>equivalent to</p> -<div class="preformatted"><div class="preformattedContent"> -<pre>java -server -Dlog4j.configuration=file://`pwd`/../etc/log4j.off.xml -Xmx256m org.apache.qpid.topic.Publisher -host <host> -messages 10000 -batch 20 -clients 10
-</pre> -</div></div> - -<h4><a name="TopicTest-TopicTestResults"></a>Topic Test Results</h4> -<p>For Server list see main <a href="Qpid Testing.html" title="Qpid Testing">Qpid Testing</a> page.</p> - -<p><ins>r466127</ins></p> -<table class='confluenceTable'><tbody> -<tr> -<th class='confluenceTh'>Servers</th> -<th class='confluenceTh'>Run</th> -<th class='confluenceTh'>Timings</th> -</tr> -<tr> -<td class='confluenceTd'>b1,c2</td> -<td class='confluenceTd'><b>r1</b></td> -<td class='confluenceTd'>min: 1527, max: 8397 avg: 1491</td> -</tr> -<tr> -<td class='confluenceTd'>b1,c2</td> -<td class='confluenceTd'><b>r2</b></td> -<td class='confluenceTd'>min: 1462, max: 7876 avg: 1472</td> -</tr> -<tr> -<td class='confluenceTd'>b1,c2</td> -<td class='confluenceTd'><b>r3</b></td> -<td class='confluenceTd'>min: 1491, max: 8234 avg: 1494</td> -</tr> -</tbody></table> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/URL Formats.html b/content/xdocs/URL Formats.html deleted file mode 100755 index b2216c5913..0000000000 --- a/content/xdocs/URL Formats.html +++ /dev/null @@ -1,43 +0,0 @@ -<html> - <head> - <title>Apache Qpid : URL Formats</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : URL Formats - </span> - </div> - <div class="pagesubheading"> - This page last changed on Apr 02, 2008 by <font color="#0050B2">asimon</font>. - </div> - - <h2><a name="URLFormats-URLFormatforconnectionsandbinding"></a>URL Format for connections and binding </h2> -<p>There are currently two formats implemented in the Java code base. One is for connection and the other is an exchange binding URL. The URL formats have been designed around the Java URI format. This allows the parsing majority of the parsing work to be handled for us.</p> - -<ul> - <li><a href="Connection URL Format.html" title="Connection URL Format">Connection URL Format</a> - The format used to describe a connection.</li> - <li><a href="BindingURLFormat.html" title="BindingURLFormat">BindingURLFormat</a> - The format used for creating bindings within and to a broker.</li> -</ul> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Useful Links.html b/content/xdocs/Useful Links.html deleted file mode 100755 index ab70509a40..0000000000 --- a/content/xdocs/Useful Links.html +++ /dev/null @@ -1,38 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Useful Links</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Useful Links - </span> - </div> - <div class="pagesubheading"> - This page last changed on Oct 19, 2006 by <font color="#0050B2">mmccorma</font>. - </div> - - <h1><a name="UsefulLinks-Purpose"></a>Purpose </h1> - -<p>Links to related projects/useful stuff for developers</p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Using Qpid with other JNDI Providers.html b/content/xdocs/Using Qpid with other JNDI Providers.html deleted file mode 100755 index 0b46fc3a3a..0000000000 --- a/content/xdocs/Using Qpid with other JNDI Providers.html +++ /dev/null @@ -1,137 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Using Qpid with other JNDI Providers</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Using Qpid with other JNDI Providers - </span> - </div> - <div class="pagesubheading"> - This page last changed on Jun 22, 2007 by <font color="#0050B2">ritchiem</font>. - </div> - - -<h2><a name="UsingQpidwithotherJNDIProviders-HowtouseaJNDIProvider"></a>How to use a JNDI Provider</h2> - -<p>Qpid will work with any JNDI provider capable of storing Java objects. We have a task to add our own initial context factory, but until that's available ....</p> - -<p>First you must select a JNDI provider to use. If you aren't already using an application server (i.e. Tomcat ?) which provides JNDI support you could consider using either:</p> -<ul> - <li>Apache's <a href="http://directory.apache.org/subprojects/apacheds/index.html" title="Visit page outside Confluence">Directory</a> which provides an LDAP JNDI implementation</li> -</ul> - - -<ul> - <li>OR the SUN JNDI SPI for the FileSystem which can be downloaded from <a href="http://java.sun.com/products/jndi/downloads/index.html" title="Visit page outside Confluence">http://java.sun.com/products/jndi/downloads/index.html</a></li> -</ul> - - -<ul class="alternate" type="square"> - <li>Click : Download JNDI 1.2.1 & More button</li> - <li>Download: File System Service Provider, 1.2 Beta 3</li> - <li>and then add the two jars in the lib dir to your class path.</li> -</ul> - - -<p>There are two steps to using JNDI objects.</p> -<ul class="alternate" type="square"> - <li>Bind : Which stores a reference to a JMS Object in the provider.</li> - <li>Lookup : Which tries to retrieve the reference and create the JMS Object.</li> -</ul> - - -<p>There are two objects that would normally be stored in JNDI.</p> -<ul class="alternate" type="square"> - <li>A ConnectionFactory</li> - <li>A Destination (Queue or Topic)</li> -</ul> - - -<h3><a name="UsingQpidwithotherJNDIProviders-Binding"></a>Binding</h3> - -<p>Then you need to setup the values that the JNDI provider will used to bind your references, something like this:</p> -<div class="code" style="border-style: solid; "><div class="codeHeader" style="border-bottom-style: solid; "><b>Setup JNDI</b></div><div class="codeContent"> -<pre class="code-java">Hashtable env = <span class="code-keyword">new</span> Hashtable(11);
- env.put(Context.INITIAL_CONTEXT_FACTORY,<span class="code-quote">"com.sun.jndi.fscontext.RefFSContextFactory"</span>);
- env.put(Context.PROVIDER_URL,LOCAL_FILE_PATH_FOR_STORING_BINDS_PATH_MUST_EXIST);</pre> -</div></div> -<p>These values are then used to create a context to bind your references.</p> -<div class="code" style="border-style: solid; "><div class="codeHeader" style="border-bottom-style: solid; "><b>Perform Binding of ConnectionFactory</b></div><div class="codeContent"> -<pre class="code-java"><span class="code-keyword">try</span>
-{
- Context ctx = <span class="code-keyword">new</span> InitialContext(env);
-
- <span class="code-comment">// Create the object to be bound in <span class="code-keyword">this</span> <span class="code-keyword">case</span> a ConnectionFactory
-</span> ConnectionFactory factory = <span class="code-keyword">null</span>;
-
- <span class="code-keyword">try</span>
- {
- factory = <span class="code-keyword">new</span> AMQConnectionFactory(CONNECTION_URL);
- <span class="code-keyword">try</span>
- {
- ctx.bind(binding, factory);
- }
- <span class="code-keyword">catch</span> (NamingException e)
- {
- <span class="code-comment">//Handle problems with binding. Such as the binding already exists.
-</span> }
- }
- <span class="code-keyword">catch</span> (URLSyntaxException amqe)
- {
- <span class="code-comment">//Handle any exception with creating ConnnectionFactory
-</span> }
-}
-<span class="code-keyword">catch</span> (NamingException e)
-{
- <span class="code-comment">//Handle problem creating the Context.
-</span>}</pre> -</div></div> -<p>To bind a queue instead simply create a AMQQueue object and use that in the binding call.</p> -<div class="code" style="border-style: solid; "><div class="codeHeader" style="border-bottom-style: solid; "><b>Bind a AMQQueue</b></div><div class="codeContent"> -<pre class="code-java">AMQQueue queue = <span class="code-keyword">new</span> AMQQueue(QUEUE_URL);
-ctx.bind(binding, queue);</pre> -</div></div> - -<h3><a name="UsingQpidwithotherJNDIProviders-Lookup"></a>Lookup</h3> - -<p>You can then get a queue connection factory from the JNDI context.</p> -<div class="code" style="border-style: solid; "><div class="codeHeader" style="border-bottom-style: solid; "><b>Perform Binding of ConnectionFactory</b></div><div class="codeContent"> -<pre class="code-java">ConnectionFactory factory;
-<span class="code-keyword">try</span>
-{
- factory= (ConnectionFactory)ctx.lookup(binding);
-}
-<span class="code-keyword">catch</span> (NamingException e)
-{
- <span class="code-comment">//Handle problems with lookup. Such as binding does not exist.
-</span>}</pre> -</div></div> -<p>Note that you need not cast the bound object back to an <tt>AMQConnectionFactory</tt> so all your current JMS apps that use JNDI can start using Qpid straight away.</p> - - -<h2><a name="UsingQpidwithotherJNDIProviders-HowtocreateaTopicConnectionFactoryandQueueConnectionFactory"></a>How to create a TopicConnectionFactory and QueueConnectionFactory</h2> - -<p>AMQConnectionFactory implements TopicConnectionFactory and QueueConnectionFactory as well as the ConnectionFactory.</p> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/ValgrindBadSuppressions.html b/content/xdocs/ValgrindBadSuppressions.html deleted file mode 100755 index d7c8221b47..0000000000 --- a/content/xdocs/ValgrindBadSuppressions.html +++ /dev/null @@ -1,61 +0,0 @@ -<html> - <head> - <title>Apache Qpid : ValgrindBadSuppressions</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : ValgrindBadSuppressions - </span> - </div> - <div class="pagesubheading"> - This page last changed on Mar 28, 2007 by <font color="#0050B2">aconway</font>. - </div> - - <p>(Observed with valgrind 3.2.1, fixed in 3.2.3)<br/> -Valgrind 3.2.1 sometimes produces supressions that don't work, like this:</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">{
- <insert a suppression name here>
- Memcheck:Free
- fun:_vgrZU_libcZdsoZa_free
- fun:main
-}</pre> -</div></div> -<p>The identifying characteristic is that they begin with fun:_vg<something></p> - -<p><a href="http://article.gmane.org/gmane.comp.debugging.valgrind/5939" title="Visit page outside Confluence">http://article.gmane.org/gmane.comp.debugging.valgrind/5939</a> explains what these symbols are.</p> - -<p>The workaround is to replace fun:<em>vg*_lib*</em><something> with fun:<something>, where something<br/> -should be a valid C or C++ mangled symbol.</p> - -<p>The following test program demonstrates the problem</p> -<div class="code"><div class="codeContent"> -<pre class="code-java">#include <stdlib.h>
-<span class="code-object">int</span> main(<span class="code-object">int</span> argc,<span class="code-object">char</span>**argv) {
- <span class="code-object">char</span>*p = malloc(10);
- free(p);
- free(p);
-}</pre> -</div></div> - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/Weekly QPID Developer Meetings.html b/content/xdocs/Weekly QPID Developer Meetings.html deleted file mode 100755 index 692fab8ead..0000000000 --- a/content/xdocs/Weekly QPID Developer Meetings.html +++ /dev/null @@ -1,36 +0,0 @@ -<html> - <head> - <title>Apache Qpid : Weekly QPID Developer Meetings</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : Weekly QPID Developer Meetings - </span> - </div> - <div class="pagesubheading"> - This page last changed on Mar 28, 2008 by <font color="#0050B2">godfrer</font>. - </div> - - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/add.gif b/content/xdocs/add.gif Binary files differdeleted file mode 100755 index 252d7ebcb8..0000000000 --- a/content/xdocs/add.gif +++ /dev/null diff --git a/content/xdocs/border/border_bottom.gif b/content/xdocs/border/border_bottom.gif Binary files differdeleted file mode 100755 index b93012ac2a..0000000000 --- a/content/xdocs/border/border_bottom.gif +++ /dev/null diff --git a/content/xdocs/border/spacer.gif b/content/xdocs/border/spacer.gif Binary files differdeleted file mode 100755 index fc2560981e..0000000000 --- a/content/xdocs/border/spacer.gif +++ /dev/null diff --git a/content/xdocs/icons/blogentry_16.gif b/content/xdocs/icons/blogentry_16.gif Binary files differdeleted file mode 100755 index 83d600d097..0000000000 --- a/content/xdocs/icons/blogentry_16.gif +++ /dev/null diff --git a/content/xdocs/icons/bullet_blue.gif b/content/xdocs/icons/bullet_blue.gif Binary files differdeleted file mode 100755 index 25bfa0cf2b..0000000000 --- a/content/xdocs/icons/bullet_blue.gif +++ /dev/null diff --git a/content/xdocs/icons/comment_16.gif b/content/xdocs/icons/comment_16.gif Binary files differdeleted file mode 100755 index 6f76e86bd7..0000000000 --- a/content/xdocs/icons/comment_16.gif +++ /dev/null diff --git a/content/xdocs/icons/emoticons/add.gif b/content/xdocs/icons/emoticons/add.gif Binary files differdeleted file mode 100755 index 0c00fe0d49..0000000000 --- a/content/xdocs/icons/emoticons/add.gif +++ /dev/null diff --git a/content/xdocs/icons/emoticons/biggrin.gif b/content/xdocs/icons/emoticons/biggrin.gif Binary files differdeleted file mode 100755 index ad04031985..0000000000 --- a/content/xdocs/icons/emoticons/biggrin.gif +++ /dev/null diff --git a/content/xdocs/icons/emoticons/check.gif b/content/xdocs/icons/emoticons/check.gif Binary files differdeleted file mode 100755 index 28bb99943f..0000000000 --- a/content/xdocs/icons/emoticons/check.gif +++ /dev/null diff --git a/content/xdocs/icons/emoticons/error.gif b/content/xdocs/icons/emoticons/error.gif Binary files differdeleted file mode 100755 index 6d68a8cc0b..0000000000 --- a/content/xdocs/icons/emoticons/error.gif +++ /dev/null diff --git a/content/xdocs/icons/emoticons/forbidden.gif b/content/xdocs/icons/emoticons/forbidden.gif Binary files differdeleted file mode 100755 index c6acdec605..0000000000 --- a/content/xdocs/icons/emoticons/forbidden.gif +++ /dev/null diff --git a/content/xdocs/icons/emoticons/help_16.gif b/content/xdocs/icons/emoticons/help_16.gif Binary files differdeleted file mode 100755 index 83387c25c6..0000000000 --- a/content/xdocs/icons/emoticons/help_16.gif +++ /dev/null diff --git a/content/xdocs/icons/emoticons/information.gif b/content/xdocs/icons/emoticons/information.gif Binary files differdeleted file mode 100755 index 072ab660fa..0000000000 --- a/content/xdocs/icons/emoticons/information.gif +++ /dev/null diff --git a/content/xdocs/icons/emoticons/lightbulb.gif b/content/xdocs/icons/emoticons/lightbulb.gif Binary files differdeleted file mode 100755 index cd72409a47..0000000000 --- a/content/xdocs/icons/emoticons/lightbulb.gif +++ /dev/null diff --git a/content/xdocs/icons/emoticons/lightbulb_on.gif b/content/xdocs/icons/emoticons/lightbulb_on.gif Binary files differdeleted file mode 100755 index 3768ef7d12..0000000000 --- a/content/xdocs/icons/emoticons/lightbulb_on.gif +++ /dev/null diff --git a/content/xdocs/icons/emoticons/sad.gif b/content/xdocs/icons/emoticons/sad.gif Binary files differdeleted file mode 100755 index 6aca31070f..0000000000 --- a/content/xdocs/icons/emoticons/sad.gif +++ /dev/null diff --git a/content/xdocs/icons/emoticons/smile.gif b/content/xdocs/icons/emoticons/smile.gif Binary files differdeleted file mode 100755 index f8dc2782a0..0000000000 --- a/content/xdocs/icons/emoticons/smile.gif +++ /dev/null diff --git a/content/xdocs/icons/emoticons/star_blue.gif b/content/xdocs/icons/emoticons/star_blue.gif Binary files differdeleted file mode 100755 index 9b366cebeb..0000000000 --- a/content/xdocs/icons/emoticons/star_blue.gif +++ /dev/null diff --git a/content/xdocs/icons/emoticons/star_green.gif b/content/xdocs/icons/emoticons/star_green.gif Binary files differdeleted file mode 100755 index 42d27ec7e8..0000000000 --- a/content/xdocs/icons/emoticons/star_green.gif +++ /dev/null diff --git a/content/xdocs/icons/emoticons/star_red.gif b/content/xdocs/icons/emoticons/star_red.gif Binary files differdeleted file mode 100755 index c10acb9f7d..0000000000 --- a/content/xdocs/icons/emoticons/star_red.gif +++ /dev/null diff --git a/content/xdocs/icons/emoticons/star_yellow.gif b/content/xdocs/icons/emoticons/star_yellow.gif Binary files differdeleted file mode 100755 index 0f1d151a32..0000000000 --- a/content/xdocs/icons/emoticons/star_yellow.gif +++ /dev/null diff --git a/content/xdocs/icons/emoticons/thumbs_down.gif b/content/xdocs/icons/emoticons/thumbs_down.gif Binary files differdeleted file mode 100755 index 855c748864..0000000000 --- a/content/xdocs/icons/emoticons/thumbs_down.gif +++ /dev/null diff --git a/content/xdocs/icons/emoticons/thumbs_up.gif b/content/xdocs/icons/emoticons/thumbs_up.gif Binary files differdeleted file mode 100755 index 7c55feebd8..0000000000 --- a/content/xdocs/icons/emoticons/thumbs_up.gif +++ /dev/null diff --git a/content/xdocs/icons/emoticons/tongue.gif b/content/xdocs/icons/emoticons/tongue.gif Binary files differdeleted file mode 100755 index fe77df2fa2..0000000000 --- a/content/xdocs/icons/emoticons/tongue.gif +++ /dev/null diff --git a/content/xdocs/icons/emoticons/warning.gif b/content/xdocs/icons/emoticons/warning.gif Binary files differdeleted file mode 100755 index 1c9883b8f7..0000000000 --- a/content/xdocs/icons/emoticons/warning.gif +++ /dev/null diff --git a/content/xdocs/icons/emoticons/wink.gif b/content/xdocs/icons/emoticons/wink.gif Binary files differdeleted file mode 100755 index 24bdea9605..0000000000 --- a/content/xdocs/icons/emoticons/wink.gif +++ /dev/null diff --git a/content/xdocs/icons/home_16.gif b/content/xdocs/icons/home_16.gif Binary files differdeleted file mode 100755 index 7a902b1be9..0000000000 --- a/content/xdocs/icons/home_16.gif +++ /dev/null diff --git a/content/xdocs/icons/linkext7.gif b/content/xdocs/icons/linkext7.gif Binary files differdeleted file mode 100755 index f2dd2dcfa9..0000000000 --- a/content/xdocs/icons/linkext7.gif +++ /dev/null diff --git a/content/xdocs/icons/mail_16.gif b/content/xdocs/icons/mail_16.gif Binary files differdeleted file mode 100755 index 0386c0d105..0000000000 --- a/content/xdocs/icons/mail_16.gif +++ /dev/null diff --git a/content/xdocs/icons/mail_small.gif b/content/xdocs/icons/mail_small.gif Binary files differdeleted file mode 100755 index a3b7d9f06f..0000000000 --- a/content/xdocs/icons/mail_small.gif +++ /dev/null diff --git a/content/xdocs/icons/user_12.gif b/content/xdocs/icons/user_12.gif Binary files differdeleted file mode 100755 index d41511f1b8..0000000000 --- a/content/xdocs/icons/user_12.gif +++ /dev/null diff --git a/content/xdocs/icons/user_16.gif b/content/xdocs/icons/user_16.gif Binary files differdeleted file mode 100755 index f5a2fb6a3a..0000000000 --- a/content/xdocs/icons/user_16.gif +++ /dev/null diff --git a/content/xdocs/index.html b/content/xdocs/index.html deleted file mode 100755 index 5c53f3ddcf..0000000000 --- a/content/xdocs/index.html +++ /dev/null @@ -1,709 +0,0 @@ - - -<html> - <head> - <title>qpid (Apache Qpid) Test</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <center> - <h1><font color="#0050B2">Space Details:</font></h1> - </center> - <table class="grid" border="1" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td width="200"> - <b>Key:</b> - </td> - <td>qpid</td> - </tr> - <tr> - <td width="200"> - <b>Name:</b> - </td> - <td>Apache Qpid</td> - </tr> - <tr> - <td width="200"> - <b>Description:</b> - </td> - <td><p>The Qpid Project provides an open and interoperable, multiple language implementations of the Advanced Messaged Queuing Protocol (AMQP) specification and related technologies including PGM, transaction management, queuing, distribution, security, management and heterogeneous multi-platform support for messaging.</p></td> - </tr> - <tr> - <td width="200"> - <b>Creator (Creation Date):</b> - </td> - <td>husted (Oct 06, 2006)</td> - </tr> - <tr> - <td width="200"> - <b>Last Modifier (Mod. Date):</b> - </td> - <td>rgreig (Oct 17, 2006)</td> - </tr> - </table> - <br/> - <br/> - <p> - <h2><font color="#0050B2">Available Pages:</font></h2> - <ul> - <li> - <a href="Index.html">Index</a> - <img src="icons/home_16.gif" height="16" width="16" border="0" align="absmiddle"/> <ul> - <li> - <a href="AMQP0-9-DesignNotes.html">AMQP0-9-DesignNotes</a> - </li> - </ul> - <ul> - <li> - <a href="ClusteringHA.html">ClusteringHA</a> - <ul> - <li> - <a href="Cluster Design Note.html">Cluster Design Note</a> - </li> - </ul> - <ul> - <li> - <a href="ClusteringAndFederation.html">ClusteringAndFederation</a> - </li> - </ul> - <ul> - <li> - <a href="Old Clustering Design Note.html">Old Clustering Design Note</a> - </li> - </ul> - <ul> - <li> - <a href="Reliability Requirements.html">Reliability Requirements</a> - </li> - </ul> - </li> - </ul> - <ul> - <li> - <a href="Developer Pages.html">Developer Pages</a> - <ul> - <li> - <a href="Cpp Client Java Interop Issues.html">Cpp Client Java Interop Issues</a> - </li> - </ul> - <ul> - <li> - <a href="Distributed Testing.html">Distributed Testing</a> - </li> - </ul> - <ul> - <li> - <a href="Interop Testing Specification.html">Interop Testing Specification</a> - </li> - </ul> - <ul> - <li> - <a href="Low-Level API Diagram.html">Low-Level API Diagram</a> - </li> - </ul> - <ul> - <li> - <a href="Qpid Java Meeting Minutes 04-04-2008.html">Qpid Java Meeting Minutes 04-04-2008</a> - </li> - </ul> - <ul> - <li> - <a href="Qpid Java Meeting Minutes 11-04-2008.html">Qpid Java Meeting Minutes 11-04-2008</a> - </li> - </ul> - <ul> - <li> - <a href="Qpid Java Meeting Minutes 2008-04-18.html">Qpid Java Meeting Minutes 2008-04-18</a> - </li> - </ul> - <ul> - <li> - <a href="Qpid Java Meeting Minutes 28-03-2008.html">Qpid Java Meeting Minutes 28-03-2008</a> - </li> - </ul> - <ul> - <li> - <a href="Queue Replay.html">Queue Replay</a> - </li> - </ul> - <ul> - <li> - <a href="Weekly QPID Developer Meetings.html">Weekly QPID Developer Meetings</a> - </li> - </ul> - </li> - </ul> - <ul> - <li> - <a href="Download.html">Download</a> - </li> - </ul> - <ul> - <li> - <a href="Getting Involved.html">Getting Involved</a> - <ul> - <li> - <a href="GSoC.html">GSoC</a> - </li> - </ul> - <ul> - <li> - <a href="OSVC.html">OSVC</a> - </li> - </ul> - </li> - </ul> - <ul> - <li> - <a href="HermesJMS.html">HermesJMS</a> - </li> - </ul> - <ul> - <li> - <a href="Informal M2.1 code review 2008-03-18.html">Informal M2.1 code review 2008-03-18</a> - </li> - </ul> - <ul> - <li> - <a href="Navigation.html">Navigation</a> - <ul> - <li> - <a href="Acknowledgment.html">Acknowledgment</a> - </li> - </ul> - <ul> - <li> - <a href="License.html">License</a> - </li> - </ul> - <ul> - <li> - <a href="Project Status.html">Project Status</a> - </li> - </ul> - </li> - </ul> - <ul> - <li> - <a href="People.html">People</a> - <ul> - <li> - <a href="MartinRitchie.html">MartinRitchie</a> - </li> - </ul> - </li> - </ul> - <ul> - <li> - <a href="Qpid 'C++' Documentation.html">Qpid 'C++' Documentation</a> - <ul> - <li> - <a href="CppApiGuide.html">CppApiGuide</a> - </li> - </ul> - <ul> - <li> - <a href="CppEventChannelIo.html">CppEventChannelIo</a> - </li> - </ul> - <ul> - <li> - <a href="CppHandlerChains.html">CppHandlerChains</a> - </li> - </ul> - <ul> - <li> - <a href="CppStyleGuide.html">CppStyleGuide</a> - </li> - </ul> - <ul> - <li> - <a href="PythonBrokerTest.html">PythonBrokerTest</a> - </li> - </ul> - </li> - </ul> - <ul> - <li> - <a href="Qpid .Net Documentation.html">Qpid .Net Documentation</a> - <ul> - <li> - <a href="Qpid .Net How To.html">Qpid .Net How To</a> - <ul> - <li> - <a href="Build .NET Client.html">Build .NET Client</a> - </li> - </ul> - <ul> - <li> - <a href="Setup .Net Client on Windows.html">Setup .Net Client on Windows</a> - </li> - </ul> - </li> - </ul> - </li> - </ul> - <ul> - <li> - <a href="Qpid Java Documentation.html">Qpid Java Documentation</a> - <ul> - <li> - <a href="3rd Party Libraries.html">3rd Party Libraries</a> - </li> - </ul> - <ul> - <li> - <a href="Example Classes.html">Example Classes</a> - </li> - </ul> - <ul> - <li> - <a href="Getting Started.html">Getting Started</a> - <ul> - <li> - <a href="MgmtC++.html">MgmtC++</a> - </li> - </ul> - <ul> - <li> - <a href="RAJB.html">RAJB</a> - </li> - </ul> - <ul> - <li> - <a href="RASC.html">RASC</a> - </li> - </ul> - </li> - </ul> - <ul> - <li> - <a href="Getting Started Guide.html">Getting Started Guide</a> - </li> - </ul> - <ul> - <li> - <a href="Java Coding Standards.html">Java Coding Standards</a> - </li> - </ul> - <ul> - <li> - <a href="Java Unit Tests with InVM Broker.html">Java Unit Tests with InVM Broker</a> - </li> - </ul> - <ul> - <li> - <a href="JMS Compliance.html">JMS Compliance</a> - </li> - </ul> - <ul> - <li> - <a href="Management Design notes.html">Management Design notes</a> - </li> - </ul> - <ul> - <li> - <a href="Management Tools.html">Management Tools</a> - <ul> - <li> - <a href="JMX Management Console.html">JMX Management Console</a> - <ul> - <li> - <a href="Configuring Qpid Management Console.html">Configuring Qpid Management Console</a> - </li> - </ul> - <ul> - <li> - <a href="FAQ.html">FAQ</a> - </li> - </ul> - <ul> - <li> - <a href="Qpid Management Features.html">Qpid Management Features</a> - </li> - </ul> - </li> - </ul> - <ul> - <li> - <a href="MessageStore Tool.html">MessageStore Tool</a> - </li> - </ul> - </li> - </ul> - <ul> - <li> - <a href="Multiple AMQP Version Support.html">Multiple AMQP Version Support</a> - <ul> - <li> - <a href="AMQPVersion.1.html">AMQPVersion.1</a> - </li> - </ul> - </li> - </ul> - <ul> - <li> - <a href="Qpid Developer Documentation.html">Qpid Developer Documentation</a> - <ul> - <li> - <a href="Java Architecture Overview.html">Java Architecture Overview</a> - </li> - </ul> - <ul> - <li> - <a href="Java Broker Design - MessageStore.html">Java Broker Design - MessageStore</a> - <ul> - <li> - <a href="BDBMessageStore (3rd Party).html">BDBMessageStore (3rd Party)</a> - </li> - </ul> - <ul> - <li> - <a href="JDBCStore.html">JDBCStore</a> - </li> - </ul> - <ul> - <li> - <a href="MemoryMessageStore.html">MemoryMessageStore</a> - </li> - </ul> - </li> - </ul> - <ul> - <li> - <a href="Message API Design.html">Message API Design</a> - </li> - </ul> - <ul> - <li> - <a href="Qpid Design - Access Control Lists.html">Qpid Design - Access Control Lists</a> - </li> - </ul> - <ul> - <li> - <a href="Qpid Design - Application Registry.html">Qpid Design - Application Registry</a> - </li> - </ul> - <ul> - <li> - <a href="Qpid Design - Authentication.html">Qpid Design - Authentication</a> - </li> - </ul> - <ul> - <li> - <a href="Qpid Design - Configuration.html">Qpid Design - Configuration</a> - </li> - </ul> - <ul> - <li> - <a href="Qpid Design - Framing.html">Qpid Design - Framing</a> - </li> - </ul> - <ul> - <li> - <a href="Qpid Design - Management.html">Qpid Design - Management</a> - </li> - </ul> - <ul> - <li> - <a href="Qpid Design - Message Acknowledgement.html">Qpid Design - Message Acknowledgement</a> - </li> - </ul> - <ul> - <li> - <a href="Qpid Design - Threading.html">Qpid Design - Threading</a> - </li> - </ul> - <ul> - <li> - <a href="Restructuring Java Broker and Client Design.html">Restructuring Java Broker and Client Design</a> - </li> - </ul> - <ul> - <li> - <a href="The AMQP Distributed Transaction Classes.html">The AMQP Distributed Transaction Classes</a> - </li> - </ul> - </li> - </ul> - <ul> - <li> - <a href="Qpid IBM JMS Performance Test Results.html">Qpid IBM JMS Performance Test Results</a> - </li> - </ul> - <ul> - <li> - <a href="Qpid Java Client refactoring.html">Qpid Java Client refactoring</a> - </li> - </ul> - <ul> - <li> - <a href="Qpid Java FAQ.html">Qpid Java FAQ</a> - </li> - </ul> - <ul> - <li> - <a href="Qpid Java How To.html">Qpid Java How To</a> - <ul> - <li> - <a href="Configure ACLs.html">Configure ACLs</a> - </li> - </ul> - <ul> - <li> - <a href="Configure Java Qpid to use a SSL connection..html">Configure Java Qpid to use a SSL connection.</a> - </li> - </ul> - <ul> - <li> - <a href="Configure the Broker via config.xml.html">Configure the Broker via config.xml</a> - <ul> - <li> - <a href="M2 - config.xml.html">M2 - config.xml</a> - </li> - </ul> - <ul> - <li> - <a href="M2.1 - config.xml.html">M2.1 - config.xml</a> - </li> - </ul> - </li> - </ul> - <ul> - <li> - <a href="Configure the Virtual Hosts via virtualhosts.xml.html">Configure the Virtual Hosts via virtualhosts.xml</a> - </li> - </ul> - <ul> - <li> - <a href="How to Use JNDI.html">How to Use JNDI</a> - <ul> - <li> - <a href="Using Qpid with other JNDI Providers.html">Using Qpid with other JNDI Providers</a> - </li> - </ul> - </li> - </ul> - <ul> - <li> - <a href="Qpid Java Build How To.html">Qpid Java Build How To</a> - <ul> - <li> - <a href="Building.html">Building</a> - <ul> - <li> - <a href="Performance Testing for C++.html">Performance Testing for C++</a> - </li> - </ul> - <ul> - <li> - <a href="Qpid Cpp Build How To.html">Qpid Cpp Build How To</a> - </li> - </ul> - </li> - </ul> - </li> - </ul> - </li> - </ul> - <ul> - <li> - <a href="Qpid Java Run Scripts.html">Qpid Java Run Scripts</a> - </li> - </ul> - <ul> - <li> - <a href="Qpid Troubleshooting Guide.html">Qpid Troubleshooting Guide</a> - </li> - </ul> - <ul> - <li> - <a href="Release Plans.html">Release Plans</a> - </li> - </ul> - <ul> - <li> - <a href="roadmap.html">roadmap</a> - </li> - </ul> - <ul> - <li> - <a href="Sustained Tests.html">Sustained Tests</a> - </li> - </ul> - <ul> - <li> - <a href="URL Formats.html">URL Formats</a> - <ul> - <li> - <a href="0.10 Connection URL Format.html">0.10 Connection URL Format</a> - </li> - </ul> - <ul> - <li> - <a href="BindingURLFormat.html">BindingURLFormat</a> - </li> - </ul> - <ul> - <li> - <a href="Connection URL Format.html">Connection URL Format</a> - </li> - </ul> - </li> - </ul> - </li> - </ul> - <ul> - <li> - <a href="Qpid Python Documentation.html">Qpid Python Documentation</a> - </li> - </ul> - <ul> - <li> - <a href="Qpid Release Page.html">Qpid Release Page</a> - <ul> - <li> - <a href="M1 Release.html">M1 Release</a> - <ul> - <li> - <a href="M1 Release Check list.html">M1 Release Check list</a> - </li> - </ul> - </li> - </ul> - <ul> - <li> - <a href="M2 Release.html">M2 Release</a> - </li> - </ul> - <ul> - <li> - <a href="Qpid Release Notes.html">Qpid Release Notes</a> - <ul> - <li> - <a href="Qpid Java M1 Release Notes.html">Qpid Java M1 Release Notes</a> - </li> - </ul> - </li> - </ul> - <ul> - <li> - <a href="QpidReleaseProcess.html">QpidReleaseProcess</a> - </li> - </ul> - <ul> - <li> - <a href="RC Multi-Platform Testing.html">RC Multi-Platform Testing</a> - </li> - </ul> - </li> - </ul> - <ul> - <li> - <a href="Qpid Ruby Documentation.html">Qpid Ruby Documentation</a> - </li> - </ul> - <ul> - <li> - <a href="Qpid Testing.html">Qpid Testing</a> - <ul> - <li> - <a href="Test Server 1.html">Test Server 1</a> - </li> - </ul> - <ul> - <li> - <a href="Test Server 2.html">Test Server 2</a> - </li> - </ul> - <ul> - <li> - <a href="Topic Test.html">Topic Test</a> - </li> - </ul> - </li> - </ul> - <ul> - <li> - <a href="Source Repository.html">Source Repository</a> - <ul> - <li> - <a href="Mailing Lists.html">Mailing Lists</a> - </li> - </ul> - </li> - </ul> - <ul> - <li> - <a href="Useful Links.html">Useful Links</a> - </li> - </ul> - </li> - <li> - <a href="CppTips.html">CppTips</a> - <ul> - <li> - <a href="BewareOfStringPromotion.html">BewareOfStringPromotion</a> - </li> - </ul> - <ul> - <li> - <a href="BewareStdStringLiterals.html">BewareStdStringLiterals</a> - </li> - </ul> - <ul> - <li> - <a href="NeverUseStaticLocalVariables.html">NeverUseStaticLocalVariables</a> - </li> - </ul> - <ul> - <li> - <a href="NoUsingNamespaceInHeaders.html">NoUsingNamespaceInHeaders</a> - </li> - </ul> - <ul> - <li> - <a href="PrivateLocking.html">PrivateLocking</a> - </li> - </ul> - <ul> - <li> - <a href="ReturnStdStringByValue.html">ReturnStdStringByValue</a> - </li> - </ul> - <ul> - <li> - <a href="ScopedLocking.html">ScopedLocking</a> - </li> - </ul> - <ul> - <li> - <a href="SharedPtr.html">SharedPtr</a> - </li> - </ul> - <ul> - <li> - <a href="ValgrindBadSuppressions.html">ValgrindBadSuppressions</a> - </li> - </ul> - </li> - </ul> - </p> - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/reconnect.gif b/content/xdocs/reconnect.gif Binary files differdeleted file mode 100755 index e2f8c3e1fe..0000000000 --- a/content/xdocs/reconnect.gif +++ /dev/null diff --git a/content/xdocs/roadmap.html b/content/xdocs/roadmap.html deleted file mode 100755 index 7374b42890..0000000000 --- a/content/xdocs/roadmap.html +++ /dev/null @@ -1,100 +0,0 @@ -<html> - <head> - <title>Apache Qpid : roadmap</title> - <link rel="stylesheet" href="styles/site.css" type="text/css" /> - <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> - </head> - - <body> - <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff"> - <tr> - <td valign="top" class="pagebody"> - <div class="pageheader"> - <span class="pagetitle"> - Apache Qpid : roadmap - </span> - </div> - <div class="pagesubheading"> - This page last changed on Mar 27, 2008 by <font color="#0050B2">cctrieloff</font>. - </div> - - -<h2><a name="roadmap-M2.1"></a>M2.1</h2> - -<p>M2.1 is a maintainer release for the M2 code branch. The detailed breakdown of JIRA's for M2.1 can be found here:</p> - -<p>This release implements the the AMQP 0-9 protocol version</p> - - -<p><a href="http://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&mode=hide&sorter/order=DESC&sorter/field=priority&resolution=-1&pid=12310520&fixfor=12312720" title="Visit page outside Confluence">http://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&mode=hide&sorter/order=DESC&sorter/field=priority&resolution=-1&pid=12310520&fixfor=12312720</a></p> - - -<h2><a name="roadmap-M3Currentdevelopmentrelease"></a>M3 – Current development release</h2> - -<p>This release implements the AMQP 0-9 & AMQP 0-10 protocol versions</p> - -<p>Top level themes for this release:</p> - -<ul> - <li>C++ broker supporting AMQP 0-10</li> - <li>C++ client supporting AMQP 0-10</li> - <li>Java Client support AMQP 0-9 (M2.1) and AMQP 0-10</li> - <li>Python Client supporting AMQP 0-9 (M2.1) and AMQP 0-10 (in addition to older versions)</li> - <li>Landing the Big merge on Java Broker</li> - <li>Ruby Client updated to AMQP 0-10 — Nice task to start on</li> - <li>.NET Client updated to AMQP 0-10 — Nice task to start on</li> - <li>Federation</li> - <li>Transparent 0.8/0.9/.10 support in the Java broker (might need to be M4)</li> -</ul> - - -<p>The following are nice task to pick up for new committers: (Please mail the list if you have interest in doing any of these</p> - -<ul> - <li>Creation of Perl Client — Nice task to start on</li> - <li>AMQP-MGMT to WS-DM and JMX bridge — Nice task to start on</li> - <li>Integrating AMQP-MGMT into the Java broker</li> - <li>Windows Client C++ support</li> - <li>Solaris Client C++ support</li> - <li>Writing examples and getting started pages — Nice task to start on</li> - <li>Help update this site <img class="emoticon" src="./icons/emoticons/smile.gif" height="20" width="20" align="absmiddle" alt="" border="0"/> — Nice task to start on</li> - <li>Profiling for performance improvements</li> -</ul> - - -<p>Slightly more involved items</p> - -<ul> - <li>Message Priority - both brokers</li> - <li>Java broker tasks - <ul> - <li>Add Flow To Disk</li> - <li>Message Federation for Java (Fan out & forward to remote queue) – look at C++ broker and impl in Java (might need to wait for 0-10 (M4))</li> - <li>Flow control - throttling of overactive producers – might need 0-10 (M4)</li> - </ul> - </li> - <li>JCA / App server integrations</li> - <li>Spring integration</li> -</ul> - - - -<p>JIRA for M3:</p> - -<p><a href="http://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&mode=hide&sorter/order=DESC&sorter/field=priority&resolution=-1&pid=12310520&fixfor=12312117" title="Visit page outside Confluence">http://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&mode=hide&sorter/order=DESC&sorter/field=priority&resolution=-1&pid=12310520&fixfor=12312117</a></p> - - - - </td> - </tr> - </table> - <table border="0" cellpadding="0" cellspacing="0" width="100%"> - <tr> - <td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td> - </tr> - <tr> - <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td> - </tr> - </table> - </body> -</html>
\ No newline at end of file diff --git a/content/xdocs/site.xml b/content/xdocs/site.xml deleted file mode 100755 index e8720b7cc0..0000000000 --- a/content/xdocs/site.xml +++ /dev/null @@ -1,146 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!-- - 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. ---> -<site label="Apache Qpid" href="" xmlns="http://apache.org/forrest/linkmap/1.0" - tab=""> - - <home label="Apache Qpid" tab="home"> - <home label="Home" href="index.html" description="Apache Qpid"/> - <download label="Download" href="Download.html" description="Download and Install Apache Qpid"/> - <faq label="FAQ" href="FAQ.html" description="FAQ"/> - <lists label="Mailing Lists" href="Mailing Lists.html"/> - <using label="Using Apache Qpid" description="Developing Applications with Apache Qpid"> - <interop label="C++/Java Interoperability" href="Cpp%20Client%20Java%20Interop%20Issues.html" description="Issues with interoperabilty between implementations"/> - <examples label="Example Classes" href="Example Classes.html"/> - <gettingstarted label="Getting Started Guide" href="Getting Started Guide.html"/> - <jmscompliance label="JMS Compliance" href="JMS Compliance.html"/> - <clientapi label="Message API Design" href="Message API Design.html"/> - <jndi label="How To Use JNDI" href="How to Use JNDI.html"/> - <otherjndi label="Using Other JNDI Providers" href="Using Qpid with other JNDI Providers.html"/> - <connurl label="Connection URLs" href="ConnectionURLFormat.html"/> - <bindurl label="Binding URLs" href="BindingURLFormat.html"/> - <properties label="System Properties" href="Properties.html"/> - </using> - <running label="Running the Broker"> - <configxml label="Configuring the Broker" href="Configure the Broker via config.xml.html"/> - <vhosts label="Configuring Virtual Hosts" href="Configure the Virtual Hosts via virtualhosts.xml.html"/> - <run label="Starting and stopping the broker" href="Qpid Java Run Scripts.html"/> - <trouble label="Trouble Shooting Guide" href="Qpid Troubleshooting Guide.html"/> - </running> - <clustering label="Clustering"> - <overview label="Overview" href="ClusteringHA.html" description="Clustering and High Availability"/> - <designnotes label="Design Notes" href="Cluster Design Note.html" description="Design Notes"/> - <federation label="Federation" href="ClusteringAndFederation.html" description="Federation"/> - <olddesignnote label="Old Design Notes" href="Old Clustering Design Note.html" description="Old design note"/> - <reliability label="Reliability" href="Reliability Requirements.html" description="Reliability Requirements"/> - </clustering> - <management label="Management"> - <tools label="Tools" href="Management Tools.html"/> - <console label="JMX Console" href="JMX Management Console.html"/> - <configuringconsole label="Configuring The JMX Console" href="Configuring Qpid Management Console.html"/> - <features label="Apache Qpid Management Features" href="Qpid Management Features.html"/> - <messagestoretool label="Message Store Tool" href="MessageStore Tool.html"/> - <hermes label="Hermes JMS" description="Using Hermes JMS with Apache Qpid" href="HermesJMS.html"/> - </management> - <release label="Release Plans" href="Release Plans.html"/> - <gettinginvolved label="Getting Involved" href="Getting Involved.html"/> - </home> - - <developers label="Developers" tab="dev" href="dev/"> - <devhome label="Developer Home" href="index.html" description="Working on Apache Qpid"/> - <src label="Source Repository" href="Source Repository.html"/> - <building label="Building" href="Building.html" description="Building"/> - <java label="Java"> - <overview label="Overview" href="Qpid Java Documentation.html"/> - <javabuild label="Building Java" href="Qpid Java Build How To.html"/> - <thirdpartylibs label="3rd Party Libraries" href="3rd Party Libraries.html"/> - <codingstandards label="Java Coding Standards" href="Java Coding Standards.html"/> - <vmbrokertests label="Java Unit Tests With InVM Broker" href="Java Unit Tests with InVM Broker.html"/> - <design label="Design"> - <appreg label="Application Registry" href="Qpid Design - Application Registry.html"/> - <authen label="Authentication" href="Qpid Design - Authentication.html"/> - <config label="Configuration" href="Qpid Design - Configuration.html"/> - <framing label="Framing" href="Qpid Design - Framing.html"/> - <management label="Management" href="Qpid Design - Management.html"/> - <ack label="Message Acknolwedgement" href="Qpid Design - Message Acknowledgement.html"/> - <threading label="Threading" href="Qpid Design - Threading.html"/> - <restructuring label="Restructuring Java Broker And Client" href="Restructuring Java Broker and Client Design.html"/> - <clientrefactor label="Client Refactoring" href="Qpid Java Client refactoring.html"/> - <dtx label="Distributed Transaction Classes" href="The AMQP Distributed Transaction Classes.html"/> - </design> - </java> - <cpp label="C++"> - <cppoverview label="Overview" href="Qpid Cpp Documentation.html"/> - <cppbuild label="Build" href="Qpid Cpp Build How To.html"/> - <apiguide label="API Guide" href="CppApiGuide.html"/> - <channelio label="Event Channel I/O" href="CppEventChannelIo.html"/> - <handlerchains label="Handler Chains" href="CppHandlerChains.html"/> - <styleguide label="Style Guide" href="CppStyleGuide.html"/> - <tips label="Tips"> - <privatelocking href="PrivateLocking.html" label="PrivateLocking"/> - <scopedlocking href="ScopedLocking.html" label="ScopedLocking"/> - <sharedptr href="SharedPtr.html" label="SharedPtr"/> - <bewarestdstringliterals href="BewareStdStringLiterals.html" label="BewareStdStringLiterals"/> - <neverusestaticlocalvariables href="NeverUseStaticLocalVariables.html" label="NeverUseStaticLocalVariables"/> - <bewareofstringpromotion href="BewareOfStringPromotion.html" label="BewareOfStringPromotion"/> - <returnstdstringbyvalue href="ReturnStdStringByValue.html" label="ReturnStdStringByValue"/> - <nousingnamespaceinheaders href="NoUsingNamespaceInHeaders.html" label="NoUsingNamespaceInHeaders"/> - <valgrindbadsuppressions href="ValgrindBadSuppressions.html" label="ValgrindBadSuppressions"/> - </tips> - </cpp> - <dotnet label=".Net"> - <dotnetbuild label="Build" href="Build .NET Client.html"/> - <dotnetclient label="Client Setup" href="Setup .Net Client on Windows.html"/> - </dotnet> - <test label="Testing"> - <distributedtesting label="Distributed Testing" href="Distributed Testing.html"/> - <interoptesting label="Interoperability Testing" href="Interop Testing Specification.html"/> - <brokertest label="Python Broker Test" href="PythonBrokerTest.html"/> - <sustained label="Sustained Tests" href="Sustained Tests.html"/> - <platforms label="Multiplatform Testing" href="RC Multi-Platform Testing.html"/> - </test> - <design label="Design" description="Design Notes and Documents"> - <replay label="Queue Replay" href="Queue Replay.html"/> - <management label="Management" href="Management Design notes.html"/> - <multiversion label="Multiple AMQP Version Support" href="Multiple AMQP Version Support.html"/> - <multiversionone label="AMQPVersion.1" href="AMQPVersion.1.html"/> - <messagestore label="Message Store"> - <overview label="Overview" href="Java Broker Design - MessageStore.html"/> - <bdbstore label="BDB Store" href="BDBMessageStore (3rd Party).html"/> - <jdbcstore label="JDBC Store" href="JDBCStore.html"/> - <memstore label="Memory Store" href="MemoryMessageStore.html"/> - </messagestore> - </design> - <releases label="Releases"> - <overview label="Overview" href="Qpid Release Page.html"/> - <process label="Release Process" href="QpidReleaseProcess.html"/> - <m2rel label="M2 Release" href="M2 Release.html"/> - <m1rel label="M1 Release" href="M1 Release.html"/> - <m1relchk label="M1 Release Checklist" href="M1 Release Check 5Flist.html"/> - <m1relnts label="M1 Release Notes" href="Qpid Java M1 Release Notes.html"/> - <roadmap label="Roadmap" href="roadmap.html"/> - </releases> - </developers> - - - <about label="About" tab="about" href="about/"> - <people label="People" href="People.html"/> - <license label="License" href="License.html"/> - <status label="Project Status" href="Project Status.html"/> - </about> - -</site> diff --git a/content/xdocs/styles/site.css b/content/xdocs/styles/site.css deleted file mode 100755 index 94e93af5a6..0000000000 --- a/content/xdocs/styles/site.css +++ /dev/null @@ -1,1511 +0,0 @@ -body, p, td, table, tr, .bodytext, .stepfield { - font-family: Verdana, arial, sans-serif; - font-size: 11px; - line-height: 16px; - color: #000000; - font-weight: normal; -} -#PageContent { - text-align: left; - background-color: #fff; - padding: 0px; - margin: 0px; - padding-bottom:20px; -} -/* -** when this stylesheet is used for the Tiny MCE Wysiwyg editor's edit area, we can't -** use an id=PageContent or class=wiki-content, so we must -** set the body style to that used for PageContent, and p to that used for wiki-content. -*/ - -body { - margin: 0px; - padding: 0px; - text-align: center; - background-color: #f0f0f0; -} - -@media print { - -body { - background-color: #fff; -} - -} - -.monospaceInput { - font:12px monospace -} - -.wiki-content p, .commentblock p { - margin: 16px 0px 16px 0px; - padding: 0px; -} - -.wiki-content-preview { - padding: 5px; - border-left: 1px solid #3c78b5; - border-right: 1px solid #3c78b5; -} - -ul, ol { - margin-top: 2px; - margin-bottom: 2px; - padding-top: 0px; - padding-bottom: 0px; -} - -pre { - padding: 0px; - margin-top: 5px; - margin-left: 15px; - margin-bottom: 5px; - margin-right: 5px; - text-align: left; -} - -.helpheading { - font-weight: bold; - background-color: #D0D9BD; - border-bottom: 1px solid #3c78b5; - padding: 4px 4px 4px 4px; - margin: 0px; - margin-top: 10px; -} -.helpcontent { - padding: 4px 4px 20px 4px; - background-color: #f5f7f1; -} - -.code { - border: 1px dashed #3c78b5; - font-size: 11px; - font-family: Courier; - margin: 10px; - line-height: 13px; -} - -.focusedComment { - background: #ffffce; -} - -.commentBox, .focusedComment { - padding: 10px; - margin: 5px 0 5px 0; - border: 1px #bbb solid; -} - -.codeHeader { - background-color: #f0f0f0; - border-bottom: 1px dashed #3c78b5; - padding: 3px; - text-align: center; -} - -.codeContent { - text-align: left; - background-color: #f0f0f0; - padding: 3px; -} - -.preformatted { - border: 1px dashed #3c78b5; - font-size: 11px; - font-family: Courier; - margin: 10px; - line-height: 13px; -} - -.preformattedHeader { - background-color: #f0f0f0; - border-bottom: 1px dashed #3c78b5; - padding: 3px; - text-align: center; -} - -.preformattedContent { - background-color: #f0f0f0; - padding: 3px; -} - -.panel { - border: 1px dashed #3c78b5; - margin: 10px; - margin-top: 0px; -} - -.panelHeader { - background-color: #f0f0f0; - border-bottom: 1px dashed #3c78b5; - padding: 3px; - text-align: center; -} - -.panelContent { - background-color: #f0f0f0; - padding: 5px; -} - -.anonymousAlert { - background-color: #f0f0f0; - border: 1px dashed red; - font-size: 11px; - padding: 10px 5px 10px 5px; - margin: 4px; - line-height: 13px; -} - -.lockAlert { - background-color: #f0f0f0; - width: 50%; - border: 1px dashed red; - font-size: 11px; - padding: 10px 5px 10px 5px; - margin: 4px; - line-height: 13px; -} - - -.code-keyword { - color: #000091; - background-color: inherit; -} - -.code-object { - color: #910091; - background-color: inherit; -} - -.code-quote { - color: #009100; - background-color: inherit; -} - -.code-comment { - color: #808080; - background-color: inherit; -} - - -.code-xml .code-keyword { - color: inherit; - font-weight: bold; -} - -.code-tag { - color: #000091; - background-color: inherit; -} - -.breadcrumbs { - background-color: #f0f0f0; - border-color: #3c78b5; - border-width: 1px 0px 1px 0px; - border-style: solid; - font-size: 11px; - padding: 3px 0px 3px 0px; -} - -.navmenu { - border: 1px solid #ccc; -} - -.menuheading { - font-weight: bold; - background-color: #f0f0f0; - border-bottom: 1px solid #3c78b5; - padding: 4px 4px 2px 4px; -} - -.menuitems { - padding: 4px 4px 20px 4px; -} - -.rightpanel { - border-left: 1px solid #ccc; - border-bottom: 1px solid #ccc; -} - -#helpheading { - text-align: left; - font-weight: bold; - background-color: #D0D9BD; - border-bottom: 1px solid #3c78b5; - padding: 4px 4px 4px 4px; - margin: 0px; -} -#helpcontent { - padding: 4px 4px 4px 4px; - background-color: #f5f7f1; -} -.helptab-unselected { - font-weight: bold; - padding: 5px; - background-color: #f5f7f1; -} -.helptab-selected { - font-weight: bold; - background-color: #D0D9BD; - padding: 5px; -} -.helptabs { - margin: 0px; - background-color: #f5f7f1; - padding: 5px; -} -.infopanel-heading { - font-weight: bold; - padding: 4px 0px 2px 0px; -} - -.pagebody { -} - -.pageheader { - padding: 5px 5px 5px 0px; - border-bottom: 1px solid #3c78b5; -} - -.pagetitle { - font-size: 22px; - font-weight: bold; - font-family: Arial, sans-serif; - color: #003366; -} - -.newpagetitle { - color: #ccc !important; -} - -.steptitle { - font-size: 18px; - font-weight: bold; - font-family: Arial, sans-serif; - color: #003366; - margin-bottom: 7px; -} - -.substeptitle { - font-size: 12px; - font-weight: bold; - font-family: Arial, sans-serif; - color: #003366; - margin: 2px 4px 4px 4px; - padding: 2px 4px 1px 4px; -} - -.stepdesc { - font-family: Verdana, arial, sans-serif; - font-size: 11px; - line-height: 16px; - font-weight: normal; - color: #666666; - margin-top: 7px; - margin-bottom: 7px; -} - -.steplabel { - font-weight: bold; - margin-right: 4px; - color: black; - float: left; - width: 15%; - text-align: right; -} - -.stepfield { - background: #f0f0f0; - padding: 5px; -} - -.submitButtons{ - margin-top:5px; - text-align:right; -} - -.formtitle { - font-size: 12px; - font-weight: bold; - font-family: Arial, sans-serif; - color: #003366; -} - -.sectionbottom { - border-bottom: 1px solid #3c78b5; -} - -.topRow { - border-top: 2px solid #3c78b5; -} - -.tabletitle { - font-size: 14px; - font-weight: bold; - font-family: Arial, sans-serif; - padding: 3px 0px 2px 0px; - margin: 8px 4px 2px 0px; - color: #003366; - border-bottom: 2px solid #3c78b5; -} -.pagesubheading { - color: #666666; - font-size: 10px; - padding: 0px 0px 5px 0px; -} - -HR { - color: 3c78b5; - height: 1; -} - -A:link, A:visited, A:active, A:hover { - color: #003366; -} - -h1 A:link, h1 A:visited, h1 A:active { - text-decoration: none; -} - -h1 A:hover { - border-bottom: 1px dotted #003366; -} - -.wiki-content > :first-child, .commentblock > :first-child { - margin-top: 3px; -} - -.logocell { - padding: 10px; -} - -input { - font-family: verdana, geneva, arial, sans-serif; - font-size: 11px; - color: #000000; -} - -textarea, textarea.editor { - font-family: verdana, geneva, arial, sans-serif; - font-size: 11px; - color: #333333; -} - -/* use logoSpaceLink instead. -.spacenametitle { - font: 21px/31px Impact, Arial, Helvetica; - font-weight: 100; - color: #999999; - margin: 0px; -} -.spacenametitle img { - margin: 0 0 -4px 0; -} -.spacenametitle a { - text-decoration: none; - color: #999999; -} -.spacenametitle a:visited { - text-decoration: none; - color: #999999; -}*/ - -.spacenametitle-printable { - font: 20px/25px Impact, Arial, Helvetica; - font-weight: 100; - color: #999999; - margin: 0px; -} -.spacenametitle-printable a { - text-decoration: none; - color: #999999; -} -.spacenametitle-printable a:visited { - text-decoration: none; - color: #999999; -} - -.blogDate { - font-weight: bold; - text-decoration: none; - color: black; -} - -.blogSurtitle { - background: #f0f0f0; - border: 1px solid #ddd; - padding: 3px; - margin: 1px 1px 10px 1px; -} - -.blogHeading { - font-size: 20px; - line-height: normal; - font-weight: bold; - padding: 0px; - margin: 0px; -} - -.blogHeading a { - text-decoration: none; - color: black; -} - -.endsection { - align: right; - color: #666666; - margin-top: 10px; -} -.endsectionleftnav { - align: right; - color: #666666; - margin-top: 10px; -} - -h1 { - font-size: 24px; - line-height: normal; - font-weight: bold; - background-color: #f0f0f0; - color: #003366; - border-bottom: 1px solid #3c78b5; - padding: 2px; - margin: 36px 0px 4px 0px; -} - -h2 { - font-size: 18px; - line-height: normal; - font-weight: bold; - background-color: #f0f0f0; - border-bottom: 1px solid #3c78b5; - padding: 2px; - margin: 27px 0px 4px 0px; -} - -h3 { - font-size: 14px; - line-height: normal; - font-weight: bold; - background-color: #f0f0f0; - padding: 2px; - margin: 21px 0px 4px 0px; -} - -h4 { - font-size: 12px; - line-height: normal; - font-weight: bold; - background-color: #f0f0f0; - padding: 2px; - margin: 18px 0px 4px 0px; -} - -h4.search { - font-size: 12px; - line-height: normal; - font-weight: normal; - background-color: #f0f0f0; - padding: 4px; - margin: 18px 0px 4px 0px; -} - -h5 { - font-size: 10px; - line-height: normal; - font-weight: bold; - background-color: #f0f0f0; - padding: 2px; - margin: 14px 0px 4px 0px; -} - -h6 { - font-size: 8px; - line-height: normal; - font-weight: bold; - background-color: #f0f0f0; - padding: 2px; - margin: 14px 0px 4px 0px; -} - -.smallfont { - font-size: 10px; -} -.descfont { - font-size: 10px; - color: #666666; -} -.smallerfont { - font-size: 9px; -} -.smalltext { - color: #666666; - font-size: 10px; -} -.smalltext a { - color: #666666; -} -.smalltext-blue { - color: #3c78b5; - font-size: 10px; -} -.surtitle { - margin-left: 1px; - margin-bottom: 5px; - font-size: 14px; - color: #666666; -} - -/* css hack found here: http://www.fo3nix.pwp.blueyonder.co.uk/tutorials/css/hacks/ */ -.navItemOver { font-size: 10px; font-weight: bold; color: #ffffff; background-color: #003366; cursor: hand; voice-family: '\'}\''; voice-family:inherit; cursor: pointer;} -.navItemOver a { color: #ffffff; background-color:#003366; text-decoration: none; } -.navItemOver a:visited { color: #ffffff; background-color:#003366; text-decoration: none; } -.navItemOver a:hover { color: #ffffff; background-color:#003366; text-decoration: none; } -.navItem { font-size: 10px; font-weight: bold; color: #ffffff; background-color: #3c78b5; } -.navItem a { color: #ffffff; text-decoration: none; } -.navItem a:hover { color: #ffffff; text-decoration: none; } -.navItem a:visited { color: #ffffff; text-decoration: none; } - -div.padded { padding: 4px; } -div.thickPadded { padding: 10px; } -h3.macrolibrariestitle { - margin: 0px 0px 0px 0px; -} - -div.centered { text-align: center; margin: 10px; } -div.centered table {margin: 0px auto; text-align: left; } - -.tableview table { - margin: 0; -} - -.tableview th { - text-align: left; - color: #003366; - font-size: 12px; - padding: 5px 0px 0px 5px; - border-bottom: 2px solid #3c78b5; -} -.tableview td { - text-align: left; - border-color: #ccc; - border-width: 0px 0px 1px 0px; - border-style: solid; - margin: 0; - padding: 4px 10px 4px 5px; -} - -.grid { - margin: 2px 0px 5px 0px; - border-collapse: collapse; -} -.grid th { - border: 1px solid #ccc; - padding: 2px 4px 2px 4px; - background: #f0f0f0; - text-align: center; -} -.grid td { - border: 1px solid #ccc; - padding: 3px 4px 3px 4px; -} -.gridHover { - background-color: #f9f9f9; -} - -td.infocell { - background-color: #f0f0f0; -} -.label { - font-weight: bold; - color: #003366; -} - -label { - font-weight: bold; - color: #003366; -} - -.error { - background-color: #fcc; -} - -.errorBox { - background-color: #fcc; - border: 1px solid #c00; - padding: 5px; - margin: 5px; -} - -.errorMessage { - color: #c00; -} - -.success { - background-color: #dfd; -} - -.successBox { - background-color: #dfd; - border: 1px solid #090; - padding: 5px; - margin-top:5px; - margin-bottom:5px; -} - -blockquote { - padding-left: 10px; - padding-right: 10px; - margin-left: 5px; - margin-right: 0px; - border-left: 1px solid #3c78b5; -} - -table.confluenceTable -{ - margin: 5px; - border-collapse: collapse; -} - -/* Added as a temporary fix for CONF-4223. The table elements appear to be inheriting the border: none attribute from the sectionMacro class */ -table.confluenceTable td.confluenceTd -{ - border-width: 1px; - border-style: solid; - border-color: #ccc; - padding: 3px 4px 3px 4px; -} - -/* Added as a temporary fix for CONF-4223. The table elements appear to be inheriting the border: none attribute from the sectionMacro class */ -table.confluenceTable th.confluenceTh -{ - border-width: 1px; - border-style: solid; - border-color: #ccc; - padding: 3px 4px 3px 4px; - background-color: #f0f0f0; - text-align: center; -} - -td.confluenceTd -{ - border-width: 1px; - border-style: solid; - border-color: #ccc; - padding: 3px 4px 3px 4px; -} - -th.confluenceTh -{ - border-width: 1px; - border-style: solid; - border-color: #ccc; - padding: 3px 4px 3px 4px; - background-color: #f0f0f0; - text-align: center; -} - -DIV.small { - font-size: 9px; -} - -H1.pagename { - margin-top: 0px; -} - -IMG.inline {} - -.loginform { - margin: 5px; - border: 1px solid #ccc; -} - -/* The text how the "This is a preview" comment should be shown. */ -.previewnote { text-align: center; - font-size: 11px; - color: red; } - -/* How the preview content should be shown */ -.previewcontent { background: #E0E0E0; } - -/* How the system messages should be shown (DisplayMessage.jsp) */ -.messagecontent { background: #E0E0E0; } - -/* How the "This page has been modified..." -comment should be shown. */ -.conflictnote { } - -.createlink { - color: maroon; -} -a.createlink { - color: maroon; -} -.templateparameter { - font-size: 9px; - color: darkblue; -} - -.diffadded { - background: #ddffdd; - padding: 1px 1px 1px 4px; - border-left: 4px solid darkgreen; -} -.diffdeleted { - color: #999; - background: #ffdddd; - padding: 1px 1px 1px 4px; - border-left: 4px solid darkred; -} -.diffnochange { - padding: 1px 1px 1px 4px; - border-left: 4px solid lightgrey; -} -.differror { - background: brown; -} -.diff { - font-family: lucida console, courier new, fixed-width; - font-size: 12px; - line-height: 14px; -} -.diffaddedchars { - background-color:#99ff99; - font-weight:bolder; -} -.diffremovedchars { - background-color:#ff9999; - text-decoration: line-through; - font-weight:bolder; -} - -.greybackground { - background: #f0f0f0 -} - -.greybox { - border: 1px solid #ddd; - padding: 3px; - margin: 1px 1px 10px 1px; -} - -.borderedGreyBox { - border: 1px solid #cccccc; - background-color: #f0f0f0; - padding: 10px; -} - -.greyboxfilled { - border: 1px solid #ddd; - background: #f0f0f0; - padding: 3px; - margin: 1px 1px 10px 1px; -} - -.navBackgroundBox { - padding: 5px 5px 5px 5px; - font-size: 22px; - font-weight: bold; - font-family: Arial, sans-serif; - color: white; - background: #3c78b5; - text-decoration: none; -} - -.previewBoxTop { - background-color: #f0f0f0; - border-width: 1px 1px 0px 1px; - border-style: solid; - border-color: #3c78b5; - padding: 5px; - margin: 5px 0px 0px 0px; - text-align: center; -} -.previewContent { - background-color: #fff; - border-color: #3c78b5; - border-width: 0px 1px 0px 1px; - border-style: solid; - padding: 10px; - margin: 0px; -} -.previewBoxBottom { - background-color: #f0f0f0; - border-width: 0px 1px 1px 1px; - border-style: solid; - border-color: #3c78b5; - padding: 5px; - margin: 0px 0px 5px 0px; - text-align: center; -} - -.functionbox { - background-color: #f0f0f0; - border: 1px solid #3c78b5; - padding: 3px; - margin: 1px 1px 10px 1px; -} - -.functionbox-greyborder { - background-color: #f0f0f0; - border: 1px solid #ddd; - padding: 3px; - margin: 1px 1px 10px 1px; -} - -.search-highlight { - background-color: #ffffcc; -} - -/* normal (white) background */ -.rowNormal { - background-color: #ffffff; - } - -/* alternate (pale yellow) background */ -.rowAlternate { - background-color: #f7f7f7; -} - -/* used in the list attachments table */ -.rowAlternateNoBottomColor { - background-color: #f7f7f7; -} - -.rowAlternateNoBottomNoColor { -} - -.rowAlternateNoBottomColor td { - border-bottom: 0px; -} - -.rowAlternateNoBottomNoColor td { - border-bottom: 0px; -} - -/* row highlight (grey) background */ -.rowHighlight { - background-color: #f0f0f0; - -} - -TD.greenbar {FONT-SIZE: 2px; BACKGROUND: #00df00; BORDER: 1px solid #9c9c9c; PADDING: 0px; } -TD.redbar {FONT-SIZE: 2px; BACKGROUND: #df0000; BORDER: 1px solid #9c9c9c; PADDING: 0px; } -TD.darkredbar {FONT-SIZE: 2px; BACKGROUND: #af0000; BORDER: 1px solid #9c9c9c; PADDING: 0px; } - -TR.testpassed {FONT-SIZE: 2px; BACKGROUND: #ddffdd; PADDING: 0px; } -TR.testfailed {FONT-SIZE: 2px; BACKGROUND: #ffdddd; PADDING: 0px; } - -.toolbar { - margin: 0px; - border-collapse: collapse; -} - -.toolbar td { - border: 1px solid #ccc; - padding: 2px 2px 2px 2px; - color: #ccc; -} - -td.noformatting { - border-width: 0px; - border-style: none; - text-align: center; - padding: 0px; -} - -.commentblock { - margin: 12px 0 12px 0; -} - -/* - * Divs displaying the license information, if necessary. - */ -.license-eval, .license-none, .license-nonprofit { - border-top: 1px solid #bbbbbb; - text-align: center; - font-size: 10px; - font-family: Verdana, Arial, Helvetica, sans-serif; -} - -.license-eval, .license-none { - background-color: #ffcccc; -} - -.license-eval b, .license-none b { - color: #990000 -} - -.license-nonprofit { - background-color: #ffffff; -} - -/* - * The shadow at the bottom of the page between the main content and the - * "powered by" section. - */ -.bottomshadow { - height: 12px; - background-image: url("$req.contextPath/images/border/border_bottom.gif"); - background-repeat: repeat-x; -} - -/* - * Styling of the operations box - */ -.navmenu .operations li, .navmenu .operations ul { - list-style: none; - margin-left: 0; - padding-left: 0; -} - -.navmenu .operations ul { - margin-bottom: 9px; -} - -.navmenu .label { - font-weight: inherit; -} - -/* - * Styling of ops as a toolbar - */ -.toolbar div { - display: none; -} - -.toolbar .label { - display: none; -} - -.toolbar .operations { - display: block; -} - -.toolbar .operations ul { - display: inline; - list-style: none; - margin-left: 10px; - padding-left: 0; -} - -.toolbar .operations li { - list-style: none; - display: inline; -} - -/* list page navigational tabs */ -#foldertab { -padding: 3px 0px 3px 8px; -margin-left: 0; -border-bottom: 1px solid #3c78b5; -font: bold 11px Verdana, sans-serif; -} - -#foldertab li { -list-style: none; -margin: 0; -display: inline; -} - -#foldertab li a { -padding: 3px 0.5em; -margin-left: 3px; -border: 1px solid #3c78b5; -border-bottom: none; -background: #3c78b5; -text-decoration: none; -} - -#foldertab li a:link { color: #ffffff; } -#foldertab li a:visited { color: #ffffff; } - -#foldertab li a:hover { -color: #ffffff; -background: #003366; -border-color: #003366; -} - -#foldertab li a.current { -background: white; -border-bottom: 1px solid white; -color: black; -} - -#foldertab li a.current:link { color: black; } -#foldertab li a.current:visited { color: black; } -#foldertab li a.current:hover { -background: white; -border-bottom: 1px solid white; -color: black; -} - -/* alphabet list */ -ul#squaretab { -margin-left: 0; -padding-left: 0; -white-space: nowrap; -font: bold 8px Verdana, sans-serif; -} - -#squaretab li { -display: inline; -list-style-type: none; -} - -#squaretab a { -padding: 2px 6px; -border: 1px solid #3c78b5; -} - -#squaretab a:link, #squaretab a:visited { -color: #fff; -background-color: #3c78b5; -text-decoration: none; -} - -#squaretab a:hover { -color: #ffffff; -background-color: #003366; -border-color: #003366; -text-decoration: none; -} - -#squaretab li a#current { -background: white; -color: black; -} - -.blogcalendar * { - font-family:verdana, arial, sans-serif; - font-size:x-small; - font-weight:normal; - line-height:140%; - padding:2px; -} - - -table.blogcalendar { - border: 1px solid #3c78b5; -} - -.blogcalendar th.calendarhead, a.calendarhead { - font-size:x-small; - font-weight:bold; - padding:2px; - text-transform:uppercase; - background-color: #3c78b5; - color: #ffffff; - letter-spacing: .3em; - text-transform: uppercase; -} - -.calendarhead:visited {color: white;} -.calendarhead:active {color: white;} -.calendarhead:hover {color: white;} - -.blogcalendar th { - font-size:x-small; - font-weight:bold; - padding:2px; - background-color:#f0f0f0; -} - -.blogcalendar td { - font-size:x-small; - font-weight:normal; -} - -.searchGroup { padding: 0 0 10px 0; background: #f0f0f0; } -.searchGroupHeading { font-size: 10px; font-weight: bold; color: #ffffff; background-color: #3c78b5; padding: 2px 4px 1px 4px; } -.searchItem { padding: 1px 4px 1px 4px; } -.searchItemSelected { padding: 1px 4px 1px 4px; font-weight: bold; background: #ddd; } - -/* permissions page styles */ -.permissionHeading { - border-bottom: #bbb; border-width: 0 0 1px 0; border-style: solid; font-size: 16px; text-align: left; -} -.permissionTab { - border-width: 0 0 0 1px; border-style: solid; background: #3c78b5; color: #ffffff; font-size: 10px; -} -.permissionSuperTab { - border-width: 0 0 0 1px; border-style: solid; background: #003366; color: #ffffff; -} -.permissionCell { - border-left: #bbb; border-width: 0 0 0 1px; border-style: solid; -} - -/* warning panel */ -.warningPanel { background: #FFFFCE; border:#F0C000 1px solid; padding: 8px; margin: 10px; } -/* alert panel */ -.alertPanel { background: #FFCCCC; border:#C00 1px solid; padding: 8px; margin: 10px; } -/* info panel */ -.infoPanel { background: #D8E4F1; border:#3c78b5 1px solid; padding: 8px; margin: 10px; } - -/* side menu highlighting (e.g. space content screen) */ -.optionPadded { padding: 2px; } -.optionSelected { background-color: #ffffcc; padding: 2px; border: 1px solid #ddd; margin: -1px; } -.optionSelected a { font-weight: bold; text-decoration: none; color: black; } - -/* information macros */ -.noteMacro { border-style: solid; border-width: 1px; border-color: #F0C000; background-color: #FFFFCE; text-align:left; margin-top: 5px; margin-bottom: 5px} -.warningMacro { border-style: solid; border-width: 1px; border-color: #c00; background-color: #fcc; text-align:left; margin-top: 5px; margin-bottom: 5px} -.infoMacro { border-style: solid; border-width: 1px; border-color: #3c78b5; background-color: #D8E4F1; text-align:left; margin-top: 5px; margin-bottom: 5px} -.tipMacro { border-style: solid; border-width: 1px; border-color: #090; background-color: #dfd; text-align:left; margin-top: 5px; margin-bottom: 5px} -.informationMacroPadding { padding: 5px 0 0 5px; } - -table.infoMacro td, table.warningMacro td, table.tipMacro td, table.noteMacro td, table.sectionMacro td { - border: none; -} - -table.sectionMacroWithBorder td.columnMacro { border-style: dashed; border-width: 1px; border-color: #cccccc;} - -.pagecontent -{ - padding: 10px; - text-align: left; -} - -/* styles for links in the top bar */ -.topBarDiv a:link {color: #ffffff;} -.topBarDiv a:visited {color: #ffffff;} -.topBarDiv a:active {color: #ffffff;} -.topBarDiv a:hover {color: #ffffff;} -.topBarDiv {color: #ffffff;} - -.topBar { - background-color: #003366; -} - - -/* styles for extended operations */ -.greyLinks a:link {color: #666666; text-decoration:underline;} -.greyLinks a:visited {color: #666666; text-decoration:underline;} -.greyLinks a:active {color: #666666; text-decoration:underline;} -.greyLinks a:hover {color: #666666; text-decoration:underline;} -.greyLinks {color: #666666; display:block; padding: 10px} - -.logoSpaceLink {color: #999999; text-decoration: none} -.logoSpaceLink a:link {color: #999999; text-decoration: none} -.logoSpaceLink a:visited {color: #999999; text-decoration: none} -.logoSpaceLink a:active {color: #999999; text-decoration: none} -.logoSpaceLink a:hover {color: #003366; text-decoration: none} - -/* basic panel (basicpanel.vmd) style */ -.basicPanelContainer {border: 1px solid #3c78b5; margin-top: 2px; margin-bottom: 8px; width: 100%} -.basicPanelTitle {padding: 5px; margin: 0px; background-color: #f0f0f0; color: black; font-weight: bold;} -.basicPanelBody {padding: 5px; margin: 0px} - -.separatorLinks a:link {color: white} -.separatorLinks a:visited {color: white} -.separatorLinks a:active {color: white} - -.greynavbar {background-color: #f0f0f0; border-top: 1px solid #3c78b5; margin-top: 2px} - -div.headerField { - float: left; - width: auto; - height: 100%; -} - -.headerFloat { - margin-left: auto; - width: 50%; -} - -.headerFloatLeft { - float: left; - margin-right: 20px; - margin-bottom: 10px; -} - -#headerRow { - padding: 10px; -} - -div.license-personal { - background-color: #003366; - color: #ffffff; -} - -div.license-personal a { - color: #ffffff; -} - -.greyFormBox { - border: 1px solid #cccccc; - padding: 5px; -} - -/* IE automatically adds a margin before and after form tags. Use this style to remove that */ -.marginlessForm { - margin: 0px; -} - -.openPageHighlight { - background-color: #ffffcc; - padding: 2px; - border: 1px solid #ddd; -} - -.editPageInsertLinks, .editPageInsertLinks a -{ - color: #666666; - font-weight: bold; - font-size: 10px; -} - -/* Style for label heatmap. */ -.top10 a { - font-weight: bold; - font-size: 2em; - color: #003366; -} -.top25 a { - font-weight: bold; - font-size: 1.6em; - color: #003366; -} -.top50 a { - font-size: 1.4em; - color: #003366; -} -.top100 a { - font-size: 1.2em; - color: #003366; -} - -.heatmap { - list-style:none; - width: 95%; - margin: 0px auto; -} - -.heatmap a { - text-decoration:none; -} - -.heatmap a:hover { - text-decoration:underline; -} - -.heatmap li { - display: inline; -} - -.minitab { -padding: 3px 0px 3px 8px; -margin-left: 0; -margin-top: 1px; -margin-bottom: 0px; -border-bottom: 1px solid #3c78b5; -font: bold 9px Verdana, sans-serif; -text-decoration: none; -float:none; -} -.selectedminitab { -padding: 3px 0.5em; -margin-left: 3px; -margin-top: 1px; -border: 1px solid #3c78b5; -background: white; -border-bottom: 1px solid white; -color: #000000; -text-decoration: none; -} -.unselectedminitab { -padding: 3px 0.5em; -margin-left: 3px; -margin-top: 1px; -border: 1px solid #3c78b5; -border-bottom: none; -background: #3c78b5; -color: #ffffff; -text-decoration: none; -} - -a.unselectedminitab:hover { -color: #ffffff; -background: #003366; -border-color: #003366; -} - -a.unselectedminitab:link { color: white; } -a.unselectedminitab:visited { color: white; } - -a.selectedminitab:link { color: black; } -a.selectedminitab:visited { color: black; } - -.linkerror { background-color: #fcc;} - -a.labelOperationLink:link {text-decoration: underline} -a.labelOperationLink:active {text-decoration: underline} -a.labelOperationLink:visited {text-decoration: underline} -a.labelOperationLink:hover {text-decoration: underline} - -a.newLabel:link {background-color: #ddffdd} -a.newLabel:active {background-color: #ddffdd} -a.newLabel:visited {background-color: #ddffdd} -a.newLabel:hover {background-color: #ddffdd} - -ul.square {list-style-type: square} - -.inline-control-link { - background: #ffc; - font-size: 9px; - color: #666; - padding: 2px; - text-transform: uppercase; - text-decoration: none; -} - - -.inline-control-link a:link {text-decoration: none} -.inline-control-link a:active {text-decoration: none} -.inline-control-link a:visited {text-decoration: none} -.inline-control-link a:hover {text-decoration: none} - -.inline-control-link { - background: #ffc; - font-size: 9px; - color: #666; - padding: 2px; - text-transform: uppercase; - text-decoration: none; - cursor: pointer; -} - -div.auto_complete { - width: 350px; - background: #fff; -} -div.auto_complete ul { - border: 1px solid #888; - margin: 0; - padding: 0; - width: 100%; - list-style-type: none; -} -div.auto_complete ul li { - margin: 0; - padding: 3px; -} -div.auto_complete ul li.selected { - background-color: #ffb; -} -div.auto_complete ul strong.highlight { - color: #800; - margin: 0; - padding: 0; -} - -/******* Edit Page Styles *******/ -.toogleFormDiv{ - border:1px solid #A7A6AA; - background-color:white; - padding:5px; - margin-top: 5px; -} - -.toogleInfoDiv{ - border:1px solid #A7A6AA; - background-color:white; - display:none; - padding:5px; - margin-top: 10px; -} - -.inputSection{ - margin-bottom:20px; -} - -#editBox{ - border:1px solid lightgray; - background-color:#F0F0F0; -} - -/******* Left Navigation Theme Styles ********/ -.leftnav li a { - text-decoration:none; - color:white; - margin:0px; - display:block; - padding:2px; - padding-left:5px; - background-color: #3c78b5; - border-top:1px solid #3c78b5; -} - -.leftnav li a:active {color:white;} -.leftnav li a:visited {color:white;} -.leftnav li a:hover {background-color: #003366; color:white;} - -/* Added by Shaun during i18n */ -.replaced -{ - background-color: #33CC66; -} - -.topPadding -{ - margin-top: 20px; -} - -/* new form style */ -.form-block { - padding: 6px; -} -.form-error-block { - padding: 6px; - background: #fcc; - border-top: #f0f0f0 1px solid; - border-bottom: #f0f0f0 1px solid; - margin-bottom: 6px; - padding: 0 12px 0 12px; -} -.form-element-large { - font-size: 16px; - font-weight: bold; - font-family: Arial, sans-serif; - color: #003366; -} - -.form-element-small { - font-size: 12px; - font-weight: bold; - font-family: Arial, sans-serif; - color: #003366; -} - -.form-header { - background: lightyellow; - border-top: #f0f0f0 1px solid; - border-bottom: #f0f0f0 1px solid; - margin-bottom: 6px; - padding: 0 12px 0 12px; -} -.form-header p, .form-block p, .form-error-block p { - line-height: normal; - margin: 12px 0 12px 0; -} -.form-example { - color: #888; - font-size: 11px; -} -.form-divider { - border-bottom: #ccc 1px solid; - margin-bottom: 6px; -} -.form-buttons { - margin-top: 6px; - border-top: #ccc 1px solid; - border-bottom: #ccc 1px solid; - background: #f0f0f0; - padding: 10px; - text-align: center; -} -.form-buttons input { - width: 100px; -} -.form-block .error { - padding: 6px; - margin-bottom: 6px; -}
\ No newline at end of file diff --git a/content/xdocs/tabs.xml b/content/xdocs/tabs.xml deleted file mode 100755 index dfbf4bc891..0000000000 --- a/content/xdocs/tabs.xml +++ /dev/null @@ -1,36 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!-- - 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. ---> -<!DOCTYPE tabs PUBLIC "-//APACHE//DTD Cocoon Documentation Tab V1.1//EN" "http://forrest.apache.org/dtd/tab-cocoon-v11.dtd"> -<tabs software="Apache Qpid" - title="Apache Qpid" - copyright="2006-2007 Apache Software Foundation" - xmlns:xlink="http://www.w3.org/1999/xlink"> -<!-- The rules for tabs are: - @dir will always have '/@indexfile' added. - @indexfile gets appended to @dir if the tab is selected. Defaults to 'index.html' - @href is not modified unless it is root-relative and obviously specifies a - directory (ends in '/'), in which case /index.html will be added - If @id's are present, site.xml entries with a matching @tab will be in that tab. - - Tabs can be embedded to a depth of two. The second level of tabs will only - be displayed when their parent tab is selected. - --> - <tab id="home" label="Home" dir=""/> - <tab id="dev" label="Developers" dir="dev/"/> - <tab id="about" label="About" dir="about/" indexfile="People.html"/> -</tabs> diff --git a/resources/images/ellipse-2.svg b/resources/images/ellipse-2.svg deleted file mode 100755 index 32df27eb79..0000000000 --- a/resources/images/ellipse-2.svg +++ /dev/null @@ -1,30 +0,0 @@ -<?xml version="1.0" standalone="no"?> -<!-- - 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. ---> -<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.0//EN" -"http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd"> -<svg xmlns="http://www.w3.org/2000/svg" version="1.0" - width="300" height="150" - viewBox="0 0 1500 1000" -> - <desc>Ellipse</desc> - <rect x="1" y="1" width="1495" height="995" - fill="none" stroke="blue" stroke-width="5"/> - <ellipse transform="translate(200 200) rotate(-45)" - rx="200" ry="100" - fill="none" stroke="red" stroke-width="20"/> -</svg> diff --git a/resources/images/icon-a.png b/resources/images/icon-a.png Binary files differdeleted file mode 100755 index 64e66358b0..0000000000 --- a/resources/images/icon-a.png +++ /dev/null diff --git a/resources/images/icon-b.png b/resources/images/icon-b.png Binary files differdeleted file mode 100755 index b0c0db3689..0000000000 --- a/resources/images/icon-b.png +++ /dev/null diff --git a/resources/images/icon.png b/resources/images/icon.png Binary files differdeleted file mode 100755 index 3be8bbbe65..0000000000 --- a/resources/images/icon.png +++ /dev/null diff --git a/resources/images/project-logo.png b/resources/images/project-logo.png Binary files differdeleted file mode 100755 index 8a63e42038..0000000000 --- a/resources/images/project-logo.png +++ /dev/null diff --git a/resources/images/sub-dir/icon-c.png b/resources/images/sub-dir/icon-c.png Binary files differdeleted file mode 100755 index c3a2644ccd..0000000000 --- a/resources/images/sub-dir/icon-c.png +++ /dev/null diff --git a/resources/schema/catalog.xcat b/resources/schema/catalog.xcat deleted file mode 100755 index b32ce37fcb..0000000000 --- a/resources/schema/catalog.xcat +++ /dev/null @@ -1,29 +0,0 @@ -<?xml version="1.0"?> -<!-- - 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. ---> -<!DOCTYPE catalog PUBLIC "-//OASIS//DTD Entity Resolution XML Catalog V1.0//EN" -"http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd"> -<!-- OASIS XML Catalog for Forrest Documents --> -<catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog" - prefer="public"> -<!-- Example catalog entry --> - <public publicId="-//Acme//DTD Hello Document V1.0//EN" - uri="hello-v10.dtd"/> -<!-- Sets of symbols. e.g. for string replacements --> - <public publicId="-//Apache Forrest//ENTITIES Symbols Project v1.0//EN" - uri="symbols-project-v10.ent"/> -</catalog> diff --git a/resources/schema/hello-v10.dtd b/resources/schema/hello-v10.dtd deleted file mode 100755 index 43b4c863ec..0000000000 --- a/resources/schema/hello-v10.dtd +++ /dev/null @@ -1,51 +0,0 @@ -<!-- - 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. ---> -<!-- =================================================================== - - Apache Hello DTD (Version 1.0) - -PURPOSE: - - -TYPICAL INVOCATION: - - <!DOCTYPE greeting PUBLIC - "-//Acme//DTD Hello Document Vx.y//EN" - "hello.dtd"> - - where - - x := major version - y := minor version - -FIXME: - -CHANGE HISTORY: -[Version 1.0] - 20041009 Initial version. (JJP) - -==================================================================== --> - -<!-- =============================================================== --> -<!-- Greeting type element --> -<!-- =============================================================== --> - -<!ELEMENT greeting (#PCDATA)> - -<!-- =============================================================== --> -<!-- End of DTD --> -<!-- =============================================================== --> diff --git a/resources/schema/symbols-project-v10.ent b/resources/schema/symbols-project-v10.ent deleted file mode 100755 index 33a9bf441b..0000000000 --- a/resources/schema/symbols-project-v10.ent +++ /dev/null @@ -1,26 +0,0 @@ -<!-- - 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. ---> - -<!-- Typical invocation: - <!ENTITY % symbols-project - PUBLIC "-//Apache Forrest//ENTITIES Symbols Project v1.0//EN" - "symbols-project-v10.ent"> - %symbols-project; ---> -<!ENTITY myp "My Project Name"> -<!ENTITY myp-s "<strong>My Project Name</strong>"> -<!ENTITY myp-t "My Project Name™"> diff --git a/resources/stylesheets/hello2document.xsl b/resources/stylesheets/hello2document.xsl deleted file mode 100755 index 50d20174ae..0000000000 --- a/resources/stylesheets/hello2document.xsl +++ /dev/null @@ -1,33 +0,0 @@ -<?xml version="1.0"?> -<!-- - 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. ---> -<!--+ - | Transforms Hello document format. - +--> -<xsl:stylesheet version="1.0" - xmlns:xsl="http://www.w3.org/1999/XSL/Transform"> - <xsl:template match="/"> - <document> - <header> - <title><xsl:value-of select="greeting"/></title> - </header> - <body> - <xsl:value-of select="greeting"/> - </body> - </document> - </xsl:template> -</xsl:stylesheet> diff --git a/sitemap.xmap b/sitemap.xmap deleted file mode 100755 index ca7a5353da..0000000000 --- a/sitemap.xmap +++ /dev/null @@ -1,66 +0,0 @@ -<?xml version="1.0"?> -<!-- - 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. ---> -<map:sitemap xmlns:map="http://apache.org/cocoon/sitemap/1.0"> - <map:components> - <map:actions> - <map:action logger="sitemap.action.sourcetype" name="sourcetype" src="org.apache.forrest.sourcetype.SourceTypeAction"> - <sourcetype name="hello-v1.0"> - <document-declaration public-id="-//Acme//DTD Hello Document V1.0//EN" /> - </sourcetype> - </map:action> - </map:actions> - <map:selectors default="parameter"> - <map:selector logger="sitemap.selector.parameter" name="parameter" src="org.apache.cocoon.selection.ParameterSelector" /> - </map:selectors> - </map:components> - <map:resources> - <map:resource name="transform-to-document"> - <map:act type="sourcetype" src="{src}"> - <map:select type="parameter"> - <map:parameter name="parameter-selector-test" value="{sourcetype}" /> - <map:when test="hello-v1.0"> - <map:generate src="{properties:content.xdocs}{../../1}.xml" /> - <map:transform src="{properties:resources.stylesheets}/hello2document.xsl" /> - <map:serialize type="xml-document"/> - </map:when> - </map:select> - </map:act> - </map:resource> - </map:resources> - <map:pipelines> - <map:pipeline> - <map:match pattern="old_site/*.html"> - <map:select type="exists"> - <map:when test="{properties:content}{1}.html"> - <map:read src="{properties:content}{1}.html" mime-type="text/html"/> -<!-- - Use this instead if you want JTidy to clean up your HTML - <map:generate type="html" src="{properties:content}/{0}" /> - <map:serialize type="html"/> - --> - </map:when> - </map:select> - </map:match> - <map:match pattern="**.xml"> - <map:call resource="transform-to-document"> - <map:parameter name="src" value="{properties:content.xdocs}{1}.xml" /> - </map:call> - </map:match> - </map:pipeline> - </map:pipelines> -</map:sitemap> diff --git a/skinconf.xml b/skinconf.xml deleted file mode 100755 index 117effbd5e..0000000000 --- a/skinconf.xml +++ /dev/null @@ -1,416 +0,0 @@ -<?xml version="1.0"?> -<!-- - 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. ---> -<!-- -Skin configuration file. This file contains details of your project, -which will be used to configure the chosen Forrest skin. ---> -<!DOCTYPE skinconfig PUBLIC "-//APACHE//DTD Skin Configuration V0.8-1//EN" "http://forrest.apache.org/dtd/skinconfig-v08-1.dtd"> -<skinconfig> -<!-- To enable lucene search add provider="lucene" (default is google). - Add box-location="alt" to move the search box to an alternate location - (if the skin supports it) and box-location="all" to show it in all - available locations on the page. Remove the <search> element to show - no search box. @domain will enable sitesearch for the specific domain with google. - In other words google will search the @domain for the query string. - --> - <search name="MyProject" domain="mydomain" provider="google"/> -<!-- Disable the print link? If enabled, invalid HTML 4.0.1 --> - <disable-print-link>true</disable-print-link> -<!-- Disable the PDF link? --> - <disable-pdf-link>false</disable-pdf-link> -<!-- Disable the POD link? --> - <disable-pod-link>true</disable-pod-link> -<!-- Disable the Text link? FIXME: NOT YET IMPLEMENETED. --> - <disable-txt-link>true</disable-txt-link> -<!-- Disable the xml source link? --> -<!-- The xml source link makes it possible to access the xml rendition - of the source frim the html page, and to have it generated statically. - This can be used to enable other sites and services to reuse the - xml format for their uses. Keep this disabled if you don't want other - sites to easily reuse your pages.--> - <disable-xml-link>true</disable-xml-link> -<!-- Disable navigation icons on all external links? --> - <disable-external-link-image>true</disable-external-link-image> -<!-- Disable w3c compliance links? - Use e.g. align="center" to move the compliance links logos to - an alternate location default is left. - (if the skin supports it) --> - <disable-compliance-links>false</disable-compliance-links> -<!-- Render mailto: links unrecognisable by spam harvesters? --> - <obfuscate-mail-links>true</obfuscate-mail-links> - <obfuscate-mail-value>.at.</obfuscate-mail-value> -<!-- Disable the javascript facility to change the font size --> - <disable-font-script>true</disable-font-script> -<!-- mandatory project logo - default skin: renders it at the top --> - <project-name>MyProject</project-name> - <project-description>MyProject Description</project-description> - <project-url>http://myproj.mygroup.org/</project-url> - <project-logo>images/project.png</project-logo> -<!-- Alternative static image: - <project-logo>images/project-logo.gif</project-logo> --> -<!-- optional group logo - default skin: renders it at the top-left corner --> - <group-name>MyGroup</group-name> - <group-description>MyGroup Description</group-description> - <group-url>http://mygroup.org</group-url> - <group-logo>images/group.png</group-logo> -<!-- Alternative static image: - <group-logo>images/group-logo.gif</group-logo> --> -<!-- optional host logo (e.g. sourceforge logo) - default skin: renders it at the bottom-left corner --> - <host-url></host-url> - <host-logo></host-logo> -<!-- relative url of a favicon file, normally favicon.ico --> - <favicon-url></favicon-url> -<!-- The following are used to construct a copyright statement --> - <disable-copyright-footer>false</disable-copyright-footer> -<!-- @inception enable automatic generation of a date-range to current date --> - <year inception="true">2005</year> - <vendor>The Example Organisation.</vendor> -<!-- The optional copyright-link URL will be used as a link in the - copyright statement --> - <copyright-link>http://www.example.org/</copyright-link> -<!-- Some skins use this to form a 'breadcrumb trail' of links. - Use location="alt" to move the trail to an alternate location - (if the skin supports it). - Omit the location attribute to display the trail in the default location. - Use location="none" to not display the trail (if the skin supports it). - For some skins just set the attributes to blank. - - NOTE: If a breadcrumb entry points at a local file the href must - be complete, that is it must point to the file itself, not to a - directory. - --> - <trail> - <link1 name="myGroup" href="http://www.apache.org/"/> - <link2 name="myProject" href="http://forrest.apache.org/"/> - <link3 name="" href=""/> - </trail> -<!-- Configure the TOC, i.e. the Table of Contents. - @max-depth - how many "section" levels need to be included in the - generated Table of Contents (TOC). - @min-sections - Minimum required to create a TOC. - @location ("page","menu","page,menu", "none") - Where to show the TOC. - --> - <toc max-depth="2" min-sections="1" location="page"/> -<!-- Heading types can be clean|underlined|boxed --> - <headings type="boxed"/> -<!-- The optional feedback element will be used to construct a - feedback link in the footer with the page pathname appended: - <a href="@href">{@to}</a> - --> - <feedback to="webmaster@foo.com" - href="mailto:webmaster@foo.com?subject=Feedback " > - Send feedback about the website to: - </feedback> -<!-- Optional message of the day (MOTD). - Note: This is only implemented in the pelt skin. - Note: Beware issue FOR-677 if you use an absolute path uri. - If the optional <motd> element is used, then messages will be appended - depending on the URI string pattern. - motd-option : Each option will match a pattern and apply its text. - The "pattern" attribute specifies the pattern to be matched. - This can be a specific page, or a general pattern to match a set of pages, - e.g. everything in the "samples" directory. - The @starts-with=true anchors the string to the start, otherwise contains - motd-title : This text will betadded in brackets after the <html><title> - and this can be empty. - motd-page : This text will be added in a panel on the face of the page, - with the "motd-page-url" being the hyperlink "More". - Values for the "location" attribute are: - page : on the face of the page, e.g. in the spare space of the toc - alt : at the bottom of the left-hand navigation panel - both : both - --> - <motd> - <motd-option pattern="samples/sample.html"> - <motd-title>sample</motd-title> - <motd-page location="both"> - This is an example of a Message of the day (MOTD). - </motd-page> - <motd-page-url>faq.html</motd-page-url> - </motd-option> - <motd-option pattern="samples/faq.html"> - <motd-page location="page"> - How to enable this MOTD is on this page. - </motd-page> - <motd-page-url>http://forrest.apache.org/docs/faq.html</motd-page-url> - </motd-option> - </motd> -<!-- - extra-css - here you can define custom css-elements that are - A) overriding the fallback elements or - B) adding the css definition from new elements that you may have - used in your documentation. - --> - <extra-css> -<!--Example of reason B: - To define the css definition of a new element that you may have used - in the class attribute of a <p> node. - e.g. <p class="quote"/> - --> - p.quote { - margin-left: 2em; - padding: .5em; - background-color: #f0f0f0; - font-family: monospace; - } - <!--Example: - To override the colours of links only in the footer. - --> - #footer a { color: #0F3660; } - #footer a:visited { color: #009999; } - </extra-css> - <colors> -<!-- These values are used for the generated CSS files. - They essentially "override" the default colors defined in the chosen skin. - There are four duplicate "groups" of colors below, denoted by comments: - Color group: Forrest, Krysalis, Collabnet, and Lenya using Pelt. - They are provided for example only. To customize the colors of any skin, - uncomment one of these groups of color elements and change the values - of the particular color elements that you wish to change. - Note that by default, all color groups are commented-out which means that - the default colors provided by the skin are being used. - --> -<!-- Color group: Forrest: example colors similar to forrest.apache.org - Some of the element names are obscure, so comments are added to show how - the "pelt" skin uses them, other skins might use these elements in a different way. - Tip: temporarily change the value of an element to red (#ff0000) and see the effect. - pelt: breadtrail: the strip at the top of the page and the second strip under the tabs - pelt: header: top strip containing project and group logos - pelt: heading|subheading: section headings within the content - pelt: navstrip: the strip under the tabs which contains the published date - pelt: menu: the left-hand navigation panel - pelt: toolbox: the selected menu item - pelt: searchbox: the background of the searchbox - pelt: border: line border around selected menu item - pelt: body: any remaining parts, e.g. the bottom of the page - pelt: footer: the second from bottom strip containing credit logos and published date - pelt: feedback: the optional bottom strip containing feedback link - --> -<!-- - <color name="breadtrail" value="#cedfef" font="#0F3660" link="#0F3660" vlink="#0F3660" hlink="#000066"/> - <color name="header" value="#294563"/> - <color name="tab-selected" value="#4a6d8c" link="#0F3660" vlink="#0F3660" hlink="#000066"/> - <color name="tab-unselected" value="#b5c7e7" link="#0F3660" vlink="#0F3660" hlink="#000066"/> - <color name="subtab-selected" value="#4a6d8c" link="#0F3660" vlink="#0F3660" hlink="#000066"/> - <color name="subtab-unselected" value="#4a6d8c" link="#0F3660" vlink="#0F3660" hlink="#000066"/> - <color name="heading" value="#294563"/> - <color name="subheading" value="#4a6d8c"/> - <color name="published" value="#4C6C8F" font="#FFFFFF"/> - <color name="feedback" value="#4C6C8F" font="#FFFFFF" align="center"/> - <color name="navstrip" value="#4a6d8c" font="#ffffff" link="#0F3660" vlink="#0F3660" hlink="#000066"/> - <color name="menu" value="#4a6d8c" font="#cedfef" link="#ffffff" vlink="#ffffff" hlink="#ffcf00"/> - <color name="toolbox" value="#4a6d8c"/> - <color name="border" value="#294563"/> - <color name="dialog" value="#4a6d8c"/> - <color name="searchbox" value="#4a6d8c" font="#000000"/> - <color name="body" value="#ffffff" link="#0F3660" vlink="#009999" hlink="#000066"/> - <color name="table" value="#7099C5"/> - <color name="table-cell" value="#f0f0ff"/> - <color name="highlight" value="#ffff00"/> - <color name="fixme" value="#cc6600"/> - <color name="note" value="#006699"/> - <color name="warning" value="#990000"/> - <color name="code" value="#CFDCED"/> - <color name="footer" value="#cedfef"/> ---> -<!-- Color group: Krysalis --> -<!-- - <color name="header" value="#FFFFFF"/> - - <color name="tab-selected" value="#a5b6c6" link="#000000" vlink="#000000" hlink="#000000"/> - <color name="tab-unselected" value="#F7F7F7" link="#000000" vlink="#000000" hlink="#000000"/> - <color name="subtab-selected" value="#a5b6c6" link="#000000" vlink="#000000" hlink="#000000"/> - <color name="subtab-unselected" value="#a5b6c6" link="#000000" vlink="#000000" hlink="#000000"/> - - <color name="heading" value="#a5b6c6"/> - <color name="subheading" value="#CFDCED"/> - - <color name="navstrip" value="#CFDCED" font="#000000" link="#000000" vlink="#000000" hlink="#000000"/> - <color name="toolbox" value="#a5b6c6"/> - <color name="border" value="#a5b6c6"/> - - <color name="menu" value="#F7F7F7" link="#000000" vlink="#000000" hlink="#000000"/> - <color name="dialog" value="#F7F7F7"/> - - <color name="body" value="#ffffff" link="#0F3660" vlink="#009999" hlink="#000066"/> - - <color name="table" value="#a5b6c6"/> - <color name="table-cell" value="#ffffff"/> - <color name="highlight" value="#ffff00"/> - <color name="fixme" value="#cc6600"/> - <color name="note" value="#006699"/> - <color name="warning" value="#990000"/> - <color name="code" value="#a5b6c6"/> - - <color name="footer" value="#a5b6c6"/> ---> -<!-- Color group: Collabnet --> -<!-- - <color name="header" value="#003366"/> - - <color name="tab-selected" value="#dddddd" link="#555555" vlink="#555555" hlink="#555555"/> - <color name="tab-unselected" value="#999999" link="#ffffff" vlink="#ffffff" hlink="#ffffff"/> - <color name="subtab-selected" value="#cccccc" link="#000000" vlink="#000000" hlink="#000000"/> - <color name="subtab-unselected" value="#cccccc" link="#555555" vlink="#555555" hlink="#555555"/> - - <color name="heading" value="#003366"/> - <color name="subheading" value="#888888"/> - - <color name="navstrip" value="#dddddd" font="#555555"/> - <color name="toolbox" value="#dddddd" font="#555555"/> - <color name="border" value="#999999"/> - - <color name="menu" value="#ffffff"/> - <color name="dialog" value="#eeeeee"/> - - <color name="body" value="#ffffff"/> - - <color name="table" value="#ccc"/> - <color name="table-cell" value="#ffffff"/> - <color name="highlight" value="#ffff00"/> - <color name="fixme" value="#cc6600"/> - <color name="note" value="#006699"/> - <color name="warning" value="#990000"/> - <color name="code" value="#003366"/> - - <color name="footer" value="#ffffff"/> ---> -<!-- Color group: Lenya using pelt--> -<!-- - - <color name="header" value="#ffffff"/> - - <color name="tab-selected" value="#E5E4D9" link="#000000" vlink="#000000" hlink="#000000"/> - <color name="tab-unselected" value="#F5F4E9" link="#000000" vlink="#000000" hlink="#000000"/> - <color name="subtab-selected" value="#000000" link="#000000" vlink="#000000" hlink="#000000"/> - <color name="subtab-unselected" value="#E5E4D9" link="#000000" vlink="#000000" hlink="#000000"/> - - <color name="heading" value="#E5E4D9"/> - <color name="subheading" value="#000000"/> - <color name="published" value="#000000"/> - <color name="navstrip" value="#E5E4D9" font="#000000"/> - <color name="toolbox" value="#CFDCED" font="#000000"/> - <color name="border" value="#999999"/> - - <color name="menu" value="#E5E4D9" font="#000000" link="#000000" vlink="#000000" hlink="#000000"/> - <color name="dialog" value="#CFDCED"/> - <color name="body" value="#ffffff" /> - - <color name="table" value="#ccc"/> - <color name="table-cell" value="#ffffff"/> - <color name="highlight" value="#ffff00"/> - <color name="fixme" value="#cc6600"/> - <color name="note" value="#006699"/> - <color name="warning" value="#990000"/> - <color name="code" value="#003366"/> - - <color name="footer" value="#E5E4D9"/> ---> - </colors> -<!-- Settings specific to PDF output. --> - <pdf> -<!-- - Supported page sizes are a0, a1, a2, a3, a4, a5, executive, - folio, legal, ledger, letter, quarto, tabloid (default letter). - Supported page orientations are portrait, landscape (default - portrait). - Supported text alignments are left, right, justify (default left). - --> - <page size="letter" orientation="portrait" text-align="left"/> -<!-- - Pattern of the page numbering in the footer - Default is "Page x". - first occurrence of '1' digit represents the current page number, - second occurrence of '1' digit represents the total page number, - anything else is considered as the static part of the numbering pattern. - Examples : x is the current page number, y the total page number. - <page-numbering-format>none</page-numbering-format> Do not displays the page numbering - <page-numbering-format>1</page-numbering-format> Displays "x" - <page-numbering-format>p1.</page-numbering-format> Displays "px." - <page-numbering-format>Page 1/1</page-numbering-format> Displays "Page x/y" - <page-numbering-format>(1-1)</page-numbering-format> Displays "(x-y)" - --> - <page-numbering-format>Page 1</page-numbering-format> -<!-- - Margins can be specified for top, bottom, inner, and outer - edges. If double-sided="false", the inner edge is always left - and the outer is always right. If double-sided="true", the - inner edge will be left on odd pages, right on even pages, - the outer edge vice versa. - Specified below are the default settings. - --> - <margins double-sided="false"> - <top>1in</top> - <bottom>1in</bottom> - <inner>1.25in</inner> - <outer>1in</outer> - </margins> -<!-- - Print the URL text next to all links going outside the file - --> - <show-external-urls>false</show-external-urls> -<!-- - Disable the copyright footer on each page of the PDF. - A footer is composed for each page. By default, a "credit" with role=pdf - will be used, as explained below. Otherwise a copyright statement - will be generated. This latter can be disabled. - --> - <disable-copyright-footer>false</disable-copyright-footer> - </pdf> -<!-- - Credits are typically rendered as a set of small clickable - images in the page footer. - - Use box-location="alt" to move the credits to an alternate location - (if the skin supports it). - - For example, pelt skin: - - box-location="alt" will place the logo at the end of the - left-hand coloured menu panel. - - box-location="alt2" will place them underneath that panel - in the left-hand whitespace. - - Otherwise they are placed next to the compatibility icons - at the bottom of the screen. - - Comment out the whole <credit>-element if you want no credits in the - web pages - --> - <credits> - <credit box-location="alt"> - <name>Built with Apache Forrest</name> - <url>http://forrest.apache.org/</url> - <image>images/built-with-forrest-button.png</image> - <width>88</width> - <height>31</height> - </credit> -<!-- A credit with @role="pdf" will be used to compose a footer - for each page in the PDF, using either "name" or "url" or both. - --> -<!-- - <credit role="pdf"> - <name>Built with Apache Forrest</name> - <url>http://forrest.apache.org/</url> - </credit> - --> - </credits> -</skinconfig> diff --git a/translations/langcode.xml b/translations/langcode.xml deleted file mode 100755 index b11b3400d2..0000000000 --- a/translations/langcode.xml +++ /dev/null @@ -1,29 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!-- - 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. ---> -<!-- - This catalog is used so displays how the language name - is named by their speakers. ---> -<catalogue > - <message key="en">English</message> - <message key="es">Espanol</message> - <message key="it">Italiano</message> - <message key="nl">Nederlands</message> - <message key="de">Deutsch</message> - <message key="fr">Francais</message> -</catalogue> diff --git a/translations/languages_de.xml b/translations/languages_de.xml deleted file mode 100755 index 17901714d2..0000000000 --- a/translations/languages_de.xml +++ /dev/null @@ -1,24 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!-- - 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. ---> -<catalogue xml:lang="de"> - <message key="en">Englisch</message> - <message key="es">Spanisch</message> - <message key="nl">Holländisch</message> - <message key="de">Deutsch</message> - <message key="fr">Französisch</message> -</catalogue> diff --git a/translations/languages_en.xml b/translations/languages_en.xml deleted file mode 100644 index 9fb1ae7656..0000000000 --- a/translations/languages_en.xml +++ /dev/null @@ -1,24 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!-- - 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. ---> -<catalogue xml:lang="en"> - <message key="en">English</message> - <message key="es">Spanish</message> - <message key="nl">Dutch</message> - <message key="de">German</message> - <message key="fr">French</message> -</catalogue> diff --git a/translations/languages_es.xml b/translations/languages_es.xml deleted file mode 100755 index e784e2c66f..0000000000 --- a/translations/languages_es.xml +++ /dev/null @@ -1,22 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!-- - 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. ---> -<catalogue xml:lang="es"> - <message key="en">Inglés</message> - <message key="es">Español</message> - <message key="nl">Holandés</message> -</catalogue> diff --git a/translations/languages_fr.xml b/translations/languages_fr.xml deleted file mode 100755 index 30bc4efd7b..0000000000 --- a/translations/languages_fr.xml +++ /dev/null @@ -1,24 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!-- - 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. ---> -<catalogue xml:lang="fr"> - <message key="en">Anglais</message> - <message key="es">Espagnol</message> - <message key="nl">Néerlandais</message> - <message key="de">Allemand</message> - <message key="fr">Français</message> -</catalogue> diff --git a/translations/languages_nl.xml b/translations/languages_nl.xml deleted file mode 100755 index 084570668b..0000000000 --- a/translations/languages_nl.xml +++ /dev/null @@ -1,24 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!-- - 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. ---> -<catalogue xml:lang="nl"> - <message key="en">Engels</message> - <message key="es">Spaans</message> - <message key="nl">Nederlands</message> - <message key="de">Duits</message> - <message key="fr">Frans</message> -</catalogue> diff --git a/translations/menu.xml b/translations/menu.xml deleted file mode 100755 index 7d5e504c99..0000000000 --- a/translations/menu.xml +++ /dev/null @@ -1,33 +0,0 @@ -<?xml version="1.0"?> -<!-- - 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. ---> -<catalogue xml:lang="en"> - <message key="About">About</message> - <message key="Index">Index</message> - <message key="Changes">Changes</message> - <message key="Todo">Todo</message> - <message key="Samples">Samples</message> - <message key="Apache document">Apache document</message> - <message key="Static content">Static content</message> - <message key="Linking">Linking</message> - <message key="Wiki page">Wiki page</message> - <message key="ihtml page">Ihtml page</message> - <message key="ehtml page">Ehtml page</message> - <message key="FAQ">FAQ</message> - <message key="Simplifed Docbook">Simplifed Docbook</message> - <message key="XSP page">XSP page</message> -</catalogue> diff --git a/translations/menu_af.xml b/translations/menu_af.xml deleted file mode 100755 index c07a6b68b1..0000000000 --- a/translations/menu_af.xml +++ /dev/null @@ -1,33 +0,0 @@ -<?xml version="1.0"?> -<!-- - 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. ---> -<catalogue xml:lang="af"> - <message key="About">Aangaande</message> - <message key="Index">Inhoud</message> - <message key="Changes">Veranderinge</message> - <message key="Todo">Om te doen</message> - <message key="Samples">Voorbeelde</message> - <message key="Apache document">Apache dokument</message> - <message key="Static content">Statise Inhoud</message> - <message key="Linking">Linking</message> - <message key="Wiki page">Wiki bladsy</message> - <message key="ihtml page">Ihtml bladsy</message> - <message key="ehtml page">Ehtml bladsy</message> - <message key="FAQ">FAQ</message> - <message key="Simplifed Docbook">Vereenvoudigde Docbook</message> - <message key="XSP page">XSP bladsy</message> -</catalogue> diff --git a/translations/menu_de.xml b/translations/menu_de.xml deleted file mode 100755 index 237c1f6dc2..0000000000 --- a/translations/menu_de.xml +++ /dev/null @@ -1,33 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!-- - 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. ---> -<catalogue xml:lang="de"> - <message key="About">Über</message> - <message key="Index">Index</message> - <message key="Changes">Änderungen </message> - <message key="Todo">Todo</message> - <message key="Samples">Beispiele</message> - <message key="Apache document">Apache Dokumentationsseite</message> - <message key="Static content">Statischer Inhalt</message> - <message key="Linking">Linking</message> - <message key="Wiki page">Wiki Seite</message> - <message key="ihtml page">ihtml Seite</message> - <message key="ehtml page">ehtml Seite</message> - <message key="FAQ">FAQ</message> - <message key="Simplifed Docbook">Vereinfachte Docbook</message> - <message key="XSP page">XSP Seite</message> -</catalogue> diff --git a/translations/menu_es.xml b/translations/menu_es.xml deleted file mode 100755 index 622048418e..0000000000 --- a/translations/menu_es.xml +++ /dev/null @@ -1,33 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!-- - 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. ---> -<catalogue xml:lang="es"> - <message key="About">Acerca de</message> - <message key="Index">Indice</message> - <message key="Changes">Cambios</message> - <message key="Todo">Tareas pendientes</message> - <message key="Samples">Ejemplos</message> - <message key="Apache document">Documento Apache</message> - <message key="Static content">Contenido Estático</message> - <message key="Linking">Linking</message> - <message key="Wiki page">Página Wiki</message> - <message key="ihtml page">Página ihtml</message> - <message key="ehtml page">Página ehtml</message> - <message key="FAQ">Preguntas Frecuentes</message> - <message key="Simplifed Docbook">Página Simplifed Docbook</message> - <message key="XSP page">Página XSP</message> -</catalogue> diff --git a/translations/menu_fr.xml b/translations/menu_fr.xml deleted file mode 100755 index c318bb591f..0000000000 --- a/translations/menu_fr.xml +++ /dev/null @@ -1,33 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!-- - 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. ---> -<catalogue xml:lang="de"> - <message key="About">A propos</message> - <message key="Index">Index</message> - <message key="Changes">Modifications</message> - <message key="Todo">A faire</message> - <message key="Samples">Exemples </message> - <message key="Apache document">Document Apache</message> - <message key="Static content">Contenu statique</message> - <message key="Linking">Gestion des liens</message> - <message key="Wiki page">Page wiki</message> - <message key="ihtml page">Page ihtml</message> - <message key="ehtml page">Page ehtml</message> - <message key="FAQ">FAQ</message> - <message key="Simplifed Docbook">Docbook simplifié</message> - <message key="XSP page">Page XSP</message> -</catalogue> diff --git a/translations/menu_it.xml b/translations/menu_it.xml deleted file mode 100755 index 12e6966e91..0000000000 --- a/translations/menu_it.xml +++ /dev/null @@ -1,33 +0,0 @@ -<?xml version="1.0"?> -<!-- - 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. ---> -<catalogue xml:lang="it"> - <message key="About">Riguardo a</message> - <message key="Index">Indice</message> - <message key="Changes">Cambiamenti</message> - <message key="Todo">Cose da fare</message> - <message key="Samples">Esempi</message> - <message key="Apache document">Apache document</message> - <message key="Static content">Contenuto Statico</message> - <message key="Linking">Linking</message> - <message key="Wiki page">Pagina Wiki</message> - <message key="ihtml page">Pagina ihtml</message> - <message key="ehtml page">Pagina ehtml</message> - <message key="FAQ">Domande frequenti</message> - <message key="Simplifed Docbook">Simplifed Docbook</message> - <message key="XSP page">Pagina XSP</message> -</catalogue> diff --git a/translations/menu_nl.xml b/translations/menu_nl.xml deleted file mode 100755 index 19800a2d73..0000000000 --- a/translations/menu_nl.xml +++ /dev/null @@ -1,33 +0,0 @@ -<?xml version="1.0"?> -<!-- - 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. ---> -<catalogue xml:lang="nl"> - <message key="About">Over</message> - <message key="Index">Index</message> - <message key="Changes">Wijzigingen</message> - <message key="Todo">Nog te doen</message> - <message key="Samples">Voorbeelden</message> - <message key="Apache document">Apache document</message> - <message key="Static content">Statische inhoud</message> - <message key="Linking">Linken</message> - <message key="Wiki page">Wiki pagina</message> - <message key="ihtml page">Ihtml pagina</message> - <message key="ehtml page">Ehtml pagina</message> - <message key="FAQ">FAQ</message> - <message key="Simplifed Docbook">Vereenvoudigd Docbook</message> - <message key="XSP page">XSP pagina</message> -</catalogue> diff --git a/translations/menu_no.xml b/translations/menu_no.xml deleted file mode 100755 index c091bbace0..0000000000 --- a/translations/menu_no.xml +++ /dev/null @@ -1,33 +0,0 @@ -<?xml version="1.0"?> -<!-- - 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. ---> -<catalogue xml:lang="no"> - <message key="About">Om</message> - <message key="Index">Indeks</message> - <message key="Changes">Endringer</message> - <message key="Todo">Oppgave liste</message> - <message key="Samples">Eksempler</message> - <message key="Apache document">Apache Dokument</message> - <message key="Static content">Statisk innhold</message> - <message key="Linking">Linking</message> - <message key="Wiki page">Wiki side</message> - <message key="ihtml page">ihtml side</message> - <message key="ehtml page">ehtml side</message> - <message key="FAQ">FAQ</message> - <message key="Simplifed Docbook">Simplifed Docbook</message> - <message key="XSP page">XSP side</message> -</catalogue> diff --git a/translations/menu_ru.xml b/translations/menu_ru.xml deleted file mode 100755 index 80887e4534..0000000000 --- a/translations/menu_ru.xml +++ /dev/null @@ -1,33 +0,0 @@ -<?xml version="1.0"?> -<!-- - 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. ---> -<catalogue xml:lang="ru"> - <message key="About">О проекте</message> - <message key="Index">Содержание</message> - <message key="Changes">Изменения</message> - <message key="Todo">План</message> - <message key="Samples">Примеры</message> - <message key="Apache document">Страница документа Apache</message> - <message key="Static content">Статическое содержание</message> - <message key="Linking">Linking</message> - <message key="Wiki page">Страница Wiki</message> - <message key="ihtml page">Страница ihtml</message> - <message key="ehtml page">Страница ehtml</message> - <message key="FAQ">Вопросы/Ответы</message> - <message key="Simplifed Docbook">Docbook страница</message> - <message key="XSP page">XSP страница</message> -</catalogue> diff --git a/translations/menu_sk.xml b/translations/menu_sk.xml deleted file mode 100755 index 4bf7d624f9..0000000000 --- a/translations/menu_sk.xml +++ /dev/null @@ -1,33 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!-- - 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. ---> -<catalogue xml:lang="sk"> - <message key="About">O programe</message> - <message key="Index">Zoznám</message> - <message key="Changes">Zmeny</message> - <message key="Todo">Úlohy</message> - <message key="Samples">Príklady</message> - <message key="Apache document">Apache Document</message> - <message key="Static content">Statický Obsah</message> - <message key="Linking">Linking</message> - <message key="Wiki page">Wiki stránka</message> - <message key="ihtml page">ihtml stránka</message> - <message key="ehtml page">ehtml stránka</message> - <message key="FAQ">Casté Otázky</message> - <message key="Simplifed Docbook">Simplifed Docbook stránka</message> - <message key="XSP page">XSP stránka</message> -</catalogue> diff --git a/translations/tabs.xml b/translations/tabs.xml deleted file mode 100755 index a5e10030a5..0000000000 --- a/translations/tabs.xml +++ /dev/null @@ -1,22 +0,0 @@ -<?xml version="1.0"?> -<!-- - 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. ---> -<catalogue xml:lang="en"> - <message key="Home">Home</message> - <message key="Samples">Samples</message> - <message key="Apache XML Projects">Apache XML Projects</message> -</catalogue> diff --git a/translations/tabs_de.xml b/translations/tabs_de.xml deleted file mode 100755 index 19f7d94508..0000000000 --- a/translations/tabs_de.xml +++ /dev/null @@ -1,22 +0,0 @@ -<?xml version="1.0"?> -<!-- - 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. ---> -<catalogue xml:lang="de"> - <message key="Home">Home</message> - <message key="Samples">Beispiele</message> - <message key="Apache XML Projects">Apache XML Projekte</message> -</catalogue> diff --git a/translations/tabs_es.xml b/translations/tabs_es.xml deleted file mode 100755 index d273249151..0000000000 --- a/translations/tabs_es.xml +++ /dev/null @@ -1,22 +0,0 @@ -<?xml version="1.0"?> -<!-- - 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. ---> -<catalogue xml:lang="es"> - <message key="Home">Inicio</message> - <message key="Samples">Ejemplos</message> - <message key="Apache XML Projects">Projectos XML Apache</message> -</catalogue> diff --git a/translations/tabs_fr.xml b/translations/tabs_fr.xml deleted file mode 100755 index 73ef5e2395..0000000000 --- a/translations/tabs_fr.xml +++ /dev/null @@ -1,22 +0,0 @@ -<?xml version="1.0"?> -<!-- - 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. ---> -<catalogue xml:lang="fr"> - <message key="Home">Accueil</message> - <message key="Samples">Exemples</message> - <message key="Apache XML Projects">Projets Apache XML</message> -</catalogue> diff --git a/translations/tabs_nl.xml b/translations/tabs_nl.xml deleted file mode 100755 index b474c5ca6d..0000000000 --- a/translations/tabs_nl.xml +++ /dev/null @@ -1,22 +0,0 @@ -<?xml version="1.0"?> -<!-- - 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. ---> -<catalogue xml:lang="nl"> - <message key="Home">Home</message> - <message key="Samples">Voorbeelden</message> - <message key="Apache XML Projects">Apache XML Projecten</message> -</catalogue> |
