Device Upgrade

image update

[Command] image update bin-file

[Purpose] Upgrade system version

[Parameter]

Parameter	Description
bin-file	Software image file name

[View] System view

[Notes] By default, during an upgrade, the system will automatically copy the currently saved configuration file to the new version and load it after the restart. If you need to clear the configuration or save the latest configuration, please execute the appropriate commands before the upgrade.

[Use Cases]

sonic# image update AsterNOS-V5.2R001.bin

image list

[Command]

image list

[Purpose]

Show the system version of the current partition.

[View]

System View

[Comment]

The system has software versions installed on two partitions. This command shows the version installed on the current partition. Use the image set_default command to specify the software version that takes effect for the system, which requires a reboot to apply.

[Use Cases]

sonic# image list
Current: SONiC-OS-V5.2R015T04-20251210.220426
Next: SONiC-OS-V5.2R015T04-20251210.220426
Available:
SONiC-OS-V5.2R015T04-20251210.220426
SONiC-OS-201911.0-20251201.165801

image set_default

[Command]

image set_default

[Purpose]

When multiple software versions exist in the partition, set the default version to take effect for the system.

[Parameter]

bin-file Software image file name

[View]

System View

[Comment]

Use the image list command to view the software versions in the system partition. Use the image set_default command to specify the software version currently in effect for the system, which requires a reboot to take effect.

[Use Cases]

sonic# image set_default SONiC-OS-V5.2R015T04-20251210.220426