Skip to main content

How to install SONiC NOS on a switch using SCP, HTTP, TFTP, or USB methods?

  • Updated

Pre-requisites:

  1. Make sure the Switch/ASIC Model is running a supported released version of ACS SONiC
  2. Download the latest SONiC build from Aviz Certified Community SONiC
  3. Contact the Aviz Networks Support Team at support@aviznetworks.com for any assistance
  4. Make sure the switch management port is connected and configured to the network
  5. Upload/Copy the appropriate ACS SONiC bin file to the source location, which is either

mceclip0.png

Upgrade Procedure:

To install SONiC on a supported switch, follow the steps below

  • Login into the switch using the console port and reboot the switch

  • Enter ONIE mode

                                GNU GRUB version 2.02

*********************************************************************************
*  SONiC-OS-2.1.1_RELEASE.0-dirtly-20220727.040334                              *
*  *ONIE*                                                                       *
*                                                                               *
*                                                                               *
*                                                                               *
*                                                                               *
*                                                                               *
*                                                                               *
*********************************************************************************

    Use the * and * kesy to select which entry is highlighted.
    Press enter to boot the selected OS, 'e' to edit the commands
    before booting or 'c' for a command-line

  • Select 'ONIE: Uninstall OS' to clean up any installed image

                                GNU GRUB version 2.02

*********************************************************************************
*  SONiC-OS-2.1.1_RELEASE.0-dirtly-20220727.040334                              *
*  *ONIE*                                                                       *
*                                                                               *
*                                                                               *
*                                                                               *
*                                                                               *
*                                                                               *
*                                                                               *
*********************************************************************************

 
    Use the * and * kesy to select which entry is highlighted.
    Press enter to boot the selected OS, 'e' to edit the commands
    before booting or 'c' for a command-line

 

  • The switch will reboot and boot into 'ONIE: Install OS' mode, run the below command to stop auto-discovery

    ONIE:/ # onie-discovery-stop
Note: If above command doesn't work please try usig 'onie-stop'

 

  • Assign IP to 'eth0' for network reachability

    • Assign 'eth0' with a static mgmt-IP

      ONIE:/ # ifconfig eth0 <mgmt-ip> netmask <netmask> up
//Example - ifconfig eth0 10.4.4.72 netmask 255.255.254.0 up

      Note: DHCP IPs are auto-assigned and require no manual configuration

  • Verify the IP address on the interface's

    ONIE:/ # ip address

//Example - 
ONIE:/ # ip address
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue qlen 1
link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
inet 127.0.0.1/8 scope host lo
valid_lft forever preferred_lft forever
inet6 ::1/128 scope host
valid_lft forever preferred_lft forever
2: dummy0: <BROADCAST,NOARP> mtu 1500 qdisc noop qlen 1000
link/ether a6:ae:69:08:dc:70 brd ff:ff:ff:ff:ff:ff
3: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq qlen 1000
link/ether 04:3f:72:c4:1a:68 brd ff:ff:ff:ff:ff:ff
inet 10.4.4.72/23 brd 10.4.5.255 scope global eth0
valid_lft forever preferred_lft forever
inet6 fe80::63f:72ff:fec4:1a68/64 scope link
valid_lft forever preferred_lft forever
4: sit0@NONE: <NOARP> mtu 1480 qdisc noop qlen 1
link/sit 0.0.0.0 brd 0.0.0.0
5: ip6tnl0@NONE: <NOARP> mtu 1452 qdisc noop qlen 1
link/tunnel6 00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00 brd 00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00
ONIE:/ #

 

  •  Install image using SCP, TFTP or HTTP

    • Using SCP:

      • Copy the image from the SCP source/server to the switch, using the below command:

        ONIE:/ # scp <user>@<server-ip>:/<dir>/opb-nos.bin opbnos.bin
//Example - scp aviz@10.2.2.10:/images/opb/opb-nos.bin opbnos.bin

 

  •  Install the copied image, using the below command:

    ONIE:/ # onie-nos-install <image-name.bin>
//Example - onie-nos-install opbnos.bin

 

  • Using TFTP:

    • Start a TFTP server on a server where the ACS image is stored

    • on the switch console use the below command to start the installation process, the image will be downloaded and installed automatically from the TFTP server

      ONIE:/ # onie-nos-install tftp://<IP>/<opb-nos.bin>
//Example - onie-nos-install tftp://10.2.2.10/opb-nos-20220714.2.1.1.bin

 

  • Using HTTP:

    • Start an HTTP-server at the image directory on a Linux machine using the below command

      aviz@10.2.2.10:/images/opb$ python3 -m http.server 8030

    • on the switch console use the below command to start the installation process, the image will be downloaded and installed automatically from the Linux machine

      ONIE:/ # onie-nos-install http://<IP>:<port>/<opb-nos.bin>
//Example - onie-nos-install http://10.2.2.10:8030/opb-nos-20220714.2.1.1.bin

 

  • After successful installation, the device will reboot and boot up with Aviz Certified SONiC.

 

  • Install the Image using a USB drive:

    • Insert a FAT/FAT32 formatted USB with the ACS .bin file into the switch

    • Run 'fdisk -l' to determine the Linux device name of your USB, ignore the MMC drives, USB will show up as '/dev/sdb1'

      ONIE:/ # fdisk -l

    • Create a temporary directory for the installer

      ONIE:/ # mkdir /mnt/tempdisk

    • Mount the USB to the temporary directory, using the below command

      ONIE:/ # mount /dev/sdb1 /mnt/tempdisk

    • Use the below command to start the installation process

      ONIE:/ # onie-nos-install /mnt/tempdisk/<acs.bin>
//Example - ONIE:/ # onie-nos-install tempdisk/acs-20220714.2.1.1.bin
    • After successful installation, the device will reboot and boot up with SONiC NOS.

Related articles