Management Plane for Software Life Cycle Management Operations

RBFS supports software life-cycle management functions by enabling operations such as image downloading, installing, activating, and deleting while the router is operational. You can use CLI commands to perform these operations through both in-band and out-of-band (OOB) interfaces. With this feature, software upgrade tasks can now be performed through the management plane without requiring a dedicated OOB connection.

Software can be downloaded and installed without any downtime. Only a brief downtime occurs during the activation.

The following sections provide information about the new commands:

Download Software Image

The following command downloads the software image from the specified HTTPS URL and saves it to the configuration partition using the provided filename.

Syntax:

request software download <url> <file-name>

Option Description

<url>

Specify HTTPS URL location.

<file-name>

Specify the file name.

Example Command:

request software download https://pkg.rtbrick.net/_/images/latest/rtbrick-host-installer/bookworm-installer-spine-q2c-s9600-32x-25.4.0-g6daily.2025 1013163757+Bdevelopment.C3dae1a64 image-1-dev

Delete Software Image

This command deletes the specified software image file from the partition:

Syntax:

request software delete [partition-a | partition-b] <file-name>

Option Description

partition-a | partition-b

Specify the desired partition target for downloading.

<file-name>

Specify the file name. NOTE: Autocompletion is supported for specifying software image file names.

Install Software Image

This command starts the installation of the software image into the specified partition.

You must always specify a partition and if a mounted (active) partition is selected, then it throws an error.

Syntax:

request software install [partition-a | partition-b] <file-name>

Option Description

partition-a | partition-b

Specify the target image partition.

<file-name>

Specify the file name. NOTE: Autocompletion is supported for specifying software image file names.

Set Active Partition Flag

You can set a reboot flag for a specific software partition (for example, Partition A or Partition B) as the active partition for the all future reboots. The device will boot from that partition every time it restarts, until changed again.

Syntax:

request software activate [partition-a | partition-b] <option>

Option Description

partition-a | partition-b

Specify the desired partition.

temporary

A temporary reboot activates the specified partition only for the next boot. After the device restarts again, it automatically reverts to the original active partition.

reboot

Reboots the specified partition.

Inband Software Show Commands

software partition

Syntax:

show software partition

This command displays all software partitions on the system along with the installed software images. If no software is installed in a partition, the command lists any software image files that have been downloaded to that partition.

The active partition (the one currently running) is clearly shown in the output. The partition marked with the “reboot” tag shows which partition will become active after the next reboot.

Example Command:

show software partition

Example: The output shows software image details for partitions A and B, including image IDs, versions, and platform information. Partition B is currently set as both the active and permanent boot image. Temporary boot option is not set.

supervisor@rtbrick.net: op> show software partition
System Image Information:
  Image A Details:
    Image ID            : 64ad2c9a-e72a-41f6-be80-de8e9325cc3b
    Image Type          : host-installer
    Platform Chipset    : q2a
    Model               : s9510-28dc
    Element Role        : multiservice-edge
    Image Version       : 2504.0.0-g6daily.20251028034032+Bdevelopment.Cd73d28d2
    RTB Image Version   : 25.4.0-g6daily.20251028034032+Bdevelopment.Cd73d28d2
  Image B Details:
    Image ID            : ebbacee2-9cf2-4ec4-bd81-05ed23b40250
    Image Type          : host-installer
    Platform Chipset    : q2a
    Model               : s9510-28dc
    Element Role        : multiservice-edge
    Image Version       : 2504.0.0-g6daily.20251030035506+Bdevelopment.Cd73d28d2
    RTB Image Version   : 25.4.0-g6daily.20251030035506+Bdevelopment.Cd73d28d2
  Boot Options:
    Active Image        : B
    Permanent Boot      : B
    Temporary Boot      : Not Set
  Installer Files: Not available

Example: The output shows that partition B is the active and permanent boot image and partition A is set as the temporary boot image. The system will boot from partition A on the next reboot but will revert to partition B for future boots.

