Installation & Upgrades or Downgrades

This page describes how to install and upgrade SONiC images.

Example model & SONiC version:

  • Aurora 615/715
  • Netberg SONiC: sonic-202012-nb-inno-211121

Note:

  • Please use the image provided.

Install SONiC over the network

Procedure:

Step 1. Enter the ONIE install OS mode

Note: Switch will automatically enter the ONIE install mode if there’s no NOS installed.

                          GNU GRUB  version 2.02
  +----------------------------------------------------------------------------+
 |*ONIE: Install OS    <----- Select this one                                 | 
 | ONIE: Rescue                                                               |
 | ONIE: Uninstall OS                                                         |
 | ONIE: Update ONIE                                                          |
 | ONIE: Embed ONIE                                                           |
 +----------------------------------------------------------------------------+

      Use the ^ and v keys 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.               

ONIE Service Discovery will immediately start working. If the automated deployment is not set up, then a user can stop the messages using this command:

ONIE:/ # onie-stop
discover: installer mode detected.
Stopping: discover... done.

Step 2. Install the image from the remote URL

We assume you have uploaded SONiC image onto a http server (192.168.0.4).

ONIE:/ # onie-nos-install http://192.168.0.4/sonic-202012-nb-inno-211121.bin

When NOS installation finishes, the box will reboot into SONiC by default.

 

Netberg SONiC console port settings

Default console port settings are 115200-8-n-1-n.

 

User management

The default credential for login is admin/YourPaSsWoRd.

There is no separate CLI for adding users and for changing passwords. Users shall use the linux commands “useradd” command to add new users. Users shall use the linux command “passwd ” to change the password for the specific username.

 

Netberg SONiC Upgrade or Downgrade

1. Check the image

root@sonic:/home/admin# sonic-installer list
Current: SONiC-OS-202012-nb-inno.0-25af05a8
Next: SONiC-OS-202012-nb-inno.0-25af05a8
Available:
SONiC-OS-202012-nb-inno.0-25af05a8

2. Install an image from remote HTTP server

root@sonic:/home/admin# sonic-installer install http://192.168.0.4:8000/sonic-sonic-master-nb-inno-210811.bin
New image will be installed, continue? [y/N]: y
Downloading image...
Downloading image...
...99%, 977 MB, 10653 KB/s, 0 seconds left...
Installing image SONiC-OS-master-nb-inno.0-2d2d4bce and setting it as default...
Command: bash /tmp/sonic_image
Verifying image checksum ... OK.
Preparing image archive ... OK.
Installing SONiC in SONiC
ONIE Installer: platform: x86_64-innovium-r0
onie_platform: x86_64-netberg_aurora_715-r0
Installing SONiC to /host/image-master-nb-inno.0-2d2d4bce
Archive:  fs.zip
   creating: /host/image-master-nb-inno.0-2d2d4bce/boot/
  inflating: /host/image-master-nb-inno.0-2d2d4bce/boot/initrd.img-4.19.0-12-2-amd64
  inflating: /host/image-master-nb-inno.0-2d2d4bce/boot/config-4.19.0-12-2-amd64
  inflating: /host/image-master-nb-inno.0-2d2d4bce/boot/System.map-4.19.0-12-2-amd64
  inflating: /host/image-master-nb-inno.0-2d2d4bce/boot/vmlinuz-4.19.0-12-2-amd64
   creating: /host/image-master-nb-inno.0-2d2d4bce/platform/
   creating: /host/image-master-nb-inno.0-2d2d4bce/platform/x86_64-grub/
  inflating: /host/image-master-nb-inno.0-2d2d4bce/platform/x86_64-grub/grub-pc-bin_2.02+dfsg1-20+deb10u4_amd64.deb
   creating: /host/image-master-nb-inno.0-2d2d4bce/platform/x86_64-cel_midstone-r0/
  inflating: /host/image-master-nb-inno.0-2d2d4bce/platform/x86_64-cel_midstone-r0/platform-modules-midstone-200i_0.2.2_amd64.deb
   creating: /host/image-master-nb-inno.0-2d2d4bce/platform/x86_64-netberg_aurora_615-r0/
  inflating: /host/image-master-nb-inno.0-2d2d4bce/platform/x86_64-netberg_aurora_615-r0/sonic-platform-netberg-aurora-615_1.0.0_amd64.deb
   creating: /host/image-master-nb-inno.0-2d2d4bce/platform/x86_64-netberg_aurora_715-r0/
  inflating: /host/image-master-nb-inno.0-2d2d4bce/platform/x86_64-netberg_aurora_715-r0/sonic-platform-netberg-aurora-715_1.0.0_amd64.deb
   creating: /host/image-master-nb-inno.0-2d2d4bce/platform/x86_64-delta_et-c032if-r0/
  inflating: /host/image-master-nb-inno.0-2d2d4bce/platform/x86_64-delta_et-c032if-r0/platform-modules-et-c032if_1.1_amd64.deb
 extracting: /host/image-master-nb-inno.0-2d2d4bce/platform/firsttime
 extracting: /host/image-master-nb-inno.0-2d2d4bce/fs.squashfs
