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

S1720, S2700, S5700, and S6720 V200R011C10

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

Ethernet Interface Configuration Commands

Command Support

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

am isolate

Function

The am isolate command isolates the current interface from a specified interface unidirectionally.

The undo am isolate command cancels unidirectional isolation between the current interface and a specified interface. If no interface is specified, unidirectional isolation between the current interface and all the other interfaces is canceled.

By default, no unidirectional isolation is configured between the current interface and a specified interface.

Format

am isolate { interface-type interface-number }&<1-8>

undo am isolate [ interface-type interface-number ]&<1-8>

am isolate interface-type interface-number1 [ to interface-number2 ]

undo am isolate [ interface-type interface-number1 [ to interface-number2 ] ]

Parameters

Parameter

Description

Value

interface-type interface-number

Specifies the type and number of the interface from which the current interface is isolated unidirectionally.

  • interface-type specifies the type of the interface.
  • interface-number specifies the number of the interface.
-
interface-type interface-number1 [ to interface-number2 ]

Specifies the type and number of the interface from which the current interface is isolated unidirectionally.

to specifies an interface range, indicating all the interfaces numbered between interface-number1 and interface-number2.

interface-number2 must be greater than interface-number1.

Views

Ethernet interface view, GE interface view, XGE interface view, MultiGE interface view, 40GE interface view, Eth-Trunk interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The am isolate command isolates interfaces unidirectionally. For example, if interface A is isolated from interface B unidirectionally, packets sent from interface A cannot reach interface B, but packets sent from interface B can reach interface A. Unidirectional isolation needs to be configured in the following scenarios:

  • When multiple hosts connect to different interfaces of a device and a host sends many broadcast packets to the other hosts, isolate the interface connected to the host from other interfaces unidirectionally. Then the other hosts do not receive packets from the host.
  • Interfaces in a port isolation group are isolated from each other, but interfaces in different port isolation groups can communicate. To isolate interfaces in different port isolation groups, configure unidirectional isolation between these interfaces.

By default, only Layer 2 packets of the current interface are isolated from a specified interface, but Layer 3 packets are not isolated. To isolate both Layer 2 and Layer 3 packets on interfaces unidirectionally, run the port-isolate mode all command.

Precautions

An interface can be unidirectionally isolated from another type of interface. However, an interface cannot be unidirectionally isolated from itself or from the management interface. In addition, an Eth-Trunk cannot be unidirectionally isolated from its member interfaces.

NOTE:

An interface can be isolated from a maximum of 128 interfaces unidirectionally.

Example

# Isolate GE0/0/1 from GE0/0/2 unidirectionally.
<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] am isolate gigabitethernet 0/0/2

auto duplex

Function

The auto duplex command configures the duplex mode on an Ethernet electrical interface in auto-negotiation mode.

The undo auto duplex command restores the default duplex mode on an Ethernet electrical interface in auto-negotiation mode.

By default, the duplex mode on an Ethernet electrical interface is negotiated with the peer interface.

Format

auto duplex { half | full }*

undo auto duplex

Parameters

Parameter

Description

Value

half Sets the duplex mode on an Ethernet electrical interface in auto-negotiation mode to half-duplex. -
full Sets the duplex mode on an Ethernet electrical interface in auto-negotiation mode to full-duplex. -

Views

Ethernet interface view, MultiGE interface view, GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In auto-negotiation mode, interfaces on both ends of a link negotiate their duplex mode. If the negotiated duplex mode is not the required one, you can run the auto duplex command to set the required duplex mode in auto-negotiation mode.

  • If service traffic volume of enterprise users is high, interfaces at both ends of a link must work in full-duplex mode. Otherwise, packet loss occurs. You can run the auto duplex full command to set the duplex mode to full-duplex. After the auto-negotiation succeeds, the interfaces work in full-duplex mode.
  • If service traffic volume of enterprise users is low, interfaces at both ends of a link can meet data transmission requirements when they work in half-duplex mode. You can run the auto duplex half command to set the duplex mode to half-duplex. After the auto-negotiation succeeds, the interfaces work in half-duplex mode.

Prerequisites

Run the negotiation auto command to configure Ethernet interface to work in auto-negotiation mode.

Precautions

  • In auto-negotiation mode, an FE electrical interface negotiates the duplex mode with the peer device on the link.

  • In auto-negotiation mode, a GE electrical interface that works at a rate of 1000 Mbit/s only supports the full-duplex mode. If the duplex mode is changed to half-duplex, the GE electrical interface works at a maximum rate of 100 Mbit/s.

  • The GE optical interfaces support the duplex mode configuration when they are equipped with GE copper modules.

  • The interfaces on both ends of a link must have the same duplex mode.

Example

# Configure Ethernet electrical interface GE0/0/1 in auto-negotiation mode to work in half-duplex mode.
<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] negotiation auto
[HUAWEI-GigabitEthernet0/0/1] auto duplex half
Related Topics

auto speed

Function

The auto speed command configures the auto-negotiation rate of an Ethernet electrical interface.

The undo auto speed command restores the default auto-negotiation rate of an Ethernet electrical interface.

By default, Ethernet electrical interfaces on both ends can negotiate to any rate they support.

Format

auto speed { 10 | 100 | 1000 | 2500 | 5000 | 10000 } *

undo auto speed

Parameters

Parameter

Description

Value

10

Sets the auto-negotiation rate of an Ethernet electrical interface to 10 Mbit/s.

-

100

Sets the auto-negotiation rate of an Ethernet electrical interface to 100 Mbit/s.

-

1000

Sets the auto-negotiation rate of an Ethernet electrical interface to 1000 Mbit/s.

NOTE:

FE electrical interfaces do not support this parameter.

When an XGE interface has a GE copper module installed, the rate of the interface can only be negotiated to 1000 Mbit/s or 100 Mbit/s. Only the rate of XGE interfaces on the S6720LI, S6720S-LI, S6720SI, S6720S-SI, S6720EI and S6720S-EI can be negotiated to 100 Mbit/s.

-

2500

Sets the auto-negotiation rate of an Ethernet electrical interface to 2500 Mbit/s.

NOTE:

Only MultiGE interfaces support this parameter.

-

5000

Sets the auto-negotiation rate of an Ethernet electrical interface to 5000 Mbit/s.

NOTE:

Only MultiGE interfaces support this parameter.

-

10000

Sets the auto-negotiation rate of an Ethernet electrical interface to 10000 Mbit/s.

NOTE:

Only MultiGE interfaces support this parameter.

-

Views

Ethernet interface view, GE interface view, MultiGE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In auto-negotiation mode, interfaces on both ends of a link negotiate their rate. If the negotiated rate is not the required one, run the auto speed command to set the auto-negotiation rate range to limit the negotiated rate.

For example, the network adapter speeds on Server1, Server2, and Server3 that form a server cluster are all 1000 Mbit/s, and the speed of the outbound interface GE0/0/4 connecting the device to external networks is also 1000 Mbit/s. The servers connect to GE0/0/1, GE0/0/2, and GE0/0/3 respectively. If the auto-negotiation speed is not specified on the device, the speeds negotiated by GE0/0/1, GE0/0/2, and GE0/0/3 with their connected servers are all 1000 Mbit/s. When the servers send data at the speed of 1000 Mbit/s concurrently, the outbound interface GE0/0/4 will be blocked. In this case, you can run the auto speed 100 100 command to configure the auto-negotiation speed to 100 Mbit/s for GE0/0/1, GE0/0/2, and GE0/0/3, preventing the outbound interface from being blocked.

Prerequisites

Run the negotiation auto command to configure the Ethernet interface to work in auto-negotiation mode.

Example

# Configure Ethernet electrical interface GE0/0/1 to work at a rate of 100 Mbit/s in auto-negotiation mode.
<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] negotiation auto
[HUAWEI-GigabitEthernet0/0/1] auto speed 100
Related Topics

cable-snr-test

Function

The cable-snr-test command checks the network cable quality and displays the check result.

NOTE:

Only MultiGE electrical interfaces on the S6720-52X-PWH-SI, S6720-56C-PWH-SI-AC, S6720-56C-PWH-SI, S5720-28X-PWH-LI-AC, S6720-32C-SI-AC, S6720-32C-SI-DC, S6720-32C-PWH-SI-AC, and S6720-32C-PWH-SI support this command.

Format

cable-snr-test

Parameters

None

Views

MultiGE interface view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

You can check the quality of the network cable on a MultiGE electrical interface to determine whether the network cable quality meets communication requirements.

Precautions

  • This command checks real-time quality of the network cable on an interface, and the network cable quality changes with the external environment.
  • A MultiGE electrical interface supports the network cable quality check only when it works at the rate of 2.5 Gbit/s or higher.
  • An interface does not support the network cable quality check when it is Down or in loopback detection mode.

Example

# Check the network cable quality on MultiGE0/0/1.
<HUAWEI> system-view
[HUAWEI] interface MultiGE 0/0/1
[HUAWEI-MultiGE0/0/1] cable-snr-test
Info: The current network cable is of good quality.

carrier

Function

The carrier command configures the delay in reporting an interface status change event.

The undo carrier command restores the default delay in reporting an interface status change event.

By default, the delay in reporting an interface Up event is 2000 milliseconds, and the delay in reporting an interface Down event is 0 milliseconds.

Format

carrier { up-hold-time | down-hold-time } interval

undo carrier { up-hold-time | down-hold-time }

Parameters

Parameter

Description

Value

up-hold-time interval

Specifies the delay in reporting an interface Up event.

The value is 0 or an integer that ranges from 50 to 50000, in milliseconds.

down-hold-time interval

Specifies the delay in reporting an interface Down event.

The value is 0 or an integer that ranges from 1000 to 50000, in milliseconds.

Views

Ethernet interface view, GE interface view, XGE interface view, MultiGE interface view, 40GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The physical status of an Ethernet interface can be Up or Down. When the physical status changes, the system notifies upper-layer protocol modules (such as the routing and forwarding modules) of the change to direct packet receiving and forwarding. The system also automatically generates traps and logs to remind users to perform corresponding operations on physical links. For example, when the physical status of the active interface in an interface protection group changes from Up to Down, the system immediately instructs the upper-layer service forwarding protocol to send service packets from the standby interface.

If frequent physical status changes are reported to the system, extra system costs are generated. You can configure the delay in reporting physical status changes to solve the problem. The system is unaware of the physical status changes on interfaces within the configured delay. If the interface physical status is not recovered after the delay expires, the physical status changes are reported to the system.

You can configure the delay in reporting physical status changes based on the network connection status.
  • Setting a long delay

    For example, an interface frequently alternates between Up and Down states at an interval shorter than the IP route convergence time. In this case, the upper-layer protocol does not need to sense the physical status changes. You can set a long delay in reporting physical status changes to avoid unnecessary routing entry refreshing caused by frequent physical status changes.

  • Setting a short delay

    For example, when the physical status of the active interface in an interface protection group changes from Up to Down, the system needs to immediately instruct the upper-layer service forwarding protocol to send service packets from the standby interface. In this case, you can set a short delay in reporting physical status changes to ensure real-time service switchover.

Precautions

If you run the carrier command multiple times in the same interface view, only the latest configuration takes effect.

Example

# Set the delay in reporting an interface Up event to 1000 milliseconds on GE0/0/1.

<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] carrier up-hold-time 1000

clear configuration port-isolate

Function

The clear configuration port-isolate command clears all the interface isolation configurations on the device.

By default, interface isolation configurations on the device are not cleared.

Format

clear configuration port-isolate

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

To clear all the interface isolation configurations on the device, you need to delete the configurations one by one. If a large number of configurations exist on the device, deleting the configurations takes much time and increases the maintenance workload. To reduce the maintenance workload and operation complexity, run the clear configuration port-isolate command in the system view to clear all the interface isolation configurations on the device. The configurations involve the port isolation group, unidirectional port isolation, and isolation mode.

Example

# Clear all the interface isolation configurations on the device.

<HUAWEI> system-view
[HUAWEI] clear configuration port-isolate
Warning: The port isolate will be cancelled. Continue?[Y/N]:y                   
Info: This operation may take a few seconds. Please wait for a moment...done.  

combo-port

Function

The combo-port command configures the working mode of a combo interface.

The undo combo-port command restores the default setting.

By default, a combo interface works in auto mode. That is, the combo interface automatically switches between the electrical mode and optical mode.

Format

combo-port { auto | copper | fiber }

undo combo-port

Parameters

Parameter

Description

Value

auto
Allows a combo interface to automatically select the working mode. The combo interface checks whether an optical module has been installed:
  • When a cable is not connected and an optical module is installed, the combo interface works in optical mode.
  • When a cable is connected, the interface is in Up state, and an optical module is installed, the combo interface works in electrical mode. After the device restarts, the combo interface works in optical mode.
  • When a cable is connected, the interface is in Down state, and an optical module is installed, the combo interface works in optical mode.

In summary, when an optical module is installed on the combo optical interface, the combo interface works in optical mode after the device restarts.

-
copper Configures a combo interface to work in electrical mode so that data is transmitted through network cables. -
fiber Configures a combo interface to work in optical mode so that data is transmitted through optical fibers. -

Views

GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A combo interface consists of a GE electrical interface and a GE optical interface on the panel. The multiplexed electrical and optical interfaces share one internal forwarding interface and cannot work at the same time. When one interface works, the other interface is disabled. You can use the electrical or optical interface based on the remote interface type. The electrical and optical interfaces share one interface view. When you enable the electrical or optical interface, configure the interface attributes (such as the rate and duplex mode) in the same interface view.

Precautions

This command takes effect only on combo interfaces.

If a combo interface is configured to work in a different mode from the remote interface, the two interfaces cannot communicate.

The electrical interface is used with the optical interface as a combo interface. Combo optical interface does not support GE copper module.

Example

# Configure GE0/0/1 to work in electrical mode.
<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] combo-port copper

display counters protocol

Function

The display counters protocol command displays IPv4 and IPv6 packet statistics on an interface.

NOTE:

Only the S5720EI, S5720HI, S6720EI, and S6720S-EI support this command.

Format

display counters [ interface interface-type interface-number ] protocol [ rate ]

Parameters

Parameter

Description

Value

interface interface-type interface-number

Specifies the interface type and number.

-

protocol

Displays IPv4 and IPv6 packet statistics.

-

rate

Displays packet rate information.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

After enabling IPv4 or IPv6 packet statistics collection on an interface, you can run this command to view packet statistics, facilitating fault location and troubleshooting.

Example

# Display IPv4 and IPv6 packet statistics on interfaces.

<HUAWEI> display counters protocol
-: Statistic not enable                                                         
Inbound                                                                         
Interface        IPv4(bytes)     IPv4(pkts)     IPv6(bytes)     IPv6(pkts)      
GE0/0/20                   0              0               0              0      
GE0/0/21                   -              -               0              0      
Outbound                                                                        
Interface        IPv4(bytes)     IPv4(pkts)     IPv6(bytes)     IPv6(pkts)      
GE0/0/20                   0              0               0              0      
GE0/0/21                   -              -               0              0 

# Display IPv4 and IPv6 packet rate information on interfaces.

<HUAWEI> display counters protocol rate
-: Statistic not enable                                                         
Inbound                                                                         
Interface      IPv4(bytes/s)   IPv4(pkts/s)   IPv6(bytes/s)   IPv6(pkts/s)      
GE0/0/20                   0              0               0              0      
GE0/0/21                   -              -               0              0      
Outbound                                                                        
Interface      IPv4(bytes/s)   IPv4(pkts/s)   IPv6(bytes/s)   IPv6(pkts/s)      
GE0/0/20                   0              0               0              0      
GE0/0/21                   -              -               0              0
Table 4-14  Description of the display counters protocol command output

Item

Description

-: Statistic not enable

If a field of an interface displays -, traffic statistics collection about the corresponding type of packets is disabled.

Inbound

Packet statistics in the inbound direction of an interface.

Outbound

Packet statistics in the outbound direction of an interface.

Interface

Interface name.

IPv4(bytes)

Number of bytes in IPv4 packets.

IPv4(pkts)

Number of IPv4 packets.

IPv6(bytes)

Number of bytes in IPv6 packets.

IPv6(pkts)

Number of IPv6 packets.

IPv4(bytes/s)

Rate of bytes in IPv4 packets.

IPv4(pkts/s)

Rate of IPv4 packets.

IPv6(bytes/s)

Rate of bytes in IPv6 packets.

IPv6(pkts/s)

Rate of IPv6 packets.

display device port-on-card status

Function

The display device port-on-card status command displays information about the card interface working mode.

NOTE:

Only S6720-C-SI series switches support this command.

Format

display device port-on-card status [ slot slot-id ]

Parameters

Parameter

Description

Value

slot slot-id

Specifies the slot ID.

The value depends on the device configuration.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run this command to view information about the card interface working mode.

Example

# Display information about the card interface working mode.

<HUAWEI> display device port-on-card status
Slot ID        Port-on-card status  
------------------------------------
0              enable
1              enable
------------------------------------
Table 4-15  Description of the display device port-on-card status command output

Item

Description

Slot ID

Slot ID.

Port-on-card status

Whether the switch works in the card interface working mode:
  • enable: The switch works in the card interface working mode.
  • disable: The switch works in the panel interface working mode.
  • NA: The card interface working mode cannot be configured on the member switch in a stack.

display error-down recovery

Function

The display error-down recovery command displays information about the port in Error-Down state, including the interface name, cause of the Error-Down event, delay for the interface to change from Down to Up, and remaining time for the Up event.

NOTE:

An interface enters the error-down state after being shut down due to an error. Currently, errors include the auto-defend protection, threshold crossing event, remote failure event, MAC address flapping, link flapping, low optical power, error packets exceeding the alarm threshold, and BPDU protection.

Format

display error-down recovery [ interface interface-type interface-number ]

Parameters

Parameter

Description

Value

interface-type interface-number

Displays the specified port in Error-Down state.

  • interface-type specifies the interface type.

  • interface-number specifies the interface number.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The auto recovery function is configured and the delay for the an interface to change from Down to Up is set using the error-down auto-recovery command. If the interface is in the Error-Down state, you can run the display error-down recovery command to view the remaining time for the Up event.

Prerequisites

The auto recovery function has been configured on an interface using the error-down auto-recovery command.

Precautions

If interface is not specified in this command, the system displays information about all interfaces in error-down state.

Example

# Display the delay for the interface to change from Down to Up and the remaining time for the Up event.

