No relevant resource is found in the selected language.

This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. Read our privacy policy>Search

Reminder

To have a better experience, please upgrade your IE browser.

upgrade

S12700 V200R013C00 Command Reference

This document describes all the configuration commands of the device, including the command function, syntax, parameters, views, default level, usage guidelines, examples, and related commands.
Rate and give feedback:
Huawei uses machine translation combined with human proofreading to translate this document to different languages in order to help you better understand the content of this document. Note: Even the most advanced machine translation cannot match the quality of professional translators. Huawei shall not bear any responsibility for translation accuracy and it is recommended that you refer to the English document (a link for which has been provided).
Upgrade Commands

Upgrade Commands

Command Support

Commands provided in this section and all the parameters in the commands are supported by all switch models by default, unless otherwise specified. For details, see specific commands.

check configuration compatible

Function

The check configuration compatible command checks whether the configuration file for next startup conflicts with the system software for next startup.

Format

check configuration compatible { system-software | version version }

Parameters

Parameter

Description

Value

system-software

Specifies the system software to be checked as the system software for next startup.

-

version version

Specifies the version of the system software to be checked.

The value is a string of 11 or 17 case-insensitive characters in the format of VxxxRxxxCxx or VxxxRxxxCxxSPCxxx in which x indicates digits 0 to 9.

Views

User view

Default Level

3: Management level

Usage Guidelines

If you upgrade the system software to V200R008C10 or a later version, or downgrade the system software to a version earlier than V200R008C10, when the configuration file contains WLAN configurations, the system displays a message indicating that the configuration file conflicts with the system software for next startup when the device restarts. The system software upgrade fails. You are advised to run the check configuration compatible system-software command to check whether the system software for next startup conflicts with the configuration file for next startup, or run the check configuration compatible version version command to check whether a specified system software conflicts with the configuration file for next startup. If a conflict occurs during the upgrade, you need to use the eDesk tool to convert configurations in the configuration file, and specify the converted configuration file as the configuration file for next startup. If the configuration file is not converted, the configurations will be lost after the system is restarted and upgraded. If a conflict occurs during the downgrade, you are advised not to perform the downgrade operation.

NOTE:

After converting configurations in the configuration file using the eDesk tool, restart the switch without saving the configurations. If the configurations are saved, the converted configuration file is invalid.

Example

# Check whether the configuration file for next startup conflicts with the system software for next startup.

<HUAWEI> check configuration compatible system-software
Info: The configuration is compatible with system software.

# Check whether the configuration file for next startup conflicts with V200R013C00.

<HUAWEI> check configuration compatible version V200R013C00
Info: The configuration is compatible with V200R013C00 software.
Table 2-82  Description of the check configuration compatible command output

Item

Description

Info: The configuration is compatible with system software.

The configuration file for next startup is compatible with the system software for next startup.

Info: The configuration is compatible with V200R013C00 software.

The configuration file for next startup is compatible with the specified system software.

Warning: The WLAN configuration conflicts with the next startup system software. To prevent configuration loss, use the eDesk tool to convert the configuration, and then specify the new configuration file for next startup.

The configuration file for next startup is incompatible with the system software for next startup.

Info: The WLAN configurations have been converted using the eDesk tool. Do not save the configurations; otherwise, converted configurations will be lost.

WLAN configurations have been converted using the eDesk tool. To prevent the converted configurations from being lost, do not save the configurations.

Info: The next startup system software version is lower than V200R008C10, the WLAN configuration is not compatible.

If the version of the next startup software packages is earlier than V200R008C10, WLAN configurations are incompatible.

Error: The software version format is incorrect. The suggested format is VxxxRxxxCxx or VxxxRxxxCxxSPCXXX.

The specified system software format is incorrect or the switch fails to obtain version information from the specified system software.

Error: The configuration file version format is incorrect. The suggested format is VxxxRxxxCxx or VxxxRxxxCxxSPCXXX.

The switch fails to obtain configuration information from the specified system software.

Error: Failed to get the next startup system software version.

The switch fails to obtain version information from the system software for next startup.

Error: Failed to get the next startup configuration file version.

The switch fails to obtain configuration information from the system software for next startup.

Related Topics

check version

Function

The check version command checks the version mapping of the system software.

Format

check version [ all | allow | newer ]

Parameters

Parameter

Description

Value

all

Displays information about all the versions.

-

allow

Displays information about the compatible versions.

-

newer

Displays information about the latter versions.

-

Views

User view

Default Level

3: Management level

Usage Guidelines

The check version command checks the version mapping information about the system software. If no parameter is specified in the command, the command displays versions incompatible with the software version.

NOTE:

Only one user is allowed to run this command at one time. If multiple users run this command simultaneously, an error message is displayed.

Example

# Display information about all the versions.

<HUAWEI> check version all
Slot       Type Content    CurVer      ExactVer    State        Upgrade Suggest 
--------------------------------------------------------------------------------
6          LPU  BootROM    0207.0029   0207.0029   Compatible   None            
6          LPU  BootLoad   0207.003d   0207.003d   Compatible   None            
6          LPU  CPLD0      1309.2614   1309.2614   Compatible   None            
13         MPU  BootROM    0207.0029   0207.0029   Compatible   None            
13         MPU  BootLoad   0207.003d   0207.003d   Compatible   None            
13         MPU  CPLD0      1411.2114   1411.2114   Compatible   None            
16         SFU  BootROM    0207.00b4   0207.00b4   Compatible   None            
16         SFU  BootLoad   0207.00be   0207.00be   Compatible   None            
16         SFU  CPLD0      1312.1611   1312.1611   Compatible   None            
6          LPU  CANbus_App 09d         09d         Compatible   None            
6          LPU  CANbus_Sdr 009         009         Compatible   None            
13         MPU  CANbus_App 09d         09d         Compatible   None            
13         MPU  CANbus_Sdr 00b         00b         Compatible   None            
16         SFU  CANbus_App 09d         09d         Compatible   None            
16         SFU  CANbus_Sdr 009         009         Compatible   None            
19         CMU  CANbus_App 06d         06d         Compatible   None            
19         CMU  CANbus_Sdr 007         007         Compatible   None            
Table 2-83  Description of the check version command output

Item

Description

Slot

Slot ID.

In a cluster, this parameter is displayed as Chassis/Slot.

Type

Board type.

Content

Component type.

CurVer

Version that is currently loaded on the board.

ExactVer

Exact version of the software that the device needs to use for startup.

State

Relationship between the current version and the exact version:

  • Compatible: The current version is the same as the exact version.
  • Incompatible: The current version is earlier than the exact version.
  • Newer: The current version is later than the exact version.

Upgrade Suggest

Different upgrade suggestions are offered according to the relationship between the current version and the exact version.

  • None: Indicates that the current version does not need to be upgraded.
  • Must: Indicates that the current version must be upgraded.
  • Recommend: Indicates that the user can choose not to upgrade the current version because it is later than the exact version. You can use the current software version because software versions are backward compatible. It is recommended that you degrade the software version to the target version to ensure version matching.
  • Suggest: The current software version is much eariler. It is recommended that you upgrade the current software version.

check startup

Function

The check startup command checks the correctness of various resource files, including the PAF file, the patch package, the startup software, and the configuration file.

Format

check startup [ crc ] [ next ]

Parameters

