OcNOS-SP : NetConf User Guide : Sys-Update using NetConf
Sys-Update using NetConf
This chapter contains examples of carrying out Sys-update using NetConf.
The system update feature provides the user with the option to upgrade or downgrade the OcNOS image in a router. A router's software can be upgraded when a new feature is introduced or when software bugs are fixed.
NetConf provides the user with the following options for sys-update:
1. Download the image and install.
2. To delete the downloaded image.
3. To cancel the image download which is in progress.
Download the Image and Install
On the Switch:
Connect to yangcli and proceed as shown below:
 
yangcli ocnos@127.1> sys-update-get url=http://10.12.40.120/jenkins-archives-3/onie/installer/OCNOS-1-3-6/EC_AS7326_56X/OCNOS_DC_IPBASE/OcNOS-1.3.6.241a-DC_IPBASE/EC_AS7326_56X-OcNOS-1.3.6.241a-DC_IPBASE-S0-P0-installer
Download the OcNOS image. After the command, wait for some time for the image to download. Same can be verified through CLI “show installers” (Refer to validation logs)
yangcli ocnos@127.1> sys-update-install installerName=EC_AS7326_56X-OcNOS-1.3.6.241a-DC_IPBASE-S0-P0-installer
Install the downloaded image.
 
Note: The sys-update-get CLI is updated with known-hosts-add parameter too support SCP and SFTP. Use the sys-update-get known-hosts-add=true CLI to download the OcNOS image file via SCP/SFTP.

When known-host-add parameter is given as true then the IP address/hostname is added into known_hosts file and proceed to sys-update.

If known-host-add parameter is not given and IP address/hostname is not present in the known_hosts file then sys-update-get via SCP/SFTP throws an error message
'%% Download failed, SSL peer certificate or SSH remote key was not OK'.
Validation
Show installer output while image download is in progress:
tmp string is used before the image name to represent download is in progress
 
#show installers
/installers/tmp_EC_AS7326_56X-OcNOS-1.3.6.241a-DC_IPBASE-S0-P0-installer
#
 
Show installer output after completion of image download:
#show installers
/installers/EC_AS7326_56X-OcNOS-1.3.6.241a-DC_IPBASE-S0-P0-installer
To Delete the Downloaded Image
On the Switch:
Connect to yangcli and proceed as shown below:
 
yangcli ocnos@127.1> sys-update-get url=http://10.12.40.120/jenkins-archives-3/onie/installer/OCNOS-1-3-6/EC_AS7326_56X/OCNOS_DC_IPBASE/OcNOS-1.3.6.241a-DC_IPBASE/EC_AS7326_56X-OcNOS-1.3.6.241a-DC_IPBASE-S0-P0-installer
Download the OcNOS image. After the command wait for some time for the image to get downloaded. Same can be verified through CLI “Show installers” (Refer to validation logs)
yangcli ocnos@127.1> sys-update-delete imageName=EC_AS7326_56X-OcNOS-1.3.6.241a-DC_IPBASE-S0-P0-installer
Delete the downloaded image.
Validation
Show installer output after completion of image download:
#show installers
/installers/EC_AS7326_56X-OcNOS-1.3.6.241a-DC_IPBASE-S0-P0-installer
Show installer output after deleting downloaded image:
#show installers
#
To Cancel the Image Download:
On the Switch:
Connect to yangcli and proceed as shown below:
yangcli ocnos@127.1> sys-update-get url=http://10.12.40.120/jenkins-archives-3/onie/installer/OCNOS-1-3-6/EC_AS7326_56X/OCNOS_DC_IPBASE/OcNOS-1.3.6.241a-DC_IPBASE/EC_AS7326_56X-OcNOS-1.3.6.241a-DC_IPBASE-S0-P0-installer
To download the OcNOS image.
yangcli ocnos@127.1> sys-update-cancel-download
Cancel the download.
Validation
Show installer output while image download is in progress:
tmp string is used before the image name to represent download is in progress
#show installers
/installers/tmp_EC_AS7326_56X-OcNOS-1.3.6.241a-DC_IPBASE-S0-P0-installer
#
Show installer output after canceling of download:
#show installers
#