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

Command Reference

S7700 and S9700 V200R011C10

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).
Configuring System Startup Commands

Configuring System Startup 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 file-integrity

Function

The check file-integrity command checks whether a file is consistent with the corresponding signature file.

Format

check file-integrity filename signature-filename

Parameters

Parameter

Description

Value

filename

Specifies the name of a file to be checked. The file must exist.

The value is a string of 4 to 64 case-insensitive characters without spaces. The file name extension can be .cc, .pat, .zip, or .7z.

signature-filename

Specifies the name of the signature file corresponding to the file to be checked. The signature file must exist.

The value is a string of 5 to 64 case-insensitive characters without spaces. The file name extension must be .asc.

Views

System view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

You can run this command to check whether a file is consistent with the corresponding signature file. If the check fails, the file cannot be used as the system software, patch file, or web page file.

NOTE:
Signature files are released with each version. Each valid system software, patch file, or web page file has a corresponding signature file. You need to upload the signature file to the switch before using this command.

Example

# Check whether the system software is consistent with the corresponding signature file.

<HUAWEI> system-view
[HUAWEI] check file-integrity S9700-V200R011C10SPC500.cc S9700-V200R011C10SPC500.cc.asc

clear configuration interface

Function

Using the clear configuration interface command, you can perform one-touch configuration clearance on an interface.

Format

clear configuration interface interface-type interface-number

Parameters

Parameter Description Value
interface-type interface-number Indicates the type and number of the interface where one-touch configuration clearance is performed. At present, the tunnel and css-port interfaces are not supported.

Views

System view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

To configure an interface on a device for other use, original configurations on the interface need to be deleted one by one. If the interface has a large number of configurations, deleting these configurations one-by-one takes a long time and increases the maintenance workload. To reduce the maintenance workload and simplify the deletion operation, you can use this command to perform one-touch configuration clearance on an interface.

You can also run the clear configuration this command in the system view to delete configurations on a specified interface.

NOTE:

The one-touch configuration clearance function cannot delete the combo-port command on an interface.

Configuration Impact

After this command is run, all configurations on an interface will be cleared. The status of the interface is shutdown.

Precautions

The execution of this command takes a long time. To terminate the running command, press Ctrl+C.

In general, after the clear configuration this command is run on an interface to clear the configuration, the default configuration is restored. If special configurations exist on the interface on which the clear configuration this command is run, the configuration may be displayed in the undo command format.

Example

# Perform one-touch configuration clearance on GigabitEthernet1/0/1.

<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 1/0/1
[HUAWEI-GigabitEthernet1/0/1] display this
#
interface GigabitEthernet1/0/1
 port link-type hybrid
 port hybrid pvid vlan 50
#
return
[HUAWEI-GigabitEthernet1/0/1] quit
[HUAWEI] clear configuration interface gigabitethernet 1/0/1
Warning: All configurations of the interface will be cleared, and its state will
 be shutdown. Continue? [Y/N] :y...
Info: Total execute 2 command(s), 2 successful, 0 failed. 
[HUAWEI] interface gigabitethernet 1/0/1
[HUAWEI-GigabitEthernet1/0/1] display this
#
interface GigabitEthernet1/0/1
 shutdown
#
return

clear configuration this

Function

The clear configuration this command deletes configurations on an interface at a time to restore the default configurations.

Format

clear configuration this

Parameters

None

Views

Interface view (excluding tunnel interface view, css-port interface view, and port group view)

Default Level

3: Management level

Usage Guidelines

Usage Scenario

To configure an interface on a device for other use, original configurations on the interface need to be deleted one by one. If the interface has a large number of configurations, deleting these configurations one-by-one takes a long time and increases the maintenance workload. To reduce the maintenance workload and simplify the deletion operation, you can use this command to perform one-touch configuration clearance on an interface.

You can also run the clear configuration interface interface-type interface-num command in the system view to delete configurations on a specified interface.

Configuration Impact

After you run the clear configuration this command, the system displays a message, asking you whether to delete the configurations on the specified interface. If you enter Y, all configurations on the specified interface are deleted and the interface status becomes shutdown.

Running the clear configuration this command on an interface is similar to running undo commands on the interface in batches.

Precautions

The execution of this command takes a long time. To terminate the running command, press Ctrl+C.

In general, after the clear configuration this command is run on an interface to clear the configuration, the default configuration is restored. If special configurations exist on the interface on which the clear configuration this command is run, the configuration may be displayed in the undo command format.

As some commands correlate to each other, if you run the undo command to delete the configurations of a command, the configurations of the correlated command are also deleted. After the clear configuration this command is run on an interface, the statistics in the command output may be inconsistent with actual clearance results. Refer to the actual clearance results in real-world applications.

Example

# Perform one-touch configuration clearance on GigabitEthernet1/0/1.

<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 1/0/1
[HUAWEI-GigabitEthernet1/0/1] display this
#
interface GigabitEthernet1/0/1
 description abc
 port link-type access
#
return
[HUAWEI-GigabitEthernet1/0/1] clear configuration this
Warning: All configurations of the interface will be cleared, and its state will be shutdown. Continue? [Y/N] :y
Info: Total 2 command(s) executed, 2 successful, 0 failed.
[HUAWEI-GigabitEthernet1/0/1] display this
#
interface GigabitEthernet1/0/1
 shutdown
#
return

clear inactive-configuration slot

Function

The clear inactive-configuration slot command deletes the inactive configurations from the board that does not operate.

Format

clear inactive-configuration slot slot-id

Parameters

Parameter Description Value
slot-id Specifies the slot ID of a board that does not operate.

The value range depends on the device configuration.

Views

System view

Default Level

3: Management level

Usage Guidelines

After a board has been replaced, using the clear inactive-configuration slot command deletes the configurations of the board that does not operate if these configurations do not need to be saved.

Running the clear inactive-configuration slot command can delete the inactivate configurations and the sub-interfaces from the board that does not operate.

Before using this command, ensure that the specified board on which configurations are to be deleted does not operate.

This command can be run by only one user at a time to delete inactive configurations from a specified interface.

Example

# Delete the configurations from the board that does not operate in slot 7.

<HUAWEI> system-view
[HUAWEI] clear inactive-configuration slot 7
Warning: The inactive configuration of slot 7 will be deleted and can't be restored.
Are you sure to continue?[Y/N] y
The command will takes a few minutes, please wait..
Info: Succeeding in clearing the inactive configuration.

configuration backup local disable

Function

The configuration backup local disable command disables the device from backing up the running configurations locally.

The undo configuration backup local disable command enables the device to back up the running configurations locally.

By default, the device is enabled to back up the running configurations locally.

Format

configuration backup local disable

undo configuration backup local disable

Parameters

None

Views

System view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

To automatically back up the current running configurations to the local storage after the device configurations are modified, run the undo configuration backup local disable command to enable automatic backup of the current running configurations. This function helps check historical records of configuration changes and facilitate fault location.

Precautions

  • When the device is enabled to back up the current running configurations, the current running configurations are backed up 2 hours after the device configurations are modified. If saving or automatic saving operation is performed, conflicts may occur. The configuration backup will be triggered every 30 minutes until the backup succeeds.
  • If the CPU usage exceeds 60% during the configuration backup, the configuration backup will be triggered every 30 minutes until the backup succeeds.
  • Delivering a configuration command fails during the configuration backup.
  • If the current configurations are consistent with the configurations saved last time, the device does not repeatedly back up the current configurations to the local storage.

Rules for backup file management:

  • The local storage path is $_backup/running_config/.
  • The format of the backup file name is yyyymmddhhmmss.sysname.zip, where yyyymmdd indicates the year, month, and day, hhmmss indicates the hour, minute, and second, and sysname indicates the host name of the device.
  • Backup files are aged based on the aging rules each time when the number of backup files exceeds 30, when the total space used by backup files exceeds 10 MB, or when the remaining storage space is less than 30 MB.
  • The backup file aging stops when the number of backup files is 5 or less.

