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 2018/09/07 19:51:28 UTC
[1/2] qpid-site git commit: Update for qpid-interop-test-0.2.0 web
pages on the Qpid web site
Repository: qpid-site
Updated Branches:
refs/heads/asf-site d94787130 -> e601a53fb
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/e601a53f/input/releases/qpid-interop-test-0.2.0/QUICKSTART.md
----------------------------------------------------------------------
diff --git a/input/releases/qpid-interop-test-0.2.0/QUICKSTART.md b/input/releases/qpid-interop-test-0.2.0/QUICKSTART.md
new file mode 100644
index 0000000..c0c1aae
--- /dev/null
+++ b/input/releases/qpid-interop-test-0.2.0/QUICKSTART.md
@@ -0,0 +1,370 @@
+<!--
+
+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
+
+## 1. Overview
+
+You must build *and install* qpid-interop-test before you can run the tests.
+
+By default, qpid-interop-test will install to `/usr/local` (and will thus also
+require root privileges), but you can set any non-privileged 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
+ * Python 3.x
+ * cmake
+ * Java JDK
+ * Maven
+ * JSON cpp
+
+The following Qpid components must be installed *before* you build and install
+qpid-interop-test:
+
+ * Qpid Proton C++ development
+ * Qpid Python
+ * Python2 Qpid Proton
+ * Python3 Qpid Proton
+
+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)
+
+In addition, if you wish to run the tests against a broker on the build machine,
+it will be necessary to have a running broker. One of the following may be
+installed and started against which to run the interop tests as a local broker:
+
+ * Artemis Java broker
+ * ActiveMQ Java broker
+ * Qpid C++ broker
+ * Qpid Dispatch router (which may be used as a single node, or as part of a
+ routed configuration)
+
+Any AMQP 1.0 broker should work. Tests can also be run against a
+remote broker provided the broker IP address is known.
+
+These 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
+3. Build qpid-interop-test
+4. Run the tests
+
+## 2. Install prerequisites
+
+### 2.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.
+
+### 2.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
+yum install epel-release-latest-7.noarch.rpm
+````
+
+then install the following packages:
+
+````
+yum -y install jsoncpp-devel nodejs-rhea qpid-proton-cpp-devel python-qpid-proton qpid-proton-cpp-devel python2-qpid-proton
+````
+
+### 2.3 Fedora 28
+
+All packages are available directly from the Fedora repositories:
+
+````
+dnf -y 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 qpid-proton-cpp-devel python2-qpid-proton python3-qpid-proton
+````
+
+### 2.4 CentOS7 Docker image
+
+Docker images come with only the bare essentials, so there is more to install than a standard bare-metal install:
+
+````
+yum -y install vim unzip wget git gcc-c++ make cmake maven swig java-1.8.0-openjdk-devel perl-XML-XPath python-devel procps-ng
+````
+
+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
+yum -y install epel-release-latest-7.noarch.rpm
+````
+
+then install the following packages:
+
+````
+yum -y install mono-devel python34-devel jsoncpp-devel nodejs-rhea qpid-proton-cpp-devel python-qpid-proton qpid-proton-cpp-devel python2-qpid-proton
+````
+
+Note that at the time of release, there is no python3-qpid-proton package available for CentOS7, but this should be available soon. Tests should be run with
+the --exclude-shim ProtonPython3 flag to avoid errors.
+
+### 2.5 Fedora 28 Docker image
+
+````
+dnf -y install vim unzip wget procps-ng git gcc-c++ make cmake maven swig java-1.8.0-openjdk-devel perl-XML-XPath python-devel mono-devel python3-devel jsoncpp-devel nodejs-rhea python-qpid-proton qpid-proton-cpp-devel python2-qpid-proton python3-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 -y install qpid-cpp-server # CentOS7/RHEL
+
+or
+
+ dnf -y install qpid-cpp-server # Fedora 28
+
+and set the configuration file in /etc/qpid/qpidd.conf as follows:
+
+````
+auth=no
+queue-patterns=qit
+````
+
+The broker may be started via service, but if running in a Docker container, this may not work. In this case, start the broker directly:
+
+ /sbin/qpidd -d
+
+and can be stopped with
+
+ /sbin/qpidd -q
+
+### 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
+}
+
+````
+
+The broker may be started via service, but if running in a Docker container, this may not work. In this case, start the broker directly:
+
+ /sbin/qdrouterd -d
+
+and can be stopped with
+
+ pkill qdrouterd # Needs procps-ng package installed in Docker containers
+
+## 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
+
+or
+
+ git clone https://github.com/apache/qpid-interop-test.git
+
+Assuming the source tree is located in directory qpid-interop-test:
+
+````
+cd qpid-interop-test
+git tag -l # See list of tags
+git checkout tags/<tagname> # tagname is the release, for example 0.2.0-rc3
+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_complex_types_test | Tests complex AMQP 1.0 types | C++ Python2 Python3 |
+| amqp_large_content_test | Tests implementation of large messages up to 10MB | C++ Python2 Python3 AMQP.NetLite |
+| amqp_types_test | Tests the implementation of AMQP 1.0 types | C++ Python2 Python3 Rhea AMQP.NetLite |
+| jms_hdrs_props_test | Tests JMS headers and properties | C++ JMS Python2 Python3 |
+| jms_messages_test | Tests all JMS message types (except ObjectMessage) | C++ JMS Python2 Python3 |
+
+Each test has command-line options which can be used to limit or modify the test, use the `--help` option to see
+these options.
+
+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>
+...
+````
+
+**CentOS7 Note:**
+
+CentOS7 does not have the `python3-qpid-proton` package available at the time of the 0.2.0 release. To avoid
+errors in the test on CentOS7 (which does not yet auto-detect but assumes the availability of this package), use the
+`--exclude-shim ProtonPython3` command-line parameter to disable this shim. See
+[QPIDIT-126](https://issues.apache.org/jira/browse/QPIDIT-126) for progress and further details on this issue.
+
+## 5. Optional Components
+
+### 5.1 AMQP.Net Lite Client
+
+A detailed description of how to install and run the AMQP.Net Lite client on Fedora may be found at Apache
+JIRA [QPIDIT-105](https://issues.apache.org/jira/browse/QPIDIT-105), and can easily be adapted to other
+Linux operating systems. The following packages need to be installed:
+
+ * Mono
+ * Pre-compiled AMQP.Net Lite library (available from https://www.nuget.org/api/v2/package/AMQPNetLite/)
+
+See the above JIRA for detailed instructions. Here is a summary:
+
+Download/install the Amqp.Net Lite dlls. They are initially zipped, unzip them into a well-known location.
+Make sure you can find the path to the required .dll file for the version you are using, for example:
+
+```
+/abs/path/to/amqp.netlite/lib/net45
+```
+
+When building qpid-interop-test (section 3 above), add the following environment variable to the cmake parameters:
+`-DAMQPNETLITE_LIB_DIR=<abs/path/to/amqp.netlite/lib/net45>`. When cmake completes, look for the following:
+
+```
+-- BUILD_AMQPNETLITE = ON
+```
+
+which shows that the dll was found and the .netlite tests will be enabled. If you see the following,
+then the required dll was not found:
+
+```
+-- BUILD_AMQPNETLITE = OFF
+```
+The messages immediately preceding this will give a clue as to why it was not found, one of `AMQPNETLITE_LIB_DIR`
+not defined or `Amqp.Net.dll` was not found in the path.
+
+### 5.2 Rhea JavaScript Client
+
+The following packages need to be installed:
+
+ * nodejs
+ * npm
+
+The Rhea source may be cloned from github:
+
+ git clone https://github.com/amqp/rhea.git
+
+If the `rhea` directory is discovered when qpid-interop-test runs `cmake`, then the Rhea client tests
+will be enabled. If the directory is not found, it may be set through the `RHEA_DIR` variable
+when running `cmake`.
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/e601a53f/input/releases/qpid-interop-test-0.2.0/index.md
----------------------------------------------------------------------
diff --git a/input/releases/qpid-interop-test-0.2.0/index.md b/input/releases/qpid-interop-test-0.2.0/index.md
new file mode 100644
index 0000000..ec3f0e8
--- /dev/null
+++ b/input/releases/qpid-interop-test-0.2.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.2.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.2.0.tar.gz](http://archive.apache.org/dist/qpid/interop-test/0.2.0/qpid-interop-test-0.2.0.tar.gz) | [ASC](https://archive.apache.org/dist/qpid/interop-test/0.2.0/qpid-interop-test-0.2.0.tar.gz.asc), [SHA512](https://archive.apache.org/dist/qpid/interop-test/0.2.0/qpid-interop-test-0.2.0.tar.gz.sha512)|
+
+## 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.2.0)
+ - [Resolved issues in JIRA](https://issues.apache.org/jira/issues/?jql=project+%3D+QPIDIT+AND+fixVersion+%3D+%270.2.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.2.0)
+
+<script type="text/javascript">
+ _deferredFunctions.push(function() {
+ if ("0.2.0" === "{{current_interop_test_release}}") {
+ _modifyCurrentReleaseLinks();
+ }
+ });
+</script>
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/e601a53f/input/releases/qpid-interop-test-0.2.0/release-notes.md
----------------------------------------------------------------------
diff --git a/input/releases/qpid-interop-test-0.2.0/release-notes.md b/input/releases/qpid-interop-test-0.2.0/release-notes.md
new file mode 100644
index 0000000..4e9dfbf
--- /dev/null
+++ b/input/releases/qpid-interop-test-0.2.0/release-notes.md
@@ -0,0 +1,56 @@
+;;
+;; 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.2.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-65](https://issues.apache.org/jira/browse/QPIDIT-65) - Add command-line controls to JMS_hdrs_props_test to control test more precisely
+ - [QPIDIT-93](https://issues.apache.org/jira/browse/QPIDIT-93) - Optionally produce xUnit XML report with test results
+ - [QPIDIT-109](https://issues.apache.org/jira/browse/QPIDIT-109) - Add ability to run Proton Python shims under Python 3
+ - [QPIDIT-110](https://issues.apache.org/jira/browse/QPIDIT-110) - Add check for failure of Sender shim, if so, kill Receiver shim
+ - [QPIDIT-112](https://issues.apache.org/jira/browse/QPIDIT-112) - Change test queue prefix from "jms.queue.qpid_interop" to "qit"
+ - [QPIDIT-115](https://issues.apache.org/jira/browse/QPIDIT-115) - Print both stderr and stdout output when stderr output is detected on a shim
+ - [QPIDIT-127](https://issues.apache.org/jira/browse/QPIDIT-127) - update to use the current v19 apache parent pom
+
+## Bugs fixed
+
+ - [QPIDIT-79](https://issues.apache.org/jira/browse/QPIDIT-79) - Stopping Python tests using ctrl+c sometimes results in a zombie shim
+ - [QPIDIT-85](https://issues.apache.org/jira/browse/QPIDIT-85) - Tests don't limit the number of times it tries to connect to a broker
+ - [QPIDIT-106](https://issues.apache.org/jira/browse/QPIDIT-106) - Cmake does not find custom-installed maven
+ - [QPIDIT-113](https://issues.apache.org/jira/browse/QPIDIT-113) - AMQP.NetLite shims produce error message on stderr which should be ignored
+ - [QPIDIT-114](https://issues.apache.org/jira/browse/QPIDIT-114) - [AMQP.NetLite] AMQP char type is not supported, but is not excluded from test
+ - [QPIDIT-128](https://issues.apache.org/jira/browse/QPIDIT-128) - misuse of JAVA_HOME causes tests to error without clear indication why
+ - [QPIDIT-129](https://issues.apache.org/jira/browse/QPIDIT-129) - tests reference wrong 'shim' version for Qpid JMS
+ - [QPIDIT-130](https://issues.apache.org/jira/browse/QPIDIT-130) - 'utils' module is versioned incorrectly
+
+## Tasks
+
+ - [QPIDIT-37](https://issues.apache.org/jira/browse/QPIDIT-37) - Add test timeout to receiver shims so that when not all expected messages are received, the test does not wait indefinitely
+ - [QPIDIT-61](https://issues.apache.org/jira/browse/QPIDIT-61) - Condense common code from the Python tests into a test module.
+ - [QPIDIT-107](https://issues.apache.org/jira/browse/QPIDIT-107) - Add support for JMS message properties in ProtonCpp shim
+ - [QPIDIT-119](https://issues.apache.org/jira/browse/QPIDIT-119) - Add AMQP complex type test
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/e601a53f/input/releases/qpid-interop-test-0.2.0/users-guide.html.in
----------------------------------------------------------------------
diff --git a/input/releases/qpid-interop-test-0.2.0/users-guide.html.in b/input/releases/qpid-interop-test-0.2.0/users-guide.html.in
new file mode 100644
index 0000000..e16876f
--- /dev/null
+++ b/input/releases/qpid-interop-test-0.2.0/users-guide.html.in
@@ -0,0 +1,540 @@
+<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
+* ProtonPython2
+* ProtonPython3
+* 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">ProtonPython2</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">ProtonPython3</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">5</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">6</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">7</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">8</p></td>
+<td align="left" valign="top"><p class="table">ProtonCpp</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython2</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">9</p></td>
+<td align="left" valign="top"><p class="table">ProtonCpp</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython3</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">10</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">11</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython2</p></td>
+<td align="left" valign="top"><p class="table">AmqpNetLite</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">12</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython2</p></td>
+<td align="left" valign="top"><p class="table">ProtonCpp</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">13</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython2</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython2</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">14</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython2</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython3</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">15</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython2</p></td>
+<td align="left" valign="top"><p class="table">RheaJS</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">16</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython3</p></td>
+<td align="left" valign="top"><p class="table">AmqpNetLite</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">17</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython3</p></td>
+<td align="left" valign="top"><p class="table">ProtonCpp</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">18</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython3</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython2</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">19</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython3</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython3</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">20</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython3</p></td>
+<td align="left" valign="top"><p class="table">RheaJS</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">21</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">22</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">23</p></td>
+<td align="left" valign="top"><p class="table">RheaJS</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython2</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">24</p></td>
+<td align="left" valign="top"><p class="table">RheaJS</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython3</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">25</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, 25 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: <a href="https://qpid.apache.org/components/interop-test/index.html">https://qpid.apache.org/components/interop-test/index.html</a></p></div>
+<div class="paragraph"><p>Download soruce: <a href="https://qpid.apache.org/download.html">https://qpid.apache.org/download.html</a></p></div>
+<div class="paragraph"><p>Git: <a href="https://github.com/apache/qpid-interop-test.git">https://github.com/apache/qpid-interop-test.git</a></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-c++, cmake, maven, json-cpp
+</p>
+</li>
+<li>
+<p>
+Qpid Proton: qpid-proton-cpp-devel, python2-qpid-proton, python3-qpid-proton
+</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_interop_test">c. 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 -DCMAKE_INSTALL_PREFIX=<path/to/local/install/dir> ..
+ $ 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 by default 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">‘--timeout’</p></td>
+<td align="left" valign="top"><p class="table">Timeout for the test in seconds (default: 10 seconds, may vary with test). If the
+ test does not complete within this time, it will be terminated and marked as a
+ failure.</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>
+<tr>
+<td align="left" valign="top"><p class="table"><code>--xunit-log</code></p></td>
+<td align="left" valign="top"><p class="table">Enable the generation of xUnit log files at the conclusion of the tests.</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table"></p></td>
+<td align="left" valign="top"><p class="table"><code>--xunit-log-dir</code></p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">Path where xUnit log files are written.</p></td>
+<td align="left" valign="top"><p class="table"><code>--description</code></p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">Description of test used in xUnit log file.</p></td>
+<td align="left" valign="top"><p class="table"><code>--broker-topology</code></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-complex-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 complex 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 complex 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>
+<tr>
+<td align="left" valign="top"><p class="table"><code>--include-subtype</code></p></td>
+<td align="left" valign="top"><p class="table">Name of AMQP subtype to include. This is the AMQP type used within a primary complex
+ type (for example, the types used within an AMQP list). Cannot be used together with
+ <code>--exclude-subtype</code>. May be used multiple times to include more than one subtype.
+ NOTE: There is a special <code>*</code> wildcard that can be used for this, and will allow
+ all valid types to be used together in the same test.</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table"><code>--exclude-subtype</code></p></td>
+<td align="left" valign="top"><p class="table">Name of AMQP subtype to exclude. Cannot be used together with
+ <code>--include-subtype</code>. May be used multiple times to exclude more than one subtype.</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. 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 5. 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 6. 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 text log files. However, by using the <code>--xunit-log</code> command-line option, xunit log files
+will be generated at the conclusion of the test in the <code>xunit_logs</code> directory. The directory may be changed by
+using the <code>--xunit-log-dir</code> command-line option. Log file management is the responsibility of the user, and if
+xunit logging is used regularly, these files will accumulate, possibly exhausting the available disk space. NOTE
+that if a test is interrupted (by using ctl+c, for example), then the log files will not be generated.)</p></div>
+</div>
+</div>
---------------------------------------------------------------------
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: Update for qpid-interop-test-0.2.0 web
pages on the Qpid web site
Posted by kp...@apache.org.
Update for qpid-interop-test-0.2.0 web pages on the Qpid web site
Project: http://git-wip-us.apache.org/repos/asf/qpid-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/qpid-site/commit/e601a53f
Tree: http://git-wip-us.apache.org/repos/asf/qpid-site/tree/e601a53f
Diff: http://git-wip-us.apache.org/repos/asf/qpid-site/diff/e601a53f
Branch: refs/heads/asf-site
Commit: e601a53fbb4fb774bbbea708c7c89051b22805e4
Parents: d947871
Author: Kim van der Riet <kv...@localhost.localdomain>
Authored: Fri Sep 7 15:51:10 2018 -0400
Committer: Kim van der Riet <kv...@localhost.localdomain>
Committed: Fri Sep 7 15:51:10 2018 -0400
----------------------------------------------------------------------
content/components/interop-test/index.html | 6 +-
content/dashboard.html | 2 +-
content/documentation.html | 4 +-
content/download.html | 6 +-
content/releases/index.html | 3 +-
.../releases/qpid-interop-test-0.1.0/index.html | 2 +-
.../qpid-interop-test-0.2.0/QUICKSTART.html | 567 +++++++++++++++
.../releases/qpid-interop-test-0.2.0/index.html | 201 ++++++
.../qpid-interop-test-0.2.0/release-notes.html | 186 +++++
.../qpid-interop-test-0.2.0/users-guide.html | 684 +++++++++++++++++++
input/_transom_config.py | 2 +-
input/releases/index.md | 3 +-
.../qpid-interop-test-0.2.0/QUICKSTART.md | 370 ++++++++++
input/releases/qpid-interop-test-0.2.0/index.md | 61 ++
.../qpid-interop-test-0.2.0/release-notes.md | 56 ++
.../qpid-interop-test-0.2.0/users-guide.html.in | 540 +++++++++++++++
16 files changed, 2680 insertions(+), 13 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/e601a53f/content/components/interop-test/index.html
----------------------------------------------------------------------
diff --git a/content/components/interop-test/index.html b/content/components/interop-test/index.html
index 97b90a0..7c1a3b8 100644
--- a/content/components/interop-test/index.html
+++ b/content/components/interop-test/index.html
@@ -245,8 +245,8 @@ changed to any valid IP address and port.</p>
<div class="two-column">
<ul>
-<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="/releases/qpid-interop-test-0.2.0/QUICKSTART.html">Quickstart guide</a></li>
+<li><a href="/releases/qpid-interop-test-0.2.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>
@@ -261,7 +261,7 @@ changed to any valid IP address and port.</p>
<h2 id="releases">Releases</h2>
<ul>
-<li><a href="/releases/qpid-interop-test-0.1.0">Qpid Interop Test 0.1.0</a> </li>
+<li><a href="/releases/qpid-interop-test-0.2.0">Qpid Interop Test 0.2.0</a> </li>
<li><a href="/releases/index.html#past-releases">Past releases</a></li>
</ul>
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/e601a53f/content/dashboard.html
----------------------------------------------------------------------
diff --git a/content/dashboard.html b/content/dashboard.html
index 1cfda23..9f129cc 100644
--- a/content/dashboard.html
+++ b/content/dashboard.html
@@ -162,7 +162,7 @@ https://github.com/apache/qpid-proton/blob/go1{/dir}/{file}#L{line}"/>
</tr>
<tr>
<td><a href="/components/interop-test/index.html">Qpid Interop Test</a></td>
- <td><a href="/releases/qpid-interop-test-0.1.0">0.1.0</a></td>
+ <td><a href="/releases/qpid-interop-test-0.2.0">0.2.0</a></td>
<td><a href="https://issues.apache.org/jira/projects/QPIDIT">Summary</a> • <a href="https://issues.apache.org/jira/issues/?jql=project+%3D+QPIDIT+and+resolution+is+null">Open issues</a> • <a href="https://issues.apache.org/jira/issues/?jql=project+%3D+QPIDIT">All issues</a> • <a href="https://issues.apache.org/jira/secure/CreateIssue!default.jspa?pid=12318621">Create issue</a></td>
<td>-</td>
<td><a href="https://git-wip-us.apache.org/repos/asf/qpid-interop-test.git">Git</a> • <a href="https://github.com/apache/qpid-interop-test">GitHub</a></td>
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/e601a53f/content/documentation.html
----------------------------------------------------------------------
diff --git a/content/documentation.html b/content/documentation.html
index bec0f72..e3aca0c 100644
--- a/content/documentation.html
+++ b/content/documentation.html
@@ -222,8 +222,8 @@ You can find older versions with our
<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="/releases/qpid-interop-test-0.2.0/QUICKSTART.html">Quickstart guide</a></li>
+<li><a href="/releases/qpid-interop-test-0.2.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>
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/e601a53f/content/download.html
----------------------------------------------------------------------
diff --git a/content/download.html b/content/download.html
index 7b56ba2..a6fd27a 100644
--- a/content/download.html
+++ b/content/download.html
@@ -219,9 +219,9 @@ https://github.com/apache/qpid-proton/blob/go1{/dir}/{file}#L{line}"/>
<tbody>
<tr>
<td><a href="/components/interop-test/index.html">Qpid Interop Test</a></td>
- <td>0.1.0</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">Source</a> (<a href="https://www.apache.org/dist/qpid/interop-test/0.1.0/qpid-interop-test-0.1.0.tar.gz.asc">ASC</a>, <a href="https://www.apache.org/dist/qpid/interop-test/0.1.0/qpid-interop-test-0.1.0.tar.gz.sha512">SHA512</a>)</td>
- <td><a href="/releases/qpid-interop-test-0.1.0/index.html">Release Page</a></td>
+ <td>0.2.0</td>
+ <td><a href="http://www.apache.org/dyn/closer.lua/qpid/interop-test/0.2.0/qpid-interop-test-0.2.0.tar.gz">Source</a> (<a href="https://www.apache.org/dist/qpid/interop-test/0.2.0/qpid-interop-test-0.2.0.tar.gz.asc">ASC</a>, <a href="https://www.apache.org/dist/qpid/interop-test/0.2.0/qpid-interop-test-0.2.0.tar.gz.sha512">SHA512</a>)</td>
+ <td><a href="/releases/qpid-interop-test-0.2.0/index.html">Release Page</a></td>
</tr>
</tbody>
</table>
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/e601a53f/content/releases/index.html
----------------------------------------------------------------------
diff --git a/content/releases/index.html b/content/releases/index.html
index 2feca09..2dbc135 100644
--- a/content/releases/index.html
+++ b/content/releases/index.html
@@ -130,12 +130,12 @@ the
<li><a href="qpid-java-6.1.7/index.html">Qpid for Java 6.1.7</a>, September 2018</li>
<li><a href="qpid-jms-0.36.0/index.html">Qpid JMS 0.36.0</a>, August 2018</li>
<li><a href="qpid-jms-amqp-0-x-6.3.3/index.html">Qpid JMS AMQP 0-x 6.3.3</a>, August 2018</li>
+<li><a href="qpid-interop-test-0.2.0/index.html">Qpid Interop-test 0.2.0</a>, August 2018</li>
<li><a href="qpid-proton-j-0.29.0/index.html">Qpid Proton-J 0.29.0</a>, August 2018</li>
<li><a href="qpid-dispatch-1.3.0/index.html">Qpid Dispatch 1.3.0</a>, July 2018</li>
<li><a href="qpid-broker-j-7.0.6/index.html">Qpid Broker-J 7.0.6</a>, June 2018</li>
<li><a href="qpid-cpp-1.38.0/index.html">Qpid C++ 1.38.0</a>, March 2018</li>
<li><a href="qpid-python-1.37.0/index.html">Qpid Python 1.37.0</a>, November 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>
@@ -186,6 +186,7 @@ the
<li><a href="qpid-proton-j-0.24.0/index.html">Qpid Proton-J 0.24.0</a>, December 2017</li>
<li><a href="qpid-jms-0.27.0/index.html">Qpid JMS 0.27.0</a>, November 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-interop-test-0.1.0/index.html">Qpid Interop-test 0.1.0</a>, November 2017</li>
<li><a href="qpid-proton-0.18.0/index.html">Qpid Proton 0.18.0</a>, October 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-jms-0.26.0/index.html">Qpid JMS 0.26.0</a>, October 2017</li>
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/e601a53f/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
index d105612..e721777 100644
--- a/content/releases/qpid-interop-test-0.1.0/index.html
+++ b/content/releases/qpid-interop-test-0.1.0/index.html
@@ -166,7 +166,7 @@ the files you download.</p>
<script type="text/javascript">
_deferredFunctions.push(function() {
- if ("0.1.0" === "0.1.0") {
+ if ("0.1.0" === "0.2.0") {
_modifyCurrentReleaseLinks();
}
});
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/e601a53f/content/releases/qpid-interop-test-0.2.0/QUICKSTART.html
----------------------------------------------------------------------
diff --git a/content/releases/qpid-interop-test-0.2.0/QUICKSTART.html b/content/releases/qpid-interop-test-0.2.0/QUICKSTART.html
new file mode 100644
index 0000000..2363ce4
--- /dev/null
+++ b/content/releases/qpid-interop-test-0.2.0/QUICKSTART.html
@@ -0,0 +1,567 @@
+<!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.2.0/index.html">Qpid Interop Test 0.2.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>
+
+<h2 id="1-overview">1. Overview</h2>
+
+<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 <code>/usr/local</code> (and will thus also
+require root privileges), but you can set any non-privileged directory as the
+install prefix using the <code>CMAKE_INSTALL_PREFIX</code> environment variable, for
+example <code>$HOME/install</code>.</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>Python 3.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 C++ development</li>
+<li>Qpid Python</li>
+<li>Python2 Qpid Proton</li>
+<li>Python3 Qpid Proton</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>In addition, if you wish to run the tests against a broker on the build machine,
+it will be necessary to have a running broker. One of the following may be
+installed and started against which to run the interop tests as a local broker:</p>
+
+<ul>
+<li>Artemis Java broker</li>
+<li>ActiveMQ Java broker</li>
+<li>Qpid C++ broker</li>
+<li>Qpid Dispatch router (which may be used as a single node, or as part of a
+routed configuration)</li>
+</ul>
+
+<p>Any AMQP 1.0 broker should work. Tests can also be run against a
+remote broker provided the broker IP address is known.</p>
+
+<p>These 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</li>
+<li>Build qpid-interop-test</li>
+<li>Run the tests</li>
+</ol>
+
+<h2 id="2-install-prerequisites">2. Install prerequisites</h2>
+
+<h3 id="21-rhel6">2.1 RHEL6</h3>
+
+<p>Currently <strong>RHEL6 is not supported</strong> 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="22-rhel7">2.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
+yum install epel-release-latest-7.noarch.rpm
+</code></p>
+
+<p>then install the following packages:</p>
+
+<p><code>
+yum -y install jsoncpp-devel nodejs-rhea qpid-proton-cpp-devel python-qpid-proton qpid-proton-cpp-devel python2-qpid-proton
+</code></p>
+
+<h3 id="23-fedora-28">2.3 Fedora 28</h3>
+
+<p>All packages are available directly from the Fedora repositories:</p>
+
+<p><code>
+dnf -y 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 qpid-proton-cpp-devel python2-qpid-proton python3-qpid-proton
+</code></p>
+
+<h3 id="24-centos7-docker-image">2.4 CentOS7 Docker image</h3>
+
+<p>Docker images come with only the bare essentials, so there is more to install than a standard bare-metal install:</p>
+
+<p><code>
+yum -y install vim unzip wget git gcc-c++ make cmake maven swig java-1.8.0-openjdk-devel perl-XML-XPath python-devel procps-ng
+</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
+yum -y install epel-release-latest-7.noarch.rpm
+</code></p>
+
+<p>then install the following packages:</p>
+
+<p><code>
+yum -y install mono-devel python34-devel jsoncpp-devel nodejs-rhea qpid-proton-cpp-devel python-qpid-proton qpid-proton-cpp-devel python2-qpid-proton
+</code></p>
+
+<p>Note that at the time of release, there is no python3-qpid-proton package available for CentOS7, but this should be available soon. Tests should be run with
+the --exclude-shim ProtonPython3 flag to avoid errors.</p>
+
+<h3 id="25-fedora-28-docker-image">2.5 Fedora 28 Docker image</h3>
+
+<p><code>
+dnf -y install vim unzip wget procps-ng git gcc-c++ make cmake maven swig java-1.8.0-openjdk-devel perl-XML-XPath python-devel mono-devel python3-devel jsoncpp-devel nodejs-rhea python-qpid-proton qpid-proton-cpp-devel python2-qpid-proton python3-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 -y install qpid-cpp-server # CentOS7/RHEL
+</code></pre>
+
+<p>or</p>
+
+<pre><code>dnf -y install qpid-cpp-server # Fedora 28
+</code></pre>
+
+<p>and set the configuration file in /etc/qpid/qpidd.conf as follows:</p>
+
+<p><code>
+auth=no
+queue-patterns=qit
+</code></p>
+
+<p>The broker may be started via service, but if running in a Docker container, this may not work. In this case, start the broker directly:</p>
+
+<pre><code>/sbin/qpidd -d
+</code></pre>
+
+<p>and can be stopped with</p>
+
+<pre><code>/sbin/qpidd -q
+</code></pre>
+
+<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>
+
+<p>The broker may be started via service, but if running in a Docker container, this may not work. In this case, start the broker directly:</p>
+
+<pre><code>/sbin/qdrouterd -d
+</code></pre>
+
+<p>and can be stopped with</p>
+
+<pre><code>pkill qdrouterd # Needs procps-ng package installed in Docker containers
+</code></pre>
+
+<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>
+
+<pre><code>git clone https://git-wip-us.apache.org/repos/asf/qpid-interop-test.git
+</code></pre>
+
+<p>or</p>
+
+<pre><code>git clone https://github.com/apache/qpid-interop-test.git
+</code></pre>
+
+<p>Assuming the source tree is located in directory qpid-interop-test:</p>
+
+<p><code>
+cd qpid-interop-test
+git tag -l # See list of tags
+git checkout tags/<tagname> # tagname is the release, for example 0.2.0-rc3
+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_complex_types_test</td>
+ <td>Tests complex AMQP 1.0 types</td>
+ <td>C++ Python2 Python3</td>
+</tr>
+<tr>
+ <td>amqp_large_content_test</td>
+ <td>Tests implementation of large messages up to 10MB</td>
+ <td>C++ Python2 Python3 AMQP.NetLite</td>
+</tr>
+<tr>
+ <td>amqp_types_test</td>
+ <td>Tests the implementation of AMQP 1.0 types</td>
+ <td>C++ Python2 Python3 Rhea AMQP.NetLite</td>
+</tr>
+<tr>
+ <td>jms_hdrs_props_test</td>
+ <td>Tests JMS headers and properties</td>
+ <td>C++ JMS Python2 Python3</td>
+</tr>
+<tr>
+ <td>jms_messages_test</td>
+ <td>Tests all JMS message types (except ObjectMessage)</td>
+ <td>C++ JMS Python2 Python3</td>
+</tr>
+</tbody>
+</table>
+
+<p>Each test has command-line options which can be used to limit or modify the test, use the <code>--help</code> option to see
+these options.</p>
+
+<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>
+
+<p><strong>CentOS7 Note:</strong></p>
+
+<p>CentOS7 does not have the <code>python3-qpid-proton</code> package available at the time of the 0.2.0 release. To avoid
+errors in the test on CentOS7 (which does not yet auto-detect but assumes the availability of this package), use the
+<code>--exclude-shim ProtonPython3</code> command-line parameter to disable this shim. See
+<a href="https://issues.apache.org/jira/browse/QPIDIT-126">QPIDIT-126</a> for progress and further details on this issue.</p>
+
+<h2 id="5-optional-components">5. Optional Components</h2>
+
+<h3 id="51-amqpnet-lite-client">5.1 AMQP.Net Lite Client</h3>
+
+<p>A detailed description of how to install and run the AMQP.Net Lite client on Fedora may be found at Apache
+JIRA <a href="https://issues.apache.org/jira/browse/QPIDIT-105">QPIDIT-105</a>, and can easily be adapted to other
+Linux operating systems. The following packages need to be installed:</p>
+
+<ul>
+<li>Mono</li>
+<li>Pre-compiled AMQP.Net Lite library (available from https://www.nuget.org/api/v2/package/AMQPNetLite/)</li>
+</ul>
+
+<p>See the above JIRA for detailed instructions. Here is a summary:</p>
+
+<p>Download/install the Amqp.Net Lite dlls. They are initially zipped, unzip them into a well-known location.
+Make sure you can find the path to the required .dll file for the version you are using, for example:</p>
+
+<p><code>
+/abs/path/to/amqp.netlite/lib/net45
+</code></p>
+
+<p>When building qpid-interop-test (section 3 above), add the following environment variable to the cmake parameters:
+<code>-DAMQPNETLITE_LIB_DIR=<abs/path/to/amqp.netlite/lib/net45></code>. When cmake completes, look for the following:</p>
+
+<p><code>
+-- BUILD_AMQPNETLITE = ON
+</code></p>
+
+<p>which shows that the dll was found and the .netlite tests will be enabled. If you see the following,
+then the required dll was not found:</p>
+
+<p><code>
+-- BUILD_AMQPNETLITE = OFF
+</code>
+The messages immediately preceding this will give a clue as to why it was not found, one of <code>AMQPNETLITE_LIB_DIR</code>
+not defined or <code>Amqp.Net.dll</code> was not found in the path.</p>
+
+<h3 id="52-rhea-javascript-client">5.2 Rhea JavaScript Client</h3>
+
+<p>The following packages need to be installed:</p>
+
+<ul>
+<li>nodejs</li>
+<li>npm</li>
+</ul>
+
+<p>The Rhea source may be cloned from github:</p>
+
+<pre><code>git clone https://github.com/amqp/rhea.git
+</code></pre>
+
+<p>If the <code>rhea</code> directory is discovered when qpid-interop-test runs <code>cmake</code>, then the Rhea client tests
+will be enabled. If the directory is not found, it may be set through the <code>RHEA_DIR</code> variable
+when running <code>cmake</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/e601a53f/content/releases/qpid-interop-test-0.2.0/index.html
----------------------------------------------------------------------
diff --git a/content/releases/qpid-interop-test-0.2.0/index.html b/content/releases/qpid-interop-test-0.2.0/index.html
new file mode 100644
index 0000000..a056fb2
--- /dev/null
+++ b/content/releases/qpid-interop-test-0.2.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.2.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.2.0</li></ul>
+
+ <div id="-middle-content">
+ <h1 id="qpid-interop-test-020">Qpid Interop Test 0.2.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.2.0/qpid-interop-test-0.2.0.tar.gz">qpid-interop-test-0.2.0.tar.gz</a></td>
+ <td><a href="https://archive.apache.org/dist/qpid/interop-test/0.2.0/qpid-interop-test-0.2.0.tar.gz.asc">ASC</a>, <a href="https://archive.apache.org/dist/qpid/interop-test/0.2.0/qpid-interop-test-0.2.0.tar.gz.sha512">SHA512</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.2.0">All release artefacts</a></li>
+<li><a href="https://issues.apache.org/jira/issues/?jql=project+%3D+QPIDIT+AND+fixVersion+%3D+%270.2.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.2.0">Source repository tag</a></li>
+</ul>
+
+<script type="text/javascript">
+ _deferredFunctions.push(function() {
+ if ("0.2.0" === "0.2.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/e601a53f/content/releases/qpid-interop-test-0.2.0/release-notes.html
----------------------------------------------------------------------
diff --git a/content/releases/qpid-interop-test-0.2.0/release-notes.html b/content/releases/qpid-interop-test-0.2.0/release-notes.html
new file mode 100644
index 0000000..520e5ef
--- /dev/null
+++ b/content/releases/qpid-interop-test-0.2.0/release-notes.html
@@ -0,0 +1,186 @@
+<!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.2.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.2.0/index.html">Qpid Interop Test 0.2.0</a></li><li>Qpid Interop Test 0.2.0 Release Notes</li></ul>
+
+ <div id="-middle-content">
+ <h1 id="qpid-interop-test-020-release-notes">Qpid Interop Test 0.2.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-65">QPIDIT-65</a> - Add command-line controls to JMS_hdrs_props_test to control test more precisely</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-93">QPIDIT-93</a> - Optionally produce xUnit XML report with test results</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-109">QPIDIT-109</a> - Add ability to run Proton Python shims under Python 3</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-110">QPIDIT-110</a> - Add check for failure of Sender shim, if so, kill Receiver shim</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-112">QPIDIT-112</a> - Change test queue prefix from "jms.queue.qpid_interop" to "qit"</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-115">QPIDIT-115</a> - Print both stderr and stdout output when stderr output is detected on a shim</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-127">QPIDIT-127</a> - update to use the current v19 apache parent pom</li>
+</ul>
+
+<h2 id="bugs-fixed">Bugs fixed</h2>
+
+<ul>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-79">QPIDIT-79</a> - Stopping Python tests using ctrl+c sometimes results in a zombie shim</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-85">QPIDIT-85</a> - Tests don't limit the number of times it tries to connect to a broker</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-106">QPIDIT-106</a> - Cmake does not find custom-installed maven</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-113">QPIDIT-113</a> - AMQP.NetLite shims produce error message on stderr which should be ignored</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-114">QPIDIT-114</a> - [AMQP.NetLite] AMQP char type is not supported, but is not excluded from test</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-128">QPIDIT-128</a> - misuse of JAVA_HOME causes tests to error without clear indication why</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-129">QPIDIT-129</a> - tests reference wrong 'shim' version for Qpid JMS</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-130">QPIDIT-130</a> - 'utils' module is versioned incorrectly</li>
+</ul>
+
+<h2 id="tasks">Tasks</h2>
+
+<ul>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-37">QPIDIT-37</a> - Add test timeout to receiver shims so that when not all expected messages are received, the test does not wait indefinitely</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-61">QPIDIT-61</a> - Condense common code from the Python tests into a test module.</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-107">QPIDIT-107</a> - Add support for JMS message properties in ProtonCpp shim</li>
+<li><a href="https://issues.apache.org/jira/browse/QPIDIT-119">QPIDIT-119</a> - Add AMQP complex type 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/e601a53f/content/releases/qpid-interop-test-0.2.0/users-guide.html
----------------------------------------------------------------------
diff --git a/content/releases/qpid-interop-test-0.2.0/users-guide.html b/content/releases/qpid-interop-test-0.2.0/users-guide.html
new file mode 100644
index 0000000..f000b02
--- /dev/null
+++ b/content/releases/qpid-interop-test-0.2.0/users-guide.html
@@ -0,0 +1,684 @@
+<!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.2.0/index.html">Qpid Interop Test 0.2.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
+* ProtonPython2
+* ProtonPython3
+* 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">ProtonPython2</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">ProtonPython3</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">5</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">6</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">7</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">8</p></td>
+<td align="left" valign="top"><p class="table">ProtonCpp</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython2</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">9</p></td>
+<td align="left" valign="top"><p class="table">ProtonCpp</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython3</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">10</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">11</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython2</p></td>
+<td align="left" valign="top"><p class="table">AmqpNetLite</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">12</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython2</p></td>
+<td align="left" valign="top"><p class="table">ProtonCpp</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">13</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython2</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython2</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">14</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython2</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython3</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">15</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython2</p></td>
+<td align="left" valign="top"><p class="table">RheaJS</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">16</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython3</p></td>
+<td align="left" valign="top"><p class="table">AmqpNetLite</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">17</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython3</p></td>
+<td align="left" valign="top"><p class="table">ProtonCpp</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">18</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython3</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython2</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">19</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython3</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython3</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">20</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython3</p></td>
+<td align="left" valign="top"><p class="table">RheaJS</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">21</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">22</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">23</p></td>
+<td align="left" valign="top"><p class="table">RheaJS</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython2</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">24</p></td>
+<td align="left" valign="top"><p class="table">RheaJS</p></td>
+<td align="left" valign="top"><p class="table">ProtonPython3</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">25</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, 25 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: <a href="https://qpid.apache.org/components/interop-test/index.html">https://qpid.apache.org/components/interop-test/index.html</a></p></div>
+<div class="paragraph"><p>Download soruce: <a href="https://qpid.apache.org/download.html">https://qpid.apache.org/download.html</a></p></div>
+<div class="paragraph"><p>Git: <a href="https://github.com/apache/qpid-interop-test.git">https://github.com/apache/qpid-interop-test.git</a></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-c++, cmake, maven, json-cpp
+</p>
+</li>
+<li>
+<p>
+Qpid Proton: qpid-proton-cpp-devel, python2-qpid-proton, python3-qpid-proton
+</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_interop_test">c. 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 -DCMAKE_INSTALL_PREFIX=<path/to/local/install/dir> ..
+ $ 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 by default 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">‘--timeout’</p></td>
+<td align="left" valign="top"><p class="table">Timeout for the test in seconds (default: 10 seconds, may vary with test). If the
+ test does not complete within this time, it will be terminated and marked as a
+ failure.</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>
+<tr>
+<td align="left" valign="top"><p class="table"><code>--xunit-log</code></p></td>
+<td align="left" valign="top"><p class="table">Enable the generation of xUnit log files at the conclusion of the tests.</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table"></p></td>
+<td align="left" valign="top"><p class="table"><code>--xunit-log-dir</code></p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">Path where xUnit log files are written.</p></td>
+<td align="left" valign="top"><p class="table"><code>--description</code></p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">Description of test used in xUnit log file.</p></td>
+<td align="left" valign="top"><p class="table"><code>--broker-topology</code></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-complex-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 complex 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 complex 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>
+<tr>
+<td align="left" valign="top"><p class="table"><code>--include-subtype</code></p></td>
+<td align="left" valign="top"><p class="table">Name of AMQP subtype to include. This is the AMQP type used within a primary complex
+ type (for example, the types used within an AMQP list). Cannot be used together with
+ <code>--exclude-subtype</code>. May be used multiple times to include more than one subtype.
+ NOTE: There is a special <code>*</code> wildcard that can be used for this, and will allow
+ all valid types to be used together in the same test.</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table"><code>--exclude-subtype</code></p></td>
+<td align="left" valign="top"><p class="table">Name of AMQP subtype to exclude. Cannot be used together with
+ <code>--include-subtype</code>. May be used multiple times to exclude more than one subtype.</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. 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 5. 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 6. 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 text log files. However, by using the <code>--xunit-log</code> command-line option, xunit log files
+will be generated at the conclusion of the test in the <code>xunit_logs</code> directory. The directory may be changed by
+using the <code>--xunit-log-dir</code> command-line option. Log file management is the responsibility of the user, and if
+xunit logging is used regularly, these files will accumulate, possibly exhausting the available disk space. NOTE
+that if a test is interrupted (by using ctl+c, for example), then the log files will not be generated.)</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/e601a53f/input/_transom_config.py
----------------------------------------------------------------------
diff --git a/input/_transom_config.py b/input/_transom_config.py
index 357bae3..efab524 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.6")
cpp_release = _Release(site_url, "Qpid C++", "qpid-cpp", "1.38.0")
dispatch_release = _Release(site_url, "Qpid Dispatch", "qpid-dispatch", "1.3.0")
-interop_test_release = _Release(site_url, "Qpid Interop Test", "qpid-interop-test", "0.1.0")
+interop_test_release = _Release(site_url, "Qpid Interop Test", "qpid-interop-test", "0.2.0")
java_release = _Release(site_url, "Qpid for Java", "qpid-java", "6.1.7")
jms_release = _Release(site_url, "Qpid JMS", "qpid-jms", "0.36.0")
jms_amqp_0_x_release = _Release(site_url, "Qpid JMS for AMQP 0-x", "qpid-jms-amqp-0-x", "6.3.3")
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/e601a53f/input/releases/index.md
----------------------------------------------------------------------
diff --git a/input/releases/index.md b/input/releases/index.md
index bfb805e..5fc3865 100644
--- a/input/releases/index.md
+++ b/input/releases/index.md
@@ -31,12 +31,12 @@ the
- [Qpid for Java 6.1.7](qpid-java-6.1.7/index.html), September 2018
- [Qpid JMS 0.36.0](qpid-jms-0.36.0/index.html), August 2018
- [Qpid JMS AMQP 0-x 6.3.3](qpid-jms-amqp-0-x-6.3.3/index.html), August 2018
+ - [Qpid Interop-test 0.2.0](qpid-interop-test-0.2.0/index.html), August 2018
- [Qpid Proton-J 0.29.0](qpid-proton-j-0.29.0/index.html), August 2018
- [Qpid Dispatch 1.3.0](qpid-dispatch-1.3.0/index.html), July 2018
- [Qpid Broker-J 7.0.6](qpid-broker-j-7.0.6/index.html), June 2018
- [Qpid C++ 1.38.0](qpid-cpp-1.38.0/index.html), March 2018
- [Qpid Python 1.37.0](qpid-python-1.37.0/index.html), November 2017
- - [Qpid Interop-test 0.1.0](qpid-interop-test-0.1.0/index.html), November 2017
</div>
@@ -84,6 +84,7 @@ the
- [Qpid Proton-J 0.24.0](qpid-proton-j-0.24.0/index.html), December 2017
- [Qpid JMS 0.27.0](qpid-jms-0.27.0/index.html), November 2017
- [Qpid Proton 0.18.1](qpid-proton-0.18.1/index.html), November 2017
+ - [Qpid Interop-test 0.1.0](qpid-interop-test-0.1.0/index.html), November 2017
- [Qpid Proton 0.18.0](qpid-proton-0.18.0/index.html), October 2017
- [Qpid Proton-J 0.23.0](qpid-proton-j-0.23.0/index.html), October 2017
- [Qpid JMS 0.26.0](qpid-jms-0.26.0/index.html), October 2017
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@qpid.apache.org
For additional commands, e-mail: commits-help@qpid.apache.org