Edge Upgrade​​​

Edge Software components can be upgraded on a running Edge installation. All the individual components support upgrades. This allows a provisioned edge to be upgraded in place. Upgrades cover 3 different components.

• Ubuntu OS
• ABB Edge Installer
• Security Components

This document covers installing the OS update from the WWW and installing the new Ability components from a local directory on the Edge.

Raspberry Pi

The Raspberry Pi installation provided by Ability will not upgrade at this time because of the method used to create the kernel provided for ARM testing. However, other production ARM installations should be able to follow the same procedure detailed below to upgrade.

Upgrade Verification

• All upgrade testing should be validated before upgrading any production Edge Installations.
• On April 30, 2023, Ubuntu Linux 18.04 LTS's hardware and maintenance will no longer be supported.

Supported Upgrades

The Ability Edge Installer and Security components are expected to easily upgrade all current installations of Edge using Security components with a version of 2.0.x or greater. The install process will keep current configurations during the upgrade. If an older version of the Security components are installed, contact CST for an upgrade procedure.

Upgrade Steps

1. Obtain the latest software for the planned upgrade.

2. Upgrade to the latest Edge components. Determine the version of the software installed.

Verify Version

This upgrade procedure was tested with TPM2.0 amd64 hardware Edge Security components with version 3.x.x or greater. If an older version of Edge Security is in use, contact CST for assistance.

Execute the following command to get the latest software catalog.

sudo apt update 

TIP

If the docker version is updated, you will be prompted to restart docker services. Select Yes to restart docker. Once the Ubuntu upgrade is complete, Edge software should restart after the docker service is restarted.

Navigate to the local folder on the Edge with all latest components for the running OS and run this command:

sudo apt install ./*.deb

Accept the defaults to install the latest software. The software installation will restart the Edge software. Confirm that everything is working before moving to the next step.

3. When completed, perform the following post isntalls verifications.

Modify the following to match the defaults settings of the latest version of the Edge Installer.

• If rsyslog was not specifically enabled, disable the service.

sudo systemctl disable rsyslog

• Disable docker debug. Edit /etc/docker/daemon.json, set "debug" to false, save the file.

• Wait for 15 minutes and confirm that that squid components are removed.

apt list --installed | grep squid

The above output should not display any squid packages are installed.

• Update the OS software.

sudo apt upgrade -y 

TIP

If the docker version is updated, you will be prompted to restart docker services. Select Yes to restart docker. Once the Ubuntu upgrade is complete, Edge software should restart after the docker service is restarted.

When completed reboot and verify the Edge is still functional. If the current system is not at 20.04, use the next section to update Ubuntu.

Upgrade to Ubuntu 20.04

After the components are upgraded on Ubuntu 18.04, the OS can be upgraded to Ubuntu 20.04 using the following procedure. While this is not required at this time because Ubuntu 18.04 LTS is still supported, migration is recommended.

4. Upgrade to Ubuntu 20.04.

5. Verify the Edge connects to the IOT hub and operates normally.

This completes the upgrade of the Edge.