Switch CPU vendor is: GenuineIntel
Switch CPU cstates are: disabled
Installed SONiC base image SONiC-OS successfully

Command: grub-set-default --boot-directory=/host 0

Command: config-setup backup
Taking backup of curent configuration

Command: mkdir -p /tmp/image-master-nb-inno.0-2d2d4bce-fs
Command: mount -t squashfs /host/image-master-nb-inno.0-2d2d4bce/fs.squashfs /tmp/image-master-nb-inno.0-2d2d4bce-fs
Command: sonic-cfggen -d -y /tmp/image-master-nb-inno.0-2d2d4bce-fs/etc/sonic/sonic_version.yml -t /tmp/image-master-nb-inno.0-2d2d4bce-fs/usr/share/sonic/templates/sonic-environment.j2
Command: umount -rf /tmp/image-master-nb-inno.0-2d2d4bce-fs
Command: rm -rf /tmp/image-master-nb-inno.0-2d2d4bce-fs
Command: sync;sync;sync

Command: sleep 3

Done

3. Check the images

# sonic-installer list
Current: SONiC-OS-202012-nb-inno.0-25af05a8
Next: SONiC-OS-master-nb-inno.0-2d2d4bce
Available:
SONiC-OS-master-nb-inno.0-2d2d4bce
SONiC-OS-202012-nb-inno.0-25af05a8 

Note: This command displays information about currently installed images. It displays a list of installed images, currently running image and image set to be loaded in next reboot.

4. Reboot device

admin@sonic:~$ sudo reboot

5. Check the images

# sonic-installer list
Current: SONiC-OS-master-nb-inno.0-2d2d4bce
Next: SONiC-OS-master-nb-inno.0-2d2d4bce
Available:
SONiC-OS-master-nb-inno.0-2d2d4bce
SONiC-OS-202012-nb-inno.0-25af05a8 

Specify the default image

1. Check the images

# sonic-installer list
Current: SONiC-OS-master-nb-inno.0-2d2d4bce
Next: SONiC-OS-master-nb-inno.0-2d2d4bce
Available:
SONiC-OS-master-nb-inno.0-2d2d4bce
SONiC-OS-202012-nb-inno.0-25af05a8

Note:

  • “Current” image, it mean the running image
  • “Next” image, it mean the next boot up image.
  • “Available” images, it mean installed SONiC images.

2. Set the default boot-up image

# sonic-installer set-default SONiC-OS-202012-nb-inno.0-25af05a8
Command: grub-set-default --boot-directory=/host 1

3. Check the image status

# sonic-installer list
Current: SONiC-OS-master-nb-inno.0-2d2d4bce
Next: SONiC-OS-202012-nb-inno.0-25af05a8
Available:
SONiC-OS-master-nb-inno.0-2d2d4bce
SONiC-OS-202012-nb-inno.0-25af05a8

 

Remove installed image

1. Check the images

# sonic-installer list
Current: SONiC-OS-202012-nb-inno.0-25af05a8
Next: SONiC-OS-202012-nb-inno.0-25af05a8
Available:
SONiC-OS-master-nb-inno.0-2d2d4bce
SONiC-OS-202012-nb-inno.0-25af05a8

2. Remove the image

# sonic-installer remove SONiC-OS-master-nb-inno.0-2d2d4bce
Image will be removed, continue? [y/N]: y
Updating GRUB...
Done
Removing image root filesystem...
Done
Command: grub-set-default --boot-directory=/host 0

Image removed

3. Check the images

root@sonic:/home/admin# sonic-installer list
Current: SONiC-OS-202012-nb-inno.0-25af05a8
Next: SONiC-OS-202012-nb-inno.0-25af05a8
Available:
SONiC-OS-202012-nb-inno.0-25af05a8
NEWS

Latest news