Difference between revisions of "Cumulocity Configuration"
From Teltonika Networks Wiki
Kristijonasb (talk | contribs) |
|||
(7 intermediate revisions by 4 users not shown) | |||
Line 32: | Line 32: | ||
<ul> | <ul> | ||
<li>Log in to your device's WebUI.</li> | <li>Log in to your device's WebUI.</li> | ||
− | <li><b>Go to | + | <li><b>Go to Services → Package Manager</b> and install Cumulocity.<br>[[File:Networking_rutos_configuration_examples_cumulocity_3.png|border|class=tlt-border]]</li> |
<li></b>Go to Services → Cloud Solutions → Cumulocity</b> and configure it as follows. | <li></b>Go to Services → Cloud Solutions → Cumulocity</b> and configure it as follows. | ||
<ol> | <ol> | ||
<li>Enable Cumulocity</li> | <li>Enable Cumulocity</li> | ||
− | |||
<li>Specify your Cumulocity server's address in the 'Server Address' field.</li> | <li>Specify your Cumulocity server's address in the 'Server Address' field.</li> | ||
<li>Set a connection frequency interval (at least 1 minute).</li> | <li>Set a connection frequency interval (at least 1 minute).</li> | ||
<li>Click 'Save & Apply'.</li> | <li>Click 'Save & Apply'.</li> | ||
− | </ol>[[File: | + | </ol>[[File:Networking_rutos_configuration_examples_cumulocity_4.png|border|class=tlt-border]] |
</li> | </li> | ||
</ul> | </ul> | ||
Line 57: | Line 56: | ||
</ol>[[File:Networking_rutos_configuration_examples_cumulocity_7.png]] | </ol>[[File:Networking_rutos_configuration_examples_cumulocity_7.png]] | ||
</li> | </li> | ||
− | <li>If the device connects successfully, you should see an indication similar to the one below. Click 'Complete' to finish the registration. | + | <li>If the device connects successfully, you should see an indication similar to the one below. Click 'Complete' to finish the registration.</li> |
</ul> | </ul> | ||
+ | <!-- | ||
+ | ==Installing example application== | ||
+ | |||
+ | First, you need to install Cumulocity. Go to System -> Package manager: | ||
+ | |||
+ | [[File:Package manager.jpg]] | ||
+ | |||
+ | When you open package manager you will see a list of packages. You need click install on Cumulocity, see below: | ||
+ | |||
+ | |||
+ | [[File:Screenshot from 2019-11-27 16-00-24.png]] | ||
+ | |||
+ | ==Configuring and launching example application== | ||
+ | After you successfully installed Cumulocity, in „Services“ tab there should be an option called „IoT Platforms“. | ||
+ | |||
+ | [[File:cumiot.png]] | ||
+ | |||
+ | [[File:cumiotwindow.png]] | ||
+ | |||
+ | Only single field is required, which is Server Address. This is the same URL of Cumulocity Cockpit website. In this example, it is myservername.cumulocity.com. | ||
+ | |||
+ | Explanation of other options: | ||
+ | |||
+ | Use SSL/TLS – connection will use TLS, however, you need to have a signed SSL certificate, otherwise application would not be able to connect to the Cumulocity server. | ||
+ | |||
+ | Reset Auth – once device has been removed from the Cumulocity Device Management, you will need to reset authentication in order to re-register device. | ||
+ | |||
+ | Also click „Enable“ to enable example application. See below: | ||
+ | |||
+ | [[File:cumiotvalues.png]] | ||
+ | |||
+ | Now click „Save“ and if everything is correct – example application will successfully connect to the Cumulocity server. | ||
+ | |||
+ | Now you need to register device on Device Management in Cumulocity Cockpit. | ||
+ | |||
+ | Device registration is done by writing down device's serial number. In order to obtain your device's serial number, look at the backplate of it or navigate to your device's control panel and then to „Status → Device“ page: | ||
+ | |||
+ | [[File:cumdevice.png]] | ||
+ | |||
+ | In this case, serial number is 09516845. | ||
+ | |||
+ | Now log into your Cumulocity Cockpit portal, in this example URL is https://myservername.cumulocity.com. | ||
+ | |||
+ | Go to the Device Management page: | ||
+ | |||
+ | [[File:cumcockpit.png]] | ||
+ | |||
+ | [[File:cumdevicemanagement.png]] | ||
+ | |||
+ | Then navigate to Registration page: | ||
+ | |||
+ | [[File:cumdevicepage.png]] | ||
+ | |||
+ | Click „Register device“: | ||
+ | |||
+ | [[File:cumdeviceregister.png]] | ||
+ | |||
+ | Click „General device registration“: | ||
+ | |||
+ | [[File:cumnewdevice.png]] | ||
+ | |||
+ | Write device’s serial number in „Device ID“ field and click „Next“: | ||
+ | |||
+ | [[File:cumdeviceregistration.png]] | ||
+ | |||
+ | As shown below, registration is successful: | ||
+ | |||
+ | [[File:cumsuccessresgister.png]] | ||
+ | |||
+ | Click „Finish“ to close this pop-up. Now if everything is correct, a new device widget should show up with a status „PENDING ACCEPTANCE“: | ||
+ | |||
+ | [[File:cumpendingdevice.png]] | ||
+ | |||
+ | Click „Accept“ button to accept this device. | ||
+ | |||
+ | Now navigate to „All devices“ page: | ||
+ | |||
+ | [[File:cumalldevices.png]] | ||
+ | |||
+ | Here you should be able to see list of all registered devices: | ||
+ | |||
+ | [[File:cumallregistereddevices.png]] | ||
+ | |||
+ | Click on „TLT-RUT955 Router“ name to get into information page: | ||
+ | |||
+ | [[File:cumdeviceinfo.png]] | ||
+ | |||
+ | Notice „Device Data“ widget, it contains information from the router device. By navigating to „Control“ tab, you can restart device by clicking „More → Restart Device“: | ||
+ | |||
+ | [[File:cumdevicecontrol.png]] | ||
+ | |||
+ | You can go back to Cumulocity Cockpit page the same way you entered Device managemant page: | ||
+ | |||
+ | [[File:cumnavigatecockpit.png]] | ||
+ | |||
+ | Then navigate to „Home“ page: | ||
+ | |||
+ | [[File:cumnavigatehome.png]] | ||
+ | |||
+ | And then click „Add widget“: | ||
+ | |||
+ | [[File:cumaddwidget.png]] | ||
+ | |||
+ | Select „Asset properties“ widget and type title, then select „TLT-RUT955 Router“ in „Target Assets or Devices“: | ||
+ | |||
+ | [[File:cumcreatewidget.png]] | ||
+ | |||
+ | To add more information into widget, click „Add property“ and click on „Show“ to add that property. | ||
+ | |||
+ | In example application, these properties are used: | ||
+ | |||
+ | Hardware – Model, Revision, Serial Number | ||
+ | |||
+ | Mobile – Cell ID, Connection Type, Current Operator, ICCID, IMEI and Signal | ||
+ | |||
+ | WAN – IP and Wan Type | ||
+ | |||
+ | Total properties: | ||
+ | |||
+ | [[File:cumtotalprops.png]] | ||
+ | |||
+ | Then click „Save“ and you should be able to see widget with properties you have set: | ||
+ | |||
+ | [[File:cumdevicewidgetinfo.png]] | ||
==Explanation of example application== | ==Explanation of example application== | ||
− | |||
There are two steps when adding new properties: | There are two steps when adding new properties: | ||
Line 227: | Line 349: | ||
For more information about Lua API, download Cumulocity C++ SDK: https://bitbucket.org/m2m/cumulocity-sdk-c/downloads and look up inside „sdk/doc/lua.html“ with a browser. | For more information about Lua API, download Cumulocity C++ SDK: https://bitbucket.org/m2m/cumulocity-sdk-c/downloads and look up inside „sdk/doc/lua.html“ with a browser. | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
==External Links== | ==External Links== | ||
Line 296: | Line 360: | ||
{{Template: trademark disclaimer}} | {{Template: trademark disclaimer}} | ||
--> | --> | ||
− |
Revision as of 07:32, 24 September 2020
Main Page > General Information > Configuration Examples > Third party services > IoT platforms > Cumulocity ConfigurationCumulocity IoT is a cloud-based, real-time IoT management platform that's also compatible with Teltonika-Networks devices.
Introduction
This article contains step-by-step instructions on how to set up a Cumulocity server and register a Teltonika-Networks device on it.
Basic setup
Basic setup consists of:
- Creating a Cumulocity account
- Configuring Cumulocity on a Teltonika-Networks device
- Registering the device on your Cumulocity server
Create an account
First of all, you will need to set up your Cumulocity environment (server).
- Register an account on Cumulocity.
- Wait a few minutes after the registration, open your email account and look for an email with the subject 'Welcome to Cumulocity IoT'. Open it and click 'Login to Cumulocity IoT'.
- Upon a successful login you should be redirected to the Cumulocity Cockpit.
Configure a device
Set up Cumulocity on your Teltonika-Networks device.
- Log in to your device's WebUI.
- Go to Services → Package Manager and install Cumulocity.
- Go to Services → Cloud Solutions → Cumulocity and configure it as follows.
- Enable Cumulocity
- Specify your Cumulocity server's address in the 'Server Address' field.
- Set a connection frequency interval (at least 1 minute).
- Click 'Save & Apply'.
Register a device
Register your Teltonika-Networks device on Cumulocity.
- Find the 'Application switcher' in the top-right corner of the Cumulocity dashboard and go to 'Device management'.
- Then expand the 'Devices' tab in left-hand menu, go to 'Registration' and click 'Register device'.
- Complete the registration.
- Choose 'General device registration'.
- Enter your device's serial number into the 'Device ID' field. The serial number can be found on the device's housing, box or in the WebUI, Status → System page.
- Click 'Next'.
- If the device connects successfully, you should see an indication similar to the one below. Click 'Complete' to finish the registration.