Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

system upgrade

 

Syntax

Release Information

This command was introduced prior to release 2.1.1.

Starting with release 4.2, the system automatically retries the system upgrade commit command if the initial commit fails.

Starting with release 4.3, you can issue this command with the provisioning privilege. In releases lower than release 4.3, you must have superuser privileges to issue this command.

Description

This command performs operations related to system software upgrades.

Options

Parameter

Description

Range

Default Value

cancel

Cancels a software download if one is in progress.

commit

Loads the new software on all modules.

Software-based features on the service module (such as PM collection, APSD, APR, FPSD) are disabled temporarily until the module boots back up.

Note: Starting with release 4.2, the system automatically retries the commit if the initial commit fails.

download

Downloads the new software package from the remote-url to local storage.

The new software package must be in an RPM format.

firmware options

Upgrades the firmware on a specified module. See system upgrade firmware.

remote-url protocol:url

The remote location where you want to copy the system log file(s).

sftp|ftp://
[username@]host
[:port]/filename

username is the username to use on the remote server.

host is the host name or IP address of the remote server.

port is the protocol port number to use.

filename is the filepath and filename of the software package. The file must be an RPM file.

If username is not specified, the current CLI session’s login name is used.

If port is not specified, the standard default FTP or SFTP port is used.

password password

The password associated with the specified username.

If a password is not specified, the system prompts you for a password.

Note: The password must contain alphanumeric characters only.

A character string

None

rollback

Rolls back to the software and configuration in effect on all modules immediately prior to the upgrade. This command is service affecting.

Software-based features on the service module (such as PM collection, APSD, APR, FPSD) are disabled temporarily until the module boots back up.

Note: You might need to perform a cold reboot of all modules after rolling back. For more information, see the BTI7800 Series Software Configuration Guide.

Required Privilege Level

Related Documentation

Sample Output

bti7800# system upgrade remote-url ftp://user@172.25.5.100/sw/bti7800-sys-1.6.0-14211.x86_64.rpm

For more information on performing software upgrades, see the BTI7800 Series Software Configuration Guide.