system firmware update

Updates the system firmware.

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://firmware/filename.
USB-FILE
Specifies the USB file path in format usb://file-name.
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

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. Both IPv4 and IPv6 are 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

This command is available only to users with the admin role.

Host IP must be in the format of a valid IPv4 or IPv6 address.

Firmware images are .bin files with the version format, YearBorn.Major.Minor.Patch.

There is no auto-commit after firmware update.
  • After the firmware update, use the system firmware commit command to commit the new firmware version.
  • Use the system firmware rollback command to remove the new image from the device.

Examples

The following examples update the system firmware.

device# system firmware update system firmware update flash://firmware/TierraOS-21.1.1.0-NPB.bin

device# system firmware update usb://TierraOS-21.1.1.0-NPB.bin

device# system firmware update http://1.1.1.1:8000/path/TierraOS-21.1.0.0-NPB.bin

device# system firmware update scp://test:pass@1.1.1.1/path/TierraOS-21.1.0.0-NPB.bin 

device# system firmware update sftp://test:pass@1.1.1.1/path/TierraOS-21.1.0.0-NPB.bin