Parameter Description Value
crc Performs a CRC check on various resource files. -
next Checks various resource files used for next startup. -

Views

User view

Default Level

1: Monitoring level

Usage Guidelines

After configuring the resource files for next startup, you can run this command to check whether the resource files are complete and whether the formats and versions of the resource files are correct.

Example

# Check the correctness of the resource files.

<HUAWEI> check startup
Main board:
Check startup software.......ok                                                 
Check configuration file.....ok                                                 
Check PAF....................ok                                                 
Check Patch..................ok                                                 
PAF is fitted with startup software                                             
Slave board:                                                                    
Check startup software.......ok                                                 
Check configuration file.....ok                                                 
Check PAF....................ok                                                 
Check Patch..................ok                                                 
PAF is fitted with startup software                                             
Startup software in slave board is fitted with main board. 

# Performs a CRC check on various resource files.

<HUAWEI> check startup crc
Warning: This operation will take several minutes! Continue?[Y/N]:y             
Check startup software CRC                                                      
................................................................................
................................................................................
................................................................................
............................................................................    
ok                                                                              
Check startup software CRC in slave board.......................................
...............................................................                 
ok 

display license

Function

The display license command displays information about the license file in the system.

Format

display license [ file-name | verbose ]

Parameters

Parameter Description Value
file-name

Displays summary information about the license file with a specified file name.

file-name supports file name association. The disk where the file resides can be automatically associated.
  • Full help: All the disks of the device can be associated and displayed.
  • Partial help: The related disk and file can be associated and displayed after you enter a specified character string.

The value is a string of 5 to 64 case-insensitive characters without spaces.

verbose

Displays detailed information about the current active license file.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

A license file dynamically controls the availability of some features. Only one license file is active in the system. Run this command to view detailed information about the active license in the system, including license file name, version, validity period, and control item. Based on the information, you can determine whether to upgrade the system version to support more features.

Example

# Display information about the active license file of the MPU on the S12700.
<HUAWEI> display license
 Active license    : flash:/S12700.dat
 License state     : Demo
 Revoke ticket     : No ticket

 RD of Huawei Technologies Co., Ltd.

 Product name      : S12700
 Product version   : V200R012
 License Serial No : LIC20140208014E50
 Creator           : Huawei Technologies Co., Ltd.
 Created Time      : 2017-02-08 21:22:06
 Feature name      : EHFEA1
 Authorize type    : DEMO
 Expired date      : 2017-04-07
 Trial days        : --

 Item name          Item type  Value    Description
 ------------------------------------------------------------- 
 EH1SNQA00000       Function   YES      NQA Client & NQA Server
 EH1SIPV60000       Function   YES      IPV6 GTLV2
 EH1SSSP00000       Function   YES      Operation Diffluence Platform Function
 EH1SBSVC0000       Function   YES      S12700 Base SW Version Control Function
 EH1SMPLS0000       Function   YES      MPLS
 EH1SFIB128K0       Resource   6        FIB128K
 EH1SFIB512K0       Resource   2        FIB512K
 EH1SWL16AP00       Resource   127      WL16AP
 EH1SWL64AP00       Resource   32       WL64AP
 EH1SWL128AP0       Resource   16       WL128AP
 EH1SWL512AP0       Resource   4        WL512AP
 EH1SPPPOE4K0       Resource   8        PPPOE4K
 EH1SPPPOE8K0       Resource   4        PPPOE8K
 EH1SPPPOE16K       Resource   2        PPPOE16K

 Master board license state: Demo. The license for the current configuration will 
expire in 343 days. Apply for authentic license before the current license expires.
Table 2-84  Description of the display license command output

Item

Description

Active license

Name and path of the active license file.

License state

Status of a license file:
  • Normal

    This state value indicates that a license file is working properly. If the status of the license file on the live network is not Normal, check the license file.

  • Trial

    • A license file enters the Trial state if the ESN does not match the device. A license file in Trial state can be used only for 60 days.

      To continue to use a license file after the Trial state, apply for a new license file using the correct ESN.

    • A temporary license file expires and enters the Trial state.

      To continue to use a license file after the Trial state, apply for a new license file and activate it.

    • A license file is revoked and enters the Trial state.

      To continue to use a license file after the Trial state, apply for a new license file based on the revocation code and activate it.

    • If you replace the master main control board but the new ESN does not match the license file, the license file enters the Trial state.

      To continue to use a license file after the Trial state, apply for a new license file matching the new ESN and activate it.

  • Demo

    When you activate a temporary license file, it enters the Demo state. The Demo state exists only for a demo license file used for test and deployment.

    A license file in Demo state allows you to use normal functions within a specified period. Before the expiration of the license file in Demo state, replace it with a commercial license file.

  • Emergency

    In the emergency conditions like earthquake, volcano explosion, and tsunami, you can run the license emergency command to trigger a license file to enter the Emergency state. The Emergency state stays for seven days, and a license file can enter the Emergency state three times.

  • Default: No license file is activated or a license file expires.

    If a license file enters the Default state, services will be interrupted.

    If you want to use services after a license file expires or becomes invalid, apply for a new license file and activate it.

Revoke ticket

License revocation code. no ticket indicates that the license is permanently valid.

Product name

Name of the product that runs the license.

Product version

Product version.

License Serial No

Serial number of license file.

Creator

Creator of the file.

Created Time

Time when the file was created.

Feature name

Feature name.

Authorize type

Authorization type.
  • demo: trial authorization.
  • comm: commercial authorization.

Expired date

License expiration date. PERMANENT indicates that the license is permanently valid.

Trial days

Trial period of an expired license.
  • For a license file in the trail state, the trial period is 60 days. The value of this field is displayed as 60.
  • For a license file that is not in the trail state, this field is meaningless, and its value is displayed as --.

Item name

Name of a control item.

Item type

Type of a control item.

Value

Value of a control item.

Description

Description of a control item.

display license esn

Function

The display license esn command displays the equipment serial number (ESN) used for applying a license.

Format

display license esn

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

When you need to use licensed resource items or function items, apply to Huawei for a license file. When applying for a license, you need to provide the device ESN.

ESN is the only identifier of device components (such as MPU and interface board), run the display license esn command to display the ESN of the current device, and then use the ESN to apply a license file for the device.

The ESN of the chassis must be the same as the ESN in the license to be activated. If they are different, the license file cannot be activated.

Example

# Display the ESN used for applying a license.

<HUAWEI> display license esn
ESN: 2102113090P0xxxxxxxx
Table 2-85  Description of the display license esn command output

Item

Description

ESN

ESN of the device.

display license information

Function

The display license information command displays license information about the master and standby switches in a CSS system.

Format

display license information

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

  • If the control items of the license files on the standby and master switches are the same, the standby switch uses its own license file and does not synchronize the license file of the master switch. You can run the display license command to check the license control items. An active/standby switchover has no impact on the license files loaded on the master and standby switches.
  • If the control items of the license files on the standby and master switches are different, the standby switch synchronizes the license file of the master switch. The ESN in the synchronized license file will differ from the standby switch's ESN. If so, the license changes to the Trial state and enters the trial period. After an active/standby switchover, the license on the new master switch enters the trial period. You can run the display license information command on the master switch to check whether the switch's ESN is the same as the ESN in the license file.

Precautions

The display license command displays license information about the master switch only, whereas the display license information command displays license information about the master and standby switches in the CSS system.

