NOTEL: we are not making provisions for remote participation. Part of the success for these types of events is the face to face contact.

+

NOTE: we are not making provisions for remote participation. Part of the success for these types of events is the face to face contact.

==Test Code Collection==

==Test Code Collection==

Revision as of 10:43, 13 November 2013

We will be hosting an MQTT Interop Testing Day on Monday, March 17, 2014 in Burlingame, CA. The goal is to have as many different MQTT client and server implementations participate in interoperability testing to validate the implementation of the upcoming OASIS MQTT standard.

The outcome of this day will be a report that shows the products that successfully participated in the interop testing. Hoepfully we will demonstrate the true power of an open standard for the IoT and M2M industry.

Date and Location

Agenda (DRAFT)

2. First round of testing - client product match with a server product

3. Second round - multiple different clients with one server

4. Grand finale - multiple servers bridged together

5. Creating the testing report

6. Conversation and Discovering what cool things other people are doing with MQTT

Schedule

Dec. 1 - Sign-up open

Jan. 15 - Test cases made available

Feb. 1 - First phone call meeting to discuss the testing requirements

March 17 - Testing day

Testing Plans

This is a starting point for a plan for testing.

1) We need tests for both MQTT client libraries and servers. Servers may also act as clients connecting to other servers (called a bridge in Mosquitto/RSMB).

2) The MQTT OASIS specification is nearing a public consultation draft. It will contain normative statements which will be listed, and the various degrees of compliance required categorized as in RFC 2119.

"The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and
"OPTIONAL" in this document are to be interpreted as described in RFC 2119."

3) I propose we take each of the listed normative statements and turn them into one or two test cases, with a link back to the specification. Each statement will apply to either server or client library, some to both. Each test case will test either client library or server and will consist of input sequences along with assertions about the results that should/must be observed.

4) Server tests can be described at the MQTT packet level. I already have some tests which do this - so does Roger. Each of the server tests will be a sequence of MQTT flows into a server, interleaved with the expected MQTT packets out of the server.

5) Because the interfaces used to drive client libraries are all different, the client tests will need to be more abstract. They could also be termed in MQTT packet flows, in this sort of way "make calls to the client library to cause MQTT packet flows foo", "following packet flow bar, make a message available to the application", and so forth. Using these test scenarios, any client library can be tested against any server.

6) Server bridge tests will be similar to client tests - probably a subset as bridges have more limited scope for behaviour in general.

7) On the day, servers would be expected to be configured in a standard way to allow the client tests to work against them. We'll publish that configuration as part of the client tests.

8) We will have at least one Mosquitto instance available for anyone to test against on the day. We expect to have Mosquitto updated to allow OASIS conforming clients to connect.

9) Other aspects, which may not be in the specification directly, that we might like tests for: SSL/TLS connections, High Availability client library support.

Participation

Organizations and individuals that have implemented a 'product' using MQTT client or server are welcome to participate. Each 'product' can send 2 representatives to participate in the testing. Due to space and logistics there will be a limit of 20 products that can participate in the testing day. 'Prduct' = a commercial product, open source project or cloud service.

Participation in the Interop Testing Day will be free to all EclipseCon attendees. If you don't want to attend EclipseCon you might have to pay a nominal fee to pay for the food. We still need to work out these details but we promise it won't have more than $100/participant. Of course everyone should really attend EclipseCon since there will be lots of M2M and IoT sessions.

To register please sign-up using our eventbite site.

NOTE: we are not making provisions for remote participation. Part of the success for these types of events is the face to face contact.