Skip to content
Contact Support
  • There are no suggestions because the search field is empty.

How to upgrade AltoPlex firmware

Upgrade roadmap

The role of the device (distribution node (DN) or client node (CN)) affects the sequence of upgrading.

  1. Download and unzip the firmware zip file from Altoplex Firmware Downloads at support.altowav.com.
  2. Upgrade the devices one at a time.
  3. Always start with the distribution node furthest from the root node.
  4. Make sure each upgrade finishes and all DN and CN links are re-established before moving on to the next distribution node.
  5. Upgrade client nodes after the distribution nodes are upgraded.

The firmware binary filename

The following files are included in the firmware zip file:

  • A digest file, not used as part of this upgrade process.
  • The firmware binary.

The firmware binary filename consists of three parts:

<filetype>-<device_family_name>-<version_number>

where:

  • filetype is kb_sw-prod
  • device_family_name is one of:
    • NOMAD — Firmware used for D621 and P621 devices.
    • DEVO — Firmware used for D423, C410, C420, and P421 devices.
  • version_number is the version number of the firmware.

For example:

kb_sw-prod-NOMAD-4.2.0

Upgrade from the WebUI

  1. Download and unzip the firmware zip file from Altoplex Firmware Downloads at support.altowav.com.

    The following files are included in the firmware zip file:

    • A digest file, not used as part of this upgrade process.
    • The firmware binary. See The upgrade software filename for information about the filename used for the firmware binary.

  2. Access the WebUI of the AltoPlex device. In your browser's address bar, type:

    https://hostname

    where hostname is the hostname (KB-XX-XX-XX) or IP address of the radio. See Connecting to the AltoPlex radio for more information.

  3. Click the login link in the WebUI header to log in as administrator. The default password is admin.

  4. Click the Admin tab.
  5. Click the Upgrade Firmware button.

    The Firmware upgrade dialog opens.

  6. Click Choose File.
  7. Browse to the directory where the upgrade binary file was downloaded and select the file.
  8. Click Start Upgrade.

Upgrade from the CLI

Upgrade from the CLI by using Secure File Copy (scp)

Use Secure File Copy (scp) to upload a file from a remote host to the AltoPlex device and install the file:

  1. Download and unzip the firmware zip file from Altoplex Firmware Downloads at support.altowav.com.

    The following files are included in the firmware zip file:

    • A digest file, not used as part of this upgrade process.
    • The firmware binary. See The upgrade software filename for information about the filename used for the firmware binary.

  2. Log in via ssh to the AltoPlex device:

    $ ssh admin@<hostname>

    admin@<hostname>'s password:

    where hostname is the hostname (for example, KB-C7-00-01) or IP address of the radio. See Connecting to the AltoPlex radio for more information.

  3. Enter control mode:

    KB-C7-00-01> control

    KB-C7-00-01(control)>

  4. Upload and install the software:

    KB-C7-00-01(control)> software upgrade scp://user@server/firmware_filename

    where:

    • user is the name of the user on the remote host.
    • server is the hostname or IP address of the remote host.
    • firmware_filename is the path and filename of the upgrade software.
  5. When prompted, type the password to log into the remote host.

    The upgrade software will be uploaded and installed on the D621. You can monitor the status of the upgrade by using the software status command:

    KB-C7-00-01(control)> software status
    current-software-version: 3.9.1
    status: upgrading
    running-sw-version: 3.9.1
    new-sw-version: 4.2.0
    upgrade-running: yes

    After the software upgrade completes, the device will reboot.

Upgrade from the CLI by using a TFTP server

  1. Download and unzip the firmware zip file from Altoplex Firmware Downloads at support.altowav.com.

    The following files are included in the firmware zip file:

    • A digest file, not used as part of this upgrade process.
    • The firmware binary. See The upgrade software filename for information about the filename used for the firmware binary.
  2. Upload the binary file to the TFTP directory on your server. The TFTP server must be accessible from each device being upgraded.

  3. Log in via ssh to the AltoPlex device:

    $ ssh admin@<hostname>

    admin@<hostname>'s password:

    where hostname is the hostname (for example, KB-C7-00-01) or IP address of the radio. See Connecting to the AltoPlex radio for more information.

  4. Enter control mode:

    KB-C7-00-01> control

    KB-C7-00-01(control)>

  5. Upload and install the software:

    KB-C7-00-01(control)> software upgrade tftp://server/firmware_filename

    where:

    • server is the hostname or IP address of the TFTP server.
    • firmware_filename is the path and filename of the upgrade software.

    The upgrade software will be uploaded and installed on the AltoPlex device. You can monitor the status of the upgrade by using the software status command:

    KB-C7-00-01(control)> software status
    current-software-version: 3.9.1
    status: upgrading
    running-sw-version: 3.9.1
    new-sw-version: 4.2.0
    upgrade-running: yes

    After the software upgrade completes, the device will reboot.

Upgrade from the REST API 

  1. Download and unzip the firmware zip file from Altoplex Firmware Downloads at support.altowav.com.

    The following files are included in the firmware zip file:

    • A digest file, not used as part of this upgrade process.
    • The firmware binary. See The upgrade software filename for information about the filename used for the firmware binary.
  2. Upload the firmware image file to a server that can be access by all devices.
  3. Use the configuration/software_upgrade API to install the firmware file. For example: 

    curl -k -u admin:<password> \
    https://<hostname>/rest/v002/configuration/software_upgrade \
    -X POST \
    -H "Content-Type:application/octet-stream" \
    -H "X-File-Name:<filename>" \
    --data-binary@<path>/<filename>

    Where:

    • password is the password to log into the device. The default password is admin.
    • path is the path to the firmware file. If the command is executed from the same local directory as the firmware file, path is not necessary.
    • filename is the name of the firmware upgrade file, for example, kb_sw-prod-NOMAD-4.2.0.
    • hostname is the hostname or IP address of the radio being upgraded.

    The following example curl command uses the -i option to show the response headers, and demonstrates that the file transfer was successful and that the upgrade has begun:

    $ curl -i -k -X POST -u admin:admin \

    -H "Content-Type:application/octet-stream" \

    -H "X-File-Name:kb_sw-prod-NOMAD-4.2.0.plain" \

    --data-binary @kb_sw-prod-NOMAD-4.2.0.plain \

    https://10.0.0.01/rest/v002/configuration/software_upgrade

    % Total % Received % Xferd Average Speed Time Time Time Current

    Dload Upload Total Spent Left Speed

    100 34.1M 100 88 100 34.1M 15 6358k 0:00:05 0:00:05 --:--:-- 6301kHTTP/1.1 100 Continue

     

    HTTP/1.1 200 OK

    Content-Type: application/json

    Cache-Control: public, must-revalidate, proxy-revalidate

    Content-Length: 88

    Date: Sat, 01 Jan 2025 00:23:39 GMT

    Server: lighttpd/1.4.73

    {

    "status":"starting",

    "running-sw-version":"3.9.1",

    "upgrade-running":"yes"

    }

    The upgrade may take up to several minutes to complete.

Verify that the firmware update was successful

Verify firmware update from the WebUI

  1. Open the WebUI.
  2. The firmware version is displayed on the Status page in the Device Information section:

Verify firmware update from the command line

  1. Log in via ssh to the AltoPlex device:

    $ ssh admin@<hostname>

    admin@<hostname>'s password:

    where hostname is the hostname (for example, KB-C7-00-01) or IP address of the radio. See Connecting to the AltoPlex radio for more information.

  2. Enter control mode:

    KB-C7-00-01> control

    KB-C7-00-01(control)>

  3. Check the status of the device by using the software status command:

    KB-C7-00-01(control)> software status
    current-software-version: 4.2.0
    status: idle
    upgrade-running: no

    KB-C7-00-01(control)>

    Verify that the current-software-version matches the expected value of the upgrade.

Verify firmware update from the REST API

Use the device/node_identity API to return the firmware version:

$ curl -k -u admin:admin https://KB-C7-00-01/rest/v002/device/node_identity
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
 Dload  Upload   Total   Spent    Left  Speed
100   605  100   605    0     0   8188  0 --:--:-- --:--:-- --:--:--  8402{
  "Ethernet MAC" : "70:88:6B:C7:00:01",
  "HW name" : "nomad",
  "HW rev" : 2,
  "HW type code" : 82,
  "Node role" : "DN",
  "Number Ethernet Interfaces" : 1,
  "Number RF Interfaces" : 1,
  "Part number" : "1900-8411-1012-nomad-2-LBKA0ZZ1SV1",
  "Serial number" : "000000000000000000001KB-C7-00-01:2",
  "authorized_org" : "",
  "bootloader version" : "KBBLVERSION:1.3:prod:robot:2025-11-07_11-57-10:nomad:1b565eb",
  "description" : "system description not set",
  "gps available" : 1,
  "location" : "system location not set",
  "name" : "KB-C7-00-01",
  "node type" : "PTP",
  "software" : "4.2.0"
}