User Guide

This guide will illustrate the steps required for configuring an application that uses the new Cloud Connection APIs to publish messages to the Kapua platform.

Cloud Connection Instantiation and Configuration

To create a new Cloud Connection, open the Cloud Connections section of the Web UI:

Create a new Cloud Connection by clicking on the New Connection button and entering a new unique identifier in the Cloud Connection Service PID field. The identifier must be a valid kura.service.pid and, in case of a Kapua Cloud Connection, it must start with the org.eclipse.kura.cloud.CloudService- prefix. A valid identifier can be org.eclipse.kura.cloud.CloudService-KAPUA. As an alternative, it is possible to reconfigure the existing org.eclipse.kura.cloud.CloudService Cloud Connection.

Configure the MQTTDataTrasport service.

Click on the MQTTDataTrasport-KAPUA tab and fill the parameters required for establishing the MQTT connection:

Broker-url
Topic Context Account-Name
Username
Password

Finally, configure the DataService-KAPUA service.

In order to enable automatic connection, set the Connect Auto-on-startup parameter to true

Publisher Instantiation and Configuration

Select to the connection to be used from the list.
Click on the New Pub/Sub button.

Select the type of component to be created, from the Available Publisher/Subscriber factories drop down list, in order to create a Publisher
select the org.eclipse.kura.cloud.publisher.CloudPublisher entry.
Enter an unique kura.service.pid identifier in the New Publisher/Subscriber PID field.
Click Apply, you should see the publisher configuration

Select and configure the newly created publisher instance, and then click Apply

Binding an Application to the Publisher

Select the application instance configuration
Find the configuration entry that represents a Publisher reference.
Click on the Select available targets link and select the desired Publisher instance to bind to.

Click on Apply