Update system firmware

The Connect EZ 8 operating system firmware images consist of a single file with the following naming convention:

platform-version.bin

For example, Connect EZ 8-25.2.54.xxx

Manage firmware updates using Digi Remote Manager

If you have a network of many devices, you can use Digi Remote Manager Profiles to manage firmware updates. Profiles ensure all your devices are running the correct firmware version and that all newly installed devices are updated to that same version. For more information, see the Profiles section of the Digi Remote Manager User Guide.

Python and DAL OS firmware updates

Make sure to check the Python version you are using and that it is compatible with the DAL OS firmware version to which you want to upgrade. You may need to update any Python scripts you have so they are compatible with the Python running on the DAL OS firmware version you choose. See Python versions and corresponding DAL OS firmware versions.

Certificate management for firmware images

The system firmware files are signed to ensure that only Digi-approved firmware load onto the device. The Connect EZ 8 device validates the system firmware image as part of the update process and only successfully updates if the system firmware image can be authenticated.

Downgrading

Downgrading to an earlier release of the firmware may result in the device configuration being erased.

Downgrading from firmware version 22.2.9.x

Beginning with firmware version 22.2.9.x, the Connect EZ 8 device uses certificate-based communication for enhanced security when connecting to Digi Remote Manager. If you downgrade your firmware from version 22.2.9.x to version 21.11.x or previous, your device will no longer be able to communicate with Remote Manager.

To remedy this issue, select the device in Remote Manager and select Actions > Reset Device Certificate.



  Web

  1. Log into the Connect EZ 8 WebUI as a user with full Admin access rights.

  2. On the main menu, click System. Under Administration, click Firmware Update.

  3. Click Download from server.

  4. For Version:, select the appropriate version of the device firmware.
  5. Click Update Firmware.
  1. Select the device in Remote Manager and click Actions > Open Console, or log into the Connect EZ 8 local command line as a user with full Admin access rights.

    Depending on your device configuration, you may be presented with an Access selection menu. Type admin to access the Admin CLI.

  2. >Use the system firmware ota check command to determine if new modem firmware is available on the Digi firmware repository.
    > system firmware ota check
Current firmware version is 23.9.74.0
Checking for latest Connect EZ 8 firmware...
Newest firmware version available to download is '25.2'
Device firmware update from '23.9.74.0' to '25.2' is needed
>
  3. Use the modem firmware ota list command to list available firmware on the Digi firmware repository. 
    > system firmware ota list
23.9.74.0
25.2
>
  4. Perform an OTA firmware update:
    • To perform an OTA firmware update by using the most recent available firmware from the Digi firmware repository:
      1. Update the firmware: 
        > system firmware ota update
Downloading firmware version '25.2'...
Downloaded firmware /tmp/cli_firmware.bin remaining
Applying firmware version '25.2'...
41388K
netflash: got "/tmp/cli_firmware.bin", length=42381373
netflash: authentication successful
netflash: vendor and product names are verified.
netflash: programming FLASH device /dev/flash/image1
41408K 100%
Firmware update completed, reboot device
>
      2. Reboot the device:
        > reboot
>

    • To perform an OTA firmware update by using a specific version from the Digi firmware repository, use the version parameter to identify the appropriate firmware version as determined by using system firmware ota list command. For example:

      1. Update the firmware: 
        > system firmware ota update version 25.2
Downloading firmware version '25.2'...
Downloaded firmware /tmp/cli_firmware.bin remaining
Applying firmware version '25.2'...
41388K
netflash: got "/tmp/cli_firmware.bin", length=42381373
netflash: authentication successful
netflash: vendor and product names are verified.
netflash: programming FLASH device /dev/flash/image1
41408K 100%
Firmware update completed, reboot device
>
      2. Reboot the device:
        > reboot
>

  Web

  1. Download the Connect EZ 8 operating system firmware from the Digi Support FTP site to your local machine.

    2. Log into the Connect EZ 8 WebUI as a user with full Admin access rights.

  2. On the main menu, click System. Under Administration, click Firmware Update.

  3. Click Choose file.
  4. Browse to the location of the firmware on your local file system and select the file.
  5. Click Update Firmware.

  1. Download the Connect EZ 8 operating system firmware from the Digi Support FTP site to your local machine.
  2. Select the device in Remote Manager and click Actions > Open Console, or log into the Connect EZ 8 local command line as a user with full Admin access rights.

    Depending on your device configuration, you may be presented with an Access selection menu. Type admin to access the Admin CLI.

  3. Load the firmware image onto the device. We recommend using the /tmp directory.
    4. > scp host hostname-or-ip user username remote remote-path local local-path to local

    where:

    • hostname-or-ip is the hostname or IP address of the remote host.
    • username is the name of the user on the remote host.
    • remote-path is the path and filename of the file on the remote host that will be copied to the Connect EZ 8 device.
    • local-path is the location on the Connect EZ 8 device where the copied file will be placed.

    For example: 

    > scp host 192.168.4.1 user admin remote /home/admin/bin/Connect EZ 8-25.2.bin local /tmp/ to local
admin@192.168.4.1's password: adminpwd 
Connect EZ 8-25.2.bin			100%	36MB	11.1MB/s	00:03
>
  4. Verify that the firmware file has been successfully uploaded to the device:
    > ls /tmp
-rw-r--r--    1 root     root      37511229 May 16 20:10 Connect EZ 8-25.2.bin
-rw-r--r--    1 root     root          2580 May 16 16:44 blank.json
...
>
  5. Update the firmware by entering the system firmware update command, specifying the path and file name to the firmware file:
    > system firmware update file /tmp/Connect EZ 8-25.2.bin
36632K
netflash: got "/tmp/Connect EZ 8-25.2.bin", length=37511229
netflash: authentication successful
netflash: programming FLASH device /dev/flash/image
36633K 100%
Firmware update completed, reboot device
>
  6. Reboot the device to run the new firmware image using the reboot command. 
    > reboot
Rebooting system
>
  7. Once the device has rebooted, log into the Connect EZ 8's command line as a user with Admin access and verify the running firmware version by entering the show system command. 
    > show system

 Hostname                 : Connect EZ 8
 FW Version               : 25.2
 MAC                      : 0040FF800120
 Model                    : Digi Connect EZ 8
 Current Time             : Thu, Jan 11, 2024 12:10:00 +0000
 Uptime                   : 42 seconds (42s)

>