Release notes

Release 10.6

Cumulocity IoT Edge Release 10.6, April 2020, includes the following improvements, fixes and known issues:

Hosting microservices

You can now develop and deploy microservices in Cumulocity IoT Edge. For more information about enabling or disabling the microservice hosting feature, see Enable microservice hosting feature.

This enhancement includes some changes to the monitoring and diagnostic utilities:

Supported microservices

Cumulocity IoT Edge supports all microservices developed for Cumulocity IoT Cloud including the Cumulocity IoT Machine Learning offering.

Support for remote access protocols

Cumulocity IoT Edge now supports the VNC and Telnet protocols to remotely access the Edge VM. See Connecting to the cloud.

Support for OPC UA 2.0

OPC UA 2.0 is now available. For more information, see Optional services > OPC UA in the User guide.

When you upgrade to Cumulocity IoT Edge version 10.6, the OPC UA agent configurations are lost. You must reconfigure all the OPC UA configurations.

Cumulocity IoT DataHub

Cumulocity IoT DataHub is now available in the Cumulocity IoT Edge platform as an integrated application, available from the application switcher. For more information, see Cumulocity IoT DataHub.

Known issues

CIE-852 VMware Workstation Issue: On VMware Workstation, you should use UTC on your host machine. If you choose not to use UTC, you may have time sync issues.

Workaround: Set rtc.diffFromUTC=0 in the .vmx file.
CIE-892 Virtual Box Issue: On Virtual Box, you should use UTC on your host machine. If you choose not to use UTC, you may have time sync issues.

Workaround: Set the VBoxInternal/Devices/mc146818/0/Config/UseUTC key value to 1.
CIE-895 Device Management Issue: In the Device Management application, when you click on a device in the All devices menu, the Measurements tab does not appear in the device information page even if there are measurements on the device.

Workaround: Refresh or reload the browser. If it doesn’t work, replace “device-info” with “measurements” in the URL.
CIE-911 Edge agent registration Issue: After upgrading from Edge version 10.5 to 10.6, you cannot register your Edge agent with Cumulocity tenant as you cannot access the /usr/edge/properties/edge-agent/device-id file. You need the device ID to register your Edge agent with Cumulocity tenant.

Workaround: As a root user, change the ownership of the edge-agent folder using the command:
chown -R edge-agent:edge-agent /usr/edge/properties/edge-agent.

Release 10.5

Cumulocity IoT Edge Release 10.5, November 2019, includes the following improvements, fixes and known issues:

Remote device management

You can now register and manage your Cumulocity IoT Edge VM remotely from your Cumulocity IoT tenant. You must first configure the Edge agent (see Configuring Edge agent) and then register the Edge VM with the Cumulocity IoT tenant (see Registering the Edge device with a Cumulocity IoT tenant).

Support for Microsoft Hyper-V

You can now import and setup your Edge appliance using Microsoft Hyper-V on Windows 10 Pro and Windows 10 Enterprise, version 1809. See Example setup for Hyper-V.

Post installation

A new parameter is added in the config.dat file.
If you are running the post-installation script using the config.dat file, there is a new parameter required in that file called cloud.url. If you do not want to specify a cloud URL, use an empty string as the value. This is relevant for customers who are performing automated runs of the post-installation by specifying an existing file.

Custom rules

After upgrading to Edge version 10.5, you must upload the custom rules from an older installation again. The custom rules are not migrated automatically during the upgrade process.


Known issues

CIE-303 ERROR: Error getting real time notifications: CsvDataError(InvalidFieldData(0, “ “)).
This error is not significant and will be addressed in a future release.
CIE-476 The Cron job that runs the diagnostic utility is not configured automatically after upgrading Cumulocity IoT Edge.
1. Start the Edge VM and log in as admin user
2. Run the command crontab -e and add the following lines:


@reboot sleep 300 && sudo /opt/c8y/utilities/diagnostic-utility/
*/15 * * * * sudo /opt/c8y/utilities/diagnostic-utility/

3. Save the Cron file and restart the Edge VM.



Area Description Ticket
Security The edge image has the updated CentOS.
Apama Analytics Builder Events dropped in simulation mode because of incorrect timestamps being used.
Administration Admin user can now access the MongoDB log location. CIE-128
Administration Admin user can now access the nginx logs at /var/log/nginx. Also, the permission issues for cat and tail commands is now fixed. CIE-130
Administration Admin user can now edit the following files:
  • .properties
  • /usr/share/cumulocity-core-karaf/bin/setenv
  • /usr/share/cumulocity-core-karaf/etc/org.ops4j.pax.logging.cfg



Area Description Ticket
Apama Analytics Builder Simulation mode fails to receive inputs for non-broadcast devices. This issue is now fixed.
Administration c8y linux-agent can now be upgraded from 10.4.0 to 10.4.0 (Fix 1) CIE-3
Administration c8y agent can now be upgraded from 9.8.9 to 10.4.x CIE-4
Administration Resetting the admin password is now made mandatory. CIE-5
Administration Admin user can now edit the /usr/edge/properties/apama/extensions/config/files/ file to configure worker threads. CIE-7
Administration Root user SSH is now disabled. CIE-8

Release 10.4

Cumulocity IoT Edge Release 10.4, April 2019, includes the improvements listed below.

Apama Analytics Builder

Cumulocity IoT Edge now includes Apama Analytics Builder. Analytics Builder provides self-service analytics to the domain experts, allowing web-based drag & drop of streaming analytics applications.

You can access Apama Analytics Builder from the Cumulocity IoT app switcher:

App switcher

See Apama Analytics Builder for Cumulocity IoT for the complete documentation.

Cumulocity IoT platform

Cumulocity IoT Edge 10.4 release is based on the 10.4.0 release of the Cumulocity IoT platform. Therefore all new features in the Administration, Cockpit and Device Management application and related APIs are now also available in Cumulocity IoT Edge.

Specifically new features are:



Device Management


For further details, refer to the Cumulocity IoT platform release notes.

VMWare as main hypervisor

With Cumulocity IoT Edge 10.4 release, VMWare-based hypervisors are the preferred choice for Cumulocity IoT Edge production installations. Detailed changes are:

Edge packaging and installation

Edge installation has been improved as follows: