Core platform & devices

What´s new

Administration

Microservice logging

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

Microservice logging

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

Single sign-on

The single sign-on functionality has been further enhanced:

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]

User menu

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:

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:

SNMP device protocol details

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

Component Description Issue
Sigfox The external call which pings the Sigfox API is now skipped for /health calls done by Kubernetes for the liveness/readiness probe. The status of the Sigfox API does no longer alter the overall microservice health status when /health is called by a user. MTM-31107

Fixes

Component Description Issue
Administration Subscription no longer fails when there are leftovers from old deployments. MTM-28066
CEP (Esper) Japanese characters can be used again in "Name" annotations in Esper-based CEP. MTM-31227
Device Management Missing application header has been added for requests done via fetch. MTM-31122
LWM2M An error in a race condition has been fixed to prevent that operations are executed multiple times. MTM-30579
UI Scaling issues with the title of the Welcome widget in the Cockpit Home screen have been fixed. MTM-31159

10.5.7.7

Improvements

Component Description Issue
UI Two new languages have been added to the Cumulocity IoT UI: Korean, Polish. MTM-30803

Fixes

Component Description Issue
Administration Setting the parameter “supportUrl” to false in the application options will now hide the support link in the User menu. MTM-28984
Microservice Microservice billing adjustments to work correctly on a server with non-UTC server timezone. MTM-30380
UI CPU usage for the Realtime button functionality has been optimized. MTM-30733
Web SDK BasicAuth with CORS is now working when using the @c8y/client, as the not allowed x-xsrf-token header is no longer set when using CORS. MTM-30649

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

Area Description Jira ticket
UI Improved UI performance for charts. MTM-30537
OPC UA Regular address space scan will no longer fail if the display name is null. MTM-30395

10.5.7.5

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

Important

An issue has been identified that can lead to excessive RAM usage which finally leads to problems with the Linux OOM-Killer mechanism. Customers deploying and operating their own instance of Cumulocity IoT, are asked to follow the updated instructions on the configuration of memory settings described here:

  • Backend installation > Create the Cumulocity environment file > Important configuration items in the Multi-node installation guide.
  • Operational procedures > Karaf memory considerations in the Operations guide.

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

Area Description Jira ticket
UI The data points table is now rendered correctly and all display issues have been fixed. MTM-28989
Sigfox The creation of the Sigfox “Service Data Advance” callback template is now based on the networkMetadata contract option to avoid creation failure alarms. MTM-30164
LoRa The Actility microservice now reflects the correct routing profiles for the current tenant's Thingpark account for each LoRa device registration request. MTM-30064
Various Issues with high CPU load, when subscriptions of microservices change frequently, introduced in version 10.5.7.1, have been resolved. Tenant usage statistics are now updated three times per day. MTM-30342

10.5.7.3 - 10.5.7.4

Info

Release 10.5.7.1 has implemented an improvement, which allows to calculate more accurate statistics on resource consumption of microservices. Currently, this can lead to high CPU load when subscriptions of microservices change frequently.

We will improve this in one of the following Maintenance releases but the releases 10.5.7.3 and 10.5.7.4 are still affected. We will keep you informed.

As a workaround to limit CPU costs for this calculation we recommend the following configuration change.

On all core nodes, add the following to /etc/cumulocity/cumulocity-core.properties:

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

The preferred way of doing this is to apply the changes to the Chef server environment configuration.

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

Area Description Jira ticket
UI The “supportUrl: false” option now works as intended and hides the support link in the User menu. MTM-28984
UI The unnecessary horizontal line below the navigator has been removed. MTM-30092
LoRa The connectivity plan, selected by a user during device registration, is now properly used for the device creation request to the ThingPark API. MTM-29455
Microservices Memory leak fix for the microservice proxy. MTM-27444
CEP Correct self URLs are now returned from CEP endpoints. MTM-25207
DOC In the Data broker documentation, the warning on the usage of the "All objects" option has been further enhanced. MTM-30058

10.5.7.0 - 10.5.7.2

Info

Release 10.5.7.1 has implemented an improvement, which allows to calculate more accurate statistics on resource consumption of microservices. Currently, this can lead to high CPU load when subscriptions of microservices change frequently.

We will improve this in one of the following Maintenance releases but the release 10.5.7.2 is still affected. We will keep you informed.

As a workaround to limit CPU costs for this calculation we recommend the following configuration change.

On all core nodes, add the following to /etc/cumulocity/cumulocity-core.properties:

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

The preferred way of doing this is to apply the changes to the Chef server environment configuration.

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

