Enea provides regular releases that will require the upgrading of Enea Edge components. The Enea Edge Management application must be upgraded first, followed by upgrading the Enea Edge Runtime on the uCPE devices.

It is recommended to create a system backup by accessing the System menu and selecting System Backup from the Enea Edge Management GUI, for recovery in case of an upgrade failure. Extract the Enea_Edge_Management_<version>-build<build_number>.tar.gz folder. The directory in which the archive has been unpacked will be denoted as <EEMg-installerdir>. Enter <EEMg-installerdir>/dist. Run the following command with the root account and change /opt/ems to the correct location of the Enea Edge Management installation: ./upgrade.sh /opt/ems \ Enea_Edge_Management_<version>-build<build_number>.tar.gz Running this command will: Stop the currently running ucpemanager service. Create a compressed file of the ucpemanager application folder (EneaEdgeManagement-Backup-YYYYddMMHHmm.tar.gz), which contains a snapshot of the existing installation in the <EEMg-installerdir>/dist directory. The snapshot file created during the upgrade can be used for restoring the Enea Edge Management application. Extract the application files from the specified compressed install kit. Start the ucpemanager service. Fresh Installation of the Enea Edge Management in the Manual contains information about the input required to be entered during the execution of the upgrade script. For an example on how to upgrade an Enea Edge Management installation in a High Availability setup, consult Upgrading a High Availability Deployment in the Manual.

How to restore a previous Enea Edge Management installation Extract Enea_Edge_Management_<version>-build<build_number>.tar.gz The directory in which the archive has been unpacked will be denoted as <EEMg-installerdir>. Copy the snapshot file (EneaEdgeManagement-Backup-YYYYddMMHHmm.tar.gz) created during a previous Enea Edge Management Upgrade or Enea Edge Management Uninstall Operation into the <EEMg-installerdir>/dist directory. Enter <EEMg-installerdir>/dist. Run the following command with the root user and change /opt/ems to the correct location of the Enea Edge Management installation: ./restore.sh /opt/ems EneaEdgeManagement-Backup-YYYYddMMHHmm.tar.gz Running this command will: Remove any vestiges of the existing ucpemanager service, if they exist. Reinstall the Enea Edge Management application on the specified target location, restoring the data in the database and files in the process. The ucpemanager service will then start with the older version now running on the system.

How to uninstall an existing Enea Edge Management installation Navigate to the folder where the Enea Edge Management application is unpacked: <EEMg-installerdir>. Enter <EEMg-installerdir>/dist. Run the following command with the root user and change /opt/ems to the correct location of the Enea Edge Management installation: ./uninstall.sh /opt/ems Running this command will: Stop the currently running ucpemanager service. Create a compressed file of the ucpemanager application folder: EneaEdgeManagement-Backup-YYYYddMMHHmm.tar.gz, which contains a snapshot of the existing installation and functions as a restore point. The snapshot file created during the uninstall can be used for restoring the Enea Edge Management application. Uninstall the ucpemanager service, so that it will not start up on reboot. Uninstall the database service. Completely remove the contents of the application and database folders. After these steps, the Enea Edge Management application is completely removed from the system.

A uCPE device can be upgraded using the Enea Edge Management GUI.

The Device Upgrade/Install option performs the following operations to the uCPE device: Prepare for upgrade. This stage prepares the files needed for an upgrade. Install file on device. This stage copies the file to the uCPE device. Upgrade Device. This stage upgrades the uCPE device to a newer version. Upgrading from Enea NFV Access 2.3.0 is not possible when using the Enea Edge Management application in HTTPS mode. Either switch to HTTP by accessing the System menu, clicking on Configuration, then Web Access and checking the Enable HTTP box, or by installing Edge Enea 2.4.0 on the device manually.

Before an installation or upgrade can be completed, certain configuration data must be set. Files also need to be uploaded to the Device Upgrade image repository in order to be uploaded to the device. Launch the Device Upgrade management console by selecting Devices and then the Upgrade button from the top tool-bar. The console will contain the following tabs: Image Library. To add/delete an image. Upgrade Operations. See upgrades that are currently running, cancel any upgrades in progress, or start a uCPE device upgrade. Configuration. Upgrade configuration parameters. The uCPE Device upgrade is done with image files of the type ostree.tar.bz2, which are available in the Enea_Edge_Runtime_<processor>_<version>-build<build_number>.tar.gz file you downloaded with your release.

