system service update
Updates the service to a different
version with minimal downtime.
Syntax
system service update
FLASH-FILE
system
service update
USB-FILE
system
service update
SCP-FILE
system
service update
SFTP-FILE
system
service update
HTTP-FILE
system
service 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.
- hostname
- Specifies the server by name or IP address
(IPv4 or 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.
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 the 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-mgr_1.1.0.tar.gz
device# system service update sftp://test:pass@1.1.1.1/home/test/interface_mgr_1.1.0.tar.gz
device# system service update http://1.1.1.1:8000/home/test/packet-mgr_1.1.0.tar.gz