If a switch is not in a CSS system, the display license information command displays license information about the switch only. If a CSS system contains the master and standby switches, the display license information command displays license information about the master and standby switches.

Follow-up Procedure

If the ESN of the standby switch differs from the ESN in the synchronized license file, the license enters the trial period. Apply for a new license file before the trial period expires according to the following process.

  1. Run the license revoke command on the master switch to obtain the revocation code of the license file on the switch.
  2. Run the display esn command on the master switch to collect ESNs of the master and standby switches.
  3. Log in to Huawei's license application website, and use the revocation code and ESNs of the master and standby switches to apply for a new license file for the CSS system.
  4. Run the license active license-name command on the master switch to activate the new license file.

Example

# Display license information about the master and standby switches in a CSS system.

<HUAWEI> display license information

Slot 1/9:
Current license file           : flash:/S12700V200R009_20160104100016.dat
Synchronize from master board  : YES
Current license file esn       : 020PBV10xxxxxxxx,020LCU6Txxxxxxxx
Current slot esn               : 020PBV10xxxxxxxx
License esn match with device  : YES

Slot 1/10:
Current license file           : flash:/S12700V200R009_20160104100016.dat
Synchronize from master board  : YES
Current license file esn       : 020PBV10xxxxxxxx,020LCU6Txxxxxxxx
Current slot esn               : 020PBV10xxxxxxxx
License esn match with device  : YES

Slot 2/13:
Current license file           : flash:/S12700V200R009_20160104100016.dat
Synchronize from master board  : YES
Current license file esn       : 020PBV10xxxxxxxx,020LCU6Txxxxxxxx
Current slot esn               : 020LCU6Txxxxxxxx
License esn match with device  : YES

Slot 2/14:
Current license file           : flash:/S12700V200R009_20160104100016.dat
Synchronize from master board  : YES
Current license file esn       : 020PBV10xxxxxxxx,020LCU6Txxxxxxxx
Current slot esn               : 020LCU6Txxxxxxxx
License esn match with device  : YES
Table 2-86  Description of the display license information command output

Item

Description

Slot

Slot ID.

Current license file

Current license file.

Synchronize from master board

Whether the license file is synchronized from the master switch.

For the master switch, the value is YES.

Current license file esn

ESN in the current license file.

Current slot esn

ESN of the switch.

License esn match with device

Whether the ESN in the license file matches the switch's ESN.

display license resource usage

Function

The display license resource usage command displays the usage of the resource items defined in a license file.

Format

display license resource usage

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can use the display license resource usage command to check the usage of the resource items defined in the license file.

Resource usage refers to the percentage of resources used out of resources defined by the license file.

Example

# Display the usage of licensed resources.

<HUAWEI> display license resource usage
Info: Active License on master board: flash:/lic_on199309_ad0f43b1d3c.dat             
 FeatureName    | ConfigureItemName       | ResourceUsage                       
                                                                                
 ACCESS            LLE0WLAN01                  0/1                              
 ACCESS            LE1SWLAN64AP                0/2                              
 ACCESS            LE1SWLAN32AP                0/3    
Table 2-87  Description of the display license resource usage command output

Item

Description

Activated License on master board

File name and path of an active license name.

FeatureName

Name of the feature controlled by the license.

ConfigureItemName

Name of a control item.

ResourceUsage

Percentage of used resources.

display license revoke-ticket

Function

The display license revoke-ticket command displays the revocation code of the current license file of the device.

Format

display license revoke-ticket

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display license revoke-ticket command enables you to check the revocation code of a license file that has become invalid on the device. This code proves that the current license file is invalid and is used to apply for a new license.

Precautions

This command displays information only when the license file in current device system is invalid. Otherwise, no command output is displayed.

Example

# Display the revocation code of the current invalid license file.

<HUAWEI> display license revoke-ticket
 Info: The revoke ticket is: LIC20091103006100:27C1B773ED11D9F877855CDAEE74ABFE60E07126.

display license state

Function

The display license state command displays the license status on the MPU.

Format

display license state

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To check the status of the running license, run this command. The command displays the current status of the license and the number of days before the license in this status will expire.

The system supports the following license states:

  • Normal: normal license
  • Demo: demonstration license
  • Trial: trial license that has expired but is still valid during the trial period
  • Emergency: emergency license
  • Default: default license

This command helps you locate license problems and verify the license status on the device.

Prerequisites

A license file has been stored on the main control board of the device and has been activated. This ensures that valid entries are displayed after the execution of the command. If the license file is not activated, no command output is displayed.

Example

# Display the status of the license on the MPU.

<HUAWEI> display license state
Info: Current license state is Emergency. 2 count remain. 2 days remain.

display module-information

Function

The display module-information command displays information about dynamically uploaded modules.

Format

display module-information [ verbose | next-startup ]

Parameters

Parameter Description Value
verbose

Displays detailed information about dynamically uploaded modules.

-

next-startup

Displays information about the module packages to be uploaded at the next startup.

-

Views

All views

Default Level

3: Management level

Usage Guidelines

After modules are uploaded, you can run the display module-information command to check information about these modules.

Example

# Display information about dynamically uploaded modules.

<HUAWEI> display module-information

                           Module Information
------------------------------------------------------------------------
Module     Version   InstallTime                     PackageName
------------------------------------------------------------------------
MACSEC     SPH       2011-01-16 16:39:18+00:00       s12700.mod

Total = 1

# Display detailed information about dynamically uploaded modules.

<HUAWEI> display module-information verbose

                           Module Information
------------------------------------------------------------------------
Module     Version   InstallTime                     PackageName
------------------------------------------------------------------------
MACSEC     SPH       2011-01-16 16:39:18+00:00       s12700.mod

Total = 1
Board Info:

------------------------------------------------------------------------
Slot       Module         State     Count Time(YYYY-MM-DD HH:MM:SS)
------------------------------------------------------------------------
0          MACSEC         Using     1     2011-01-16 16:39:17+00:00

Total = 1
Table 2-88  Description of the display module-information command output

Item

Description

Module Information

Module information.

Module

Module name.

Version

Module package version.

PackageName

Module package name.

InstallTime

Time when the module package was uploaded to the memory.

Total

The Total field under Module Information displays the number of module packages that take effect. The Total field under Board Info displays the number of boards that have modules installed.

Board Info

Board information.

Slot

Slot ID of the board where a module resides.

State

Status of the module.

Count

Number of modules that take effect on the board.

Time(YYYY-MM-DD HH:MM:SS)

Time when the module took effect, that is, time when the current module was loaded to the current state.

# Display information about the next startup modules configured in the system.

<HUAWEI> display module-information next-startup
Info: The result will be shown in several minutes. Please wait for a moment......

                      Next startup module packages
Total = 1
------------------------------------------------------------------------
No.  PackageName
------------------------------------------------------------------------
1    flash:/$_install_mod/s12700.mod
Table 2-89  Description of the display module-information next-startup command output

Item

Description

Next startup module packages

Information about module packages to be installed at the next startup.

Total

Number of module packages to be installed at the next startup.

No.

Sequence number of a module package to be installed at the next startup.

PackageName

Name of a module package to be installed at the next startup.

display paf

Function

The display paf command displays information about the product adaptive file (PAF) in the system.

Format