Adding an image to the image repository/library Select Devices and then the Upgrade button. Select Add from the Image Library tab to add a new image file. Select Choose File to provide the path to the image file (must be of type ostree.tar.bz2). Select the target hardware platform corresponding to the image being uploaded (xeon-d or atom-c3000). Click Send to upload the image to the image repository. Deleting an image from the image repository Select Devices and then the Upgrade button. Select the image you want to delete from the Image Library tab and then click Delete.

The Upgrade Operations tab allows a user to manage uCPE device upgrades in the system. It allows the user to see all the upgrades that are currently in progress, as well as listing the completed ones. If an upgrade succeeds or fails, then a row will be added to the completed upgrades table. If one fails, the failure message will be visible in the table. The list of completed upgrade tasks resides in the cache memory and will not persist across reboots of the server. How to Install/Upgrade a device immediately or schedule the process for later Select Devices and then the Upgrade button. Select Upgrade Devices from the Upgrade Operations tab. This will launch a Multi Device Install Image screen that will allow the user to install and upgrade more than one uCPE device at a time or upgrade later. The configurable parameters are: Scheduling. Click this checkbox if the upgrade will be done later. Schedule the day, hour and minute for when to run the upgrade. The hour represents the local Enea Edge Management application server hour. Description. An optional description of the operation. It is recommended to add a description so that different upgrades happening simultaneously can be distinguished. Image File. Click on Choose Image File to select the image file. Devices. The list of uCPE Devices that can accept an image file is populated when the image file is chosen. Mark the uCPE devices that you wish to upgrade and press the > button to move the uCPE devices to the right side of the selector. Those chosen form the list of uCPE devices that will be upgraded. Upgrade Operation. The available options are: Install and Activate. This will do an image installation as well as an upgrade. Install Only. This will do an image installation only. The image is copied to the uCPE device, and an upgrade will be done later either at a scheduled time or when the option Activate Only is selected. Activate Only. This will activate an already installed image on the uCPE device. To start the upgrade, click ok. When the uCPE device activates the upgrade, it will be rebooted automatically.

The installed releases on a uCPE device can be viewed by selecting the uCPE device first, then from the top toolbar selecting Configuration and then the Upgrade button. The installed releases on the uCPE device, the release status, release state, commit-id and release version will be listed in a table.

The status of the installation and upgrade can be viewed in the Upgrade Operations tab. Ongoing or scheduled upgrade operations can be viewed or canceled. To view the status of an installation or upgrade operations Select Devices and then the Upgrade button. Select Upgrade Operations. The ongoing operations are listed at the top and a history of failed or successful operations are listed at the bottom. Select an Active or Completed Upgrade Operation and then the Device Status button to see detailed information regarding the upgrade operation, including the uCPE devices involved and information per uCPE device. To cancel an upgrade operation Select Devices, then the Upgrade button and choose Upgrade Operations. Select an operation from the list and choose Cancel Upgrade and Confirm. The operation will then be deleted from the list.

The default values present in the configuration of each uCPE device are recommended for use. Modifying them is for an Advanced User only. How to Configure the uCPE device Upgrade Select Devices and then the Upgrade button. Select Configuration. The configurable parameters are: deviceImageDir. This is the disk location of the device image repository. If no absolute path name is given it is assumed to be relative to the installation directory. maxThreads. This number dictates how many upgrades the system can manage at one time, either individually launched or launched from the multi-device screens. This value defaults to 20, which means that 20 uCPE devices may be updated at one time. KeepAlive. This number represents the number of seconds that a thread will be kept alive before it is collected. If multiple installations are occurring, this will keep the thread alive for X seconds before it is released. If not released, it can be used by the internal scheduling system as soon as it has completed an upgrade.

Each uCPE device can receive image files and use them to upgrade. This can be done by selecting the uCPE device in the System view and clicking the Upgrade button. In the new window, an upgrade image can be chosen from the Image Files tab by selecting the image file from the list and clicking the Install on Device button. The Image files that appear in the Image Library tab can be uploaded to the Enea Edge Management Application by following the steps listed in Image Library. Once an image is installed on the uCPE device, the image will be available on the uCPE device and be visible in the Releases tab. There are two ways to make it active, choose one or the other: Select it from the list and then start the upgrade by clicking the Upgrade button. Select Operations, then Upgrade, enter the Release Name and press Execute. Filling in the Restore Archive text field is optional and should be left unset if the NFVi Snapshot feature is disabled. If an installed image is no longer needed, it can be removed from the device by selecting Operations and Remove Release. In the Remove Release window, provide the Release Name and press Execute.