Rules for backup file aging:

  • A number and an aging priority are specified for a backup file based on the file generation time.
    NOTE:

    File number: The latest file generated is numbered 1, the file generated before the latest file is numbered 2, and so on. A larger number indicates an earlier generation time.

    File aging priority: The file with a smaller file number has a higher priority. Files with a lower priority are aged first. Note that files with priority 0 are not aged. If a file has multiple priorities, refer to the highest priority.

    • Priority 0: files numbered from 1 to 5
    • Priority 1: files numbered from 6 to 10
    • Priority 2: the last generated files on each day in the past week
    • Priority 3: the last generated files in each month in the past 5 months
    • Priority 4: other backup files
  • Note for backup file aging:
    • The backup files are aged in time sequence based on the priority. A backup file generated earlier is aged first.

Example

# Disable the device from backing up the running configurations locally.

<HUAWEI> system-view
[HUAWEI] configuration backup local disable

configuration copy file to running

Function

The configuration copy file to running command executes commands in a specified configuration file.

Format

configuration copy file file-name to running

Parameters

Parameter Description Value
file-name Specifies the name of a configuration file to be executed. The value is a string of 4 to 160 characters in the [ drive ] [ path ] file-name format. The file name extension must be .cfg or .zip.

Views

User view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

To execute an existing configuration file, run the configuration copy file to running command. All the commands in the specified configuration file are executed at one time.

Precautions

Only one user can execute the configuration copy file to running command at one time.

If configuration restoration occurs or a batch backup operation is performed, the configuration copy file to running command ends.

If a command fails during the execution of the configuration copy file to running command, the system skips it and executes the next command.

Example

# Execute the commands in the huawei.cfg file.

<HUAWEI> configuration copy file huawei.cfg to running
Warning: This operation may take a long time, press CTRL+C to break. Continue?[Y/N]:y

configuration copy startup to file

Function

The configuration copy startup to file command backs up the startup configuration file to a specified file.

Format

configuration copy startup to file file-name

Parameters

Parameter Description Value
file-name Specifies the name of a destination file. The value is a string of 4 to 160 characters in the [ drive ] [ path ] file-name format. The file name extension must be .cfg or .zip. The extension of the destination file and the backup file must be the same.

Views

User view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

To back up the startup configuration file, run the configuration copy startup to file command.

Precautions

If a file with the same name already exists, the system asks whether to replace the previous file. Press Y to replace the file or N not to do so.

Example

# Back up the startup configuration file to the huawei.cfg file.

<HUAWEI> configuration copy startup to file huawei.cfg

compare configuration

Function

The compare configuration compares whether the current configurations (including offline configurations) are identical with the next startup configuration file.

Format

compare configuration [ configuration-file ] [ current-line-number save-line-number ]

Parameters

Parameter Description Value
configuration-file Specifies the name of the configuration file to be compared with the current configurations. The value is a string of 5 to 48 case-insensitive characters without spaces.
current-line-number Specifies the line number for comparison in the current configuration. The value is an integer that ranges from 0 to 65535.
save-line-number Specifies the line number for comparison in the saved configuration. The value is an integer that ranges from 0 to 65535.

Views

User view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

If current-line-number and save-line-number are not specified, the configuration files are compared from the first lines. The two parameters can be specified to skip the differences that are found and continue the comparison.

The compare configuration command outputs display the current configuration file (including offline configurations) and the saved configuration file from the line that contains differences respectively. By default, the output difference information is restricted to 120 characters.

  • If the characters from differences to the end of the configuration file are less than 120, the system displays the output difference information till the end of the configuration file.
  • If the characters from differences to the end of the configuration file are more than 120, the system only displays 120 characters.

Precautions

  • The configuration file name extension must be .cfg or .zip.

  • If configuration-file is not specified, the system compares whether the current configurations (including offline configurations) are identical with the next startup configuration file.

  • If configuration-file is specified, the system compares whether the current configurations (including offline configurations) are identical with the specified startup configuration file.

Example

# Compare whether the current configurations (including offline configurations) are identical with the next startup configuration file.

<HUAWEI> compare configuration
Info: The system is now comparing the configuration, please wait....
Warning: The current configuration is not the same as the next startup 
configuration file. There may be several differences, and the following are some 
configurations beginning from the first: 
====== Current configuration line 6 ======
 vlan batch 1 to 2 10 to 11 15 70 to 71 91 to 92 100 111 230 240 901
 vlan batch 911 1111
#
 l2protocol-tunnel vtp group-mac 0100-0ccd-ffff

 ====== Configuration file line 6 ======
 vlan batch 1 to 2 10 to 11 15 70 91 to 92 100 111 230 240 901
 vlan batch 911 1111
#
 l2protocol-tunnel vtp group-mac 0100-0ccd-ffff  
Related Topics

display changed-configuration time

Function

The display changed-configuration time command displays the time of the last configuration change.

Format

display changed-configuration time

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

After changing the configuration of the device, you can run the display changed-configuration time command to view the time of the last configuration change.

Example

# Display the time of the last configuration change.

<HUAWEI> display changed-configuration time

display configuration recover-result

Function

The display configuration recover-result command displays the configuration recovery result.

Format

display configuration recover-result

Parameters

None

Views

All views

Default Level

3: Management level

Usage Guidelines

Usage Scenario

You can use the display configuration recover-result command to view the information about the configuration recovery result and records of configuration recovery failures. The records include the command that fails the configuration recovery, the view in which the command resides, the line number of the command in the current startup configuration file, the reason why the command fails, and the execution time of the configuration recovery.

This command displays a maximum of 256 records in time sequence. The latest record is displayed in the last. If the number of commands for configuration recovery exceeds 256, the device no longer records commands that fail the configuration recovery.

Prerequisites

The device has restarted and the configuration recovery is successful.

Example

# Display the configuration result.

<HUAWEI> display configuration recover-result
The current startup saved-configuration file is cfcard:/vrpcfg.zip.
The number of failed commands is 2. 
----------------------------------------------------------------------

Command : ip address 10.85.1.1 255.255.255.0
View    : Vlanif85
Line    : 414
Reason  : Failed to parse the command.
Time    : 10:00:06  2012-07-25 UTC+08:00 DST

Command : ip address 10.86.1.1 255.255.255.0
View    : Vlanif86
Line    : 417
Reason  : Failed to parse the command.
Time    : 10:00:06  2012-07-25 UTC+08:00 DST 

----------------------------------------------------------------------
Table 2-63  Description of the display configuration recover-result command output

Item

Description

Command

Command that fails the configuration recovery

View

View in which the command resides

Line

Line number of the command in the current startup configuration file

Reason

Reason why the command fails

Time

Execution time of the configuration recovery

display current-configuration

Function

The display current-configuration command displays the currently running configuration.

This command does not display parameters that use default settings.

Format

display current-configuration [ configuration [ configuration-type [ configuration-instance ] ] | interface [ interface-type [ interface-number ] ] ] [ feature feature-name ] [ filter filter-expression ]

display current-configuration [ all | inactive ]

display current-configuration configuration vpn-instance [ vpn-instance-name ] related

Parameters

Parameter

Description

Value

configuration

Displays all configuration information, except for the configuration on interfaces.

-
configuration-type

Specifies information about the configuration that is a specified type, except for the configuration on interfaces.

The configuration type depends on the existing configuration. For example:
  • system: system configuration
  • user-interface: user interface configuration
  • aaa: AAA configuration
-
configuration-instance

Specifies information about the specified configuration instance, except for the configuration on interfaces.

The configuration instance depends on the existing configuration.

The value is a string of 1 to 80 case-insensitive characters without spaces.
interface [ interface-type [ interface-number ] ]