Area Description Jira ticket
UI Subgroups are now properly displayed in the navigator if the user has READ access to the nested groups. MTM-27044
UI Tabs in the navigation panel now have the same order across all browsers. MTM-29403
UI An error appears If an SSO user attempts to access an application without having proper permissions. MTM-29191
UI Placeholders in the SCADA widget now display values from the selected device. MTM-29048
UI Fixed issue with applying custom translations to navigator nodes. MTM-29263
UI Branding images can now be removed from the UI. MTM-29287
UI Tenant branding can now be updated without the need to re-upload the images. MTM-29287
Administration Retention rules can now delete records previous to year 1963. MTM-28097
CEP CEP is no longer overloaded due to email send threads not being closed properly. MTM-28301
Web SDK Issues with the tutorial app have been resolved. MTM-29304
Web SDK Fixed a problem with the detail$ observable in InventoryService when realtime is turned off. MTM-29399
REST Measurements now accept “null” as a measurement value. MTM-29203
Various Password reset emails will now be sent faster. MTM-27589
Various Unexpected “NullPointerException” errors will no longer occur when deleting microservices. MTM-28941
Various Logs are no longer flooded when invalid measurements are used on create. MTM-28534
Various Security improvements for kubernetes. MTM-28373
Various SMTP password is no longer exposed via the API. MTM-27919

10.5.2 - 10.5.6

Improvements

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

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

Area Description Jira ticket
UI It is now possible to display more than 100 datapoints in the dropdown menu when creating a “Global smart rule”. MTM-28071
UI Security improvements in various fields to prevent HTML injections. MTM-27139
UI Issues when hitting “Enter” on the title bar of widgets that use the “Target assets or devices” list will no longer occur. MTM-28095
UI Cyclic references in managed objects will no longer occur. MTM-28866
UI Translations of the support user feature are now more consistent. MTM-26513
UI The application switcher now shows all of the subscribed external applications. MTM-28921
UI C8Y tenant no longer freezes from the Cumulocity IoT Sensor App data stream. MTM-27107
Administration “Could not find application by ID” error will no longer appear when editing a user. MTM-27419
Administration Changing a data connector state to “Activating” via REST will no longer leave the connector in “Activating” state. Now the connector resyncs devices and changes the state to “Active”. MTM-29210
Administration Data connector names now have a text limit. MTM-28382
Administration “CellID” usage statistics are now working without any issues. MTM-28564
Administration The issue when uploading a configuration snapshot after deleting an already uploaded file will no longer occur. MTM-28146
Administration The Clear all button in the Alarms page now works as intended. MTM-27141
Cockpit Device reports now show the correct timezone when exported as an Excel file. MTM-27973
Cockpit Reports generation security has been improved. MTM-28350
Cockpit Devices are now loading when assigning devices in the Sub-assets tab. MTM-27419
Device Management Adding Impact resources with an already existing ID will trigger a warning message. MTM-26420
Device Management The Device status section in the Info tab of a device can now be properly configured. MTM-27675
Device Management The sensor smartphone dashboard is now correctly appearing when a smartphone is added. MTM-27958
Device Management Measurements will no longer be lost when setting the interval to “Last minute” in the Measurements tab of a device. MTM-27970
Device Management Graphs in the dashboard page are now showing all series. MTM-27834
Enterprise Edition It is now possible to enable the “Allow creation of subtenants” functionality without any issues. MTM-28038
Data broker Data broker automatic inventory resync is now properly working for active connectors. MTM-28341
Microservices JWT validation will no longer cause microservice access issues. MTM-27679
REST Measurements now accept “null” as a measurement value. MTM-29203
DOC Corrections and improvements in the Web SDK for Angular guide. MTM-29190
DOC Wrong requests in the real-time notifications section of the Reference guide have been fixed. MTM-28845
Various Javascript SDK will no longer break on handshake failure. MTM-28080
Various Oauth group mapping error will no longer occur. MTM-28297
Various Resolved a race condition in Karaf process, which led to an unexpected high CPU consumption. MTM-28093
Various Issues when requesting measurements as CSV with query strings will no longer occur. MTM-27408
Various Issue with sporadic session timeouts in a SSO environment when communicating with microservices has been fixed. MTM-27615
Various Parallel software downloads are no longer causing issues. MTM-28334
Various “ConnectionPoolTimeoutException” no longer occurs from the Java Device SDK. MTM-28003
Various Maximum export limit is now also enforced for CSV exports. MTM-28404
Various Initial requests which start the oAuth2 code flow is now send via HTTPS. MTM-28146

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

Area Description Jira ticket
Administration User registration issues, in which users with similar emails could not be created, are now fixed. MTM-28007
Administration Translations in the Tenant list page are no longer inconsistent. MTM-27731
Administration Users can now use special characters such as “üöäßÜÖÄ” for usernames, aliases and role names without any issues. MTM-27703
UI Download button in the Event list widget is no longer missing when the event has been added via realtime. MTM-23732