Updates the service to a different version with minimal downtime.
Note
As a best practice, do not list the password in the command line for security purposes. The user will be prompted for the password.Exec mode
Service images are tar.gz files with the version format, major.minor.patch.
Validations for the command are as follows:
The following example updates system service.
device# system service update flash://ms-images/chassis-mgr_1.1.0.tar.gz device# system service update usb://chassis-mgr_1.1.0.tar.gz device# system service update scp://test:pass@1.1.1.1/home/test/chassis-ms.tar.gz device# system service update sftp://test:pass@1.1.1.1/home/test/ifmgr-ms.tar.gz device# system service update http://1.1.1.1:8000/home/test/pktmgr-ms.tar.gz
The following examples show error messages for system service update.
Invalid URL format:
device# system service update temp.tar.gz
temp.tar.gz is not a valid URL format
Usage:
usb://<filename>
flash://ms-images/<filename> for service update
scp://<username>:<password>@<host>[:port]/<filepath>
sftp://<username>:<password>@<host>[:port]/<filepath>
http://[username:password@]<host>[:port]/<filepath>
https://[username:password@]<host>[:port]/<filepath>
Invalid host name or IP:
device# system service update http://test.example.com:8000/home/test/chassis-ms.tar.gz
Error: No such host test.example.com
device# system service update http://1.1.1.1:8081/home/test/pktmgr-ms.tar.gz
Error: Host IP not reachable
Invalid credentials:
device# system service update scp://test:test@1.1.1.1/home/test/chassis-ms.tar.gz
Error: Invalid user credentials
Invalid file type:
device# system service update scp://test:test@1.1.1.1/home/test/abc.txt
Error: File abc.txt is not the correct format for service images
Service version is already running:
device# system service update http://1.1.1.1:8000/home/test/chassis-ms.tar.gz
Service update failed. Current Version: 1.0.0, Error: Current version is already running
Major and minor versions mismatch between the current and new image:
device# system service update http://1.1.1.1:8000/home/test/chassis-ms.tar.gz
Service update failed. Major/Minor version mismatch. Current version: 1.0.0, New version: 1.1.0
Invalid firmware directory:
device# system service update flash://firmware/chassis-mgr_1.1.0.tar.gz
Firmware files should be in firmware directory and Microservices in ms-images directory
Invalid file:
device# system service update flash://ms-images/chassis-mgr_1.1.0.tar.gz
File flash://ms-images/chassis-mgr_1.1.0.tar.gz does not exist
USB not enabled:
device# system service update usb://chassis-mgr_1.1.0.tar.gz
Error: USB not enabled