Login
- Table of Contents
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 06-Software Upgrade Commands | 125.51 KB |
boot-loader
Syntax
boot-loader file file-url { main | backup }
View
User view
Default level
3: Manage level
Parameters
file file-url: Specifies a file name, a string of 1 to 63 characters. If you enter a relative path here, the system automatically converts it to an absolute path. The absolute path should contain no more than 63 characters; otherwise, the command cannot be successfully executed. The file name is in the format of [drive:/]file-name, where:
· The items in square brackets ([]) are optional.
· drive specifies the storage media of the file. The value is the name of the storage media. If a device has only one storage media, you can execute this command without providing this argument.
· file-name specifies the filename, which is usually suffixed by .bin. Suffixes vary with devices.
main: Specifies a file as a main boot file. A main boot file is used to boot a device.
backup: Specifies a file as a backup boot file. A backup boot file is used to boot a device only when a main boot file is unavailable.
Description
Use boot-loader to specify a boot file to be used at the next boot.
To execute the boot-loader command successfully, save the file to be used at the next device boot in the root directory of the storage media.
Related commands: display boot-loader.
Examples
# Specify the main boot file for the next device boot as test.bin.
<Sysname> boot-loader file test.bin main
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 0!
bootrom
Syntax
bootrom { backup | read | restore | update file file-url } [ all | part ]
View
User view
Default level
3: Manage level
Parameters
read: Reads Boot ROM, or in other words, copies the Boot ROM program from the normal partition of the Boot ROM memory to the CF card as the backup, which will be used to restore the Boot ROM when the Boot ROM memory is broken.
restore: Restores Boot ROM, or in other words, restores the Boot ROM codes from the backup partition to the normal partition of the Boot ROM memory. When the current Boot ROM is broken, and you have backed up the codes, you can restore the Boot ROM by performing the restore operation.
backup: Backs up Boot ROM, or in other words, backs up the Boot ROM codes in the normal partition to the backup partition of the Boot ROM memory. When the current Boot ROM is broken, you can restore the Boot ROM program from the backup partition. You are recommended to back up the Boot ROM before upgrading it.
update file file-url: Upgrades Boot ROM, where file-url is a string of 1 to 63 characters and represents name of the file to be upgraded. For more information about the file-url argument, see boot-loader.
all: Operates all contents of Boot ROM. All contents of the Boot ROM file are operated if the all and part keywords are not specified.
part: Operates only the extension part of Boot ROM (Boot ROM includes the basic part and the extension part, the basic part provides the basic operation items and the extension part provides more Boot ROM operation items). All contents of the Boot ROM file are operated if the all and part keywords are not specified.
Description
Use bootrom to read, restore, back up, or upgrade the Boot ROM program on the device.
To execute the bootrom command successfully, you must first save the Boot ROM program in the root directory of the storage media.
Examples
# Read the Boot ROM program.
<Sysname> bootrom read all
Now reading bootrom, please wait...
Read bootrom completed! Please check the file!
After the Boot ROM program is read, you will find that files extendbtm.bin and basicbtm.bin are generated on the storage media of the device.
<Sysname> dir
Directory of cfa0:/
0 drw- - Jul 07 2009 21:09:12 logfile
1 -rw- 15074620 Aug 08 2008 13:03:44 test.bin
2 -rw- 139 Sep 24 2008 06:51:38 system.xml
3 -rw- 524288 Aug 13 2008 17:07:18 extbtm.bin
4 -rw- 524288 Aug 13 2008 17:07:18 basicbtm.bin
5 -rw- 4232 Sep 24 2008 06:51:40 startup.cfg
250088 KB total (223700 KB free)
File system type of cfa0: FAT16
# Back up the Boot ROM program.
<Sysname> bootrom backup all
Now backuping bootrom, please wait...
Backup bootrom completed!
# Restore the Boot ROM program.
<Sysname> bootrom restore all
This command will restore bootrom file, Continue? [Y/N]:y
Now restoring bootrom, please wait...
Restore bootrom completed!
# Use the wx5004.bin file to upgrade the Boot ROM program on the device.
<Sysname> bootrom update file wx5004.bin
This command will update bootrom file, Continue? [Y/N]:y
Now updating bootrom, please wait...
Update bootrom success!
display boot-loader
Syntax
display boot-loader [ | { begin | exclude | include } regular-expression ]
View
Any view
Default 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.
Description
Use display boot-loader to display information of the boot file.
Related commands: boot-loader.
Examples
# Display the file adopted for the current and next boot of the device.
<Sysname> display boot-loader
The boot file used at this reboot:cfa0:/test.bin attribute: main
The boot file used at the next reboot:cfa0:/test.bin attribute: main
The boot file used at the next reboot:cfa0:/test.bin attribute: backup
Failed to get the secure boot file used at the next reboot!
Table 1 Command output
|
Field |
Description |
|
The boot file used at this reboot |
File used for the current boot of the system. |
|
attribute |
Attributes of a boot file, main or backup. |
|
The boot file used at the next reboot |
Boot file used for the next boot of the device. |
|
Failed to get the secure boot file used at the next reboot! |
If the main boot file and the backup boot file are not available or damaged, the secure boot file will be used for the boot of the device. |
display patch
Syntax
display patch [ | { begin | exclude | include } regular-expression ]
View
Any view
Default 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.
Description
Use display patch to display the installed patch files and the versions of their corresponding patch packages. If a patch is not loaded from a patch package, the version of the patch package is not displayed.
Examples
# Display the installed patch files and the versions of their corresponding patch packages.
<Sysname> display patch
cfa0:/patch-xxx.bin, B90H01a, loaded on slot(s):0
Table 2 Command output
|
Field |
Description |
|
cfa0:/patch-xxx.bin |
Directory of the installed patch file. |
|
B90H01a |
Version of the patch package. |
|
loaded on slot(s):0 |
Slot number of the card on which the patch loaded. |
display patch information
Syntax
display patch information [ | { begin | exclude | include } regular-expression ]
View
Any view
Default 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.
Description
Use display patch information to display the hotfix information.
Examples
# Display hotfix information.
<Sysname> display patch information
The location of patches: cfa0:
Slot Version Temporary Common Current Active Running Start-Address
----------------------------------------------------------------------
1 MPU004 0 1 1 0 1 0x310bd74
Table 3 Command output
|
Field |
Description |
|
The location of patches |
Patch file location. To configure the location, use the patch location command. |
|
Slot |
Meaningless. |
|
Version |
Patch version. The first three characters represent the suffix of the PATCH-FLAG. The following three digits, if any, represent the patch number. (The patch number can be read after the patch is loaded.) |
|
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 |
Starting address of the patch memory area in the memory. |
patch active
Syntax
patch active [ patch-number ]
View
System view
Default level
3: Manage level
Parameters
patch-number: Sequence number of a patch. The valid values of this argument depend on the patch file used.
Description
Use patch active to activate patches. The system will temporarily run the loaded patches.
If you execute the command with specifying the sequence number of a patch, all the DEACTIVE patches (including the specified patch) before the specified patch will be activated.
If you execute the command without specifying the sequence number of a patch, all the DEACTIVE patches will be activated.
Examples
# Activate patch 3 and all the loaded DEACTIVE patches before patch 3.
<Sysname> system-view
[Sysname] patch active 3
# Activate all the loaded patches.
<Sysname> system-view
[Sysname] patch active
patch deactive
Syntax
patch deactive [ patch-number ]
View
System view
Default level
3: Manage level
Parameters
patch-number: Sequence number of a patch. The valid values of this argument depend on the patch file used.
Description
Use patch deactive to stop running patches and the system will run at the original software version.
If you execute the command with specifying the sequence number of a patch, all the ACTIVE patches (including the specified patch) after the specified patch turn to DEACTIVE state.
If you execute the command without specifying the sequence number of a patch, all the ACTIVE patches turn to DEACTIVE state.
This command is not applicable to the patches in RUNNING state.
Examples
# Stop running patch 3 and all the ACTIVE patches after patch 3.
<Sysname> system-view
[Sysname] patch deactive 3
# Stop running all the ACTIVE patches.
<Sysname> system-view
[Sysname] patch deactive
patch delete
Syntax
patch delete [ patch-number ]
View
System view
Default level
3: Manage level
Parameters
patch-number: Sequence number of a patch. The valid values of this argument depend on the patch file used.
Description
Use patch delete to delete patches and all the patches after the specified patch.
If you execute the command with specifying the sequence number of a patch, all the patches (including the specified patch) after the specified patch will be deleted.
If you execute the command without specifying the sequence number of a patch, all the patches will be deleted.
This command only removes the patches from the patch memory area, and it does not delete them from the storage media. The patches are in IDLE state after this command is executed.
Examples
# Delete patch 3 and all the patches after patch 3.
<Sysname> system-view
[Sysname] patch delete 3
# Delete all the patches.
<Sysname> system-view
[Sysname] patch delete
patch install
Syntax
patch install { patch-location | file filename }
undo patch install
View
System view
Default level
3: Manage level
Parameters
patch-location: A string consisting of 1 to 64 characters. It specifies the directory where the patch file locates. It can be a root directory of a storage media.
file filename: Filename of a patch package.
Description
Use patch install to install all the patches in one step.
Use the undo patch install to remove the patches.
When you execute the patch install command, the "Do you want to continue running patches after reboot? [Y/N]:" message is displayed. If you enter:
· y or Y—All the specified patches are installed, and turn to RUNNING state from IDLE. This equals execution of the commands patch location, patch load, patch active, and patch run. The patches remain RUNNING after system reboot.
· n or N—All the specified patches are installed and turn to ACTIVE state from IDLE. This equals execution of the commands patch location, patch load and patch active. The patches turn to DEACTIVE state after system reboot.
Before executing the command, save patch files to the specified directory. The following rules apply:
· If you install patches from patch packages, save the patch packages to any directory on the device.
· If you install patches from patch files, save the patch files to the root directory of the storage media.
· After the patch install command is executed, the system changes the patch file location specified with the patch location command to the directory specified by the patch-location argument of the patch install command. For example, if you execute the patch location xxx command and then the patch install yyy command, the patch file location automatically changes from xxx to yyy. If you execute the patch install file filename command, the system will not change the patch file location.
Examples
# Install the patches located on the CF card.
<Sysname> system-view
[Sysname] patch-install cfa0:
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]
# Install the specified patch package.
<Sysname> system-view
[Sysname] patch install file:/patch_packeg.bin
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
Syntax
patch load [ file filename ]
View
System view
Default level
3: Manage level
Parameters
file filename: Filename of a patch package.
Description
Use patch load to load the patch file on the storage media (such as the Flash or the CF card) to the patch memory area.
If you execute the command with providing the filename of a patch package, the system will load the patch from the patch package.
If you execute the command without providing the filename of a patch package, the system will load the patch from a patch file.
Before executing the command, save the patch files to the specified directory. Note that the following rules apply:
· If you load patches from patch packages, save the patch packages to any directory on the device.
· If you load patches from patch files, save the patch files to the root directory of the storage media.
Examples
# Load the patch file from a patch file.
<Sysname> system-view
[Sysname] patch load
# Load the patch file from a patch package.
<Sysname> system-view
[Sysname] patch load file cfa0:/patchpackege.bin
patch location
Syntax
patch location patch-location
View
System view
Default level
3: Manage level
Parameters
patch-location: Specifies the patch file location. It is a string of 1 to 64 characters. It can be a root directory of a storage media.
Description
Use patch location to configure the patch file location.
By default, the patch file location is flash: or cfa0:.
If you want to install a patch package, you do not need to configure this command.
If you save the patch files to other storage media except the Flash on the device, you must specify the directory where the patch files locate with the patch-location argument. Then the system loads the appropriate patch files in the specified directory. If the device has only one storage media, the patch file is saved to a specific location and you do not need to execute this command.
The patch install command changes the patch file location specified with the patch location command to the directory specified by the patch-location argument of the patch install command. For example, if you execute the patch location xxx command and then the patch install yyy command, the patch file location automatically changes from xxx to yyy. If you execute the patch install command with providing the filename of a patch package, the system will not change the patch file location.
Examples
# Configure the root directory of the CF card as the patch file location.
<Sysname> system-view
[Sysname] patch location cfa0:
patch run
Syntax
patch run [ patch-number ]
View
System view
Default level
3: Manage level
Parameters
patch-number: Sequence number of a patch. The valid values of this argument depend on the patch file used.
Description
Use patch run to confirm the running of ACTIVE patches.
If you execute the command with specifying the sequence number of a patch, the command confirms the running of all the ACTIVE patches (including the specified patch) before the specified patch.
If you execute the command without specifying the sequence number of a patch, the command confirms the running of all the ACTIVE patches.
This command is applicable to patches in ACTIVE state only.
If the running of a patch is confirmed, after the system reboots, the patch will still be effective.
Examples
# Confirm the running of patch 3 and all the ACTIVE patches before patch 3.
<Sysname> system-view
[Sysname] patch run 3
# Confirm the running of all the ACTIVE patches.
<Sysname> system-view
[Sysname] patch run