<HUAWEI> display error-down recovery
interface                    error-down cause           recovery   remainder
                                                        time(sec)  time(sec)
----------------------------------------------------------------------------
GigabitEthernet0/0/1         bpdu-protection            30         10
Table 4-16  Description of the display error-down recovery command output

Item

Description

interface

Interface name.

error-down cause

Cause of the Error-Down event, including:
  • as-not-ready: An AS is not in service.
  • auto-defend
  • efm-threshold-event
  • efm-remote-failure
  • bpdu-protection
  • data-integrity-error
  • error-statistics
  • storm-control
  • port-security
  • mac-address-flapping
  • transceiver-power-low
  • link-flap

recovery time(sec)

Delay for the interface to change from Down to Up, in seconds. If no automatic recovery time is configured, you need to run the undo shutdown (interface view) command to make the interface go Up and the recovery time is displayed as --.

remainder time(sec)

Remaining time for the Up event, in seconds. If no automatic recovery time is configured, you need to run the undo shutdown (interface view) command to make the interface go Up and the remaining time is displayed as --.

display interface ethernet brief

Function

The display interface ethernet brief command displays brief information about Ethernet interfaces.

Format

display interface ethernet brief [ main ]

Parameters

Parameter

Description

Value

main

Displays brief information about Ethernet main interfaces.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

You can use the display interface ethernet brief command to view brief information about Ethernet interfaces, including the physical status, auto-negotiation mode, duplex mode, rate, and average inbound and outbound bandwidth usages within the last period of time. This information helps you locate and rectify faults.

Precautions

To clear statistics on an interface, run the reset counters interface command.

Example

# Display brief information about Ethernet interfaces.

<HUAWEI> display interface ethernet brief
PHY: Physical                                                                   
*down: administratively down                                                    
#down: LBDT down                                               
(l): loopback                                                                   
(b): BFD down                                                                   
InUti/OutUti: input utility/output utility                                      
Interface                   PHY   Auto-Neg Duplex Bandwidth  InUti OutUti Trunk 
GigabitEthernet0/0/1        up    enable   half        100M  0.06%   100%    -- 
GigabitEthernet0/0/2        up    enable   full       1000M   100%   100%    -- 
GigabitEthernet0/0/3        up    enable   full       1000M     0%   100%    -- 
GigabitEthernet0/0/4        up    enable   full       1000M   100%   100%     1 
GigabitEthernet0/0/5        up    enable   full       1000M    99%   100%    -- 
GigabitEthernet0/0/6        down  enable   half       1000M     0%     0%    -- 
GigabitEthernet0/0/7        down  enable   half       1000M     0%     0%    -- 
GigabitEthernet0/0/8        down  enable   full       1000M     0%     0%    -- 
GigabitEthernet0/0/9        down  enable   full       1000M     0%     0%    -- 
GigabitEthernet0/0/10       down  enable   full       1000M     0%     0%    -- 
GigabitEthernet0/0/11       down  enable   full       1000M     0%     0%    -- 
GigabitEthernet0/0/12       down  enable   full       1000M     0%     0%    -- 
GigabitEthernet0/0/13       down  enable   full       1000M     0%     0%    -- 
GigabitEthernet0/0/14       down  enable   full       1000M     0%     0%    -- 
GigabitEthernet0/0/15       down  enable   full       1000M     0%     0%    -- 
GigabitEthernet0/0/16       down  enable   full       1000M     0%     0%    -- 
GigabitEthernet0/0/17       down  enable   full       1000M     0%     0%    -- 
GigabitEthernet0/0/18       down  enable   full       1000M     0%     0%    -- 
GigabitEthernet0/0/19       down  enable   full       1000M     0%     0%    -- 
GigabitEthernet0/0/20       down  enable   full       1000M     0%     0%    -- 
GigabitEthernet0/0/21       down  enable   full       1000M     0%     0%    -- 
GigabitEthernet0/0/22       down  enable   full       1000M     0%     0%    -- 
GigabitEthernet0/0/23       down  enable   full       1000M     0%     0%    -- 
GigabitEthernet0/0/24       down  enable   full       1000M     0%     0%    -- 
MEth0/0/1                   down  enable   half        100M     0%     0%    -- 
Table 4-17  Description of the display interface ethernet brief command output

Item

Description

Interface

Type and number of an interface. All interfaces are displayed in alphabetical order. Information about the following interfaces can be displayed:
  • MEth0/0/1 interface

  • FE interface

  • GE interface

  • XGE interface

  • MultiGE interface

  • 40GE interface

PHY

Physical status of an interface:
  • up: indicates that the interface works properly.

  • down: indicates that the physical layer of the interface fails.

  • *down: refers to administratively down, indicating that the administrator has run the shutdown (interface view) command on the interface.

  • #down: LBDT down, indicating that loop detection is enabled on the interface. The interface is shut down when the device detects a loop on the downstream network or between interfaces.
  • (l): refers to loopback, indicating that the loopback function is enabled on the interface.

  • (b): indicates that the physical layer of the interface is in BFD down state.

Auto-Neg

Whether auto-negotiation is enabled on an interface:
  • enable: indicates that auto-negotiation is enabled on the interface.

  • disable: indicates that auto-negotiation is disabled on the interface.

To configure the auto-negotiation mode for an interface, run the negotiation auto command.

Duplex

Duplex mode of an interface:
  • full: indicates the full-duplex mode.

  • half: indicates the half-duplex mode.

  • In auto-negotiation mode, use the auto duplex command to configure the duplex mode of an interface.
  • In non-auto negotiation mode, use the duplex command to configure the duplex mode of an interface.

Bandwidth

Bandwidth on the interface.

InUti

Average inbound bandwidth usage within the last 5 minutes.

Average inbound bandwidth usage = Average inbound rate within the last 5 minutes/Interface bandwidth

When the average bandwidth usage is smaller than 0.01% and greater than 0.005%, the value 0.01% is displayed. When the average bandwidth usage is smaller than 0.005% and greater than 0, the value 0 is displayed. When the interface bandwidth becomes smaller, for example, the bandwidth is changed using the speed command, or when an Eth-Trunk member interface becomes Down or is removed from the Eth-Trunk, the bandwidth usage be displayed as 100% because the communication traffic is not adjusted in time.

OutUti

Average outbound bandwidth usage within the last 5 minutes.

Average outbound bandwidth usage = Average outbound rate within the last 5 minutes/Interface bandwidth

When the average bandwidth usage is smaller than 0.01% and greater than 0.005%, the value 0.01% is displayed. When the average bandwidth usage is smaller than 0.005% and greater than 0, the value 0 is displayed. When the interface bandwidth becomes smaller, for example, the bandwidth is changed using the speed command, or when an Eth-Trunk member interface becomes Down or is removed from the Eth-Trunk, the bandwidth usage be displayed as 100% because the communication traffic is not adjusted in time.

Trunk

Number of the Eth-Trunk to which an interface is added.

display port-group

Function

The display port-group command displays information about permanent port groups and interfaces in these groups.

Format

display port-group [ all | port-group-name ]

Parameters

Parameter

Description

Value

all

Displays information about all permanent port groups and interfaces in these groups.

-

port-group-name

Displays information about a specified permanent port group and interfaces in the group.

The value is the name of an existing port group.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

When using the display port-group command, note that:
  • If no parameter is configured, names of all permanent port groups are displayed.
  • If all is configured, information about all permanent port groups and interfaces in these groups is displayed.
  • If port-group-name is configured, information about a specified permanent port group and interfaces in the group is displayed.

Example

# Display information about all port groups and interfaces in these groups.

<HUAWEI> display port-group all
Portgroup: 1
GigabitEthernet0/0/1
GigabitEthernet0/0/2
GigabitEthernet0/0/3
Table 4-18  Description of the display port-group command output

Item

Description

Portgroup

Name of a permanent port group.

display port-isolate group

Function

The display port-isolate group command displays the configuration of a port isolation group.

Format

display port-isolate group { group-id | all }

Parameters

Parameter

Description

Value

group-id

Displays the configuration of a specified port isolation group.

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

all

Displays the configurations of all port isolation groups.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The port isolation feature isolates interfaces in a VLAN. Run port-isolate enable [ group group-id ] command to add interfaces to a port isolation group, you can implement Layer 2 isolation between these interfaces. To view the configuration of the port isolation group, run the display port-isolate group command.

Example

# Display the configurations of all port isolation groups.

<HUAWEI> display port-isolate group all
  The ports in isolate group 3:
GigabitEthernet0/0/1 
GigabitEthernet0/0/2
  The ports in isolate group 4:
GigabitEthernet0/0/3 
GigabitEthernet0/0/4
Related Topics

display port protect-group

Function

The display port protect-group command displays information about member interfaces in an interface protection group.

Format

display port protect-group { all | protect-group-index }

Parameters

Parameter

Description

Value

all

Displays information about all interface protection groups and their member interfaces.

-

protect-group-index

Displays information about member interfaces in the specified interface protection group.

The value is an integer that ranges from 0 to 63.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Hosts are usually connected to an external network through a default gateway. If the outbound interface of the default gateway fails, the hosts cannot communicate with the external network, interrupting normal service transmission and degrading device reliability. The port protection function solves this problem. Without changing the networking, you can add two interfaces on the device to a port protection group to implement interface backup in active/standby mode. When the active interface fails, services are immediately switched to the standby interface, ensuring non-stop service transmission.

The display port protect-group command displays information about member interfaces in an interface protection group.

Example

# Display information about interface protection group 1 and its member interfaces.

<HUAWEI> display port protect-group 1
  Group ID : 1    
-----------------------------------------------    
  Protect-group member        Role      State   
-----------------------------------------------      
  GigabitEthernet0/0/1        Master    Work    
  GigabitEthernet0/0/2        Standby   Protect  
Table 4-19  Description of the display port protect-group command output

Item

Description

Group ID

ID of the interface protection group.

Protect-group member

Member name of the interface protection group.

Role

Interface role:

  • Master: working interface
  • Standby: protected interface

State

Interface status:

  • Work: working state
  • Protect: protection state
  • Down: the interface is physically down

display port split

Function

The display port split command displays the current status of a split or merged interface.

Format

display port split [ slot slot-id ]

Parameters

Parameter

Description

Value

slot slot-id

Specifies the slot ID.

The value is an integer and must be set according to the device configuration.

Views

User view, system view

Default Level

1: Monitoring level

Usage Guidelines

After interfaces are split, you can run this command to view the current status of the split and merged interface.

Example

# Display the current status of a split or merged interface .

<HUAWEI> display port split
*enable  : Will be enabled after board reset
*disable : Will be disabled after board reset

 Port           Status     Split Port
----------------------------------------------------
 40GE0/0/1      enable     XGigabitEthernet0/0/49
                           XGigabitEthernet0/0/50
                           XGigabitEthernet0/0/51
                           XGigabitEthernet0/0/52
 40GE0/0/2      enable     XGigabitEthernet0/0/53
                           XGigabitEthernet0/0/54
                           XGigabitEthernet0/0/55
                           XGigabitEthernet0/0/56
 40GE0/1/1      disable    -
 40GE0/1/2      enable     XGigabitEthernet0/1/5
                           XGigabitEthernet0/1/6
                           XGigabitEthernet0/1/7
                           XGigabitEthernet0/1/8
 40GE0/1/3      disable    -
 40GE0/1/4      disable    -
Table 4-20  Description of the display port split command output
Item Description
Port Port that can be split or merged.
Status Current status of a split or merged interface:
  • enable: Interface split is enabled.
  • disable: Interface split is disabled.
  • *enable: Interface split is enabled after the device is reset.
  • *disable: Interface merge is enabled after the device is reset.
Split Port Interfaces that have been split. If an interface is not split, this field displays as -. If an interface is split, converted interfaces are displayed.

display snmp-agent trap feature-name ifnet all

Function

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

Format

display snmp-agent trap feature-name ifnet all

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

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

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

Example

# Display all trap messages of the IFNET module.

<HUAWEI> display snmp-agent trap feature-name ifnet all
------------------------------------------------------------------------------
Feature name: IFNET
Trap number : 15
------------------------------------------------------------------------------
Trap name                       Default switch status   Current switch status
hwIfMonitorCrcErrorRising       off                     on
hwIfMonitorCrcErrorResume       off                     off
hwIfFlowDown                    off                     off
hwIfFlowUp                      off                     off
hwIfNameChange                  off                     off
hwIfNameChangeResume            off                     off
hwIfMonitorInputRateRising      off                     off
hwIfMonitorInputRateResume      off                     off
hwIfMonitorOutputRateRising     off                     off
hwIfMonitorOutputRateResume     off                     off
hwEntityExtCfmOverSlot          off                     on
hwEntityExtCfmOverCard          off                     off
linkDown                        off                     off
linkUp                          off                     off
hwExtInterfaceDelete            off                     off
Table 4-21  Description of the display snmp-agent trap feature-name ifnet 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 IFNET module:

  • hwIfMonitorCrcErrorRising: The number of CRC errors occurring within a certain period exceeds the configured threshold.
  • hwIfMonitorCrcErrorResume: The number of CRC errors occurring within a certain period falls below the configured threshold.
  • hwIfFlowDown: Traffic is interrupted.
  • hwIfFlowUp: Traffic is restored.
  • hwIfNameChange: Interface information changes when the single-chassis system is expanded to multi-chassis system.
  • hwIfNameChangeResume: Interface information changes when the multi-chassis system is rolled back to the single-chassis system.
  • hwIfMonitorInputRateRising: The percentage of incoming traffic on an interface to the total interface bandwidth exceeds the configured threshold.
  • hwIfMonitorInputRateResume: The percentage of incoming traffic on an interface to the total interface bandwidth falls below the configured threshold.
  • hwIfMonitorOutputRateRising: The percentage of outgoing traffic on an interface to the total interface bandwidth exceeds the configured threshold.
  • hwIfMonitorOutputRateResume: The percentage of outgoing traffic on an interface to the total interface bandwidth falls below the configured threshold.
  • hwEntityExtCfmOverSlot: The slot configuration has been restored.
  • hwEntityExtCfmOverCard: The interface card configuration has been restored.
  • linkDown: The link protocol status of an interface becomes Down.
  • linkUp: The link protocol status of an interface becomes Up.
  • hwExtInterfaceDelete: An interface is deleted.

Default switch status

Status of the default trap function:

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

Current switch status

Status of the current trap function:

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

display snmp-agent trap feature-name ifpdt all

Function

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

Format

display snmp-agent trap feature-name ifpdt all

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

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

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

Example

# Display all trap messages of the IFPDT module.

<HUAWEI> display snmp-agent trap feature-name ifpdt all
------------------------------------------------------------------------------                                                      
Feature name: IFPDT                                                                                                                 
Trap number : 12                                                                                                                     
------------------------------------------------------------------------------                                                      
Trap name                       Default switch status   Current switch status                                                       
hwPortNoSupportOETrap           on                      on                                                                          
hwTrunkMemSpeedDifferentAlarm   off                     on                                                                          
hwTrunkMemSpeedDifferentResume  off                     on                                                                          
hwPortErrorRateExceed           on                      on      
hwPhysicalPortInBroadcastRapidChange                                                                                                
                                on                      on                                                                          
hwSubIfNumExceededSpecAlarm     on                      on                                                                          
hwSubIfNumExceededSpecAlarmResume                                                                                                   
                                on                      on                                                                          
hwInputRateChangeOverThresholdNotice                                                                                                
                                on                      on                                                                          
hwOutputRateChangeOverThresholdNotice                                                                                               
                                on                      on                      
hwPortProtectGroupUnavailable   on                      on                      
hwPortProtectGroupAvailable     on                      on                      
hwPortProtectGroupDelete        on                      on                      
hwCableSnrAbnormal              on                      on                      
hwCableSnrNormal                on                      on                      
hwCableSnrDetectNotSupport      on                      on
Table 4-22  Description of the display snmp-agent trap feature-name ifpdt 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 IFPDT module:

  • hwPortNoSupportOETrap: The stack interface is connected to the copper transceiver module or GE optical module.
  • hwTrunkMemSpeedDifferentAlarm: The rates of active interfaces of the Eth-Trunk are different.
  • hwTrunkMemSpeedDifferentResume: The rates of active interfaces of the Eth-Trunk are changed to be the same.
  • hwPortErrorRateExceed: The rate of CRC, Giants, and Runts error packets received by an interface is greater than or equal to 1000 packets per second.

    NOTE:
    Only the S5720EI supports this field.
  • hwPhysicalPortInBroadcastRapidChange: The rapid-change-ratio of inputbroadcast exceeded the threshold.
  • hwSubIfNumExceededSpecAlarm: The number of sub-interfaces on the switch exceeds the maximum value.

    NOTE:

    Only the S6720EI, S6720S-EI, S5720HI, and S5720EI support this field.

  • hwSubIfNumExceededSpecAlarmResume: The number of sub-interfaces on the switch is within the normal range.

    NOTE:

    Only the S6720EI, S6720S-EI, S5720HI, and S5720EI support this field.

  • hwInputRateChangeOverThresholdNotice: The sudden traffic volume change in the inbound direction of interfaces.
  • hwOutputRateChangeOverThresholdNotice: The sudden traffic volume change in the outbound direction of interfaces.
  • hwPortProtectGroupUnavailable: The port protection group function becomes unavailable.
  • hwPortProtectGroupAvailable: The port protection group function becomes available.
  • hwPortProtectGroupDelete: The port protection group is deleted.
  • hwCableSnrAbnormal: The network cable quality is abnormal.
  • hwCableSnrNormal: The network cable quality is normal.
  • hwCableSnrDetectNotSupport: The network cable quality cannot be checked.
  • hwVxlanTrunkHashNotSupport: This object indicates that the IP address-based load balancing mode configured on an Eth-Trunk does not take effect for VXLAN packets when the Eth-Trunk functions as the outbound interface of VXLAN packets.

Default switch status

Status of the default trap function:

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

Current switch status

Status of the current trap function:

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

display snmp-agent trap feature-name error-down all

Function

The display snmp-agent trap feature-name error-down all command displays the status of all traps of the error-down module.

Format

display snmp-agent trap feature-name error-down all

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The Simple Network Management Protocol (SNMP) is a network management standard widely used on the TCP/IP network. It uses a central computer (a network management station) that runs network management software to manage network elements. The SNMP agent reports trap messages to the network management station so that the network management station can obtain the network status in a timely manner, and the network administrator can take measures accordingly.

