What´s new
Administration
[MTM-29160] It is now possible to configure sms77 as SMS provider in Settings > Customization in the Administration application.
For details, see Administration > Changing settings in the User guide.
Enterprise Tenant
[MTM-29923] 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, see Enterprise Tenant > Customizing your platform in the User guide.
Cockpit
[MTM-29400] To improve transparency, the display of the timestamp in data point graphs or tables when aggregation is activated has been modified:
- If daily aggregation is selected, the time indication will no longer be shown.
- If hourly aggregation is selected, the minute and second indication will no longer be shown.
- If minutely aggregation is selected, the second indication will no longer be shown.
For details, see Cockpit > Data explorer in the User guide.
OPC UA
The following improvements have been implemented in the OPC UA gateway since 10.5.7.
For details, see Optional services > OPC UA in the User guide.
Extended subscription parameters
[MTM-29065] The subscription parameters have been extended by:
- “queueSize” - number, queueSize > 0, no max value
- “dataChangeTrigger” - string, radio-button with possible values: Status, StatusValue, StatusValueTimestamp
- “discardOldest” - Boolean, radio-buttons with possible labels: Discard oldest, Discard newest - where discard newest will just turn discard oldest into false. Discard oldest is the default.
Easier analysis of issues during the auto-apply procedure
[MTM-29837] The following improvements have been added:
- “c8y_ua_DeviceTypeApplied” event is triggered when a device type is applied to a node server.
- “c8y_ua_DeviceTypeUnapplied” event is triggered when a device type is removed from a node server.
- “c8y_ua_command_GetDeviceTypeApplicationState” operation has been added to query the state of device type applications on servers.
- “c8y_ua_command_TestDeviceTypeMatching” operation has been added to tell if a node (root node) matches and will be applied to a device type or not.
Notification buffer size configuration
[MTM-30338] Notification buffer size is configured in OPC UA client which defines how many monitored item values should be buffered to receive subscription notification data from OPC UA server. Default is 100. Setting this too low could cause buffer overflow error on the client. Setting this too high wastes memory of the client. In order to decide what is a good number, following configurations should be taken into account:
- Subscription reporting rate (aka publish interval)
- Sampling rate of monitored items
Basically, the more data you got in one notification package from the server, the higher number should be set.
Performance improvements
- [MTM-29868] Performance has been improved when using read/write operations.
- [MTM-30343] Enhanced performance for measurements when there is a lot of data.
Documentation
The 10.6.0 documentation contains
- all description enhancements and updates resulting from new features and improvements in the product,
- a variety of documentation changes and fixes to permanently improve the documentation quality and make it clearer.
Moreover, you can find the following major enhancements (new guides or sections or larger rebuilds) in the area of documentation.
Device integration tutorials
In addition to the device guides offered in the Cumulocity IoT Device Partner Portal, we have re-written and added a collection of device integration tutorials which describe in a step-by-step approach how to integrate various demo devices to Cumulocity IoT, see Device integration tutorials.
Moreover, documentation on how to set up and configure a Casa Systems (NetComm) router using the new Cumulocity IoT NetComm Agent package has been added here.
Installation and operations guides
The Installation and operation guides for Cumulocity IoT Core now include all relevant information for the installation and operation of Apama components. In addition, the following guides are now available through the Software AG Empower Portal:
- LWM2M - Installation & operations guide
- SSL Management - Installation & operations guide
- Zementis microservice - Installation & operations guide
Note, that access to these documents on the Empower Portal requires credentials.
Machine learning guide
The former Predictive Analytics offering has been rebranded to Cumulocity IoT Machine Learning. Accordingly, the name of the respective guide has been changed.
Microservice SDK guide
A new Best Practices collection has been added to the Microservice SDK guide, providing recommendations to be considered before developing and deploying microservices on top of Cumulocity IoT.
Release 10.6.0.27
Fixes
| Component | Description | Issue |
|---|---|---|
| Device Management | In the search result page, when users click the Add group link they will now be able to enter a group name and create a group from the listed devices. | MTM-35089 |
| Enterprise tenant | In the Branding tab, the validation of the favicon has been fixed. It is now again possible to upload an .ico file. | MTM-36883 |
| Two-factor authentication | For more clarity, a new warning message has been added for disabled users with TOTP, stating that the user is disabled. | MTM-36710 |
Release 10.6.0.28
Improvement
| Component | Description | Issue |
|---|---|---|
| Loriot LoRa | The "snr" value is now also included in the message posted to the platform through the Loriot LoRa microservice. | MTM-37021 |
Fixes
| Component | Description | Issue |
|---|---|---|
| Web SDK | An issue has been fixed where the login was in English instead of the browser language setting. Language codes are now resolved correctly for the Japanese language. | MTM-37059 |
Release 10.6.0.23
Improvements
| Component | Description | Issue |
|---|---|---|
| Web SDK | A new property "i18Extra" is available for the application options to add custom translations. | MTM-31545 |
Fixes
| Component | Description | Issue |
|---|---|---|
| Administration | In the Inventory tab, a user without relevant permission will no longer see the inventory tree. Moreover, the error message being displayed if a user doesn´t have relevant permissions now shows the correct information. In the Application access tab, a user without relevant permission will no longer be able to edit. | MTM-33393 |
| Cockpit | Copying a dashboard from one device to another will now show the correct source. | MTM-33042 |
| Data Broker | The error message that shows up when a data-broker connector cannot be created now includes details, such as the SSL certificate problem with the destination URL. | MTM-35686 |
| Documentation | Details on the functionality of the smart rule “On measurement threshold create alarm” have been updated in Cockpit > Smart rules collection in the User guide. | MTM-34765 |
| Enterprise Tenant | In the Branding page it is no longer possible to upload a non-supported file format; you can now only upload image files. | MTM-29627 |
| OPC UA | HTTP POST action request body now is UTF-8 encoded. | MTM-34487 |
| REST API | Additional validation has been added to check the occurrence of control characters in messages sent by MQTT. Allowed characters are "\n \t \r". | MTM-34174 |
| Smart rules | On creating or updating a "On measurement threshold create alarm" smart rule, validation of global threshold ranges in the Data Point Library has been added. | MTM-32926 |
| Smart rules | The smart rule “On measurement threshold create alarm” will create an alarm if the configuration is not valid when the rule is executed. | MTM-34500 |
| UI | Changed translation for "Cockpit" in Russian. Added translation for "Cookie" section labels in the branding configuration form. | MTM-33103 |
| Web SDK | Fixed the issue related to the lastDeviceMessage in the SCADA widget which did not display the occurrence of the last communication. Monitoring is now done on the following APIs: /measurements, /events, /operations, /alarms for last communication occurrence. | MTM-33322 |
Release 10.6.0.14/10.6.0.20
Info
Release 10.6.0.20 is a re-build of release 10.6.0.14 created for technical reasons.
Improvements
| Component | Description | Issue |
|---|---|---|
| Various | If the Google geolocation service does not know the WLAN that a smartbox device sends to the Cumulocity IoT platform, it will no longer use the center of Germany as fall back but throw a 404 exception instead. | MTM-33996 |
Fixes
| Component | Description | Issue |
|---|---|---|
| Administration | The support user up until now was not able to change another account's password because the Confirm password dialog would not accept the support user's current password. This issue has been fixed, and now the support user is able to change the password for another account successfully. | MTM-32577 |
| Cockpit | Dashboards will no longer appear as devices in the Sub-assets tab of groups. | MTM-33295 |
| REST API | Real-time notifications for managed object updates will send refreshed data if a device becomes unavailable. | MTM-33401 |
| Two-factor authentication | The activity time for the support user is updated if SMS TFA is used. | MTM-33015 |
Release 10.6.0.13
Fixes
| Component | Description | Issue |
|---|---|---|
| Two-factor authentication | Users with the login mode "OAuth internal" can now log in with a user alias. | MTM-33743 |
Release 10.6.0.12
Fixes
| Component | Description | Issue |
|---|---|---|
| Cockpit | Image icons in the Location tab of a device are now displayed properly. | MTM-32795 |
| Core product | JavaScript event attributes (like onclick, onmouseover) can now also be used in SVG files in SCADA widgets and in the custom code in HTML widgets. | MTM-30767 |
| Security | Resolved incorrect support user elevated rights assignment in the management tenant. | MTM-32527 |
| Web SDK | Binaries uploaded via the Web SDK now have the correct file type. | MTM-29893 |
Release 10.6.0.11
Fixes
| Component | Description | Issue |
|---|---|---|
| Administration | The OpenIT service URL has been changed from sms.openit.de to https://sms.plusserver.com/put.php. | MTM-33053 |
| Data Broker | An issue has been fixed with concurrent activation of multiple data broker connectors. | MTM-31946 |
| Microservices | Resolved the issue that an enterprise tenant could not see the logs from its own instance of a PER_TENANT microservice when the management tenant was the owner. | MTM-32487 |
| SMS microservice | sms-gateway no longer returns an error when the receiptRequest element is not provided in the request. | MTM-32957 |
Release 10.6.0.10
Improvements
| Component | Description | Issue |
|---|---|---|
| Load Balancer | To improve performance and scalability, new ports to connect via MQTT with round-robin scheduling have been added. | MTM-31239 |
| Microservice | Updated libraries with known vulnerabilities to the latest version for the following microservice agents: - vendme-order-agent - sms-gateway - smartgroup-agent - cellid-agent - firware-approval-agent - impact-agent - iodd-agent |
MTM-30820 |
Fixes
| Component | Description | Issue |
|---|---|---|
| Cockpit | The search functionality has been improved. When you click on a device in a search result, the device details will open immediately. | MTM-32742 |
| Core product | All configurable email templates now support the {tenant-domain} placeholder. | MTM-30291 |
| Data Broker | The data broker now automatically retries requests which failed because the destination server closed long-lasting idle connections. This fix reduces the possibility to lose requests via data broker. | MTM-32177 |
| Device Management | Fixed an issue where the Measurements tab in Device Management was only visible on reload. | MTM-32265 |
| Device Management | Values in custom columns in the device list are now displayed in the same way as they are stored in the inventory. | MTM-32290 |
| Device Management | Device protocol page can now display more than 100 device protocols. | MTM-29385 |
| Enterprise Tenant | The branding option for changing hover-color now works correctly. | MTM-31628 |
| LWM2M | The LWM2M object details page now displays the correct content when navigating between instances of the same object. | MTM-32220 |
| MQTT | To improve performance, the MQTT queue limit for a tenant is now calculated based on the number of tenants, not based on the number of connected devices. | MTM-31468 |
| Realtime | When a user is logged in via SSO, the access to the /cep/notification endpoint is no longer prevented. | MTM-31094 |
| REST API | Excel report files are no longer empty when using the "time" parameter in the export. The Excel file now shows the correct data. | MTM-31620 |
| Single sign-on | Firmware binary files can now be downloaded without issues when a user is logged in via SSO. | MTM-32121 |
Release 10.6.0.6
Improvements
| Component | Description | Issue |
|---|---|---|
| LWM2M | The cluster config can now be adjusted in the agents property file to either use multicast or a set of static node IPs. | MTM-31298 |
| Sigfox | Sigfox device registration form: Hex string validation added to ID and PAC input fields. | MTM-30217 |
| Sigfox | On device registration, only active contracts with free slots will now be shown. | MTM-30220 |
Fixes
| Component | Description | Issue |
|---|---|---|
| Administration | Adding or updating an inventory role now takes the user back to the Inventory roles tab while adding or updating a global role takes the user back to the Global roles tab. | MTM-31422 |
| CEP (Esper) | The alarm creation in the management context has been changed. If an error occurs, an alarm is now sent to the application owner and the tenant subscribed to the microservice. | MTM-31155 |
| Enterprise Tenant | Issue has been resolved where in some circumstances active tenants could be denied access to a microservice. | MTM-31749 |
| UI | Max number of chars validation of the Name field for global and inventory roles in the UI is now aligned with the BE validation. | MTM-30896 |
Release 10.6.0.3
Improvements
| Component | Description | Issue |
|---|---|---|
| OPC UA | The opcua-device-gateway docker tar file no longer contains multiple docker images. | MTM-31452 |
| UI | The tabs implementation has been changed in a way that it allows to create horizontal tabs in an application that had defined vertical tabs in the manifest options and vice versa. | MTM-31308 |
Fixes
| Component | Description | Issue |
|---|---|---|
| Cockpit | The Sub-assets tab no longer shows smart rules as devices. | MTM-31102 |
| Device Management | The position of a device, submitted in the Location tab, is now saved as floating point number instead of string. | MTM-30313 |
| Device Management | The password tooltip for the device credentials has been changed to “Password must have at least 8 characters and no more than 32 and can only contain letters, numbers and the following symbols: `~!@#$%^&*()?;:\'",.<>{}[]\\/”. | MTM-29790 |
Release 10.6.0.2
Improvements
| Component | Description | Issue |
|---|---|---|
| Administration | It is now possible to configure sms77 as SMS provider in the Administration application. For details, see Administration > Changing settings in the User guide. | MTM-29160 |
| Administration | To improve security, password reset emails may no longer be sent to arbitrary email addresses but only to email addresses which are linked to an existing account. | MTM-30212 |
| Cockpit | To improve transparency, the display of the timestamp in data point graphs or tables when aggregation is activated has been modified. For details, see Cockpit > Data explorer in the User guide. | MTM-29400 | Cockpit | A new reporting agent microservice has been implemented to allow scheduled reports with Apama Streaming Analytics. Previously existing configurations of schedulers may automatically be migrated to the new agent via the UI. After the migration is complete, the new UI allows the creation of schedules using the new report agent microservice. | MTM-28500 |
| Enterprise Tenant | A cookie banner has been added to the Cumulocity IoT platform which can be configured via the application options or via UI from the Branding page in the Administration application. For details, see Enterprise Tenant > Customizing your platform in the User guide. | MTM-29923 |
| Enterprise Tenant | The licences generated for a domain are now also valid for subdomains on any level. | MTM-30433 |
| OPC UA | The subscription parameters have been extended by "queueSize", "dataChangeTrigger" and "discardOldest". For details, see Optional services > OPC UA in the User guide. | MTM-29065 |
| Security | On password reset, after a configurable number of failed requests subsequent requests will be blocked for a configurable amount of time. Password reset no longer uses an internal technical user. | MTM-27694 |
| 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 no longer alters the overall microservice health status when /health is called by a user. | MTM-31107 |
| Single sign-on | If single sign-on is configured for a tenant, on creating a new user a warning alert is shown that a local user will not be able to log in via single sign-on. On editing a user created via an external authorization server, a warning alert is shown that the user profile, global roles, and application access cannot be edited. | MTM-29754 |
| UI | To improve UI performance, a new parameter "acl.subPage.query.size" has been added to modify the page query size when filtering for events and alarms. | MTM-29964 |
| UI | To improve performance, the number of events displayed in the events widget and in the Events tab has been reduced. | MTM-29798 |
| UI | To improve performance, the number of alarms displayed in the alarms widget and in the Alarms tab has been reduced. | MTM-29645 |
| UI | Two new languages have been added to the Cumulocity IoT UI: Korean, Polish. | MTM-30803 |
Fixes
| Component | Description | Issue |
|---|---|---|
| Administration | Users being managed by OAUTH and an external authorization server will no longer be locked after failed login attempts through basic authentication. | MTM-30144 |
| Administration | The inventory permissions of a user will no longer be cleared when the owner of the user account has been changed. | MTM-28094 |
| Administration | Setting the parameter “supportUrl” to false in the application options will now hide the support link in the User menu. | MTM-28984 |
| CEP (Esper) | If a user wants to save a CEP module with a colon in its name, the module will not be saved and the user will be notified about the issue. | MTM-29292 |
| CEP (Esper) | Japanese characters can be used again in "Name" annotations in Esper-based CEP without any issues. | MTM-31227 |
| Device Management | Accessing any device in the devices list in the Device Management application will no longer increment the “deviceRequestCount”: The application header has been added to requests done via fetch. | MTM-30842 |
| Documentation | Updated postman collection by fixing realtime-related requests where 'advice' property was used incorrectly. Updated links to postman collection in documentation. | MTM-28867 |
| LWM2M | An error in a race condition has been fixed to prevent that operations are executed multiple times. | MTM-30579 |
| Microservices | Microservice billing adjustments to work correctly on a server with non-UTC server timezone. | MTM-30380 |
| Microservices | The microservice script for deploying, packing etc. is now available in the c8y_examples repository. | MTM-30238 |
| Microservices | Subscription no longer fails when there are leftovers from old deployments. | MTM-28066 |
| OPC UA | Regular address space scan will no longer fail if the display name is null. | MTM-30395 |
| UI | Improved UI performance for charts. | MTM-30537 |
| UI | Scaling issues with the title of the Welcome widget in the Cockpit Home screen have been fixed. | MTM-311597 |
| Various | More reliable core failure discovery by load balancer. | MTM-26153 |
| 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.8.0 - 10.5.12.0
Improvements
| Component | Description | Issue |
|---|---|---|
| Administration | The TOTP feature is now available for all tenants. For more info, see Administration > Two-factor authentication in the User guide. | MTM-30016 |
| Administration | A new button has been added to the Archives page to refresh hosted applications. | MTM-29313 |
| Administration | There is a new warning message, when there are no available logs. | MTM-29450 |
| Data broker | Connectors are now suspended immediately after the tenant is disabled. | MTM-29544 |
| Data broker | Data broker queues are now removed if the tenant is deleted or is no longer subscribed to the feature. | MTM-24254 |
| LWM2M | Default COAP thread size has been increased to 50. | MTM-29676 |
| Microservice | Microservice SDK now supports Java 11. | MTM-29302 |
| OPC UA | Performance improvements when using read/write operations. | MTM-29868 |
| OPC UA | Enhanced performance for measurements when there is a lot of data. | MTM-30343 |
| OPC UA | It is now easier to analyze issues during the auto-apply procedure. The following improvements have been added: - "c8y_ua_DeviceTypeApplied" event is triggered when a device type is applied to a node server. - "c8y_ua_DeviceTypeUnapplied" event is triggered when a device type is removed from a node server. - "c8y_ua_command_GetDeviceTypeApplicationState" operation has been added to query the state of device type applications on servers. - "c8y_ua_command_TestDeviceTypeMatching" operation has been added to tell if a node (root node) matches and will be applied to a device type or not. |
MTM-29837 |
| OPC UA | Notification buffer size is configured in OPC UA client which defines how many monitored item values should be buffered to receive subscription notification data from OPC UA server. Default is 100. Setting this too low could cause buffer overflow error on the client. Setting this too high wastes memory of the client. In order to decide what is a good number, following configurations should be taken into account: - Subscription reporting rate (aka publish interval) - Sampling rate of monitored items Basically, the more data you got in one notification package from the server, the higher number should be set. |
MTM-30338 |
| Sigfox/LoRa | The Message ID label in the Device protocols page has been changed to Message type ID. | MTM-29820 |
| UI | Tooltips for domain and tenant name fields have been updated to indicate that using underscore is not recommended. | MTM-29753 |
| UI | The default “pageSize” parameter value has been reduced from 100 to 20 to improve load performance of certain views that display asset hierarchies (for example, the navigator in the Cockpit application or the inventory role assignment page). | MTM-29419 |
| UI | To improve load performance of certain views that display alarms, a severity parameter can now be added to alarm API calls to display only selected severities. | MTM-29646 |
| Various | The Cumulocity IoT platform operates on internal buffers (queues) for data which must be forwarded into other components like DataBroker, MQTT, or CEP. The internal queues are shared among all tenants using the respective feature. By default all such tenants get partitions of the same size. If a tenant processes substantially higher load than the average, then the administrators can now set the size of a queue for a specific tenant as per the tenant’s needs. In that case the total size of that queue will be increased accordingly. |
MTM-29046 |
Fixes
| Component | Description | Issue |
|---|---|---|
| Administration | “Xsfr” error will no longer occur when logging in using basic authentication. | MTM-28982 |
| CEP | Correct self URLs are now returned from CEP endpoints. | MTM-25207 |
| Data broker | Missing translations for the data broker alert messages have been added. | MTM-28383 |
| Device Management | In the Firmware tab, a placeholder has been added to the Version field to better understand how the field must be filled. | MTM-29294 |
| Device Management | The Add firmware and Add software dropdown buttons are now closed by default. | MTM-28097 |
| Documentation | The Java SDK documentation was updated with additional information regarding the “allPages()” method. | MTM-29631 |
| 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 |
| 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 |
| LWM2M | Memory leaks will no longer occur. | MTM-29617 |
| LWM2M | The agent will no longer run out of heap memory so easily during high traffic. The max heap size has been increased. | MTM-29535 |
| LWM2M | Queue flushing now is done safely. If one queue or one element in the queue has failed to flush, other items will still be processed. | MTM-29456 |
| LWM2M | Device protocol type is now properly updating. | MTM-29452 |
| LWM2M | If a write operation has timed out or the device has disconnected, the agent will put the operation back to PENDING instead of failing with an internal error. | MTM-29040 |
| LWM2M | In some cases the platform would send multiple post-registration operations. This issue will no longer occur. | MTM-29509 |
| Microservices | Microservices now run in a correct timezone. | MTM-29453 |
| Microservices | Memory leak fix for the microservice proxy. | MTM-27444 |
| Microservices | “Cellid-agent-server” is now working without any issues. | MTM-29072 |
| Microservices | Typos in microservice scripts (http://resources.cumulocity.com/examples/microservice) have been fixed. | MTM-27949 |
| OPC UA | When a node, which is being read on demand or is being processed based on the device protocol, has an abnormal value due to bad or uncertain status code, an alarm with warning severity is raised for the server device. This alarm is cleared when the node's value is back to normal on the next read. | MTM-28940 |
| REST | Measurements now again accept “null” as a measurement value. | MTM-29203 |
| Sigfox | The error which appeared in the Device protocols page on updating a managed object will no longer occur. | MTM-29858 |
| 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 |
| SMTP | SMTP password is no longer exposed via the API. | MTM-27919 |
| Web SDK | Fixed a problem with the detail$ observable in InventoryService when realtime is turned off. | MTM-29399 |
| UI | Branding images can now be removed from the UI. | MTM-29287 |
| UI | “supportUrl: false” option now works as intended and hides the support link in the User menu. | MTM-28984 |
| UI | The login dialog now correctly shows the field label Tenant ID instead of Tenant on accessing an invalid URL. | MTM-28905 |
| UI | CPU optimizations for the Realtime button functionality. | MTM-30408 |
| UI | Wrong or missing title properties have been corrected. | MTM-30096 |
| UI | The unnecessary horizontal line below the navigator has been removed. | MTM-30092 |
| UI | The data points table is now rendered correctly and all display issues have been fixed. | MTM-28989 |
| Various | The environment variable of a microservice will no longer include the names of all microservices in the installation. | MTM-28589 |
| Various | “md5” and “sha1” checksums are now provided for cumulocity maven artifacts deployed on resources.cumulocity.com. | MTM-28823 |
| Various | Adding certificates will no longer cause an error. | MTM-29230 |
| Various | Fixed an issue in the @c8y/cli build tool that was unnecessarily requesting the tenant on deploy. | MTM-30347 |