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

Pre-requisites:

1. Make sure the Switch/ASIC Model is running a supported released version of ACS SONiC
2. Contact the Aviz Networks Support Team to get the latest image for the specific Switch/ASIC model
3. Make sure the switch management port is connected and configured to the network
4. Upload/Copy the appropriate ACS SONiC bin file to the source location, which is either
   • SCP server
   • TFTP Server
   • HTTP Server
   • USB drive

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.