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.
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 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.