system service update

Updates the service to a different version with minimal downtime.

Syntax

system firmware update FLASH-FILE

system firmware update USB-FILE

system firmware update SCP-FILE

system firmware update SFTP-FILE

system firmware update HTTP-FILE

system firmware update HTTPS-FILE

Parameters

FLASH-FILE: Specifies the flash file path in format flash://ms-images/filename.
USB-FILE: Specifies the USB file path in format usb://filename.
SCP-FILE: Specifies the SCP file path in format scp://username:password@host[:port]/filepath.
SFTP-FILE: Specifies the SFTP file path in format sftp://username:password@host[:port]/filepath.
HTTP-FILE: Specifies the HTTP file path in format http://[username:password@]host[:port]/filepath.
HTTPS-FILE: Specifies the HTTPS file path in format https://[username:password@]host[:port]/filepath.
username: Account name of the authorized user.
password: Password of the authorized user.
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.
hostname: Specifies the server by name or IP address (IPv4/IPv6). Only valid unicast IP addresses are supported, multicast IP addresses are not supported.; Hostname usage requires that DNS resolution is configured on the device.
port: Specifies the port number, which must be preceded by a colon. If the port is not included, the default port is assumed.
filepath: Specifies the path to the file.

Modes

Exec mode

Usage Guidelines

Service images are tar.gz files with the version format, major.minor.patch.

Validations for the command are as follows:

This command is available only to users with admin role.
The target destination must be valid and reachable.
The major.minor version numbers must be identical between the current and new images.

Examples

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