Core platform & devices

What´s new

Administration

Microservice logging

Usability in the Logs tab of subscribed applications has been enhanced.

• It is now possible to directly navigate to the end and the beginning of the logs list. [MTM-27530]
• The Date To field has been removed in order to reduce confusion. Instead, starting from the “dateFrom” date, 2000 logs will be sent. [MTM-29296]
• The date specifying the time range can now be selected from a calendar and the theme can be selected through a toggle. [MTM-26441]
• Moreover, an Auto-refresh button has been added. If enabled, the displayed logs automatically get updated every 10 seconds. [MTM-27531]

For details, see Administration > Managing applications in the User guide.

Single sign-on

The single sign-on functionality has been further enhanced:

• If single sign-on is the only defined login option, the users will not see the Cumulocity IoT login page, but will be redirected to the login window of the external auth provider. Basic authentication cannot be deleted via the Administration UI. It can only be done via the login options API. [MTM-23157]
• A new single logout mechanism is now provided. If configured, the user is redirected to the defined authorization server logout URL after logging out from Cumulocity IoT. For details see Administration > Changing settings > Configuring single sign-on in the User guide. [MTM-23522]
• On creating a new user, a warning message is now displayed stating that a user, which is created locally, will not be able to use the single sign-on functionality. Limitations of local users in the context of single sign-on have been added to the documentation. For details see Administration > Managing users in the User guide. [MTM-29103] TOTP

A new two-factor authentication strategy has been added. You can now also use TOTP (Google authenticator) as authentication method.

For details, see Administration > Two-factor authentication in the User guide.

Tenant ID

Tenant ID information is now included in the dropdown user menu. [MTM-28565]

OPCUA

OPC UA 2.0 is now available. The feature stores data into the Cumulocity IoT database via REST. Additionally, c8y commands are executed to perform various operations on the OPC UA servers. The gateway must be registered as Cumulocity IoT device in a specific tenant and the opcua-device-gateway must run in the users’ environment. In order to use OPC UA, subscription to the “opcua-mgmt-service” microservice is required.

The following functionalities are now available:

• Support for multiple OPC UA servers
  

• Support for browsing and searching of the address space
  

• Addressing OPC UA nodes via URN

• Largely extended support for mapping the OPC UA and Cumulocity IoT information models

For details, see Optional services > OPC UA in the User guide.

SNMP

Support for integration of SNMP-enabled devices has been added to the Cumulocity IoT platform through two new components:

• The mib-parser microservice converts a Managed Information Base (MIB) file to a JSON representation which is then used to create a device protocol.
• The SNMP agent is a stand-alone Java program that communicates with SNMP-enabled device(s) and the Cumulocity IoT platform. It receives SNMP data from the devices, converts the data to Cumulocity IoT-based objects based on the device protocol mapping, persists the data locally, and forwards the data to Cumulocity IoT.

For details, see Optional services > SNMP in the User guide.

Documentation

In addition to all enhancements or changes related to the improvements and fixes of the 10.5.7 release, the following improvements or modifications have been made in the area of documentation.

Versioning

Starting with Cumulocity IoT release 10.5.7, the documentation website now offers the documentation for various versions. Apart from the latest released version (currently 10.5.7) you will additionally see the documentation for all other GA releases in maintenance (currently 10.5.0 and 10.4.6). You may switch between the versions through a dropdown menu.

User guide: Optional services

The Cumulocity IoT Sensor App documentation has been updated and improved, see Optional services > Cumulocity IoT Sensor App.

The webMethods.io Integration documentation has been enhanced, see Optional services > webMethods.io Integration.

A new chapter OPC UA has been added, which describes in detail the functionalities of the new OPC UA device gateway.

A new chapter SNMP has been added, which describes in detail the functionalities of the recently added SNMP agent.

Device SDK guide: Device SDK for C++

The Device SDK for C++ documentation has been updated and improved, see Device SDK for C++ in the Device SDK guide.

Cumulocity IoT Edge

The Cumulocity IoT Edge guide has been updated to include all new features and functionalities related to the Cumulocity IoT Edge 10.5 release from November 2019.

10.5.7.8

Improvements

Fixes

10.5.7.7

Improvements

Fixes

10.5.7.6

Improvements

[Enterprise Tenant] A cookie banner has been added to the Cumulocity IoT platform. The login page will now contain information about cookies and their purpose.

