Login
- Table of Contents
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 06-Software Upgrade Commands | 93.54 KB |
boot-loader
Use boot-loader to specify a startup system software image for the device.
Syntax
boot-loader file file-url
Views
User view
Default command level
3: Manage level
Parameters
file file-url: Specifies the file path, a string of 1 to 63 characters. If you enter a relative path, the system automatically converts it to an absolute path. The absolute path can contain up to 63 characters. The file name uses the drive:/file-name format or the file-name format, where:
· The drive argument specifies the storage medium where the file is saved. If the device has only one storage medium, you can omit the storage medium name. The storage medium of the master device is identified by the storage name, flash, for example.
· The file-name argument specifies the file name, which typically uses the .bin extension.
Usage guidelines
To execute the boot-loader command successfully, make sure you have saved the image file to the root directory of the storage medium on the device.
Examples
# Specify wa4600_fat.bin as the startup system software image file.
<Sysname> boot-loader file wa4600_fat.bin
This command will set the boot file. Continue? [Y/N]:y
The specified file will be used as the main boot file at the next reboot on slot 1!
display boot-loader
bootrom
Use bootrom to read or upgrade the Boot ROM image on a device.
Syntax
bootrom { read | update file file-url } [ all | part ]
Views
User view
Default command level
3: Manage level
Parameters
read: Backs up the Boot ROM image in the Normal area of a Boot ROM to Flash memory.
update file file-url: Loads a Boot ROM image in a storage medium to the Normal area of Boot ROM. The file-url argument specifies the image file path, a string of 1 to 63 characters. For more information about file path naming, see "boot-loader."
all: Applies the action to the entire Boot BOM image, including the basic section and the extended section. If neither all nor part is specified, the action applies to the entire Boot ROM image.
part: Applies the action to the extended Boot ROM image section.
Usage guidelines
To execute the bootrom command successfully, make sure you have saved the upgrade image file to the root directory of the storage medium on the device.
Examples
# Read the Boot ROM image.
<Sysname> bootrom read all
Now reading bootrom, please wait...
Read bootrom! Please wait...
Start reading basic bootrom!
Read basic bootrom completed!
Start reading extended bootrom!
Read extended bootrom completed!
Read bootrom completed! Please check the file!
display boot-loader
Use display boot-loader to display system software image information, including the current system software image and the startup system software images.
Syntax
display boot-loader [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
2: System level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
# Display system software images. (The command output varies with devices.)
<Sysname> display boot-loader
The current boot app is: flash:/wa4600_fat.bin
The app that will boot upon reboot is: flash:/wa4600_fat.bin
Table 1 Command output
|
Field |
Description |
|
The current boot app is |
System software image that has been loaded. |
|
The app that will boot upon reboot is |
System software image to be used at the next startup. |
Related commands
boot-loader
display patch
Use display patch to display patch files that have been installed.
If a patch file is loaded from a patch package file, this command also displays the package file version.
Syntax
display patch [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
3: Manage level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
# Display patch files that have been installed. (The command output varies with devices.)
<Sysname> display patch
flash:/patch_mpu.bin, loaded on slot(s):0
Table 2 Command output
|
Field |
Description |
|
flash:/patch_mpu.bin |
File directory. |
|
loaded on slot(s):0 |
Slot number of the card on which the patches have been loaded. The slot number is fixed at 0 for an AP. |
display patch information
Use display patch information to display hotfix information.
Syntax
display patch information [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
3: Manage level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
# Display hotfix information. (The command output varies with devices.)
<Sysname> display patch information
The location of patches: flash:
Slot Version Temporary Common Current Active Running Start-Address
----------------------------------------------------------------------
1 MPU 0 0 0 0 0 0x2528738
Table 3 Command output
|
Field |
Description |
|
The location of patches |
Patch file location. You can use the patch location command to change the location. |
|
Slot |
Meaningless. |
|
Version |
Patch version. |
|
Temporary |
Number of temporary patches. |
|
Common |
Number of common patches. |
|
Current |
Total number of patches. |
|
Running |
Number of patches in RUNNING state. |
|
Active |
Number of patches in ACTIVE state. |
|
Start-Address |
Start address of the patch memory area in the memory. |
patch active
Use patch active to activate patches.
Syntax
patch active [ patch-number ]
Views
System view
Default command level
3: Manage level
Parameters
patch-number: Specifies the sequence number of a patch. Values available for this argument depend on the patch file that has been loaded. If no sequence number is specified, this command validates all INACTIVE patches. If a sequence number is specified, this command activates the specified patch and all its previous INACTIVE patches.
Usage guidelines
Before executing this command, you must use the patch load command to load patches.
The patch active command changes the state of DEACTIVE patches to ACTIVE state and runs the patches. To continue to run these patches after a reboot, use the patch run command to change their state to RUNNING. If not, the state of ACTIVE patches changes back to DEACTIVE at a reboot.
Examples
# Activate patch 3 and all its previous DEACTIVE patches.
<Sysname> system-view
[Sysname] patch active 3
# Activate all DEACTIVE patches.
<Sysname> system-view
[Sysname] patch active
patch deactive
Use patch deactive to stop running patches.
Syntax
patch deactive [ patch-number ]
Views
System view
Default command level
3: Manage level
Parameters
patch-number: Specifies the sequence number of a patch. Values available for this argument depend on the patch file that has been loaded. If no sequence number is specified, this command deactivates all ACTIVE patches. If a sequence number is specified, this command deactivates the specified patch and all its subsequent ACTIVE patches.
Usage guidelines
This command is not applicable to patches in RUNNING state.
Examples
# Stop running patch 3 and all its subsequent ACTIVE patches.
<Sysname> system-view
[Sysname] patch deactive 3
# Stop running all ACTIVE patches.
<Sysname> system-view
[Sysname] patch deactive
patch delete
Use patch delete to remove patches from the patch memory area.
Syntax
patch delete [ patch-number ]
Views
System view
Default command level
3: Manage level
Parameters
patch-number: Specifies the sequence number of a patch. Values available for this argument depend on the patch file that has been loaded. If no sequence number is specified, this command removes all patches in the patch memory area. If a sequence number is specified, this command removes the specified patch and all its subsequent patches.
Usage guidelines
This command does not delete patches from the storage medium. After being removed from the patch memory area, the patches changes to the IDLE state.
Examples
# Remove patch 3 and all its subsequent patches from the patch memory area.
<Sysname> system-view
[Sysname] patch delete 3
# Remove all patches from the patch memory area.
<Sysname> system-view
[Sysname] patch delete
patch install
Use patch install to install and run patches in one step.
Use undo patch install to remove all ACTIVE and RUNNING patches from the patch memory area.
Syntax
patch install { patch-location | file filename }
undo patch install
Views
System view
Default command level
3: Manage level
Parameters
patch-location: Specifies the patch file path, a string of 1 to 64 characters. The file must be saved in the root directory of the storage medium. Provide this argument if the patch file is not packaged in a patch package file, and make sure the file name is correct.
file filename: Specifies a patch package file name.
Usage guidelines
Before installing patches, save the patch file or patch package file to the root directory of the Flash memory on the device.
The patch install command changes the state of installed patches from IDLE to ACTIVE or RUNNING, depending on your choice during the command execution process. If you choose to continue to run installed patches after a reboot, the installed patches are set in RUNNING state and remain in this state after a reboot. If not, the installed patches are set in ACTIVE state and change to the DEACTIVE state at a reboot.
The undo patch install command changes the state of ACTIVE and RUNNING patches to IDLE, but does not delete them from the storage medium.
If you execute the patch install patch-location command, the directory specified for the patch-location argument replaces the directory specified with the patch location command after the upgrade is complete.
Examples
# Install files from Flash memory.
<Sysname> system-view
[Sysname] patch-install flash:
Patches will be installed. Continue? [Y/N]:y
Do you want to run patches after reboot? [Y/N]:y
Installing patches…
Installation completed, and patches will continue to run after reboot.
[Sysname]
patch load
Use patch load to load patches from the Flash memory to the patch memory area.
Syntax
patch load [ file filename ]
Default
The system loads the patch file from the Flash memory.
Views
System view
Default command level
3: Manage level
Parameters
file filename: Specifies a patch package file name. If the package file is specified, the system loads patch files from the patch package. If no package file is specified, the system loads patch files from Flash memory.
Usage guidelines
Before loading patches, save the patch file or patch package file to the root directory of the Flash memory on the device.
Examples
# Load patches from patch files.
<Sysname> system-view
[Sysname] patch load
patch location
Use patch location to specify the patch file location.
Syntax
patch location patch-location
Default
The patch file location is flash:.
Views
System view
Default command level
3: Manage level
Parameters
patch-location: Specifies the patch file location, a string of 1 to 64 characters. It can only be the root directory of a storage medium.
Usage guidelines
This command does not take effect for patch package files.
If the device has only the Flash memory, you do not need to use this command to specify the patch file location.
If your device has an additional storage medium other than the Flash memory, you can save patch files to that storage medium.
The patch install patch-location command can change the patch file location that has been specified with the patch location command. In contrast, the patch install file filename does not.
Examples
# Specify the root directory of the USB disk as the patch file location.
<Sysname> system-view
[Sysname] patch location usb:
patch run
Use patch run to confirm ACTIVE patches.
Syntax
patch run [ patch-number ]
Views
System view
Default command level
3: Manage level
Parameters
patch-number: Specifies the sequence number of a patch. Values available for this argument depend on the patch file that has been loaded. If no sequence number is specified, this command confirms all ACTIVE patches and changes their state to RUNNING. If a sequence number is specified, this command confirms the specified ACTIVE patch and all its previous patches, and changes their state to RUNNING.
Usage guidelines
After being confirmed, ACTIVE patches are set in RUNNING state and can continue to run after a reboot. If not being confirmed, ACTIVE patches are set in DEACTIVE state at a reboot.
Examples
# Confirm patch 3 and all its previous ACTIVE patches.
<Sysname> system-view
[Sysname] patch run 3
# Confirm all ACTIVE patches.
<Sysname> system-view
[Sysname] patch run
password-recovery enable
Use password-recovery enable to enable the password recovery feature.
Use undo password-recovery enable to disable the password recovery feature.
Syntax
password-recovery enable
undo password-recovery enable
Default
The password recovery feature is enabled.
Views
System view
Default command level
3: Manage level
Usage guidelines
If the password recovery feature is enabled, a console user can configure a new password while retaining the original configuration file.
If password recovery capability is disabled, a console user must restore the factory-default configuration before they can configure a new password. Restoring the factory-default configuration deletes the next-startup configuration file.
To enhance system security, H3C recommends that you disable the password recovery feature.
Examples
# Disable the password recovery feature.
<Sysname> system-view
[Sysname] undo password-recovery enable