The display snmp-agent trap feature-name error-down all command displays the following information:
  • Trap names supported by the error-down module. The trap names are the same as the trap names specified by the snmp-agent trap enable feature-name error-down trap-name trap-name command. Each trap name corresponds to a network element abnormality.

  • Trap status of the error-down module. You can check whether the trap is reported based on the trap name.

Prerequisites

SNMP has been enabled. See snmp-agent.

Example

# Display all traps of the error-down module.

<HUAWEI>display snmp-agent trap feature-name error-down all
------------------------------------------------------------------------------
Feature name: ERROR-DOWN
Trap number : 2
------------------------------------------------------------------------------
Trap name                       Default switch status   Current switch status
hwErrordown                     on                      on
hwErrordownRecovery             on                      on
Table 4-23  Description of the display snmp-agent trap feature-name error-down all command output

Item

Description

Feature name

Name of the module that the trap belongs to.

Trap number

Number of traps.

Trap name

Name of the trap:
  • hwErrordown: indicates an error-down alarm.

  • hwErrordownRecovery: indicates an error-down clear alarm.

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

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

display virtual-cable-test

Function

The display virtual-cable-test command displays the last cable test result on an Ethernet electrical interface.

Format

display virtual-cable-test interface-type interface-number

Parameters

Parameter

Description

Value

interface-type interface-number

Displays the cable test result on a specified interface.

This Parameter can be an XGE optical interface that has a GE copper module installed.

-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

A cable test detects faults on the cable connected to an interface. If the cable is working properly, the test result displays the total length of the cable. If the cable cannot work properly, the test result displays the distance between the interface and the failure point.

NOTE:

The test result is only for reference and may be inaccurate for cables of some vendors.

Example

# Display the cable test result on Ethernet electrical interface GE0/0/1.

<HUAWEI> display virtual-cable-test gigabitethernet 0/0/1
VCT test last ran on: 2013-7-12 21:25:13     
Pair A length: 189meter(s)
Pair B length: 189meter(s)
Pair C length: 189meter(s)
Pair D length: 189meter(s)
Pair A state: Ok
Pair B state: Ok
Pair C state: Ok
Pair D state: Ok  
Info: The test result is only for reference.
Table 4-24  Description of the display virtual-cable-test command output

Item

Description

VCT test last ran on

Time when the last VCT test was performed on the interface.
NOTE:
  • When the daylight saving time (DST) is not used, the system displays the following information: VCT test last ran on: 2013-7-12 21:25:13.
  • When the DST is used, the system displays the following information: VCT test last ran on: 2013-7-12 21:25:13 DST.

Pair A length

Length of a network cable.
  • The length is the distance between the interface and the faulty point if a fault occurs.
  • The length is the actual length of the cable when the cable works properly.
  • The length is the default length 0 m if the interface is not connected to any network cable.
NOTE:
If the cable length is displayed as Unknown, the cable status is OK, but the cable length test result cannot be used.

Pair A state

Status of a circuit pair of the cable:
  • Ok: indicates that the circuit pair is terminated normally.
  • Open: indicates that the circuit pair is not terminated.
  • Short: indicates that the circuit pair is short-circuited.
  • Crosstalk: indicates that the circuit pairs interfere with each other.
  • Unknown: indicates that the circuit pair has an unknown fault.
NOTE:
Pairs A, B, C, and D are the four pairs in a cable.
Related Topics

duplex

Function

The duplex command sets the duplex mode for an Ethernet electrical interface in non-auto-negotiation mode.

The undo duplex command restores the default duplex mode for an Ethernet electrical interface in non-auto-negotiation mode.

By default, the duplex mode of an Ethernet electrical interface is full duplex when the interface works in non-auto-negotiation mode.

Format

duplex { full | half }

undo duplex

Parameters

Parameter

Description

Value

full

Sets the duplex mode to full duplex for an Ethernet electrical interface in non-auto-negotiation mode.

-

half

Sets the duplex mode to half duplex for an Ethernet electrical interface in non-auto-negotiation mode.

-

Views

Ethernet interface view, MultiGE interface view, GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Interfaces can work in the following two duplex modes:
  • Half-duplex mode: An interface in this mode only receives or sends data at a time within a specified transmission distance.
  • Full-duplex mode: An interface in this mode receives and sends data at the same time. The maximum throughput in full-duplex mode is double that in half-duplex mode, and the transmission distance is not limited.

If the peer device does not support auto-negotiation, you can run this command to manually set the duplex mode for the local interface in non-auto-negotiation mode to ensure that the interface works in the same duplex mode as the peer interface.

Prerequisites

The Ethernet interface has been set to work in non-auto-negotiation mode by running the undo negotiation auto command.

Precautions
  • When the working rate of a GE electrical interface is 1000 Mbit/s, the interface supports only the full duplex mode and does not need to negotiate the duplex mode with the peer interface.

  • When an interface works in half-duplex mode, flow control does not take effect on the interface.

  • Interfaces on both ends of a link must have the same duplex mode.

  • Physical service interfaces of the S5720HI, S5720EI, S6720S-EI, and S6720EI do not support the half duplex mode.

Example

# Set the duplex mode to half duplex for Ethernet electrical interface GE0/0/1 in non-auto-negotiation mode.
<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] undo negotiation auto
[HUAWEI-GigabitEthernet0/0/1] speed 100
[HUAWEI-GigabitEthernet0/0/1] duplex half

error-down auto-recovery

Function

The error-down auto-recovery command enables an interface in Error-Down state to go Up and sets the auto recovery delay.

The undo error-down auto-recovery command disables an interface in Error-Down state from going Up automatically.

By default, an interface in Error-Down state is not enabled to go Up.

NOTE:

An interface enters the Error-Down state after being shut down due to an error. Currently, errors include the auto-defend protection, threshold crossing event, remote failure event, MAC address flapping, link flapping, low optical power, error packets exceeding the alarm threshold, and BPDU protection.

Format

error-down auto-recovery cause { as-not-ready | auto-defend | bpdu-protection | efm-remote-failure | efm-threshold-event | error-statistics | runts-error-statistics | link-flap | mac-address-flapping | port-security | transceiver-power-low | storm-control | data-integrity-error } interval interval-value

undo error-down auto-recovery cause { auto-defend | bpdu-protection | efm-remote-failure | efm-threshold-event | error-statistics | runts-error-statistics | link-flap | mac-address-flapping | port-security | transceiver-power-low | storm-control | data-integrity-error }

NOTE:

The S1720GFR does not support the as-not-ready parameter.

efm-threshold-event does not take effect on the S1720GFR.

Parameters

Parameter

Description

Value

cause

Indicates the cause for an interface in Error-Down state.

-

as-not-ready

Indicates that the AS where the interface resides is not in service.

-

auto-defend

Indicates that the auto-defend function is enabled.

-

bpdu-protection

Indicates that STP BPDU protection is enabled.

-

efm-remote-failure

Indicates that an EFM remote failure event occurs.

-

efm-threshold-event

Indicates that a threshold crossing event occurs.

-

error-statistics

Indicates that the number of error packets exceeds the alarm threshold.

-

runts-error-statistics

Indicates that the number of received Runts error packets reaches the alarm threshold.

NOTE:

Only interfaces on the S5720EI can be in this Error-Down state.

-

link-flap

Indicates that link flapping occurs.

-

storm-control

Indicates that storm control is enabled.

-

port-security

Indicates that the number of learned secure MAC addresses exceeds the upper limit or static MAC address flapping is detected.

-

mac-address-flapping

Indicates that MAC address flapping occurs.

-

transceiver-power-low

Indicates that the optical power is too low.

-

data-integrity-error

Indicates that the chip memory identifier has a data integrity error.

NOTE:

Only the S6720HI supports this parameter.

-

interval interval-value

Specifies the auto recovery delay.

The value is an integer that ranges from 30 to 86400, in seconds.
  • A smaller value indicates a higher frequency at which an interface alternates between Up and Down states.
  • A larger value indicates longer traffic interruption.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

An interface enters the Error-Down state in the following scenarios.

Cause for an Interface in Error-Down State Scenario Remarks
as-not-ready

When the device negotiates to the AS mode, its port status becomes Down and then becomes Up after services in the service profiles have been delivered.

-

auto-defend

After the auto-defend action command is used to configure actions against attack sources, the interface that receives attack packets is shut down to prevent the device from attacks.

-

bpdu-protection

On an STP-enabled network where BPDU protection is configured on an edge port, if malicious attackers send bogus BPDUs to attack the switching device, the switching device sets the edge port to Down immediately after the edge port receives BPDUs. As a result, all services on the edge port are interrupted.

For details, see stp bpdu-protection.

efm-remote-failure

The efm trigger error-down command associates an error event with an interface. When EFM detects critical-event, dying-gasp, link-fault, or timeout faults, the protocol status of the interface becomes Down and all services on the interface are interrupted.

-

efm-threshold-event

When link monitoring is configured for an interface on a link, the link is considered unavailable, if the number of errored frames, errored codes, or errored frame seconds detected by the interface reaches or exceeds the threshold within a period. You can associate an EFM crossing event with an interface. Then the system sets the administrative status of the interface to Down. In this manner, all services on the interface are interrupted.

-

error-statistics

When an Ethernet interface configured with a backup link receives error packets, faults such as packet loss occur. To ensure nonstop service transmission, when the number of received error packets reaches the alarm threshold, the interface is shut down and services are switched to the backup link.

For details, see trap-threshold error-statistics and error-statistics threshold-event trigger error-down.

runts-error-statistics

An interface receives Runts error packets if the optical fiber, network cable, or optical module is removed and reinstalled, the shutdown or undo shutdown command is executed, or Runts packets are forwarded on the network. To avoid worse impact on the device or services, the device counts the number of Runts error packets received by an interface within one minute, and shuts down the interface if the number reaches the alarm threshold 5.

-

link-flap

Network cable faults or active/standby switchovers may cause an interface to alternate between Up and Down. You can configure link flapping protection. When the device receives an interface Up/Down message, it checks the interface flapping count and link flapping detection interval. If the interface flapping count reaches the limit within the specified period, the device shuts down interface.

For details, see port link-flap protection enable.

storm-control

After the storm control action is configured as error-down on an interface, the interface is shut down when the average rate of receiving broadcast, multicast, and unknown unicast packets is larger than the specified limit within the interval for detecting storms.

For details, see storm-control action.

port-security

After port security is enabled on an interface, MAC addresses learned by the interface change to secure dynamic MAC addresses. If the port-security protect-action command sets the security protection action to shutdown, the interface is shut down when the number of learned MAC addresses on the interface exceeds the upper limit or static MAC address flapping is detected.

For details, see port-security protect-action and port-security enable.

mac-address-flapping

If the user network where the device is deployed does not support loop prevention protocols, configure a loop prevention action for the device to perform when the device detects MAC address flapping. The device shuts down an interface when detecting MAC address flapping on the interface.

For details, see mac-address flapping detection and mac-address flapping action.

transceiver-power-low

When the optical power of an Ethernet optical interface configured with a backup link is reduced, faults such as packet loss occur. When the optical power is lower than the lower alarm threshold, the interface is triggered to be in Error-Down state and services are switched immediately.

For details, see transceiver power low trigger error-down.

data-integrity-error

After the switch runs for a long time, the chip memory identifier has a data integrity error.

-

By default, an interface can only be resumed by a network administrator after being shut down. To configure the interface to restore to the Up state automatically, run the error-down auto-recovery command to set an auto recovery delay. After the delay, the interface goes Up automatically.

The restored interface is shut down again if the interface receives BPDUs again or the link is considered unavailable in a specified time.

Precautions

The error-down auto-recovery command is invalid for the interface that has been in Error-Down state. It takes effect for only the interface that enters the Error-Down state after the error-down auto-recovery command is executed.

BPDU protection has been enabled using the stp bpdu-protection command in the system view.

A threshold crossing event has been associated with an interface using the efm threshold-event trigger error-down command in the interface view.

An error event has been associated with an interface using the efm trigger error-down command in the interface view.

Example

# Set the delay for an interface changes from Down to Up to 50s after the edge port is enabled with BPDU protection on an STP-enabled network.

<HUAWEI> system-view
[HUAWEI] error-down auto-recovery cause bpdu-protection interval 50

# Set the auto recovery delay to 50s after an EFM threshold crossing event is associated with an interface.

<HUAWEI> system-view
[HUAWEI] error-down auto-recovery cause efm-threshold-event interval 50

# Set the auto recovery delay to 50s after an EFM remote failure event is associated with an interface.

<HUAWEI> system-view
[HUAWEI] error-down auto-recovery cause efm-remote-failure interval 50

error-down-threshold error-statistics

Function

The error-down-threshold error-statistics command configures the alarm threshold for error packets causing an interface status to change to Error-Down and interval for receiving error packets.

The undo error-down-threshold error-statistics command restores the default value of the alarm threshold and the alarm interval for error packets that cause the interface status to change to Error-Down.

By default, the alarm threshold for error packets is 3 and the alarm interval is 10 seconds.

Format

error-down-threshold error-statistics threshold-value interval interval-value

undo error-down-threshold error-statistics

Parameters

Parameter

Description

Value

threshold-value

Specifies the alarm threshold for error packets that cause the interface status to change to Error-Down.

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

NOTE:

The threshold is greater than or equal to the alarm threshold for error packets configured by the trap-threshold error-statistics command.

interval interval-value

Specifies the alarm interval for error packets that cause the interface status to change to Error-Down.

The value is an integer that ranges from 10 to 65535, in seconds.

Views

Ethernet interface view, GE interface view, XGE interface view, MultiGE interface view, 40GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

After an interface is configured to transit to the Error-Down state when the number of received error packets exceeds the threshold using the error-statistics threshold-event trigger error-down command, the interface transits to the Error-Down state when the number of received error packets exceeds the threshold within the specified interval. By default, an interface transits to the Error-Down state when the number of received error packets exceeds 3 within 10 seconds. Run the error-down-threshold error-statistics command to configure the interval and the threshold for received error packets.

Precautions

This command is not supported on the stack interface.

On a switch running a version earlier than V200R009C00, if the alarm threshold has been set to n and alarm interval to m seconds using the trap-threshold error-statistics threshold-value interval interval-value command, the error-down-threshold error-statistics n interval m configuration is automatically generated after the system software version is upgraded to V200R009C00 or a later version.

On a switch running a version earlier than V200R009C00, if the error-down-threshold error-statistics configuration exists on the switch, the configuration remains unchanged after the system software version is upgraded to V200R009C00 or a later version.

Example

By default, the alarm threshold of error packets that cause the interface status to change to Error-Down is 10 and the alarm interval is 30 seconds.

<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] error-down-threshold error-statistics 10 interval 30

error-statistics threshold-event trigger error-down

Function

The error-statistics threshold-event trigger error-down command configures an interface to transit to the error-down state when the number of error packets received on the interface reaches the threshold.

The undo error-statistics threshold-event trigger error-down command restores the default setting.

By default, an interface does not transit to the error-down state when the number of error packets received on the interface reaches the threshold.

Format

error-statistics threshold-event trigger error-down

undo error-statistics threshold-event trigger error-down

Parameters

None

Views

Ethernet interface view, GE interface view, XGE interface view, MultiGE interface view, 40GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When an Ethernet interface receives excessive error packets, faults such as packet loss will occur. Because the interface is still in Up state, traffic is still transmitted on the interface even if a backup link is configured. To avoid impact on services, you can configure the interface to change to the Error-down state when it receives excessive error packets. When the number of received error packets on the interface exceeds the threshold, the system disables the interface and records the interface status as ERROR DOWN(error-statistics) state (indicating that the interface is Down because of excessive error packets). Services are then switched to the backup link immediately.

Follow-up Procedure

An interface in Error-down state can be recovered using either of the following methods:
  • Manual recovery: If a few interfaces need to be recovered forcibly, run the shutdown and undo shutdown commands in the interface view. Alternatively, run the restart command in the interface view to restart the interfaces.
  • Automatic recovery: If a large number of interfaces need to be recovered, manual recovery is time consuming and some interfaces may be omitted. You can run the error-down auto-recovery cause error-statistics interval interval-value command in the system view to enable automatic interface recovery and set the recovery delay time. An interface in Error-down state automatically recovers when the specified delay time expires.

Example

# Configure GE0/0/1 to transit to the error-down state when the number of error packets received on the interface reaches the threshold.

<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] error-statistics threshold-event trigger error-down

flow-control (interface view)

Function

The flow-control command enables flow control on an Ethernet interface.

The undo flow-control command disables flow control on an Ethernet interface.

By default, flow control is disabled on an Ethernet interface.

Format

flow-control

undo flow-control

Parameters

None

Views

Ethernet interface view, GE interface view, XGE interface view, MultiGE interface view, 40GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Flow control prevents packet loss caused by network congestion. If network congestion occurs on the local device after flow control is configured, the local device sends a message to the remote device, requesting the remote device to temporarily stop sending packets. After receiving the message, the remote device temporarily stops sending packets to the local device regardless of the interface working rate.

Precautions

  • If flow control is enabled on an interface, it must also be enabled on the peer interface.

  • Flow control and flow control auto-negotiation can be configured on Ethernet interfaces, but they cannot be configured concurrently.

  • XGE interfaces on the S5720-32C-HI-24S-AC, and XGE interfaces and the last eight GE interfaces on the S5720-56C-HI-AC, S5720-56C-PWR-HI-AC, and S5720-56C-PWR-HI-AC1 do not support flow control.

  • When an interface works in half-duplex mode, flow control does not take effect on the interface.

  • In a scenario where Layer 3 services are deployed, enabling flow control may affect the IP traffic forwarding on the interface. As a result, the interface becomes unavailable. You can run the undo flow-control command in the interface view to disable flow control to recover the interface.

Example

# Enable flow control on GE0/0/1.
<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] flow-control

flow-control negotiation

Function

The flow-control negotiation command enables flow control auto-negotiation on an Ethernet interface.

The undo flow-control negotiation command disables flow control auto-negotiation on an Ethernet interface.

By default, flow control auto-negotiation is disabled on an Ethernet interface.

Format

flow-control negotiation

undo flow-control negotiation

Parameters

None

Views

Ethernet interface view, GE interface view, XGE interface view, MultiGE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Network congestion causes packet loss. Flow control can prevent packet loss. If congestion occurs on a device, the device sends a message to request the peer device to stop sending packets, which prevents packet loss. Flow control auto-negotiation enables a device to determine whether to enable flow control by negotiating with the peer device.

Prerequisites