The cookie banner can be configured via the application options or via UI from the Branding page in the Administration application. For details refer to Enterprise Tenant > Customizing your platform in the User guide. [MTM-29923]

Fixes

10.5.7.5

Information for customers deploying and operating their own instance of Cumulocity IoT

Kubernetes Network Plugin

When installing an 10.5.7 environment or when upgrading from 10.5.0 to 10.5.7, specify flannel as the Kubernetes network plugin. See Specify flannel as Kubernetes network plugin in the Multi-node installation guide.

Kubernetes Pod Network CIDR

In order to avoid a conflict with any host network you can define an individual CIDR range for the Kubernetes network plugin. See Kubernetes Pod Network CIDR in the Multi-node installation guide.

Fixes

10.5.7.3 - 10.5.7.4

"concurrency.tenant-usage-flush.core-pool-size" => "1"
"concurrency.tenant-usage-flush.rejected" => "DISCARD"
"concurrency.tenant-usage-flush.queue-size" => "1000"

Improvements

[Administration] The TOTP feature is now available for all tenants. For more details, see Administration > Two-factor authentication in the User guide. [MTM-30016]

[REST] Severity parameter can now be added to alarm API calls. [MTM-29646]

Fixes

10.5.7.0 - 10.5.7.2

"concurrency.tenant-usage-flush.core-pool-size" => "1"
"concurrency.tenant-usage-flush.rejected" => "DISCARD"
"concurrency.tenant-usage-flush.queue-size" => "1000"

Improvements

[UI] Tenant ID information is now included in the dropdown user menu. [MTM-28565]

[Device Management] Pending devices now appear at the top of the list in the Registration page. [MTM-28662]

[Web SDK] The list$ and detail$ observable methods of the @c8y/client are now marked as deprecated and will be removed on the next Private Edition release. [MTM-29468]

Performance improvements for retention rules when removing large numbers of records. [MTM-28302]

It is now allowed to define the SMTP address in environment configuration not only as IP, but also as DNS. [MTM-28002]

Fixes

10.5.2 - 10.5.6

Improvements

[Administration] Usability in the Logs tab of subscribed applications has been enhanced.

• It is now possible to directly navigate to the end and the beginning of the logs list. [MTM-27530]
• The date specifying the time range can now be selected from a calendar and the theme can be selected through a toggle. [MTM-26441]
• Moreover, an Auto-refresh button has been added. If enabled, the displayed logs automatically get updated every 10 seconds. [MTM-27531]

For details, see Administration > Managing applications in the User guide.

[Administration] The single sign-on functionality has been further enhanced. If single sign-on is the only defined login option, the users will not see the Cumulocity IoT login page, but will be redirected to the login window of the external auth provider. Basic authentication cannot be deleted via the Administration UI. It can only be done via the login options API. [MTM-23157]

[Administration] The password section in the subtenant properties tab has been improved. [MTM-28073]

[Administration] Billing mode information has been added to the Properties tab of an application. The two possible billing modes are subscription and resources. For details, see Enterprise Tenant > Managing tenants > Microservice usage in the User guide. [MTM-27677]

[Administration] The option Allow subtenants to edit this tenant option in the Tenant policies page has been replaced with a checkbox. [MTM-28918]

[Administration] Improved error messages when uploading invalid microservices. [MTM-29033]

[Cockpit] On scheduling an export, it is now possible to enter multiple email addresses, separated by a comma. [MTM-27275]

[Web SDK] The Web SDK is now released under the Apache 2.0 license. [MTM-28584]

[CEP] It is now possible to personalize the cep-queue and data-broker-queue buffer size for a particular tenant. This can be done from the management tenant by using the subtenant custom fragments cepServer.queue.limit and data-broker.queue.limit. [MTM-28451]

[Various] It is now possible to define device types by using partial namespace tables. [MTM-29064]

Fixes

10.5.1

Improvements

[Administration] Usability in the Logs tab of subscribed applications has been enhanced. It is now possible to directly navigate to the end and the beginning of the logs list. For details, see Administration > Managing applications in the User guide. [MTM-27530]

[MQTT] The maximum MQTT payload size has been increased to 16k (16184). [MTM-27947]

[Microservices] Oauth support has been added to the C# Microservice SDK. [MTM-24026]

[Sigfox] Deprovision device button has been removed. [MTM-24832]

Fixes