Specifies an interface type.

The information on the interface depends on the existing configuration.
  • interface-type: specifies the type of an interface
  • interface-number: specifies the number of an interface
-
feature feature-name

Specifies the configuration information about the specified feature.

The configuration information about the feature depends on the existing configuration.

-
filter filter-expression

Displays the configuration information that matches a regular expression.

NOTE:
If a large amount of configurations are displayed, it takes a long time for the system to obtain the filtered configuration information correctly. Wait for a while.

The value is a string of 1 to 255 case-insensitive characters, spaces not supported. The matching starts from the first character of the command.

For example, if snmp-agent is specified for filter-expression, only commands beginning with snmp-agent are filtered.

all

Displays all the configuration information.

-
inactive

Displays configurations about the boards that are not installed.

When a board is not inserted, its configuration information is in the inactive status. The front of these configurations in the inactive state is marked with an asterisk (*).

-
vpn-instance [ vpn-instance-name ] Displays configurations of a VPN instance with a specified name. The value must be an existing VPN instance name.
related Displays configurations of a specified module. -

Views

All views

Default Level

3: Management level

Usage Guidelines

To check whether the configured parameters take effect, run the display current-configuration command. The parameters that do not take effect are not displayed.

The command output is relevant to user configuration.

You can use a regular expression to filter the command output. For the regular expression rules, see Filtering Output Information Based on the Regular Expression in "CLI Overview" in the S7700 and S9700 V200R011C10 Configuration Guide - Basic Configuration.

If the configuration is in the offline state, the offline configuration is marked with * in the display current-configuration all and display current-configuration inactive command output.

Example

# Display all configurations that include vlan.

<HUAWEI> display current-configuration | include vlan
vlan batch 10 77 88               
 port trunk allow-pass vlan 10                  

# Display the FTP feature configuration.

<HUAWEI> display current-configuration feature ftp 
#
FTP server enable
#
------------ END ------------ 

display factory-configuration reset-result

Function

The display factory-configuration reset-result command displays the latest factory configuration restoration result of a switch.

Format

display factory-configuration reset-result

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

After the factory configuration of a switch is restored using the reset factory-configuration command, you can run the display factory-configuration reset-result command to check the factory configuration restoration result.

Example

# Display the latest factory configuration restoration result.

<HUAWEI> display factory-configuration reset-result
Slot   Time                         Type                                   Result
 _____________________________________________________________________________________          
1/7    2017/10/11 15:55:11 [DST]   Startup saved-configuration file      Succeeded
                                   Configuration in flash                Succeeded
                                   Cloud-mng db-configuration            Succeeded
                                   Data file                             Succeeded

1/8    2017/10/11 15:55:20 [DST]   Startup saved-configuration file      Succeeded
                                   Configuration in flash                Succeeded
                                   Cloud-mng db-configuration            Succeeded
                                   Data file                             Succeeded
Table 2-64  Description of the display factory-configuration reset-result command output

Item

Description

Slot

Slot ID.

Time

Time for restoring the factory configuration.

Type

Type of the configuration file that needs to be restored to the factory configuration.

  • Startup saved-configuration file: configurations in the configuration file
  • Configuration in flash: configurations in the flash, such as the cluster configuration
  • Cloud-mng db-configuration: database files of the NETCONF
  • Data file: data files in the file system
NOTE:

Cloud-mng db-configuration information can be displayed only on the S7706 ( The main control unit is SRUE or SRUH.) and S7712 ( The main control unit is SRUE or SRUH.).

Result

Result of restoring the factory configuration of the configuration file.

  • Succeeded: Factory configuration restoration succeeds.
  • Failed: Factory configuration restoration fails.

display reset-reason

Function

The display reset-reason command displays the reason for board reset.

Format

display reset-reason [ slot slot-id ]

Parameters

Parameter

Description

Value

slot slot-id

Specifies the slot ID of a board.

The value is an integer and is dependent on the specific device.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

When no slot ID is specified, the display reset-reason command displays the reset reason for all boards.

Example

# Displays the reset reason for all boards.

<HUAWEI> display reset-reason
The LPU chassis[1] board[1] has no reset records.
The LPU chassis[1] board[2] has no reset records.
The LPU chassis[1] board[3]'s reset total 1, detailed information:
--  1. 2012/03/13   19:58:15, Reset No.: 1
       Reason: Check mod information fail
The MPU chassis[1] board[4] has no reset records.
The MPU chassis[1] board[5]'s reset total 967, detailed information:
--  1. 2012/03/20   13:07:52, Reset No.: 967
       Reason: Warm reset board for no receiving message in a long time
--  2. 2012/03/20   12:57:52, Reset No.: 966
       Reason: Warm reset board for no receiving message in a long time
--  3. 2012/03/20   12:47:52, Reset No.: 965
       Reason: Warm reset board for no receiving message in a long time
--  4. 2012/03/20   12:37:52, Reset No.: 964
       Reason: Warm reset board for no receiving message in a long time
--  5. 2012/03/20   12:27:52, Reset No.: 963
       Reason: Warm reset board for no receiving message in a long time

# Displays the reset reason for a specific board.

<HUAWEI> display reset-reason slot 1
The LPU chassis[1] board[1] has no reset records.
Table 2-65  Description of the display reset-reason command output

Item

Description

LPU

Line Processing Unit.

MPU

Main Processing Unit.

SFU

Switch Fabric Unit.

chassis

Chassis ID of a board.

board

Slot ID of a board.

reset total

Number of times a board was reset.

detailed information

Detailed information about board resetting.

Reset No.

Number of a reset.

Reason

Reason for a reset.

Table 2-66 describes the causes that may be displayed in the display reset-reason command output and provides the handling methods.

Table 2-66  Reset causes and handling methods

Reset Cause

Handling Method

User operations

Reset by user command

A user has reset the card using the command line interface (CLI) or network management system (NMS).

Check whether any user with the reset privilege has reset the card.

Power off by user command

VRP reset selfboard because of command

Reset board by vrp cmd

Reset board by snmp

Reset for rollback

The demo time of license is overtime

The temporary license loaded on the card has expired.

Obtain a license from Huawei.

System loading

Reset for load

During a software upgrade, an LPU is reset after the system software is loaded.

This is a normal reset and requires no action.

Reset for lpu resource-mode disaccord with mpu

The resource mode configured on an LPU does not match that of the MPU.

This is a normal reset and requires no action.

Reset for the LPU patch file or module does not match that on the MPU

The patch package or plug-in specified for an LPU is different from that of the MPU.

After the LPU is registered, delete the patch package or plug-in, and then load the correct one.

Reset for initializing the board's status by IFNET

An LPU's status is initialized after an active/standby switchover.

If the LPU configuration is not recovered after a switchover, it cannot communicate with other cards.

It is a normal condition if the LPU works normally after a switchover.

Reset slave board for memsize too little

The memory size of the standby MPU is smaller than that of the active MPU.

Check the memory size of the standby MPU. If its memory size is smaller than that of the active MPU, replace the standby MPU.

Reset for slave board's card statement disaccord with master's

Only one of MPUs has a subcard (such as an FSU) installed.

Install the same subcard on the other MPU or remove the current subcard to ensure that the two MPUs have the same subcard configuration.

Reset for patch load

An LPU is reset after a patch is loaded.

It is a normal condition if a patch is loaded during an LPU startup.

Reset for patch get state fail

The patch fails to be loaded to a card.

It is normal for such resets to occur one or two times during a system startup.

If such resets occur multiple times, go to section Contacting Technical Support.

Reset for patch load file fail

Reset for patch synchronize file fail

Reset for patch state compare fail

Software exceptions

VRP reset selfboard because of find deadloop

A deadloop is detected.

Check alarms and logs on the switch to locate the problem.

