startup system-software
Format
startup system-software system-file [ all | slave-board | slot slot-id ]
Devices that do not support the stack function or do not have the stack function enabled do not support the all, slave-board, or slot slot-id parameters.
Parameters
| Parameter | Description | Value |
|---|---|---|
system-file |
Specifies the name of the system software file. |
The value is a string of 4 to 64 case-insensitive characters without spaces and %. It is in the format of [ drive-name ] [ file-name ]. If drive-name is not specified, the name of the default storage device is used. |
all |
Specifies all member devices in a stack. |
- |
slave-board |
Specifies the system software for next startup on the slave switch. |
- |
slot slot-id |
Specifies a member device in a stack. |
The value is an integer. The range of the integer is dependent on the specific device. |
Usage Guidelines
Usage Scenario
In system software upgrade or downgrade, run this command to specify the system software for next startup.
Follow-up Procedure
Run the reboot or the schedule reboot command to restart the device.
Precautions
- If the system software to be specified is V200R010 or an earlier version, you need to restore the default BootROM password; otherwise, the downgrade may fail. When the startup system-software command is run, the system displays a prompt and the current password is cleared only after the user confirms the operation.
- Some S5720-HI switches running V200R008 and later versions cannot be downgraded to V200R007C00SPC500.
- The system software package must use .cc as the file name extension and be saved to the root directory of the storage device.
- When the system software for next startup is configured using the startup system-software command, the system checks the system software integrity. If the digital signature of the system software is invalid, the configuration fails. Therefore, ensure the system software validity.
- If the upgrade or downgrade cannot be performed between versions, the system displays a message, prompting you to perform operations as prompted.
- The system automatically upgrades the BootROM after you run the startup system-software command to specify the system software for next startup.
- The display cli command-tree command output shows that the chassis parameter is registered on the device. Fixed devices do not support this parameter.
- During system software upgrade of fixed PoE switches, powered devices (PDs) will be powered off.
The system file is authenticated when you configure the file name of the system software used in the next startup. Wait for a while.
Table 1 lists the possible causes and troubleshooting methods for failures to load the system software package to the device.
Failure Cause |
Troubleshooting Method |
|
|---|---|---|
CRC check fails. |
The system software package is damaged. Please upload again. |
Upload the system software package again. |
Version check fails. |
The %s only supports the system software package of %s and later versions. |
Upload the system software package of the version supported by the device. |
Signature verification fails. |
Software package verification failed. Please upload again. |
Upload the system software package again. |
The system software package is corrupted. |
The system software package is damaged. Please upload again. |
Upload the system software package again. |
The system software package is not supported on the device. |
The system software package does not match the device. |
Upload the system software package that matches the device. |
The name of the system software package is incorrect. |
The system software package does not exist. |
Change the name of the system software package and upload the package again. |
The name of the system software package is too long. |
The file name is too long. |
Change the name of the system software package and upload the package again. |
Stacking is not supported. |
The target version does not support CSS card stacking. Disable this stacking function and try later. |
Disable the stacking function and upload the system software package again. |
The system software package does not match the MPU. |
The system software package does not include the MPU software package. |
Upload the system software package that matches the MPU. |
Failed to set the system software package. |
Failed in setting the software for booting system. |
Check whether the system software package matches the device type. |
The directory where the system software package is uploaded is incorrect. |
The file flash:/%.cc doesn't exist in the main board. (Default directory is flash:/) |
Upload the system software package to the root directory of the flash memory. |