upgrade as
Function
The upgrade as name command upgrades an AS with a specified name.
The upgrade as name-include command upgrades ASs of which the name contains a specified string.
The upgrade as type command upgrades ASs of a specified type.
The upgrade as all command upgrades all ASs.
undo upgrade as command rolls back ASs to the previous version.
This command can only be executed on a parent switch.
Format
upgrade as name as-name [ reload [ at time ] ]
upgrade as name-include string [ reload [ at time ] ]
upgrade as type as-type [ reload [ at time ] ]
upgrade as all [ reload [ at time ] ]
undo upgrade as { all | name as-name | name-include string | type as-type }
Parameters
| Parameter | Description | Value |
|---|---|---|
| as-name | Upgrades an AS with a specified name. |
The value must have an existing AS name. |
| string | Upgrades all the ASs of which the name contains a specified string. |
The value is a string of 1 to 31 case-insensitive characters without spaces. |
| as-type | Upgrades ASs of a specified type. |
The value is an enumerated type. You can enter a question mark (?) and select a value from the displayed value range. |
| reload | Configures an AS to restart after upgrade files are downloaded. |
- |
| at time | Specifies the AS restart time. If reload is specified but time is not specified, an AS restarts immediately after loading files. If time is specified, the AS restarts at the specified time. |
The value is a string of characters in the HH:MM format, where HH:MM indicates the hour and minute. HH ranges from 0 to 23, and MM ranges from 0 to 59. |
Usage Guidelines
Usage Scenario
You can run the upgrade as command to upgrade online ASs. You can upgrade one AS, ASs of a specified type, or all ASs.
After performing upgrade configuration on an AS, the patch and system software files for the next startup will be the specified ones. You can run the undo upgrade as command to cancel the configuration as long as the AS is not restarted. After this command is executed, the patch and system software files for the next startup are consistent with the currently running ones. If the patch has taken effect after upgrade configuration is performed, the patch cannot be rolled back to the previous version.
Precautions
The patch and system software files used to upgrade ASs are specified in the as type command. If no system software file is not specified using the as type command, an AS automatically uses the system software of the same version as the parent during an upgrade. If the system software of the same version as the parent does not exist, the AS continues to use the previous system software.
- The upgrade as command cannot upgrade an AS if the software file name or patch file name specified in the as type command is the same as the current or next startup software file name or patch file name of the AS.
- The upgrade as command cannot upgrade an AS if the software file name specified in the as type command does not exist.
- When you upgrade an AS using the upgrade as command
without specifying reload:
- If you specify patch patch but not system-software system-software in the as type command, the patch file is activated online immediately.
- If you specify both patch patch and system-software system-software in the as type command and the specified system software file version is the version running on the AS, the patch file is activated online immediately.
- If you specify both patchpatch and system-softwaresystem-software in the as type command and the specified system software file version is earlier or later than the version running on the AS, the specified system software file and patch file will be set as next startup files.