com.ibm.streamsx.iot v1.3.0

Changes since version v1.2.0:

• changed the upper version bounds of the dependent toolkits to 99.0.0, so that the upper bounds practically do not apply, #86
• changed the product dependency to 4.3.0 as the dependent JSON toolkit also requires 4.3.0, #86

See also the CHANGELOG of this toolkit.

Pre-build files

There are two pre-build .sab files provided. Please note, that these application bundles are provided for RHEL7 only.

com.ibm.streamsx.iot.watson.apps.IotPlatform.sab

This application needs submission time parameters to be defined. Please enter your "org, authKey, authToken" from your IoT Platform credentials (click "Configure" button) before clicking "Submit" button.
This is the basic application you need for your IoT solution. It is connecting to your IBM Cloud IoT Platform instance and exposes event, cmd, status messages of your devices via publish/subscribe interface (micro-service) to other Streams applications.
This application needs to run if you want other Streams applications to receive messages from your devices.

com.ibm.streamsx.iot.apps.ViewAllDevices.sab

This is a test application which uses publish/subscribe interface to receive message from your devices. You can use it to check if data from your devices reach your Streams applications via the IBM Cloud IoT Platform .
As there are "views" defined you can see the data in the Streams Console.

com.ibm.streamsx.iot v1.2.0

Update 28.05.2019

New pre-built package added (util-sab-files-v4.3-rhel7-x86-64.zip) for usage in IBM Cloud with actual IBM Streams version. As actual created Streaming Analytics services run on RHEL7.x only there is no RHEL6 package provided.

Changes since version v1.1.1:

• change from streamsx.meassaging.mqtt to streamsx.mqtt
• change product dependency to 4.2.0

streamsx.mqtt is a new toolkit including the mqtt functionality of the streamsx.messaging toolkit. The mqtt functionality of the streamsx.messaging toolkit is now deprecated. So one should use the new streamsx.mqtt toolkit which has in version 1.0.0 exactly the same functionality as in the streamsx.messaging toolkit.
You need to download and install streamx.mqtt into your toolkit location to use this new version of streamsx.iot.

This release replaces release v1.1.2. It was seen to change the product dependency has to be changed and this is (as new MQTT toolkit) to be seen as requiring change in 2nd place of version.

Pre-build files

There are two pre-build .sab files provided. Depending on your running IBM Streams installation (in IBM Cloud you can see this in the Price Plan details) you should select the appropriate version (RHEL6.x or RHEL7.x).

com.ibm.streamsx.iot.watson.apps.IotPlatform.sab

This application needs submission time parameters to be defined. Please enter your "org, authKey, authToken" from your IoT Platform credentials (click "Configure" button) before clicking "Submit" button.
This is the basic application you need for your IoT solution. It is connecting to your IBM Cloud IoT Platform instance and exposes event, cmd, status messages of your devices via publish/subscribe interface (micro-service) to other Streams applications.
This application needs to run if you want other Streams applications to receive messages from your devices.

com.ibm.streamsx.iot.apps.ViewAllDevices.sab

This is a test application which uses publish/subscribe interface to receive message from your devices. You can use it to check if data from your devices reach your Streams applications via the IBM Cloud IoT Platform .
As there are "views" defined you can see the data in the Streams Console.

com.ibm.streamsx.iot v1.1.2 - revoked

This version is revoked. Changes in product dependency and adding new toolkit is worth to get 2nd place changed in version. So support of streamsx.mqtt and product dependency of 4.2.0 is now in versions 1.2.x.

Please see version v1.2.0

Changes since version v1.1.1:

• change from streamsx.meassaging.mqtt to streamsx.mqtt

streamsx.mqtt is a new toolkit including the mqtt functionality of the streamsx.messaging toolkit. The mqtt functionality of the streamsx.messaging toolkit is now deprecated. SO one should use the new streamsx.mqtt toolkit which has in version 1.0.0 exactly the same functionality as in the streamsx.messaging toolkit.
You need to download and install streamx.mqtt into your toolkit location to use this new version of streamsx.iot.

com.ibm.streamsx.iot v1.1.1

First a remark to come clean: I recently bumped the version without doing a release.
To catch that error I have to bump the version again for this release to not confuse it
with code that has already been used without a proper release of this toolkit.

Changes since version v1.0.2:

• Incorporation of I18N/NLS resource files
• Change Quarks references to Edgent in documentation
• Enhancements in test code
• Subscribe to JSON commands
• Added error port for JSON parsing errors

com.ibm.streamsx.iot v1.0.2

Overview

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 Edgent and IBM Watson IoT Platform.

Requires IBM Streams 4.1

Updates from 0.8.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.8.0

• Default to encrypted connections to IBM Watson IoT Platform
• Allow the domain for IBM Watson IoT Platform service to be set
• Device commands are sent to IBM Watson IoT Platform at MQTT QoS 2

Installation

Download and unpack the archive streamsx.iot.toolkits-1.0.2.commit_cdc1e1f-20160815-1214.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-1.0.2.commit_cdc1e1f-20160815-1214.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 - https://github.com/IBMStreams/streamsx.messaging/releases/tag/v5.0.0
• com.ibm.streamsx.topology - https://github.com/IBMStreams/streamsx.topology/releases/tag/v1.4.3

Bluemix Streaming Analytic Service

The Streams 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 defaults to encrypted connections to IoT Platform.

Streams application com.ibm.streamsx.iot.watson.apps::IotPlatformBluemix is a variant of IotPlatform for IBM Streams 4.2 that uses an application configuration object to hold the authorization tokens for IoT Platform. This allows easier submission as only the application configuration name is required at job submission time, which can be a memorable name, such as the organization identifier.

Streams application com.ibm.streamsx.iot.apps::ViewAllDevices is a companion application to the IotPlatform that subscribes to all device events, commands and statuses and creates views on them. It may be used as a quick mechanism to see all device related data by creating Streams console table grids against the views created by the application. The bundle was compiled as above and works on Bluemix Streaming Analytic Service. IotPlatform must also be submitted.

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

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.

com.ibm.streamsx.iot v0.7.0

Overview

Early release for evaluation.

This toolkit is now named com.ibm.streams.iot.

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

This is a quick release after the toolkit has been refactored to be a generic IoT toolkit, some manual testing has been performed, but the goal is to have an early release to allow early feedback.

Updates from 0.6.0

This version introduces incompatible changes due to the change in focus of the toolkit to be a generic IoT toolkit that includes support for IBM Watson IoT Platform.

Changes from 0.6.0

• Namespace and package names have been changed to under com.ibm.streamsx.iot. (iotf has been replaced with iot)
• Topic name prefix for publish-subscribe is now streamsx/iot/ (was iotf/).
• IBM Watson IoT Platform code has been separated into namespaces under com.ibm.streamsx.iot.watson.
• IotfOrganization application renamed to IotPlatform (full name com.ibm.streamsx.iot.watson.apps::IotPlatform).
• Parameters for authorization access renamed to be in line with names used by IBM Watson IoT Platform
  • org - Organization identifier (was orgId)
  • authKey - API authorization key (was apiKey)
  • authToken - API authorization token (was apiToken)

Applications that use the recommended subscribe model should only have to change namespace or package names to com.ibm.streamsx.iot.

Installation

Download and unpack the archive streamsx.iot.toolkits-0.7.0.commit_commit_2492b9c-20160426-1602.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.7.0.commit_commit_2492b9c-20160426-1602.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
• com.ibm.streamsx.topology - https://github.com/IBMStreams/streamsx.topology/releases/tag/v1.1.2

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

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.

com.ibm.streamsx.iotf v0.6.0

Overview

Early release for evaluation.

Provides connectivity with IBM Watson IoT Platform for IBM Streams.

Requires IBM Streams 4.1

Updates from 0.4.0

This version introduces an incompatible change due to #20 which ensures attribute names match IBM Watson IoT Platform.

Changes from 0.4.0

• Changed deviceType to typeId to match Watson IoT Platform
• Added initial Java Application API support
• Require IBM Streams 4.1
• Pre-built IotfOrganization application supplied for use in Bluemix Streaming Analytics Service

Installation

Download and unpack the archive streamsx.iotf.toolkits-0.6.0.commit_bdde1ec-20160331-0837.tgz into a toolkit directory, I use $HOME/toolkits for toolkits I download from IBMStreams.

cd $HOME/toolkits
tar xzf $HOME/Downloads/streamsx.iotf.toolkits-0.6.0.commit_bdde1ec-20160331-0837.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
• com.ibm.streamsx.topology - https://github.com/IBMStreams/streamsx.topology/releases/tag/v1.1.2

Bluemix Streaming Analytic Service

The SPL application com.ibm.streamsx.iotf.apps::IotfOrganization that provides the connectivity to IBM Watson IoT Plaform is supplied as a Streams application bundle below: com.ibm.streamsx.iotf.apps.IotfOrganization.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.

• orgId - Organization identifier
• apiKey - API key
• apiToken - API authorization token

SPL application com.ibm.streamsx.iotf.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. IotfOrganization must also be submitted.

com.ibm.streamsx.iotf v0.4.0

Overview

Early release for evaluation.

Provides connectivity with IBM Watson IoT Platform for IBM Streams.

Updates from 0.3.1

Changes from 0.3.1

• Completed publish-subscribe micro-service model
• Operator added to create device command from SPL tuple: CommandTupleToPayload
• Improved SPLDOC
• Samples moved to separate toolkits

Installation

Download and unpack the archive streamsx.iotf.toolkits-0.4.0.commit_6f034d2-20160323-0836.tgz into a toolkit directory, I use $HOME/toolkits for toolkits I download from IBMStreams.

cd $HOME/toolkits
tar xzf $HOME/Downloads/streamsx.iotf.toolkits-0.4.0.commit_6f034d2-20160323-0836.tgz

This toolkit requires three other 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
• com.ibm.streamsx.topology - https://github.com/IBMStreams/streamsx.topology/releases/tag/v1.1.2

com.ibm.streamsx.iotf v0.3.1

Initial release for evaluation.

Provides connectivity with IBM Watson IoT Platform for IBM Streams.

Changes from 0.3.0

• Adds missing extras parameter in IotfSensors