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
Sample Output
bti7800# system upgrade remote-url ftp://user@172.25.5.100/sw/bti7800-sys-1.6.0-14211.x86_64.rpmValue for 'password' (<string>): ******** bti7800# system upgrade download bti7800# show system upgrade Current Status : download-success bti7800# system upgrade commit CAUTION: Would you like to Proceed? [no,yes] yes
For more information on performing software upgrades, see the BTI7800 Series Software Configuration Guide.
