You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@qpid.apache.org by kp...@apache.org on 2017/12/05 23:18:41 UTC
[1/2] qpid-site git commit: Added content pages for Qpid Interop Test
Repository: qpid-site
Updated Branches:
refs/heads/asf-site ed98eeda0 -> 3ef7d3097
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/3ef7d309/input/releases/qpid-interop-test-0.1.0/QUICKSTART.md
----------------------------------------------------------------------
diff --git a/input/releases/qpid-interop-test-0.1.0/QUICKSTART.md b/input/releases/qpid-interop-test-0.1.0/QUICKSTART.md
new file mode 100644
index 0000000..94e457a
--- /dev/null
+++ b/input/releases/qpid-interop-test-0.1.0/QUICKSTART.md
@@ -0,0 +1,234 @@
+<!--
+
+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.
+
+-->
+
+# QUICKSTART GUIDE
+
+You must build *and install* qpid-interop-test before you can run the tests.
+
+By default, qpid-interop-test will install to /usr/local, but you can set any
+non-priviedged directory as the install prefix using the CMAKE_INSTALL_PREFIX
+environment variable, for example $HOME/install.
+
+The following tools are needed to build qpid-interop-test:
+
+ * git
+ * gcc-c++
+ * Python 2.7.x
+ * cmake
+ * Java JDK
+ * Maven
+ * JSON cpp
+
+The following Qpid components must be installed *before* you build and install
+qpid-interop-test:
+
+ * Qpid Proton (including C++ Proton API)
+ * Qpid Python
+
+The following are not required, but if installed and present, will be tested:
+
+ * Rhea (a Javascript client, also requires npm and nodejs)
+ * AMQP.Net Lite (requires mono)
+
+Pre-requisites can be installed using the standard system package manager (yum,
+dnf, apt-get etc.) OR built from source and installed.
+
+These are the install steps:
+
+1. Install prerequisites, from packages or source
+2. Install or download / build AMQP brokers to test against (or set up networked brokers)
+3. Build qpid-interop-test
+4. Run the tests
+
+## 1. Install prerequisites
+
+### 1.1 RHEL6
+
+Currently RHEL6 is not supported because it uses Python 2.6.x, and the test code uses
+features of Python 2.7.x. This may be supported in a future release.
+
+### 1.2 RHEL7
+
+From a clean install:
+
+````
+yum install cmake maven java-1.8.0-openjdk-devel perl-XML-XPath
+````
+
+Some packages will need to be downloaded from [EPEL](https://fedoraproject.org/wiki/EPEL).
+To set up the EPEL repo in yum:
+
+````
+wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
+rpm -ivh epel-release-latest-6.noarch.rpm
+````
+
+then install the following packages:
+
+````
+yum install jsoncpp-devel nodejs-rhea qpid-proton-cpp-devel python-qpid-proton
+````
+
+### 1.3 Fedora 26
+
+All packages are available directly from the Fedora repositories:
+
+````
+dnf install gcc-c++ cmake maven java-1.8.0-openjdk-devel perl-XML-XPath jsoncpp-devel nodejs-rhea qpid-proton-cpp-devel python-qpid-proton
+````
+
+## 2. Obtaining a broker
+
+Qpid-interop-test requires a running broker to be available. This
+may be on localhost as a local install or build, or on another machine, in which case its
+IP addresss must be known. Some local broker install options are:
+
+### 2.1 ActiveMQ 5
+
+Download from [Apache](http://activemq.apache.org/download.html).
+
+Make the following changes to the `activemq.xml` config file: For XML element
+`broker.transportConnectors.transportConnector@name="amqp"` add the attribute
+`wireFormat.allowNonSaslConnections=true`. ie:
+
+````
+<transportConnector name="amqp" uri="amqp://0.0.0.0:5672?maximumConnections=1000&wireFormat.maxFrameSize=1048576000&wireFormat.allowNonSaslConnections=true"/>
+````
+
+### 2.2 Artemis
+
+Download from [Apache](https://activemq.apache.org/artemis/download.html).
+
+### 2.3 Qpid cpp broker
+
+ yum install qpid-cpp-server
+
+and set the configuration file in /etc/qpid/qpidd.conf as follows:
+
+````
+auth=no
+queue-patterns=jms.queue.qpid-interop
+````
+
+### 2.4 Qpid Dispatch Router
+
+ yum install qpid-dispatch-router
+
+and add the following to the config file in /etc/qpid-dispatch/qdrouterd.conf:
+
+````
+listener {
+ host: ::1
+ port: amqp
+ authenticatePeer: no
+ saslMechanisms: ANONYMOUS
+}
+
+````
+
+## 3. Install qpid-interop-test
+
+Qpid-interop-test may be installed locally (preferred for local builds) or to the system
+(which requires root privileges). For a local install, use the `-DCMAKE_INSTALL_PREFIX`
+option to the `cmake` command. If it is omitted, then qpid-interop-test will be installed
+into the default system directories. The source may be unpacked, or (if you need to use the
+latest and greatest), cloned from git:
+
+````
+git clone https://git-wip-us.apache.org/repos/asf/qpid-interop-test.git
+````
+
+Assuming the source tree is located in directory {{qpid-interop-test}}:
+
+````
+cd qpid-interop-test
+mkdir build
+cd build
+````
+For a local install:
+
+````
+cmake -DCMAKE_INSTALL_PREFIX=<abs-path-to-local-install-dir> ..
+make install
+````
+
+For a system install, root privileges are required:
+
+````
+cmake ..
+make
+sudo make install
+
+````
+
+## 4. Run the tests
+
+### 4.1 Set the environment
+
+The config.sh script is in the qpid-interop-test build directory:
+
+````
+source build/config.sh
+````
+
+### 4.2 Start the test broker
+
+If the broker is at a remote location rather than localhost, the IP address must be known. In tests using
+the Qpid Dispatch Router, then the entire broker network must be running before the tests are run. The IP
+addresses of the sender (the broker to which messages are being sent) and receiver (the broker from which
+messages will be received) must be known.
+
+### 4.3 Run chosen tests
+
+The available tests are:
+
+| Module | Description | Clients |
+| ------ | ----------- | ------- |
+| amqp_large_content_test | Tests implementation of large messages up to 10MB | C++ Python AMQP.NetLite |
+| amqp_types_test | Tests the implementation of AMQP 1.0 types | C++ Python Rhea AMQP.NetLite |
+| jms_hdrs_props_test | Tests JMS headers and properties | C++ JMS Python |
+| jms_messages_test | Tests all JMS message types (except ObjectMessage) | C++ JMS Python |
+
+The preferred method to run the tests is using the Python module option as follows:
+
+````
+python -m qpid_interop_test.amqp_types_test
+python -m qpid_interop_test.jms_messages_test
+...
+````
+
+If the broker is remote, use the following to point to the broker(s):
+
+````
+python -m qpid_interop_test.amqp_types_test --sender <broker-ip-addr> --receiver <broker-ip-addr>
+python -m qpid_interop_test.jms_messages_test --sender <broker-ip-addr> --receiver <broker-ip-addr>
+...
+````
+
+In tests using the Qpid dispatch router, a multi-node configuration may be set up such that messages
+are sent to a different broker to that from which they will be received. For example, to send to
+broker A and receive from broker B:
+
+````
+python -m qpid_interop_test.amqp_types_test --sender <broker-ip-addr-A> --receiver <broker-ip-addr-B>
+python -m qpid_interop_test.jms_messages_test --sender <broker-ip-addr-A> --receiver <broker-ip-addr-B>
+...
+````
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/3ef7d309/input/releases/qpid-interop-test-0.1.0/index.md
----------------------------------------------------------------------
diff --git a/input/releases/qpid-interop-test-0.1.0/index.md b/input/releases/qpid-interop-test-0.1.0/index.md
new file mode 100644
index 0000000..e025179
--- /dev/null
+++ b/input/releases/qpid-interop-test-0.1.0/index.md
@@ -0,0 +1,61 @@
+;;
+;; 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.
+;;
+
+# Qpid Interop Test 0.1.0
+
+Qpid Interop Test is a suite of AMQP interoperability tests. More
+about [Qpid Interop
+Test]({{site_url}}/components/interop-test/index.html).
+
+For a detailed list of the changes in this release, see the [release
+notes](release-notes.html).
+
+## Downloads
+
+It's important to [verify the
+integrity]({{site_url}}/download.html#verify-what-you-download) of
+the files you download.
+
+| Content | Download | Verify |
+|---------|----------|--------|
+| Interop Test | [qpid-interop-test-0.1.0.tar.gz](http://archive.apache.org/dist/qpid/interop-test/0.1.0/qpid-interop-test-0.1.0.tar.gz) | [PGP](http://archive.apache.org/dist/qpid/interop-test/0.1.0/qpid-interop-test-0.1.0.tar.gz.asc) |
+
+## Documentation
+
+
+ - [Quickstart guide](QUICKSTART.html)
+ - [User guide](users-guide.html)
+ - [Developer overview](https://git-wip-us.apache.org/repos/asf?p=qpid-interop-test.git;a=blob_plain;f=docs/qpid-interop-test-devel-overview.txt;hb=0.1.0)
+ - [Test HOWTO](https://git-wip-us.apache.org/repos/asf?p=qpid-interop-test.git;a=blob_plain;f=docs/Test_HOWTO.txt;hb=0.1.0)
+ - [Shim HOWTO](https://git-wip-us.apache.org/repos/asf?p=qpid-interop-test.git;a=blob_plain;f=docs/Shim_HOWTO.txt;hb=0.1.0)
+
+
+## More information
+
+ - [All release artefacts](http://archive.apache.org/dist/qpid/interop-test/0.1.0)
+ - [Resolved issues in JIRA](https://issues.apache.org/jira/issues/?jql=project+%3D+QPIDIT+AND+fixVersion+%3D+%270.1.0%27+AND+resolution+%3D+%27fixed%27+ORDER+BY+priority+DESC)
+ - [Source repository tag](https://git-wip-us.apache.org/repos/asf/qpid-interop-test.git/tree/refs/tags/0.1.0)
+
+<script type="text/javascript">
+ _deferredFunctions.push(function() {
+ if ("0.1.0" === "{{current_interop_test_release}}") {
+ _modifyCurrentReleaseLinks();
+ }
+ });
+</script>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/3ef7d309/input/releases/qpid-interop-test-0.1.0/release-notes.md
----------------------------------------------------------------------
diff --git a/input/releases/qpid-interop-test-0.1.0/release-notes.md b/input/releases/qpid-interop-test-0.1.0/release-notes.md
new file mode 100644
index 0000000..77e22e9
--- /dev/null
+++ b/input/releases/qpid-interop-test-0.1.0/release-notes.md
@@ -0,0 +1,74 @@
+;;
+;; 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.
+;;
+
+# Qpid Interop Test 0.1.0 Release Notes
+
+Qpid Interop Test is a suite of AMQP interoperability tests. More
+about [Qpid Interop
+Test]({{site_url}}/components/interop-test/index.html).
+
+For more information about this release, including download links and
+documentation, see the [release overview](index.html).
+
+
+## New features and improvements
+
+ - [QPIDIT-20](https://issues.apache.org/jira/browse/QPIDIT-20) - Add ability to detect broker, skip tests that fail for that broker
+ - [QPIDIT-21](https://issues.apache.org/jira/browse/QPIDIT-21) - Add shims for C++ client
+ - [QPIDIT-22](https://issues.apache.org/jira/browse/QPIDIT-22) - Add ability to run on Jenkins CI
+ - [QPIDIT-32](https://issues.apache.org/jira/browse/QPIDIT-32) - Use Maven to build Java components
+ - [QPIDIT-33](https://issues.apache.org/jira/browse/QPIDIT-33) - Add JMS message headers and properties to test suite
+ - [QPIDIT-41](https://issues.apache.org/jira/browse/QPIDIT-41) - Rearrange test directory structure to better organize tests and shims
+ - [QPIDIT-42](https://issues.apache.org/jira/browse/QPIDIT-42) - Split JMS message test into two separate tests: message bodies, and message headers/properties
+ - [QPIDIT-44](https://issues.apache.org/jira/browse/QPIDIT-44) - Add AMQP large content test
+ - [QPIDIT-53](https://issues.apache.org/jira/browse/QPIDIT-53) - Eliminate use of authentication when collecting broker connection properties
+ - [QPIDIT-84](https://issues.apache.org/jira/browse/QPIDIT-84) - Update README, QUICKSTART, add a users' guide
+ - [QPIDIT-96](https://issues.apache.org/jira/browse/QPIDIT-96) - Improvements in Java component management
+ - [QPIDIT-98](https://issues.apache.org/jira/browse/QPIDIT-98) - Change Proton C++ Receiver shims to use latest non-deprecated API calls
+
+## Bugs fixed
+
+ - [QPIDIT-24](https://issues.apache.org/jira/browse/QPIDIT-24) - Broker identification failure blocks tests
+ - [QPIDIT-34](https://issues.apache.org/jira/browse/QPIDIT-34) - Update to jsoncpp text format has broken test harness for all C++ shims
+ - [QPIDIT-38](https://issues.apache.org/jira/browse/QPIDIT-38) - Artemis broker-added properties not handled correctly in python receive shim
+ - [QPIDIT-40](https://issues.apache.org/jira/browse/QPIDIT-40) - Sender and Receiver threads don't stop when tests end in some error conditions
+ - [QPIDIT-51](https://issues.apache.org/jira/browse/QPIDIT-51) - Method needed to skip sensing broker type
+ - [QPIDIT-55](https://issues.apache.org/jira/browse/QPIDIT-55) - Proton install dir is hard coded into cmake
+ - [QPIDIT-56](https://issues.apache.org/jira/browse/QPIDIT-56) - Rhea installs to /usr/lib regardless of cmake install dir
+ - [QPIDIT-57](https://issues.apache.org/jira/browse/QPIDIT-57) - Cmake installer should check for presence of Node.js and Rhea client
+ - [QPIDIT-66](https://issues.apache.org/jira/browse/QPIDIT-66) - Shims should install into a libexec directory, not into the Python site-packages path
+ - [QPIDIT-67](https://issues.apache.org/jira/browse/QPIDIT-67) - Compile errors after recent header cleanup in Proton C++ bindings
+ - [QPIDIT-69](https://issues.apache.org/jira/browse/QPIDIT-69) - JMS tests fail with "Import Error: no module names jms_types"
+ - [QPIDIT-73](https://issues.apache.org/jira/browse/QPIDIT-73) - Rhea shim char type broken by recent updates to Rhea
+ - [QPIDIT-82](https://issues.apache.org/jira/browse/QPIDIT-82) - JMS tests fail intermittently with null message
+ - [QPIDIT-83](https://issues.apache.org/jira/browse/QPIDIT-83) - JAVA classpath points to maven repository rather than installed location
+
+## Tasks
+
+ - [QPIDIT-1](https://issues.apache.org/jira/browse/QPIDIT-1) - Initial code import
+ - [QPIDIT-2](https://issues.apache.org/jira/browse/QPIDIT-2) - Add command-line options to control which shims and/or AMQP type combinations to run
+ - [QPIDIT-13](https://issues.apache.org/jira/browse/QPIDIT-13) - Submit patch to Proton for AMQP type support needed by ProtonPython shim
+ - [QPIDIT-16](https://issues.apache.org/jira/browse/QPIDIT-16) - Place Qpid JMS shim build management under Maven
+ - [QPIDIT-17](https://issues.apache.org/jira/browse/QPIDIT-17) - Add JMS test suite
+ - [QPIDIT-18](https://issues.apache.org/jira/browse/QPIDIT-18) - Use existing structured text representation standard for communicating between test and shims
+ - [QPIDIT-47](https://issues.apache.org/jira/browse/QPIDIT-47) - Add Rhea javascript shim for AMQP types test
+ - [QPIDIT-48](https://issues.apache.org/jira/browse/QPIDIT-48) - Add test options which allow separate addresses for the sender and receiver
+ - [QPIDIT-52](https://issues.apache.org/jira/browse/QPIDIT-52) - Make qpid-interop-test installable
+ - [QPIDIT-59](https://issues.apache.org/jira/browse/QPIDIT-59) - Create a HOWTO file on writing a new shim
+ - [QPIDIT-60](https://issues.apache.org/jira/browse/QPIDIT-60) - Create a HOWTO file on writing a new test
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/3ef7d309/input/releases/qpid-interop-test-0.1.0/users-guide.html.in
----------------------------------------------------------------------
diff --git a/input/releases/qpid-interop-test-0.1.0/users-guide.html.in b/input/releases/qpid-interop-test-0.1.0/users-guide.html.in
new file mode 100644
index 0000000..1691216
--- /dev/null
+++ b/input/releases/qpid-interop-test-0.1.0/users-guide.html.in
@@ -0,0 +1,454 @@
+<div class="quoteblock">
+<div class="title">Apache License</div>
+<div class="content">
+<div class="paragraph"><p>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</p></div>
+<div class="paragraph"><p><a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a></p></div>
+<div class="paragraph"><p>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.</p></div>
+</div>
+<div class="attribution">
+</div></div>
+<h1 id="_qpid_interoperability_test_users_guide">Qpid Interoperability Test Users Guide</h1>
+<div class="sect1">
+<h2 id="_1_introduction">1. Introduction</h2>
+<div class="sectionbody">
+<div class="paragraph"><p>qpid-interop-test is an AMQP client interoperability test suite. It tests
+various aspects of the AMQP protocol and/or test client features against
+each other to ensure that they can interoperate.</p></div>
+<div class="paragraph"><p>The test suite consists of tests and shims. Each test has a set of test-cases
+which make up the test. Each test case will pass or fail a specific feature
+or piece of functionality under test.</p></div>
+<div class="paragraph"><p>Each test has a set of shims, which are small and specific clients which
+send and receive messages, and is written using one of the client libraries
+under test. For example, the amqp_types test has shims for the following
+clients:
+* AmqpNetLite
+* ProtonCpp
+* ProtonPython
+* RheaJS</p></div>
+<div class="paragraph"><p>To obtain both self- and interoperability testing, each test program will
+run each shim against every other shim in the role of both sender and
+receiver. For the amqp-type-test example above, this will result in the
+following combinations of shims being used:</p></div>
+<div class="tableblock">
+<table rules="all"
+width="30%"
+frame="border"
+cellspacing="0" cellpadding="4">
+<col width="10%" />
+<col width="45%" />
+<col width="45%" />
+<tbody>
+<tr>
+<td align="left" valign="top"><p class="table"></p></td>
+<td align="left" valign="top"><p class="table"><strong>Sender shim</strong></p></td>
+<td align="left" valign="top"><p class="table"><strong>Receiver shim</strong></p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">1</p></td>
+<td align="left" valign="top"><p class="table">AmqpNetLite</p></td>
+<td align="left" valign="top"><p class="table">AmqpNetLite</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">2</p></td>
+<td align="left" valign="top"><p class="table">AmqpNetLite</p></td>
+<td align="left" valign="top"><p class="table">ProtonCpp</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">3</p></td>
+<td align="left" valign="top"><p class="table">AmqpNetLite</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">4</p></td>
+<td align="left" valign="top"><p class="table">AmqpNetLite</p></td>
+<td align="left" valign="top"><p class="table">RheaJS</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">5</p></td>
+<td align="left" valign="top"><p class="table">ProtonCpp</p></td>
+<td align="left" valign="top"><p class="table">AmqpNetLite</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">6</p></td>
+<td align="left" valign="top"><p class="table">ProtonCpp</p></td>
+<td align="left" valign="top"><p class="table">ProtonCpp</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">7</p></td>
+<td align="left" valign="top"><p class="table">ProtonCpp</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">8</p></td>
+<td align="left" valign="top"><p class="table">ProtonCpp</p></td>
+<td align="left" valign="top"><p class="table">RheaJS</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">9</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython</p></td>
+<td align="left" valign="top"><p class="table">AmqpNetLite</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">10</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython</p></td>
+<td align="left" valign="top"><p class="table">ProtonCpp</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">11</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">12</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython</p></td>
+<td align="left" valign="top"><p class="table">RheaJS</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">13</p></td>
+<td align="left" valign="top"><p class="table">RheaJS</p></td>
+<td align="left" valign="top"><p class="table">AmqpNetLite</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">14</p></td>
+<td align="left" valign="top"><p class="table">RheaJS</p></td>
+<td align="left" valign="top"><p class="table">ProtonCpp</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">15</p></td>
+<td align="left" valign="top"><p class="table">RheaJS</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">16</p></td>
+<td align="left" valign="top"><p class="table">RheaJS</p></td>
+<td align="left" valign="top"><p class="table">RheaJS</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="paragraph"><p>so that for each test case, 16 individual tests are run. The test program
+will by default run all the available shims against each other in this way,
+but it is possible to control which shims are used using the --include-shim
+or --exclude-shim arguments (see below).</p></div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_2_obtaining">2. Obtaining</h2>
+<div class="sectionbody">
+<div class="paragraph"><p>qpid-interop-test is an Apache Qpid project.</p></div>
+<div class="paragraph"><p>Web page: xxx</p></div>
+<div class="paragraph"><p>Download soruce: xxx</p></div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_3_building">3. Building</h2>
+<div class="sectionbody">
+<div class="sect2">
+<h3 id="_a_install_dependencies">a. Install dependencies:</h3>
+<div class="ulist"><ul>
+<li>
+<p>
+Build tools: git, gcc, cmake
+</p>
+</li>
+<li>
+<p>
+Qpid Proton: qpid-proton-c-devel
+</p>
+</li>
+</ul></div>
+</div>
+<div class="sect2">
+<h3 id="_b_decide_on_local_vs_system_install">b. Decide on local vs system install</h3>
+<div class="sect3">
+<h4 id="_local_install">Local install:</h4>
+<div class="paragraph"><p>Installs all of the Proton and QIT bits in a local directory. This is
+useful for limited testing where you don’t want to have these files
+in your system directories. Also, if you don’t have root privileges, then
+this is the only way to install. The drawback is that you may need to
+adjust some environment settings (<code>PATH</code>, <code>PYTHONPATH</code>, <code>LD_LIBRARY_PATH</code>) so
+that the test will run.</p></div>
+</div>
+<div class="sect3">
+<h4 id="_system_install">System install:</h4>
+<div class="paragraph"><p>Installs the files into traditional system locations. This type of install
+requires root privileges. As the files are located in expected locations, no
+environment settings need be made.</p></div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_c_build_qpid_proton">c. Build qpid-proton</h3>
+<div class="paragraph"><p><strong>System install:</strong></p></div>
+<div class="listingblock">
+<div class="content">
+<pre><code> $ cd qpid-proton
+ $ mkdir build
+ $ cd build
+ $ cmake ..
+ $ make
+ $ sudo make install</code></pre>
+</div></div>
+<div class="paragraph"><p><strong>Local install:</strong></p></div>
+<div class="listingblock">
+<div class="content">
+<pre><code> $ cd qpid-proton
+ $ mkdir build
+ $ cd build
+ $ cmake ..
+ $ make install</code></pre>
+</div></div>
+</div>
+<div class="sect2">
+<h3 id="_d_build_qpid_interop_test">d. Build qpid-interop-test</h3>
+<div class="paragraph"><p><strong>System install:</strong></p></div>
+<div class="listingblock">
+<div class="content">
+<pre><code> $ cd qpid-interop-test
+ $ mkdir build
+ $ cd build
+ $ cmake ..
+ $ make
+ $ sudo make install</code></pre>
+</div></div>
+<div class="paragraph"><p><strong>Local install:</strong></p></div>
+<div class="listingblock">
+<div class="content">
+<pre><code> $ cd qpid-interop-test
+ $ mkdir build
+ $ cd build
+ $ cmake ..
+ $ make install</code></pre>
+</div></div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_4_running">4. Running</h2>
+<div class="sectionbody">
+<div class="paragraph"><p>The tests assume a broker is available and running. The assumed default is at
+<code>localhost:5672</code>. For other broker location(s), use the <code>--sender</code> and <code>--receiver</code>
+arguments to specify where the clients should interact, see below.</p></div>
+<div class="paragraph"><p>The tests do not start or stop brokers.</p></div>
+<div class="paragraph"><p>There are several tests in the test suite:</p></div>
+<div class="ulist"><ul>
+<li>
+<p>
+<strong>amqp_types_test.py</strong> - Tests all of the AMQP primitive types. This primarily tests
+ the encoding and decoding of AMQP types.
+</p>
+</li>
+<li>
+<p>
+<strong>amqp_large_content_test.py</strong> - Tests large messages of various types. Messages sizes
+ are 1MB, 10MB, 100MB. Compound types (lists, maps, etc) send elements of various
+ sizes so that the total payload is the target size.
+</p>
+</li>
+<li>
+<p>
+<strong>jms_messages_test.py</strong> - Tests JMS message types (as implemented by Qpid-jms over AMQP)
+ from all the Qpid clients (including non-jms clients)
+</p>
+</li>
+<li>
+<p>
+<strong>jms_hdrs_props_test.py</strong> - Tests various combinations of JMS headers and properties
+ are correctly sent and received by the various clients.
+</p>
+</li>
+</ul></div>
+<div class="paragraph"><p>Each test is executed directly.</p></div>
+<div class="sect2">
+<h3 id="_command_line_arguments">Command-line arguments</h3>
+<div class="tableblock">
+<table rules="all"
+width="100%"
+frame="border"
+cellspacing="0" cellpadding="4">
+<caption class="title">Table 1. Common to all tests</caption>
+<col width="20%" />
+<col width="80%" />
+<tbody>
+<tr>
+<td align="left" valign="top"><p class="table"><code>--help</code></p></td>
+<td align="left" valign="top"><p class="table">Print help. This is useful for seeing the available argument options and
+ defaults for some arguments.</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table"><code>--sender</code></p></td>
+<td align="left" valign="top"><p class="table">Node to which test suite will send messages.
+ Format: <code>ip-address:port</code>
+ Default: <code>localhost:5672</code></p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table"><code>--receiver</code></p></td>
+<td align="left" valign="top"><p class="table">Node from which test suite will receive messages.
+ Format: <code>ip-address:port</code>
+ Default: <code>localhost:5672</code></p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table"><code>--no-skip</code></p></td>
+<td align="left" valign="top"><p class="table">Do not skip tests that are excluded by default for reasons of a known bug.
+ Warning: some tests may lock up of freeze rather than fail.</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table"><code>--broker-type</code></p></td>
+<td align="left" valign="top"><p class="table">Specify the broker manually, which eliminates the test connection made
+ to the broker to determine its identity through connection properties. If
+ "None" is specified, then Artemis broker will be assumed, but this will
+ change in the future when Artemis fixes the connection properties issue.
+ Format: For our current brokers: one of: "ActiveMQ", "qpid-cpp",
+ "qpid-dispatch-router". Artemis does not currently pass its name
+ in connection properties, and is equivalent to "None".</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table"><code>--include-shim</code></p></td>
+<td align="left" valign="top"><p class="table">Name of shim to include. Cannot be used together with <code>--exclude-shim</code>. May
+ be used multiple times to include more than one shim.</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table"><code>--exclude-shim</code></p></td>
+<td align="left" valign="top"><p class="table">Name of shim to exclude. Cannot be used together with <code>--include-shim</code>. May
+ be used multiple times to exclude more that one shim.</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="tableblock">
+<table rules="all"
+width="100%"
+frame="border"
+cellspacing="0" cellpadding="4">
+<caption class="title">Table 2. amqp-types-test</caption>
+<col width="20%" />
+<col width="80%" />
+<tbody>
+<tr>
+<td align="left" valign="top"><p class="table"><code>--include-type</code></p></td>
+<td align="left" valign="top"><p class="table">Name of AMQP type to include. Cannot be used together with <code>--exclude-type</code>.
+ May be used multiple times to include more than one type.</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table"><code>--exclude-type</code></p></td>
+<td align="left" valign="top"><p class="table">Name of AMQP type to exclude. Cannot be used together with <code>--include-type</code>.
+ May be used multiple times to exclude more than one type.</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="tableblock">
+<table rules="all"
+width="100%"
+frame="border"
+cellspacing="0" cellpadding="4">
+<caption class="title">Table 3. amqp-large-content-test</caption>
+<col width="100%" />
+<tbody>
+<tr>
+<td align="left" valign="top"><p class="table">No other parameters. There is currently no way to select/limit the message size, but there
+an issue open to address this limitation.</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="tableblock">
+<table rules="all"
+width="100%"
+frame="border"
+cellspacing="0" cellpadding="4">
+<caption class="title">Table 4. jms-messages-test</caption>
+<col width="20%" />
+<col width="80%" />
+<tbody>
+<tr>
+<td align="left" valign="top"><p class="table"><code>--include-type</code></p></td>
+<td align="left" valign="top"><p class="table">Name of JMS message type to include. Cannot be used together with
+ <code>--exclude-type</code>. May be used multiple times to include more than one type.</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table"><code>--exclude-type</code></p></td>
+<td align="left" valign="top"><p class="table">Name of JMS message type to exclude. Cannot be used together with
+ <code>--include-type</code>. May be used multiple times to exclude more than one type.</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="tableblock">
+<table rules="all"
+width="100%"
+frame="border"
+cellspacing="0" cellpadding="4">
+<caption class="title">Table 5. jms-hdrs-props-test</caption>
+<col width="20%" />
+<col width="80%" />
+<tbody>
+<tr>
+<td align="left" valign="top"><p class="table"><code>--include-type</code></p></td>
+<td align="left" valign="top"><p class="table">Name of Java property type to include. Cannot be used together with
+ <code>--exclude-type</code>. May be used multiple times to include more than one type.</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table"><code>--exclude-type</code></p></td>
+<td align="left" valign="top"><p class="table">Name of Java property type to exclude. Cannot be used together with
+ <code>--include-type</code>. May be used multiple times to exclude more than one type.</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="paragraph"><p>There is currently no way to control/limit the JMS header types in this test, but there is
+an issue open to address this limitation.</p></div>
+<div class="sect3">
+<h4 id="_examples">Examples:</h4>
+<div class="paragraph"><p>To limit amqp_types_test to boolean type only:
+<code>$ amqp_types_test --include-type boolean</code></p></div>
+<div class="paragraph"><p>To limit amqp_types_test to Qpid-cpp and Proton-python shims only:
+<code>$ amqp_types_test --include-shim ProtonCpp --include-shim ProtonPython</code></p></div>
+<div class="paragraph"><p>To test against a pair of Dispatch Routers and a broker running on the local machine
+as follows (first set up the brokers and routers):</p></div>
+<div class="listingblock">
+<div class="content">
+<pre><code>+----------+ 9001 +----------+ 5672 +--------+
+| sender |--------->| dispatch |-------->| |
+| shim | | router 1 | | |
++----------+ +----------+ | |
+ | broker |
++----------+ 9002 +----------+ 5672 | |
+| receiver |<---------| dispatch |<--------| |
+| shim | | router 2 | | |
++----------+ +----------+ +--------+</code></pre>
+</div></div>
+<div class="paragraph"><p><code>$ amqp_types_test --sender localhost:9001 --receiver localhost:9002</code></p></div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_5_output">5. Output</h2>
+<div class="sectionbody">
+<div class="paragraph"><p>All the tests will list each test as it runs and whether it passes or fails.
+If a test fails, then the details of the failure will be printed at the end of
+the test.</p></div>
+<div class="listingblock">
+<div class="content">
+<pre><code> ======================================================================
+ FAIL: test.B.MESSAGE.JMS_TYPE_HEADER:string+JMS_REPLYTO_HEADER:topic.QpidJms->ProtonCpp (__main__.PartB_JmsHeaderCombination_TestCase)
+ ----------------------------------------------------------------------
+ Traceback (most recent call last):
+ File "./install/lib/python2.7/site-packages/qpid_interop_test/jms_hdrs_props_test.py", line 422, in inner_test_method
+ receive_shim)
+ File "./install/lib/python2.7/site-packages/qpid_interop_test/jms_hdrs_props_test.py", line 313, in run_test
+ self.fail(str(receive_obj))
+ AssertionError: JmsReceiver error: Unexpected JMS message header: JMS_PRIORITY: Expected default priority (4), found priority 0</code></pre>
+</div></div>
+<div class="paragraph"><p>Currently, the tests do not produce log files.</p></div>
+</div>
+</div>
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/3ef7d309/input/site.css
----------------------------------------------------------------------
diff --git a/input/site.css b/input/site.css
index 81058e3..c6fca7f 100644
--- a/input/site.css
+++ b/input/site.css
@@ -218,6 +218,7 @@ td, th {
td:last-child, th:last-child {
padding-right: 0;
+ border-right: none;
}
td {
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/3ef7d309/python/generate.py
----------------------------------------------------------------------
diff --git a/python/generate.py b/python/generate.py
index 00631eb..01b08f5 100644
--- a/python/generate.py
+++ b/python/generate.py
@@ -393,6 +393,9 @@ def _fetch_issues(project, release):
if project in ("qpid-cpp", "qpid-java", "qpid-python", "broker-j"):
project = "qpid"
+ if project in ("qpid-interop-test"):
+ project = "qpidit"
+
if project == "proton":
fix_version = "proton-c-{}".format(release)
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/3ef7d309/python/plano.py
----------------------------------------------------------------------
diff --git a/python/plano.py b/python/plano.py
index 15e7bce..de5df14 100644
--- a/python/plano.py
+++ b/python/plano.py
@@ -536,6 +536,9 @@ def call_and_print_on_error(command, *args, **kwargs):
except CalledProcessError:
eprint(read(output_file), end="")
raise
+ except OSError as e:
+ eprint("\"{0}\": {1}".format(command, e))
+ raise
_child_processes = list()
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/3ef7d309/scripts/gen-interop-test-release-docs
----------------------------------------------------------------------
diff --git a/scripts/gen-interop-test-release-docs b/scripts/gen-interop-test-release-docs
index a7c7c39..f02b68c 100755
--- a/scripts/gen-interop-test-release-docs
+++ b/scripts/gen-interop-test-release-docs
@@ -21,11 +21,16 @@
import os
from generate import *
+from shutil import copyfile
def gen_interop_test_docs(release, source_dir, output_dir):
- pass
-
-## Now do stuff ##
+ # Copy QUICKSTART.md into the output directory
+ copyfile("%s/QUICKSTART.md"%(source_dir), "%s/QUICKSTART.md"%(output_dir))
+ # Generate docbook output
+ build_dir = make_temp_dir()
+ source_file = "{}/docs/users-guide.txt".format(source_dir)
+ output_file = "{}/users-guide.html.in".format(output_dir)
+ call(["asciidoc", "--doctype", "book", "--no-header-footer", "--out-file", output_file, source_file])
release, issues_release, source_release, release_dir, checkout_dir = setup_release_script()
source_dir = checkout_dir or fetch_source("interop-test", source_release)
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/3ef7d309/scripts/gen-interop-test-release-page
----------------------------------------------------------------------
diff --git a/scripts/gen-interop-test-release-page b/scripts/gen-interop-test-release-page
index fbeb9ee..aa406a1 100755
--- a/scripts/gen-interop-test-release-page
+++ b/scripts/gen-interop-test-release-page
@@ -32,9 +32,11 @@ component_records = (
documentation = \
"""
-
- - XXX
-
+ - [Quickstart guide](QUICKSTART.html)
+ - [User guide](users-guide.html)
+ - [Developer overview](https://git-wip-us.apache.org/repos/asf?p=qpid-interop-test.git;a=blob_plain;f=docs/qpid-interop-test-devel-overview.txt;hb=0.1.0)
+ - [Test HOWTO](https://git-wip-us.apache.org/repos/asf?p=qpid-interop-test.git;a=blob_plain;f=docs/Test_HOWTO.txt;hb=0.1.0)
+ - [Shim HOWTO](https://git-wip-us.apache.org/repos/asf?p=qpid-interop-test.git;a=blob_plain;f=docs/Shim_HOWTO.txt;hb=0.1.0)
"""
template = \
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@qpid.apache.org
For additional commands, e-mail: commits-help@qpid.apache.org
[2/2] qpid-site git commit: Added content pages for Qpid Interop Test
Posted by kp...@apache.org.
Added content pages for Qpid Interop Test
Project: http://git-wip-us.apache.org/repos/asf/qpid-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/qpid-site/commit/3ef7d309
Tree: http://git-wip-us.apache.org/repos/asf/qpid-site/tree/3ef7d309
Diff: http://git-wip-us.apache.org/repos/asf/qpid-site/diff/3ef7d309
Branch: refs/heads/asf-site
Commit: 3ef7d309765c479480533c6989ce2cd966b1d804
Parents: ed98eed
Author: Kim van der Riet <kp...@apache.org>
Authored: Tue Dec 5 18:18:27 2017 -0500
Committer: Kim van der Riet <kp...@apache.org>
Committed: Tue Dec 5 18:18:27 2017 -0500
----------------------------------------------------------------------
content/components/index.html | 12 +
content/components/interop-test/index.html | 138 ++++-
content/documentation.html | 21 +
content/download.html | 19 +
content/releases/index.html | 1 +
.../qpid-interop-test-0.1.0/QUICKSTART.html | 413 +++++++++++++
.../releases/qpid-interop-test-0.1.0/index.html | 201 +++++++
.../qpid-interop-test-0.1.0/release-notes.html | 204 +++++++
.../qpid-interop-test-0.1.0/users-guide.html | 598 +++++++++++++++++++
content/site.css | 1 +
input/_transom_config.py | 2 +-
input/components/index.md | 5 +
input/components/interop-test/index.md | 140 ++++-
input/documentation.md | 17 +
input/download.md | 10 +-
input/releases/index.md | 1 +
.../qpid-interop-test-0.1.0/QUICKSTART.md | 234 ++++++++
input/releases/qpid-interop-test-0.1.0/index.md | 61 ++
.../qpid-interop-test-0.1.0/release-notes.md | 74 +++
.../qpid-interop-test-0.1.0/users-guide.html.in | 454 ++++++++++++++
input/site.css | 1 +
python/generate.py | 3 +
python/plano.py | 3 +
scripts/gen-interop-test-release-docs | 11 +-
scripts/gen-interop-test-release-page | 8 +-
25 files changed, 2594 insertions(+), 38 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/3ef7d309/content/components/index.html
----------------------------------------------------------------------
diff --git a/content/components/index.html b/content/components/index.html
index 4e0e9c0..53f2912 100644
--- a/content/components/index.html
+++ b/content/components/index.html
@@ -170,6 +170,12 @@ connecting clients, brokers, and standalone services.</p>
<li><a href="dispatch-router/index.html">Dispatch router</a> - An AMQP router for scalable messaging interconnect</li>
</ul>
+<h2 id="messaging-tools">Messaging tools</h2>
+
+<ul>
+<li><a href="interop-test/index.html">Qpid Interop Test</a> - An AMQP 1.0 interoperability test suite</li>
+</ul>
+
<h2 id="compatibility">Compatibility</h2>
<div class="scroll">
@@ -220,6 +226,12 @@ connecting clients, brokers, and standalone services.</p>
<td>JVM, Linux, Windows</td>
<td>1.0</td>
</tr>
+<tr>
+ <td><a href="interop-test/index.html">Qpid Interop Test</a></td>
+ <td>-</td>
+ <td>Linux</td>
+ <td>1.0</td>
+</tr>
</tbody>
</table>
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/3ef7d309/content/components/interop-test/index.html
----------------------------------------------------------------------
diff --git a/content/components/interop-test/index.html b/content/components/interop-test/index.html
index 8f702a3..71b13ac 100644
--- a/content/components/interop-test/index.html
+++ b/content/components/interop-test/index.html
@@ -120,37 +120,156 @@ https://github.com/apache/qpid-proton/blob/go1{/dir}/{file}#L{line}"/>
<div class="feature">
-<h2 id="amqp-interoperability-testing">AMQP interoperability testing</h2>
-
-<p>XXX</p>
+<p>A test suite that systematically tests <a href="/amqp/index.html">AMQP 1.0</a>
+clients against each other to ensure that they are working correctly
+with each other. The tests consist of matched client pairs to send and receive
+messages through an AMQP server (or combination of connected servers). These tests
+also check that the AMQP server is able to handle the clients and AMQP traffic.</p>
</div>
<h2 id="features">Features</h2>
+<div class="two-column">
+
+<ul>
+<li>Tests all available clients against each other</li>
+<li>Tests AMQP clients against any AMQP server</li>
+<li>Tests AMQP types</li>
+<li>Tests large messages</li>
+<li>Tests JMS messages</li>
+<li>Tests JMS headers and properties</li>
+</ul>
+
+</div>
+
+<h2 id="supported-servers">Supported servers</h2>
+
+<p>Any servers that can handle <a href="/amqp/index.html">AMQP 1.0</a>
+will work. By default, the tests run against localhost using the default AMQP port (5672), but these can be
+changed to any valid IP address and port.</p>
+
+<h2 id="supported-clients">Supported clients</h2>
+
+<p>The following clients are currently supported:</p>
+
<ul>
-<li>XXX</li>
+<li><a href="/releases/qpid-proton-0.18.1/proton/c/api/files.html">Qpid Proton C++</a></li>
+<li><a href="/releases/qpid-proton-0.18.1/proton/python/api/index.html">Qpid Proton Python</a></li>
+<li><a href="/components/jms/index.html">Qpid JMS</a></li>
+<li><a href="https://github.com/grs/rhea">Rhea Javascript</a></li>
+<li><a href="https://github.com/Azure/amqpnetlite">AMQP .Net Lite</a></li>
</ul>
+<h2 id="amqp-test-coverage">AMQP test coverage</h2>
+
+<div class="scroll">
+
+<table>
+ <thead>
+ <tr>
+ <th> </th>
+ <th colspan="4">Clients</th>
+ </tr>
+ <tr>
+ <th>Test</th>
+ <th>Qpid Proton C++</th>
+ <th>Qpid Proton Python</th>
+ <th>Rhea</th>
+ <th>AMQP .Net Lite</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <th>AMQP types</th>
+ <td>YES</td>
+ <td>YES</td>
+ <td>YES</td>
+ <td>YES</td>
+ </tr>
+ <tr>
+ <th>Large AMQP messages</th>
+ <td>YES</td>
+ <td>YES</td>
+ <td></td>
+ <td>YES</td>
+ </tr>
+ </tbody>
+</table>
+
+</div>
+
+<h2 id="jms-test-coverage">JMS test coverage</h2>
+
+<div class="scroll">
+
+<table>
+ <thead>
+ <tr>
+ <th> </th>
+ <th colspan="5">Clients</th>
+ </tr>
+ <tr>
+ <th>Test</th>
+ <th>Qpid JMS</th>
+ <th>Qpid Proton C++</th>
+ <th>Qpid Proton Python</th>
+ <th>Rhea</th>
+ <th>AMQP .Net Lite</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <th>JMS messages</th>
+ <td>YES</td>
+ <td>YES</td>
+ <td>YES</td>
+ <td></td>
+ <td></td>
+ </tr>
+ <tr>
+ <th>JMS headers & properties</th>
+ <td>YES</td>
+ <td>YES</td>
+ <td>YES</td>
+ <td></td>
+ <td></td>
+ </tr>
+ </tbody>
+</table>
+
+</div>
+
<h2 id="documentation">Documentation</h2>
+<div class="two-column">
+
<ul>
-<li>XXX</li>
+<li><a href="/releases/qpid-interop-test-0.1.0/QUICKSTART.html">Quickstart guide</a></li>
+<li><a href="/releases/qpid-interop-test-0.1.0/users-guide.html">User guide</a></li>
+<li><a href="https://git-wip-us.apache.org/repos/asf?p=qpid-interop-test.git;a=blob_plain;f=docs/qpid-interop-test-devel-overview.txt;hb=0.1.0">Developer overview</a></li>
+<li><a href="https://git-wip-us.apache.org/repos/asf?p=qpid-interop-test.git;a=blob_plain;f=docs/Test_HOWTO.txt;hb=0.1.0">Test HOWTO</a></li>
+<li><a href="https://git-wip-us.apache.org/repos/asf?p=qpid-interop-test.git;a=blob_plain;f=docs/Shim_HOWTO.txt;hb=0.1.0">Shim HOWTO</a></li>
</ul>
</div>
+</div>
+
<div id="-right-column" class="right-column-adjusted">
<h2 id="releases">Releases</h2>
<ul>
-<li>XXX</li>
+<li><a href="/releases/qpid-interop-test-0.1.0">Qpid Interop Test 0.1.0</a> </li>
+<li><a href="/releases/index.html#past-releases">Past releases</a></li>
</ul>
<h2 id="issues">Issues</h2>
<ul>
+<li><a href="https://issues.apache.org/jira/secure/CreateIssue.jspa?pid=12318621&issuetype=1&priority=3">Report a bug</a></li>
+<li><a href="https://issues.apache.org/jira/secure/CreateIssue.jspa?pid=12318621&issuetype=4&priority=3">Request an improvement</a></li>
<li><form id="-jira-goto-form">Go to issue <input name="jira" value="QPIDIT-"/></form></li>
<li><a href="https://issues.apache.org/jira/browse/QPIDIT">JIRA project page</a></li>
</ul>
@@ -158,15 +277,10 @@ https://github.com/apache/qpid-proton/blob/go1{/dir}/{file}#L{line}"/>
<h2 id="source-code">Source code</h2>
<ul>
+<li><a href="https://github.com/apache/qpid-interop-test">Browse via GitHub</a></li>
<li><a href="https://git-wip-us.apache.org/repos/asf/qpid-interop-test.git">Git clone URL</a></li>
</ul>
-<h2 id="resources">Resources</h2>
-
-<ul>
-<li>XXX</li>
-</ul>
-
</div>
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/3ef7d309/content/documentation.html
----------------------------------------------------------------------
diff --git a/content/documentation.html b/content/documentation.html
index 06af5cb..446ea1a 100644
--- a/content/documentation.html
+++ b/content/documentation.html
@@ -212,6 +212,27 @@ You can find older versions with our
<hr />
+<h2 id="messaging-tools">Messaging tools</h2>
+
+<div class="flex">
+
+<section>
+
+<h3 id="qpid-interop-test">Qpid Interop Test</h3>
+
+<ul>
+<li><a href="/components/interop-test/index.html">Overview</a></li>
+<li><a href="/releases/qpid-interop-test-0.1.0/QUICKSTART.html">Quickstart guide</a></li>
+<li><a href="/releases/qpid-interop-test-0.1.0/users-guide.html">User guide</a></li>
+<li><a href="https://git-wip-us.apache.org/repos/asf?p=qpid-interop-test.git;a=blob_plain;f=docs/qpid-interop-test-devel-overview.txt;hb=0.1.0">Developer overview</a></li>
+</ul>
+
+</section>
+
+</div>
+
+<hr />
+
<h2 id="more-information">More information</h2>
<ul>
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/3ef7d309/content/download.html
----------------------------------------------------------------------
diff --git a/content/download.html b/content/download.html
index c12dc3f..d5590f2 100644
--- a/content/download.html
+++ b/content/download.html
@@ -220,6 +220,25 @@ and
<a href="http://www.apache.org/dist/qpid/broker-j/7.0.0/apache-qpid-broker-j-7.0.0-src.tar.gz.md5">MD5</a>,
<a href="http://www.apache.org/dist/qpid/broker-j/7.0.0/apache-qpid-broker-j-7.0.0-src.tar.gz.sha512">SHA512</a>]</p>
+<h2 id="messaging-tools">Messaging tools</h2>
+
+<table>
+<thead>
+<tr>
+ <th>Content</th>
+ <th>Download</th>
+ <th>Verify</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+ <td><a href="/components/interop-test/index.html">Qpid Interop Test</a></td>
+ <td><a href="http://www.apache.org/dyn/closer.lua/qpid/interop-test/0.1.0/qpid-interop-test-0.1.0.tar.gz">qpid-interop-test-0.1.0.tar.gz</a></td>
+ <td><a href="http://www.apache.org/dist/qpid/interop-test/0.1.0/qpid-interop-test-0.1.0.tar.gz.asc">ASC</a>, <a href="http://www.apache.org/dist/qpid/interop-test/0.1.0/qpid-interop-test-0.1.0.tar.gz.md5">MD5</a>, <a href="http://www.apache.org/dist/qpid/interop-test/0.1.0/qpid-interop-test-0.1.0.tar.gz.sha512">SHA512</a></td>
+</tr>
+</tbody>
+</table>
+
<h2 id="verify-what-you-download">Verify what you download</h2>
<p>It is essential that you verify the integrity of the downloaded files
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/3ef7d309/content/releases/index.html
----------------------------------------------------------------------
diff --git a/content/releases/index.html b/content/releases/index.html
index e3ad2b6..278649b 100644
--- a/content/releases/index.html
+++ b/content/releases/index.html
@@ -135,6 +135,7 @@ the
<li><a href="qpid-jms-0.27.0/index.html">Qpid JMS 0.27.0</a>, October 2017</li>
<li><a href="qpid-proton-0.18.1/index.html">Qpid Proton 0.18.1</a>, November 2017</li>
<li><a href="qpid-proton-j-0.23.0/index.html">Qpid Proton-J 0.23.0</a>, October 2017</li>
+<li><a href="qpid-interop-test-0.1.0/index.html">Qpid Interop-test 0.1.0</a>, November 2017</li>
</ul>
</div>
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/3ef7d309/content/releases/qpid-interop-test-0.1.0/QUICKSTART.html
----------------------------------------------------------------------
diff --git a/content/releases/qpid-interop-test-0.1.0/QUICKSTART.html b/content/releases/qpid-interop-test-0.1.0/QUICKSTART.html
new file mode 100644
index 0000000..03aa1e4
--- /dev/null
+++ b/content/releases/qpid-interop-test-0.1.0/QUICKSTART.html
@@ -0,0 +1,413 @@
+<!DOCTYPE html>
+<!--
+ -
+ - Licensed to the Apache Software Foundation (ASF) under one
+ - or more contributor license agreements. See the NOTICE file
+ - distributed with this work for additional information
+ - regarding copyright ownership. The ASF licenses this file
+ - to you under the Apache License, Version 2.0 (the
+ - "License"); you may not use this file except in compliance
+ - with the License. You may obtain a copy of the License at
+ -
+ - http://www.apache.org/licenses/LICENSE-2.0
+ -
+ - Unless required by applicable law or agreed to in writing,
+ - software distributed under the License is distributed on an
+ - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ - KIND, either express or implied. See the License for the
+ - specific language governing permissions and limitations
+ - under the License.
+ -
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
+ <head>
+ <title>QUICKSTART GUIDE - Apache Qpid™</title>
+ <meta http-equiv="X-UA-Compatible" content="IE=edge"/>
+ <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+ <link rel="stylesheet" href="/site.css" type="text/css" async="async"/>
+ <link rel="stylesheet" href="/deferred.css" type="text/css" defer="defer"/>
+ <script type="text/javascript">var _deferredFunctions = [];</script>
+ <script type="text/javascript" src="/deferred.js" defer="defer"></script>
+ <!--[if lte IE 8]>
+ <link rel="stylesheet" href="/ie.css" type="text/css"/>
+ <script type="text/javascript" src="/html5shiv.js"></script>
+ <![endif]-->
+
+ <!-- Redirects for `go get` and godoc.org -->
+ <meta name="go-import"
+ content="qpid.apache.org git https://git-wip-us.apache.org/repos/asf/qpid-proton.git"/>
+ <meta name="go-source"
+ content="qpid.apache.org
+https://github.com/apache/qpid-proton/blob/go1/README.md
+https://github.com/apache/qpid-proton/tree/go1{/dir}
+https://github.com/apache/qpid-proton/blob/go1{/dir}/{file}#L{line}"/>
+ </head>
+ <body>
+ <div id="-content">
+ <div id="-top" class="panel">
+ <a id="-menu-link"><img width="16" height="16" src="" alt="Menu"/></a>
+
+ <a id="-search-link"><img width="22" height="16" src="" alt="Search"/></a>
+
+ <ul id="-global-navigation">
+ <li><a id="-logotype" href="/index.html">Apache Qpid<sup>™</sup></a></li>
+ <li><a href="/documentation.html">Documentation</a></li>
+ <li><a href="/download.html">Download</a></li>
+ <li><a href="/discussion.html">Discussion</a></li>
+ </ul>
+ </div>
+
+ <div id="-menu" class="panel" style="display: none;">
+ <div class="flex">
+ <section>
+ <h3>Project</h3>
+
+ <ul>
+ <li><a href="/overview.html">Overview</a></li>
+ <li><a href="/components/index.html">Components</a></li>
+ <li><a href="/releases/index.html">Releases</a></li>
+ </ul>
+ </section>
+
+ <section>
+ <h3>Messaging APIs</h3>
+
+ <ul>
+ <li><a href="/proton/index.html">Qpid Proton</a></li>
+ <li><a href="/components/jms/index.html">Qpid JMS</a></li>
+ <li><a href="/components/messaging-api/index.html">Qpid Messaging API</a></li>
+ </ul>
+ </section>
+
+ <section>
+ <h3>Servers and tools</h3>
+
+ <ul>
+ <li><a href="/components/broker-j/index.html">Broker-J</a></li>
+ <li><a href="/components/cpp-broker/index.html">C++ broker</a></li>
+ <li><a href="/components/dispatch-router/index.html">Dispatch router</a></li>
+ </ul>
+ </section>
+
+ <section>
+ <h3>Resources</h3>
+
+ <ul>
+ <li><a href="/dashboard.html">Dashboard</a></li>
+ <li><a href="https://cwiki.apache.org/confluence/display/qpid/Index">Wiki</a></li>
+ <li><a href="/resources.html">More resources</a></li>
+ </ul>
+ </section>
+ </div>
+ </div>
+
+ <div id="-search" class="panel" style="display: none;">
+ <form action="http://www.google.com/search" method="get">
+ <input type="hidden" name="sitesearch" value="qpid.apache.org"/>
+ <input type="text" name="q" maxlength="255" autofocus="autofocus" tabindex="1"/>
+ <button type="submit">Search</button>
+ <a href="/search.html">More ways to search</a>
+ </form>
+ </div>
+
+ <div id="-middle" class="panel">
+ <ul id="-path-navigation"><li><a href="/index.html">Home</a></li><li><a href="/releases/index.html">Releases</a></li><li><a href="/releases/qpid-interop-test-0.1.0/index.html">Qpid Interop Test 0.1.0</a></li><li>QUICKSTART GUIDE</li></ul>
+
+ <div id="-middle-content">
+ <!--
+
+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.
+
+-->
+
+<h1 id="quickstart-guide">QUICKSTART GUIDE</h1>
+
+<p>You must build <em>and install</em> qpid-interop-test before you can run the tests.</p>
+
+<p>By default, qpid-interop-test will install to /usr/local, but you can set any
+non-priviedged directory as the install prefix using the CMAKE_INSTALL_PREFIX
+environment variable, for example $HOME/install.</p>
+
+<p>The following tools are needed to build qpid-interop-test:</p>
+
+<ul>
+<li>git</li>
+<li>gcc-c++</li>
+<li>Python 2.7.x</li>
+<li>cmake</li>
+<li>Java JDK</li>
+<li>Maven</li>
+<li>JSON cpp</li>
+</ul>
+
+<p>The following Qpid components must be installed <em>before</em> you build and install
+qpid-interop-test:</p>
+
+<ul>
+<li>Qpid Proton (including C++ Proton API)</li>
+<li>Qpid Python</li>
+</ul>
+
+<p>The following are not required, but if installed and present, will be tested:</p>
+
+<ul>
+<li>Rhea (a Javascript client, also requires npm and nodejs)</li>
+<li>AMQP.Net Lite (requires mono)</li>
+</ul>
+
+<p>Pre-requisites can be installed using the standard system package manager (yum,
+dnf, apt-get etc.) OR built from source and installed.</p>
+
+<p>These are the install steps:</p>
+
+<ol>
+<li>Install prerequisites, from packages or source</li>
+<li>Install or download / build AMQP brokers to test against (or set up networked brokers)</li>
+<li>Build qpid-interop-test</li>
+<li>Run the tests</li>
+</ol>
+
+<h2 id="1-install-prerequisites">1. Install prerequisites</h2>
+
+<h3 id="11-rhel6">1.1 RHEL6</h3>
+
+<p>Currently RHEL6 is not supported because it uses Python 2.6.x, and the test code uses
+features of Python 2.7.x. This may be supported in a future release.</p>
+
+<h3 id="12-rhel7">1.2 RHEL7</h3>
+
+<p>From a clean install:</p>
+
+<p><code>
+yum install cmake maven java-1.8.0-openjdk-devel perl-XML-XPath
+</code></p>
+
+<p>Some packages will need to be downloaded from <a href="https://fedoraproject.org/wiki/EPEL">EPEL</a>.
+To set up the EPEL repo in yum:</p>
+
+<p><code>
+wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
+rpm -ivh epel-release-latest-6.noarch.rpm
+</code></p>
+
+<p>then install the following packages:</p>
+
+<p><code>
+yum install jsoncpp-devel nodejs-rhea qpid-proton-cpp-devel python-qpid-proton
+</code></p>
+
+<h3 id="13-fedora-26">1.3 Fedora 26</h3>
+
+<p>All packages are available directly from the Fedora repositories:</p>
+
+<p><code>
+dnf install gcc-c++ cmake maven java-1.8.0-openjdk-devel perl-XML-XPath jsoncpp-devel nodejs-rhea qpid-proton-cpp-devel python-qpid-proton
+</code></p>
+
+<h2 id="2-obtaining-a-broker">2. Obtaining a broker</h2>
+
+<p>Qpid-interop-test requires a running broker to be available. This
+may be on localhost as a local install or build, or on another machine, in which case its
+IP addresss must be known. Some local broker install options are:</p>
+
+<h3 id="21-activemq-5">2.1 ActiveMQ 5</h3>
+
+<p>Download from <a href="http://activemq.apache.org/download.html">Apache</a>.</p>
+
+<p>Make the following changes to the <code>activemq.xml</code> config file: For XML element
+<code>broker.transportConnectors.transportConnector@name="amqp"</code> add the attribute
+<code>wireFormat.allowNonSaslConnections=true</code>. ie:</p>
+
+<p><code>
+<transportConnector name="amqp" uri="amqp://0.0.0.0:5672?maximumConnections=1000&amp;wireFormat.maxFrameSize=1048576000&amp;wireFormat.allowNonSaslConnections=true"/>
+</code></p>
+
+<h3 id="22-artemis">2.2 Artemis</h3>
+
+<p>Download from <a href="https://activemq.apache.org/artemis/download.html">Apache</a>.</p>
+
+<h3 id="23-qpid-cpp-broker">2.3 Qpid cpp broker</h3>
+
+<pre><code>yum install qpid-cpp-server
+</code></pre>
+
+<p>and set the configuration file in /etc/qpid/qpidd.conf as follows:</p>
+
+<p><code>
+auth=no
+queue-patterns=jms.queue.qpid-interop
+</code></p>
+
+<h3 id="24-qpid-dispatch-router">2.4 Qpid Dispatch Router</h3>
+
+<pre><code>yum install qpid-dispatch-router
+</code></pre>
+
+<p>and add the following to the config file in /etc/qpid-dispatch/qdrouterd.conf:</p>
+
+<p>````
+listener {
+ host: ::1
+ port: amqp
+ authenticatePeer: no
+ saslMechanisms: ANONYMOUS
+}</p>
+
+<p>````</p>
+
+<h2 id="3-install-qpid-interop-test">3. Install qpid-interop-test</h2>
+
+<p>Qpid-interop-test may be installed locally (preferred for local builds) or to the system
+(which requires root privileges). For a local install, use the <code>-DCMAKE_INSTALL_PREFIX</code>
+option to the <code>cmake</code> command. If it is omitted, then qpid-interop-test will be installed
+into the default system directories. The source may be unpacked, or (if you need to use the
+latest and greatest), cloned from git:</p>
+
+<p><code>
+git clone https://git-wip-us.apache.org/repos/asf/qpid-interop-test.git
+</code></p>
+
+<p>Assuming the source tree is located in directory {{qpid-interop-test}}:</p>
+
+<p><code>
+cd qpid-interop-test
+mkdir build
+cd build
+</code>
+For a local install:</p>
+
+<p><code>
+cmake -DCMAKE_INSTALL_PREFIX=<abs-path-to-local-install-dir> ..
+make install
+</code></p>
+
+<p>For a system install, root privileges are required:</p>
+
+<p>````
+cmake ..
+make
+sudo make install</p>
+
+<p>````</p>
+
+<h2 id="4-run-the-tests">4. Run the tests</h2>
+
+<h3 id="41-set-the-environment">4.1 Set the environment</h3>
+
+<p>The config.sh script is in the qpid-interop-test build directory: </p>
+
+<p><code>
+source build/config.sh
+</code></p>
+
+<h3 id="42-start-the-test-broker">4.2 Start the test broker</h3>
+
+<p>If the broker is at a remote location rather than localhost, the IP address must be known. In tests using
+the Qpid Dispatch Router, then the entire broker network must be running before the tests are run. The IP
+addresses of the sender (the broker to which messages are being sent) and receiver (the broker from which
+messages will be received) must be known.</p>
+
+<h3 id="43-run-chosen-tests">4.3 Run chosen tests</h3>
+
+<p>The available tests are:</p>
+
+<table>
+<thead>
+<tr>
+ <th>Module</th>
+ <th>Description</th>
+ <th>Clients</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+ <td>amqp_large_content_test</td>
+ <td>Tests implementation of large messages up to 10MB</td>
+ <td>C++ Python AMQP.NetLite</td>
+</tr>
+<tr>
+ <td>amqp_types_test</td>
+ <td>Tests the implementation of AMQP 1.0 types</td>
+ <td>C++ Python Rhea AMQP.NetLite</td>
+</tr>
+<tr>
+ <td>jms_hdrs_props_test</td>
+ <td>Tests JMS headers and properties</td>
+ <td>C++ JMS Python</td>
+</tr>
+<tr>
+ <td>jms_messages_test</td>
+ <td>Tests all JMS message types (except ObjectMessage)</td>
+ <td>C++ JMS Python</td>
+</tr>
+</tbody>
+</table>
+
+<p>The preferred method to run the tests is using the Python module option as follows:</p>
+
+<p><code>
+python -m qpid_interop_test.amqp_types_test
+python -m qpid_interop_test.jms_messages_test
+...
+</code></p>
+
+<p>If the broker is remote, use the following to point to the broker(s):</p>
+
+<p><code>
+python -m qpid_interop_test.amqp_types_test --sender <broker-ip-addr> --receiver <broker-ip-addr>
+python -m qpid_interop_test.jms_messages_test --sender <broker-ip-addr> --receiver <broker-ip-addr>
+...
+</code></p>
+
+<p>In tests using the Qpid dispatch router, a multi-node configuration may be set up such that messages
+are sent to a different broker to that from which they will be received. For example, to send to
+broker A and receive from broker B:</p>
+
+<p><code>
+python -m qpid_interop_test.amqp_types_test --sender <broker-ip-addr-A> --receiver <broker-ip-addr-B>
+python -m qpid_interop_test.jms_messages_test --sender <broker-ip-addr-A> --receiver <broker-ip-addr-B>
+...
+</code></p>
+
+
+ <hr/>
+
+ <ul id="-apache-navigation">
+ <li><a href="http://www.apache.org/">Apache</a></li>
+ <li><a href="http://www.apache.org/licenses/">License</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">Thanks!</a></li>
+ <li><a href="/security.html">Security</a></li>
+ <li><a href="http://www.apache.org/"><img id="-apache-feather" width="48" height="14" src="" alt="Apache"/></a></li>
+ </ul>
+
+ <p id="-legal">
+ Apache Qpid, Messaging built on AMQP; Copyright © 2015
+ The Apache Software Foundation; Licensed under
+ the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache
+ License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton,
+ Proton, Apache, the Apache feather logo, and the Apache Qpid
+ project logo are trademarks of The Apache Software
+ Foundation; All other marks mentioned may be trademarks or
+ registered trademarks of their respective owners
+ </p>
+ </div>
+ </div>
+ </div>
+ </body>
+</html>
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/3ef7d309/content/releases/qpid-interop-test-0.1.0/index.html
----------------------------------------------------------------------
diff --git a/content/releases/qpid-interop-test-0.1.0/index.html b/content/releases/qpid-interop-test-0.1.0/index.html
new file mode 100644
index 0000000..fb5998e
--- /dev/null
+++ b/content/releases/qpid-interop-test-0.1.0/index.html
@@ -0,0 +1,201 @@
+<!DOCTYPE html>
+<!--
+ -
+ - Licensed to the Apache Software Foundation (ASF) under one
+ - or more contributor license agreements. See the NOTICE file
+ - distributed with this work for additional information
+ - regarding copyright ownership. The ASF licenses this file
+ - to you under the Apache License, Version 2.0 (the
+ - "License"); you may not use this file except in compliance
+ - with the License. You may obtain a copy of the License at
+ -
+ - http://www.apache.org/licenses/LICENSE-2.0
+ -
+ - Unless required by applicable law or agreed to in writing,
+ - software distributed under the License is distributed on an
+ - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ - KIND, either express or implied. See the License for the
+ - specific language governing permissions and limitations
+ - under the License.
+ -
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
+ <head>
+ <title>Qpid Interop Test 0.1.0 - Apache Qpid™</title>
+ <meta http-equiv="X-UA-Compatible" content="IE=edge"/>
+ <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+ <link rel="stylesheet" href="/site.css" type="text/css" async="async"/>
+ <link rel="stylesheet" href="/deferred.css" type="text/css" defer="defer"/>
+ <script type="text/javascript">var _deferredFunctions = [];</script>
+ <script type="text/javascript" src="/deferred.js" defer="defer"></script>
+ <!--[if lte IE 8]>
+ <link rel="stylesheet" href="/ie.css" type="text/css"/>
+ <script type="text/javascript" src="/html5shiv.js"></script>
+ <![endif]-->
+
+ <!-- Redirects for `go get` and godoc.org -->
+ <meta name="go-import"
+ content="qpid.apache.org git https://git-wip-us.apache.org/repos/asf/qpid-proton.git"/>
+ <meta name="go-source"
+ content="qpid.apache.org
+https://github.com/apache/qpid-proton/blob/go1/README.md
+https://github.com/apache/qpid-proton/tree/go1{/dir}
+https://github.com/apache/qpid-proton/blob/go1{/dir}/{file}#L{line}"/>
+ </head>
+ <body>
+ <div id="-content">
+ <div id="-top" class="panel">
+ <a id="-menu-link"><img width="16" height="16" src="" alt="Menu"/></a>
+
+ <a id="-search-link"><img width="22" height="16" src="" alt="Search"/></a>
+
+ <ul id="-global-navigation">
+ <li><a id="-logotype" href="/index.html">Apache Qpid<sup>™</sup></a></li>
+ <li><a href="/documentation.html">Documentation</a></li>
+ <li><a href="/download.html">Download</a></li>
+ <li><a href="/discussion.html">Discussion</a></li>
+ </ul>
+ </div>
+
+ <div id="-menu" class="panel" style="display: none;">
+ <div class="flex">
+ <section>
+ <h3>Project</h3>
+
+ <ul>
+ <li><a href="/overview.html">Overview</a></li>
+ <li><a href="/components/index.html">Components</a></li>
+ <li><a href="/releases/index.html">Releases</a></li>
+ </ul>
+ </section>
+
+ <section>
+ <h3>Messaging APIs</h3>
+
+ <ul>
+ <li><a href="/proton/index.html">Qpid Proton</a></li>
+ <li><a href="/components/jms/index.html">Qpid JMS</a></li>
+ <li><a href="/components/messaging-api/index.html">Qpid Messaging API</a></li>
+ </ul>
+ </section>
+
+ <section>
+ <h3>Servers and tools</h3>
+
+ <ul>
+ <li><a href="/components/broker-j/index.html">Broker-J</a></li>
+ <li><a href="/components/cpp-broker/index.html">C++ broker</a></li>
+ <li><a href="/components/dispatch-router/index.html">Dispatch router</a></li>
+ </ul>
+ </section>
+
+ <section>
+ <h3>Resources</h3>
+
+ <ul>
+ <li><a href="/dashboard.html">Dashboard</a></li>
+ <li><a href="https://cwiki.apache.org/confluence/display/qpid/Index">Wiki</a></li>
+ <li><a href="/resources.html">More resources</a></li>
+ </ul>
+ </section>
+ </div>
+ </div>
+
+ <div id="-search" class="panel" style="display: none;">
+ <form action="http://www.google.com/search" method="get">
+ <input type="hidden" name="sitesearch" value="qpid.apache.org"/>
+ <input type="text" name="q" maxlength="255" autofocus="autofocus" tabindex="1"/>
+ <button type="submit">Search</button>
+ <a href="/search.html">More ways to search</a>
+ </form>
+ </div>
+
+ <div id="-middle" class="panel">
+ <ul id="-path-navigation"><li><a href="/index.html">Home</a></li><li><a href="/releases/index.html">Releases</a></li><li>Qpid Interop Test 0.1.0</li></ul>
+
+ <div id="-middle-content">
+ <h1 id="qpid-interop-test-010">Qpid Interop Test 0.1.0</h1>
+
+<p>Qpid Interop Test is a suite of AMQP interoperability tests. More
+about <a href="/components/interop-test/index.html">Qpid Interop
+Test</a>.</p>
+
+<p>For a detailed list of the changes in this release, see the <a href="release-notes.html">release
+notes</a>.</p>
+
+<h2 id="downloads">Downloads</h2>
+
+<p>It's important to <a href="/download.html#verify-what-you-download">verify the
+integrity</a> of
+the files you download.</p>
+
+<table>
+<thead>
+<tr>
+ <th>Content</th>
+ <th>Download</th>
+ <th>Verify</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+ <td>Interop Test</td>
+ <td><a href="http://archive.apache.org/dist/qpid/interop-test/0.1.0/qpid-interop-test-0.1.0.tar.gz">qpid-interop-test-0.1.0.tar.gz</a></td>
+ <td><a href="http://archive.apache.org/dist/qpid/interop-test/0.1.0/qpid-interop-test-0.1.0.tar.gz.asc">PGP</a></td>
+</tr>
+</tbody>
+</table>
+
+<h2 id="documentation">Documentation</h2>
+
+<ul>
+<li><a href="QUICKSTART.html">Quickstart guide</a></li>
+<li><a href="users-guide.html">User guide</a></li>
+<li><a href="https://git-wip-us.apache.org/repos/asf?p=qpid-interop-test.git;a=blob_plain;f=docs/qpid-interop-test-devel-overview.txt;hb=0.1.0">Developer overview</a></li>
+<li><a href="https://git-wip-us.apache.org/repos/asf?p=qpid-interop-test.git;a=blob_plain;f=docs/Test_HOWTO.txt;hb=0.1.0">Test HOWTO</a></li>
+<li><a href="https://git-wip-us.apache.org/repos/asf?p=qpid-interop-test.git;a=blob_plain;f=docs/Shim_HOWTO.txt;hb=0.1.0">Shim HOWTO</a></li>
+</ul>
+
+<h2 id="more-information">More information</h2>
+
+<ul>
+<li><a href="http://archive.apache.org/dist/qpid/interop-test/0.1.0">All release artefacts</a></li>
+<li><a href="https://issues.apache.org/jira/issues/?jql=project+%3D+QPIDIT+AND+fixVersion+%3D+%270.1.0%27+AND+resolution+%3D+%27fixed%27+ORDER+BY+priority+DESC">Resolved issues in JIRA</a></li>
+<li><a href="https://git-wip-us.apache.org/repos/asf/qpid-interop-test.git/tree/refs/tags/0.1.0">Source repository tag</a></li>
+</ul>
+
+<script type="text/javascript">
+ _deferredFunctions.push(function() {
+ if ("0.1.0" === "0.1.0") {
+ _modifyCurrentReleaseLinks();
+ }
+ });
+</script>
+
+
+ <hr/>
+
+ <ul id="-apache-navigation">
+ <li><a href="http://www.apache.org/">Apache</a></li>
+ <li><a href="http://www.apache.org/licenses/">License</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">Thanks!</a></li>
+ <li><a href="/security.html">Security</a></li>
+ <li><a href="http://www.apache.org/"><img id="-apache-feather" width="48" height="14" src="" alt="Apache"/></a></li>
+ </ul>
+
+ <p id="-legal">
+ Apache Qpid, Messaging built on AMQP; Copyright © 2015
+ The Apache Software Foundation; Licensed under
+ the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache
+ License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton,
+ Proton, Apache, the Apache feather logo, and the Apache Qpid
+ project logo are trademarks of The Apache Software
+ Foundation; All other marks mentioned may be trademarks or
+ registered trademarks of their respective owners
+ </p>
+ </div>
+ </div>
+ </div>
+ </body>
+</html>
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/3ef7d309/content/releases/qpid-interop-test-0.1.0/release-notes.html
----------------------------------------------------------------------
diff --git a/content/releases/qpid-interop-test-0.1.0/release-notes.html b/content/releases/qpid-interop-test-0.1.0/release-notes.html
new file mode 100644
index 0000000..3e1f8d0
--- /dev/null
+++ b/content/releases/qpid-interop-test-0.1.0/release-notes.html
@@ -0,0 +1,204 @@
+<!DOCTYPE html>
+<!--
+ -
+ - Licensed to the Apache Software Foundation (ASF) under one
+ - or more contributor license agreements. See the NOTICE file
+ - distributed with this work for additional information
+ - regarding copyright ownership. The ASF licenses this file
+ - to you under the Apache License, Version 2.0 (the
+ - "License"); you may not use this file except in compliance
+ - with the License. You may obtain a copy of the License at
+ -
+ - http://www.apache.org/licenses/LICENSE-2.0
+ -
+ - Unless required by applicable law or agreed to in writing,
+ - software distributed under the License is distributed on an
+ - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ - KIND, either express or implied. See the License for the
+ - specific language governing permissions and limitations
+ - under the License.
+ -
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
+ <head>
+ <title>Qpid Interop Test 0.1.0 Release Notes - Apache Qpid™</title>
+ <meta http-equiv="X-UA-Compatible" content="IE=edge"/>
+ <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+ <link rel="stylesheet" href="/site.css" type="text/css" async="async"/>
+ <link rel="stylesheet" href="/deferred.css" type="text/css" defer="defer"/>
+ <script type="text/javascript">var _deferredFunctions = [];</script>
+ <script type="text/javascript" src="/deferred.js" defer="defer"></script>
+ <!--[if lte IE 8]>
+ <link rel="stylesheet" href="/ie.css" type="text/css"/>
+ <script type="text/javascript" src="/html5shiv.js"></script>
+ <![endif]-->
+
+ <!-- Redirects for `go get` and godoc.org -->
+ <meta name="go-import"
+ content="qpid.apache.org git https://git-wip-us.apache.org/repos/asf/qpid-proton.git"/>
+ <meta name="go-source"
+ content="qpid.apache.org
+https://github.com/apache/qpid-proton/blob/go1/README.md
+https://github.com/apache/qpid-proton/tree/go1{/dir}
+https://github.com/apache/qpid-proton/blob/go1{/dir}/{file}#L{line}"/>
+ </head>
+ <body>
+ <div id="-content">
+ <div id="-top" class="panel">
+ <a id="-menu-link"><img width="16" height="16" src="" alt="Menu"/></a>
+
+ <a id="-search-link"><img width="22" height="16" src="" alt="Search"/></a>
+
+ <ul id="-global-navigation">
+ <li><a id="-logotype" href="/index.html">Apache Qpid<sup>™</sup></a></li>
+ <li><a href="/documentation.html">Documentation</a></li>
+ <li><a href="/download.html">Download</a></li>
+ <li><a href="/discussion.html">Discussion</a></li>
+ </ul>
+ </div>
+
+ <div id="-menu" class="panel" style="display: none;">
+ <div class="flex">
+ <section>
+ <h3>Project</h3>
+
+ <ul>
+ <li><a href="/overview.html">Overview</a></li>
+ <li><a href="/components/index.html">Components</a></li>
+ <li><a href="/releases/index.html">Releases</a></li>
+ </ul>
+ </section>
+
+ <section>
+ <h3>Messaging APIs</h3>
+
+ <ul>
+ <li><a href="/proton/index.html">Qpid Proton</a></li>
+ <li><a href="/components/jms/index.html">Qpid JMS</a></li>
+ <li><a href="/components/messaging-api/index.html">Qpid Messaging API</a></li>
+ </ul>
+ </section>
+
+ <section>
+ <h3>Servers and tools</h3>
+
+ <ul>
+ <li><a href="/components/broker-j/index.html">Broker-J</a></li>
+ <li><a href="/components/cpp-broker/index.html">C++ broker</a></li>
+ <li><a href="/components/dispatch-router/index.html">Dispatch router</a></li>
+ </ul>
+ </section>
+
+ <section>
+ <h3>Resources</h3>
+
+ <ul>
+ <li><a href="/dashboard.html">Dashboard</a></li>
+ <li><a href="https://cwiki.apache.org/confluence/display/qpid/Index">Wiki</a></li>
+ <li><a href="/resources.html">More resources</a></li>
+ </ul>
+ </section>
+ </div>
+ </div>
+
+ <div id="-search" class="panel" style="display: none;">
+ <form action="http://www.google.com/search" method="get">
+ <input type="hidden" name="sitesearch" value="qpid.apache.org"/>
+ <input type="text" name="q" maxlength="255" autofocus="autofocus" tabindex="1"/>
+ <button type="submit">Search</button>
+ <a href="/search.html">More ways to search</a>
+ </form>
+ </div>
+
+ <div id="-middle" class="panel">
+ <ul id="-path-navigation"><li><a href="/index.html">Home</a></li><li><a href="/releases/index.html">Releases</a></li><li><a href="/releases/qpid-interop-test-0.1.0/index.html">Qpid Interop Test 0.1.0</a></li><li>Qpid Interop Test 0.1.0 Release Notes</li></ul>
+
+ <div id="-middle-content">
+ <h1 id="qpid-interop-test-010-release-notes">Qpid Interop Test 0.1.0 Release Notes</h1>
+
+<p>Qpid Interop Test is a suite of AMQP interoperability tests. More
+about <a href="/components/interop-test/index.html">Qpid Interop
+Test</a>.</p>
+
+<p>For more information about this release, including download links and
+documentation, see the <a href="index.html">release overview</a>.</p>
+
+<h2 id="new-features-and-improvements">New features and improvements</h2>
+
+<ul>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-20">QPIDIT-20</a> - Add ability to detect broker, skip tests that fail for that broker</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-21">QPIDIT-21</a> - Add shims for C++ client</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-22">QPIDIT-22</a> - Add ability to run on Jenkins CI</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-32">QPIDIT-32</a> - Use Maven to build Java components</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-33">QPIDIT-33</a> - Add JMS message headers and properties to test suite</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-41">QPIDIT-41</a> - Rearrange test directory structure to better organize tests and shims</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-42">QPIDIT-42</a> - Split JMS message test into two separate tests: message bodies, and message headers/properties</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-44">QPIDIT-44</a> - Add AMQP large content test</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-53">QPIDIT-53</a> - Eliminate use of authentication when collecting broker connection properties</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-84">QPIDIT-84</a> - Update README, QUICKSTART, add a users' guide</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-96">QPIDIT-96</a> - Improvements in Java component management</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-98">QPIDIT-98</a> - Change Proton C++ Receiver shims to use latest non-deprecated API calls</li>
+</ul>
+
+<h2 id="bugs-fixed">Bugs fixed</h2>
+
+<ul>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-24">QPIDIT-24</a> - Broker identification failure blocks tests</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-34">QPIDIT-34</a> - Update to jsoncpp text format has broken test harness for all C++ shims</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-38">QPIDIT-38</a> - Artemis broker-added properties not handled correctly in python receive shim</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-40">QPIDIT-40</a> - Sender and Receiver threads don't stop when tests end in some error conditions</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-51">QPIDIT-51</a> - Method needed to skip sensing broker type</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-55">QPIDIT-55</a> - Proton install dir is hard coded into cmake</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-56">QPIDIT-56</a> - Rhea installs to /usr/lib regardless of cmake install dir</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-57">QPIDIT-57</a> - Cmake installer should check for presence of Node.js and Rhea client</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-66">QPIDIT-66</a> - Shims should install into a libexec directory, not into the Python site-packages path</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-67">QPIDIT-67</a> - Compile errors after recent header cleanup in Proton C++ bindings</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-69">QPIDIT-69</a> - JMS tests fail with "Import Error: no module names jms_types"</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-73">QPIDIT-73</a> - Rhea shim char type broken by recent updates to Rhea</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-82">QPIDIT-82</a> - JMS tests fail intermittently with null message</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-83">QPIDIT-83</a> - JAVA classpath points to maven repository rather than installed location</li>
+</ul>
+
+<h2 id="tasks">Tasks</h2>
+
+<ul>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-1">QPIDIT-1</a> - Initial code import</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-2">QPIDIT-2</a> - Add command-line options to control which shims and/or AMQP type combinations to run</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-13">QPIDIT-13</a> - Submit patch to Proton for AMQP type support needed by ProtonPython shim</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-16">QPIDIT-16</a> - Place Qpid JMS shim build management under Maven</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-17">QPIDIT-17</a> - Add JMS test suite</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-18">QPIDIT-18</a> - Use existing structured text representation standard for communicating between test and shims</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-47">QPIDIT-47</a> - Add Rhea javascript shim for AMQP types test</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-48">QPIDIT-48</a> - Add test options which allow separate addresses for the sender and receiver</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-52">QPIDIT-52</a> - Make qpid-interop-test installable</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-59">QPIDIT-59</a> - Create a HOWTO file on writing a new shim</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-60">QPIDIT-60</a> - Create a HOWTO file on writing a new test</li>
+</ul>
+
+
+ <hr/>
+
+ <ul id="-apache-navigation">
+ <li><a href="http://www.apache.org/">Apache</a></li>
+ <li><a href="http://www.apache.org/licenses/">License</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">Thanks!</a></li>
+ <li><a href="/security.html">Security</a></li>
+ <li><a href="http://www.apache.org/"><img id="-apache-feather" width="48" height="14" src="" alt="Apache"/></a></li>
+ </ul>
+
+ <p id="-legal">
+ Apache Qpid, Messaging built on AMQP; Copyright © 2015
+ The Apache Software Foundation; Licensed under
+ the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache
+ License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton,
+ Proton, Apache, the Apache feather logo, and the Apache Qpid
+ project logo are trademarks of The Apache Software
+ Foundation; All other marks mentioned may be trademarks or
+ registered trademarks of their respective owners
+ </p>
+ </div>
+ </div>
+ </div>
+ </body>
+</html>
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/3ef7d309/content/releases/qpid-interop-test-0.1.0/users-guide.html
----------------------------------------------------------------------
diff --git a/content/releases/qpid-interop-test-0.1.0/users-guide.html b/content/releases/qpid-interop-test-0.1.0/users-guide.html
new file mode 100644
index 0000000..5e6f8c4
--- /dev/null
+++ b/content/releases/qpid-interop-test-0.1.0/users-guide.html
@@ -0,0 +1,598 @@
+<!DOCTYPE html>
+<!--
+ -
+ - Licensed to the Apache Software Foundation (ASF) under one
+ - or more contributor license agreements. See the NOTICE file
+ - distributed with this work for additional information
+ - regarding copyright ownership. The ASF licenses this file
+ - to you under the Apache License, Version 2.0 (the
+ - "License"); you may not use this file except in compliance
+ - with the License. You may obtain a copy of the License at
+ -
+ - http://www.apache.org/licenses/LICENSE-2.0
+ -
+ - Unless required by applicable law or agreed to in writing,
+ - software distributed under the License is distributed on an
+ - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ - KIND, either express or implied. See the License for the
+ - specific language governing permissions and limitations
+ - under the License.
+ -
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
+ <head>
+ <title>Qpid Interoperability Test Users Guide - Apache Qpid™</title>
+ <meta http-equiv="X-UA-Compatible" content="IE=edge"/>
+ <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+ <link rel="stylesheet" href="/site.css" type="text/css" async="async"/>
+ <link rel="stylesheet" href="/deferred.css" type="text/css" defer="defer"/>
+ <script type="text/javascript">var _deferredFunctions = [];</script>
+ <script type="text/javascript" src="/deferred.js" defer="defer"></script>
+ <!--[if lte IE 8]>
+ <link rel="stylesheet" href="/ie.css" type="text/css"/>
+ <script type="text/javascript" src="/html5shiv.js"></script>
+ <![endif]-->
+
+ <!-- Redirects for `go get` and godoc.org -->
+ <meta name="go-import"
+ content="qpid.apache.org git https://git-wip-us.apache.org/repos/asf/qpid-proton.git"/>
+ <meta name="go-source"
+ content="qpid.apache.org
+https://github.com/apache/qpid-proton/blob/go1/README.md
+https://github.com/apache/qpid-proton/tree/go1{/dir}
+https://github.com/apache/qpid-proton/blob/go1{/dir}/{file}#L{line}"/>
+ </head>
+ <body>
+ <div id="-content">
+ <div id="-top" class="panel">
+ <a id="-menu-link"><img width="16" height="16" src="" alt="Menu"/></a>
+
+ <a id="-search-link"><img width="22" height="16" src="" alt="Search"/></a>
+
+ <ul id="-global-navigation">
+ <li><a id="-logotype" href="/index.html">Apache Qpid<sup>™</sup></a></li>
+ <li><a href="/documentation.html">Documentation</a></li>
+ <li><a href="/download.html">Download</a></li>
+ <li><a href="/discussion.html">Discussion</a></li>
+ </ul>
+ </div>
+
+ <div id="-menu" class="panel" style="display: none;">
+ <div class="flex">
+ <section>
+ <h3>Project</h3>
+
+ <ul>
+ <li><a href="/overview.html">Overview</a></li>
+ <li><a href="/components/index.html">Components</a></li>
+ <li><a href="/releases/index.html">Releases</a></li>
+ </ul>
+ </section>
+
+ <section>
+ <h3>Messaging APIs</h3>
+
+ <ul>
+ <li><a href="/proton/index.html">Qpid Proton</a></li>
+ <li><a href="/components/jms/index.html">Qpid JMS</a></li>
+ <li><a href="/components/messaging-api/index.html">Qpid Messaging API</a></li>
+ </ul>
+ </section>
+
+ <section>
+ <h3>Servers and tools</h3>
+
+ <ul>
+ <li><a href="/components/broker-j/index.html">Broker-J</a></li>
+ <li><a href="/components/cpp-broker/index.html">C++ broker</a></li>
+ <li><a href="/components/dispatch-router/index.html">Dispatch router</a></li>
+ </ul>
+ </section>
+
+ <section>
+ <h3>Resources</h3>
+
+ <ul>
+ <li><a href="/dashboard.html">Dashboard</a></li>
+ <li><a href="https://cwiki.apache.org/confluence/display/qpid/Index">Wiki</a></li>
+ <li><a href="/resources.html">More resources</a></li>
+ </ul>
+ </section>
+ </div>
+ </div>
+
+ <div id="-search" class="panel" style="display: none;">
+ <form action="http://www.google.com/search" method="get">
+ <input type="hidden" name="sitesearch" value="qpid.apache.org"/>
+ <input type="text" name="q" maxlength="255" autofocus="autofocus" tabindex="1"/>
+ <button type="submit">Search</button>
+ <a href="/search.html">More ways to search</a>
+ </form>
+ </div>
+
+ <div id="-middle" class="panel">
+ <ul id="-path-navigation"><li><a href="/index.html">Home</a></li><li><a href="/releases/index.html">Releases</a></li><li><a href="/releases/qpid-interop-test-0.1.0/index.html">Qpid Interop Test 0.1.0</a></li><li>Qpid Interoperability Test Users Guide</li></ul>
+
+ <div id="-middle-content">
+ <div class="quoteblock">
+<div class="title">Apache License</div>
+<div class="content">
+<div class="paragraph"><p>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</p></div>
+<div class="paragraph"><p><a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a></p></div>
+<div class="paragraph"><p>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.</p></div>
+</div>
+<div class="attribution">
+</div></div>
+<h1 id="_qpid_interoperability_test_users_guide">Qpid Interoperability Test Users Guide</h1>
+<div class="sect1">
+<h2 id="_1_introduction">1. Introduction</h2>
+<div class="sectionbody">
+<div class="paragraph"><p>qpid-interop-test is an AMQP client interoperability test suite. It tests
+various aspects of the AMQP protocol and/or test client features against
+each other to ensure that they can interoperate.</p></div>
+<div class="paragraph"><p>The test suite consists of tests and shims. Each test has a set of test-cases
+which make up the test. Each test case will pass or fail a specific feature
+or piece of functionality under test.</p></div>
+<div class="paragraph"><p>Each test has a set of shims, which are small and specific clients which
+send and receive messages, and is written using one of the client libraries
+under test. For example, the amqp_types test has shims for the following
+clients:
+* AmqpNetLite
+* ProtonCpp
+* ProtonPython
+* RheaJS</p></div>
+<div class="paragraph"><p>To obtain both self- and interoperability testing, each test program will
+run each shim against every other shim in the role of both sender and
+receiver. For the amqp-type-test example above, this will result in the
+following combinations of shims being used:</p></div>
+<div class="tableblock">
+<table rules="all"
+width="30%"
+frame="border"
+cellspacing="0" cellpadding="4">
+<col width="10%" />
+<col width="45%" />
+<col width="45%" />
+<tbody>
+<tr>
+<td align="left" valign="top"><p class="table"></p></td>
+<td align="left" valign="top"><p class="table"><strong>Sender shim</strong></p></td>
+<td align="left" valign="top"><p class="table"><strong>Receiver shim</strong></p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">1</p></td>
+<td align="left" valign="top"><p class="table">AmqpNetLite</p></td>
+<td align="left" valign="top"><p class="table">AmqpNetLite</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">2</p></td>
+<td align="left" valign="top"><p class="table">AmqpNetLite</p></td>
+<td align="left" valign="top"><p class="table">ProtonCpp</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">3</p></td>
+<td align="left" valign="top"><p class="table">AmqpNetLite</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">4</p></td>
+<td align="left" valign="top"><p class="table">AmqpNetLite</p></td>
+<td align="left" valign="top"><p class="table">RheaJS</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">5</p></td>
+<td align="left" valign="top"><p class="table">ProtonCpp</p></td>
+<td align="left" valign="top"><p class="table">AmqpNetLite</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">6</p></td>
+<td align="left" valign="top"><p class="table">ProtonCpp</p></td>
+<td align="left" valign="top"><p class="table">ProtonCpp</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">7</p></td>
+<td align="left" valign="top"><p class="table">ProtonCpp</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">8</p></td>
+<td align="left" valign="top"><p class="table">ProtonCpp</p></td>
+<td align="left" valign="top"><p class="table">RheaJS</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">9</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython</p></td>
+<td align="left" valign="top"><p class="table">AmqpNetLite</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">10</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython</p></td>
+<td align="left" valign="top"><p class="table">ProtonCpp</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">11</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">12</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython</p></td>
+<td align="left" valign="top"><p class="table">RheaJS</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">13</p></td>
+<td align="left" valign="top"><p class="table">RheaJS</p></td>
+<td align="left" valign="top"><p class="table">AmqpNetLite</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">14</p></td>
+<td align="left" valign="top"><p class="table">RheaJS</p></td>
+<td align="left" valign="top"><p class="table">ProtonCpp</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">15</p></td>
+<td align="left" valign="top"><p class="table">RheaJS</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">16</p></td>
+<td align="left" valign="top"><p class="table">RheaJS</p></td>
+<td align="left" valign="top"><p class="table">RheaJS</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="paragraph"><p>so that for each test case, 16 individual tests are run. The test program
+will by default run all the available shims against each other in this way,
+but it is possible to control which shims are used using the --include-shim
+or --exclude-shim arguments (see below).</p></div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_2_obtaining">2. Obtaining</h2>
+<div class="sectionbody">
+<div class="paragraph"><p>qpid-interop-test is an Apache Qpid project.</p></div>
+<div class="paragraph"><p>Web page: xxx</p></div>
+<div class="paragraph"><p>Download soruce: xxx</p></div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_3_building">3. Building</h2>
+<div class="sectionbody">
+<div class="sect2">
+<h3 id="_a_install_dependencies">a. Install dependencies:</h3>
+<div class="ulist"><ul>
+<li>
+<p>
+Build tools: git, gcc, cmake
+</p>
+</li>
+<li>
+<p>
+Qpid Proton: qpid-proton-c-devel
+</p>
+</li>
+</ul></div>
+</div>
+<div class="sect2">
+<h3 id="_b_decide_on_local_vs_system_install">b. Decide on local vs system install</h3>
+<div class="sect3">
+<h4 id="_local_install">Local install:</h4>
+<div class="paragraph"><p>Installs all of the Proton and QIT bits in a local directory. This is
+useful for limited testing where you don’t want to have these files
+in your system directories. Also, if you don’t have root privileges, then
+this is the only way to install. The drawback is that you may need to
+adjust some environment settings (<code>PATH</code>, <code>PYTHONPATH</code>, <code>LD_LIBRARY_PATH</code>) so
+that the test will run.</p></div>
+</div>
+<div class="sect3">
+<h4 id="_system_install">System install:</h4>
+<div class="paragraph"><p>Installs the files into traditional system locations. This type of install
+requires root privileges. As the files are located in expected locations, no
+environment settings need be made.</p></div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_c_build_qpid_proton">c. Build qpid-proton</h3>
+<div class="paragraph"><p><strong>System install:</strong></p></div>
+<div class="listingblock">
+<div class="content">
+<pre><code> $ cd qpid-proton
+ $ mkdir build
+ $ cd build
+ $ cmake ..
+ $ make
+ $ sudo make install</code></pre>
+</div></div>
+<div class="paragraph"><p><strong>Local install:</strong></p></div>
+<div class="listingblock">
+<div class="content">
+<pre><code> $ cd qpid-proton
+ $ mkdir build
+ $ cd build
+ $ cmake ..
+ $ make install</code></pre>
+</div></div>
+</div>
+<div class="sect2">
+<h3 id="_d_build_qpid_interop_test">d. Build qpid-interop-test</h3>
+<div class="paragraph"><p><strong>System install:</strong></p></div>
+<div class="listingblock">
+<div class="content">
+<pre><code> $ cd qpid-interop-test
+ $ mkdir build
+ $ cd build
+ $ cmake ..
+ $ make
+ $ sudo make install</code></pre>
+</div></div>
+<div class="paragraph"><p><strong>Local install:</strong></p></div>
+<div class="listingblock">
+<div class="content">
+<pre><code> $ cd qpid-interop-test
+ $ mkdir build
+ $ cd build
+ $ cmake ..
+ $ make install</code></pre>
+</div></div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_4_running">4. Running</h2>
+<div class="sectionbody">
+<div class="paragraph"><p>The tests assume a broker is available and running. The assumed default is at
+<code>localhost:5672</code>. For other broker location(s), use the <code>--sender</code> and <code>--receiver</code>
+arguments to specify where the clients should interact, see below.</p></div>
+<div class="paragraph"><p>The tests do not start or stop brokers.</p></div>
+<div class="paragraph"><p>There are several tests in the test suite:</p></div>
+<div class="ulist"><ul>
+<li>
+<p>
+<strong>amqp_types_test.py</strong> - Tests all of the AMQP primitive types. This primarily tests
+ the encoding and decoding of AMQP types.
+</p>
+</li>
+<li>
+<p>
+<strong>amqp_large_content_test.py</strong> - Tests large messages of various types. Messages sizes
+ are 1MB, 10MB, 100MB. Compound types (lists, maps, etc) send elements of various
+ sizes so that the total payload is the target size.
+</p>
+</li>
+<li>
+<p>
+<strong>jms_messages_test.py</strong> - Tests JMS message types (as implemented by Qpid-jms over AMQP)
+ from all the Qpid clients (including non-jms clients)
+</p>
+</li>
+<li>
+<p>
+<strong>jms_hdrs_props_test.py</strong> - Tests various combinations of JMS headers and properties
+ are correctly sent and received by the various clients.
+</p>
+</li>
+</ul></div>
+<div class="paragraph"><p>Each test is executed directly.</p></div>
+<div class="sect2">
+<h3 id="_command_line_arguments">Command-line arguments</h3>
+<div class="tableblock">
+<table rules="all"
+width="100%"
+frame="border"
+cellspacing="0" cellpadding="4">
+<caption class="title">Table 1. Common to all tests</caption>
+<col width="20%" />
+<col width="80%" />
+<tbody>
+<tr>
+<td align="left" valign="top"><p class="table"><code>--help</code></p></td>
+<td align="left" valign="top"><p class="table">Print help. This is useful for seeing the available argument options and
+ defaults for some arguments.</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table"><code>--sender</code></p></td>
+<td align="left" valign="top"><p class="table">Node to which test suite will send messages.
+ Format: <code>ip-address:port</code>
+ Default: <code>localhost:5672</code></p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table"><code>--receiver</code></p></td>
+<td align="left" valign="top"><p class="table">Node from which test suite will receive messages.
+ Format: <code>ip-address:port</code>
+ Default: <code>localhost:5672</code></p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table"><code>--no-skip</code></p></td>
+<td align="left" valign="top"><p class="table">Do not skip tests that are excluded by default for reasons of a known bug.
+ Warning: some tests may lock up of freeze rather than fail.</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table"><code>--broker-type</code></p></td>
+<td align="left" valign="top"><p class="table">Specify the broker manually, which eliminates the test connection made
+ to the broker to determine its identity through connection properties. If
+ "None" is specified, then Artemis broker will be assumed, but this will
+ change in the future when Artemis fixes the connection properties issue.
+ Format: For our current brokers: one of: "ActiveMQ", "qpid-cpp",
+ "qpid-dispatch-router". Artemis does not currently pass its name
+ in connection properties, and is equivalent to "None".</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table"><code>--include-shim</code></p></td>
+<td align="left" valign="top"><p class="table">Name of shim to include. Cannot be used together with <code>--exclude-shim</code>. May
+ be used multiple times to include more than one shim.</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table"><code>--exclude-shim</code></p></td>
+<td align="left" valign="top"><p class="table">Name of shim to exclude. Cannot be used together with <code>--include-shim</code>. May
+ be used multiple times to exclude more that one shim.</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="tableblock">
+<table rules="all"
+width="100%"
+frame="border"
+cellspacing="0" cellpadding="4">
+<caption class="title">Table 2. amqp-types-test</caption>
+<col width="20%" />
+<col width="80%" />
+<tbody>
+<tr>
+<td align="left" valign="top"><p class="table"><code>--include-type</code></p></td>
+<td align="left" valign="top"><p class="table">Name of AMQP type to include. Cannot be used together with <code>--exclude-type</code>.
+ May be used multiple times to include more than one type.</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table"><code>--exclude-type</code></p></td>
+<td align="left" valign="top"><p class="table">Name of AMQP type to exclude. Cannot be used together with <code>--include-type</code>.
+ May be used multiple times to exclude more than one type.</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="tableblock">
+<table rules="all"
+width="100%"
+frame="border"
+cellspacing="0" cellpadding="4">
+<caption class="title">Table 3. amqp-large-content-test</caption>
+<col width="100%" />
+<tbody>
+<tr>
+<td align="left" valign="top"><p class="table">No other parameters. There is currently no way to select/limit the message size, but there
+an issue open to address this limitation.</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="tableblock">
+<table rules="all"
+width="100%"
+frame="border"
+cellspacing="0" cellpadding="4">
+<caption class="title">Table 4. jms-messages-test</caption>
+<col width="20%" />
+<col width="80%" />
+<tbody>
+<tr>
+<td align="left" valign="top"><p class="table"><code>--include-type</code></p></td>
+<td align="left" valign="top"><p class="table">Name of JMS message type to include. Cannot be used together with
+ <code>--exclude-type</code>. May be used multiple times to include more than one type.</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table"><code>--exclude-type</code></p></td>
+<td align="left" valign="top"><p class="table">Name of JMS message type to exclude. Cannot be used together with
+ <code>--include-type</code>. May be used multiple times to exclude more than one type.</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="tableblock">
+<table rules="all"
+width="100%"
+frame="border"
+cellspacing="0" cellpadding="4">
+<caption class="title">Table 5. jms-hdrs-props-test</caption>
+<col width="20%" />
+<col width="80%" />
+<tbody>
+<tr>
+<td align="left" valign="top"><p class="table"><code>--include-type</code></p></td>
+<td align="left" valign="top"><p class="table">Name of Java property type to include. Cannot be used together with
+ <code>--exclude-type</code>. May be used multiple times to include more than one type.</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table"><code>--exclude-type</code></p></td>
+<td align="left" valign="top"><p class="table">Name of Java property type to exclude. Cannot be used together with
+ <code>--include-type</code>. May be used multiple times to exclude more than one type.</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="paragraph"><p>There is currently no way to control/limit the JMS header types in this test, but there is
+an issue open to address this limitation.</p></div>
+<div class="sect3">
+<h4 id="_examples">Examples:</h4>
+<div class="paragraph"><p>To limit amqp_types_test to boolean type only:
+<code>$ amqp_types_test --include-type boolean</code></p></div>
+<div class="paragraph"><p>To limit amqp_types_test to Qpid-cpp and Proton-python shims only:
+<code>$ amqp_types_test --include-shim ProtonCpp --include-shim ProtonPython</code></p></div>
+<div class="paragraph"><p>To test against a pair of Dispatch Routers and a broker running on the local machine
+as follows (first set up the brokers and routers):</p></div>
+<div class="listingblock">
+<div class="content">
+<pre><code>+----------+ 9001 +----------+ 5672 +--------+
+| sender |--------->| dispatch |-------->| |
+| shim | | router 1 | | |
++----------+ +----------+ | |
+ | broker |
++----------+ 9002 +----------+ 5672 | |
+| receiver |<---------| dispatch |<--------| |
+| shim | | router 2 | | |
++----------+ +----------+ +--------+</code></pre>
+</div></div>
+<div class="paragraph"><p><code>$ amqp_types_test --sender localhost:9001 --receiver localhost:9002</code></p></div>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_5_output">5. Output</h2>
+<div class="sectionbody">
+<div class="paragraph"><p>All the tests will list each test as it runs and whether it passes or fails.
+If a test fails, then the details of the failure will be printed at the end of
+the test.</p></div>
+<div class="listingblock">
+<div class="content">
+<pre><code> ======================================================================
+ FAIL: test.B.MESSAGE.JMS_TYPE_HEADER:string+JMS_REPLYTO_HEADER:topic.QpidJms->ProtonCpp (__main__.PartB_JmsHeaderCombination_TestCase)
+ ----------------------------------------------------------------------
+ Traceback (most recent call last):
+ File "./install/lib/python2.7/site-packages/qpid_interop_test/jms_hdrs_props_test.py", line 422, in inner_test_method
+ receive_shim)
+ File "./install/lib/python2.7/site-packages/qpid_interop_test/jms_hdrs_props_test.py", line 313, in run_test
+ self.fail(str(receive_obj))
+ AssertionError: JmsReceiver error: Unexpected JMS message header: JMS_PRIORITY: Expected default priority (4), found priority 0</code></pre>
+</div></div>
+<div class="paragraph"><p>Currently, the tests do not produce log files.</p></div>
+</div>
+</div>
+
+
+ <hr/>
+
+ <ul id="-apache-navigation">
+ <li><a href="http://www.apache.org/">Apache</a></li>
+ <li><a href="http://www.apache.org/licenses/">License</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
+ <li><a href="http://www.apache.org/foundation/thanks.html">Thanks!</a></li>
+ <li><a href="/security.html">Security</a></li>
+ <li><a href="http://www.apache.org/"><img id="-apache-feather" width="48" height="14" src="" alt="Apache"/></a></li>
+ </ul>
+
+ <p id="-legal">
+ Apache Qpid, Messaging built on AMQP; Copyright © 2015
+ The Apache Software Foundation; Licensed under
+ the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache
+ License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton,
+ Proton, Apache, the Apache feather logo, and the Apache Qpid
+ project logo are trademarks of The Apache Software
+ Foundation; All other marks mentioned may be trademarks or
+ registered trademarks of their respective owners
+ </p>
+ </div>
+ </div>
+ </div>
+ </body>
+</html>
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/3ef7d309/content/site.css
----------------------------------------------------------------------
diff --git a/content/site.css b/content/site.css
index 81058e3..c6fca7f 100644
--- a/content/site.css
+++ b/content/site.css
@@ -218,6 +218,7 @@ td, th {
td:last-child, th:last-child {
padding-right: 0;
+ border-right: none;
}
td {
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/3ef7d309/input/_transom_config.py
----------------------------------------------------------------------
diff --git a/input/_transom_config.py b/input/_transom_config.py
index 12116a2..9002cde 100644
--- a/input/_transom_config.py
+++ b/input/_transom_config.py
@@ -25,7 +25,7 @@ class _Release(object):
broker_j_release = _Release(site_url, "Qpid Broker-J", "qpid-broker-j", "7.0.0")
cpp_release = _Release(site_url, "Qpid C++", "qpid-cpp", "1.37.0")
dispatch_release = _Release(site_url, "Qpid Dispatch", "qpid-dispatch", "1.0.0")
-interop_test_release = _Release(site_url, "Qpid Interop Test", "qpid-interop", "0.1.0")
+interop_test_release = _Release(site_url, "Qpid Interop Test", "qpid-interop-test", "0.1.0")
java_release = _Release(site_url, "Qpid for Java", "qpid-java", "6.1.5")
jms_release = _Release(site_url, "Qpid JMS", "qpid-jms", "0.27.0")
jms_amqp_0_x_release = _Release(site_url, "Qpid JMS for AMQP 0-x", "qpid-jms-amqp-0-x", "6.3.0")
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/3ef7d309/input/components/index.md
----------------------------------------------------------------------
diff --git a/input/components/index.md b/input/components/index.md
index a6e237b..81cf30c 100644
--- a/input/components/index.md
+++ b/input/components/index.md
@@ -69,6 +69,10 @@ connecting clients, brokers, and standalone services.
- [C++ broker](cpp-broker/index.html) - A native-code AMQP message broker
- [Dispatch router](dispatch-router/index.html) - An AMQP router for scalable messaging interconnect
+## Messaging tools
+
+- [Qpid Interop Test](interop-test/index.html) - An AMQP 1.0 interoperability test suite
+
## Compatibility
<div class="scroll" markdown="1">
@@ -81,6 +85,7 @@ connecting clients, brokers, and standalone services.
| [Qpid JMS]({{site_url}}/components/jms/index.html) | Java | JVM | 1.0, 0-10, 0-9-1, 0-9, 0-8 |
| [Qpid Messaging API]({{site_url}}/components/messaging-api/index.html) | C++, Perl, Python, Ruby, .NET | Linux, Windows | 1.0, 0-10 |
| [Qpid Proton]({{site_url}}/proton/index.html) | C, C++, Java, JavaScript, Python, Ruby | JVM, Linux, Windows | 1.0 |
+| [Qpid Interop Test](interop-test/index.html) | - | Linux | 1.0 |
Any Qpid components that share an AMQP version can interoperate. For
instance, the brokers are implemented in C++ and Java respectively,
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/3ef7d309/input/components/interop-test/index.md
----------------------------------------------------------------------
diff --git a/input/components/interop-test/index.md b/input/components/interop-test/index.md
index ca0478f..a203e49 100644
--- a/input/components/interop-test/index.md
+++ b/input/components/interop-test/index.md
@@ -23,19 +23,133 @@
<div class="feature" markdown="1">
-## AMQP interoperability testing
-
-XXX
+A test suite that systematically tests [AMQP 1.0]({{site_url}}/amqp/index.html)
+clients against each other to ensure that they are working correctly
+with each other. The tests consist of matched client pairs to send and receive
+messages through an AMQP server (or combination of connected servers). These tests
+also check that the AMQP server is able to handle the clients and AMQP traffic.
</div>
## Features
- - XXX
+<div class="two-column" markdown="1">
+
+ - Tests all available clients against each other
+ - Tests AMQP clients against any AMQP server
+ - Tests AMQP types
+ - Tests large messages
+ - Tests JMS messages
+ - Tests JMS headers and properties
+
+</div>
+
+## Supported servers
+
+Any servers that can handle [AMQP 1.0]({{site_url}}/amqp/index.html)
+will work. By default, the tests run against localhost using the default AMQP port (5672), but these can be
+changed to any valid IP address and port.
+
+## Supported clients
+
+The following clients are currently supported:
+
+ - [Qpid Proton C++]({{current_proton_release_url}}/proton/c/api/files.html)
+ - [Qpid Proton Python]({{current_proton_release_url}}/proton/python/api/index.html)
+ - [Qpid JMS]({{site_url}}/components/jms/index.html)
+ - [Rhea Javascript](https://github.com/grs/rhea)
+ - [AMQP .Net Lite](https://github.com/Azure/amqpnetlite)
+
+## AMQP test coverage
+
+<div class="scroll" markdown="1">
+
+<table>
+ <thead>
+ <tr>
+ <th> </th>
+ <th colspan="4">Clients</th>
+ </tr>
+ <tr>
+ <th>Test</th>
+ <th>Qpid Proton C++</th>
+ <th>Qpid Proton Python</th>
+ <th>Rhea</th>
+ <th>AMQP .Net Lite</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <th>AMQP types</th>
+ <td>YES</td>
+ <td>YES</td>
+ <td>YES</td>
+ <td>YES</td>
+ </tr>
+ <tr>
+ <th>Large AMQP messages</th>
+ <td>YES</td>
+ <td>YES</td>
+ <td></td>
+ <td>YES</td>
+ </tr>
+ </tbody>
+</table>
+
+</div>
+
+## JMS test coverage
+
+<div class="scroll" markdown="1">
+
+<table>
+ <thead>
+ <tr>
+ <th> </th>
+ <th colspan="5">Clients</th>
+ </tr>
+ <tr>
+ <th>Test</th>
+ <th>Qpid JMS</th>
+ <th>Qpid Proton C++</th>
+ <th>Qpid Proton Python</th>
+ <th>Rhea</th>
+ <th>AMQP .Net Lite</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <th>JMS messages</th>
+ <td>YES</td>
+ <td>YES</td>
+ <td>YES</td>
+ <td></td>
+ <td></td>
+ </tr>
+ <tr>
+ <th>JMS headers & properties</th>
+ <td>YES</td>
+ <td>YES</td>
+ <td>YES</td>
+ <td></td>
+ <td></td>
+ </tr>
+ </tbody>
+</table>
+
+</div>
## Documentation
- - XXX
+<div class="two-column" markdown="1">
+
+ - [Quickstart guide]({{current_interop_test_release_url}}/QUICKSTART.html)
+ - [User guide]({{current_interop_test_release_url}}/users-guide.html)
+ - [Developer overview](https://git-wip-us.apache.org/repos/asf?p=qpid-interop-test.git;a=blob_plain;f=docs/qpid-interop-test-devel-overview.txt;hb=0.1.0)
+ - [Test HOWTO](https://git-wip-us.apache.org/repos/asf?p=qpid-interop-test.git;a=blob_plain;f=docs/Test_HOWTO.txt;hb=0.1.0)
+ - [Shim HOWTO](https://git-wip-us.apache.org/repos/asf?p=qpid-interop-test.git;a=blob_plain;f=docs/Shim_HOWTO.txt;hb=0.1.0)
+
+</div>
</div>
@@ -43,21 +157,19 @@ XXX
## Releases
-;; - {{current_interop_test_release_link}}
-;; - [Past releases]({{site_url}}/releases/index.html#past-releases)
- - XXX
+ - {{current_interop_test_release_link}}
+ - [Past releases]({{site_url}}/releases/index.html#past-releases)
## Issues
+ - [Report a bug](https://issues.apache.org/jira/secure/CreateIssue.jspa?pid=12318621&issuetype=1&priority=3)
+ - [Request an improvement](https://issues.apache.org/jira/secure/CreateIssue.jspa?pid=12318621&issuetype=4&priority=3)
- <form id="-jira-goto-form">Go to issue <input name="jira" value="QPIDIT-"/></form>
- [JIRA project page](https://issues.apache.org/jira/browse/QPIDIT)
-
+
## Source code
+ - [Browse via GitHub](https://github.com/apache/qpid-interop-test)
- [Git clone URL](https://git-wip-us.apache.org/repos/asf/qpid-interop-test.git)
-
-## Resources
-
- - XXX
-
+
</div>
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/3ef7d309/input/documentation.md
----------------------------------------------------------------------
diff --git a/input/documentation.md b/input/documentation.md
index e454a01..df65da5 100644
--- a/input/documentation.md
+++ b/input/documentation.md
@@ -95,6 +95,23 @@ You can find older versions with our
---
+## Messaging tools
+
+<div class="flex" markdown="1">
+<section markdown="1">
+
+### Qpid Interop Test
+
+ - [Overview]({{site_url}}/components/interop-test/index.html)
+ - [Quickstart guide]({{current_interop_test_release_url}}/QUICKSTART.html)
+ - [User guide]({{current_interop_test_release_url}}/users-guide.html)
+ - [Developer overview](https://git-wip-us.apache.org/repos/asf?p=qpid-interop-test.git;a=blob_plain;f=docs/qpid-interop-test-devel-overview.txt;hb=0.1.0)
+
+</section>
+</div>
+
+---
+
## More information
- [Documentation snapshots]({{site_url}}/releases/snapshots.html)
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/3ef7d309/input/download.md
----------------------------------------------------------------------
diff --git a/input/download.md b/input/download.md
index 8abfc10..46d1515 100644
--- a/input/download.md
+++ b/input/download.md
@@ -69,11 +69,11 @@ and
[MD5](http://www.apache.org/dist/qpid/broker-j/{{current_broker_j_release}}/apache-qpid-broker-j-{{current_broker_j_release}}-src.tar.gz.md5),
[SHA512](http://www.apache.org/dist/qpid/broker-j/{{current_broker_j_release}}/apache-qpid-broker-j-{{current_broker_j_release}}-src.tar.gz.sha512)\]
-;; ## Other components
-;;
-;; | Content | Download | Verify |
-;; | ------- | -------- | ------ |
-;; | [Interop Test]({{site_url}}/components/interop-test/index.html) | [qpid-interop-test-{{current_interop_test_release}}.tar.gz](http://www.apache.org/dyn/closer.lua/qpid/interop-test/{{current_interop_test_release}}/qpid-interop-test-{{current_interop_test_release}}.tar.gz) | [ASC](http://www.apache.org/dist/qpid/interop-test/{{current_interop_test_release}}/qpid-interop-test-{{current_interop_test_release}}.tar.gz.asc), [SHA](http://www.apache.org/dist/qpid/interop-test/{{current_interop_test_release}}/qpid-interop-test-{{current_interop_test_release}}.tar.gz.sha) |
+## Messaging tools
+
+| Content | Download | Verify |
+| ------- | -------- | ------ |
+|[Qpid Interop Test]({{site_url}}/components/interop-test/index.html) | [qpid-interop-test-{{current_interop_test_release}}.tar.gz](http://www.apache.org/dyn/closer.lua/qpid/interop-test/{{current_interop_test_release}}/qpid-interop-test-{{current_interop_test_release}}.tar.gz) | [ASC](http://www.apache.org/dist/qpid/interop-test/{{current_interop_test_release}}/qpid-interop-test-{{current_interop_test_release}}.tar.gz.asc), [MD5](http://www.apache.org/dist/qpid/interop-test/{{current_interop_test_release}}/qpid-interop-test-{{current_interop_test_release}}.tar.gz.md5), [SHA512](http://www.apache.org/dist/qpid/interop-test/{{current_interop_test_release}}/qpid-interop-test-{{current_interop_test_release}}.tar.gz.sha512) |
## Verify what you download
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/3ef7d309/input/releases/index.md
----------------------------------------------------------------------
diff --git a/input/releases/index.md b/input/releases/index.md
index 87aabcb..ccdca76 100644
--- a/input/releases/index.md
+++ b/input/releases/index.md
@@ -37,6 +37,7 @@ the
- [Qpid JMS 0.27.0](qpid-jms-0.27.0/index.html), October 2017
- [Qpid Proton 0.18.1](qpid-proton-0.18.1/index.html), November 2017
- [Qpid Proton-J 0.23.0](qpid-proton-j-0.23.0/index.html), October 2017
+ - [Qpid Interop-test 0.1.0](qpid-interop-test-0.1.0/index.html), November 2017
</div>
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@qpid.apache.org
For additional commands, e-mail: commits-help@qpid.apache.org