Table of Contents
Introduction
Welcome to the STORDIS Support Portal guide!
This article explains how to safely upgrade your SONiC operating system using the HTTP method. It covers all steps from verifying prerequisites to confirming the upgrade. Alternative methods, such as fresh and local file installation, are mentioned briefly.
Prerequisites
- SSH or console access to the SONiC switch.
- SSH/SFTP access to a remote HTTP server.
- Basic Linux CLI knowledge.
Important Notes
- Ensure sufficient disk space before installing a new image.
- Ensure the running configuration is written to disk.
- If using management VRF, execute the installer within the mgmt VRF context.
- The newly installed image is automatically set as the next boot image.
- A reboot is required to activate the new SONiC version.
Topology
Step-By-Step Guide
Upgrade SONiC via HTTP
STEP 1: Obtain the SONiC Image
Download the appropriate SONiC image for your platform from the official SONiC repository or your vendor’s support portal.
Ensure the image file is compatible with your switch platform and ASIC, and accessible from the remote HTTP server.
STEP 2: Check installed image
sudo sonic-installer list
STEP 3: Set the management IP address
sudo config interface ip add eth0 192.168.1.50/24
Verify connectivity to the remote HTTP server using the ping command.
STEP 4: Upgrade image from remote HTTP server
sudo sonic-installer install http://192.168.1.200/path/sonic-image.bin
To skip platform check (e.g., for virtualization testing), add --skip-platform-check:
sudo sonic-installer install http://192.168.1.200/path/sonic-image.bin --skip-platform-check
If the current switch configuration includes 'management vrf' and the HTTP server connects to the management port, use the command:
sudo ip vrf exec mgmt sonic-installer install http://192.168.1.200/path/sonic-image.bin
STEP 5: Check the boot image
sudo sonic-installer listThe "Next" boot-up image will be set to the new image automatically.
Example:
STEP 6: Reboot the device
sudo reboot
After reboot, the new SONiC image will appear in the GRUB boot menu and will be set as the default boot option.
STEP 7: Verify running version
show version
Clean Installation via ONIE
For situations where a full OS replacement is required, or when switching SONiC editions, a clean installation via ONIE is recommended.
Note: This method will completely wipe the switch and all configuration.
Important first step for fresh installation: Enter the ONIE uninstall mode on your switch to remove the current SONiC installation.
For detailed instructions on the remaining steps, refer to:
How to install and deploy SONiC on network switches?
If you need to back up your current configuration before performing any upgrade or clean install, and restore it afterward (if compatible), see:
How to backup/recover the configuration in SONiC?
Congratulations!
You have successfully upgraded your SONiC switch. The new version is now active and ready for operation.
If you have any questions related to this article, feel free to reach out to our technical support team.
Happy Networking!
Useful links
If you want to explore more topics, be sure to check out our other guides, including:
How can I set up a console connection to Edgecore Open Networking switch?
How to Reset Password in SONiC?
Where to download the SONiC Virtual Switch (VS) community pre-built image?
For more free resources, visit:
https://stordis.com/free-resources/
Still have questions? You can find more answers in our full FAQ - just follow the link below.
Comments 0
Comments
Please sign in to leave a comment.