VRP reset selfboard because of find exception

A software exception is detected.

Contact technical support personnel.

Board reset by VRP for schedule

A congestion occurs.

Check alarms and logs on the switch to locate the problem.

VRP reset selfboard because of no memory

The memory has been used up.

Check whether the memory usage is high.

Check alarms and logs on the switch to locate the problem.

Reset for memory use out

Device management

Reset for no receiving mpu's heart

An LPU does not receive heartbeat packets from the MPU in 40 seconds.

See Checking Whether the Card Reset Is Caused by Bad Installation.

Reset for no heart

The MPU did not receive heartbeat packets from an LPU in 30 seconds.

Reset for not receiving register ack from mpu

An LPU is registered 20 times but does not receive registration response packets from the MPU.

The inter-card communication fails. See Checking Whether the Card Reset Is Caused by Bad Installation.

Reset for state not stable

The MPU's communication with an LPU is interrupted intermittently.

Warm reset board for no register in a long time

An LPU fails to be registered in 30 minutes.

Warm reset board for no receiving message in a long time

The MPU does not receive any packet from an LPU in 10 minutes.

Cold reset board for no receiving message in a long time

The MPU does not receive any packet from an LPU in 20 minutes.

Cold reset board for CPU is not active

The MPU detects that the CPU of an LPU does not work.

Power off the board because of reset three times continuously

A card is reset three times during a startup.

A card will be power cycled after three warm start failures.

Reset for unregister but receive heartbeat info

The MPU receives heartbeat packets from an unregistered card.

Check alarms and logs on the switch to locate the problem.

Reset for slave board class disaccord with mpu

The active and standby MPUs are of different types.

Check the types of the active and standby MPUs and replace one of them to ensure that the switch uses MPUs of the same type.

Reset for lpu or slave version disaccord with mpu

The startup version of a card differs from that of the MPU.

If the reset card is the standby MPU, check the versions of the active and standby MPUs. If the two MPUs run V100R002 and V100R003 respectively, the standby MPU will be reset because the two versions do not support automatic synchronization.

If the reset card is an LPU, go to section Contacting Technical Support.

Reset for no receiving master cpu's heart

A VASP card is reset because the main core in its CPU does not receive heartbeat packets from the sub-core in 60 seconds.

Contact technical support personnel.

Hardware components

Reset for selftest fail

A card's self-check fails.

Reinstall the card or install it into another slot, and then check whether it works normally. If the fault persists, the card is faulty.

Reset for CPLD self-test fail

The CPLD self-check fails.

Reset selfboard because of initialize fsu fail

The FSU fails to be initialized.

reset for fpga load failed

The FPGA fails to be loaded.

Reset for fpga in abnormal state

The FPGA status is abnormal.

Reset for lanswitch chip parity error

An error occurs during an LSW circuit parity check.

Reset for FSU card type mismatch

The FSU does not match the chassis.

Replace the FSU with a matching one. If the problem cannot be fixed, go to section Contacting Technical Support.

Board reset by ISIS for purging LSP error

An error occurs when link state packets (LSPs) are cleared.

It is normal for such resets to occur one or two times during a system startup.

If such resets occur multiple times, go to section Contacting Technical Support.

CSS

Reset for frame combine

Two chassis are merged.

These are normal conditions and require no action.

Reset for frame split

The CSS is split.

Reset for fsp

The CSS is reset.

Reset for one frame register, but the board is not register

A card is not registered during a chassis registration.

Reset for slave to master in slave frame, but self is not register

On the standby switch, the standby MPU becomes the active MPU before the reset card is registered.

Reset for slave to master in master frame, but self is not register

On the master switch, the standby MPU becomes the active MPU before the reset card is registered.

Reset by switchover command from system master chassis

The switchover command is executed in the CSS.

Reset by command from other chassis

The reset command is executed on the other member switch of the CSS.

Reset board after syn version

A card is reset after version synchronization.

Reset board for Peer frame is in CSS force master status

The other switch is forcibly specified as the master switch.

Reset for fpga state disaccord with system master

The SRU hardware engine function is enabled on a switch.

Run the undo detect-engine enable command to disable the SRU hardware engine function, reboot the switch for the configuration to take effect, and then perform the CSS configuration again.

Device self-healing

Reset selfboard for ecm channel switch

The ECM channel is faulty.

Contact technical support personnel.

Reset for an entry check error in chip

A major fault occurs in chip entries.

Reset for CSS chip failure

The CSS chip on the MPU is faulty.

Reset for all HG down

All internal interconnection ports on the MPU are faulty.

Reset for critical task has not been scheduled for long time

A key task on the device cannot be scheduled within a long time.

Related Topics

display saved-configuration

Function

The display saved-configuration command displays the configuration file to be used for the next startup.

Format

display saved-configuration [ last | time | configuration ]

Parameters

Parameter Description Value
last Displays the system configurations saved last time. -
time Displays the recent time when the configurations are saved manually or automatically. -
configuration Displays the parameters of the automatic save function. -

Views

All views

Default Level

3: Management level

Usage Guidelines

If the device has been started and is not working properly, run the display saved-configuration command to check the device startup configuration in the file specified by running the startup saved-configuration command.

Run the display saved-configuration last command to check the system configurations saved last time in the configuration file loaded during the current startup.

Run the display saved-configuration time command to check the last time when the system configurations are saved.

Run the display saved-configuration configuration command to check the automatic save function parameters including the automatic save interval and CPU usage.

The command output is relevant to user configuration.

Example

# Display the configuration file for the next startup.

<HUAWEI> display saved-configuration
#
 sysname Switch
...
#
 vlan batch 10 20
#
interface Vlanif10
 ip address 192.168.1.3 255.255.255.0
#
interface Vlanif20
 ip address 192.168.4.3 255.255.255.0
...
#
interface GigabitEthernet2/0/1
 port link-type trunk
 port trunk allow-pass vlan 10
#
interface GigabitEthernet2/0/2
 port link-type trunk
 port trunk allow-pass vlan 20
...
#
user-interface maximum-vty 15
user-interface con 0
user-interface vty 0 14
 idle-timeout 0 0
#
return

display schedule reboot

Function

The display schedule reboot command displays the configuration of the scheduled restart of the device.

Format

display schedule reboot

Parameters

None

Views

All views

Default Level

3: Management level

Usage Guidelines

After using the schedule reboot command to configure a scheduled restart, you can use this command to view the configuration of the scheduled restart.

Example

# Display the configuration of the scheduled restart of the device.

<HUAWEI> display schedule reboot
Info:System will reboot at 22:00:00 2013/09/17 (in 1 hours and 43 minutes).
Table 2-67  Description of the display schedule reboot command output

Item

Description

System will reboot at

Specific restart time.

in hours and minutes

Time span between the restart time and the current time.

Related Topics

display snmp-agent trap feature-name configuration all

Function

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

Format

display snmp-agent trap feature-name configuration all

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

After the alarm function is enabled, the display snmp-agent trap feature-name configuration all command can be used to display the status of all alarms about configuration management.

Example

# Display all trap messages of the configuration module.

<HUAWEI> display snmp-agent trap feature-name configuration all
------------------------------------------------------------------------------
Feature name: CONFIGURATION
Trap number : 7
------------------------------------------------------------------------------
Trap name                       Default switch status   Current switch status
hwCfgManEventlog                off                     off
hwCfgOperateCompletion          off                     off
hwCfgB2STransferFail            off                     off
hwCfgB2SOperate                 off                     off
hwCfgRestoreFail                on                      on
hwConfigInconsistent            on                      on 
hwConfigInconsistentResume      on                      on 
Table 2-68  Description of the display snmp-agent trap feature-name configuration 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 Configuration module.
  • hwCfgManEventlog: Trap message generated when the system configuration event is changed.
  • hwCfgOperateCompletion: Trap message generated when system configuration backup is complete.
  • hwCfgB2STransferFail: Trap message generated when the system fails to back up the current configuration file to the server.
  • hwCfgB2SOperate: Trap message generated when the system starts to back up the configuration file to the server.
  • hwCfgRestoreFail: Trap message generated when the system configuration fails to be saved.
  • hwConfigInconsistent: Trap message generated when the currently running configurations of the master switch and member switches are inconsistent.
  • hwConfigInconsistentResume: Trap message generated when the currently running configurations of the master switch and member switches become consistent.

Default switch status

Default status of the trap function:
  • on: indicates that the trap function is enabled.
  • off: indicates that the trap function is disabled.

Current switch status

Current status of the trap function:
  • on: indicates that the trap function is enabled.
  • off: indicates that the trap function is disabled.

display snmp-agent trap feature-name datasync all

Function

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

Format

display snmp-agent trap feature-name datasync all [ verbose ]

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The Simple Network Management Protocol (SNMP) is a standard network management protocol widely used on TCP/IP networks. It uses a central computer (a network management station) that runs network management software to manage network elements. The management agent on the network element automatically reports traps to the network management station. After that, the network administrator immediately takes measures to resolve the problem.

The display snmp-agent trap feature-name datasync all command displays whether all trap functions of the DataSync module are enabled.

Example

# Display all trap messages of the DataSync module.

<HUAWEI> display snmp-agent trap feature-name datasync all
------------------------------------------------------------------------------
Feature name: DataSync
Trap number : 1
--------------------------------------------------------------------------------
Trap name                       Default switch status      Current switch status
hwCfgChgNotify                  on                         on
Table 2-69  Description of the display snmp-agent trap feature-name datasync 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 DataSync module:
  • hwCfgChgNotify: enables the device to send trap when the system configuration has been changed.

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 startup

Function

The display startup command displays the system software for the current and next startup, configuration file, PAF, license file, and patch file.

Format

display startup [ slot slot-id | chassis chassis-number ]

Parameters

Parameter Description Value
slot slot-id

Specifies the slot ID of a board.

The value is an integer. The range of the integer is dependent on the specific device.
chassis chassis-number

Specifies the CSS ID.

The value is 1 or 2.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Before upgrading or degrading a device, run this command to check whether the files for next startup have been loaded. If the files have been loaded, the device can be upgraded or degraded successfully after it is restarted. You can also run the command to view the system software and files for current startup.

Example

# Display the names of system software for current and next startup.

<HUAWEI> display startup
MainBoard:
  Configured startup system software:        cfcard:/basicsoftware.cc
  Startup system software:                   cfcard:/basicsoftware.cc
  Next startup system software:              cfcard:/basicsoftware.cc
  Startup saved-configuration file:          cfcard:/vrpcfg.zip
  Next startup saved-configuration file:     cfcard:/vrpcfg.zip
  Startup paf file:                          default
  Next startup paf file:                     default
  Startup license file:                      default
  Next startup license file:                 default
  Startup patch package:                     NULL
  Next startup patch package:                NULL 
SlaveBoard:
  Configured startup system software:        cfcard:/basicsoftware.cc
  Startup system software:                   cfcard:/basicsoftware.cc
  Next startup system software:              cfcard:/basicsoftware.cc
  Startup saved-configuration file:          cfcard:/vrpcfg.zip
  Next startup saved-configuration file:     cfcard:/vrpcfg.zip
  Startup paf file:                          default
  Next startup paf file:                     default
  Startup license file:                      default
  Next startup license file:                 default
  Startup patch package:                     NULL
  Next startup patch package:                NULL 
Table 2-70  Description of the display startup command output

Item

Description

Configured startup system software

System software that is configured for the current startup by running the startup system-software command before the system starts.

Startup system software

System software that is used in the current startup.

Next startup system software

System software that is configured for the next startup by running the startup system-software command.

If no system software for the next startup is configured, the system software used in the current startup is displayed.

Startup saved-configuration file

Configuration file that is used in the current startup.

Next startup saved-configuration file

Configuration file that is configured for the next startup by running the startup saved-configuration command.

If no configuration file for the next startup is configured, the configuration file used in the current startup is displayed.

Startup paf file

PAF file that is used in the current startup.

default indicates that no PAF file is specified or the PAF file does not take effect.

Next startup paf file

PAF file that is configured for the next startup.

If no PAF file is configured, default is displayed.

Startup license file

License file that is used in the current startup.

default indicates that no license file is specified or the license file does not take effect.

Next startup license file

License file that is configured for the next startup.

If no license file is configured, default is displayed.

Startup patch package

Patch package file that is used in the current startup.

NULL indicates that no patch package file is specified or the patch package file does not take effect.

Next startup patch package

Patch package file that is configured for the next startup by running the startup patch command.

If no patch package file is configured, NULL is displayed.

reboot

Function

The reboot command restarts the device.

Format

reboot [ fast | save diagnostic-information ]

Parameters

Parameter Description Value
fast Fast restarts the device. In fast restart mode, the configuration file is not saved. -
save diagnostic-information Saves the diagnostic information before the restart. -

Views

User view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

This command functions in the same way as a power recycle operation (power off and then restart the device). The command enables you to restart the device remotely.

  • If the configuration file for next startup (new configuration file) is the same as the configuration file saved on the device after the reboot command is run, the system asks you whether to save the configuration before the restart. If the configuration file for next startup (new configuration file) differs from the configuration file saved on the device, the system does not ask you whether to save the configuration before the restart, and unsaved configuration information will be lost.

  • When the reboot fast command is run, the system restart quickly without displaying any message and the configuration is lost.

  • After the reboot save diagnostic-information command is run, the system will save the diagnostic information to root directory of the storage device before restarting.

Precautions

  • If you do not respond to the displayed message within the timeout period after running this command, the system will return to the user view and the device will not be restarted.

  • To avoid loss of diagnostic information after a restart, configure the device to save the diagnostic information before restarting.

  • This command interrupts services on the entire device. Therefore, do not use this command when the device is running properly.

  • Before restarting the device, ensure that the configuration file has been saved.

  • If you upgrade the system software to V200R009C00 or a later version and 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. If a conflict occurs, 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 multiple users run the reboot save diagnostic-information command at the same time, a message indicating that the command is locked by another user is displayed.
  • If a user runs the display diagnostic-information command when another user is running the reboot save diagnostic-information command, a message indicating that the command is locked by another user is displayed.
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

# Restart the device.

<HUAWEI> reboot
Info: The system is now comparing the configuration, please wait........
Warning: The configuration has been modified, and it will be saved to the next s
tartup saved-configuration file cfcard:/204.cfg. Continue? [Y/N]:y              
Info: If want to reboot with saving diagnostic information, input 'N' and then e
xecute 'reboot save diagnostic-information'.                                    
System will reboot! Continue?[Y/N]:y

# Restart the device quickly.

<HUAWEI> reboot fast

reset boot password

Function

The reset boot password command resets the password of the BootROM menu to Admin@huawei.com.

By default, in V100R006 and earlier versions, the password of the BootROM is 9300, in versions after V100R006, the password of theBootROM is Admin@huawei.com.

Format

reset boot password [ slot slot-id ]

Parameters

Parameter

Description

Value

slot slot-id

Resets the BootROM menu password of a specified slot.

If the parameter is not specified, the device resets the BootROM menu passwords of all slots.

The value is an integer and is dependent on the specific device.

Views

All views

Default Level

3: Management level

Usage Guidelines

If you forget the password of the BootROM menu, use the reset boot password command to set the password to Admin@huawei.com. Then you can use this password to enter the BootROM menu.

Example

# Reset the password of the BootROM menu.

<HUAWEI> reset boot password
The password used to enter the boot menu by clicking Ctrl+B will be restored to the default password, continue? [Y/N] y

reset factory-configuration

Function

The reset factory-configuration command restores the factory configuration of a switch.

Format

reset factory-configuration

Parameters

None

Views

User view

Default Level

3: Configuration level

Usage Guidelines

Usage Scenario

To clear all service configurations and data files, run the reset factory-configuration command to restore the factory configuration of a switch.

Precautions

After the reset factory-configuration command is run, the system asks whether you want to restart the switch. Enter y, the switch is restarted, and service configurations and data files of the switch are cleared. Files and configurations to be cleared are as follows:
  • configurations in the configuration file
  • configurations in the flash, such as the cluster configuration
  • database files of the NETCONF
  • data files in the file system
NOTE:

The system software package for next startup, patch, module, and license files are not cleared.

Exercise caution and follow the instructions of the technical support personnel when you run this command.

Example

# Restore the factory configuration of a switch.

<HUAWEI> reset factory-configuration
Warning: The command will delete all the configurations and files (except the startup, patch, module, and license files) from the de
vice. Continue? [Y/N]:y                                                                                                             
Warning: The system will reboot after configurations and files are deleted. Continue? [Y/N]:y                                       

reset saved-configuration

Function

The reset saved-configuration command clears the next startup configuration file and cancels the configuration file used for next startup.

Format

reset saved-configuration

Parameters

None

Views

User view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

  • If the configuration file on the device is incompatible with the upgraded software, run the reset saved-configuration command to clear the configuration file and run the startup saved-configuration command to specify a new configuration file.

  • If the device in use is applied to another scenario and the original configuration file of the device does not meet requirements in the scenario, run the reset saved-configuration command to clear the existing configuration file and restart the device to restore its factory configurations.

Precautions

  • After you run the reset saved-configuration command, the next startup configuration file is cleared and the file is not used for next startup. If the current startup configuration file is the same as the next startup configuration file, the current startup configuration file is also cleared.
  • If you do not use the startup saved-configuration command to specify a new configuration file or do not save the configuration file after the file is not used for next startup, the device uses default factory configurations for startup.
  • If the current configuration file is empty, and the configuration file for the next startup is not empty, running the reset saved-configuration command clears the settings for the configuration file for the next startup.
  • If the configuration file for the next startup is empty, and the current configuration file is not empty, after the reset saved-configuration command is run, the system prompts an error and no settings are cleared.
  • Exercise caution when you run the reset saved-configuration command.

Example

# Clear the next startup configuration file in the storage device and cancel the configuration file used for next startup.

<HUAWEI> reset saved-configuration
Warning: The action will delete the saved configuration in the device.          
The configuration will be erased to reconfigure. Continue? [Y/N]:y              
Warning: Now clearing the configuration in the device.                          
Info: Succeeded in clearing the configuration in the device. 

save

Function

The save command saves the configurations to the default directory.

Format

save [ all ] [ configuration-file ]

Parameters

Parameter Description Value
all Saves all configurations to the next startup configuration file of the system.
NOTE:
All configurations are saved, including those of the boards that are not running, no matter whether all is specified.
-
configuration-file Specifies the name of a configuration file. The value is a string of 5 to 48 case-insensitive characters without spaces.

Views

User view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run commands to modify the current configuration of the device, but the modified configuration will be lost after the device restarts. To enable the new configuration to take effect after a restart, save the current configuration in the configuration file before restarting the device.

When a series of configurations are complete and take effect, you must save the current configuration file to the storage device.

If the configuration-file parameter is not specified, the save [ all ] command saves the current configuration to the next startup configuration file in the storage device. The "Next startup saved-configuration file:" field displayed in the display startup command output indicates the next startup configuration file.

The save [ all ] configuration-file command, you can save the current configuration to the specified directory of the storage device. Generally, the command does not affect the current startup configuration file. Only if the configuration-file parameter is the same as the directory and name of the configuration file for the next startup, this command can be used as the same as the save command without the configuration-file parameter.

All configurations are saved, including those of the boards that are not running, no matter whether all is specified.

If you do not specify configuration-file when saving the configuration file for the first time, the system asks you whether to save the configuration file as vrpcfg.zip. The vrpcfg.zip file is the default system configuration file with empty configurations in initial state.

Precautions

  • If the configuration file to be saved using this command has the same name with the existing configuration file, the existing configuration file is rewritten.

  • If the LPUs do not run normally during the system startup, the configuration file is not completely restored in the memory. In this case, the incomplete information in the memory overrides the configuration file when you run the save command. This causes the loss of some configuration information.
  • The configuration file name extension must be .zip or .cfg.
    • .cfg: The file is saved in plain text mode. After the file is specified as the configuration file, all commands in the file are recovered one by one during startup.
    • .zip: The .cfg file is compressed to a .zip file that occupies less space. After being specified as the configuration file, the .zip file is decompressed to the .cfg file and all commands in the .cfg file are recovered one by one during startup.
  • When the system is saving configuration files, other users are not allowed to perform configuration. When the current user is performing configuration, other users are not allowed to save configuration files.

Example

# Save the current configuration to the default directory when the next startup configuration file is not specified.

<HUAWEI> save
The current configuration will be written to the device.
Are you sure to continue?[Y/N]y
Now saving the current configuration to the slot 0..
Save the configuration successfully.

# Save the current configuration to the next startup configuration file specified.

<HUAWEI> save
The current configuration will be written to cfcard:/vrpcfg.zip.
Are you sure to continue?[Y/N]y
Now saving the current configuration to the slot 4.
Info: Save the configuration successfully.

schedule reboot

Function

The schedule reboot command configures the scheduled restart of a device and set the specific time when the device restarts or the delay time before the device restarts.

The undo schedule reboot command disables the scheduled restart function.

By default, the scheduled restart is disabled.

Format

schedule reboot { at time | delay interval [ force ] }

undo schedule reboot

Parameters

Parameter Description Value
at time Specifies the device restart time. The format of time is hh:mm YYYY/MM/DD. The restart time must be later than the current device time by less than 720 hours.YYYY/MM/DD indicates year, month, and date and is optional.
  • hh indicates hour and the value ranges from 0 to 23.
  • mm indicates minute and the value ranges from 0 to 59.
  • YYYY indicates year and the value ranges from 2000 to 2099.
  • MM indicates month and the value ranges from 1 to 12.
  • DD indicates date and the value ranges from 1 to 31.
delay interval Specifies the delay time before the device restarts. The format of interval is hh:mm or mm. The delay time must be no more than 720 hours.
  • In hh:mm, hh indicates hour and the value ranges from 0 to 720 and mm indicates minute and the value ranges from 0 to 59.
  • mm indicates minute and the value ranges from 0 to 43200.
force Specifies forcible scheduled restart. -

Views

User view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

When upgrading or restarting the device, you can configure the device to restart at time when few services are running to minimize the impact on services.

Precautions

  • If the schedule reboot at command is used to set a specific date (YYYY/MM/DD) and the date is a future date, the device restarts at the specified time. If no date is set, two situations occur: If the specified time is later than the current time, the device restarts at the specified time of the day. If the specified time is earlier than the current time, the device restarts at the set time next day.

  • Note that the gap between the specified date and current date must be shorter than or equal to 720 hours. If the scheduled restart has been configured, the latest configuration overrides the previous one.

  • Run the schedule reboot delay interval command to set the delay time before the device restarts. If the force parameter is not specified, the system compares the configuration file with the current configuration. If the current configuration is different from the configuration file, the system asks you whether to save the current configuration. After you complete the selection, the system prompts you to confirm the configured restart time. Enter Y or y to make the configured restart time take effect. If the force parameter is specified, the system does not display any message, and the restart time takes effect directly. The current configuration is not compared or saved.
  • The scheduled restart function becomes invalid when you use the clock datetime command to set the system time to over 10 minutes later than the restart time set by the schedule reboot command. If the time difference is equal to or less than ten minutes, the device immediately restarts and does not save the configuration.

  • This command restarts the device at the specified time, interrupting all services on the device. Therefore, do not use this command when the device is running properly.

  • Before restarting the device, ensure that the configuration file has been saved.