Run the negotiation auto command to configure the Ethernet interface to work in auto negotiation mode.

Precautions

  • Electrical interfaces support flow control auto-negotiation.

  • If flow control auto-negotiation is enabled on an interface, it must also be enabled on the peer interface.

  • If flow control has been enabled on an Ethernet interface using the flow-control command, run the undo flow-control command to disable flow control before running the flow-control negotiation command. Otherwise, the flow-control negotiation command fails to be executed.
  • XGE interfaces on the S5720-32C-HI-24S-AC, and XGE interfaces and the last eight GE interfaces on the S5720-56C-HI-AC, S5720-56C-PWR-HI-AC, and S5720-56C-PWR-HI-AC1 do not support flow control auto-negotiation.

  • This command can be used on an XGE optical interface that has a GE copper module installed.

  • This command can be used on a GE optical interface that has a GE optical module or GE copper module installed.
  • In a scenario where Layer 3 services are deployed, configuring flow control auto-negotiation on an Ethernet interface may affect the IP traffic forwarding on the interface. As a result, the interface becomes unavailable. You can run the undo flow-control negotiation command in the interface view to disable flow control auto-negotiation to recover the interface.

NOTE:

On the S2720-52TP-EI, S5700-52P-LI-AC, S5720-52P-LI-AC, S5700-52P-LI-DC, if interfaces 0 to 23 work as inbound interfaces (or outbound interfaces) and interfaces 24 to 47 work as outbound interfaces (or inbound interfaces), flow control auto-negotiation does not take effect on these interfaces.

Example

# Enable flow control auto-negotiation on GE0/0/1.
<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] negotiation auto
[HUAWEI-GigabitEthernet0/0/1] flow-control negotiation

group-member

Function

The group-member command adds specified Ethernet interfaces to a permanent port group.

The undo group-member command deletes specified Ethernet interfaces from a permanent port group.

By default, no Ethernet interface is added to a permanent port group.

Format

group-member { interface-type interface-number1 [ to interface-type interface-number2 ] } &<1-10>

undo group-member { interface-type interface-number1 [ to interface-type interface-number2 ] } &<1-10>

undo group-member all-unavailable-interface

Parameters

Parameter Description Value
interface-type interface-number1 to interface-type interface-number2 Adds an Ethernet interface to a permanent port group.

to indicates an interface range. All interfaces numbered between interface-number1 and interface-number2 are added to the temporary port group.

interface-number2 must be greater than interface-number1.
all-unavailable-interface

Delete all unavailable interfaces from this port-group.

-

Views

Permanent port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If you need to perform the same operations on multiple Ethernet interfaces, configuring each interface one by one easily causes incorrect configurations and is labor-intensive.

The port group function easily solves the problem. You can add all the Ethernet interfaces to the same port group. After you run a configuration command once in the port group view, the configuration takes effect on all the Ethernet interfaces in the port group, reducing the configuration workload.

Prerequisite

Prior to running this command, run the port-group command in the system view to create a permanent interface group.

Configuration Impact

If the group-member command is run more than once, all configurations take effect.

Precautions

  • Both physical and logical interfaces can be added to a permanent port group.
  • This command has the same function as the port-group group-member command that is used in the system view. You can also run the port-group group-member command to add interfaces to a temporary port group to configure the interfaces in batches.

  • When you specify the keyword to in the group-member command:

    • The interfaces specified before and after the keyword to must have the same attribute. For example, both of them are main interfaces or sub-interfaces. If they are sub-interfaces, they must belong to the same main interface.
    • If to is not used, these limitations do not apply.
    • Only the S6720EI, S6720S-EI, S5720HI and S5720EI support sub-interfaces.

Example

# Add GE0/0/1 and GE0/0/2 to port group portgroup1.
<HUAWEI> system-view
[HUAWEI] port-group portgroup1
[HUAWEI-port-group-portgroup1] group-member gigabitethernet 0/0/1 to gigabitethernet 0/0/2

interface (Ethernet interface)

Function

The interface command displays the specified interface view or sub-interface view.

The undo interface command deletes a sub-interface.

Format

interface { ethernet | gigabitethernet | multige | xgigabitethernet | 40ge } interface-number[.subinterface-number ] [ mode l2 ]

undo interface { ethernet | gigabitethernet | multige | xgigabitethernet | 40ge } interface-number[.subinterface-number ]

Parameters

Parameter

Description

Value

gigabitethernet

Displays the view of a GE interface.

-

multige

Displays the view of a MultiGE interface.

NOTE:
Only the S5720-14X-PWH-SI-AC, S5720-28X-PWH-LI-AC, S6720-32C-SI-AC , S6720-32C-SI-DC , S6720-32C-PWH-SI-AC, S6720-52X-PWH-SI, S6720-56C-PWH-SI-AC, S6720-56C-PWH-SI, and S6720-32C-PWH-SI support MultiGE interfaces.

-

xgigabitethernet

Displays the view of an XGE interface.

-

ethernet

Displays the view of an FE interface.

-

40ge

Displays the view of a 40GE interface.

-

interface-number

Specifies the number of an interface.

The value depends on the interface type and slot ID.

subinterface-number

Specifies the number of a sub-interface.

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

mode l2

Configures a sub-interface to work in Layer 2 mode for the VXLAN service.

NOTE:

Only the S6720EI, S6720S-EI, and S5720HI support this parameter.

-

Views

System view

Default Level

2: Configuration level

Usage Guidelines

After entering the specified Ethernet interface view, you can set attributes for the Ethernet interface.

NOTE:
  • Only the S6720EI, S6720S-EI, S5720HI, and S5720EI support Ethernet sub-interfaces.

  • Only hybrid and trunk interfaces on the preceding switches support Ethernet sub-interface configuration.
  • After you run the undo portswitch command to switch Layer 2 interfaces on the preceding series of switches into Layer 3 interfaces, you can configure Ethernet sub-interfaces on the interfaces.

  • After an interface is added to an Eth-Trunk, sub-interfaces cannot be configured on the interface.

  • VLAN termination sub-interfaces cannot be created on a VCMP client.

Example

# Enter the view of GE0/0/1.

<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1]
Related Topics

interface range

Function

The interface range command creates a temporary interface group and adds specified interfaces to this temporary interface group. Commands configured for a temporary interface group then automatically run on all member interfaces.

By default, no temporary interface group is created.

Format

interface range { interface-type interface-number1 [ to interface-type interface-number2 ] } &<1-10>

Parameters

Parameter Description Value
interface-type interface-number1 [ to interface-type interface-number2 ] Specifies Ethernet interfaces to be added to a temporary port group.

to indicates an interface range. All interfaces numbered between interface-number1 and interface-number2 are added to the temporary port group.

The value of interface-number2 must be larger than the value of interface-number1.

A maximum of 48 temporary port groups can be created on a device.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If you need to perform the same operations on multiple Ethernet interfaces, configuring each interface one by one easily causes incorrect configurations and is labor-intensive.

The port group function easily solves the problem. You can add all the Ethernet interfaces to the same port group. After you run a configuration command once in the port group view, the configuration takes effect on all the Ethernet interfaces in the port group, reducing the configuration workload.

Configuration Impact

If the interface range command is run more than once, all configurations take effect.

Precautions

  • The interface range and port-group group-member commands have the same functions. Therefore, use either of the commands for configuration. After exiting from the temporary port group view, the system deletes the temporary port group.
  • The interface range command is equivalent to the group-member command executed in the permanent port group view. Multiple interfaces can be added to a permanent port group in batches using the group-member command.

  • When you specify the keyword to in the interface range command:

    • The interfaces specified by interface-number1 and interface-number2 must reside on the same member switch. To add contiguous interfaces on different member switches to the same port group, run this command several times or use the keyword to several times.
    • The interfaces specified by interface-number1 and interface-number2 must be of the same type, for example, both of the interfaces are GE interfaces.
    • The interfaces specified before and after the keyword to must have the same attribute. For example, both of them are main interfaces or sub-interfaces. If they are sub-interfaces, they must belong to the same main interface.
    • If to is not specified, the preceding limitations do not apply.
    • Only the S6720EI, S6720S-EI, S5720HI and S5720EI support sub-interfaces.

Example

# Add GE0/0/1, 0/0/2, and 0/0/3 to a temporary port group.
<HUAWEI> system-view
[HUAWEI] interface range gigabitethernet 0/0/1 to gigabitethernet 0/0/3
[HUAWEI-port-group]

ifg

Function

The ifg command configures the inter-frame gap (IFG).

The undo ifg command restores the default IFG.

By default, the IFG is 12 bytes.

Format

ifg ifg-value

undo ifg [ ifg-value ]

Parameters

Parameter

Description

Value

ifg-value

Specifies the IFG.

The value is an integer that ranges from 9 to 12, in bytes.

Views

GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The IFG is used to differentiate two data packets. You can run the ifg command to configure the IFG to improve data packet forwarding efficiency.

The packet forwarding rate, also called throughput, refers to the data forwarding capability on an interface and is measured in packet per second (pps). The packet forwarding rate is calculated based on the number of 64-byte data packets transmitted in a period. The lengths of preamble and IFG affect the packet forwarding rate.

The default IFG is the maximum value of 12 bytes and is recommended. If you set the IFG to a small value, the device will not have enough time to receive the next frame after receiving one data frame. The packets then cannot be processed in real time, which results in packet loss.

NOTE:

Only the S5700-X-LI and S1720GFR support the IFG configuration.

Example

# Set the IFG of GE0/0/1 to 10 bytes.
<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] ifg 10

jumboframe enable

Function

The jumboframe enable command sets the maximum frame length allowed by an interface.

The undo jumboframe enable command restores the default maximum frame length allowed by an interface.

By default, the maximum frame length allowed by interfaces of other switches is 9216 bytes.

Format

jumboframe enable [ value ]

undo jumboframe enable

Parameters

Parameter

Description

Value

value

Specifies the maximum frame length allowed by an Ethernet interface.

  • On the S1720GFR, S1720GW, S1720GWR, S1720X, S1720GW-E, S1720GWR-E, S1720X-E, S2720EI, S2750, S5700LI, S5720LI, S5720S-LI, S5710-X-LI, S5700S-LI, S5720SI, S5720S-SI, S5730SI, S5730S-EI, S6720SI, S6720S-SI, S6720LI, and S6720S-LI, the value is an integer that ranges from 1536 to 10240.
  • On the S5720HI, S5720EI, S6720S-EI, and S6720EI, the value is an integer that ranges from 1536 to 12288.
NOTE:

On the S1720GFR, S1720GW, S1720GWR, S1720X, S1720GW-E, S1720GWR-E, S1720X-E, S2720EI, S5720SI, S5720S-SI, S5700S-LI, S5700LI, S5720LI, S5720S-LI, S5710-X-LI, S2750, S5730SI, S5730S-EI, S6720SI, S6720S-SI, S6720LI, and S6720S-LI, value cannot be set to an odd number.

For GE electrical interfaces on the S5730SI, S5730S-EI and S6720SI, value can only be set to 10232.

If value is set to an odd number in a version earlier than V200R008, the value of value increases by one automatically after the system software is upgraded to V200R008 or later versions. For example, value is set to 8879 in V200R007. After the system software is upgraded to V200R008, the value of value is 8880.

Views

Ethernet interface view, GE interface view, XGE interface view, MultiGE interface view, 40GE interface view, port group view, Eth-Trunk interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When transmitting a large amount of data (such as files and videos), an Ethernet interface may receive jumbo frames. If the jumbo frame length exceeds the default data frame length that can be processed, the device directly discards the jumbo frames. You can set the jumbo frame length allowed on an interface.

After you configure the device to allow jumbo frames, packet forwarding becomes more flexible. If multiple common Ethernet frames are used to transmit a data packet, many redundant contents such as interframe gaps (IFGs) and preambles are also transmitted. If jumbo frames are used to transmit the data packet, fewer frames, as well as fewer IFGs and preambles, are transmitted, improving bandwidth efficiency.

Precautions

If you run the jumboframe enable command multiple times in the same interface view to set the maximum frame length allowed by the interface, only the latest configuration takes effect.

If you run the jumboframe enable command on an interface without specifying the value parameter, the interface allows the default jumbo frame length. By default, the jumbo frame length allowed by Ethernet interfaces of other models is 9216 bytes.

IF the length of an outgoing packet exceeds the maximum frame length allowed on an interface, the interface can directly forward the packet.

Example

# Set the maximum frame length allowed by GE0/0/1 to 5000 bytes.

<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] jumboframe enable 5000

log-threshold input-rate output-rate

Function

The log-threshold input-rate output-rate command sets the inbound and outbound bandwidth usage thresholds for generating a log.

The undo log-threshold input-rate output-rate command restores the default inbound and outbound bandwidth usage thresholds for generating a log.

The default inbound and outbound bandwidth usage thresholds for generating a log is 80.

Format

log-threshold { input-rate | output-rate } bandwidth-in-use [ resume-rate resume-threshold ]

undo log-threshold { input-rate | output-rate }

Parameters

Parameter Description Value
input-rate Specifies the inbound bandwidth. -
output-rate Specifies the outbound bandwidth. -
bandwidth-in-use Specifies the bandwidth usage threshold for generating a log. The value is an integer that ranges from 1 to 100.
resume-rate resume-threshold Specifies the bandwidth usage threshold for clearing a log. The value is an integer that ranges from 1 to the value of bandwidth-in-use. The default value is the value of bandwidth-in-use.

Views

Ethernet interface view, GE interface view, XGE interface view, MultiGE interface view, 40GE interface view

Default Level

2: Configuration level

Usage Guidelines

Monitoring bandwidth usage helps you know current load on a device. If the bandwidth usage exceeds a threshold, bandwidth resources are insufficient and the device capacity needs to be expanded. For example, if the bandwidth usage exceeds 95%, an alarm is generated, indicating that bandwidth resources are almost exhausted. As a result, some services may be interrupted before device capacity expansion.

You can configure two thresholds: low threshold (log threshold) and high threshold (alarm threshold). The system generates a log when the bandwidth usage exceeds the low threshold and generates an alarm when the bandwidth usage exceeds the high threshold. This configuration ensures that you can expand the device capacity in advance to avoid service interruptions caused by bandwidth exhaustion.

NOTE:

Outbound bandwidth usage threshold = (Outbound interface rate/Outbound physical interface bandwidth) x 100

Inbound bandwidth usage threshold = (Inbound interface rate/Inbound physical interface bandwidth) x 100

The trap-threshold command is used to set the bandwidth usage threshold for generating a trap.

The log-threshold input-rate output-rate command with the following parameters provides various functions:
  • log-threshold input-rate bandwidth-in-use resume-rate resume-threshold: sets the inbound bandwidth usage threshold for generating a log to provide the following functions:
    • If inbound bandwidth usage value exceeds the value of bandwidth-in-use, an IFNET_BWRATE_IN_RISING log is generated, indicating that inbound bandwidth usage exceeds the configured threshold.
    • If inbound bandwidth usage value is lower than the value of resume-threshold, an IFNET_BWRATE_IN_RESUME log is generated, indicating that inbound bandwidth usage is lower than the configured threshold.
  • log-threshold output-rate bandwidth-in-use resume-rate resume-threshold: sets the outbound bandwidth usage threshold for generating a log to provide the following functions:
    • If outbound bandwidth usage value exceeds the value of bandwidth-in-use, an IFNET_BWRATE_OUT_RISING log is generated, prompting for a bandwidth increase request.
    • If outbound bandwidth usage falls below the threshold specified by resume-threshold, an IFNET_BWRATE_OUT_RESUME log is generated, indicating that bandwidth usage has been restored.

If the offset between the value of bandwidth-in-use and the value of resume-threshold is too small, log information may be frequently displayed.

The log threshold must be lower than the trap threshold, providing efficient protection for services. For example, when the inbound bandwidth usage reaches 80%, a log is generated. If the inbound bandwidth usage continues to increase and reaches 95%, a trap is generated. This ensures that a log is generated for inbound bandwidth usage of 80%, and a trap is generated for inbound bandwidth usage of 95%. Either the log or the trap prompts for a bandwidth increase, preventing service interruption.

Example

# Configure GE0/0/1 to generate a log when the outbound interface rate exceeds 80% of the bandwidth.

<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] log-threshold output-rate 80

# Configure GE0/0/1 to generate a log when the outbound interface rate exceeds 80% of the bandwidth and to clear a log when the outbound interface rate is lower than 60% of the bandwidth.

<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] log-threshold output-rate 80 resume-rate 60
Related Topics

log-threshold input-discard output-discard

Function

The log-threshold input-discard output-discard command enables the log function for inbound and outbound packet loss caused by congestion on an interface.

The undo log-threshold input-discard output-discard command disables the log function for inbound and outbound packet loss caused by congestion on an interface.

By default, the log function for inbound and outbound packet loss caused by congestion is enabled on an interface.

Format

log-threshold { input-discard | output-discard } [ threshold-value interval interval-value ]

undo log-threshold { input-discard | output-discard }

Parameters

Parameter Description Value
input-discard Specifies the log function for inbound packet loss caused by congestion on an interface. -
output-discard Specifies the log function for outbound packet loss caused by congestion on an interface. -
threshold-value Specifies the packet loss threshold for triggering log generation. The value is an integer that ranges from 100 to 4294967295. The default value is 300.
interval interval-value Specifies the interval for collecting statistics on discarded packets. The value is an integer that ranges from 60 to 86400, in seconds. The default value is 300.

Views

Ethernet interface view, GE interface view, XGE interface view, MultiGE interface view, 40GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Network congestion during service transmission may cause packet loss. If a lot of packets are discarded, services are affected. To better monitor the number of discarded packets, you can run the log-threshold input-discard output-discard on an interface to enable the log function for inbound and outbound packet loss caused by congestion. The device generates a log when the number of discarded incoming and outgoing packets on the interface in a specified period exceeds the threshold. Logs help you know the congestion on the interface. You can determine whether to increase the bandwidth or cancel the bandwidth limit on the interface based on the logs. In this way, the congestion problem can be solved.

