Edgecore SONiC Installation & Upgrade Follow

Reference model:

• Switch model name: All
• Edgecore SONiC version: All

Example:

• Install SONiC from HTTP or TFTP via ONIE
• Install SONiC from USB via ONIE

• Edgecore SONiC Upgrade

• Specified the startup image
• Remove installed image

Restriction:

• Suggest you should not install different branch SONiC image on switch, it may cause some exception issue.
• If your switch installed SONiC, you login to "ONIE :install OS" mode via grub, it will let the grub miss SONiC option.

Example 1: Install SONiC from HTTP or TFTP via ONIE

Procedure  :

Step 1. Set up the physical link environment as topology.

Step 2. Enter the ONIE install mode

Note: Switch shall automatically enter the ONIE install mode if there's no NOS installed yet.

Caution:

Since switch will automatically start the ONIE Service Discovery, this command can make user types easily.

This is not a necessary command. It won't affect installation no matter user execute it or not.

ONIE:/ # onie-discovery-stop
discover: installer mode detected.
Stopping: discover... done.

Step 3. Setup the ip address binding to switch management port

ONIE:/ # ifconfig eth0 192.168.1.2 netmask 255.255.255.0

Caution: Default ONIE will get ip from DHCP

Step 4. Install the image from remote URL via HTTP or TFTP

ONIE:/ # onie-nos-install tftp://192.168.1.3/SONiC.Edgecore-SONiC_20201123_130028_ec202006_74

If the installation is successful, the device will reboot automatically and boot-up with SONiC.

After finish the installation, user might need to check this article.

1. Username and Password

2. ecSONiC License Installation (License is no longer required from SONiC.Edgecore-SONiC 201911.2 2020 Aug version and later)

Example 2: Install SONiC from USB via ONIE

Procedure :

Step 1. Copy Edgecore SONiC installer file to USB flash drive with a name "onie-installer-x86_64".

Step 2. Reboot switch and plug in USB drive to switch 

Step 3. Enter ONIE install mode

Step 4. Wait for ONIE to discover USB and start automatically uploading new firmware via USB drive.

If the installation is successful, the device will reboot automatically and boot-up with SONiC.

Example 3:  Edgecore SONiC Upgrade

Procedure :

Step 1. Check the image

admin@sonic:~$ sudo sonic_installer list
Current: SONiC-OS-Edgecore-SONiC_20201123_130028_ec202006_74
Next: SONiC-OS-Edgecore-SONiC_20201123_130028_ec202006_74
Available:
SONiC-OS-Edgecore-SONiC_20201123_130028_ec202006_74

Step 2. Set the manangement IP (Refer to Management and front port IPv4/IPv6 Address)

admin@sonic:~$ sudo ip address add 192.168.1.2/24 dev eth0

Step 2. Upgrade image from remote HTTP server

admin@sonic:~$ sudo sonic_installer install http://192.168.1.3/http://192.168.1.3/sonic-broadcom.bin -y

Caution: It could only use HTTP to upgrade.

Step 3. Check the images.

admin@sonic:~$ sudo sonic_installer list
Current: SONiC-OS-Edgecore-SONiC_20201123_130028_ec202006_74
Next: SONiC-OS-Edgecore-SONiC_20201123_test
Available:
SONiC-OS-Edgecore-SONiC_20201123_test
SONiC-OS-Edgecore-SONiC_20201123_130028_ec202006_74

Note: The "Next" boot-up image shall be set with new image automatically.

Step 4. Reboot device

admin@sonic:~$ sudo reboot

Step 5. Check the images status

admin@sonic:~$ sudo sonic_installer list
Current: SONiC-OS-Edgecore-SONiC_20201123_test
Next: SONiC-OS-Edgecore-SONiC_20201123_test
Available:
SONiC-OS-Edgecore-SONiC_20201123_test
SONiC-OS-Edgecore-SONiC_20201123_130028_ec202006_74

Example 4:  Specified the startup image

Procedure :

Step 1. Check the images status

admin@sonic:~$ sudo sonic_installer list
Current: SONiC-OS-Edgecore-SONiC_20201123_test
Next: SONiC-OS-Edgecore-SONiC_20201123_test
Available:
SONiC-OS-Edgecore-SONiC_20201123_test
SONiC-OS-Edgecore-SONiC_20201123_130028_ec202006_74

Caution:

• "Current" image, it mean the running image
• "Next" image, it mean the next boot up image.
• "Available" images, it mean installed SONiC images.

Step 2. Change the default boot-up image

admin@sonic:~$ sudo sonic_installer set_default SONiC-OS-Edgecore-SONiC_20201123_130028_ec202006_74
Command: grub-set-default --boot-directory=/host 2

Step 2. Check the image status

admin@sonic:~$ sudo sonic_installer list
Current: SONiC-OS-Edgecore-SONiC_20201123_test
Next: SONiC-OS-Edgecore-SONiC_20201123_130028_ec202006_74
Available:
SONiC-OS-Edgecore-SONiC_20201123_test
SONiC-OS-Edgecore-SONiC_20201123_130028_ec202006_74

Then the "Next" boot-up image changed.

Caution: You can choose the boot-up image in GRUB menu directly, but this way won't change the default boot-up image.

Example 5: Remove installed image

Procedure :

Step 1. Check the images status

admin@sonic:~$ sudo sonic_installer list 
Current: SONiC-OS-Edgecore-SONiC_20201123_130028_ec202006_74
Next: SONiC-OS-Edgecore-SONiC_20201123_130028_ec202006_74
Available:
SONiC-OS-Edgecore-SONiC_20201123_test
SONiC-OS-Edgecore-SONiC_20201123_130028_ec202006_74

Step 2. Remove the image

admin@sonic:~$  sudo sonic_installer remove SONiC-OS-Edgecore-SONiC_20201123_test -y

Step 3. Check the images status

admin@sonic:~$ sudo sonic_installer list
Current: SONiC-OS-Edgecore-SONiC_20201123_130028_ec202006_74
Next: SONiC-OS-Edgecore-SONiC_20201123_130028_ec202006_74
Available:
SONiC-OS-Edgecore-SONiC_20201123_130028_ec202006_74