Example

# Configure the device to restart at 22:00.

<HUAWEI> schedule reboot at 22:00
Info: The system is now comparing the configuration, please wait.
Warning: The configuration has been modified, and it will be saved to the next startup saved-configuration file cfcard:/vrpcfg.cfg. Continue? [Y/N]:y
Now saving the current configuration to the slot 7....
Save the configuration successfully.
Now saving the current configuration to the slot 8.
Save the configuration successfully.
Info: Reboot system at 22:00:00 2012/06/10 UTC+06:00(in 6 hours and 6 minutes)
confirm?[Y/N]:y 

set save-configuration

Function

The set save-configuration command enables the function of saving system configurations periodically.

The undo set save-configuration command disables the function of saving system configurations periodically.

By default, the system does not periodically save configurations.

Format

set save-configuration [ interval interval | cpu-limit cpu-usage | delay delay-interval ] *

undo set save-configuration [ interval | cpu-limit | delay ] *

undo set save-configuration [ interval interval | cpu-limit cpu-usage | delay delay-interval ] *

Parameters

Parameter Description Value
interval interval Specifies the interval for saving configurations. The value is an integer that ranges from 30 to 43200, in minutes. The default value is 30.
cpu-limit cpu-usage

Specifies the threshold of the CPU usage during the periodic save operation.

The value is an integer that ranges from 1 to 60. The default value is 50.
delay delay-interval Specifies the delay in automatic backup after the configuration changes. The value is an integer that ranges from 1 to 60, in minutes. The default value is five minutes. The value of delay-interval must be less than the value of interval.

Views

System view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

After this command enables the function of saving system configurations periodically, the configuration file will not be lost if the device is powered off or restarts.

If the set save-configuration command is not executed, the system does not enable the function of saving system configurations periodically.

If the set save-configuration command is executed, the system compares the configuration files before saving configurations. If the configurations do not change, the system does not save the configurations.

  • You can specify interval interval to set the interval for periodically saving configurations. The system saves the current configurations only when the configurations have been changed and are not saved. The default interval is 0 seconds, indicating that the system does not save the configurations. After the automatic save function is enabled, the default interval is 30 minutes if interval is not specified.

  • If cpu-limit cpu-usage is specified, the automatic save function does not affect system performance. After the automatic save timer is triggered, the system cancels the current automatic save operation if the system CPU usage is detected to be higher than the upper limit. The default upper limit of the CPU usage is 50% for the automatic save function.
  • After delay delay-interval is specified, the system saves the changed configurations after the specified delay. The default value is 5 minutes.

The undo set save-configuration command disables the automatic save function. The undo set save-configuration command with a parameter specified restores the default value of the parameter and the automatic save function still takes effect.

Follow-up Procedure

Run the display saved-configuration configuration command to check the configurations about the periodic save function.

Precautions

Before saving configurations, the system compares the configurations with those in the configuration file. Automatic saving of configurations is triggered in the following scenarios:
  • The configurations are inconsistent with those saved last time.
  • The configurations are the same as those saved last time, but changes have been made. For example, if a command is run and then its configurations are deleted, automatic saving of configurations will still be triggered although configurations are the same as those saved last time.
After the automatic save function is enabled, the configurations are saved in the configuration file for the next startup. The content in the configuration file changes when the configuration changes. The system cancels the automatic save operation when:
  • Content is being written into the configuration file.
  • The interface board configurations are being recovered.
  • The CPU usage is excessively high.

If an interface board is not running, related configurations will be lost when the system saves the configuration file.

Example

# Set the automatic save interval to 60 minutes.

<HUAWEI> system-view
[HUAWEI] set save-configuration interval 60

# Configure the system to save the new configuration 3 minutes after the configuration changes at an interval of 10 hours when the upper limit of the CPU usage is 60%.

<HUAWEI> system-view
[HUAWEI] set save-configuration interval 600 delay 3 cpu-limit 60

set save-configuration backup-to-server server

Function

The set save-configuration backup-to-server server command specifies the server where the system periodically saves the configuration file.

The undo set save-configuration backup-to-server server command cancels the server where the system periodically saves the configuration file.

By default, the system does not periodically save configurations to the server.

Format

set save-configuration backup-to-server server server-ip [ vpn-instance vpn-instance-name ] transport-type { ftp | sftp } user user-name password password [ path path ]

set save-configuration backup-to-server server server-ip [ vpn-instance vpn-instance-name ] transport-type tftp [ path path ]

undo set save-configuration backup-to-server server [ server-ip [ vpn-instance vpn-instance-name ] ]

Parameters

Parameter

Description

Value

server server-ip Specifies the IP address of the server where the system periodically saves the configuration file. -
vpn-instance vpn-instance-name

Specifies the name of the VPN instance.

The value must be an existing VPN instance name.
transport-type Specifies the mode in which the configuration file is transmitted to the server. The value can be ftp, sftp, or tftp. To ensure file transfer security, use the SFTP method.
user user-name Specifies the name of the user who saves the configuration file on the server. The value is a string of 1 to 64 case-sensitive characters without spaces.

When double quotation marks are used around the string, spaces are allowed in the string.

password password Specifies the password of the user who saves the configuration file on the server. The value is a case-sensitive string without spaces. The value of a simple text password is a string of 1 to 16 characters. The value of a ciphertext password is a string of 24, 32 or 48 characters.

When double quotation marks are used around the string, spaces are allowed in the string.

path path Specifies the relative save path on the server.

If this parameter is not specified, the FTP, SFTP, or TFTP root path is enabled by default.

The value is a string of 1 to 64 case-sensitive characters without spaces.

When double quotation marks are used around the string, spaces are allowed in the string.

Views

System view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

Run this command to periodically save the configuration file to the server.

Before periodically saving configurations, the system compares the configuration files. If the configurations do not change, the system does not periodically save them.

Precautions

If the specified path on the server does not exist, configuration files cannot be sent to the server. The system then sends an alarm message indicating the transmission failure to the NMS, and the transmission failure is recorded as a log message on the device.

The user name and password must be the same as those used in FTP or SFTP login mode.

NOTE:
  • When you run this command to save configuration files to a server, the system supports only the binary transmission mode. Therefore, the server must support the binary transmission mode.
  • Before running this command, run the set save-configuration command to start the periodic configuration saving function. Otherwise, configuration files are not saved to the server.
  • FTP or TFTP is insecure. Therefore, configuring SFTP is recommended.
  • A server IP address can be bound to multiple VPN instances. To delete the configurations of a specified VPN instance, you must set vpn-instance-name. Otherwise, configurations irrelevant to the VPN instance will be deleted.

Example

# Specify the server to which the system periodically sends the configuration file, and set the transmission mode to SFTP.

<HUAWEI> system-view
[HUAWEI] set save-configuration backup-to-server server 10.1.1.1 transport-type sftp user admin1234 password Helloworld@6789

snmp-agent trap enable feature-name configuration

Function

The snmp-agent trap enable feature-name configuration command enables the trap function for the Configuration module.

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

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

Format

snmp-agent trap enable feature-name configuration [ trap-name { hwcfgb2soperate | hwcfgb2stransferfail | hwcfgmaneventlog | hwcfgoperatecompletion | hwcfgrestorefail } ]

undo snmp-agent trap enable feature-name configuration [ trap-name { hwcfgb2soperate | hwcfgb2stransferfail | hwcfgmaneventlog | hwcfgoperatecompletion | hwcfgrestorefail } ]

Parameters

Parameter

Description

Value