Precautions

  • If the number of discarded incoming and outgoing packets falls below the threshold in a specified period, the device generates a log indicating that the number of discarded packets falls below the threshold.
  • If the number of discarded packets exceeds the threshold in an interval for collecting statistics on discarded packets, the device immediately generates a log indicating that the number of discarded packets exceeds the threshold, and enters the next statistics interval. In the next statistics interval, the number of discarded packets on an interface is calculated using the following formula:

    Number of discarded packets = Current number of discarded packets - Number of discarded packets in the beginning of the statistics interval

  • If the number of discarded packets exceeds the threshold in several consecutive statistics intervals, the device only generates a log in the first statistics interval, indicating that the number of discarded packets exceeds the threshold. If the number of discarded packets falls below the threshold, the device generates a log indicating that the number of discarded packets falls below the threshold. If the number of discarded packets on an interface exceeds the threshold again, the device will generate a log indicating that the number of discarded packets exceeds the threshold.
  • Running the undo log-threshold input-discard output-discard command restores the default threshold for discarded packets and default interval for collecting statistics on discarded packets, and disables the log function for inbound and outbound packet loss caused by congestion. However, the device still monitors the number of discarded packets and records the information in the diagnosis logs.

Example

# Enable the log function for inbound packet loss caused by congestion on GE0/0/1, and set the threshold for discarded packets to 100 and interval for collecting statistics on discarded packets to 60 seconds.

<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] log-threshold input-discard 100 interval 60

loopback

Function

The loopback command enables loopback detection on an interface.

The undo loopback command disables loopback detection on an interface.

By default, loopback detection is not configured.

Format

loopback internal

undo loopback

Parameters

Parameter

Description

Value

internal

Configures internal loopback detection on a specified interface.

-

Views

Ethernet interface view, GE interface view, XGE interface view, MultiGE interface view, 40GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When testing some special functions, for example, locating an Ethernet fault, you need to enable loopback detection on Ethernet interfaces to check whether the interfaces are working properly. After loopback detection is enabled on an Ethernet interface, the interface is in Up state if it works properly, and is in Down state if it fails.

Follow-up Procedure

Run the display interface command to check whether the current status of the interface configured with internal loopback is Up. If the current status of the interface is Up, the internal forwarding function works well; otherwise, a fault occurs during internal forwarding.

NOTE:

After loopback detection is enabled on an interface, the Speed field in the display this interface command output indicates the configured interface rate or the rate of the installed optical module, copper module, or network cable, and the Bandwidth field in the display interface ethernet brief command output indicates the actual interface rate.

Precautions

Loopback detection interrupts the operation of Ethernet interfaces and links. After loopback detection is performed, run the undo loopback command to disable loopback detection immediately.

NOTE:

You cannot run the loopback command to perform loopback detection on a fabric port.

Example

# Configure loopback detection on GE0/0/1.
<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] loopback internal
Related Topics

loopbacktest

Function

The loopbacktest command configures internal loopback detection on an interface.

By default, internal loopback detection is not configured.

Format

loopbacktest internal

Parameters

Parameter

Description

Value

internal

Configures internal loopback detection. Internal loopback detection is used to check whether the internal forwarding chip controls forwarding on the interface correctly.
  • If the test packet is received, the internal forwarding chip functions properly.
  • If the test packet is not received, the internal forwarding chip is faulty.

-

Views

Ethernet interface view, GE interface view, XGE interface view, MultiGE interface view, 40GE interface view

Default Level

3: Management level

Usage Guidelines

You can run the loopbacktest command to check whether the internal forwarding chip functions properly.

NOTE:

Loopback detection is not required when an interface is shut down.

Loopback detection is not supported on a service stack interface.

The internal loopback detection result can be used only when no service is configured on the switch.

You cannot run the loopbacktest command to perform loopback detection on a fabric port.

After the energy-saving mode is set to basic or deep, loopback detection is disabled on an interface. Therefore, before performing loopback detection, set the energy-saving mode to standard.

Example

# Configure internal loopback detection on GE0/0/1.

<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] loopbacktest internal
Warning: This command may conflict with other service configurations. It can only be used on a device with no configuration. Continu
e?[Y/N]:y
Info: This operation may take a few seconds. Please wait for a moment....................
Info: Loopback packet test succeeded.
Related Topics

mdi

Function

The mdi command configures the medium dependent interface (MDI) mode of an Ethernet electrical interface.

The undo mdi command restores the default MDI mode of an Ethernet electrical interface.

By default, an Ethernet electrical interface automatically identifies the network cable type.

Format

mdi { across | auto | normal }

undo mdi

Parameters

Parameter

Description

Value

across

Sets the MDI mode of an Ethernet electrical interface to across.

-

auto

Sets the MDI mode of an Ethernet electrical interface to auto. An Ethernet electrical interface automatically identifies the network cable type.

-

normal

Sets the MDI mode of an Ethernet electrical interface to normal.

-

Views

Ethernet interface view, GE interface view, XGE interface view, MultiGE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Twisted pairs used to connect Ethernet devices include:

  • Straight-through cable: connects devices of different types, such as a switch and a PC or a switch and a router.
  • Crossover cable: connects devices of the same type, such as two switches, two routers, or two PCs.

Generally, if two interfaces are connected with a twisted-pair cable, the receive pin on the local end must be connected to the transmit pin on the remote end and the transmit pin on the local end must be connected to the receive pin on the remote end so that a link can be Up. According to pin assignment, twisted-pair cables are classified into straight-through and crossover cables. The device must support negotiation and crossover of receive and transmit pins so that Ethernet electrical interfaces can support the two types of twisted-pair cables. The device supports the following medium dependent interface (MDI) modes: auto, normal, and across.

Generally, when interfaces at both ends work in auto mode, devices can communicate regardless of whether the straight-through or crossover cable is used. Set the MDI mode to normal or across only when the device cannot identify the network cable type. When configuring an MDI mode on an interface, pay attention to the following points:
  • When a straight-through cable is used, the local and remote interfaces must use different MDI modes, for example, across mode on one end and normal mode on the other end.
  • When a crossover cable is used, the local and remote interfaces must use the same MDI mode. For example, both ends must use the across or normal mode, or at least one end uses the auto mode
NOTE:

Electrical interfaces support the MDI type configuration.

The XGE electrical interfaces on the ES5D21X02T01 card of the S5720EI can only use the auto MDI type.

The MDI type can be configured on an XGE optical interface that has a GE copper module installed.

The MDI type can be configured on a GE optical interface that has a GE copper module installed.

Example

# Set the MDI mode of GE0/0/1 to across.

<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] mdi across

negotiation active

Function

The negotiation active command configures an interface to work in slave mode.

The undo negotiation active command cancels the slave mode configuration on an interface.

By default, an interface does not work in slave mode.

Format

negotiation active

undo negotiation active

Parameters

None

Views

MultiGE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When a MultiGE interface on a Huawei switch is connected to an interface on a Cisco AP, the two interfaces may both support 2.5 Gbit/s or higher rates, but cannot negotiate to work in the highest rate. You can configure the MultiGE interface on the Huawei switch to work in slave mode (the interface on the Cisco AP works in master mode). The two interfaces then can negotiate to work in the highest rate supported by both of them to improve the data transmission capability.

Precautions

  • It is recommended that you run this command on an interface working in auto-negotiation mode.
  • When MultiGE interfaces of two switches are connected, you cannot configure the negotiation active command on the MultiGE interfaces simultaneously; otherwise, the MultiGE interfaces cannot go Up.

Example

# Configure MultiGE0/0/1 to work in slave mode.

<HUAWEI> system-view
[HUAWEI] interface MultiGE 0/0/1
[HUAWEI-MultiGE0/0/1] negotiation active

negotiation auto

Function

The negotiation auto command configures an Ethernet interface to work in auto-negotiation mode.

The undo negotiation auto command configures an Ethernet interface to work in non-auto negotiation mode.

By default, an Ethernet interface works in auto-negotiation mode.

Format

negotiation auto

undo negotiation auto

Parameters

None

Views

Ethernet interface view, GE interface view, XGE interface view, MultiGE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Earlier Ethernet worked in 10M half-duplex mode and required mechanisms such as Carrier Sense Multiple Access (CSMA)/Collision Detection (CD) to ensure system stability. As Ethernet technology develops, full-duplex Ethernet and 100 Mbit/s Ethernet emerge. This greatly improves Ethernet performance. Auto-negotiation technology allows new Ethernet to be compatible with earlier Ethernet. In auto-negotiation mode, interfaces on both ends of a link negotiate their operating parameters, including the duplex mode and rate. If the negotiation succeeds, the two interfaces work at the same operating parameters.

Precautions

  • For details about Ethernet interfaces supporting the auto-negotiation function, see Licensing Requirements and Limitations for Ethernet Interfaces.
  • By default, auto-negotiation is enabled on GE optical interfaces and rate auto-negotiation is disabled. You can run the speed auto-negotiation command to enable rate auto-negotiation.
  • After configuring the auto-negotiation function on an interface, if you remove and install a single optical fiber on the interface, the interface may be Up and the remote interface may be Down. You can run the shutdown and undo shutdown commands on the remote interface to make the remote interface go Up.

Example

# Configure GE0/0/1 to work in non-auto negotiation mode.
<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] undo negotiation auto
Related Topics

negotiation priority

Function

The negotiation priority command configures the protocol that a MultiGE interface in auto-negotiation mode preferentially uses.

The undo negotiation priority command restores the default protocol that a MultiGE interface in auto-negotiation mode preferentially uses.

By default, a MultiGE interface in auto-negotiation mode preferentially uses IEEE 802.3bz.

NOTE:

Only MultiGE interfaces on the S5720-28X-PWH-LI-AC, S6720-32C-SI-AC, S6720-32C-SI-DC, S6720-32C-PWH-SI-AC, S6720-32C-PWH-SI, S6720-52X-PWH-SI, S6720-56C-PWH-SI-AC, and S6720-56C-PWH-SI support this command.

Format

negotiation priority { 802.3bz | mgbase-t }

undo negotiation priority

Parameters

Parameter Description Value
802.3bz Configures IEEE 802.3bz as the protocol that a MultiGE interface in auto-negotiation mode preferentially uses. -
mgbase-t Configures Mgbase-t as the protocol that a MultiGE interface in auto-negotiation mode preferentially uses. -

Views

MultiGE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the peer device supports 2.5 Gbit/s or 5 Gbit/s rate when the peer device connects to the MultiGE interface of Huawei switch and the peer device uses the proprietary protocol Mgbase-t of the Broadcom company, the MultiGE interface of the interconnected Huawei switch may fail to be enabled. You can configure Mgbase-t as the protocol that the MultiGE interface on the Huawei switch preferentially uses, so that the MultiGE interface can be properly enabled.

Example

# Configure Mgbase-t as the protocol that a MultiGE interface in auto-negotiation mode preferentially uses.

<HUAWEI> system-view
[HUAWEI] interface MultiGE 0/0/1
[HUAWEI-MultiGE0/0/1] negotiation priority mgbase-t

port-group

Function

The port-group command creates a permanent port group and displays the permanent port group view.

The undo port-group command deletes permanent port groups.

By default, no permanent port group is configured.

Format

port-group port-group-name

undo port-group { all | port-group-name }

Parameters

Parameter

Description

Value

port-group-name

Specifies the name of a permanent port group.

The value is a string of 1 to 32 case-insensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string.
NOTE:

A permanent port group cannot be named all. Meanwhile, to avoid a usage conflict between the port-group group-member command and port-group-name, do not specify g, group-member, or first letters of group-member as the name of a permanent interface group.

all

Deletes all port groups.

-

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If you need to perform the same operations on multiple Ethernet interfaces, configuring each interface one by one easily causes incorrect configurations and is labor-intensive.

The port group function easily solves the problem. You can add all the Ethernet interfaces to the same port group. After you run a configuration command once in the port group view, the configuration takes effect on all the Ethernet interfaces in the port group, reducing the configuration workload.

Two types of port groups are available:
  • Temporary port group: To temporarily deliver a configuration to multiple interfaces, you can create a temporary port group. After you deliver the configuration and exit from the port group view, the system automatically deletes the temporary port group.
  • Permanent port group: To deliver configurations to interfaces multiple times, you can create a permanent port group. After you exit from the port group view, the port group and member interfaces in the group still exist, facilitating subsequent batch configuration for the member interfaces. To delete a permanent port group, run the undo port-group { all | port-group-name } command.

Follow-up Procedure

Run the group-member command to add Ethernet interfaces to the created permanent port group.

Precautions

The system supports a maximum of 32 permanent port groups and each port group supports a maximum of 48 member interfaces.

Example

# Create port group portgroup1 and enter the port group view.

<HUAWEI> system-view
[HUAWEI] port-group portgroup1
[HUAWEI-port-group-portgroup1]

port-group group-member

Function

The port-group group-member command creates a temporary port group and adds specified Ethernet interfaces to the temporary port group. Commands configured for a temporary port group will be automatically run on all member interfaces.

By default, no temporary port group is created.

Format

port-group group-member { interface-type interface-number1 [ to interface-type interface-number2 ] } &<1-10>

Parameters

Parameter Description Value
interface-type interface-number1 [ to interface-type interface-number2 ] Specifies Ethernet interfaces to be added to a temporary port group.

to indicates an interface range. All interfaces numbered between interface-number1 and interface-number2 are added to the temporary port group.

The value of interface-number2 must be larger than the value of interface-number1.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If you need to perform the same operations on multiple Ethernet interfaces, configuring each interface one by one easily causes incorrect configurations and is labor-intensive.

The port group function easily solves the problem. You can add all the Ethernet interfaces to the same port group. After you run a configuration command once in the port group view, the configuration takes effect on all the Ethernet interfaces in the port group, reducing the configuration workload.

Two types of port groups are available:
  • Temporary port group: To temporarily deliver a configuration to multiple interfaces, you can create a temporary port group. After you deliver the configuration and exit from the port group view, the system automatically deletes the temporary port group.
  • Permanent port group: To deliver configurations to interfaces multiple times, you can create a permanent port group. After you exit from the port group view, the port group and member interfaces in the group still exist, facilitating subsequent batch configuration for the member interfaces. To delete a permanent port group, run the undo port-group { all | port-group-name } command.

Configuration Impact

If the port-group group-member command is run more than once, all configurations take effect.

Precautions

  • The port-group group-member command is equivalent to the group-member command executed in the permanent port group view. Multiple interfaces can be added to a permanent port group in batches using the group-member command.

  • When you specify the keyword to in the port-group group-member command:

    • The interfaces specified by interface-number1 and interface-number2 must reside on the same member switch. To add contiguous interfaces on different member switches to the same port group, run this command several times or use the keyword to several times.
    • The interfaces specified by interface-number1 and interface-number2 must be of the same type, for example, both of the interfaces are GE interfaces.
    • The interfaces specified before and after the keyword to must have the same attribute. For example, both of them are main interfaces or sub-interfaces. If they are sub-interfaces, they must belong to the same main interface.
    • If to is not specified, the preceding limitations do not apply.
    • Only the S6720EI, S6720S-EI, S5720HI and S5720EI support sub-interfaces.

Example

# Add GE0/0/1, GE0/0/2, and GE0/0/3 to a temporary port group.
<HUAWEI> system-view
[HUAWEI] port-group group-member gigabitethernet 0/0/1 to gigabitethernet 0/0/3
[HUAWEI-port-group]

port-isolate enable

Function

The port-isolate enable command enables port isolation.

The undo port-isolate enable command disables port isolation.

By default, port isolation is disabled.

Format

port-isolate enable [ group group-id ]

undo port-isolate enable [ group group-id ]

Parameters

Parameter

Description

Value

group group-id

Specifies the ID of a port isolation group.

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

Views

Ethernet interface view, GE interface view, XGE interface view, MultiGE interface view, 40GE interface view, port group view, Eth-Trunk interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To implement Layer 2 isolation between interfaces, add different interfaces to different VLANs. This, however, wastes VLAN resources. To save VLAN resources, enable port isolation to isolate interfaces in a VLAN. That is, you can add interfaces to a port isolation group to implement Layer 2 isolation between these interfaces. Port isolation provides secure and flexible networking schemes for customers.

Precautions

  • After port isolation is configured, ports are isolated at Layer 2 but can communicate at Layer 3 by default. To configure both Layer 2 isolation and Layer 3 isolation, run the port-isolate mode all command.

  • Interfaces in a port isolation group are isolated from each other, but interfaces in different port isolation groups can communicate. If group-id is not specified, interfaces are added to port isolation group 1 by default.

Example

# Enable port isolation on GE0/0/1.

<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] port-isolate enable group 1

port-isolate exclude vlan

Function

The port-isolate exclude vlan command excludes a VLAN where port isolation needs to be disabled.

The undo port-isolate exclude vlan command cancels the configuration.

By default, no VLAN is excluded when port isolation is configured.

Format

port-isolate exclude vlan { vlan-id1 [ to vlan-id2 ] } &<1-10>

undo port-isolate exclude vlan { vlan-id1 [ to vlan-id2 ] } &<1-10>

Parameters

Parameter

Description

Value

vlan-id1 Specifies the ID of a VLAN. The value is an integer that ranges from 1 to 4094.
vlan-id2 Specifies the ID of a VLAN. The value is an integer that ranges from 1 to 4094.
vlan-id1 to vlan-id2 Specifies VLAN IDs in a batch.
  • vlan-id1 specifies the first VLAN ID.

  • vlan-id2 specifies the last VLAN ID.

    vlan-id2 must be greater than vlan-id1. vlan-id1 and vlan-id2 determine a VLAN range.

  • If you do not specify to vlan-id2, only one VLAN is specified.

The values of vlan-id1 and vlan-id2 are integers that range from 1 to 4094.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To enable communication between users in a VLAN where port isolation needs to be disabled, run the port-isolate exclude vlan command to exclude the VLAN.

Only S1720GFR, S1720GW, S1720GWR, S1720X, S1720GW-E, S1720GWR-E, S1720X-E, S2720EI, S2750, S5700LI, S5720LI, S5720S-LI, S5720HI, S5710-X-LI, S5720SI, S5720S-SI, S5700S-LI, S5730SI, S5730S-EI, S6720SI, S6720S-SI, S6720LI, and S6720S-LI support this command.

Example

# Exclude VLAN 10 where port isolation needs to be disabled.

<HUAWEI> system-view
[HUAWEI] port-isolate exclude vlan 10

protect-group member

Function

The protect-group member command adds the specified Ethernet interface to an interface protection group.

The undo protect-group member command deletes an Ethernet interface from an interface protection group.

By default, no Ethernet interface is added to an interface protection group.

Format

protect-group member interface-type interface-number { master | standby }

undo protect-group member interface-type interface-number

Parameters

Parameter

Description

Value

interface-type interface-number Specifies the type and number of the interface to be added to an interface protection group.

-

