Edgecore SONiC Installation & Upgrade

Example: ecSONiC installation 

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 (TFTP/HTTP) :

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 install 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

Procedure (USB) :

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

Example: ecSONiC 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

Example: Change the default boot-up image

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.

Example: Remove the image

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