Table of Contents

Related Documents

06-Software Upgrade Commands

Title	Size	Download
06-Software Upgrade Commands	199.59 KB

Software upgrade commands

NOTE:

The switch operates in IRF or standalone (the default) mode. For more information about the IRF mode, see IRF Configuration Guide.

boot-loader

Syntax

Standalone mode:

boot-loader file file-url slot slot-number { main | backup }

IRF mode:

boot-loader file file-url chassis chassis-number slot slot-number { main | backup }

View

User view

Default level

3: Manage level

Parameters

file file-url: Specifies a file name, which is 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 should contain no more than 63 characters; otherwise, the command cannot be successfully executed. The specified system software image must be saved in the flash or CF card of the switch. 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 a storage medium. If a switch has only one storage medium, you can execute this command without providing this argument.

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

slot slot-number: Specifies a card by its slot number. Use this option when your switch is operating in standalone (the default) mode.

chassis chassis-number slot slot-number: Specifies a card on an IRF member switch. The chassis-number argument represents the ID of the IRF member switch, and the slot-number argument represents the number of the slot that holds the card. You can display the member ID and slot number with the display device command. Use this option when your switch is operating in IRF mode. For more information about IRF, see IRF Configuration Guide.

main: Specifies a file as a main system software image.

backup: Specifies a file as a backup system software image.

Description

· Standalone mode

Use the boot-loader command to specify a system software image to be used at the next boot of the active main board (AMB) or the standby main board (SMB).

To successfully execute the boot-loader command, save the file to be used at the next boot in the root directory of the storage medium.

If the storage medium is on the AMB, you can specify the storage medium by giving its name, such as flash; if the storage medium is on the SMB, you can specify the storage medium by giving its name and the slot-number of the SMB, 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 specify the system software image for the AMB, the file-url argument cannot contain a slot number, and slot-number should be specified as the slot number of the AMB; when you specify the system software image for the SMB, the file-url argument must contain a slot number (such as slot1#flash:/test.bin), and slot-number should be specified as the slot number of the SMB.

The names of the files to be used at the next boot of the AMB and the SMB may be different, but the versions of the files must be the same; otherwise, the switch may not boot normally.

Related commands: display boot-loader.

· IRF mode

Use the boot-loader command to specify a system software image to be used at the next boot of a main board.

To execute the boot-loader command successfully, save the file to be used at the next boot in a main board's root directory of the storage medium on a specified member switch.

If the storage medium is on the AMB of the IRF fabric (the AMB of the master), you can specify the storage medium by giving its name, such as flash; if the storage medium is on an SMB of the IRF fabric (any main boards except the AMB of the IRF fabric), you can specify the storage medium by giving its switch ID and the slot-number of the card, that is, in the format of chassis chassis-number#slotslot-number#StorageMediumName, such as chassis2#slot1#flash.

When you specify the system software image to be used at the next boot of the AMB of the IRF fabric, the file-url argument cannot contain a member ID or a slot ID, chassis-number should be specified as the member ID of the master, and slot-number should be specified as the slot number of the AMB of the IRF fabric. When you specify the system software image to be used at the next boot of an SMB of the IRF fabric, the file-url argument must contain the slot number of the card and the member ID of the member switch where the main board resides, such as chassis2#slot1#flash:/test.bin, chassis-number should be specified as the member ID of the IRF member switch, and slot-number should be specified as the slot number of the card.

The names of the files to be used at the next boot of the AMB and SMB of the IRF fabric may be different, but the versions of the files must be the same; otherwise, the SMB cannot join the IRF fabric again.

Related commands: display boot-loader.

Examples

# Specify the main system software image for the AMB (the slot number is 0) for the next switch boot as test.bin (Make sure that the file test.bin is already saved on the storage media of the AMB; otherwise, the system prompts error and the execution of the command fails).

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

This command will set the boot file of the specified board. Continue? [Y/N]:y

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

# Specify the main system software image for the SMB (the slot number is 1) for the next switch boot as test.bin (Make sure that the file test.bin is already saved on the storage media of the SMB; otherwise, the system prompts error and the execution of the command fails).

<Sysname> boot-loader file slot1#flash:/test.bin slot 1 main

This command will set the boot file of the specified board. Continue? [Y/N]:y

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

# Specify the main system software image for the global AMB in slot 0 on the switch with member ID of 1 as test.bin. (Make sure that the file test.bin is already saved on the storage media of card; otherwise, the system prompts error and the execution of the command fails.)

<Sysname> boot-loader file test.bin chassis 1 slot 0 main

This command will set the boot file of the specified board. Continue? [Y/N]:y

The specified file will be used as the main boot file at the next reboot on chassis 1 slot 0!

# Specify the main system software image for the global SMB in slot 1 on the switch with the member ID of 1 as test.bin. (Make sure that the file test.bin is already saved on the storage media of card; otherwise, the system prompts error and the execution of the command fails.)

<Sysname> boot-loader file chassis1#slot1#flash:/test.bin chassis 1 slot 1 main

This command will set the boot file of the specified board. Continue? [Y/N]:y

The specified file will be used as the main boot file at the next reboot on chassis 1 slot 1!

boot-loader update slot

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 SMB.

Description

Use the boot-loader update slot command to upgrade system software for the SMB.

NOTE:

This command is supported only when the system operates in standalone mode but not in IRF mode.

Examples

# Upgrade system software for the SMB in slot 1.

<Sysname> boot-loader update slot 1

bootrom update

Syntax

Standalone mode:

bootrom update file file-url slot slot-number-list

IRF mode:

bootrom update file file-url chassis chassis-number slot slot-number-list

View

User view

Default level

3: Manage level

Parameters

file file-url: Specifies the BootWare for the upgrade, where file-url represents the upgrade filename. The value is a string of 1 to 63 characters. The BootWare image file can be saved only on the flash or CF card. he absolute path should contain no more than 63 characters; otherwise, the command cannot be successfully executed. The specified system software image must be saved in the flash or CF card of the switch. 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 a storage medium. If a switch has only one storage medium, you can execute this command without providing this argument.

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

slot slot-number-list: Specifies a list of slot numbers of cards, in the format of { slot-number [ to slot-number ] }&<1-7>. The slot-number argument represents the number of the slot that holds the card. &<1-7> indicates that you can specify up to seven lists of slot numbers.

chassis chassis-number slot slot-number: Specifies a card by its IRF member ID. You can display the member ID and slot number with the display device command. Use this option when your switch is operating in IRF mode. For more information about IRF, see IRF Configuration Guide.

Description

· Standalone mode

Use the bootrom update command to upgrade BootWare image on a card.

When you upgrade BootWare image for the AMB, the file-url argument cannot contain a slot number, and slot-number should be specified as the slot number of the AMB; when you upgrade BootWare image for the SMB or an interface card, the file-url argument must contain the slot number (such as slot1#flash:/test.bin), slot-number should be specified as the slot number of the card.

The names of the BootWare images on the cards may be different, but the versions of the programs must be the compatible; otherwise, the switch may not boot normally.

· IRF mode

Use the bootrom update command to upgrade BootWare on a specified card on the specified IRF member switch.

If the storage media is on the global AMB, you can specify the storage media by giving its name, such as flash; if the storage media is on the global SMB, you can specify the storage media by giving its member ID and the slot number of the card in the format of chassischassis-number#slotslot-number#, such as chassis2#slot1#flash.

When you specify the Boot ROM program for global AMB and the interface card on the master, the file-url argument cannot contain a member ID or a slot ID, chassis-number should be specified as the member ID of the master, and slot-number should be specified as the slot number of the card. When you specify the Boot ROM program for other cards of the IRF member switch, the file-url argument must contain the slot number of the card and the member ID of the switch where the card resides, such as chassis2#slot1#flash:/test.bin, chassis-number should be specified as the member ID of the switch, and slot-number should be specified as the slot number of the card.

Examples

# Use the test.btw file to upgrade BootWare on the AMB in slot 1.

<Sysname> bootrom update file test.btw slot 1

clock update

Syntax

Standalone mode:

clock update [ file file-url ] slot slot-id

IRF mode:

clock update [ file file-url ] chassis chassis-number slot slot-id

View

User view

Default level

2: System level

Parameters

file file-url: Specifies the upgrade clock monitor file. The file-url argument represents upgrade filename, which is a string of 1 to 63 characters. With no file name specified, the clock monitor file contained in the current system software image is used.

slot slot-id: Specifies the slot number of the main board whose clock monitor software is to be upgraded.

chassis chassis-number: Specifies the IRF member switch bearing the main board whose clock monitor software is to be upgraded. The chassis-number argument represents the ID of the IRF member switch. You can display the member ID with the display device command.

Description

Use the clock update command to upgrade the clock monitor software of the specified main board.

After the above command is executed, you need to wait for a period of time until the system prompts you that the upgrading is completed.

CAUTION:

· To avoid damage to the clock monitor software, do not perform the following operations when upgrading the it: performing an active/standby switchover, resetting the clock monitor module whose software is being upgraded, powering off of the switch, rebooting or removing of the AMB. For information about the clock monitor module, see Network Management and Monitoring Configuration Guide.

· The file specified by using the file-url argument must be saved on the storage media of the corresponding main board. For example, to upgrade the clock monitor software of the AMB on the master, the file must be saved on the storage media of the AMB on the master. Otherwise, the upgrade process fails.

· All clock-related services of the whole switch are affected during the upgrade process.

· This command is applicable only for the main board LSR1SRP2D1.

Examples

# Upgrade the clock monitor software of the main board in slot 1 by using the clock monitor software contained in the current system software image.

<Sysname> clock update slot 1

display boot-loader

Syntax

Standalone mode:

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

IRF mode:

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

View

Any view

Default level

2: System level

Parameters

slot slot-number: Specifies a card by its slot number. Use this option when your switch is operating in standalone (the default) mode.

|: 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.

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 system software image.

Related commands: boot-loader.

Examples

· Standalone mode:

# Display the file adopted at the current and next boot of the switch.

<Sysname> display boot-loader

The next primary boot file of board 0 is: cfa0:/test.bin

The next backup boot file of board 0 is: flash:/backup.bin

The current boot file of board 0 is: cfa0:/test.bin

· IRF mode:

# Display the files adopted at the current and next boot of the IRF fabric.

<Sysname> display boot-loader

The next primary boot file of chassis 1 slot 0 is: cfa0:/test.bin

The next backup boot file of chassis 1 slot 0 is: flash:/backup.bin

The current boot file of chassis 1 slot 0 is: cfa0:/test.bin

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.

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

· Standalone mode:

# Display the installed patch files and the versions of their corresponding patch packages.

The following patch packages are loaded:

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

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

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

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

· IRF mode:

# Display the installed patch files and the versions of their corresponding patch packages.

<Sysname> display patch

The following patch packages are loaded:

flash:/s9500-b90h02a.bin, H001, loaded on slot(s):

Chassis 1, slot(s): 0

flash:/s9500-b90h02b.bin, H002, loaded on slot(s):

Chassis 1, slot(s): 3

flash:/s9500-b90h02c.bin, H003, loaded on slot(s):

Chassis 3, slot(s): 6, 11

Table 1 Output description

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

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.

Examples

# Display hotfix information.

· Standalone mode:

<Sysname> display patch information

The location of patches: flash:

Slot Version Temporaty Common Current Active Running Start-Address

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

0 MR 0 0 0 0 0 0x3995b70

3 LC 0 0 0 0 0 0x225bab4

· IRF mode:

<Sysname> display patch information

Chassis Slot Version Temporaty Common Current Active Running Start-Address

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

1 0 MR 0 0 0 0 0 0x378d834

1 3 LC 0 0 0 0 0 0x21d6bf0

Table 2 Output description

Field	Description
The location of patches	Patch file location. You can configure it using the patch location command.
Slot	The slot number of the card. If only one CPU is on the card, the 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. If no patch is installed, the flag suffix of the patch is displayed.
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.
Chassis	ID of the IRF member switch.

logic update

Syntax

logic update [ file filename ] slot slot-number [ subslot subslot-number ] logicid logicid

View

User view

Default level

2: System level

Parameters

file filename: Specifies the logic upgrade file. The filename argument represents the upgrade filename, which is a string of 1 to 63 characters. If it is not provided, the logic upgrade file contained in the current startup file is used.

slot slot-number: Specifies a card by its slot number. Use this option when your switch is operating in standalone (the default) mode.

subslot subslot-number: Specifies the subslot number of the subcard whose logic is to be upgraded. This argument can be specified only when the subcard is configured on the switch.

logicid logicid: Specifies the logic type, which can be either 1 or 4.

· 1: Upgrades the logic for the CPU on a base card.

· 4: Upgrades the logic for a subcard.

Description

Use the logic update command to upgrade the logic for the CPU on an interface card or the logic for a subcard.

CAUTION:

In the logic upgrade process, do not perform active/standby switchover, power off the switch, or restart or swap the AMB.

NOTE:

· The logic update command cannot be used to upgrade the logic for a main board or an interface card.

· This command is available only when the switch operates in standalone mode.

Examples

# Upgrade the logic for the card in slot 2.

<Sysname> logic update file cfa0:/S9500E-CMW520-B1321D.bin slot 2 logicid 1

logic update bymbus

Syntax

Standalone mode:

logic update bymbus [ file filename ] slot slot-number logicid logicid

IRF mode:

logic update bymbus [ file filename ] chassis chassis-number slot slot-number logicid logicid

View

User view

Default level

2: System level

Parameters

slot slot-number: Specifies a card by its slot number. Use this option when your switch is operating in standalone (the default) mode.

logicid logicid: Specifies the logic type, which can be 0, 1 or 2.

· 0: Upgrades the logic for the base card.

· 1: Upgrades the logic for the operation, administration, and maintenance (OAM) module on a main board, or the logic for the CPU on an interface card.

· 2: Upgrades the logic for the daughter card on a base card. (Only supported by LSR1LN2BNL1 at present.)

Description

Use the logic update bymbus command to upgrade the logic for the specified card. If the logic for a card fails (such as upgrade failure), use the logic update bymbus command to load a new logic.

CAUTION:

In the logic upgrade process, do not perform active/standby switchover, power off the switch, or restart or swap the AMB.

NOTE:

· The logic update bymbus command cannot be used to upgrade the logic for the CPU on a base card or the logic for a subcard. Use the logic update file command to upgrade the logic for the CPU on a base card or the logic for a subcard.

· Before upgrading the logic for an interface card, keep the interface card offline. For more information about the configurations, see the board-offline command in the chapter “Device management commands.”

· During the upgrading of the logic for a card, the card restarts automatically to validate the upgraded logic.

· If you plug in an interface card during the logic upgrade process, you have to wait a comparatively long time for the power-on of this interface card by the switch.

· For more information about base cards and subcards, see H3C S9500E Switch Series Installation Guide.

Examples

# Upgrade the logic for the card in slot 2.

<Sysname> logic update bymbus slot 2 logicid 0

mbus update

Syntax

Standalone mode:

mbus update [ file file-url ] slot slot-number

IRF mode:

mbus update [ file file-url ] chassis chassis-number slot slot-number

View

User view

Default level

2: System level

Parameters

file file-url: Specifies the MBUS daughter card software. The file-url argument represents the upgrade filename, which is a string of 1 to 63 characters. With no file name specified, the MBUS daughter card software contained in the current system software image is used.

slot slot-number: Specifies a card by its slot number. Use this option when your switch is operating in standalone (the default) mode.

Description

Use the mbus update command to upgrade the MBUS daughter card software of the card in the specified slot.

CAUTION:

In the software upgrade process of an MBUS daughter card, do not perform active/standby switchover, power off the switch, or restart or swap the AMB.

Examples

# Upgrade the MBUS daughter card software of the card in slot 2.

<Sysname> mbus update file cfa0:/mbus_v101.bin slot 2

oam-bootrom update

Syntax

Standalone mode:

oam-bootrom update file file-url slot slot-number

IRF mode:

oam-bootrom update file file-url chassis chassis-number slot slot-number

View

User view

Default level

2: System level

Parameters

file file-url: Specifies the BootWare image file used for the upgrade, where file-url represents the upgrade filename. The file can be saved only on the flash or CF card.

slot slot-number: Specifies a card by its slot number. Use this option when your switch is operating in standalone (the default) mode.

Description

Use the oam-bootrom update command to upgrade the extension part of the BootWare images of the OAM modules on the AMB and SMB.

Examples

# Use the test.btw file to upgrade BootWare on a card (the slot number is 1).

<Sysname> oam-bootrom update file flash:/test.btw slot 1

patch active

Syntax

Standalone mode:

patch active patch-number slot slot-number

IRF mode:

patch active patch-number chassis chassis-number slot slot-number

View

System view

Default level

3: Manage level

Parameters

patch-number: Sequence number of a patch, which ranges from 1 to 200.

slot slot-number: Specifies a card by its slot number. Use this option when your switch is operating in standalone (the default) mode.

Description

Use the patch active command to activate the specified patch, namely, the system will run the patch functions instead of the original functions.

After you execute the command, all the DEACTIVE patches before the specified patch are activated.

The command is not applicable to 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

· Standalone mode:

# Activate patch 3 and all the loaded DEACTIVE patches before patch 3 on the card in slot 5.

<Sysname> system-view

[Sysname] patch active 3 slot 5

· IRF mode:

# Activate all the loaded DEACTIVE patches on the card in slot 2 of the IRF member switch with the member ID of 1.

<Sysname> system-view

[Sysname] patch active chassis 1 slot 2

patch deactive

Syntax

Standalone mode:

patch deactive patch-number slot slot-number

IRF mode:

patch deactive patch-number chassis chassis-number slot slot-number

View

System view

Default level

3: Manage level

Parameters

patch-number: Sequence number of a patch, which ranges from 1 to 200.

slot slot-number: Specifies a card by its slot number. Use this option when your switch is operating in standalone (the default) mode.

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

· Standalone mode:

# Stop running patch 3 and all the ACTIVE patches after patch 3 on the card in slot 5.

<Sysname> system-view

[Sysname] patch deactive 3 slot 5

· IRF mode:

# Stop running all the ACTIVE patches on the card in slot 5 of the IRF member switch with member ID of 1.

<Sysname> system-view

[Sysname] patch deactive chassis 1 slot 5

patch delete

Syntax

Standalone mode:

patch delete patch-number slot slot-number

IRF mode:

patch delete patch-number chassis chassis-number slot slot-number

View

System view

Default level

3: Manage level

Parameters

patch-number: Sequence number of a patch, which ranges from 1 to 200.

slot slot-number: Specifies a card by its slot number. Use this option when your switch is operating in standalone (the default) mode.

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 media. The patches are in IDLE state after this command is executed.

Examples

· Standalone mode:

# Delete patch 3 and all the patches after patch 3 on the card in slot 5.

<Sysname> system-view

[Sysname] patch delete 3 slot 5

· IRF mode:

# Delete all the patches on the card in slot 5 of the IRF member switch with the member ID of 1.

<Sysname> system-view

[Sysname] patch delete chassis 1 slot 5

patch install

Syntax

patch install patch-location

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. The file must be under the root directory of a storage medium. If the storage medium supports partitions, the patch files must be under the root directory of the first partition.

Description

Use the patch install command to install all the patches in one step.

Use the undo patch install to remove the patches.

After you execute the patch install command, a message "Do you want to continue running patches after reboot? [Y/N]:" is displayed.

· Entering 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. 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 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. Note that the following rules apply:

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

· If you install patches from patch files, save the patch files for the AMB and interface cards to the root directory of the AMB; and save the patch files for the SMB to the root directory of the SMB'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 located on the flash and make the patches take effect after the switch 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]

patch load

Syntax

Standalone mode:

patch load slot slot-number [ file filename ]

IRF mode:

patch load chassis chassis-number slot slot-number [ file filename ]

View

System view

Default level

3: Manage level

Parameters

slot slot-number: Specifies a card by its slot number. Use this option when your switch is operating in standalone (the default) mode.

file filename: File name of a file 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. Note that the following rules apply:

· If you load patches from patch packages, save the patch packages to any directory on the AMB. (standalone mode)

· If you load patches from patch files, save the patch files for the AMB and interface cards to the root directory of the AMB, and save the patch files for the SMB to the root directory of the SMB's storage media. (standalone mode)

· If you load patches from patch packages, save the patch packages to any directory on the AMB of the IRF fabric. (IRF mode)

· If you load patches form patch files, save the patch files to root directories of the member switches' storage media: save the patch files for the AMB and interface cards of each member switch to the root directory of the local AMB’s storage media, and save the patch files for the SMBs of each member switch to the local SMB's storage media. (IRF mode)

Examples

· Standalone mode:

# Load the patch files for the card in slot 3.

<Sysname> system-view

[Sysname] patch load slot 3

· IRF mode:

# Load the patch file from a patch package for the card in slot 3 on the IRF member switch with member ID of 1.

<Sysname> system-view

[Sysname] patch load chassis 1 slot 3 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 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:.

If you save the patch files to other storage media except the flash on the switch, you need to 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.

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

Standalone mode:

patch run patch-number [ slot slot-number ]

IRF mode:

patch run patch-number [ chassis chassis-number slot slot-number ]

View

System view

Default level

3: Manage level

Parameters

patch-number: Sequence number of a patch, which ranges from 1 to 200.

slot slot-number: Specifies a card by its slot number. Use this option when your switch is operating in standalone (the default) mode.

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. (Standalone mode)

With the chassis and slot keywords specified, the command confirms the running state of all the qualified patches on a specified card of an IRF member switch, including patches on the OAM CPU. If neither keyword is specified, the command confirms the running state of the qualified patches on all cards in the IRF fabric. (IRF mode)

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

· Standalone mode:

# Confirm the running of patch 3 and all the ACTIVE patches before patch 3 on the card in slot 5.

<Sysname> system-view

[Sysname] patch run 3 slot 5

· IRF mode:

# Confirm the running of all the ACTIVE patches on the card in slot 5 of the IRF member switch with member ID of 1.

<Sysname> system-view

[Sysname] patch run chassis 1 slot 5

power-logic update

Syntax

Standalone mode:

power-logic update [ file file-url ] slot slot-number

IRF mode:

power-logic update [ file file-url ] chassis chassis-number slot slot-number

View

User view

Default level

3: Manage level

Parameters

file file-url: Specifies the power supply unit (PSU) software of a card. The file-url argument represents the upgrade filename, which is a string of 1 to 63 characters. With no file name specified, the PSU upgrade file contained in the current system software image is used.

slot slot-number: Specifies the slot number of the card whose PSU software is to be upgraded.

chassis chassis-number: Specifies card on the IRF member switch bearing the PSU whose software is to be upgraded. The chassis-number argument takes the ID of the IRF member switch, which you can display with the display device command.

Description

Use the power-logic update command to upgrade the PSU software for a card.

CAUTION:

· When the PSU of a card fails, the switch cannot recognize the card type. If you execute the power-logic update command, the system prompts you to select the correct card type. In this case, select the correct card type by referring to the silkscreen on the right of the card panel (such as LSR1GP48LEB1). If you do not select the card type within 30 seconds, or you fail to input a correct number within five attempts, the system prompts upgrade failure.

· If the PSU of the card supplies power normally, the system does not prompt you to select the card type.

· In the PSU software upgrade process of a card, do not perform an active/standby switchover of the main boards, power off the switch, or restart or swap the AMB.

· When the switch operates in IRF mode, to upgrade the software for a card on the master, you must save the upgrade file to the directory on the storage medium on the AMB or SMB of the master. To upgrade the software for a card on the slave, you must save the upgrade file to the directory on the storage medium on the AMB of the salve. Otherwise, the upgrade process fails.

· You cannot upgrade the PSU software for a main board with this command.

NOTE:

· Before upgrading the software for a card, keep the card offline by executing the board-offline command. For more information about the configurations, see the chapter “Device management commands.”

· During the upgrading of the PSU software for a card, the card restarts automatically to validate the upgraded PSU software.

If you plug in a card during upgrading of the PSU software, you have to wait a comparatively long time for the power-on of this card by the switch.

Examples

# Upgrade the PSU software for the card in slot 2.

<Sysname> power-logic update slot 2

01-Fundamentals Command Reference

boot-loader

boot-loader update slot

bootrom update

oam-bootrom update

patch active

Cloud & AI

InterConnect

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Resources

Partner Business Management

Company Information

News & Events

Contact Us