Cumulocity IoT Edge Release 10.6, April 2020, includes the following improvements, fixes and known issues:
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:
- Diagnostic utility changes:
- The health of the Kubernetes platform components and the hosted microservices have been added to the list of health endpoints monitored by diagnostic monitor.
- Diagnostic data collector collects the logs of the Kubernetes platform components as well as the logs of the hosted microservices. For more information, see Microservices log file locations.
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.
|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.
|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
|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:
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.
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.
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.
- Cumulocity IoT Edge Release 10.5 includes Apama 10.5.0.
- If you are upgrading to Cumulocity IoT Edge version 10.5 from any previous version, note that you must redeploy all of your EPL files. See Apama streaming analytics - New code editor and manager.
|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
3. Save the Cron file and restart the Edge VM.
|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:
|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/analyticsbuilder-workers.properties file to configure worker threads.||CIE-7|
|Administration||Root user SSH is now disabled.||CIE-8|
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:
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:
- Single sign-on with the OAuth2 protocol is now possible, including Azure AD integration. See Administration > Changing settings > Configuring single sign-on in the Users guide for details.
- In addition to the “user name” used to authenticate a user, an administrator can now also specify a “login alias” for a user. This allows to change the displayed name (e.g. after a change of name or email address) without changing the ID (user name). The user can login using the original “user name” or the “login alias”.
- An alarm is now raised when the data broker cannot connect to the cloud or when the queue is full.
- A new button Clear all to clear all alarms at once (after confirmation) has been added.
- Under Device Registration, the most recent pending device registration is shown on top.
- The “Group assignment” widget has been improved: the dropdown menu highlights matching groups and hides groups which do not contain the provided text in their name.
- It is now possible to delete device credentials when removing root devices.
- The event list in the Events tab can now be filtered by manually entering an event type.
- It is now possible to bulk-register devices from an uploaded list of serial numbers.
- Number of unresolved alarms by severity will be shown in alarms overview (also in Cockpit application).
- A new version of the Web SDK has been released, supporting Angular version 7.
- With MQTT, devices can now be updated using JSON.
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:
- In addition to VMware ESXi, VMware Workstation Player is supported.
- VirtualBox support is marked as “non production”.
Edge packaging and installation
Edge installation has been improved as follows:
- The post-installation tool has been updated with more error checks, see Setting up Cumulocity IoT Edge > Configuration.
- The IP address is now easily configurable, see Setting up Cumulocity IoT Edge > Accessing the Cumulocity IoT platform.
- Disk size is now expandable.
- Time synchronization requirements are now documented.
- The email service is now configurable, see Operating Cumulocity IoT Edge > Administration and configuration. This can be used to send “Forgot password” emails and to configure Smart Rules that send emails.