supervisor@rtbrick.net: op> show software partition
System Image Information:
  Image A Details:
    Image ID            : 64ad2c9a-e72a-41f6-be80-de8e9325cc3b
    Image Type          : host-installer
    Platform Chipset    : q2a
    Model               : s9510-28dc
    Element Role        : multiservice-edge
    Image Version       : 2504.0.0-g6daily.20251028034032+Bdevelopment.Cd73d28d2
    RTB Image Version   : 25.4.0-g6daily.20251028034032+Bdevelopment.Cd73d28d2
  Image B Details:
    Image ID            : ebbacee2-9cf2-4ec4-bd81-05ed23b40250
    Image Type          : host-installer
    Platform Chipset    : q2a
    Model               : s9510-28dc
    Element Role        : multiservice-edge
    Image Version       : 2504.0.0-g6daily.20251030035506+Bdevelopment.Cd73d28d2
    RTB Image Version   : 25.4.0-g6daily.20251030035506+Bdevelopment.Cd73d28d2
  Boot Options:
    Active Image        : B
    Permanent Boot      : B
    Temporary Boot      : A
  Installer Files: Not available

Example: The output shows two software images installed (Image A and Image B). Image B is currently active, while Image A remains the permanent boot image.

supervisor@rtbrick.net: op> request software activate partition-a
Task successful
supervisor@rtbrick.net: op> show software partition
System Image Information:
  Image A Details:
    Image ID            : 64ad2c9a-e72a-41f6-be80-de8e9325cc3b
    Image Type          : host-installer
    Platform Chipset    : q2a
    Model               : s9510-28dc
    Element Role        : multiservice-edge
    Image Version       : 2504.0.0-g6daily.20251028034032+Bdevelopment.Cd73d28d2
    RTB Image Version   : 25.4.0-g6daily.20251028034032+Bdevelopment.Cd73d28d2
  Image B Details:
    Image ID            : ebbacee2-9cf2-4ec4-bd81-05ed23b40250
    Image Type          : host-installer
    Platform Chipset    : q2a
    Model               : s9510-28dc
    Element Role        : multiservice-edge
    Image Version       : 2504.0.0-g6daily.20251030035506+Bdevelopment.Cd73d28d2
    RTB Image Version   : 25.4.0-g6daily.20251030035506+Bdevelopment.Cd73d28d2
  Boot Options:
    Active Image        : B
    Permanent Boot      : A
    Temporary Boot      : Not Set
  Installer Files: Not available

Job Data

Syntax:

show software job <job_uuid> data

This command is used to view the real-time activity and log output of a software job. For example, tracking the progress of a software image download or installation.

Sample command:

show software job 2f3d3570-69d2-4307-9c97-305155f8016b data

Example: The output shows the specific software job that shows the system initiated a download. The download is progressing at a rate of around 110 MB/s.

supervisor@rtbrick.net: op> show software job 2f3d3570-69d2-4307-9c97-305155f8016b data
--2025-10-14 04:56:38--  https://pkg.rtbrick.net/_/images/latest/rtbrick-host-installer/bookworm-installer-spine-q2c-s9600-32x-25.4.0-g6daily.20251013163757+Bdevelopment.C3dae1a64
Resolving pkg.rtbrick.net (pkg.rtbrick.net)... 10.200.137.175
Connecting to pkg.rtbrick.net (pkg.rtbrick.net)|10.200.137.175|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 1450171722 (1.3G) [text/plain]
Saving to: ‘/var/config/installer/image-1-dev’

     0K ........ ........ ........ ........  2% 96.8M 14s
 32768K ........ ........ ........ ........  4%  112M 13s
 65536K ........ ........ ........ ........  6%  112M 12s
 98304K ........ ........ ........ ........  9%  112M 12s
131072K ........ ........ ........ ........ 11%  111M 11s
163840K ........ ........ ........ ........ 13%  112M 11s
196608K ........ ........ ........ ........ 16%  112M 11s
229376K ........ ........ ........ ........ 18%  112M 10s
262144K ........ ........ ........ ........ 20%  111M 10s
294912K ........ ........ ........ ........ 23%  113M 10s
327680K ........ ........ ........ ........ 25%  112M 9s
360448K ........ ........ ........ ........ 27%  112M 9s
393216K ........ ........ ........ ........ 30%  112M 9s
425984K ........ ........ ........ ........ 32%  112M 8s
458752K ........ ........ ........ ........ 34%  105M 8s
491520K ........ ........ ........ ........ 37%  112M 8s
<...>
2025-10-14 04:56:50 (111 MB/s) - ‘/var/config/installer/image-1-dev’ saved [1450171722/1450171722]

Job Status

Syntax:

show software job <job_uuid> status

This command is used to view the final state or result of the software job after execution.

Sample Command:

show software job 2f3d3570-69d2-4307-9c97-305155f8016b status

Example output shows the software job status that has completed and its state is marked as done with an exit code of 0.

supervisor@rtbrick.net: op> show software job 2f3d3570-69d2-4307-9c97-305155f8016b status
State      : done
Exit Code  : 0