com.ibm.streamsx.iot v0.8.0

Overview

Early release for evaluation.

This toolkit is now named com.ibm.streams.iot (since 0.7.0).

Provides Internet of Things (IoT) integration for IBM Streams including connectivity with IBM Watson IoT Platform.
IoT integration includes support for a IoT device model that matches that used by Apache Quarks and IBM Watson IoT Platform.

Requires IBM Streams 4.1

Updates from 0.7.0

Note: *If upgrading from a release earlier than 0.7.0 then please see the release notes for 0.7.0.

Changes from 0.7.0

• Support for encrypted connections (requires a build of the messaging toolkit from its master branch).
• Support for Watson IoT Platform's scalable application model. Optional scaling parameters can be passed that set the number of connections to IoT Platform.
• Remote filtering operators subscribing to device events, commands & statuses. Reduces network traffic by fitlering the events at the publisher, not the subscriber, for example in IotPlatform.
• Improvements to IoTPlatform application
  • Support for encrypted connections (default unencrypted) through optional submission time parameter encrypted
  • Support for IoT Platform's scalable application model. Optional submission time parameters set the number (defaulting to 1) of MQTT connections and Publish operators using parallel regions:
    • scaleEvents - Scaling factor for consuming and publishing device events (default 1).
    • scaleCommands - Scaling factor for consuming and publishing device commands (default 1).
    • scaleStatuses - Scaling factor for consuming and publishing device statuses (default 1).
  • Support for remote filtering.

Installation

Download and unpack the archive streamsx.iot.toolkits-0.8.0.commit_1756881-20160512-0819.tgz into a toolkit directory, I use $HOME/toolkits for toolkits I download from IBMStreams.

cd $HOME/toolkits
tar xzf $HOME/Downloads/streamsx.iot.toolkits-0.8.0.commit_1756881-20160512-0819.tgz.tgz

This toolkit requires these toolkits from IBMStreams, that you also need to download a release for and add to your toolkits directory using the same process as this toolkit.

• com.ibm.streamsx.datetime - https://github.com/IBMStreams/streamsx.datetime/releases/tag/v1.1.1
• com.ibm.streamsx.json - https://github.com/IBMStreams/streamsx.json/releases/tag/v1.1.1
• com.ibm.streamsx.messaging - Included with IBM Streams. If using encrypted connections then you must build a version of this toolkit yourself from the master branch.
• com.ibm.streamsx.topology - https://github.com/IBMStreams/streamsx.topology/releases/tag/v1.3.0

Bluemix Streaming Analytic Service

The SPL application com.ibm.streamsx.iot.watson.apps::IotPlatform that provides the connectivity to IBM Watson IoT Platform is supplied as a Streams application bundle below: com.ibm.streamsx.iot.watson.apps.IotPlatform.sab.

This bundle was built on x86_64 Redhat Linux 6.5 and can be submitted to a Bluemix Streaming Analytic Service instance. It requires three submission time parameters to specific the IBM Watson IoT Platform connectivity.

• org - Organization identifier
• authKey - API key
• authToken - API authorization token

It supports encrypted connections to IoT Platform, though defaults to unencrypted.

SPL application com.ibm.streamsx.iot.sample.quarks::IotfSensors is a companion application to the Apache Quarks sample app IotfSensors. The bundle was compiled as above and works on Bluemix Streaming Analytic Service. IotPlatform must also be submitted.