Create an IoT-Connector (aka. Product)
A Murano IoT-Connector is the virtual representation of the physical hardware and sensors that will send data to the Murano platform.
Table of Contents
To create a new IoT-Connector using the Web UI:
1. Navigate to the Murano 'Home' solution list page
2. Click on "ADD APPLICATION".
Note: you are in the IoT-Connectors templates category, not to be confused with other categories as follow:
- Applications - End-to-end Exosite application which cannot be customized directly. Eg. ExoSense & ExoHome
- IoT-Connectors - Already-Connected devices ready to be claimed.
- Murano Applications - Customized application templates.
You will find several other IoT-Connectors template with various added functionalities. Including:
- IoT-Connector As-a-Service - IoT-Connector As-a-Service designed to be published on the Marketplace under the IoT-Connectors section.
IoT-Connector- IoT-Connector to connect 3rd party APIs as data input.
3. For this example we will search and pick the "Basic IoT-Connector" element.
4. Click on "CREATE IOT-CONNECTOR".
5. Name your IoT-Connector and apply.
6. On Murano Home page, select the IoT-Connector you just created.
You can see the device connectivity subdomain created automatically. The subdomain is the same as the IoT-Connector solution ID. You will need it for connecting your devices and advanced troubleshooting.
7. To copy your IoT-Connector ID go to the top-left portion of the screen, click on the ID button.
$ murano product create <name> --save
This command will return the ID of your new IoT-Connector. It will also save the ID to a local
.murano/config file, so that your project will use this ID in the future.
Configure Your IoT-Connector Manually
If you have already created an IoT-Connector, you can easily configure Murano CLI to use it using
murano init, or you can enable it manually by adding it to the
$ murano config product.id <product-id>
Syncup Your IoT-Connector
Add the IoT-Connector definition to the
specs/resources.yaml file and then upload the changes to Murano:
$ murano syncup
This command sets up all the data aliases in the spec file. You can see them by going to https://www.exosite.io/business/solutions, choosing your IoT-Connector, and then clicking the RESOURCES tab. These are all the different resources that your hardware will use.