SONiC OS Install via CLI Install

Summary: SONiC OS Install via CLI Install

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.
Check out other resources

Instructions

Prerequisites:  
  1. Active connection to the switch.
  2. File Server details with OS software loaded. HTTP service must be available to the switch.

Instructions:
Image Lists and Status: Check the currently booted OS image and the image that will be booted on the next reboot.
  1. At the SONiC CLI prompt, use the “show image list” command to display which image is currently active and which version will be loaded on the next reboot.
SONIC# show image list
Current: SONiC-OS-4.0.1-Enterprise_Base
Next: SONiC-OS-4.0.1-Enterprise_Base
Available:
SONiC-OS-4.0.1-Enterprise_Base
SONIC#
 
  1. Use the “image install http://[IP]/[image_name]” command to install a new image into the Next: slot, to be loaded at next boot
SONIC#
SONIC# image install http://10.0.0.200/SONiC-OS-4.0.3-Enterprise_Base.bin
%Info: Check 'show image status' for image install progress.
SONIC#
 
  1. To check status of the image download process and then the install progress, use the “show image status” command.
  
SONIC# show image status
-----------------------------------------------------------
Global operation status  : GLOBAL_STATE_DOWNLOAD
-----------------------------------------------------------
File operation status    : TRANSFER_DOWNLOAD
File size(bytes)         : 959070190
File transfer bytes      : 253968384
File progress            : 26%
Transfer start time      : 2023-02-03 20:14:45+0000
Transfer end time        : N/A
-----------------------------------------------------------
SONIC#
 
  1. After several minutes, execute the “show image status” command again and verify the progress of the install progress. Note the “Transfer end time” is completed and there is now an additional “INSTALL_PROGRESS’ in the “Install operation status” section.
SONIC# show image status
-----------------------------------------------------------
Global operation status  : GLOBAL_STATE_INSTALL
-----------------------------------------------------------
File operation status    : TRANSFER_STATE_SUCCESS
File size(bytes)         : 959070190
File transfer bytes      : 959070190
File progress            : 100%
Transfer start time      : 2023-02-03 20:14:45+0000
Transfer end time        : 2023-02-03 20:16:02+0000
-----------------------------------------------------------
Install operation status : INSTALL_PROGRESS
Install start time       : 2023-02-03 20:16:02+0000
Install end time         : N/A
SONIC#
 
  1. After several additional minutes, execute the ‘show image status’ again and note the completion of the “INSTALL_STATE_SUCCESS” and the ‘Install end time’ field is updated.
SONIC# show image status
-----------------------------------------------------------
Global operation status  : GLOBAL_STATE_INSTALL
-----------------------------------------------------------
File operation status    : TRANSFER_STATE_SUCCESS
File size(bytes)         : 959070190
File transfer bytes      : 959070190
File progress            : 100%
Transfer start time      : 2023-02-03 20:14:45+0000
Transfer end time        : 2023-02-03 20:16:02+0000
-----------------------------------------------------------
Install operation status : INSTALL_STATE_SUCCESS
Install start time       : 2023-02-03 20:16:02+0000
Install end time         : 2023-02-03 20:18:06+0000
SONIC#
 
  1. The “show image list” command will show that the new image will be used on the next boot. Both the current and the new image will be listed as available on the local switch.
SONIC# show image list
Current: SONiC-OS-4.0.1-Enterprise_Base
Next: SONiC-OS-4.0.3-Enterprise_Base
Available:
SONiC-OS-4.0.1-Enterprise_Base
SONiC-OS-4.0.3-Enterprise_Base
SONIC#


Set the Default Boot Image: Changing the OS image the switch will use on next boot.
  1. To show which image version is set to boot on the next reload, use the “show image list” command.
SONIC#
SONIC# show image list
Current: SONiC-OS-4.0.1-Enterprise_Base
Next: SONiC-OS-4.0.1-Enterprise_Base
Available:
SONiC-OS-4.0.1-Enterprise_Base
SONiC-OS-4.0.3-Enterprise_Base
SONIC#
 
  1. To change the OS image the switch will use upon next boot, use the “image set default [image name]” command. To confirm the change, execute “show image list” command again to verify the image for the next boot.
SONIC# show image list
Current: SONiC-OS-4.0.3-Enterprise_Advanced
Next: SONiC-OS-4.1.0-Enterprise_Premium
Available:
SONiC-OS-4.0.3-Enterprise_Advanced
SONiC-OS-4.1.0-Enterprise_Premium

SONIC# image set-default SONiC-OS-4.0.3-Enterprise_Advanced

SONIC# show image list
Current: SONiC-OS-4.0.3-Enterprise_Advanced
Next: SONiC-OS-4.0.3-Enterprise_Advanced
Available:
SONiC-OS-4.0.3-Enterprise_Advanced
SONiC-OS-4.1.0-Enterprise_Premium
SONIC#


This concludes the steps needed to change the default boot image in SONiC.
For further assistance, see the Dell EMC Enterprise SONiC User Guide Release Documentation , the Dell SONiC Quick Start Guide, or reach out to Dell EMC Technical Support.

Additional Information

Refer to this video:


You can also view this video on YouTube .

Affected Products

Enterprise SONiC Distribution
Article Properties
Article Number: 000213661
Article Type: How To
Last Modified: 06 Dec 2023
Version:  3
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.