Overview

Use this procedure to install a software image file. This procedure applies to all Edge 8000 Series devices.

Ribbon ships the Edge 8000 device with preinstalled firmware. For version control or solution reasons, Ribbon Support may recommend the system be upgraded to a newer or specific version of firmware.

Ribbon Support provides a link to the image to be downloaded to the local management computer. The management computer must have IPv4 access to the Edge 8000 system to perform the image transfer and then perform the upgrade. When upgrading more than one system on the network it may be desired to place the image files on a HTTP server to allow multiple systems to pull the image files.

SCP is the preferred method to transfer the file from the management computer to the system. Use SCP as a command line option or use an SCP application utility like WinSCP. The image file must be placed in the /e8k-data directory on the system with a maximum of 2 image files.

Attaching a serial cable to the console port gives access to the CLI, allowing the user to view the installation process on the management computer. This console interface provides an option to Keep the Existing configuration or select a factory default option. The default is to Keep the Existing configuration.


Caution

This operation causes a service disruption. Perform this procedure only during a maintenance window.

Prerequisites

  • System Administrator Command Line Interface (CLI) login access
  • The ISO image file supplied by Ribbon or available in Ribbon Global Service Center (GSC)

Start

  1. Log in to the Edge 8000 CLI as System Administrator (sysadm) and enter the password.
  2. Change permission to root user by entering sudo -i. Then enter the sysadm user password.
  3. Verify the integrity of the image file. Confirm that the file size from the Ribbon download server is the same size on the management computer.
  4. Verify there is sufficient space for the new image file.

    1. List the image files. 
      Syntax
      sys-tools image ls

      Example
      # sys-tools image ls
CommonOs-alma.host-8.6-v1.0.0b17219-x86_64.iso
CommonOs-alma.host-8.6-v23.6.0b18010-x86_64.iso (active)


    2. If there are two image files, remove the image that is not active to make room for the new image file.
      Syntax
      sys-tools image delete <filename.iso>
      Ribbon recommends deleting the non-active image file to allow the active running image to be available should a downgrade be necessary.
  5. Transfer the new ISO image file to directory /e8k-data using the CLI scp command.

  6. Execute the command to install the new image. 
    The system sets the boot option to the new ISO image, backs up all configuration settings, reboots to start the image installation, and finally restores the system configuration settings. The installation takes approximately 30 to 40 minutes.
    Syntax:
    sys-tools image install <image_file_name.iso>
    sys-tools image ls

    Example
    [root@e8000 ~]# sys-tools image install CommonOs-alma.host-8.6-v23.6.0b19919-x86_64.iso
################Warning#############################
This action will reboot the device and enter the install Almalinux process.
All Almalinux OS data on the disk will be overwritten.
The installation will take about 30 minutes.
Continue (yes/no)?
yes
Set ventoy(0004) as next boot
...
    Note

    If the SBC SWe Edge has been independently upgraded using the SWe Edge web GUI, the backup process of the image installation saves the complete SBC SWe Edge virtual machine (VM) and configuration settings.

    In case the image file was partially downloaded and that file was used to upgrade the system, the upgrade will fail. You can view the upgrade failure on the console interface. To recover, power cycle the system and watch the boot messages on the console interface. There will be an option to interrupt the boot and select the previous image. 

  7. After the system reboots, log back in to the device as System Administrator using the web-based user interface.

  8. The current software version appears on the Home page. Verify the software version is the new version.

  9. As a double check, use the CLI to confirm that the system is running on the new image.
    Syntax:
    sys-tools image ls
    In the system response, the word "active" in parenthesis indicates which image the system is running on. Verify that the active image is the new image you just installed.

    Example
    # sys-tools image ls
CommonOs-alma.host-8.6-v1.0.0b17219-x86_64.iso
CommonOs-alma.host-8.6-v23.6.0b18010-x86_64.iso (active)