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

CloudEngine 8800, 7800, 6800, and 5800 V200R002C50

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

clear configuration commit

Function

The clear configuration commit command deletes the label of a configuration rollback point specified in the system or the earliest configuration rollback point generated in the system.

Format

clear configuration commit { commit-id label | oldest number-of-commits }

Parameters

Parameter Description Value
commit-id label Deletes the label of a specified configuration rollback point.

The value is an integer that the system generates automatically.

Run the display configuration commit list command to check the configuration rollback points.

oldest number-of-commits Specifies the number of the earliest configuration rollback points to be deleted.

The value is an integer that ranges from 1 to 80.

Views

User view

Default Level

2: Configuration level

NOTE:

If use the oldest parameter, this command is at the management level.

Usage Guidelines

Usage Scenario

To reduce the information amount in the system buffer, run this command to delete one or more earliest configuration rollback points that are generated.

Configuration rollback points in the system can be classified into those with labels and those without any label.
  • You can run the clear configuration commit commit-id label command to delete the label of a specified configuration rollback point.

  • You can run the clear configuration commit oldest number-of-commits command to delete a configuration rollback point without any label. After the clear configuration commit oldest number-of-commits command is run, configuration rollback points with labels become discontinuous configuration rollback points. If you run the display configuration commit list command to check the configuration rollback points, values of the CommitId fields of these discontinuous configuration rollback points in the command output are marked with an asterisk (*).

In normal cases, you do not need to run this command to delete the earliest rollback points from the list. The system will automatically delete the earliest rollback points before generating new points if the number of rollback points in the list reaches the upper limit (80).

Prerequisites

Make sure that the configuration rollback point can be deleted by running the display configuration commit list or display configuration commit changes command to check the system configuration change in the rollback point.

Follow-up Procedure

Run the display configuration commit list command to check whether the configuration rollback point has been deleted.

Example

# Delete the configuration rollback point numbered 1000000265.

<HUAWEI> clear configuration commit 1000000265 label

clear inactive-configuration

Function

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

Format

clear inactive-configuration { slot slot-id | all | chassis chassis-id }

Parameters

Parameter Description Value
slot slot-id

Specifies the slot ID of an interface board that is not installed.

The value is an integer and the value range depends on device model.

all

Specifies all interface boards that are not installed.

-
chassis chassis-id

Specifies the stack ID.

NOTE:

This parameter is available only in stack scenarios.

The value must be set according to the device configuration.

Views

System view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

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

Precautions

This command is only used in stack scenarios.

Ensure that the specified device on which configurations are to be deleted does not operate.

After this command is executed, inactive configurations on the device are deleted. Uncommitted configurations that depend on these inactive configurations will fail to be committed, and the system displays an error message.

Example

# Delete the configurations from the device that does not operate in slot 1.

<HUAWEI> system-view
[~HUAWEI] clear inactive-configuration slot 1
Warning: The inactive configuration of slot 1 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 current backup-to-server monthly

Function

The configuration current backup-to-server monthly command enables the function to upload a configuration file to the server on a specific date and time every month.

The undo configuration current backup-to-server monthly command disables this function.

By default, the function to upload a configuration file to the server on a specific date and time every month is disabled.

Format

configuration current backup-to-server monthly date date-value [ time time-value ]

undo configuration current backup-to-server monthly

Parameters

Parameter Description Value
date date-value Specifies a date. The value is an integer ranging from 1 to 31.
time time-value Specifies a time point. The value is expressed in the format of HH:MM:SS, where HH:MM:SS indicates a second-specific time point. HH ranges from 0 to 23, and MM and SS both range from 0 to 59. The default value is 00:00:00.

Views

System view

Default Level

3: Management level

Usage Guidelines

To upload a configuration file to the server on a specific date and time every month, run the configuration current backup-to-server monthly command.

The configuration file generated after this command is a .dat file, and the generated time is local time.

Example

# Upload a configuration file to the server at 12:12:12 on the first day every month.

<HUAWEI> system-view
[~HUAWEI] configuration current backup-to-server monthly date 1 time 12:12:12

configuration file auto-save

Function

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

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

By default, the system does not periodically save configurations.

Format

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

configuration file auto-save { interval | cpu-limit | delay } default

undo configuration file auto-save

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.
default Restores the default values for the parameters of the automatic save function. -

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 configuration file auto-save command is not executed, the system does not enable the function of saving system configurations periodically. In this case, the configuration file auto-save { interval | cpu-limit | delay } default command does not take effect.

If the configuration file auto-save 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. If interval is not specified, the default interval (30 minutes) is used.

  • 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.
  • If the interval interval and delay delay-interval parameters are both set, the parameter in which the configured interval first expires triggers the configuration save operation. When the interval configured in the other parameter expires, the system checks configurations again. It performs a save operation only when detecting a configuration change.

The undo configuration file auto-save command disables the automatic save function.

Configuration Impact

After the autosave function is configured, the system saves configurations to the server configuration file. The contents in the configuration file change with the configurations. If you run the save command to manually perform a save operation, configurations are not saved to the server when the time specified for the autosave function arrives.

Follow-up Procedure

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

Precautions

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 configurations are being recovered.
  • The CPU usage is excessively high.

Example

# Set the automatic save interval to 60 minutes.

<HUAWEI> system-view
[~HUAWEI] configuration file auto-save 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] configuration file auto-save interval 600 delay 3 cpu-limit 60

configuration file auto-save backup-to-server

Function

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

The undo configuration file auto-save backup-to-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

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

undo configuration file auto-save backup-to-server server [ server-ip | 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 is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the 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 characters without spaces.
password password Specifies the password of the user who saves the configuration file on the server.

The value is a string of case-sensitive characters without spaces. It can be a plaintext string of 1 to 255 characters or a ciphertext string of 20 to 432 characters.

A 24-character ciphertext password configured in an earlier version is also supported in this version.

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

path folder 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 .

Views

System view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

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

The configuration file generated after this command is run is in the same format as the configuration file for the next startup. If the configuration file for the next startup is a .dat file, the configuration file generated is also a .dat file. If the configuration file for the next startup is a .cfg or .zip file, the configuration file generated is a .zip file.

The configuration file is saved on the server as a compressed package. The package is named in the format of YY-MM-DD.HH-MM-SS.device name.zip, for example, 2012-10-25.15-13-37.HUAWEI.zip. After the package is decompressed, the file with the file name extension of .cfg is the configuration file.

The periodic saving interval depends on the interval configured using the configuration file auto-save command.

Precautions

  • Before using this command, run the configuration file auto-save command; and enable FTP, SFTP, or TFTP on the server, otherwise, the configuration file auto-save backup-to-server command does not take effect. The system cancels the operation of periodically saving the configuration file in the following scenarios:
    • The configuration file is being written.
    • The LPU is recovering the configuration.
    • The CPU usage is high.
  • The system supports a maximum of five servers. The servers are independent of each other. If the system fails to save configuration files to a server, the system reports traps to the NMS and records logs.

  • When configuration files are being uploaded, the system does not save configurations to a server until the configuration files are uploaded.

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

  • The time of the configuration file generated after this command is run is the UTC.

  • After a bound VPN instance is deleted, the VPN configuration specified using the configuration file auto-save backup-to-server command will not be cleared but does not take effect. If you configure the VPN instance with the same name again, the VPN function restores.

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

Example

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

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

display configuration

Function

The display configuration command displays the configuration in a specified configuration file.

Format

display configuration configuration-file

Parameters

Parameter Description Value
configuration-file Specifies the name of an existing configuration file. The value is a string of 5 to 64 case-sensitive characters without spaces. The file name extension can be .zip, .dat, or .cfg.

Views

All views

Default Level

3: Management level

Usage Guidelines

Usage Scenario

After a configuration file is saved using the save command, run the display configuration command to view the configuration file.

The command output is relevant to user configuration. The command does not display the default configuration.

Prerequisites

The specified configuration file exists.

Example

# Display the configuration file named vrpcfg.zip.

<HUAWEI> display configuration vrpcfg.zip
#
FTP server enable
#                         
...
aaa                         
 local-user ftp password irreversible-cipher `xy$!D3>a#Oc5/Js:mGN*Ii8AZtE4Kb!0h*QS7J<wD(j-9oN^.5%!@OKp,.5*YKuR    
 local-user ftp ftp-directory flash:/                                          
 local-user ftp service-type ftp                                                
#
...
interface 10GE1/0/1                                                     
 undo shutdown                                                                  
 ip address 10.1.1.200 255.255.255.0                                           
#                                                                               
...
interface LoopBack0                                                             
 ip address 10.10.1.1 255.255.255.255                                             
#                                                                               
...
user-interface con 0                                                            
 set authentication password cipher %$%$~^Mg.QBcGS^}H.Q*w~#*,JA8%$%$                    
 history-command max-size 30                                                    
#                                                                               
user-interface vty 0 14                                                         
 user privilege level 3                                                         
 idle-timeout 0 0                                                               
#
return 

display configuration changes

Function

The display configuration changes command displays the difference between a configuration file and the current running configuration file on the device.

Format

To display the difference based on the configuration file names, run:

display configuration changes [ running file file-name | file file-name running ]

To display the difference based on the user labels, run:

display configuration changes [ running label label | label label running ]

Parameters

Parameter Description Value
file file-name

Displays the difference between a configuration file and the current running configuration file.

The name is a string of 5 to 64 characters in the format of *.zip, *.cfg, or *.dat. The file-name must already exist.
label label

Displays the difference between the current running configuration file and the configuration file based on a specific user label.

The label must already exist.

Views

All views

Default Level

3: Management level

Usage Guidelines

Usage Scenario

You can run the display configuration changes running file file-name command to check the difference between the current running configuration file and a specified configuration file.

You can run the display configuration changes file file-name running command to check the difference between a specified configuration file and the current running configuration file.

The display configuration changes running label label command displays the difference between the current configuration and the configuration of a specified user label.

The display configuration changes label label running command displays the difference between the configuration of a specified user label and the current configuration.

This command can only compare the current running configuration file with a configuration file. When you run this command, the first specified configuration file is called source configuration, and the later specified configuration file is called target configuration. If the target configuration is different from the source configuration, the difference is displayed based on the following rules:
  • An added command is displayed in the format of prefix+.
  • A deleted command is displayed in the format of prefix-.
  • If a command is modified, the original command is displayed in the format of prefix-, and the new command is displayed in the format of prefix+.

Precautions

The specified configuration file specified by file-name must exist on the device.

Example

# Display the difference between the current running configuration file and the configuration file a.cfg.

<HUAWEI> display configuration changes running file a.cfg
Building configuration
Warning: The specified configuration file is not the same as the current configuration. There are several differences as follow:
  #
+ sysname China

display configuration commit at at

Function

The display configuration commit at command displays all configurations of a device at a specific configuration rollback point.

Format

display configuration commit at commit-id

Parameters

Parameter Description Value
commit-id Displays all configurations of a device at a specific configuration rollback point. The value is an integer ranging from 1000000001 to 1999999999. A commit ID is automatically generated by a device and cannot be manually modified.

Views

All views

Default Level

3: Management level

Usage Guidelines

After a user commits a command to a device, the device automatically generates a configuration rollback point, which records the configuration changes and all configurations at this point. You can run the display configuration commit at command to view all configurations of the device at this point. So that if the device has a fault, run the rollback configuration command to roll the device back to the configurations before the fault occurs.

Example

# Display all configurations of a device at the 1000000481 configuration rollback point.

<HUAWEI> display configuration commit at 1000000481
#
sysname HUAWEI
#                                                                               
drop-profile default                                                            
#                                                                               
diffserv domain default                                                         
#                                                                               
aaa                                                                             
 #                                                                              
 authentication-scheme default                                                  
 #                                                                              
 authorization-scheme default                                                   
 #                                                                              
 accounting-scheme default                                                      
 #                                                                              
 domain default                                                                 
 #                                                                              
 domain default_admin                                                           
#                                                                               
stack                                                                           
 #                                                                              
 stack member 1 domain 10                                                       
#                                                                               
  ---- More ----      

display configuration commit changes

Function

The display configuration commit changes command displays the configuration change recorded at a configuration rollback point.

Format

display configuration commit changes [ at commit-id | since commit-id | last number-of-commits ]

Parameters

Parameter Description Value
at commit-id Displays the configuration change at a specified configuration rollback point.

The value is an integer that the system generates automatically.

Run the display configuration commit list command to check the configuration rollback points.

since commit-id Displays the configuration changes from the specified configuration rollback point to the current state.

The value is an integer that the system generates automatically.

Run the display configuration commit list command to check the configuration rollback points.

last number-of-commits Displays the changes at the specified number of latest configuration rollback points.

The value is an integer that ranges from 1 to 80.

Views

All views

Default Level

3: Management level

Usage Guidelines

Usage Scenario

Run this command to check the configuration changes when you need to restore the system to a historical state because incorrect operations are performed on the device or some configurations fail due to some faults.

Prerequisites

Configuration has been performed and the configuration rollback point has been generated.

Follow-up Procedure

Recover or roll back the configuration after checking the configuration change.

Example

# Display the configuration change saved at the configuration rollback point numbered 1000002001.

<HUAWEI> display configuration commit changes at 1000002001
Building configuration                                                                                                              
  #                                                                                                                                 
+ interface Vlanif89                                                                                                                
+  ip address 192.168.89.1 255.255.255.0                                                                                            
  # 

# Display the configuration changes from the specified configuration rollback point to the latest rollback point.

<HUAWEI> display configuration commit changes since 1000001999
Building configuration                                                          
  #                                                                             
- vlan batch 10                                                                 
  #                                                                             
+ vlan batch 10 89                                                              
  #                                                                             
+ interface Vlanif89                                                                                                                
+  ip address 192.168.89.1 255.255.255.0                                                                                            
  #

# Display the configuration changes at the latest three configuration rollback points.

<HUAWEI> display configuration commit changes last 3
Building configuration                                                          
  #                                                                             
- vlan batch 10                                                                 
  #                                                                             
+ vlan batch 10 89                                                              
  #                                                                             
+ interface Vlanif89                                                                                                                
+  ip address 192.168.89.1 255.255.255.0                                                                                            
  #

# Display the configuration changes at all configuration rollback points in the current system.

<HUAWEI> display configuration commit changes
Building configuration                                                                                                              
Commit changes of commitId 1000002001 2015-06-18 03:04:59                                                                                              
  #                                                                                                                                 
+ interface Vlanif89                                                                                                                
+  ip address 192.168.89.1 255.255.255.0                                                                                            
  #                                                                                                                                 
                                                                                                                                    
Commit changes of commitId 1000002000 2015-06-18 03:04:30                                                                                              
                                                                                                                                    
Commit changes of commitId 1000001999 2015-06-18 03:01:59                                                                                              
  #                                                                                                                                 
- vlan batch 10                                                                 
  #                                                                             
+ vlan batch 10 89                                                              
  #                                                                                                                                 
                                                                                                                                    
Commit changes of commitId 1000001998 2015-06-18 03:00:20
        
Commit changes of commitId 1000001997 2015-06-18 02:01:39
Table 3-50  Description of the display configuration commit changes command output

Item

Description

Commit changes of commitId

Number of a configuration rollback point, which uniquely identifies the rollback point.

Run the display configuration commit list command to check the configuration rollback points.

-

Deleted configuration.

For the modified configuration, - indicates the old configuration and + indicates the new configuration.

+

Added configuration.

For the modified configuration, - indicates the old configuration and + indicates the new configuration.

display configuration commit list

Function

The display configuration commit list command displays the configuration rollback points that are generated in the system.

Format

display configuration commit list [ verbose ] [ number-of-commits | label ]

Parameters

Parameter Description Value
verbose Displays the configuration rollback point details including the description. -
number-of-commits Displays a specified number of configuration rollback points. The value is an integer that ranges from 1 to 100.
label Displays label of the configuration rollback point list. -

Views

All views

Default Level

3: Management level

Usage Guidelines

Usage Scenario

After configuring the system, run this command to check historical configuration rollback points.

The system displays the configuration rollback points in descending order of generation time. That is, the latest configuration rollback point is displayed first.

Follow-up Procedure

Use the rollback point label to roll back the configuration.

Example

# Display all configuration rollback points.

<HUAWEI> system-view
[~HUAWEI] sysname ROLLBACK
[*HUAWEI] commit description This is a test
[~ROLLBACK] display configuration commit list
------------------------------------------------------------------------------------
No.  CommitId    Label           User            TimeStamp
------------------------------------------------------------------------------------
1    1000002002  -               -               2012-08-22 17:55:49+08:00
2    1000002001  -               huawei          2012-08-22 17:12:04+08:00
3    1000002000  -               -               2012-08-22 17:11:09+08:00      

# Display details about all configuration rollback points.

<HUAWEI> system-view
[~HUAWEI] sysname ROLLBACK
[*HUAWEI] commit description This is a test
[~ROLLBACK] display configuration commit list verbose
1) CommitId: 1000002002
        Label: -
        User: -
        User-Intf: VTY 0
        Type: CLI
        TimeStamp: 2012-08-22 17:55:49+08:00
        Description: This is a test

2) CommitId: 1000002001
        Label: -
        User: huawei
        User-Intf: VTY 0
        Type: CLI
        TimeStamp: 2012-08-22 17:12:04+08:00
        Description:

3) CommitId: 1000002000
        Label: -
        User: -
        User-Intf: VTY 0
        Type: CLI
        TimeStamp: 2012-08-22 17:11:09+08:00
        Description:
Table 3-51  Description of the display configuration commit list command output

Item

Description

No.

Sequence number.

CommitId

ID of the configuration rollback point, which uniquely identifies the configuration rollback point.

If values of the CommitId fields are marked with an asterisk (*), the configuration rollback points are discontinuous configuration rollback points, that is, a user has configured labels for the configuration rollback points and then run the clear configuration commit oldest number-of-commits command to change the labeled configuration rollback points into discontinuous ones.

Label

Label of the configuration rollback point.

You can run the commit label label command to add a label for a configuration rollback point.

User

User name.

User-Intf

User interface type, such as CON0 and VTY1.

Type

Terminal type, such as CLI, SNMP, NETCONF, RESTORE, SYSTEM, and ROLLBACK.

TimeStamp

Timestamp of the configuration rollback point.

Description

Description of a configuration rollback point.

You can run the commit description description command to add description for a configuration rollback point.

display configuration recover-result

Function

The display configuration recover-result command displays the configuration recovery result after an upgrade.

Format

display configuration recover-result

Parameters

None

Views

All views

Default Level

3: Management level

Usage Guidelines

After you run the startup saved-configuration command to specify the configuration file for the next startup and restart the device, run this command to check the configuration recovery result (success, failure, or partial failure) and failure cause.

Example

# Display the configuration result after an upgrade.

<HUAWEI> display configuration recover-result
Info: The current startup saved-configuration file is flash:/vrpcfg.zip.
The number of failed commands is 1. 
--------------------------------------------------------------------------------
Command     : vm-manager
View        : system
Line        : 204
Reason      : Execute failed
Time        : 2013-06-25 09:13:09
--------------------------------------------------------------------------------
Table 3-52  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 configuration rollback result

Function

The display configuration rollback result command displays the configurations that fail to roll back and the messages that are generated during the configuration rollback.

Format

display configuration rollback result

Parameters

None

Views

All views

Default Level

3: Management level

Usage Guidelines

During the configuration rollback, some configurations fail to roll back or messages are generated during configuration rollback. Run this command to check the failed configurations and messages.

Example

# Display the latest configuration rollback failure and the messages generated during configuration rollback.

<HUAWEI> display configuration rollback result
!warning information
  interface 10GE1/0/5
+  pim bfd enable
Warning: The configuration is successful. Enable global BFD to validate the configuration.
!There are still several differences as follow:
  #
  interface 10GE1/0/2
-  ip address 10.3.3.3 255.255.255.0
+  ip address 10.4.4.4 255.255.255.0
  #

# Display the latest configuration rollback success without messages generated during configuration rollback.

<HUAWEI> display configuration rollback result
Info: The latest rollback operation is successful. 
Table 3-53  Description of the display configuration rollback result command output

Item

Description

!warning information

Message that is generated during the configuration rollback.

!There are still several differences as follow:

Information about a rollback failure.

-

Deleted configuration.

For the modified configuration, - indicates the old configuration and + indicates the new configuration.

+

Added configuration.

For the modified configuration, - indicates the old configuration and + indicates the new configuration.

display configuration sessions

Function

The display configuration sessions command displays session status.

Format

display configuration sessions [ verbose ]

Parameters

Parameter Description Value
verbose Indicates detailed information about session status. -

Views

All views

Default Level

3: Management level

Usage Guidelines

To query information about users who have logged in to the device, you can run the display configuration sessions command to view session status.

Example

# Display session status.

<HUAWEI> display configuration sessions
--------------------------------------------------------------------------------
Session User-Intf    User                 Date                              Lock
                                                                                
--------------------------------------------------------------------------------
285                  _SYSTEM_             2014-09-23 15:07:52               -   
                                                                                
286     SNMP_User                         2014-09-23 15:07:54               -   
                                                                                
514 *   VTY 0                             2014-09-25 13:39:11               -   
                                                                                
--------------------------------------------------------------------------------

# Display detailed information about session status.

<HUAWEI> display configuration sessions verbose
--------------------------------------------------------------------------------
Session      : 285                                                              
User-Intf    :                                                                  
User         : _SYSTEM_                                                         
Date         : 2014-09-23 15:07:52                                              
Lock-Type    : -                                                                
Cfg-Mode     : -                                                                
Client       : NETCONF                                                          
Elapsed-Time : 1 days, 22:36:57                                                 
                                                                                
Session      : 286                                                              
User-Intf    : SNMP_User                                                        
User         :                                                                  
Date         : 2014-09-23 15:07:54                                              
Lock-Type    : -                                                                
Cfg-Mode     : 1-stage                                                          
Client       : SNMP                                                             
Elapsed-Time : 1 days, 22:36:55                                                 
                                                                                
Session      : 514 *                                                            
User-Intf    : VTY 0                                                            
User         :                                                                  
Date         : 2014-09-25 13:39:11                                              
Lock-Type    : -                                                                
Cfg-Mode     : -                                                                
Client       : CLI                                                              
Elapsed-Time : 0 days, 0:05:38                                                  
                                                                                
--------------------------------------------------------------------------------
Table 3-54  Description of the display configuration sessions command output

Item

Description

Session

Indicates the ID of the session that connects to the system.

User-Intf

Indicates the interface information that the user used to logging on.

User

Indicates the user name.
  • When a user performs operations through an NMS, SNMP_User is displayed.

  • When a user performs RMON operations, RMON_User is displayed.

  • After the system is started, OPS will automatically apply for an internal link that is used as a channel for the Maintenance assistant to subscribe to logs and alarms. The link user name is _SYSTEM_.

Date

Indicates the time of the logging user.

Lock

Indicates the lock state.

Cfg-Mode

Indicates the configuration mode.

Client

Indicates the client information.

Elapsed-Time

Indicates the elapsed time of the logging user.

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 ] ] | all | inactive ] [ include-default ]

Parameters

Parameter Description Value
configuration configuration-type Specifies the configuration type. The value is determined by the current system configurations.
configuration-instance Specifies a configuration instance. The value is a string of 1 to 200 case-insensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.
interface [ interface-type [ interface-number ] ]

Specifies an interface type.

-
all

Displays all the configuration information.

-
inactive

Displays the offline configuration information.

-
include-default Displays the default configuration. -

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. If the include-default parameter is specified, the command output includes the default system configuration starting with a tilde (~).

You can use a regular expression to filter the command output. For the regular expression rules, see "Filtering Command Outputs" in the CloudEngine 8800, 7800, 6800, and 5800 Series Switches Configuration Guide - Basic Configuration.

After you run the display current-configuration all or display current-configuration inactive command, * in the command output indicates offline configuration.

NOTE:
The symbol * has two meanings:
  1. When * is displayed in an interactive operation, it indicates the configurations that have not been submitted.
  2. When * is displayed in configuration information, it indicates the offline configurations.

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

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

# Display the configuration that includes the default configuration.

<HUAWEI> display current-configuration include-default
!Software Version V100R006C00SPC200                                             
!Last configuration was updated at 2015-09-14 02:34:08+00:00                    
!Last configuration was saved at 2015-09-08 06:58:17+00:00                      
#                                                                               
~language character-set ISO8859-1                                               
#                                                                               
sysname HUAWEI                                                                  
#                                                                               
~undo command-privilege level rearrange                                         
#                                                                               
return

display module-information

Function

The display module-information command displays information about dynamically installed modules in the system.

Format

display module-information [ verbose | next-startup ]

Parameters

Parameter Description Value
verbose Displays details about dynamically installed modules. -
file-name Displays the specify module information loaded at the next startup. The module must already exist, with the file name extension being .mod or .MOD.
next-startup Displays module information loaded at the next startup. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

To view information about dynamically installed modules in the system, run the display module-information command. The information helps to monitor whether modules are successfully installed or uninstalled.

Example

# Display details about dynamically installed modules in the system.

<HUAWEI> display module-information verbose
                       Module Information
--------------------------------------------------------------------
Module Version        InstallTime              PackageName
--------------------------------------------------------------------
TLV     V200R001MOD503 2012-05-23 06:28:00      CE6850V200R001MOD503.MOD
--------------------------------------------------------------------
Total = 1
Board Info :
----------------------------------------------------------------------------------------
Slot-id  ProcId  Type     FileName      EffectiveTime                      Module
----------------------------------------------------------------------------------------
17       2       C        HM800000.mod  2015-08-24 22:48:00.322            MOD0031
17       3       C        HM800000.mod  2015-08-24 22:48:00.320            MOD0031
17       4       C        HM800000.mod  2015-08-24 22:48:00.322            MOD0031
18       6       C        HM800000.mod  2015-08-24 22:48:00.349            MOD0031
18       7       C        HM800000.mod  2015-08-24 22:48:00.349            MOD0031
18       8       C        HM800000.mod  2015-08-24 22:48:00.353            MOD0031
----------------------------------------------------------------------------------------
Total = 6

# Displays the specify module information loaded at the next startup.

<HUAWEI> display module-information CE6850V200R001MOD503.MOD verbose
                       Module Information
--------------------------------------------------------------------
Module Version        InstallTime              PackageName
--------------------------------------------------------------------
TLV     V200R001MOD503 2012-05-23 06:28:00      CE6850V200R001MOD503.MOD
--------------------------------------------------------------------
Total = 1
Board Info :
----------------------------------------------------------------------------------------
Slot-id  ProcId  Type     FileName      EffectiveTime                      Module
----------------------------------------------------------------------------------------
17       3       SCRIPT   HM980000.mod  2014-11-19 08:26:46.491            m0
18       6       SCRIPT   HM980000.mod  2014-11-19 08:26:46.812            m0
----------------------------------------------------------------------------------------
Total = 2
Table 3-55  Description of the display module-information verbose command output

Item

Description

Module Information

Information about a module

Module

Name of a module

Version

Version of a module

InstallTime

Time when a module is installed

PackageName

Name of a module file

Total

Number of modules installed

Board Info

Board information

Slot-id

Board ID

ProcId

Process ID

Type

File type

FileName

File name

Module

Name of a module

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. The command does not display the default 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 MEth0/0/0 
 ip address 192.168.200.8 255.255.255.0
#
interface 10GE1/0/1
 port link-type trunk
 port trunk allow-pass vlan 10
#
interface 10GE1/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 UTC(in 1 hours and 36 minutes). 
Table 3-56  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 cfg all

Function

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

Format

display snmp-agent trap feature-name cfg all

Parameters

None

Views

All views

Default Level

3: Management level

Usage Guidelines

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

Example

# Display all trap messages of the CFG module.

<HUAWEI> display snmp-agent trap feature-name cfg all
------------------------------------------------------------------------------
Feature name: CFG
Trap number : 1
------------------------------------------------------------------------------
Trap name                      Default switch status   Current switch status                                                        
hwSysPafChangeNotification     off                     off
Table 3-57  Description of the display snmp-agent trap feature-name cfg 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 CFG module.

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.

hwSysPafChangeNotification

Enables the device to send trap when the system PAF file changed.

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

3: Management 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 : 6                                                                 
------------------------------------------------------------------------------  
Trap name                      Default switch status   Current switch status    
RESTORE_CONFIGURATION_FAIL     on                      on
hwCfgB2SOperate                on                      on                       
hwCfgB2STransferFail           on                      on                       
hwCfgChgNotify                 off                     off                      
hwCfgLastSaveFailNotify        on                      on                       
hwCfgOperateCompletion         off                     off                      
hwCfgRestoreFail               on                      on 
hwcfgmaneventlog               off                     off                      
Table 3-58  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.

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 software crl

Function

The display software crl command displays information about a digital signature certificate revocation list (CRL) file.

Format

display software crl

Parameters

None

Views

ALL views

Default Level

1: Monitoring level

Usage Guidelines

If an issued digital signature certificate needs to be revoked due to key disclosure or other reasons, a third-party tool can be used to mark the certificate invalid and add the certificate to a digital certificate CRL. To check information about the digital signature CRL file, run the display software crl command.

Example

# Display information about a digital signature CRL file that has been loaded to the main control board.

<HUAWEI> display software crl
-----------------------------------------------------------------------------------------------------------------------------------------
Slot-id          Publisher                                                                        Issue date                     Status  
-----------------------------------------------------------------------------------------------------------------------------------------
1                C=CN,O=Huawei,CN=Huawei Root CA                                                  2015-10-19 15:38:25+08:00      Valid   
1                C=CN,O=Huawei,CN=Huawei Code Signing Certificate Authority                       2016-04-05 16:27:05+08:00      Valid   
1                C=CN,O=Huawei,CN=Huawei Timestamp Certificate Authority                          2016-03-01 16:56:22+08:00      Valid   
2                C=CN,O=Huawei,CN=Huawei Root CA                                                  2015-10-19 15:38:25+08:00      Valid   
2                C=CN,O=Huawei,CN=Huawei Code Signing Certificate Authority                       2016-04-05 16:27:05+08:00      Valid   
2                C=CN,O=Huawei,CN=Huawei Timestamp Certificate Authority                          2016-03-01 16:56:22+08:00      Valid   
-----------------------------------------------------------------------------------------------------------------------------------------
Table 3-59  Description of the display software crl command output

Item

Description

Slot-id Slot ID of the device where the CRL resides
Publisher CRL issuer
Issue date CRL issue date
Status CRL status:
  • Valid
  • InValid

display startup

Function

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

Format

display startup [ slot slot-id ]

Parameters

Parameter Description Value
slot slot-id

Specifies a member device in a stack.

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

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:        flash:/basicsoftware.cc
  Startup system software:                   flash:/basicsoftware.cc
  Next startup system software:              flash:/basicsoftware.cc
  Startup saved-configuration file:          flash:/vrpcfg.zip
  Next startup saved-configuration file:     flash:/vrpcfg.zip
  Startup paf file:                          default
  Next startup paf file:                     default
  Startup patch package:                     NULL
  Next startup patch package:                NULL 
Table 3-60  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 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.

install-module

Function

The install-module command dynamically loads a specified module file.

Format

install-module file-name [ next-startup ]

Parameters

Parameter Description Value
file-name Specifies the name of the module file to be loaded. The name of the module file must already exist.
next-startup Specifies the name of the module file to be loaded at the next startup. -

Views

User view

Default Level

3: Management level

Usage Guidelines

Usage Guideline

To install a module in the current system by loading the module file, run the install-module command. The extension of a module file name must be *.MOD or *.mod.

To view information about successfully loaded module files, run the display module-information command.

Precautions

Loaded module files must be stored in the $_install_mod directory.

Example

# Load the SwitchV200R001MOD501.MOD file to the $_install_mod directory.

<HUAWEI> install-module SwitchV200R001MOD501.MOD

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.

  • After the reboot or reboot save diagnostic-information command is run, the system displays a message asking you whether to save the configuration. If you choose to save the configuration, the current configuration is written into the configuration file to prevent configuration loss after the reboot. If you choose not to save the configuration, the device reboots using the configuration in the configuration file, leading to the loss of unsaved configuration.
  • After the reboot fast command is run, the device reboots without prompting you to save the configuration. Therefore, the unsaved configuration will be lost.
  • After the reboot save diagnostic-information command is run, if a diagnostic information file already exists, the system displays a message asking you whether to overwrite the file before the reboot. If you choose to overwrite the file, the system saves current diagnostic information to the root directory of the CF card and overwrites the original diagnostic information file. If you choose not to overwrite the file, the system does not collect diagnostic information. Diagnostic information does not affect device configuration.

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.

Example

# Restart the device.

<HUAWEI> reboot

# Restart the device quickly.

<HUAWEI> reboot fast

reset boot password

Function

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

By default, the password of the BIOS menu is Admin@huawei.com.

Format

reset boot password

Parameters

None

Views

User view

Default Level

3: Management level

Usage Guidelines

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

Example

# Reset the password of the BIOS menu.

<HUAWEI> reset boot password
Warning: The password used to enter the boot menu by clicking Ctrl+B will be restored to the default password, continue? [Y/N]: y
Info: Succeeded in setting password of BIOS to the default password.

reset saved-configuration

Function

The reset saved-configuration command 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

After the device software is upgraded or the device in use is applied to another scenario, you can run the reset saved-configuration command to cancel the configuration file used for next startup so that the device starts with empty configurations.

Precautions

  • After this command is run and the device restarts, enter N when the system asks you whether to save the current configuration file as the next startup configuration file. Then configuration of canceling the configuration file for next startup then takes effect.
  • After the device starts with the default configuration, you need to log in to the device through the console port. Remote login is not supported.
  • If the next startup configuration file is empty, the device displays a message indicating that the file does not exist.
  • Exercise caution when you run the reset saved-configuration command.

Example

# Cancel the configuration file used for next startup.

<HUAWEI> reset saved-configuration
The action will delete the saved configuration on the device.                   
The configuration will be erased to reconfigure.Continue? [Y/N]: y               
Warning: Now the configuration on the device is being deleted.                         
..........  
Info: Succeeded in clearing the configuration in the device.
<HUAWEI> reboot
slot 1:                                                                         
Next startup system software: flash:/basicsoftware.cc                 
Next startup saved-configuration file: NULL                                     
Next startup paf file: default                                                  
Next startup patch package: NULL                                                
Warning: The current configuration will be saved to the next startup saved-confi
guration file. Continue? [Y/N]: n                                                
Warning: The system will reboot. Continue? [Y/N]: y 

rollback configuration

Function

The rollback configuration command rolls back the system from the current configuration state to a historical configuration state.

Format

rollback configuration { to { commit-id commit-id | label label | file file-name } | last number-of-commits }

Parameters

Parameter Description Value
commit-id commit-id Specifies the label of the configuration rollback point to which system configurations are expected to roll back.

The value is an integer that the system generates automatically.

Run the display configuration commit list command to check the configuration rollback points.

label label Specifies a user label for a configuration rollback point. A specified user label indicates the historical configuration state to which the system configuration is expected to roll back. The value is a string of 1 to 256 case-sensitive ASCII characters, spaces not supported. The value must start with a letter and cannot be presented in a single hyphen (-). The label must already exist.
file file-name Specifies a configuration file for configuration rollback. A specified configuration file indicates the historical configuration state to which the system configuration is expected to roll back. The value is a string of 5 to 64 case-sensitive characters in the format of *.zip, *.cfg, or *.dat, spaces not supported. The file-name must already exist.
last number-of-commits Specifies the number of configuration rollback points. The system will be rolled back to the historical configuration state before these configuration rollback points. The value is an integer that ranges from 1 to 80.

Views

User view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

If the configuration is incorrect, the service is not running properly, or an unexpected configuration result occurs on the network, run this command to roll back the system to the specified historical configuration state.

For example, a user performs four configuration operations and submits these configurations and four consecutive rollback points a, b, c, and d are generated. The user finds that the configuration at b is incorrect and wants to roll back the system to the configuration state before b. After the user rolls back the system configuration to a, a new rollback point e is generated and marked with Rollback.

If an error occurs in the configuration rollback, you can recover the configuration to the state before the rollback, and a new rollback point is generated and marked with Rollback.

Prerequisites

The display configuration commit changes command has been executed to check the configuration change in the configuration rollback point to determine whether the configuration can be rolled back to the expected historical state.

Follow-up Procedure

If some configurations fail to be rolled back, run the display configuration rollback result command to check these configurations and the messages generated during configuration execution.

Example

# Roll back the system to the historical configuration state at rollback point 1000000001.

<HUAWEI> rollback configuration to commit-id 1000000001

# Roll back the system to the historical configuration state at the rollback point before the last two rollback points.

<HUAWEI> rollback configuration last 2

save

Function

The save command saves the configurations to the configuration file.

Format

save [ configuration-file ]

Parameters

Parameter Description Value
configuration-file Specifies the name of a configuration file. The value is a string of 5 to 64 case-sensitive 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.

The save configuration-file command saves the current configuration to a specific file on the storage device. Generally, running the save configuration-file command does not affect the current startup configuration file. If the configuration file specified by configuration-file has the same name with the current configuration file and the default directory is used, running the save configuration-file command is equivalent to running the save command.

If you do not specify configuration-file when saving the configuration file for the first time, the system displays the file name extension of the configuration file. If you directly press Enter, the configuration file is saved as vrpcfg.zip. The vrpcfg.zip file is the default system configuration file and does not contain any configuration in the 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.

  • The configuration file name extension must be .zip, .dat 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.
    • .dat: A .dat file is a binary file. If the startup software version and the .dat file version are the same, the system restores all configurations in the .dat file in batches when the device starts. This speeds up the system startup.

Example

# Save the current configuration file to the default storage medium when the switch starts with configuration.

<HUAWEI> save
Warning: The current configuration will be written to the device. Continue? [Y/N]:y
Now saving the current configuration to the slot 1 
Info: Save the configuration successfully.

# Save the current configuration file to the default storage medium for the first time when the switch starts without configuration.

<HUAWEI> save
Warning: The current configuration will be written to the device. Continue? [Y/N]: y
Info: Please input the file name(*.cfg, *.zip, *.dat)[vrpcfg.zip]:
Now saving the current configuration to the slot 2 ..
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 2037.
  • 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, with an error within 1 minute. 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
Warning: The current configuration will be saved to the next startup saved-configuration file. Continue? [Y/N]:y                    
Now saving the current configuration....    
Save the configuration successfully.             
Info: Reboot system at 22:00:00 2017/08/07 UTC (in 11 hours and 19 minutes).        
Confirm? [Y/N]:y 

set configuration commit

Function

The set configuration commit command sets a user label for a configuration rollback point.

By default, no user label is set for configuration commit.

Format

set configuration commit commit-id label label-string

Parameters

Parameter Description Value
commit-id Specifies the ID of a configuration rollback point. The value is an integer ranging from 1000000001 to 1999999999 and generated by the system automatically.
label label-string Specifies the user label of a configuration rollback point.
NOTE:

The parameter value must be unique in the system and in one-to-one mappings with commit-id.

The value is a string of 1 to 256 case-sensitive ASCII characters without spaces. The value must start with a letter and cannot be presented in a single hyphen (-).

Views

User view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After a configuration rollback point is generated, the system automatically allocates a commit ID for this configuration rollback point. The commit ID is an integer that ranges from 1000000001 to 1999999999, which is difficult to understand and remember. When the number of configuration rollback points that are automatically generated by the system reaches the upper threshold, earliest configuration rollback points are replaced by latest configuration rollback points. For some important configurations, however, the related configuration rollback points need to be retained. In this case, you can run the set configuration commit command to specify a user label for a configuration rollback point, which is easy to understand and remember and configuration rollback points related to important configurations are not replaced.

You can specify a user label when a configuration rollback point is generated using the commit command. If a configuration rollback point has been generated, you can run the set configuration commit command to add a user label for the configuration rollback point. For continuous configuration rollback points with labels, you cannot directly modify the labels. You must run the clear configuration commit commit-id label command to delete the labels of the configuration rollback points first and then run the set configuration commit command to specify user labels for the configuration rollback points.
NOTE:

For discontinuous configuration rollback points with labels (values of the CommitId fields of the configuration rollback points in the display configuration commit list command output are marked with an asterisk [*]), exercise caution when running the clear configuration commit commit-id label command because this command will simultaneously delete the configuration rollback points and their labels.

You can run the clear configuration commit commit-id label command to delete label information of a configuration rollback point.

You can run the display configuration commit list command to check label information of a configuration rollback point.

Precautions

  • In unified management mod, the set configuration commit command can only be run in a physical system (PS).

  • You cannot run the clear configuration commit oldest number-of-commits command to delete a configuration rollback point with a label.

  • If the set configuration commit command has been run, you cannot run the rollback configuration command to roll back the system to the previous configuration.

  • If you run the set configuration commit command multiple times, only the latest configuration takes effect.

Example

# Set the label new_label for configuration commit ID 1000000002.

<HUAWEI> set configuration commit 1000000002 label new_label

snmp-agent trap enable feature-name cfg

Function

The snmp-agent trap enable feature-name cfg command enables the trap function for the CFG module.

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

By default, the trap function is disabled for the CFG module.

Format

snmp-agent trap enable feature-name cfg [ trap-name hwsyspafchangenotification ]

undo snmp-agent trap enable feature-name cfg [ trap-name hwsyspafchangenotification ]

Parameters

Parameter Description Value
trap-name Enables the traps of CFG events of specified types. -
hwsyspafchangenotification Enables the device to send trap when the system PAF file changed. -

Views

System view

Default Level

3: Management level

Usage Guidelines

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

Example

# Enables the device to send trap when the system PAF file changed.

<HUAWEI> system-view
[~HUAWEI] snmp-agent trap enable feature-name cfg trap-name hwsyspafchangenotification

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.

By default, the trap function is disabled for the Configuration module.

Format

snmp-agent trap enable feature-name configuration [ trap-name trap-name]

undo snmp-agent trap enable feature-name configuration [ trap-name trap-name]

Parameters

Parameter Description Value
trap-name 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.

  • hwcfgchgnotify: Enables the device to send a trap when the system configuration is changed.

  • hwcfglastsavefailnotify: Enables the device to send a trap when the system saves the last configuration failed.

  • 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 failed to restore the system configurations.

  • restore_configuration_fail: Enables the device to send a trap when failed to restore the system configurations.

Views

System view

Default Level

3: Management 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

software crl load

Function

The software crl load command loads a digital signature certificate revocation list (CRL) file to the main control board.

Format

software crl load crl-name

Parameters

Parameter Description Value
crl-name

Specifies a CRL name.

The CRL file must be in the flash directory of the main control board.

The value is a string of 5 to 63 case-insensitive characters, spaces not supported.

The file name is determined by the uploaded file and must be the same as the name of the uploaded file.

Views

User view

Default Level

3: Management level

Usage Guidelines

The lifetime of a certificate is limited. A certificate authority (CA) can revoke a certificate to shorten its lifetime. A CRL is a list of certificates that have been revoked, and therefore should not be relied upon. The CRL is issued by a CA. If a CA revokes a certificate, the key pair defined in the certificate can no longer be used even if the certificate does not expire. After a certificate in a CRL expires, the certificate is deleted from the CRL to shorten the CRL.

If an issued digital signature certificate needs to be revoked due to key disclosure or other reasons, a third-party tool can be used to mark the certificate invalid and add the certificate to a digital certificate CRL. To load the latest digital signature CRL file to a device, run the software crl load command. After the file is loaded, the device does not verify the digital signature certificate upon next startup.

Example

# Load a CRL file to the main control board.

<HUAWEI> software crl load crldata-new.crl

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 ]

Parameters

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

The name of a configuration file must already exist. The file name extension can be .zip, .dat, or .cfg.

slot slot-id Specifies a member device in a stack. The value is an integer. The range of the integer is dependent on the specific device.

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 command to restart the device.

Precautions

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

  • The configuration file name extension must be .zip, .dat, 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.
    • A .dat file is a binary file. If the startup software version and the .dat file version are the same, the system restores all configurations in the .dat file in batches when the device starts. This speeds up the system startup. If the startup software version and the .dat file version are different, the system restores configurations using commands in the .dat file.

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.

By default, no system software file to be used at the next startup is specified.

Format

startup system-software system-file [ all | slave-board | slot slot-id ]

Parameters

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

The name of the system software file must already exist. 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.

all Specifies all member devices in a stack. -
slave-board Specifies the system software for next startup on the slave switch. -
slot slot-id Specifies a member device in a stack. The value is an integer. The range of the integer is dependent on the specific device.

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 command to restart the device.

Precautions

  • The system software package must use .cc as the file name extension and be saved to the root directory of the storage device.

  • The system software configured for next startup cannot be deleted.

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 | slot slot-id }

Parameters

Parameter Description Value
patch-name

Specifies the name of the patch file for next startup.

The name of the patch file must already exist. 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.

all Specifies all member devices in a stack. -
slot slot-id

Specifies a member device in a stack.

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

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.

Prerequisites

The desired patch file has been uploaded to the Flash:/ of the device.

Follow-up Procedure

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

Example

# Specify the patch file for next startup.

<HUAWEI> startup patch patch.pat all

uninstall-module

Function

The uninstall-module command uninstalls a specified module file.

Format

uninstall-module { file-name [ next-startup ] | all }

uninstall-module next-startup all

Parameters

Parameter Description Value
file-name Specifies the name of the module file to be uninstalled. The value is a string of 5 to 63 case-sensitive characters in the format of [file-name].
next-startup Specifies the name of the module file loaded at next startup. -
all Specifies that all modules need to be uninstalled. -

Views

User view

Default Level

3: Management level

Usage Guidelines

The uninstall-module command can be used to uninstall in-use modules from the system.

The display module-information command can be used to check whether a specified module has been uninstalled from the system.

The uninstall-module next-startup all command configures a device to remove all dynamically loaded modules at a next startup.

Example

# Uninstall module 123.MOD from the system.

<HUAWEI> uninstall-module 123.MOD 
This will uninstall the module. Are you sure? [Y/N]:y
Info: Succeeded in uninstalling the module.

# Remove all dynamically loaded modules at a next startup.

<HUAWEI> uninstall-module next-startup all
Info: Operating, please wait for a moment........done.
Info: Succeeded in uninstalling the module.
Translation
Download
Updated: 2019-03-21

Document ID: EDOC1000166501

Views: 42776

Downloads: 328

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