Software upgrade commands 1

boot-loader 1

boot-loader update· 2

bootrom update· 2

display boot-loader 3

display patch· 4

display patch information· 5

logic update· 6

patch active· 7

patch deactive· 8

patch delete· 8

patch install 9

patch load· 10

patch location· 11

patch run· 12

 

boot-loader

Syntax

boot-loader file file-url slot slot-number { 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 medium of the file. The value is the name of the storage medium. If a router has only one storage medium, you can execute this command without providing this argument.

·           file-name specifies the filename, which is usually suffixed by .app or .bin.

slot slot-number: Specifies the slot number of a card.

main: Specifies a file as a main boot file. A main boot file is used to boot a router.

backup: Specifies a file as a backup boot file. A backup boot file is used to boot a router only when a main boot file is unavailable.

Description

Use the boot-loader command to specify a boot file to be used at the next boot of the active MPU or the standby MPU.

To execute the boot-loader command successfully, you must first save the file to be used at the next router boot in the root directory of the storage medium on the active MPU.

If the storage medium is on the active MPU, you can specify the storage medium by giving its name, such as flash; if the storage medium is on the standby MPU, you can specify the storage medium by giving its name and the slot-number of the standby MPU, or, in the format of slotslot-number#StorageMediumName (slot-number represents the number of the slot in which the card resides), such as slot1#flash.

When you specify the boot file for the active MPU, the file-url argument cannot contain a slot number, and slot-number should be specified as the slot number of the active MPU; when you specify the boot file for the standby MPU, the file-url argument must contain a slot number (such as slot1#flash:/test.app), and slot-number should be specified as the slot number of the standby MPU.

The names of the files for the next boot of the active MPU and the standby MPU may be different, but the versions of the files must be the same; otherwise, the router may not boot normally.

Related commands: display boot-loader.

Examples

# Specify the main boot file to be used at the next boot of a router as test.bin.

<Sysname> boot-loader file cfa0:/test.bin slot 0 main

  This command will set boot file, Continue? [Y/N]:y

 

  The specified file will be used as the main boot file at the next reboot!

boot-loader update

Syntax

boot-loader update slot slot-number

View

User view

Default level

3: Manage level

Parameters

slot slot-number: Specifies the slot number of the standby MPU.

Description

Use the boot-loader update slot command to upgrade the boot file for the standby MPU.

If the router supports both the main and the backup files to be used at the next router boot, this command upgrades the main boot file for the standby MPU.

Examples

# Upgrade the boot file for the standby MPU in slot 1.

<Sysname> boot-loader update slot 1

bootrom update

Syntax

bootrom update file file-url slot slot-number [ to slot-number ]

View

User view

Default level

3: Manage level

Parameters

file file-url: Specifies the Boot ROM for the upgrade, where file-url represents the update filename. The value is a string of 1 to 63 characters. For more information about the file-url argument, see boot-loader.

slot slot-number-list: Specifies a list of slot numbers of cards, in the format of slot-number-list = { slot-number [ to slot-number ]. The slot-number argument represents the slot number of a card.

Description

Use the bootrom command to upgrade the Boot ROM program on a card(s).

To execute the bootrom command successfully, you must first save the Boot ROM program in the root directory of the storage media on the card.

If the storage medium is on the active MPU, specify the storage medium by giving its name, such as flash. If the storage medium is on the standby MPU, specify the storage medium by giving its name and the slot-number of the standby MPU, that is, in the format of slotslot-number# StorageMediumName (slot-number represents the number of the slot in which the card resides), such as slot1#flash.

When you upgrade the Boot ROM program for the active MPU, the file-url argument cannot contain a slot number, and slot-number should be specified as the slot number of the active MPU; when you upgrade the Boot ROM program for the standby MPU or an interface card, the file-url argument must contain the slot number (such as slot1#flash:/test.app), slot-number should be specified as the slot number of the card and subslot-number-list should be specified as the subslot number of the card.

The names of the Boot ROM programs on the cards may be different, but the versions of the programs must be the same; otherwise, the router may not boot normally.

 

NOTE: After you successfully upgrade the Boot ROM program of a card, the system prompts upgrade success only if you have enabled terminal display of log information with the terminal logging command.

 

Examples

# Use the SR01LNLMCUA106.APP file on the Flash to upgrade the Boot ROM file on card 6.

<Sysname> bootrom update file SR01LNLMCUA106.APP slot 6

  This command will update bootrom file on the specified board(s), Continue? [Y/N]:y

  Now updating bootrom, please wait...

 

#Aug 21 15:08:30:383 2007 H3C DEV/1/BOARD REQUEST LOADING:

 Trap 1.3.6.1.4.1.2011.2.23.1.12.1.18<hwRequestLoading>: frameIndex is 0, slotIndex 0.6

 

#Aug 21 15:08:30:553 2007 H3C DEV/1/LOAD FINISHED:

 Trap 1.3.6.1.4.1.2011.2.23.1.12.1.20<hwLoadFinished>: frameIndex is 0, slotIndex 0.6

 

%Aug 21 15:08:30:673 2007 H3C DEV/4/BOARD LOADING:

 Board is loading file on Frame 0 Slot 6.

 

%Aug 21 15:08:30:804 2007 H3C DEV/4/LOAD FINISHED:

 Board has finished loading file on Frame 0 Slot 6.

 

%Aug 21 15:08:30:943 2007 H3C SYSM/0/SYSM_LOG_TOP:Slot=6;

 Frame 0 NPU Board 6 this is loading bootrom file...

%Aug 21 15:08:38:883 2007 H3C SYSM/0/SYSM_LOG_TOP:Slot=6;

 Frame 0 NPU Board 6 upgrade BOOTROM succeeded!

display boot-loader

Syntax

display boot-loader [ slot slot-number ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

2: System level

Parameters

slot slot-number: Displays boot file information of the specified card, where slot-number represents the slot number of a card.

|: 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 the display boot-loader command to display information of the boot file.

Related commands: boot-loader.

Examples

# Display the file adopted at the current and next boot of the router

<Sysname> display boot-loader

 The primary app to boot of board 0 at the next time is: cf0:/test.bin

 The backup  app to boot of board 0 at the next time is: cf0:/backup.bin

 The app to boot of board 0 at this time is: cf0::/test.bin

Table 1 Output description

Field	Description
The primary app to boot of board slot-number at this time is	Boot file used for the card for the next router boot. slot-number indicates the number of the slot in which the card resides.
The backup app to boot of board slot-number at next time is	Backup boot file used for the card for the next router boot. slot-number indicates the number of the slot in which the card resides.
The app to boot of board 0 at this time is	Backup boot file used for the card for the router boot at this time. slot-number indicates the number of the slot in which the card resides.

 

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 the display patch command 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

The following patch packages are loaded:

flash:/SR8800-b90h01a.bin, B90H01a, loaded on slot(s):

1, 4, 5, 6, 7, 8, 9, 10

flash:/SR8800-b90h01b.bin, B90H01b, loaded on slot(s):

2

flash:/SR8800-b90h01c.bin, B90H01c, loaded on slot(s):

3

Table 2 Output description

Field	Description
flash:/s8800-b90h01a.app	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

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 the display patch information command to display the hotfix information of a router.

Examples

# Display hotfix information.

<Sysname> display patch information

The location of patches: flash:

Slot Version   Temporary Common Current Active Running  Start-Address

----------------------------------------------------------------------

0    RPE004    0         1       1      0      1        0x310bd74

1    100001    0         1       1      0      1        0x1bb87ac

1.1  OAM001    0         1       1      0      1        0x1bb87ac

Table 3 Output description

Field	Description
The location of patches	Patch file location. To configure the location, use the patch location command.
Slot	The slot number of the card. If only one CPU is on the card, slot-number is displayed. If multiple CPUs are on the card, slot-number is displayed for the master CPU and slot-number.cpu-id is displayed for a slave CPU.
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	Starting address of the memory patch area in the memory.

 

logic update

Syntax

logic update file filename slot slot-number { board | subcard }

View

User view

Default level

2: System level

Parameters

file filename: Specifies the file to be used to upgrade a logic. The filename argument represents the name of the file to be used. If it is not provided, the logic upgrading file contained in the current startup file is used.

slot slot-number: Specifies the slot number of the card whose logic is to be upgraded. At present, only the line cards are supported.

board: Specifies to upgrade the logic of a card.

subcard: Specifies to upgrade the logic of a subcard.

Description

Use the logic update command to upgrade the logic of the specified card.

 

NOTE: If you plug in a line card during upgrading of a logic, you have to wait a comparatively long time for the power-on of this line card by the router.

 

Examples

# Upgrade the logic of the card in slot 2 through the MBUS daughter card.

<Sysname> logic update file test slot 2 logicid 0

patch active

Syntax

patch active [ patch-number ] slot slot-number

View

System view

Default level

3: Manage level

Parameters

patch-number: Sequence number of a patch.

slot slot-number: Specifies a card by its slot number.

Description

Use the patch active command to activate the patch, which means the system will run the loaded patch.

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.

 

NOTE: ·       The command is applicable to only patches in DEACTIVE state. ·       After a system reboot, the original ACTIVE patches change to DEACTIVE and become invalid. To make them effective, activate them again.

 

Examples

# Activate patch 3 and all the loaded DEACTIVE patches before patch 3 on the standby MPU in slot 1.

<Sysname> system-view

[Sysname] patch active 3 slot 1

# Activate all the loaded DEACTIVE patches on the standby MPU in slot 1.

<Sysname> system-view

[Sysname] patch active slot 1

patch deactive

Syntax

patch deactive [ patch-number ] slot slot-number

View

System view

Default level

3: Manage level

Parameters

patch-number: Sequence number of a patch.

slot slot-number: Specifies a card by its slot number.

Description

Use the patch deactive command to stop running the specified patch and all the ACTIVE patches after the specified patch, 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 on the standby MPU in slot 1.

<Sysname> system-view

[Sysname] patch deactive 3 slot 1

# Stop running all the ACTIVE patches on the standby MPU in slot 1.

<Sysname> system-view

[Sysname] patch deactive slot 1

patch delete

Syntax

patch delete [ patch-number ] slot slot-number

View

System view

Default level

3: Manage level

Parameters

patch-number: Sequence number of a patch.

slot slot-number: Specifies a card by its slot number.

Description

Use the patch delete command to delete the specified patch 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 memory patch area, and it does not delete them from the storage medium. The patches are in IDLE state after execution of this command.

Examples

# Delete patch 3 and all the patches after patch 3 on the standby MPU in slot 1.

<Sysname> system-view

[Sysname] patch delete 3 slot 1

# Delete all the patches on the standby MPU in slot 1.

<Sysname> system-view

[Sysname] patch delete slot 1

patch install

Syntax

patch install { patch-location | file filename }

undo patch install

View

System view

Default level

3: Manage level

Parameters

patch-location: Specifies the directory where the patch file locates, which is a string of 1 to 64 characters.. The file must be in the root directory of a storage medium. If the storage medium is a CF card with partitions, the patch files must be in the root directory of the first partition.

file filename: Filename of a patch package.

Description

Use the patch install command 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 message "Do you want to continue running patches after reboot? [Y/N]:" appears.

·           Entering y or Y: All the patches in the specified directory 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 in RUNNING state after system reboot. If a slot is empty, the system will record the information. When a card is plugged into the slot, the system will install the corresponding patch on the card.

·           Entering n or N: All the patches in the specified directory 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. Follow these rules:

·           If you install patches from patch packages, save the patch packages to any directory on the active MPU.

·           If you install patches from patch files, save the patch files for the active MPU and interface cards to the root directory of the active MPU; and save the patch files for the standby MPU to the root directory of the standby MPU's storage media. If the storage media is a CF card with partitions, save the patch files to the root directory of the first partition.

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 on the Flash and specify the patches to remain in RUNNING state after system reboot.

<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]

# Install the specified patch package and specify the patches to remain in RUNNING state after system reboot.

<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 slot slot-number [ file filename ]

View

System view

Default level

3: Manage level

Parameters

slot slot-number: Specifies a card by its slot number.

file filename: Filename of a patch package.

Description

Use the patch load command to load the patch file on the storage media (such as the Flash or the CF card) to the memory patch 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.

The system loads the patch file from the Flash by default. If the system cannot find the patch file on the Flash, it will try to read and load the patch file from the CF card.

Before executing the command, save the patch files to the specified directory. Follow these rules:

·           If you load patches from patch packages, save the patch packages to any directory on the active MPU.

·           If you load patches from patch files, save the patch files for the active MPU and interface cards to the root directory of the active MPU, and save the patch files for the standby MPU to the root directory of the standby MPU's storage media.

Examples

# Load the patch file from a patch file for the standby MPU in slot 1.

<Sysname> system-view

[Sysname] patch load slot 1

# Load the patch file from a patch package for the standby MPU in slot 1.

<Sysname> system-view

[Sysname] patch load slot 1 file flash:/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 consisting of 1 to 64 characters.

Description

Use the patch location command to configure the patch file location.

By default, the patch file location is flash:.

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 router, you need to specify the directory where the patch files locate with the patch-file argument. Then the system loads the appropriate patch files in the specified directory.

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 ] [ slot slot-number ]

View

System view

Default level

3: Manage level

Parameters

patch-number: Sequence number of a patch.

slot slot-number: Specifies a card by its slot number.

Description

Use the patch run command 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.

With the slot keyword specified, the command confirms the running state of all the qualified patches on the card, including patches on the OAM CPU. If the keyword is not specified, the command confirms the running state of the qualified patches on all cards only.

This command is applicable to patches in ACTIVE state only.

If the running of a patch is confirmed, after the system reboots, the patch remains effective.

Examples

# Confirm the running of patch 3 and all the ACTIVE patches before patch 3 on the standby MPU in slot 1.

<Sysname> system-view

[Sysname] patch run 3 slot 1

# Confirm the running of all the ACTIVE patches on the standby MPU in slot 1.

<Sysname> system-view

[Sysname] patch run slot 1