Edgecore SONiC Installation & Upgrade

Example: ecSONiC installation 

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

Caution: Do not install from USB thumb drive. 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 install 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

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