display paf { all [ slot slot-id ] | { resource | service } item-name }

Parameters

Parameter

Description

Value

all

Displays all information about the PAF file.

-

slot slot-id

Displays all information about the PAF file for the slot ID of a board.

-

resource

Specifies the value set for a resource item in the PAF file.

-

service

Specifies the value set for a service item in the PAF file.

-

item-name

Specifies the name of a resource item or a service item.

The value is a string of 1 to 64 characters.

Views

All views

Default Level

3: Management level

Usage Guidelines

A PAF file provides only required resources and features. This command can display all the specification information about the PAF file.

Example

# Display the value set for a resource item in the PAF file.

<HUAWEI> display paf resource PAF_LCS_NQA_SPECS_NUM_ENTRY
 PAF_LCS_NQA_SPECS_NUM_ENTRY = 1, 2000, 5000, 0

# Display the value set for a service item in the PAF file.

<HUAWEI> display paf service PAF_LCS_BFD_BASIC_SPECS_ENABLED 
 PAF_LCS_BFD_BASIC_SPECS_ENABLED = 0, 1
Table 2-90  Description of the display paf resource command output

Item

Description

PAF_LCS_NQA_SPECS_NUM_ENTRY

Resource item name in the PAF file.

1

Whether a resource item is controlled by a license.
  • 1: yes
  • 0: no

2000

Default value of the resource item in the PAF file.

5000

Maximum value of the resource item in the PAF file.

0

Minimum value of the resource item in the PAF file.

Table 2-91  Description of the display paf service command output

Item

Description

PAF_LCS_BFD_BASIC_SPECS_ENABLED

Service item name in the PAF file.

0

Whether a service item is controlled by a license.
  • 1: yes
  • 0: no

1

Service status.
  • 1: enabled
  • 0: disabled

display patch-information

Function

The display patch-information command displays information about the patch in the current system.

Format

display patch-information [ history ]

Parameters

Parameter Description Value
history

Displays historical information about the patch in the current system.

-

Views

All views

Default Level

3: Management level

Usage Guidelines

After a patch is loaded or deleted, run this command to view information about the patch, including its version, name, and status.

Example

# Display current information about the patch in the system.

<HUAWEI> display patch-information
Patch Package Name   :flash:/patch.pat
Patch Package Version:V200R008C00SPH001
The state of the patch state file is: Running
The current state is: Running

************************************************************************
*           Information about hot patch errors is as follows:          *
************************************************************************

     Slot            CurrentVersion
------------------------------------------------------------

No hot patch error occurs on any board.


************************************************************************
*                The hot patch information, as follows:                *
************************************************************************

 Slot       Type           State     Count Time(YYYY-MM-DD HH:MM:SS)
------------------------------------------------------------------------
 14         C              Running   1     2012-08-15 09:20:48+00:00            

# Display historical information about the patch in the system.

<HUAWEI> display patch-information history
************************************************************************        
*                The patch command history, as follows:                *        
************************************************************************        
                                                                                
 time(Y.M.D/HH:MM:SS)   state         size     patch-package name               
 -----------------------------------------------------------------------        
 2014.01.29/14:07:39  Startup       827318      patch_all_pack.pat       
 2014.10.13/11:33:12  Running         8404      patch_all_pack1.pat       
 2014.10.13/10:48:36     Idle       827318      patch_all_pack2.pat
Table 2-92  Description of the display patch-information command output

Item

Description

Patch Package Name

Name of the patch file.

Patch Package Version

Version of the patch.

The state of the patch state file is

Status of the patch file.

The current state is

Current status of the patch.

Slot

Slot ID of an interface board.

Type

Patch type.

  • C: single-core patch.

  • Core: multi-core patch. The value 0 indicates a master-core patch, and the value N indicates a slave-core patch.

  • HSP: bottom-layer software patch.

  • APP: upper-layer software patch.

  • ENP: indicates an ENP patch.

  • Kernel: indicates a kernel patch.

  • BIN: indicates a process patch.

  • C-WMP: multi-core WMP patch.

  • C-NAC: multi-core NAC patch.

State

Running status of the patch.

  • Deactive

  • Active

  • Running

  • Idle: no patch in the system

  • Startup: the patch file for next startup

Count

Number of patch units.

For kernel patches, the number of kernel patches in Active and Running states is displayed.

Time(YYYY-MM-DD HH:MM:SS)

Time when the patch takes effect.

size

Size of the patch.

display rollback

Function

The display rollback { information | result } command displays rollback information in the system.

Format

display rollback { information | result }

Parameters

Parameter

Description

Value

information

Displays version information after the system is rolled back.

-

result

Checks whether the rollback is successful.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

If an error occurs during an upgrade and you need to cancel the upgrade, run the rollback command to roll back the system to the previous version.

  • Before performing a rollback, you can run the display rollback information command to preview the version status after the rollback, including the system software, configuration file, and patch file used after the rollback, as well as the remaining time for the rollback function to take effect.
  • After completing the rollback, you can run the display rollback result command to check whether the rollback is successful.

Example

# Display rollback information in the system.

<HUAWEI> display rollback information
--------------------------------------------------------------------
MainBoard:
Software package: flash:/basicsoft.cc
Configuration file: flash:/vrpcfg.zip
Patch file: NULL
Rollback remain time: 00:16:49
--------------------------------------------------------------------
Slot 1/7:
Software package: flash:/basicsoft.cc
Configuration file: flash:/vrpcfg201506011523.zip
Patch file: NULL
Rollback remain time: 00:16:49
--------------------------------------------------------------------
Table 2-93  Description of the display rollback information command output

Item

Description

Software package

System software used after the rollback.

Configuration file

Configuration file used after the rollback.

This configuration file is the backup configuration file automatically generated by the system after the upgrade. The file name is in the format of filenameYYYYMMDDhhmm.zip.
  • filename: indicates the name of the configuration file before the upgrade.
  • YYYY: indicates the year.
  • MM: indicates the month.
  • DD: indicates the day.
  • hh: indicates the hour.
  • mm: indicates the minute.

If the file name is too long, the system automatically shortens the file name length to the required length.

Patch file

Patch file used after the rollback.

Rollback remain time

Remaining time for the rollback function to take effect.

# Check whether the rollback is successful after the rollback is complete.

<HUAWEI> display rollback result
Rollback result: Success.
Table 2-94  Description of the display rollback result command output

Item

Description

Rollback result

Rollback result:

  • Success: The rollback is successful.

  • Fail: The rollback fails.

    If the rollback fails, the system displays specific rollback failure information:
    • Software rollback fail: The system software fails to be rolled back.
    • Configuration rollback fail: The configuration file fails to be rolled back.
    • Patch rollback fail: The patch file fails to be rolled back.
Related Topics

display snmp-agent trap feature-name gtl all

Function

The display snmp-agent trap feature-name gtl all command displays all trap messages of the GTL module.

Format

display snmp-agent trap feature-name gtl all

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run the display snmp-agent trap feature-name gtl all command to check status of all GTL traps. This status can be configured using the snmp-agent trap enable feature-name gtl command.

Example

# Display all trap messages of the GTL module.

<HUAWEI> display snmp-agent trap feature-name gtl all
------------------------------------------------------------------------------
Feature name: GTL
Trap number : 3
------------------------------------------------------------------------------
Trap name                       Default switch status   Current switch status
hwGtlResourceUsedUp             on                      on
hwGtlNearDeadline               on                      on
hwGtlDefaultValue               off                     on
hwGtlResourceUsedUpCleared      on                      on
hwGtlNearDeadlineCleared        on                      on
hwGtlDefaultValueCleared        off                     on
hwGtlEsnMismatch                on                      on
hwGtlEsnMismatchCleared         on                      on
hwGtlItemInactive               on                      on
hwGtlItemInactiveCleared        on                      on
Table 2-95  Description of the display snmp-agent trap feature-name gtl all command output

Item

Description

Feature name

Name of the module to which a trap message belongs.

Trap number

Number of trap messages.

Trap name

Name of a trap message of the GTL module:

  • hwGtlResourceUsedUp: The trap was generated when the percentage of the resources used by the service module was not less than the threshold defined by the license.
  • hwGtlNearDeadline: The trap was generated when the system date was approaching the deadline of the service module defined in the license, that is, when the license entered the demo status.
  • hwGtlDefaultValue:The system used the default configuration of the license, when a license file became invalid.
  • hwGtlResourceUsedUpCleared: The trap was generated when the resource usage of the service module fell below the threshold.
  • hwGtlNearDeadlineCleared: The trap was generated when the old license file became invalid or the new license file took effect.
  • hwGtlDefaultValueCleared: The trap was generated when the system did not use default license configurations.
  • hwGtlEsnMismatch: The trap was generated when theslot ESN and the license ESN did not match.
  • hwGtlEsnMismatchCleared: The trap was generated when the slot ESN and the license ESN matched again.
  • hwGtlItemInactive: The service module to be controlled by the GTL file was not included in the file but the associated service was successfully configured.
  • hwGtlItemInactiveCleared: The trap was generated when the GTL file involving the current service module was activated.

Default switch status

Status of the default trap function:
  • on: indicates that the trap function is enabled.
  • off: indicates that the trap function is disabled.

Current switch status

Status of the current trap function:
  • on: indicates that the trap function is enabled.
  • off: indicates that the trap function is disabled.

display snmp-agent trap feature-name sspadp all

Function

The display snmp-agent trap feature-name sspadp all command displays the status of all traps on the SSPADP module.

Format

display snmp-agent trap feature-name sspadp all

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

After enabling the trap function for the SSPADP module, you can run the display snmp-agent trap feature-name sspadp all command to check the status of all traps on the SSPADP module. To enable the trap function for the SSPADP module, run the snmp-agent trap enable feature-name sspadp command.

Prerequisites

The SNMP function has been enabled on the switch. For details, see snmp-agent.

Example

# Display the status of all traps on the SSPADP module.

<HUAWEI>display snmp-agent trap feature-name sspadp all
------------------------------------------------------------------------------
Feature name: SSPADP
Trap number : 1
------------------------------------------------------------------------------
Trap name                       Default switch status   Current switch status
hwPatchDelNeedReStartTrap       on                      on
Table 2-96  Description of the display snmp-agent trap feature-name sspadp all command output

Item

Specification

Feature name

Name of the module that the trap belongs to.

Trap number

Number of traps.

Trap name

Name of a trap.

hwPatchDelNeedReStartTrap: The switch needs to be restarted after the patch is deleted.

Default switch status

Default status of the trap function:
  • on: indicates that the trap function is enabled by default.

  • off: indicates that the trap function is disabled by default.

Current switch status

Status of the trap function:

  • on: indicates that the trap function is enabled.

  • off: indicates that the trap function is disabled.

display virtual license

Function

The display virtual license command displays information about the virtual license file in the current system.

Format

display virtual license

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The controller delivers a virtual license to perform management. You do not need to load the entity license for the switch. This facilitates the management and control of the functions related to the entity license.

You can run this command to check detailed information about the virtual licence file in the current system, including the name of the virtual control item, status of the virtual license, and expiration date of the virtual license.

Example

<HUAWEI> display virtual license
                                                                                
Slot 14                                                                         
------------------------------------------------------------------------------- 
Item       Resource  License     Expired     Trial days  Item                   
Name       Value     Status      Date        Total       Description            
------------------------------------------------------------------------------- 
VXLAN      1         Demo        2019-02-16  -           VXLAN Control Function 
                                                                                
Slot 13                                                                         
------------------------------------------------------------------------------- 
Item       Resource  License     Expired     Trial days  Item                   
Name       Value     Status      Date        Total       Description            
------------------------------------------------------------------------------- 
VXLAN      1         Demo        2019-02-16  -           VXLAN Control Function 
Table 2-97  Description of the display virtual license command output

Item

Description

Slot

Slot ID.

Item Name

Name of a control item in the virtual license.

VXLAN: Control over the enhanced VXLAN functions. The enhanced VXLAN functions include the distributed VXLAN gateway function and the BGP EVPN function.

NOTE:

The license does not control route exchange between devices, but controls the status of the dynamic VXLAN tunnel established using BGP EVPN. If no license is loaded or the license becomes invalid, the dynamic VXLAN tunnel cannot be established using BGP EVPN.

Resource Value

Resource value of the control item.

License Status

Status of the virtual license.

  • Default: By default, no virtual license is installed on a device and the dynamic VXLAN tunnel is in Down status.
  • Normal: The commercial virtual license is activated. The device status is changed to Normal after the controller delivers a commercial virtual license to the device. The status can be restored to Default only through online retrieving, or the status is changed to Retrieving and then restored to Default through offline retrieving.
  • Demo: The temporary virtual license is activated. The device status is changed to Demo after the controller delivers a temporary virtual license to the device. The status can be restored to Default through online retrieving, offline retrieving, and trial keepalive.
  • Trial: The license is in keepalive status, indicating that the device status is automatically changed to trial keepalive after the validity period for the device in Demo status expires. The keepalive period is 60 days. After the keepalive period expires, the status is restored to Default and the dynamic VXLAN tunnel is in Down status.
  • Retrieving: The device status is changed to Retrieving if the device in Normal status is disconnected from the controller, and the offline retrieving period is 90 days. The device status is changed to Retrieving if the device in Demo status is disconnected from the controller, and the offline retrieving period is 60 days. After the retrieving period expires, the device status is restored to Default and the dynamic VXLAN tunnel is in Down status.

Expired Date

Expiration date of the virtual license.

Trial days Total

Total trial period of the virtual license.

Item Description

Description of a control item in the virtual license.

install-module

Function

The install-module command installs module packages.

By default, no module package is installed.

Format

install-module file-name [ next-startup ]

Parameters

Parameter Description Value
file-name

Specifies the name of a module package to be installed.

file-name supports file name association. The related file can be associated and displayed after you enter a specified character string.

The value is a string of 5 to 48 case-insensitive characters without spaces.

next-startup

Specifies the name of the module package to be installed during next startup.

-

Views

User view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

Software upgrade is a common method to add new services on a network. This method, however, is complex and affects services. To solve these problems, you can run the install-module command to install the module package of a desired function, without upgrading or powering off your device.

  • Run the install-module file-name command to load a module in the module package to the device. The module directly takes effect after being loaded. If the device is in a CSS, the module is loaded to all the devices in the CSS, including the master and standby switches.
  • Run the install-module file-name next-startup command to add the module package to the next startup module list. The device automatically loads the module next time it starts. Before a module package is installed dynamically, the system checks the module package validity. In the next startup module list, one module can exist in only one module package.

Precautions

  • The file name extension of the module package must be .MOD, and the file must be saved in the directory $_install_mod on the MPU.
  • The module package version must match the current system software version. Otherwise, the module package will fail to be installed.
  • The system allows you to install up to 16 modules.

Example

# Load the module package s12700.mod.

<HUAWEI> install-module s12700.mod
Info: Installing the module flash:/$_install_mod/s12700.mod..
.
Info: Succeeded in installing the module on the master board....

# Configure the module package to be loaded during next startup.

<HUAWEI> install-module s12700.mod next-startup
Info: The result will be shown in several minutes. Please wait for a moment.....
...
Info: Succeeded in setting the next-startup module.

license active

Function

The license active command activates the license file saved in the storage of the device.

Format

license active file-name

Parameters

Parameter

Description

Value

file-name

Specifies the name of a license file.

file-name supports file name association. The disk where the file resides can be automatically associated.
  • Full help: All the disks of the device can be associated and displayed.
  • Partial help: The related disk and file can be associated and displayed after you enter a specified character string.

The value is a string of 5 to 64 characters without spaces.

Views

User view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

Change or upgrade the license file when the current license file is outdated or needs higher specifications and more features. The initial state of a license file is inactive and the license file does not take effect in the system. Run this command to activate the new or updated license file.

The license active command can be used to activate a license file in the following situations:

  • The license needs to be activated for the first time.

    You can directly run this command to activate a license.

  • The current license file needs to be updated.

    If the specifications of the new license file are lower than those of the current license file, the system displays a message asking you whether to continue. If you choose No, the system retains the current license file. If you choose Yes, the master MPU activates the current license file and the system uses the new license file.

    If the configuration items of the new license file are lower than those of the current license file, check whether the configuration items required by services exist in the new license file. If not, apply for a correct license file and activate it. Otherwise, services may be interrupted due to lack of dependent license configuration items after the board or the device is restarted.

Prerequisites

The new license file has been uploaded to the device.

Follow-up Procedure

When the system restarts, the system activates the license file that was activated last time to ensure the license files are the same before and after restart.

Precautions

  • The license file must use .dat as file name extension and be saved to the default root directory in the storage of the device.
  • If no path is specified, the license file in the working path is activated by default.
  • The system needs to back up the specified license file to the slave MPU to ensure that the master and slave MPUs have the same license file. The license file on the slave MPU does not need to be activated.
  • If the specifications of the new license file are lower than those of the current license file (some functions are authorized in the current license file, but not in the new license file, or the new license file allows fewer resources than the current one), the system displays a message asking you whether to continue.

Example

# Activate license.dat in the storage of the device.

<HUAWEI> license active license.dat

license emergency

Function

The license emergency command enables the emergency state for the license.

Format

license emergency

Parameters

None

Views

User view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

The system configuration is classified into maximum configuration, authorized configuration, and minimum configuration.

  • In maximum configuration, the maximum number of dynamic resource items are configured. Static resource items and function items are configured according to license configuration.
  • Authorization configuration means the functions and resources of the software configured on the basis of contract or special authorization. Authorized configuration depends on feature authorization of license files.
  • The minimum configuration is the default configuration when no activated license file exists in the system. The minimum configuration varies according to products.

Configurations are classified to limit the bearer capability of the system in different running status.

When you run the license emergency command to enable the emergency state for the license, the system is free from license control. In this case, the system can run with the maximum configuration of dynamic resources and the license-defined configuration of static resources and functions. When the validity period of the emergency state expires, dynamic resources are controlled by the license again. One version is provided with three validity periods of emergency state, each lasting for seven days.

The purpose for enabling the emergency state for the GTL license is disaster tolerance. If an earthquake takes place, for example, this mechanism protects users' services from being affected.

Precautions

  • The emergency state cannot be disabled manually.
  • The emergency state can only be enabled three times for each license, and the license can keep in emergency state for 7 days each time.
  • The next emergency state can be enabled only on the last day when the last emergency state expires.
  • After the emergency state is enabled, the device provides maximum number of resource control items contained in the loaded license. The device does not provide resource control items that are not contained in the loaded license even through the emergency state is enabled.

Example

# Enable the license emergency state.

<HUAWEI> license emergency
Warning: This operation will cause LCS into the EMERGENCY state. Continue? [Y/N]:y
Info: Emergency started cannot be stopped.
Related Topics

license revoke

Function

The license revoke command revokes a license file.

Format

license revoke

Parameters

None

Views

User view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

License is an authorization file. You can apply for, upgrade, or activate the license file to get corresponding user rights.

If new devices are deployed, you can purchase new licenses as needed to enable license-controlled features and functions on the devices. This reduces purchase costs. If the capacities of the existing devices need to be expanded, you can update the licenses used on the devices to enable more license-controlled features and functions.

You can upgrade a license file to:

  • Add new features.
  • Optimizes device performance.
  • Fix bugs in the current version.

Before updating a license file, run the license revoke command to revoke the existing license. The system then returns a license revocation code. This code is the evidence for license invalidation and is used to apply for a new license.

NOTE:

A license revocation code is a character string generated after a license file becomes invalid. You can determine that a license file is invalid based on the corresponding revocation code.

Precautions

  • When the existing license is going to expire, apply for a new license, upgrade, and activate the license. If the license has expired, the service modules are disabled and services are interrupted.

  • After you run the license revoke command, the license file enters the Trial state and cannot be activated again regardless of how long the license file will expire.

Example

# Revoke the current license file.

<HUAWEI> license revoke
Warning: The license will enter the Trial state and will not be activated again.
 Continue?[Y/N]: y
Related Topics

license verify

Function

The license verify command verifies the license file of the device.

Format

license verify file-name

Parameters

Parameter Description Value
file-name Specifies the name of a license file.
file-name supports file name association. The disk where the file resides can be automatically associated.
  • Full help: All the disks of the device can be associated and displayed.
  • Partial help: The related disk and file can be associated and displayed after you enter a specified character string.
The value is a string of 5 to 64 characters without spaces.

Views

User view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

Before running the license active command to activate a license file, verify the license file.

The result of the license verify command can be the following:
  • Major error

    The license file cannot be activated.

  • Minor error

    The license file may be unable to be activated.

  • Success

    The license file can be activated.

Prerequisites

The license file has been saved on the MPU of device.

Example

# Verify the license file license.dat.
<HUAWEI> license verify license.dat
Info: Verify license succeeded.
Related Topics

patch active all

Function

The patch active all command activates the patches on the current system.

By default, the loaded patches on the current system are inactive.

Format

patch active all

Parameters

None

Views

User view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

If you do not specify the active or run keyword when running the patch load command, run the patch active all command to activate all the loaded patches to make them effect.

Prerequisites

Patches have been loaded using the patch load command.

Configuration Impact

  • After a non-incremental patch is loaded and the patch active all command is run, the patches in the current system are activated.

  • If an incremental patch is loaded and the previous patch package is running, the previous patch package is still in running state after you run the patch active all command. The new patch package is activated.

Follow-up Procedure

After running the patch active all command, use the patch run all command to run the activated patch.

Precautions

After you run the patch active all command:
  • If only one board is restarted, all the patches on the board remain active.

  • If the device is restarted, all the active patches become inactive. To reactivate the patches, run the patch active all command.

To make the patches become active, run the patch active all command again.

The active state can prevent a patch error from causing continuous faults of the system. If a patch has a bug and the patch is in the active state, restart the device to prevent the patch from taking effect.

Example

# Activate all patches.

<HUAWEI> patch active all

patch configuration-synchronize

Function

The patch configuration-synchronize command synchronizes the patch configuration and patch file from the master MPU to the slave MPU.

Format

patch configuration-synchronize

Parameters

None

Views

User view

Default Level

3: Management level

Usage Guidelines

After a slave MPU is replaced or a new one is added, run this command to synchronize patch configuration and patch files from the master MPU to the slave MPU.

Example

# Synchronize the patch configurations and patch files to the slave MPU.

<HUAWEI> patch configuration-synchronize
100%  complete/
Info: Copied file flash:/ patch.pat to slave#flash:/patch.pat...Done.
Info: Succeeded in synchronizing the patch configuration to slot 10.
Info: Finished synchronizing the patch package file and the patch configuration.

patch deactive all

Function

The patch deactive all command deactivates the patches on the current system.

Format

patch deactive all

Parameters

None

Views

User view

Default Level

3: Management level

Usage Guidelines

This command does not take effect in the current version. During the operation, if a bug is detected in a patch and the system software problem cannot be solved, run the patch delete all command to delete the patches in the patch area in the memory.

Example

# Deactivate patches on the current system.

<HUAWEI> patch deactive all
Warning: This function is no longer supported in the current version.

patch delete all

Function

The patch delete all command deletes patches on the current system.

Format

patch delete all

Parameters

None

Views

User view

Default Level

3: Management level

Usage Guidelines

  • If you find errors in patches that have been loaded to the system, run this command to delete the patches to prevent patch errors from affecting system operating.
  • Before loading a non-incremental patch, run this command to delete the existing patches (if any). Otherwise, the non-incremental patch cannot be loaded.
  • After the patch is deleted, it is recommended that you restart the switch.

Example

# Delete all patches.

<HUAWEI> patch delete all
Warning: The device needs to restart after the patch is deleted.
This will delete the patch. Are you sure? [Y/N]

patch load

Function

The patch load command loads the patches to the patch areas in the system.

Format

patch load filename all [ active | run ]

Parameters

Parameter

Description

Value

filename

Specifies the path and file name of a patch package. The path can be an absolute path or a relative path.

file-name supports file name association. The disk where the file resides can be automatically associated.
  • Full help: All the disks of the device can be associated and displayed.
  • Partial help: The related disk and file can be associated and displayed after you enter a specified character string.

The value is a string of 5 to 48 case-insensitive characters without spaces. The file name must have an extension of .pat.

all

Loads the patches of all boards.

-

active

Activates loaded patches of all boards.

-

run

Runs loaded patches of all boards.

-

Views

User view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

When you load a patch to the current system, the system searches the patch package for a matching patch file according to the attributes of the patch file.
  • If a matching patch file is found in the patch package, the system loads the patch.
  • If no matching patch file is found in the patch package, the system does not load any patch.

Prerequisites

The patch package has been uploaded to the root directory of the storage device.

Before loading a patch, the system must resolve the patch package, check the validity of the patch files in the patch package, and obtain the attributes such as the patch type and version of the patch file.

Precautions

The patch file cannot be reloaded. When you reload a patch, the system displays an error message.

After this command is run, the system loads all types of patches in the patch package.
  • If the active parameter is specified, the system activates the loaded patches directly. Then you can use the patch run all command to run the patches.
  • If the run parameter is specified, the system runs the loaded patches directly.

Example

# Load the patches to the patch area of the device and run the patches directly.

<HUAWEI> patch load patch.pat all run

patch run all

Function

The patch run all command runs the patches on the current system.

Format

patch run all

Parameters

None

Views

User view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

When a board is reset, an active/standby switchover occurs, or the device is restarted, the active patches become deactivated and need to be activated again. To enable the active patches to retain in running start after a board reset, an active/standby switchover or a device restart, use this command to run these active patches.

Prerequisites

Patches have been loaded and activated on the system.

Configuration Impact

After you run this command to run patches on the current system, the patches remain in the running state if a board reset, an active/standby switchover or a device restart occurs.

After the patch run all command is run, the patches enter running state and cannot be restored to the previous state. Confirm the action before you run the command.

Example

# Run active patcheson the current system.

<HUAWEI> patch run all

reset patch-configure

Function

The reset patch-configure command deletes the configuration of the patch file for next startup.

Format

reset patch-configure [ next-startup ]

Parameters

Parameter Description Value
next-startup Deletes the configuration of the patch file for next startup. -

Views

User view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

After you run the startup patch command to specify the patch file for next startup, you can use the reset patch-configure command to delete the configuration.

Precautions

If you run the reset patch-configure command, the patch file for next startup is empty. When the device restarts, the system does not load and run the patch file.

Example

# Delete the configuration of the patch file for next startup.

<HUAWEI> reset patch-configure next-startup
Info: The result will be shown in several minutes. Please wait for a moment.....
...                                                                             
Info: Succeeded in resetting the next-startup patch state. 
Related Topics

rollback

Function

The rollback command rolls back the system to the previous version.

Format

rollback

Parameters

None

Views

User view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

If an error occurs during an upgrade and you need to cancel the upgrade, run the rollback command to roll back the system to the previous version. After the rollback, the configuration of the device is the same as the previous configuration.

Precautions

  • The rollback function takes effect only for an upgrade during which the reboot command is run to restart the device, and does not support other upgrade modes, such as the EasyDeploy upgrade and smooth cluster upgrade. If the reboot command is run to complete an upgrade and then the system is upgraded using another mode, you can only run the rollback command to roll back the system to the latest version before the upgrade during which the reboot command is run. For example, if you run the reboot command to restart the device and upgrade the system from V1.0 to V1.1, and then upgrade the system to V1.2 using EasyDeploy, the system can only be rolled back to V1.0 when you run the rollback command to perform a system rollback.

  • If a device runs continuously for more than 48 hours after being upgraded, the rollback function does not take effect. If the device runs continuously for less than 48 hours and restarts, the system sets the remaining time to zero and the rollback function does not take effect. You can run the display rollback information command to check the remaining time for the rollback function to take effect.

  • If the system software, configuration file, or patch file required in the rollback is deleted using the delete (user view) command, the system prompts that the rollback function cannot be used when you run the rollback command.

If you run the rollback command to roll back the system software, the current configuration of the device will be lost. Therefore, exercise caution when deciding to run this command.

Prerequisites

The device contains the system software, configuration file, and patch file that are used after the rollback and displayed in the display rollback information command output.

Example

# Roll back the system to the previous version.

<HUAWEI> rollback
Info: Checking rollback version information...
Rollback software: flash:/basicsoft.cc
Rollback configuration: flash:/vrpcfg.zip
Rollback patch: NULL
Warning: The version running before the last reboot/reboot fast operation is performed will be restored, and the current configuration will be lost. Continue? [Y/N]:y
Related Topics

snmp-agent trap enable feature-name gtl

Function

The snmp-agent trap enable feature-name gtl command enables the trap function of the gtl module.

The undo snmp-agent trap enable feature-name gtl command disables the trap function of the gtl module.

For details about whether the trap function for the gtl module is enabled or disabled by default, see display snmp-agent trap feature-name gtl all.

Format

snmp-agent trap enable feature-name gtl [ trap-name { hwgtldefaultvalue | hwgtldefaultvaluecleared | hwgtlneardeadline | hwgtlneardeadlinecleared | hwgtlresourceusedup | hwgtlresourceusedupcleared | hwgtlesnmismatch | hwgtlesnmismatchcleared | hwgtliteminactive | hwgtliteminactivecleared } ]

undo snmp-agent trap enable feature-name gtl [ trap-name { hwgtldefaultvalue | hwgtldefaultvaluecleared | hwgtlneardeadline | hwgtlneardeadlinecleared | hwgtlresourceusedup | hwgtlresourceusedupcleared | hwgtlesnmismatch | hwgtlesnmismatchcleared | hwgtliteminactive | hwgtliteminactivecleared } ]

Parameters

Parameter

Description

Value

trap-name Enables the traps of GTL events of specified types. -
hwgtldefaultvalue Enables the device to send a trap when a license file became invalid, the system used the default configuration of the license -
hwgtldefaultvaluecleared Enables the device to send a trap when the trap, indicating that the system used the default license configurations, was cleared. -
hwgtlneardeadline Enables the device to send trap when the system date was approaching the deadline of the service module defined in the license. -
hwgtlneardeadlinecleared Enables the device to send a trap when the license no longer approached the deadline. -
hwgtlresourceusedup Enables the device to send a trap when the percentage of the resources used by the service module was not less than the threshold defined by the license. -
hwgtlresourceusedupcleared Enables the device to send a trap when the number of resources used by the service module fell below the threshold. -
hwgtlesnmismatch Enables the device to send a trap when the slot ESN and the license ESN do not match. -
hwgtlesnmismatchcleared Enables the device to send a trap when the slot ESN and the license ESN match again. -
hwgtliteminactive Enables the device to send a trap when the service module to be controlled by the GTL file is not included in the file but the associated service is successfully configured. -
hwgtliteminactivecleared Enables the device to send a trap when the GTL file involving the current service module is activated. -

Views

System view

Default Level

2: Configuration level

Usage Guidelines

To enable the traps of one or more events, you can specify type-name.

Example

# Enable the trap function of the gtl module.

<HUAWEI> system-view
[HUAWEI] snmp-agent trap enable feature-name gtl

snmp-agent trap enable feature-name sspadp

Function

The snmp-agent trap enable feature-name sspadp command enables the trap function for the SSPADP module.

The undo snmp-agent trap enable feature-name sspadp command disables the trap function for the SSPADP module.

By default, the trap function is enabled for the SSPADP module.

Format

snmp-agent trap enable feature-name sspadp [ trap-name hwpatchdelneedrestarttrap ]

undo snmp-agent trap enable feature-name sspadp [ trap-name hwpatchdelneedrestarttrap ]

Parameters

Parameter

Description

Value

trap-name

Enables or disables the trap function for a specified event of the SSPADP module.

-

hwpatchdelneedrestarttrap

Enables the switch to send a Huawei proprietary trap when the patch in the system is deleted.

-

Views

System view

Default Level

2: Configuration level

Usage Guidelines

After the trap function is enabled, the switch generates traps during operation and sends the traps to the NMS through the SNMP module. If the trap function is disabled, the switch does not generate traps and the SNMP module does not send traps to the NMS.

Example

# Enable the hwpatchdelneedrestarttrap trap function for the SSPADP module.

<HUAWEI> system-view
[HUAWEI] snmp-agent trap enable feature-name sspadp trap-name hwpatchdelneedrestarttrap

uninstall-module

Function

The uninstall-module command uninstalls module packages.

Format

uninstall-module file-name [ next-startup ]

uninstall-module next-startup all

Parameters

Parameter Description Value
file-name

Specifies the name of a module package to be uninstalled.

The value is a string of 5 to 48 case-insensitive characters without spaces.

next-startup

Clears the module list for next startup.

-

all

Clears the module list for next startup.

-

Views

User view

Default Level

3: Management level

Usage Guidelines

If some services or functions are not required, run the uninstall-module command to uninstall the corresponding modules running in the system.

Example

# Uninstall the module package s12700.mod from the system.

<HUAWEI> uninstall-module s12700.mod
This will uninstall the module. Are you sure? [Y/N]y....
Info: Succeeded in uninstalling the module on the master board.

# Clear a specified module package in the next startup module list.

<HUAWEI> uninstall-module s12700.mod next-startup
Info: The result will be shown in several minutes. Please wait for a moment.....
...
Info: Succeeded in resetting the next-startup module.

upgrade all

Function

The upgrade all command upgrades the system file.

Format

upgrade all { startup | filename } [ force ]

Parameters

Parameter Description Value
startup Uses the running system software to upgrade the system file. -
filename

Specifies the name of the system file that is used to upgrade the system.

The value is a string of 1 to 64 characters. The format is flash:/xxx.cc.
force

Indicates forcible upgrade.

-

Views

User view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

To restart the system faster, you can run this command to upgrade the system file before the restart.

Precautions

Services are interrupted during a board upgrade or logical software upgrade using this command.

If some of the current system files are of earlier versions when you run the upgrade all startup command, you need to restart the device to upgrade the device to the latest version. If all the current system files are of the latest version, you do not need to restart the device.

Example

# Forcibly upgrade the system using the current startup file.

<HUAWEI> upgrade all startup force
Warning: The upgrade board may be reset. Please do not switchover, reset, remove
, or power off the board when upgrade is being performed. Please keep system sta
ble.                                                                            
Info: Confirm to upgrade, continue?[y/n]:y                                      
Prepare to upgrade slot 3, item bootrom, mode: online. waiting......            
                                                                                
Info: Online upgrade bootrom on slot 3 successfully.                            
Prepare to upgrade slot 3, item bootload, mode: online. waiting......           
                                                                                
Info: Online upgrade bootload on slot 3 successfully.                           
Prepare to upgrade slot 4, item bootrom, mode: online. waiting......            
Info: Online upgrade bootrom on slot 4 successfully.                            
Prepare to upgrade slot 4, item bootload, mode: online. waiting......           
Info: Online upgrade bootload on slot 4 successfully.                           
Prepare to upgrade slot 4, item cpld0, mode: online. waiting......              
Info: Online upgrade cpld0 on slot 4 successfully.                              
Prepare to upgrade slot 5, item bootrom, mode: online. waiting......            
Info: Online upgrade bootrom on slot 5 successfully.                            
Prepare to upgrade slot 5, item bootload, mode: online. waiting......           
Info: Online upgrade bootload on slot 5 successfully.                           
Prepare to upgrade slot 5, item cpld0, mode: online. waiting......              
Info: Online upgrade cpld0 on slot 5 successfully.                              
Info: The new version on the board will come into effect after reset. 
Table 2-98  Description of the upgrade all startup force command output

Item

Description

Slot

Slot ID of a board.

Item

Items to be upgraded.

mode

Mode in which the upgrade file is loaded.

Info

Upgrade result.

Translation
Download
Updated: 2019-04-09

Document ID: EDOC1100065659

Views: 123697

Downloads: 88

Average rating:
This Document Applies to these Products
Related Version
Related Documents
Share
Previous Next