trap-name Enables the traps of Configuration events of specified types. -
hwcfgb2soperate Enables the device to send a trap when the device starts to back up the configuration file on the server. -
hwcfgb2stransferfail Enables the device to send a trap when the configuration file fails to be backed up on the server. -
hwcfgmaneventlog Enables the device to send a trap when the system event is changed. -
hwcfgoperatecompletion Enables the device to send a trap when the copy operation of system configuration is complete. -
hwcfgrestorefail Enables the device to send a trap when the system restores system configurations failed. -

Views

System view

Default Level

2: Configuration level

Usage Guidelines

The Configuration module is not configured with the function of excessive traps. To enable the trap function of one or more events, you can specify trap-name.

You can run the display snmp-agent trap feature-name configuration all command to check the configuration result.

Example

# Enables the device to send a trap when the system event is changed.

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

snmp-agent trap enable feature-name datasync

Function

The snmp-agent trap enable feature-name datasync command enables the trap function for the DataSync module.

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

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

Format

snmp-agent trap enable feature-name datasync [ trap-name hwcfgchgnotify ]

undo snmp-agent trap enable feature-name datasync [ trap-name hwcfgchgnotify ]

Parameters

Parameter Description Value
trap-name Enables the traps of DataSync events of specified types. -
hwcfgchgnotify Enables the device to send trap when the configuration has been changed. -

Views

System view

Default Level

2: Configuration level

Usage Guidelines

The DataSync module is not configured with the function of excessive traps. To enable the traps of one or more events, you can specify trap-name.

Example

# Enables the device to send trap when the configuration has been changed.

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

startup saved-configuration

Function

The startup saved-configuration command specifies the system configuration file for next startup.

Format

startup saved-configuration configuration-file [ slot slot-id | chassis chassis-number ]

Parameters

Parameter Description Value
configuration-file Specifies the name of a configuration file. Make sure that the file exists.

The value is a string of 5 to 48 case-insensitive characters without spaces. The file name extension can be .zip or .cfg.

The file name must not contain %.

slot slot-id

Specifies the slot ID of a board.

The value is an integer. The range of the integer is dependent on the specific device.
chassis chassis-number

Specifies the CSS ID.

The value is 1 or 2.

Views

User view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

When the original configuration file cannot be used due to the software upgrade, run the startup saved-configuration command to specify another configuration file for next startup. The startup configuration file must be saved in the root directory of the storage device.

Follow-up Procedure

Run the reboot or the schedule reboot command to restart the device.

Precautions

  • The configuration file specified for the next startup must exist.

  • The configuration file name extension must be .zip or .cfg.
    • A configuration file with the file name extension .cfg is a text file, and you can view the file content in the text file. After the file is specified as the configuration file for next startup, the system restores all commands in the file one by one during a startup.
    • A .cfg file is compressed to a .zip file that occupies less space. After being specified as the configuration file, the .zip file is decompressed to the .cfg file and the system restores all commands in the .cfg file one by one during startup.
  • If the specified configuration file already exists on the standby MPU, the system prompts you whether to overwrite the existing configuration file.
  • Do not change the configuration file manually and specify the configuration file for next startup. Otherwise, the device may not start normally.

Example

# Specify the system configuration file for the next startup.

<HUAWEI> startup saved-configuration vrpcfg.cfg
Info: Succeeded in setting the configuration for booting system.

startup system-software

Function

The startup system-software command specifies the system software for next startup.

Format

startup system-software system-file [ all | slot slot-id | slave-board | chassis chassis-number { master | slave } ]

Parameters

Parameter Description Value
system-file Specifies the name of the system software file.

The value is a string of 4 to 48 case-insensitive characters without spaces and %. It is in the format of [ drive-name ] [ file-name ]. If drive-name is not specified, the name of the default storage device is used.

slave-board Specifies the system software for next startup on the slave MPU. -
all Specifies the system software for next startup on all MPU. -
slot slot-id

Specifies the slot ID of a board.

The value is an integer. The range of the integer is dependent on the specific device.
chassis chassis-number Specifies the CSS ID. The value is 1 or 2.
master Specifies the master MPU of the specified chassis. -
slave Specifies the slave MPU of the specified chassis. -

Views

User view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

In system software upgrade or downgrade, run this command to specify the system software for next startup.

Follow-up Procedure

Run the reboot or the schedule reboot command to restart the device.

Precautions

  • If the system software to be specified is V200R010 or an earlier version, you need to restore the default BootROM password; otherwise, the downgrade may fail. When the startup system-software command is run, the system displays a prompt and the current password is cleared only after the user confirms the operation.
  • The system software package must use .cc as the file name extension and be saved to the root directory of the storage device.
  • When the system software for next startup is configured using the startup system-software command, the system checks the system software integrity. If the digital signature of the system software is invalid, the configuration fails. Therefore, ensure the system software validity.
  • If a slave MPU has been specified by slave-board or the system software for all MPUs has been specified by all, the device automatically copies the system software from the master MPU to the slave MPU and you do not need to run the copy source-filename destination-filename command. If the specified system software already exists on the slave MPU, the device prompts you whether to overwrite the existing system software. The system software that has been specified for the next startup cannot be overwritten and the device will not perform the copy operation.
  • If the storage space of the slave MPU for which the system software is specified using the startup system-software command is insufficient, the device automatically deletes unnecessary software packages.
  • If the upgrade or downgrade cannot be performed between versions, the system displays a message, prompting you to perform operations as prompted.
  • If the device has dual MPUs, specify the system software for next startup on both the master and slave MPUs.
  • You must set the same names for the next-startup system software on the master and slave main control boards. Otherwise, the system cannot be restarted. The file names of system software on the master and slave main control board are case insensitive. All entered letters are saved as lower-case letters.
NOTE:

The system file is authenticated when you configure the file name of the system software used in the next startup. Wait for a while.

Example

# Specify the system software to be loaded for next startup.

<HUAWEI> startup system-software basicsoft.cc

startup patch

Function

The startup patch command specifies the patch file for next startup.

Format

startup patch patch-name [ all | slave-board | slot slot-id | chassis chassis-number { master | slave } ]

Parameters

Parameter Description Value
patch-name

Specifies the name of the patch file for next startup.

The value is a string of 5 to 48 case-insensitive characters without spaces. It is in the format of [ drive-name ] [ path ] [ file-name ].If drive-name is not specified, the name of the default storage device is used.

slave-board

Specifies the patch file for next startup on slave MPU.

-
all Specifies all chassis. -
slot slot-id Specifies the slot ID of a board. The value is an integer. The range of the integer is dependent on the specific device.
chassis chassis-number Specifies the CSS ID. The value is 1 or 2.
master Indicates the master MPU of the specified chassis. -
slave Indicates the slave MPU of the specified chassis. -

Views

User view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

To make the patch file take effect after the device restarts, run this command to specify the patch file for next startup.

Follow-up Procedure

Run the reboot or the schedule reboot command to restart the device.

Precautions

  • A patch file uses .pat as the file name extension and must be saved in the root directory.
  • If you use this command to specify another patch for next startup, the previous patch will be overridden.
  • After the patch file is specified for next startup, run the display patch-information command to view the patch file.
    • If the patch file for next startup is not empty, the device load the patch automatically after next startup.
    • If the patch file for next startup is empty, the device cannot load the patch after next startup.
  • After the device restarts, the system loads and runs the patch on all boards. If you do not want the system to load the patch file after startup, use either of the following methods to delete the patch file:
    • Run the patch delete all command to delete the current patch.
    • Run the reset patch-configure [ next-startup ] command to delete the patch file already loaded on the system after startup.

Example

# Specify the patch file for next startup.

<HUAWEI> startup patch patch.pat
Translation
Download
Updated: 2019-10-18

Document ID: EDOC1000178288

Views: 26554

Downloads: 109

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