master Indicates the working interface.

-

standby Indicates the protected interface.

-

Views

Interface protection group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Hosts are usually connected to an external network through a default gateway. If the outbound interface of the default gateway fails, the hosts cannot communicate with the external network, interrupting normal service transmission and degrading device reliability. The port protection function solves this problem. Without changing the networking, you can add two interfaces on the device to a port protection group to implement interface backup in active/standby mode. When the active interface fails, services are immediately switched to the standby interface, ensuring non-stop service transmission.

Prerequisites

An interface protection group has been created using the port protect-group command.

Precautions

An interface protection group contains only a working interface and a protected interface.

Example

# Add GigabitEthernet0/0/1 to an interface protection group.

<HUAWEI> system-view
[HUAWEI] port protect-group 1
[HUAWEI-protect-group1] protect-group member gigabitethernet 0/0/1 master

port-isolate mode

Function

The port-isolate mode command sets the port isolation mode.

The undo port-isolate mode command restores the default port isolation mode.

By default, ports are isolated at Layer 2 but can communicate at Layer 3.

Format

port-isolate mode { l2 | all }

undo port-isolate mode

Parameters

Parameter

Description

Value

l2

Indicates that ports are isolated at Layer 2 but can communicate at Layer 3.

-

all

Indicates that ports are isolated at both Layer 2 and Layer 3.

-

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To implement Layer 2 isolation between interfaces, you can add different interfaces to different VLANs. This wastes VLAN resources. Port isolation can isolate interfaces in the same VLAN. That is, you only need to add interfaces to a port isolation group to implement Layer 2 isolation between these interfaces. Port isolation provides secure and flexible networking schemes.

You can configure the interface isolation mode to all to implement Layer 2 and Layer 3 isolation between interfaces in a port isolation group.

NOTE:

The S1720GFR, S1720GW, S1720GWR, S1720X, S1720GW-E, S1720GWR-E, S1720X-E, S2720EI, S2750, S5700LI, S5720LI, S5720S-LI, S5710-X-LI, S5700S-LI, S6720LI and S6720S-LI support isolation at Layer 2 and interworking at Layer 3, and do not support this command.

Example

# Configure Layer 2 isolation and Layer 3 communication.

<HUAWEI> system-view
[HUAWEI] port-isolate mode l2

port media type

Function

The port media type command determines whether an interface configuration item belongs to the optical interface or electrical interface.

The undo port media typecommand restores the default setings.

Format

port media type { copper | fiber }

undo port media type { copper | fiber }

Parameters

Parameter

Description

Value

copper

Indicates that a configuration item belongs to the electrical interface.

-

fiber

Indicates that a configuration item belongs to the optical interface.

-

Views

GE interface view

Default Level

2: Configuration level

Usage Guidelines

This command only distinguishes optical interface configuration and electrical interface configuration, and is not configurable.

If you have specified the interface attributes (such as auto-negotiation, speed, and full-duplex mode) on a combo interface, the system automatically generates this command to determine whether an interface configuration item belongs to the optical interface or electrical interface. After this command is generated, the configuration for the other interface type (such as optical interface) will not be lost if the combo interface works as an electrical interface.

For example, after you run the display this command on a combo interface, the interface configuration is as follows:

#  
interface GigabitEthernet0/0/1
 port media type copper        
  undo negotiation auto        
  speed 100                    
 port media type fiber         
  undo negotiation auto        
#    

The command output shows that there are two configuration items undo negotiation auto and speed 100 when the combo interface works as an electrical interface and one configuration item undo negotiation auto when the combo interface works as an optical interface.

Example

None

port protect-group

Function

The port protect-group command creates an interface protection group and enters the interface protection group view.

The undo port protect-group command deletes the created interface protection group.

By default, no interface protection group is created.

Format

port protect-group protect-group-index

undo port protect-group protect-group-index

Parameters

Parameter

Description

Value

protect-group-index Specifies the ID of an interface protection group. The value is an integer that ranges from 0 to 63.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Hosts are usually connected to an external network through a default gateway. If the outbound interface of the default gateway fails, the hosts cannot communicate with the external network, interrupting normal service transmission and degrading device reliability. The port protection function solves this problem. Without changing the networking, you can add two interfaces on the device to a port protection group to implement interface backup in active/standby mode. When the active interface fails, services are immediately switched to the standby interface, ensuring non-stop service transmission.

Follow-up Procedure

Run the protect-group member command to add the specified Ethernet interface to an interface protection group.

Example

# Create an interface protection group.

<HUAWEI> system-view
[HUAWEI] port protect-group 1

port split

Function

The port split command splits a specified 40GE interface.

The undo port split command cancels the split configuration on a 40GE interface.

By default, no 40GE interface is split into four 10GE interfaces.

Format

port split split-type 40GE:4*XGE

undo port split

Parameters

Parameter Description Value
40GE:4*XGE

Splits a specified 40GE interface into four 10GE interfaces.

-

Views

XGE interface view, 40GE interface view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

Some 40GE optical interfaces can be used as independent interfaces or each can be split into four 10GE interfaces. With the interface split function, a device with 40GE interfaces can provide high-density 10GE interfaces, and can connect to 40GE or 10GE interfaces on the remote device. This function allows for flexible networking and lowers hardware costs.

To split an interface, run the port split split-type 40GE:4*XGE command in the view of the 40GE interface. To merge converted interfaces into the original 40GE interface, run the undo port split command in the view of only one of the four 10GE converted interfaces.

  • If interface split or merge is configured on an interface, the original configuration on the interface is lost. Therefore, exercise caution when deciding to perform the interface split or merge operation.
  • 10GE interfaces converted from a 40GE interface are numbered based on the number of the last 10GE interface on the switch. For interfaces on the switch panel, if the last 10GE interface is numbered XGE 0/y/m and a 40GE interface to be split is numbered 40GE 0/y/n, the four 10GE interfaces converted from the 40GE interface are numbered XGE 0/y/(m + 4 * (n - 1) + 1). For example, if the last 10GE interface on a switch is numbered XGE 0/0/48, the four 10GE interfaces converted from 40GE 0/0/3 are numbered XGE 0/0/57, XGE 0/0/58, XGE 0/0/59, and XGE 0/0/60. For interfaces on a card, m has a fixed value of 0. For example, the four 10GE interfaces converted from 40GE 1/1/1 on a card are numbered XGE 1/1/1, XGE 1/1/2, XGE 1/1/3, and XGE 1/1/4.

    • y: indicates the subcard number.
    • m: indicates the sequence number of the last 10GE interface on the switch.
    • n: indicates the sequence number of the 40GE interface.
    NOTE:
    Split interfaces are numbered in the same sequence as the wires of a cable are numbered. For example, in a 1-to-4 cable, the wire numbered 1 corresponds to the interface with the lowest interface number, and the wire numbered 4 corresponds to the interface with the highest interface number.
  • If an interface is split, the interface and converted interfaces cannot be added to a stack interface, regardless of whether the configuration takes effect. If an interface has been added to a stack interface, the interface cannot be split.
  • After configuring interface split using the port split split-type 40GE:4*XGE command, restart the device to make the configuration take effect. You can run the display port split command in any view to check the status of a split interface.

Example

# Split a 40GE interface into four 10GE interfaces and restart the device to make the configuration take effect.

<HUAWEI> system-view
[HUAWEI] interface 40GE 0/0/1
[HUAWEI-40GE0/0/1] port split split-type 40GE:4*XGE
Warning: This command will take effect only after resetting the board. 40GE0/0/1 will be split up into XGE, and the port configuration will be lost when the port type is changed. Continue? [Y/N]:y
Info: Succeeded in setting the configuration.
[HUAWEI-40GE0/0/1] return
<HUAWEI> reboot
Info: The system is now comparing the configuration, please wait.
Warning: The configuration has been modified, and it will be saved to the next startup saved-configuration file flash:/device.cfg. Continue? [Y/N]:y
Now saving the current configuration to the slot 0.
Save the configuration successfully.
Info: If want to reboot with saving diagnostic information, input 'N' and then execute 'reboot save diagnostic-information'.
System will reboot! Continue?[Y/N]:y
Related Topics

portswitch

Function

The portswitch command changes the working mode of Ethernet interfaces from Layer 3 mode to Layer 2 mode.

The undo portswitch command changes the working mode of Ethernet interfaces from Layer 2 mode to Layer 3 mode.

By default, an Ethernet interface works in Layer 2 mode.

Format

portswitch

undo portswitch

Parameters

None

Views

GE interface view, XGE interface view, 40GE interface view, Eth-Trunk interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, an Ethernet interface on the device works in Layer 2 mode. To enable Layer 3 functions on the interface, run the undo portswitch command on the interface.

Precautions

  • If an interface has the non-attribute configuration, this command cannot be executed. Before running this command, delete the non-attribute configuration on the interface.
  • The minimum interval between running the portswitch and undo portswitch commands must be 30s.

NOTE:

Only interfaces on the S5720HI, S5720EI, S6720S-EI, and S6720EI support switching between Layer 2 and Layer 3 modes.

Ethernet interfaces working at Layer 3 support IP address configuration.

By default, Ethernet interfaces on the device work at Layer 2 mode and have been added to VLAN 1. You can run the undo portswitch command to change the working mode to Layer 3 mode. The Ethernet interfaces are removed from VLAN 1 only after Layer 3 protocols become Up.

Example

# Change the working mode of GE0/0/1 from Layer 2 mode to Layer 3 mode.

<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] undo portswitch
[HUAWEI-GigabitEthernet0/0/1] ip address 10.10.10.10 255.255.255.0 
Related Topics

portswitch batch

Function

The portswitch batch command changes the working mode of Ethernet interfaces from Layer 3 mode to Layer 2 mode in batches.

The undo portswitch batch command changes the working mode of Ethernet interfaces from Layer 2 mode to Layer 3 mode in batches.

By default, the working mode of the interface is Layer 2 mode.

Format

portswitch batch interface-type { interface-number1 [ to interface-number2 ] } &<1-10>

undo portswitch batch interface-type { interface-number1 [ to interface-number2 ] } &<1-10>

Parameters

Parameter Description Value
interface-type interface-number1 [ to interface-number2 ]
Specifies interfaces of which the working mode needs to be changed.
  • interface-number1 specifies the number of the first interface.
  • interface-number2 specifies the number of the last interface.

    The value of interface-number2 must be larger than the value of interface-number1. interface-number1 and interface-number2 specify the range of interfaces.

  • If to interface-number2 is not specified, only the working mode of the interface specified by interface-number1 is changed.

NOTE:

You can specify a maximum of 10 interface number ranges at a time. The entered ranges cannot overlap.

-

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can run the portswitch batch or undo portswitch batch command to change the working mode of interfaces in batches.

Precautions

  • The mode switching function takes effect when the interface only has attribute configurations (for example, shutdown and description configurations). If the service configuration (for example, port link-type access configuration) exists on the interface, you must clear the service configuration before running this command.

  • The minimum interval between running the portswitch batch and undo portswitch batch commands must be 30s.

NOTE:

Only interfaces on the S5720HI, S5720EI, S6720S-EI, and S6720EI support switching between Layer 2 and Layer 3 modes.

Ethernet interfaces working at Layer 3 support IP address configuration.

Example

# Change the working mode of GE0/0/1, 0/0/2, and 0/0/3 to Layer 2 mode.

<HUAWEI> system-view
[HUAWEI] portswitch batch gigabitethernet 0/0/1 0/0/2 0/0/3
Related Topics

reset statistics-peak

Function

The reset statistics-peak command clears Peak Information Rate (PIR) statistics on an interface.

Format

reset statistics-peak interface interface-type interface-number

NOTE:

PIR statistics on the management interface cannot be cleared.

Parameters

Parameter

Description

Value

interface interface-type interface-number

Clears PIR statistics on a specified interface.
  • interface-type specifies the interface type.
  • interface-number specifies the interface number.

-

Views

All views

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, the PIR of an interface indicates the maximum rate of the interface in a long time. To check the recent peak rate of an interface, run the reset statistics-peak command to clear the previous peak rate record and obtain the new peak rate. To view the peak rate of an interface, run the display interface command. The following information is displayed:
Input peak rate 244425848 bits/sec,Record time: 2008-01-01 00:16:37             
Output peak rate 753496 bits/sec,Record time: 2008-01-15 19:25:12

Precautions

PIR statistics on a specified interface cannot be restored after they are cleared. Exercise caution before clearing the statistics.

Example

# Clear PIR statistics on GE0/0/1.

<HUAWEI> reset statistics-peak interface gigabitethernet 0/0/1
Related Topics

reset virtual-cable-test

Function

The reset virtual-cable-test command deletes cable test results on an interface.

Format

reset virtual-cable-test { interface-type interface-number | all }

Parameters

Parameter

Description

Value

interface-type interface-number

Deletes cable test results on a specified interface.
  • interface-type specifies the interface type.
  • interface-number specifies the interface number.
NOTE:

This Parameter can be an XGE optical interface when the interface has a GE copper module installed.

-

all

Deletes cable test results on all interfaces.

-

Views

All views

Default Level

3: Management level

Usage Guidelines

Usage Scenario

Before conducting a cable test on an electrical interface, you can use this command to delete the previous test results.

Precautions

The cable test results cannot be restored after they are cleared. Exercise caution before clearing the statistics.

Example

# Delete cable test results on GE0/0/1.
<HUAWEI> reset virtual-cable-test gigabitethernet 0/0/1

set device port-on-card enable

Function

The set device port-on-card enable command configures the card interface working mode.

The undo set device port-on-card enable command restores the panel interface working mode.

By default, a switch works in the panel interface working mode.

NOTE:

Only S6720-C-SI series switches support this command.

Format

set device port-on-card enable [ slot slot-id ]

undo set device port-on-card enable [ slot slot-id ]

Parameters

Parameter

Description

Value

slot slot-id

Specifies the slot ID.

The value depends on the device configuration.

Views

System view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

S6720-C-SI series switches support extended cards. However, the four 10GE SFP+ Ethernet optical interfaces on the front panel and interfaces on the extended cards (excluding the 4*10GE card) cannot be used simultaneously. By default, a switch uses interfaces on the panel. To use interfaces on a card, run the set device port-on-card enable command to configure the card interface working mode. Interfaces on the panel then cannot be used.

Precautions

  • When a 4*10GE card is installed, both interfaces on the card and panel can be used.

  • After running this command, you must confirm operations as prompted so that the switch automatically restarts to make the configuration take effect. Save the configuration in advance.

  • When the panel interface working mode is changed to the card interface working mode, the four 10GE SFP+ Ethernet optical interfaces on the front panel cannot be used. After the save command is run, the configuration of the four 10GE SFP+ Ethernet optical interfaces on the front panel will be cleared. This applies to the interfaces on the card similarly when the card interface working mode is changed to the panel interface working mode.

Example

# Configure the card interface working mode.

<HUAWEI> system-view
[HUAWEI] set device port-on-card enable

set ethernet speed down-grade

Function

The set ethernet speed down-grade command enables the rate decrease auto-negotiation function on an interface.

The undo set ethernet speed down-grade command disables the rate decrease auto-negotiation function on an interface.

By default, rate decrease auto-negotiation is disabled on an interface.

NOTE:
Rate decrease auto-negotiation takes effect only on MultiGE interfaces, GE optical interfaces that have GE copper modules installed or GE electrical interfaces on the device.

Format

set ethernet speed down-grade

undo set ethernet speed down-grade

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Two devices are connected through two GE electrical interfaces using a network cable. The two GE interfaces are configured to work in rate auto-negotiation mode. The network cable can only work at the rate of 100 Mbit/s or 10 Mbit/s because it deteriorates, but the maximum rate supported by the two GE interfaces is 1000 Mbit/s. The interfaces negotiate the working rate to 1000 Mbit/s, but cannot go Up because the network cable does not support the rate of 1000 Mbit/s.

You can use the rate decrease auto-negotiation function to solve this problem. After rate decrease auto-negotiation is enabled using this command, the two GE interfaces can decrease the negotiated rate to 10 Mbit/s or 100 Mbit/s, and then can go Up.

Prerequisites

The two connected interfaces work in auto-negotiation mode. If an interface works in non-auto-negotiation mode, run the negotiation auto command in the interface view to configure it to work in auto-negotiation mode.

Precautions

If rate decrease auto-negotiation is configured on the local interface, but not on the remote interface, the local interface can still decrease the negotiated rate to 100 Mbit/s. If the rate decrease auto-negotiation function is configured on an interface of the S5720-28X-PWH-LI-AC, S6720-32C-SI-AC, S6720-32C-SI-DC, S6720-32C-PWH-SI-AC, S6720-32C-PWH-SI, S6720-52X-PWH-SI, S6720-56C-PWH-SI-AC or S6720-56C-PWH-SI, you must also configure this function on the remote interface; otherwise, the local and remote interfaces may not go Up.

If the network cable quality is low, a MultiGE interface takes longer time to go Up after the rate decrease auto-negotiation function is configured. For example, if the rate is decreased from 10 Gbit/s to 100 Mbit/s, the MultiGE interface takes about 40 seconds to go Up. If the rate is decreased from 2.5 Gbit/s to 100 Mbit/s, the MultiGE interface takes about 20 seconds to go Up. It is recommended that you replace the network cable.

After the rate decrease auto-negotiation function is configured on a MultiGE interface of the S5720-28X-PWH-LI-AC and a network cable is removed and reinstalled on the interface in Down state continuously, the interface rate automatically decreases to 1000 Mbit/s. You can remove and reinstall the network cable again after the interface goes Up or run the shutdown and undo shutdown commands on the remote interface to restore the interface rate to 2500 Mbit/s.

Example

# Configure the rate decrease auto-negotiation function on a GE interface.
<HUAWEI> system-view
[HUAWEI] set ethernet speed down-grade
Related Topics

set flow-statistics include-interframe

Function

The set flow-statistics include-interframe command configures traffic statistics on an interface to contain the inter-frame gap and preamble.

The undo set flow-statistics include-interframe command configures traffic statistics on an interface not to contain the inter-frame gap and preamble.

By default, traffic statistics on an interface contain the inter-frame gap and preamble.

Format

set flow-statistics include-interframe

undo set flow-statistics include-interframe

Parameters

None

Views

Ethernet interface view, GE interface view, XGE interface view, MultiGE interface view, 40GE interface view, port group view, Eth-Trunk interface view

Default Level

2: Configuration level

Usage Guidelines

