Release notes

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 device remotely from your Cumulocity tenant. You must first configure the Edge agent (see Configuring Edge agent) and then register the Edge device with the Cumulocity tenant (see Registering the Edge device with a Cumulocity 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: