domstorey / mqtt-client-connector

Extend your integration capability with event publish/subscribe over MQTT

mqtt-client-connector

The MQTT connector enables you to extend the capability of IBM Integration Bus (IIB) to connect to an MQTT server. IIB is available free of charge for developers. This repository includes nodes that allow you to publish and subscribe to topics on an MQTT server from a message flow, and a sample to demonstrate this.

##Dependencies Install IBM Integration Bus Developer Edition. Update with V9.0 Fix Pack 1 (after installation, open IBM Installation Manager and click Update).

To avoid having to manually import the projects into the Integration Toolkit, install the EGit client. A specific version of the client is needed, see additional instructions.

##Setup

1. Import the MQTT Client Connector project and its prerequisites. (For instructions on how to download and import the source from GitHub see additional instructions)

• Click "Download ZIP" on the right of this page and import the archive file (selecting all the projects) into your Integration Toolkit workspace.
• Download the Paho Java client v0.1 or download the appropriate v0.1 archive file for your platform from the Eclipse Paho page.

2. Add the nodes to the Integration Toolkit:

• Clean all projects by clicking Project on the menu bar, and selecting Clean....
• In the Package Explorer view, if IIB was not installed in the default location, right-click the MQTTConnector project and select Build Path, followed by Configure Build Path. In the Libraries tab, update the location of jplugin2.jar and connectors.jar to the classes folder of your IIB runtime installation. The default location of the classes folder on Windows is C:\Program Files\IBM\MQSI\9.0.0.0\classes.
• In the Application Development view of the Integration Development perspective, right-click the Independent Resource MQTTNodes and select Start Simulation. The MQTTNodes resource is now accessible to the Integration Toolkit.

3. Install the connector on IIB:

• Export the MQTTConnector and the org.eclipse.paho.client.mqttv3 projects as separate jar files, with the same names as the projects, into your file system's ConnectorRuntimeDirectory, e.g. C:\Connectors\MQTT.
• Ensure you have created a default configuration.
• In the WebSphere MQ Explorer, under integration node IB9NODE, right-click Configurable Services and select *Import .configurableservice to import the mqtt.configurableservice from the MQTTSetupForIIB project. Note, if you do not see a Configurable Services option, ensure your integration node is connected (right-click and select Connect).
• Restart integration node IB9NODE.

Simulation mode provides an environment for testing and debugging flows, and the MQTT nodes are removed if you stop the simulation. If you want the MQTT nodes to behave like built-in nodes, you must export the MQTTNodes project as a user-defined node plug-in to the Integration Toolkit dropins directory:

• Right-click the Independent Resource MQTTNodes and select Stop Simulation.
• Right-click MQTTNodes again, select Export > User-defined node plug-in > Next.
• Set the Destination Directory to your dropins directory, eg C:\Program Files (x86)\IBM\IntegrationToolkit90\dropins, and click Finish.
• Restart the Integration Toolkit with the -clean option (add "-clean" to the last line of the launcher.bat file, ie @call mb.exe %* -clean). The MQTT nodes appear in the message flow node palette permanently.

##Pull-Requests In order for us to accept pull-request please email [email protected]

##Platforms Tested on Windows 7 Pro N x64 with IIB Developer Edition.

##Copyright and license Copyright 2013 IBM Corp. under the Eclipse Public license.