Edgecore SONiC Installation & Upgrade

Purpose: 
From this article, you may learn how to
1. Install Edgecore SONiC via TFTP/HTTP
2. Install Edgecore SONiC via USB
3. Upgrade current Edgecore SONiC 
4. Change the default boot-up image
5. Remove installed image from SONiC installer list

Supported Model (Based on SONiC.Edgecore-SONiC 201911.2 2020 Aug version):  
AS7726-32X
AS7816-64X
AS7326-56X
AS5835-54X
AS8000
AS9716-32D
AS4630-54PE
Wedge100BF-32X*
AS5835-54T*
*Support planned for Q4, 2020

1. Edgecore SONiC Installation via TFTP/HTTP

Topology: Connect TFTP and/or HTTP server to switch management port

Caution: USB installation is only supported in firmware version SONiC.Edgecore-SONiC_20200722_070543_ec201911_141 and later. For older firmware version installation, please use TFTP/HTTP procedure below. In older firmware version, an known issue related to GRUB menu update will cause root file system crash (refer to PR #4443). 

Procedure:

Step 1. Enter the ONIE install mode

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

Step Ex. Stop the ONIE Service Discovery 

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

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

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

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

ONIE:/ # ifconfig eth0 192.168.1.2 netmask 255.255.255.0

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

ONIE:/ # onie-nos-install tftp://192.168.1.3/SONiC-OS-Edgecore-SONiC_20200103_052306_ec201904_108.bin

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)

2. Edgecore SONiC Installation via USB

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.

After finish the installation, user might need to check the following two articles.

1. Username and Password

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

3. Edgecore SONiC Upgrade

Procedure :

Step 0. Check the image

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

Step 1. 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/SONiC-OS-Edgecore-SONiC_20200116_051623_ec201904_128.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_20200103_052306_ec201904_108
Next: SONiC-OS-Edgecore-SONiC_20200116_051623_ec201904_128
Available:
SONiC-OS-Edgecore-SONiC_20200116_051623_ec201904_128
SONiC-OS-Edgecore-SONiC_20200103_052306_ec201904_108

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_20200116_051623_ec201904_128
Next: SONiC-OS-Edgecore-SONiC_20200116_051623_ec201904_128
Available:
SONiC-OS-Edgecore-SONiC_20200116_051623_ec201904_128
SONiC-OS-Edgecore-SONiC_20200103_052306_ec201904_108

4. Change default boot-up image 

Procedure :

Step 0. Check the images status

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

Step 1. Change the default boot-up image

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

Step 2. Check the image status

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

Then the "Next" boot-up image changed.

Extra: Choose the boot-up image in GRUB menu

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

5. Remove installed SONiC image from SONiC installer list

Procedure :
Step 0. Check the images status

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

Step 1. Remove the image

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

Step 2. Check the images status

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