SONiC Installer

This is a command line tool available as part of the SONiC software. If the device is already running the SONiC software, this tool can be used to install an alternate image in the partition. This tool has the facility to install an alternate image, list the available images and to set the next reboot image.

sonic-installer install

This command is used to install a new image on the alternate image partition. This command takes a path to an installable SONiC image or URL and installs the image.

Usage:sonic-installer install

Example:

admin@sonic:~$ scp servername@ipaddress:/image-file (To copy image file)

admin@sonic:~$ sonic-installer install filename.bin

New image will be installed, continue? [y/N]:y

sonic-installer list

This command displays information about currently installed images, currently running image and image set to be loaded in next reboot.

Usage:
sonic-installer list

Example:

admin@sonic:~$ sonic-installer list 
Current: SONiC-OS-HEAD.XXXX
Next: SONiC-OS-HEAD.XXXX
Available: 
SONiC-OS-HEAD.XXXX
SONiC-OS-HEAD.YYYY

sonic-installer set_default

This command is be used to change the image which can be loaded by default in all the subsequent reboots.

Usage:
sonic-installer set_default <image_name>

Example:

admin@sonic:~$ sonic-installer set_default SONiC-OS-HEAD.XXXX

sonic-installer set_next_boot

This command is used to change the image that can be loaded in the next reboot only. Note that it will fallback to current image in all other subsequent reboots after the next reboot.

Usage:
sonic-installer set_next_boot <image_name>

Example:

admin@sonic:~$ sonic-installer set_next_boot SONiC-OS-HEAD.XXXX

sonic-installer remove

This command is used to remove the unused SONiC image from the disk. Note that it's not allowed to remove currently running image.

Usage:
sonic-installer remove <image_name>

Example:

admin@sonic:~$ sonic-installer remove SONiC-OS-HEAD.YYYY

Image will be removed, continue? [y/N]: y