Install SONiC on NPU

This section describes outlines the steps to install ONIE on your router under for the following scenarios:

  • Initial Installation: Installing SONiC for the first time.
  • Day 0 Activities: Setting up during initial deployment.
  • Major Version Updates: Upgrading to a new major version of SONiC.

For upgrading the SONiC image for minor updates, see Upgrade SONiC Image. Ensure to download the SONiC image (sonic-cisco-8000.bin) from the Cisco Software Download center.

Perform these steps to install Sonic on NPU for the first time.

  1. Download the SONiC image (sonic-cisco-8000.bin) from the Cisco Software Download center.

  2. Execute the sudo su command to obtain root privileges.

admin@sonic:~$sudo su
  1. Copy the downloaded SONiC install image to the router.

You can either copy it to the local folder in the router or to the network location.

root@sonic:~$scp user@<ip-address>:/<image_path>/sonic-cisco-8000.bin /tmp
  1. Reboot the router using the reboot command.
root@sonic:~$reboot
  1. Select ONIE from the GRUB menu and then Select ONIE: Rescue.
ONIE Install
  • Now the system should be in ONIE prompt and the router image is also in a place accessible from this location.
  1. Install the SONiC image using the onie-nos-install command.
ONIE#onie-nos-install http://10.2.15.6/<path>/sonic-cisco-8000.bin

Note:

  • Wait for the image to load completely and for all containers to start.
  • Do not perform any operations until all containers are up and the system uptime is at least 7 minutes.

  1. After the SONiC image is installed, the route processor reloads and boots up with the SONiC OS.

  2. Enter the default credentials at the SONiC login prompt.

sonic login: admin
Password:
Last login: Fri June 3 18:52:14 UTC 2020 on ttyS0
Linux sonic 4.19.0-9-cisco-amd64 #1 SMP Debian 4.19.118-2+deb10u1 (2022-06-03) x86_64
You are on
____   ___  _   _ _  ____
/ ___| / _ \| \ | (_)/ ___|
\___ \| | | | \|  | | |
___) | |_| | |\  | | | ___
____/ \___/|_| \_|_|\____|

--- Software for Open Networking in the Cloud ---
Unauthorized access and/or use are prohibited.
All access and/or use are subject to monitoring.
Help: http://azure.github.io/SONiC/
  1. View the software version, and the list of docker images loaded on the router.
admin@sonic:~$show version
SONiC Software Version: SONiC.cisco_202012.0-8dbd003f
Distribution: Debian 9.13
Kernel: 4.19.0-9-cisco-amd64
Build commit: 8dbd003f
Build date: Fri June 3 07:37:25 UTC 2020
Built by: user@host
Platform: x86_64-8201_sys-r0
HwSKU: 36x100Gb
ASIC: cisco-8000
Serial Number: FOC2219HITI
Cisco Silicon One SDK: 1.33.1-SDK-1.5.2-13-g843fbac-sonic-1.33.1-sai152-dec9-651-1
Cisco Whitebox BSP: 0.1.11-29-gb022f2d
Cisco Whitebox FPD: 0.1-22-gfbde9e1
Cisco NP Suite: None
Uptime: 19:16:08 up 7 min, 1 user, load average: 4.48, 3.12, 1.50
Docker images:
REPOSITORY                  TAG                              IMAGE ID                SIZE
docker-saiserver            cisco_202012.0-8dbd003f          d53de4f53fb3            951MB
docker-saiserver            latest                           d53de4f53fb3            951MB
docker-syncd                cisco_202012.0-8dbd003f          67d9c3e6ee6a            719MB
docker-syncd                latest                           67d9c3e6ee6a            719MB
docker-sonic-telemetry      cisco_202012.0-8dbd003f          177aadb68a43            353MB
docker-sonic-telemetry      latest                           177aadb68a43            353MB
docker-router-advertiser    cisco_202012.0-8dbd003f          38379913e9fb            290MB
docker-router-advertiser    latest                           38379913e9fb            290MB
docker-sonic-mgmt-framework cisco_202012.0-8dbd003f          b1dc56ba080a            428MB
docker-sonic-mgmt-framework latest                           b1dc56ba080a            428MB
docker-platform-monitor     cisco_202012.0-8dbd003f          3509321ea1ee            369MB
docker-platform-monitor     latest                           3509321ea1ee            369MB
docker-lldp-sv2             cisco_202012.0-8dbd003f          e97b462e462b            312MB
docker-lldp-sv2             latest                           e97b462e462b            312MB
docker-fpm-frr              cisco_202012.0-8dbd003f          670471b0e015            335MB
docker-fpm-frr              latest                           670471b0e015            335MB
docker-sflow                cisco_202012.0-8dbd003f          fe7fb968d68d            315MB
docker-sflow                latest                           fe7fb968d68d            315MB
docker-dhcp-relay           cisco_202012.0-8dbd003f          1ac3c7600354            300MB
docker-dhcp-relay           latest                           1ac3c7600354            300MB
docker-database             cisco_202012.0-8dbd003f          9aed1565ac96            290MB
docker-database             latest                           9aed1565ac96            290MB
docker-orchagent            cisco_202012.0-8dbd003f          fcdffb142dbb            346MB
docker-orchagent            latest                           fcdffb142dbb            346MB
docker-teamd                cisco_202012.0-8dbd003f          2c007b95b38f            315MB
docker-teamd                latest                           2c007b95b38f            315MB
docker-nat                  cisco_202012.0-8dbd003f          5e9cd32094fa            316MB
docker-nat                  latest                           5e9cd32094fa            316MB
docker-snmp-sv2             cisco_202012.0-8dbd003f          64357fe71751            348MB
docker-snmp-sv2             latest                           64357fe71751            348MB