You can run the display interface command to view the running status and traffic statistics on an interface. The Last 300 seconds input rate or Last 300 seconds output rate field in the command output indicates the inbound or outbound traffic rate on the interface in the last 300 seconds.

  • If you want to obtain the total number of bytes passing through an interface in a period, configure the device to count the bytes in the interframe gap (IFG) and preamble when collecting traffic statistics on the interface. The interface traffic rate is as follows:

    Interface traffic rate = (Original packet length + IFG + Preamble) x Number of packets passing through the interface every second

  • If you want to obtain only the number of packet bytes passing through an interface in a period, configure the device not to count the bytes in the IFG and preamble when collecting traffic statistics on the interface. The interface traffic rate is as follows:

    Interface traffic rate = Original packet length x Number of packets passing through the interface every second

    By default, the IFG has a fixed value of 12 bytes and the preamble has a fixed value of 8 bytes. You can run the ifg command to configure the IFG.

Example

# Configure traffic statistics on GE0/0/1 to contain the inter-frame gap and preamble.

<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] set flow-statistics include-interframe
Related Topics

set flow-change-ratio

Function

The set flow-change-ratio { input-threshold | output-threshold } upper-limit command sets the trap threshold for a sudden traffic volume change on interfaces.

The undo set flow-change-ratio { input-threshold | output-threshold } upper-limit command restores the default trap threshold for a sudden traffic volume change on interfaces.

By default, the trap threshold for a sudden traffic volume change on interfaces is 50%.

The set flow-change-ratio start-check bandwidth-usage command sets the lower threshold of the initial bandwidth usage percentage for triggering a trap.

The undo set flow-change-ratio start-check bandwidth-usage command restores the default lower threshold of the initial bandwidth usage percentage for triggering a trap.

By default, the lower threshold of the initial bandwidth usage percentage for triggering a trap is 20%.

Format

set flow-change-ratio { input-threshold | output-threshold } upper-limit threshold

set flow-change-ratio start-check bandwidth-usage bandwidth-usage-threshold

undo set flow-change-ratio { input-threshold | output-threshold } upper-limit

undo set flow-change-ratio start-check bandwidth-usage

Parameters

Parameter Description Value
input-threshold Specifies the trap threshold for a sudden traffic volume change in the inbound direction of interfaces. -
output-threshold Specifies the trap threshold for a sudden traffic volume change in the outbound direction of interfaces. -
upper-limit threshold Specifies the threshold for the traffic volume change percentage on interfaces. The value is an integer that ranges from 0 to 100. The default value is 50.
start-check Indicates that the switch checks the initial bandwidth usage when a trap is triggered. -
bandwidth-usage bandwidth-usage-threshold Specifies the lower threshold of the initial bandwidth usage percentage for triggering a trap. The value is an integer that ranges from 0 to 100. The default value is 20.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To allow the switch to detect real-time traffic volume changes on interfaces, you can run this command to set the trap threshold for a sudden traffic volume change on interfaces and the lower threshold of the initial bandwidth usage percentage for triggering a trap.

Traffic volume change percentage on interfaces = |Interface rate in the current traffic statistics collection interval - Interface rate in the previous traffic statistics collection interval| / Interface rate in the previous traffic statistics collection interval

Configuration Impact

If the trap function for a sudden traffic volume change is enabled (using the snmp-agent trap enable feature ifpdt trap-name hwInputRateChangeOverThresholdNotice or snmp-agent trap enable feature ifpdt trap-name hwOutputRateChangeOverThresholdNotice command) after the set flow-change-ratio command is enabled, a trap will be generated when the traffic volume change percentage on interfaces exceeds the specified threshold (value of threshold) and the bandwidth usage percentage is not lower than the lower threshold (value of bandwidth-usage-threshold).

Precautions

You can run the set flow-stat interval command to configure the traffic statistics collection interval on interfaces. The default interval is 300 seconds.

Example

# Set the trap threshold for a sudden traffic volume change in the inbound direction of interfaces to 70%.

<HUAWEI> system-view
[HUAWEI] set flow-change-ratio input-threshold upper-limit 70

set flow-change-ratio input-broadcast-detect disable

Function

The set flow-change-ratio input-broadcast-detect disable command disables detection of a sudden broadcast traffic volume change in the inbound direction of interfaces.

The undo set flow-change-ratio input-broadcast-detect disable command enables detection of a sudden broadcast traffic volume change in the inbound direction of interfaces.

By default, detection of a sudden broadcast traffic volume change in the inbound direction of interfaces is enabled.

Format

set flow-change-ratio input-broadcast-detect disable

undo set flow-change-ratio input-broadcast-detect disable

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, the switch checks whether the volume of broadcast traffic in the inbound direction of interfaces changes suddenly, and generates a trap after detecting a sudden change, facilitating network maintenance.

If the switch has many interfaces, detection of a sudden broadcast traffic volume change in the inbound direction of interfaces consumes some CPU and memory resources. You can run the set flow-change-ratio input-broadcast-detect disable command to disable the function.

Precautions

If the system software is upgraded from V200R009C00 or an earlier version to V200R010C00 or a later version, detection of a sudden broadcast traffic volume change in the inbound direction of interfaces is disabled by default.

Example

# Disable detection of a sudden broadcast traffic volume change in the inbound direction of interfaces.

<HUAWEI> system-view
[HUAWEI] set flow-change-ratio input-broadcast-detect disable

single-fiber enable

Function

The single-fiber enable command enables the single-fiber communication function on an optical interface.

The undo single-fiber enable command disables the single-fiber communication function on an optical interface.

By default, the single-fiber communication function is disabled on an interface.

Format

single-fiber enable

undo single-fiber enable

Parameters

None

Views

XGE interface view, port group view, 40GE interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

During network management and maintenance, the administrator may need to send traffic from users to a specified server for analysis and processing. If a server can receive and send packets, there is a possibility that the server forwards user traffic to other devices, causing a security risk. The unidirectional single-fiber communication function can address this issue. A single fiber means that two optical modules are connected by only one fiber, and unidirectional communication means that packets can be sent in only one direction. With this function, a switch can only send but cannot receive packets, and an analysis server can only receive but cannot send packets. The data security on the analysis server is ensured.

Precautions

An optical interface does not support this function after it connects to a cable.

The remote interface also works in non-auto negotiation mode and the rate of the peer interface is the same as the rate of the local interface.

NOTE:

The single-fiber enable command and the Configuring Internal Loopback Detection and MAC SWAP loopback test function cannot be configured on the same interface.

An XGE optical interface supports the single-fiber enable command only when it has no module installed or has an XGE optical module installed. Particularly, XGE optical interfaces on the S5720-EI, S6720-EI, and S6720S-EI also support the single-fiber enable command after GE optical modules are installed.

A 40GE optical interface supports the single-fiber enable command only when it has no optical module installed or has a 40GE optical module installed.

On an interface with the single-fiber enable command configured, the command is deleted by the system in the following situations:
  • The XGE interface is connected to a cable or has a GE optical module installed.
  • The 40GE interface is connected to a cable.

Example

# Enable XGigabitEthernet0/0/1 to send packets through a single fiber.
<HUAWEI> system-view
[HUAWEI] interface XGigabitEthernet 0/0/1
[HUAWEI-XGigabitEthernet0/0/1] single-fiber enable
Related Topics

snmp-agent trap enable feature-name ifnet

Function

The snmp-agent trap enable feature-name ifnet command enables the trap function for the IFNET module.

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

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

Format

snmp-agent trap enable feature-name ifnet [ trap-name { hwentityextcfmovercard | hwentityextcfmoverslot | hwextinterfacedelete | hwifflowdown | hwifflowup | hwifmonitorcrcerrorresume | hwifmonitorcrcerrorrising | hwifmonitorinputrateresume | hwifmonitorinputraterising | hwifmonitoroutputrateresume | hwifmonitoroutputraterising | hwifnamechange | hwifnamechangeresume | linkdown | linkup } ]

undo snmp-agent trap enable feature-name ifnet [ trap-name { hwentityextcfmovercard | hwentityextcfmoverslot | hwextinterfacedelete | hwifflowdown | hwifflowup | hwifmonitorcrcerrorresume | hwifmonitorcrcerrorrising | hwifmonitorinputrateresume | hwifmonitorinputraterising | hwifmonitoroutputrateresume | hwifmonitoroutputraterising | hwifnamechange | hwifnamechangeresume | linkdown | linkup } ]

Parameters

Parameter

Description

Value

trap-name Enables the traps of IFNET events of specified types. -
hwentityextcfmovercard Enables the trap function for configurations related to the interface sub-card. -
hwentityextcfmoverslot Enables the trap function for configurations related to the device. -
hwextinterfacedelete Enables the trap function for an interface deletion event. -
hwifflowdown Enables the trap function for the event that the status of traffic on an interface becomes Down. -
hwifflowup Enables the trap function for the event that the status of traffic on an interface becomes Up. -
hwifmonitorcrcerrorresume Enables the trap function for the event that the number of CRC error packets on an interface falls below the threshold. -
hwifmonitorcrcerrorrising Enables the trap function for the event that the number of CRC error packets on an interface exceeds the threshold. -
hwifmonitorinputrateresume Enables the trap function for the event that the rate of incoming traffic on an interface falls below the threshold. -
hwifmonitorinputraterising Enables the trap function for the event that the rate of incoming traffic on an interface exceeds the threshold. -
hwifmonitoroutputrateresume Enables the trap function for the event that the rate of outgoing traffic on an interface falls below the threshold. -
hwifmonitoroutputraterising Enables the trap function for the event that the rate of outgoing traffic on an interface exceeds the threshold. -
hwifnamechange Enables the trap function for the event that the device joins a stack and the interface number format is changed from slot ID/subcard ID/port number to stack member ID/slot ID/subcard ID/port number. -
hwifnamechangeresume Enables the trap function for the event that the device leaves a stack and the interface number format is changed from stack member ID/slot ID/subcard ID/port number to slot ID/subcard ID/port number. -
linkdown Enables the trap function for the event that the link layer protocol status becomes Down. -
linkup Enables the trap function for the event that the link layer protocol status becomes Up. -

Views

System view

Default Level

2: Configuration level

Usage Guidelines

You can specify trap-name to enable the trap function for one or more events of the IFNET module.

Example

# Enable all traps of the IFNET module.

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

snmp-agent trap enable feature-name ifpdt

Function

The snmp-agent trap enable feature-name ifpdt command enables the trap function for the IFPDT module.

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

The default configuration of the snmp-agent trap enable feature-name ifpdt command can be checked using the display snmp-agent trap feature-name ifpdt all command.

Format

snmp-agent trap enable feature-name ifpdt [ trap-name { hwcablesnrabnormal | hwcablesnrdetectnotsupport | hwcablesnrnormal | hwportnosupportoetrap | hwtrunkmemspeeddifferentalarm | hwtrunkmemspeeddifferentresume | hwporterrorrateexceed | hwsubifnumexceededspecalarm | hwsubifnumexceededspecalarmresume | hwinputratechangeoverthresholdnotice | hwoutputratechangeoverthresholdnotice | hwphysicalportinbroadcastrapidchange | hwportprotectgroupunavailable | hwportprotectgroupavailable | hwportprotectgroupdelete } ]

undo snmp-agent trap enable feature-name ifpdt [ trap-name { hwcablesnrabnormal | hwcablesnrdetectnotsupport | hwcablesnrnormal | hwportnosupportoetrap | hwtrunkmemspeeddifferentalarm | hwtrunkmemspeeddifferentresume | hwporterrorrateexceed | hwsubifnumexceededspecalarm | hwsubifnumexceededspecalarmresume | hwinputratechangeoverthresholdnotice | hwoutputratechangeoverthresholdnotice | hwphysicalportinbroadcastrapidchange | hwportprotectgroupunavailable | hwportprotectgroupavailable | hwportprotectgroupdelete } ]

NOTE:

Only the S5720EI supports hwporterrorrateexceed parameter in the command.

Only the S6720EI, S6720S-EI, S5720HI, and S5720EI support hwsubifnumexceededspecalarm or hwsubifnumexceededspecalarmresume parameter in the command.

Parameters

Parameter

Description

Value

trap-name Enables the trap function for a specified event of the IFPDT module. -
hwcablesnrabnormal Enables the trap function for the event that the network cable quality is abnormal. -
hwcablesnrdetectnotsupport Enables the trap function for the event that the network cable quality cannot be checked. -
hwcablesnrnormal Enables the trap function for the event that the network cable quality is normal. -
hwportnosupportoetrap Enables the trap function for the event that a stack interface connects to a copper module or a GE optical module. -
hwtrunkmemspeeddifferentalarm Enables the trap function for the event that rates of active interfaces of the Eth-Trunk are different. -
hwtrunkmemspeeddifferentresume Enables the trap function for the event that rates of active interfaces of the Eth-Trunk are changed to be the same. -
hwporterrorrateexceed Enables the trap function for the event that the rate of CRC, Giants, and Runts error packets received by an interface is greater than or equal to 1000 packets per second. -
hwsubifnumexceededspecalarm Enables the trap function for the event that the number of sub-interfaces on the switch exceeds the maximum value. -
hwsubifnumexceededspecalarmresume Enables the trap function for the event that the number of sub-interfaces on the switch is within the normal range. -
hwinputratechangeoverthresholdnotice Enables the trap function for a sudden traffic volume change in the inbound direction of interfaces. -
hwoutputratechangeoverthresholdnotice Enables the trap function for a sudden traffic volume change in the outbound direction of interfaces. -
hwphysicalportinbroadcastrapidchange Enables the trap function for the event that the rapid-change-ratio of inputbroadcast exceeded the threshold. -
hwportprotectgroupunavailable Enables the trap function for the event that the port protection group function becomes unavailable. -
hwportprotectgroupavailable Enables the trap function for the event that the port protection group function becomes available. -
hwportprotectgroupdelete Enables the trap function for the event that the port protection group is deleted. -

Views

System view

Default Level

2: Configuration level

Usage Guidelines

You can specify trap-name to enable the trap function for one or more events of the IFPDT module.

Example

# Enable all traps of the IFPDT module.

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

snmp-agent trap enable feature-name error-down

Function

The snmp-agent trap enable feature-name error-down command enables the trap function for the error-down module.

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

By default, the trap function is disabled for the error-down module.

Format

snmp-agent trap enable feature-name error-down [ trap-name { hwerrordown | hwerrordownrecovery } ]

undo snmp-agent trap enable feature-name error-down [ trap-name { hwerrordown | hwerrordownrecovery } ]

Parameters

Parameter Description Value
trap-name trap-name

Enables or disables the trap function for a specified event of the error-down module.

-
hwerrordown Enables the trap function for the error-down event. -
hwerrordownrecovery Enables the trap function for the error-down clear event. -

Views

System view

Default Level

2: Configuration level

Usage Guidelines

You can specify trap-name to enable the trap function for one or more events of the error-down module.

Example

# Enable the trap function for the error-down event.

<HUAWEI> system-view
[HUAWEI] snmp-agent trap enable feature-name error-down trap-name hwerrordown

speed

Function

The speed command sets the rate for an Ethernet interface in non-auto negotiation mode.

The undo speed command restores the default rate of an Ethernet interface in non-auto negotiation mode.

By default, an Ethernet interface works at its highest rate when it works in non-auto negotiation mode.

Format

speed { 10 | 100 | 1000 | 2500 | 5000 | 10000 }

undo speed

Parameters

Parameter

Description

Value

10

Indicates that the interface works at 10 Mbit/s.

-

100

Indicates that the interface works at 100 Mbit/s.

-

1000

Indicates that the interface works at 1000 Mbit/s.

NOTE:

FE interfaces do not support this parameter.

-

2500

Sets the auto-negotiation rate of an Ethernet electrical interface to 2500 Mbit/s.

NOTE:

Only MultiGE interfaces support this parameter.

-

5000

Sets the auto-negotiation rate of an Ethernet electrical interface to 5000 Mbit/s.

NOTE:

Only MultiGE interfaces support this parameter.

-

10000

Sets the auto-negotiation rate of an Ethernet electrical interface to 10000 Mbit/s.

NOTE:

Only MultiGE interfaces support this parameter.

-

Views

Ethernet interface view, GE interface view, MultiGE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In non-auto negotiation mode, if interfaces on two connected devices work at different rates, use the speed command to change the rates of the interfaces to be the same so that the two devices can communicate.

Precautions

If the remote interface does not support the auto negotiation mode, run the undo negotiation auto command on the local interface to configure the interface to work in non-auto negotiation mode. You can then change the rate of the local interface to be the same as the rate of the remote interface to ensure proper communication.

Example

# Configure GE0/0/1 to work at 100 Mbit/s in non-auto negotiation mode.
<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] undo negotiation auto
[HUAWEI-GigabitEthernet0/0/1] speed 100

speed auto-negotiation

Function

The speed auto-negotiation command enables auto-negotiation on a GE optical interface.

The undo speed auto-negotiation command disables auto-negotiation on a GE optical interface.

By default, auto-negotiation is disabled on a GE optical interface.

Format

speed auto-negotiation

undo speed auto-negotiation

Parameters

None

Views

GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If an optical interface is configured to work in auto-negotiation mode using the negotiation auto command, the interface cannot negotiate the rate with another interface. You can run the speed auto-negotiation command to configure the auto-negotiation function on the interface.

Prerequisites

Run the negotiation auto command to enable auto-negotiation before using the speed auto-negotiation command on the interface.

Precautions

  • The speed auto-negotiation command will make flow control auto-negotiation and internal loopback ineffective.
  • After configuring the auto-negotiation function on an interface, if you remove and install a single optical fiber on the interface, the interface may be Up and the remote interface may be down. You can run the shutdown and undo shutdown commands on the remote interface to make the remote interface go Up.
  • After auto-negotiation is configured on an interface, if this interface becomes Up and the remote interface becomes Down after the negotiation, run the shutdown and undo shutdown commands on the remote interface or run the undo speed auto-negotiation and speed auto-negotiation commands on this interface to enable the two ends to negotiate their rate again.
  • The last four GE optical interfaces of the S5720-36PC-EI, S5720-56PC-EI, S5720-32P-EI, and S5720-52P-EI do not support this command.
  • The last four GE optical interfaces of the S5720S-28P-SI, S5720S-52P-SI, S5720-28P-SI, and S5720-52P-SI do not support this command.
  • For S5700LI series switches, only the first 24 GE optical interfaces of the S5700-28P-LI-24S-BAT, combo optical interfaces of the S5700-28TP-LI, S5700-28TP-PWR-LI, and S5701-28TP-PWR-LI-AC, and GE optical interfaces of the S5700-52X-LI-48CS, S5700-28X-LI-24S, and S5701-28X-LI-24S-AC support this command.
  • The first two GE optical interfaces of the S2750EI and GE optical interfaces of the S5700S-LI do not support this command.

Example

# Enable auto-negotiation on GE0/0/1.
<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] negotiation auto
[HUAWEI-GigabitEthernet0/0/1] speed auto-negotiation
Related Topics

statistic enable (interface view)

Function

The statistic enable command enables IPv4 or IPv6 packet statistics collection on an interface.

The undo statistic enable command disables IPv4 or IPv6 packet statistics collection on an interface.

By default, IPv4 or IPv6 packet statistics collection is disabled on an interface.

NOTE:

Only the S5720EI, S5720HI, S6720EI, and S6720S-EI support this command.

Format

{ ipv4 | ipv6 } * statistic enable { both | inbound | outbound }

undo { ipv4 | ipv6 } * statistic enable { both | inbound | outbound }

Parameters

Parameter

Description

Value

ipv4

Indicates IPv4 packet statistics collection.

-

ipv6

Indicates IPv6 packet statistics collection.

-

both

Indicates statistics collection for incoming and outgoing packets.

-

inbound

Indicates statistics collection for incoming packets.

-

outbound

Indicates statistics collection for outgoing packets.

-

Views

VLANIF interface view, Eth-Trunk interface view, GE interface view, XGE interface view, 40GE interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To check the network status or locate network faults, you can enable IPv4 or IPv6 packet statistics collection on an interface to collect IPv4 or IPv6 packet statistics on the interface.

Precautions

  • This command and the statistic enable { both | inbound | outbound } command used in the VLANIF interface view are mutually exclusive.

  • If this command and the traffic policy command are configured together on the S5720HI, traffic policy will fail to be applied.

Example

# Enable IPv4 packet statistics collection in the inbound direction of GigabitEthernet0/0/1.

<HUAWEI> system-view
[HUAWEI] interface GigabitEthernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] ipv4 statistic enable inbound

traffic-pppoe

Function

The traffic-pppoe command configures an interface to allow only PPPoE packets to pass through.

The undo traffic-pppoe command cancels the configuration.

By default, an interface allows all types of packets to pass through.

NOTE:

S5720HI does not support the configuration.

Format

traffic-pppoe { any | source-address } { any | destination-address }

undo traffic-pppoe { any | source-address } { any | destination-address }

Parameters

Parameter

Description

Value

{ any | source-address }

Indicates that an interface allows PPPoE packets with a specified source MAC address to pass through.
  • any indicates that PPPoE packets with any source MAC address can pass through the interface.
  • source-address indicates that PPPoE packets with a specified source MAC address can pass through the interface.

The value of source-address is in the format H-H-H. An H contains 1 to 4 hexadecimal digits.

{ any | destination-address }

Indicates that an interface allows PPPoE packets with a specified destination MAC address to pass through.
  • any indicates that PPPoE packets with any destination MAC address can pass through the interface.
  • destination-address indicates that PPPoE packets with a specified destination MAC address can pass through the interface.

The value of destination-address is in the format H-H-H. An H contains 1 to 4 hexadecimal digits.

Views

Ethernet interface view, GE interface view, XGE interface view, MultiGE interface view, 40GE interface view, port group view, Eth-Trunk interface view

Default Level

2: Configuration level

Usage Guidelines

If you run the traffic-pppoe any any command on an interface, the interface allows only PPPoE packets to pass through and discards other packets.

Example

# Configure GE0/0/1 to allow only PPPoE packets to pass through.

<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] traffic-pppoe any any

# Configure GE0/0/1 to allow only PPPoE packets with source MAC address 1-1-1 to pass through.

<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] traffic-pppoe 1-1-1 any

training (40GE interface view)

Function

The training disable and undo training enable commands disable the training function on a 40GE interface.

The training enable and undo training disable commands enable the training function on a 40GE interface.

By default, the training function is enabled on a 40GE interface.

NOTE:

Only the S6720EI and S6720S-EI support this command.

Format

training { enable | disable }

undo training { enable | disable }

Parameters

None

Views

40GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

With the increase of transmission rate or frequency, attenuation of signal's high-frequency components becomes increasingly severe. To guarantee transmission performance of signals, it is necessary to compensate for signals, and commonly used compensation technologies are pre-emphasis and balancing. The pre-emphasis technology increases high-frequency components of signals at the transmit end of transmission lines to compensate attenuation during the transmission. However, the pre-emphasis technology increases crosstalk while amplifying high-frequency components. To solve this problem, the balancing technology is developed. The balancing technology is used at the receive end of transmission lines to function like a filter for filtering high-frequency crosstalk.

After the training function is enabled on a 40GE interface, the transmit end exchanges frames with the receive end to automatically set the pre-emphasis and balancing parameters, improving processing efficiency of the two technologies. Note that the negotiated parameters for the training function are obtained based on the site environment. If the site environment changes, for example, from high-temperature environment to low-temperature environment, the parameters may be inaccurate. Therefore, bit errors may occur when the training function is enabled. The training function is optional in IEEE802.3 standards, and its implementation on different types of products from various vendors may differ.

When connecting two devices, enable or disable the training function on both ends simultaneously. By default, the training function is enabled on a 40GE interface. If the training function is disabled on the remote device or the remote device does not support the function, run the training disable or undo training enable command to disable the function.

Precautions

  • The training disable and undo training enable commands can be configured on a 40GE interface only when the interface connects to a high-speed cable and is not a physical member interface in a stack.

  • After a cable is installed on a 40GE interface without the training disable configuration, the training enable configuration is automatically generated on the interface.

  • If no cable is installed on an interface, only the training enable and undo training disable commands can be configured on the interface.

  • If the display this include-default command is run on an interface to view the training configuration after a cable is installed on the interface, the default training enable configuration is always displayed in the command output and does not change with the training configuration change.
  • The training configuration on an interface takes effect only after a cable is installed on the interface. If the cable is replaced with an optical module, the training disable and training enable configurations will be automatically deleted from the interface.

  • If a 40GE interface is configured as a physical member interface in a stack system, the training disable and training enable configurations will be automatically deleted from the interface.

  • If a 40GE interface has been configured as a physical member interface in a stack system, the training function is disabled on the interface by default and cannot be enabled.

  • If the training disable or undo training enable command is configured on a 40GE interface of the S6720S-26Q-EI-24S-AC or S6720S-26Q-EI-24S-DC after a cable is installed on the interface, and the interface is connected to a remote interface on which the training function is disabled or a remote interface that does not support the training function, the two interfaces may not go Up or go Up after a delay. Therefore, configure the training disable or undo training enable command only when the training function is disabled on the remote interface or the remote interface does not support the training function. In other scenarios, it is recommended that you do not disable the training function.
  • If the training configuration does not exist on an interface of a switch running V200R009C00 or an earlier version, the training disable configuration is automatically generated on the interface after the system software is upgraded to a version later than V200R010C00. If the training configuration exists on the interface, the configuration remains unchanged after the system software is upgraded to a version later than V200R010C00.

Example

# Disable the training function on 40GE0/0/1.

<HUAWEI> system-view
[HUAWEI] interface 40ge 0/0/1
[HUAWEI-40GE0/0/1] training disable
Warning: The configuration will cause an abnormality in port running. Continue? [Y/N]:y

transceiver power low trigger error-down

Function

The transceiver power low trigger error-down command enables an Ethernet optical interface to enter the error-down state when the optical power is low.

The undo transceiver power low trigger error-down command disabled an Ethernet optical interface from entering the error-down state when the optical power is low.

By default, an Ethernet optical interface does not enter the error-down state when the optical power is low.

Format

transceiver power low trigger error-down

undo transceiver power low trigger error-down

Parameters

None

Views

Ethernet interface view, GE interface view, XGE interface view, 40GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Low optical power of the device may cause intermittent service interruption. To ensure that services are running properly, enable an interface to enter the error-down state when the optical power is low so that services can be switched in a timely manner.

Follow-up Procedure

An interface in Error-down state can be recovered using either of the following methods:
  • Manual recovery: If a few interfaces need to be recovered forcibly, run the shutdown and undo shutdown commands in the interface view. Alternatively, run the restart command in the interface view to restart the interfaces.
  • Automatic recovery: If a large number of interfaces need to be recovered, manual recovery is time consuming and some interfaces may be omitted. You can run the error-down auto-recovery cause transceiver-power-low interval interval-value command in the system view to enable automatic interface recovery and set the recovery delay time. An interface in Error-down state automatically recovers when the specified delay time expires.

Example

# Enable GE0/0/1 to enter the error-down state when the optical power is low.

<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] transceiver power low trigger error-down

trap-threshold

Function

The trap-threshold command sets the inbound and outbound bandwidth usage thresholds for generating a trap.

The undo trap-threshold command restores the default inbound and outbound bandwidth usage thresholds for generating a trap.

The default inbound or outbound bandwidth usage threshold for generating a trap is 80.

Format

trap-threshold { input-rate | output-rate } bandwidth-in-use [ resume-rate resume-threshold ]

undo trap-threshold { input-rate | output-rate }

Parameters

Parameter Description Value
input-rate Indicates inbound bandwidth. -
output-rate Indicates outbound bandwidth. -
bandwidth-in-use Specifies the bandwidth usage threshold for generating a trap. The value is an integer that ranges from 1 to 100.
resume-rate resume-threshold Specifies the bandwidth usage threshold for clearing a trap. The value is an integer that ranges from 1 to bandwidth-in-use. The default value is bandwidth-in-use.

Views

Ethernet interface view, GE interface view, XGE interface view, MultiGE interface view, 40GE interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Monitoring bandwidth usage helps you know current load on a device. If the bandwidth usage exceeds a threshold, bandwidth resources are insufficient and the device capacity needs to be expanded. For example, if the bandwidth usage exceeds 95%, an alarm is generated, indicating that bandwidth resources are almost exhausted. As a result, some services may be interrupted before device capacity expansion.

You can configure two thresholds: low threshold (log threshold) and high threshold (alarm threshold). The system generates a log when the bandwidth usage exceeds the low threshold and generates an alarm when the bandwidth usage exceeds the high threshold. This configuration ensures that you can expand the device capacity in advance to avoid service interruptions caused by bandwidth exhaustion.

NOTE:

Outbound bandwidth usage = (Outbound interface rate/Outbound physical interface bandwidth) x 100

Inbound bandwidth usage = (Inbound interface rate/Inbound physical interface bandwidth) x 100

The interface rate and bandwidth are expressed in bits per second.

To set a lower threshold, run the log-threshold command.

The trap-threshold command sets the bandwidth usage threshold for generating a trap. The trap-threshold with the following parameters provides various functions:
  • trap-threshold input-rate bandwidth-in-use resume-rate resume-threshold: sets the inbound bandwidth usage threshold for generating a trap.
    • If inbound bandwidth usage exceeds the threshold specified in bandwidth-in-use, an hwIfMonitorInputRateRising trap is generated, indicating that inbound bandwidth usage exceeds the configured threshold.
    • If inbound bandwidth usage falls below the threshold specified in resume-threshold, an hwIfMonitorInputRateResume trap is generated, indicating that inbound bandwidth usage falls between the configured threshold for clearing a trap.
  • trap-threshold output-rate bandwidth-in-use resume-rate resume-threshold: sets the outbound bandwidth usage threshold for generating a trap.
    • If outbound bandwidth usage exceeds the threshold specified in bandwidth-in-use, an hwIfMonitorOutputRateRising trap is generated, indicating that outbound bandwidth usage exceeds the configured threshold.
    • If outbound bandwidth usage falls below the threshold specified in resume-threshold, an hwIfMonitorOutputRateResume trap is generated, indicating that outbound bandwidth usage falls between the configured threshold for clearing a trap.

If the offset between the value of bandwidth-in-use and the value of resume-threshold is too small, trap information may be frequently displayed.

The log threshold must be lower than the trap threshold, providing efficient protection for services. For example, when the inbound bandwidth usage reaches 80%, a log is generated. If the inbound bandwidth usage continues to increase and reaches 95%, a trap is generated. This ensures that a log is generated for inbound bandwidth usage of 80%, and a trap is generated for inbound bandwidth usage of 95%. Either the log or the trap prompts for a bandwidth increase, preventing service interruption.

Example

# Configure GE0/0/1 to generate a trap when the outbound bandwidth usage exceeds 60%.
<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] trap-threshold output-rate 60

# Configure GE0/0/1 to generate a trap when the outbound bandwidth usage exceeds 80% and clear the trap when the outbound bandwidth usage falls below 60%.

<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] trap-threshold output-rate 80 resume-rate 60

trap-threshold error-statistics

Function

The trap-threshold error-statistics command sets the alarm threshold for error packets and alarm interval.

The undo trap-threshold error-statistics command restores the default alarm threshold for error packets and default alarm interval.

By default, the alarm threshold for error packets is 3 and the alarm interval is 10 seconds.

Format

trap-threshold error-statistics threshold-value interval interval-value

undo trap-threshold error-statistics

Parameters

Parameter

Description

Value

threshold-value

Sets the alarm threshold for error packets.

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

NOTE:

The value should not be greater than the alarm threshold for error packets that cause the interface status to change to Error-Down configured by the error-down-threshold error-statistics command.

interval interval-value

Sets the interval for reporting alarms for error packets.

The value is an integer that ranges from 10 to 65535, in seconds.

Views

Ethernet interface view, GE interface view, XGE interface view, MultiGE interface view, 40GE interface view, port group view

Default Level

2: Configuration level

Usage Guidelines

The system generates an alarm when the number of error packets received by an interface within an alarm interval exceeds the alarm threshold. If the number of received error packets is 0 in the next alarm interval, the system displays an alarm clearance message.

Example

# Set the alarm threshold for error packets on GE0/0/1 to 10 and the alarm interval to 30 seconds.

<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] trap-threshold error-statistics 10 interval 30

virtual-cable-test

Function

The virtual-cable-test command tests the cable connected to an Ethernet electrical interface and displays the test result.

Format

virtual-cable-test

Parameters

None

Views

Ethernet interface view, GE interface view, XGE interface view, MultiGE interface view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

If the cable is faulty, the interface is in Down state or the interface rate is abnormal even if it is in Up state. You can run the virtual-cable-test command to check whether the cable works properly. According to the command output, you can locate and rectify cable faults.
  • If the cable works properly, the total length of the cable is displayed.

  • If the cable cannot work properly, the distance between the interface and the fault point is displayed.

Precautions

  • The test result is only for reference and may be inaccurate for cables of some vendors.
  • The test result is related to the cable signal attenuation. When the cable length is shorter than 3 m, the cable signal attenuation mostly results from the connector, not the cable. The test result is therefore invalid.
  • Running the virtual-cable-test command may affect services on the interface in a short period of time, and the interface in Up state may alternate between Up and Down.
  • Combo electrical interfaces support cable tests, but cable tests are not recommended on combo electrical interfaces because services will be interrupted.
  • Before performing a cable test, remove the network cable from the remote interface. Otherwise, signals from the remote interface may make the test result inaccurate.
  • This command can be used on an XGE optical interface or GE optical interface when the interface has a GE copper module installed.
  • On the S1720GFR, S1720GW, S1720GWR, S1720GW-E, S1720GWR-E, S2720EI, S2750, S5700S-LI, S5700LI, S5720LI, S5720S-LI, S5710-X-LI, S5720SI, or S5720S-SI, when a GE electrical interface or copper transceiver works at a rate of 1000 Mbit/s or 100 Mbit/s, the test result is only for reference and may be inaccurate if the interface is in Up state.
  • On the S5720EI, S5720HI, S6720S-EI, or S6720EI, when a GE electrical interface or copper transceiver works at a rate of 100 Mbit/s, the test result is only for reference and may be inaccurate.
  • On the S2750, when an FE electrical interface or copper transceiver is in Up state, the test result is only for reference and may be inaccurate.
  • The virtual cable test (VCT) cannot be performed on multiple interfaces of the device at the same time.

Example

# Test the cable connected to GE0/0/1.
<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] virtual-cable-test
Warning: The command will stop service for a while. Continue? [Y/N]y
Info: This operation may take a few seconds. Please wait for a moment..........done.
Pair A length: 189meter(s)
Pair B length: 189meter(s)
Pair C length: 189meter(s)
Pair D length: 189meter(s)
Pair A state: Ok
Pair B state: Ok
Pair C state: Ok
Pair D state: Ok  
Table 4-25  Description of the virtual-cable-test command output

Item

Description

Pair A/B/C/D

Four pairs of circuits in a network cable.

Pair A length

Length of a network cable:
  • The length is the distance between the interface and the fault point if a fault occurs.
  • The length is the actual length of the cable when the cable works properly.
  • The default length is 0 m if the interface is not connected to any network cable.
NOTE:

If the cable length is displayed as Unknown, the cable status is OK, but the cable length test result cannot be used.

If the cable status is Open (indicating open circuit), the cable length in the VCT result can be used.

If the remote interface is shut down, the cable length in the VCT result can be used for combo electrical interfaces on the following switches:
  • S1720-28GWR-PWR-4TP and S1720-28GWR-PWR-4TP-E
  • S2720EI
  • S5720SI, S5720S-SI, S5710LI
  • S5700-52X-LI-48CS-AC, S5720-12TP-LI-AC, S5720-12TP-PWR-LI-AC, S5720-28TP-PWR-LI-AC, S5720S-28TP-PWR-LI-AC, S5720-28TP-PWR-LI-AC, and S5720-28TP-LI-AC
If the remote interface is shut down, the cable length in the VCT result can be used for electrical interfaces on the following switches:
  • S2720EI
  • S5720EI
  • S5720HI
  • S5720-16X-PWH-LI-AC and S5720-28X-PWH-LI-AC
  • S5730SI
  • S5730S-EI
  • S6720SI

Pair A state

Network cable status:
  • Ok: indicates that the circuit pair is terminated normally.
  • Open: indicates that the circuit pair is not terminated.
  • Short: indicates that the circuit pair is short-circuited.
  • Crosstalk: indicates that the circuit pairs interfere with each other.
  • Unknown: indicates that the circuit pair has an unknown fault.
Translation
Download
Updated: 2019-04-18

Document ID: EDOC1000178165

Views: 43061

Downloads: 1107

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