03-Interface Command Reference

HomeSupportSwitchesS7500X-G SeriesReference GuidesCommand ReferencesH3C S7500X-G Switch Series Command References-R7761Pxx-6W10003-Interface Command Reference
02-Ethernet interface commands
Title Size Download
02-Ethernet interface commands 775.54 KB

Contents

Ethernet interface commands· 1

Common Ethernet interface commands· 1

bandwidth· 1

broadcast-suppression· 1

dampening· 3

default 4

description· 5

display counters· 5

display counters rate· 6

display ethernet statistics· 8

display interface· 10

display interface link-info· 22

display interface main· 23

display link-flap protection· 27

display link-state-change statistics interface· 28

display packet-drop· 29

display lbn-group status· 31

display slot-monitor 32

duplex· 33

eee enable· 34

flow-control 35

flow-control receive enable· 35

flow-interval 36

group-member interface· 37

ifmonitor crc-error 38

ifmonitor input-buffer-drop· 39

ifmonitor input-error 41

ifmonitor input-usage· 42

ifmonitor output-buffer-drop· 44

ifmonitor output-error 45

ifmonitor output-usage· 47

ifmonitor rx-pause· 48

ifmonitor tx-pause· 49

interface· 51

interface default-description output 52

jumboframe enable· 52

link-delay· 53

link-flap protect enable· 54

loopback· 55

multicast-suppression· 56

port fec mode· 57

port ifmonitor crc-error 58

port ifmonitor input-buffer-drop· 59

port ifmonitor input-error 60

port ifmonitor input-usage· 61

port ifmonitor output-buffer-drop· 63

port ifmonitor output-error 64

port ifmonitor output-usage· 65

port ifmonitor rx-pause· 66

port ifmonitor tx-pause· 67

port link-flap protect enable· 68

port link-mode· 70

port transceiver-power-low trigger 71

port up-mode· 72

lbn-group· 73

reset counters interface· 73

reset counters mib interface· 74

reset counters slot 75

reset ethernet statistics· 75

reset link-state-change statistics interface· 76

shutdown· 77

shutdown all-physical-interfaces· 78

shutdown-interval crc-error 79

shutdown-interval link-flap· 80

shutdown-interval transceiver-power-low· 81

slot-monitor packet-drop· 82

snmp-agent trap enable eth· 83

snmp-agent trap enable ifmonitor 84

snmp-agent trap enable slot-monitor 86

speed· 87

traffic-statistic include-interframe· 88

unicast-suppression· 89

using fortygige· 90

using hundredgige· 91

using tengige· 93

using twenty-fivegige· 93

Layer 2 Ethernet interface commands· 94

display storm-constrain· 94

mdix-mode· 96

port bridge enable· 97

speed auto· 97

storm-constrain· 98

storm-constrain control 100

storm-constrain enable log· 101

storm-constrain enable trap· 101

storm-constrain interval 102

virtual-cable-test 102

Layer 3 Ethernet interface or subinterface commands· 104

mac-address· 104

mtu· 104

traffic-statistic enable· 105

 


Ethernet interface commands

Common Ethernet interface commands

 

bandwidth

Use bandwidth to set the expected bandwidth of an interface.

Use undo bandwidth to restore the default.

Syntax

bandwidth bandwidth-value

undo bandwidth

Default

The expected bandwidth (in kbps) is the interface baud rate divided by 1000.

Views

Ethernet interface view

Ethernet subinterface view

Predefined user roles

network-admin

mdc-admin

Parameters

bandwidth-value: Specifies the expected bandwidth in the range of 1 to 400000000 kbps.

Usage guidelines

The expected bandwidth is an informational parameter used only by higher-layer protocols for calculation. You cannot adjust the actual bandwidth of an interface by using this command.

Examples

# Set the expected bandwidth of Ten-GigabitEthernet 3/0/1 to 1000 kbps.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] bandwidth 1000

Related commands

speed

broadcast-suppression

Use broadcast-suppression to enable broadcast suppression and set the broadcast suppression threshold.

Use undo broadcast-suppression to disable broadcast suppression.

Syntax

broadcast-suppression { ratio | pps max-pps | kbps max-kbps }

undo broadcast-suppression

Default

Ethernet interfaces do not suppress broadcast traffic.

Views

Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Parameters

ratio: Sets the broadcast suppression threshold as a percentage of the interface bandwidth. The value range for this argument is 0 to 100. A smaller value means that less broadcast traffic is allowed to pass through.

pps max-pps: Specifies the maximum number of broadcast packets that the interface can forward per second. The value range for the max-pps argument (in pps) is 0 to 1.4881 × the interface bandwidth.

kbps max-kbps: Specifies the maximum number of kilobits of broadcast traffic that the Ethernet interface can forward per second. The value range for this argument (in kbps) is 0 to the interface bandwidth.

Usage guidelines

The broadcast storm suppression features limits the size of broadcast traffic to a threshold on an interface. When the broadcast traffic on the interface exceeds this threshold, the system drops packets until the traffic drops below this threshold.

Both the storm-constrain command and the broadcast-suppression command can suppress broadcast storms on a port. The broadcast-suppression command uses the chip to physically suppress broadcast traffic. It has less influence on the device performance than the storm-constrain command, which uses software to suppress broadcast traffic.

For the traffic suppression result to be determined, do not configure both the storm-constrain broadcast command and the broadcast-suppression command on an interface.

The configured suppression threshold value in pps or kbps will be converted into a multiple of a step supported by the chip. To determine the suppression threshold that takes effect, see the prompts on the device.

After you configure this command, the effective suppression threshold might have a 5% difference from the output of the display interface command.

Examples

# Set the broadcast suppression threshold to 10000 kbps on Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] broadcast-suppression kbps 10000

The actual value is 9984 on port Ten-GigabitEthernet3/0/1 currently.

For the SC and SD modules prefixed with LSCM2, the output shows that the value that takes effect is 9984 kbps.

Related commands

multicast-suppression

unicast-suppression

dampening

Use dampening to enable the device to dampen an interface when the interface is flapping.

Use undo dampening to restore the default.

Syntax

dampening [ half-life reuse suppress max-suppress-time ]

undo dampening

Default

Interface dampening is disabled on Ethernet interfaces.

Views

Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Parameters

half-life: Specifies the amount of time after which a penalty is decreased, in the range of 1 to 120 seconds. The default value is 54 seconds.

reuse: Specifies the reuse threshold in the range of 200 to 20000. The default value is 750. The reuse threshold must be less than the suppression threshold.

suppress: Specifies the suppression threshold in the range of 200 to 20000. The default value is 2000.

max-suppress-time: Specifies the maximum amount of time the interface can be dampened, in the range of 1 to 255 seconds. The default value is 162 seconds (three times the half-life timer).

Usage guidelines

When configuring the dampening command, follow these rules to set the values mentioned above:

·     The ceiling is equal to 2 (Max-suppress-time/Decay) × reuse-limits. It is not user configurable.

·     The configured suppress limit is lower than or equal to the ceiling.

·     The ceiling is lower than or equal to the maximum suppress limit supported.

This command, the link-delay command, and the port link-flap protect enable command are mutually exclusive on an interface.

This command does not take effect on the administratively down events. When you execute the shutdown command, the penalty restores to 0, and the interface reports the down event to the higher layer protocols.

Do not enable the dampening function on an interface with RRPP, MSTP, or Smart Link enabled.

After an interface in down state is dampened, the interface state displayed through the display interface command is always down.

Examples

# Enable interface dampening on Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] dampening

# Enable interface dampening on Ten-GigabitEthernet 3/0/1, and set the following parameters:

·     Half life time to 2 seconds.

·     Reuse value to 800.

·     Suppression threshold to 3000.

·     Maximum suppression interval to 5 seconds.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] dampening 2 800 3000 5

Related commands

display interface

link-delay

port link-flap protect enable

default

Use default to restore the default settings for an interface.

Syntax

default

Views

Ethernet interface view

Ethernet subinterface view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

CAUTION

CAUTION:

The default command might interrupt ongoing network services. Make sure you are fully aware of the impacts of this command when you use it in a live network.

This command might fail to restore the default settings for some commands because of command dependencies or system restrictions. You can use the display this command in interface view to identify these commands, and use their undo forms or follow the command reference to restore their default settings. If your restoration attempt still fails, follow the error message instructions to solve the problem.

Examples

# Restore the default settings for Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] default

description

Use description to configure the description of an interface.

Use undo description to restore the default.

Syntax

description text

undo description

Default

The description of an interface is the interface name plus Interface (for example, Ten-GigabitEthernet3/0/1 Interface).

Views

Ethernet interface view

Ethernet subinterface view

Predefined user roles

network-admin

mdc-admin

Parameters

text: Specifies the interface description, a case-sensitive string of 1 to 255 characters.

Examples

# Set the description of Ten-GigabitEthernet 3/0/1 to lan-interface.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] description lan-interface

# Set the description of Ten-GigabitEthernet 3/0/1.1 to subinterface3/0/1.1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1.1

[Sysname-Ten-GigabitEthernet3/0/1.1] description subinterface3/0/1.1

display counters

Use display counters to display interface traffic statistics.

Syntax

display counters { inbound | outbound } interface [ interface-type [ interface-number ]  ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

inbound: Displays inbound traffic statistics.

outbound: Displays outbound traffic statistics.

interface-type: Specifies an interface type.

interface-number: Specifies an interface number.

Usage guidelines

To clear the Ethernet interface traffic statistics, use the reset counters interface command.

If you do not specify an interface type, this command displays traffic statistics for all interfaces that have traffic counters.

If you specify an interface type but do not specify an interface number, this command displays traffic statistics for all interfaces of the specified type.

If you specify an interface type and number, this command displays traffic statistics for the specified interface.

Examples

# Display inbound traffic statistics for all interfaces.

<Sysname> display counters inbound interface

Interface            Total (pkts)    Broadcast (pkts)    Multicast (pkts)  Err (pkts)

XGE3/0/1                       100                 100                   0           0

XGE3/0/2                  Overflow            Overflow            Overflow    Overflow

 

 Overflow: More than 14 digits (7 digits for column "Err").

       --: Not supported.

Table 1 Command output

Field

Description

Interface

Abbreviated interface name.

Total (pkts)

Total number of packets received or sent through the interface.

Broadcast (pkts)

Total number of broadcast packets received or sent through the interface.

Multicast (pkts)

Total number of multicast packets received or sent through the interface.

Err (pkts)

Total number of error packets received or sent through the interface.

Overflow: More than 14 digits (7 digits for column "Err")

The command displays Overflow when any of the following conditions exist:

·     The data length of an Err field value is greater than 7 decimal digits.

·     The data length of a non-Err field value is greater than 14 decimal digits.

--: Not supported

The statistical item is not supported.

Related commands

reset counters interface

display counters rate

Use display counters rate to display traffic rate statistics for interfaces in up state for the most recent statistics polling interval.

Syntax

display counters rate { inbound | outbound } interface [ interface-type [ interface-number ]  ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

inbound: Displays inbound traffic rate statistics.

outbound: Displays outbound traffic rate statistics.

interface-type: Specifies an interface type.

interface-number: Specifies an interface number.

Usage guidelines

If you do not specify an interface type, this command displays traffic rate statistics for all up interfaces that have traffic counters.

If you specify an interface type but do not specify an interface number, this command displays traffic rate statistics for all up interfaces of the specified type.

If you specify an interface type and an interface, this command displays traffic rate statistics for the specified interface.

If an interface that you specify is always down for the most recent statistics polling interval, the system prompts that the interface does not support the command.

To set the statistics polling interval, use the flow-interval command.

Examples

# Display the inbound traffic rate statistics for all interfaces.

<Sysname> display counters rate inbound interface

Usage: Bandwidth utilization in percentage

Interface            Usage (%)   Total (pps)   Broadcast (pps)   Multicast (pps)

XGE3/0/1                     0             0                --               --

 

 Overflow: More than 14 digits.

       --: Not supported.

Table 2 Command output

Field

Description

Interface

Abbreviated interface name.

Usage (%)

Bandwidth usage (in percentage) of the interface for the last statistics polling interval.

·     In a typical network, the formula for interface bandwidth usage is: local physical interface bandwidth/sum of all selected local interface bandwidths.

·     In an M-LAG network, the formula for interface bandwidth usage is: local physical interface bandwidth/(sum of all selected local interface bandwidths + sum of all selected peer interface bandwidths).

Total (pps)

Average receiving or sending rate (in pps) for unicast packets for the last statistics polling interval.

Broadcast (pps)

Average receiving or sending rate (in pps) for broadcast packets for the last statistics polling interval.

Multicast (pps)

Average receiving or sending rate (in pps) for multicast packets for the last statistics polling interval. .

Overflow: more than 14 decimal digits

The command displays Overflow if the data length of a statistical item is greater than 14 decimal digits.

--: not supported

The statistical item is not supported.

Related commands

flow-interval

reset counters interface

display ethernet statistics

Use display ethernet statistics to display the Ethernet module statistics.

Syntax

In standalone mode:

display ethernet statistics slot slot-number

In IRF mode:

display ethernet statistics chassis chassis-number slot slot-number

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

slot slot-number: Specifies a card by its slot number. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. (In IRF mode.)

Examples

# (In standalone mode.) Display the Ethernet module statistics for the specified slot.

<Sysname> display ethernet statistics slot 1

ETH receive packet statistics:

    Totalnum        : 10447          ETHIINum     : 4459

    SNAPNum         : 0              RAWNum       : 0

    LLCNum          : 0              UnknownNum   : 0

    ForwardNum      : 4459           ARP          : 0

    MPLS            : 0              ISIS         : 0

    ISIS2           : 0              IP           : 0

    IPV6            : 0

ETH receive error statistics:

    NullPoint       : 0              ErrIfindex   : 0

    ErrIfcb         : 0              IfShut       : 0

    ErrAnalyse      : 5988           ErrSrcMAC    : 5988

    ErrHdrLen       : 0

 

ETH send packet statistics:

    L3OutNum        : 211            VLANOutNum   : 0

    FastOutNum      : 155            L2OutNum     : 0

ETH send error statistics:

    MbufRelayNum    : 0              NullMbuf     : 0

    ErrAdjFwd       : 0              ErrPrepend   : 0

    ErrHdrLen       : 0              ErrPad       : 0

    ErrQoSTrs       : 0              ErrVLANTrs   : 0

    ErrEncap        : 0              ErrTagVLAN   : 0

    IfShut          : 0              IfErr        : 0

Table 3 Output description

Field

Description

ETH receive packet statistics

Statistics about the Ethernet packets received by the Ethernet module:

·     Totalnum—Total number of received packets.

·     ETHIINum—Number of packets encapsulated by using Ethernet II.

·     SNAPNum—Number of packets encapsulated by using SNAP.

·     RAWNum—Number of packets encapsulated by using RAW.

·     LLCNum—Number of packets encapsulated by using LLC.

·     UnknownNum—Number of packets encapsulated by using unknown methods.

·     ForwardNum—Number of packets forwarded at Layer 2 or sent to the CPU.

·     ARP—Number of ARP packets.

·     MPLS—Number of MPLS packets. This field is not supported in the current software version.

·     ISIS—Number of IS-IS packets.

·     ISIS2—Number of large 802.3/802.2 frames encapsulated by using IS-IS.

·     IP—Number of IP packets.

·     IPv6—Number of IPv6 packets.

ETH receive error statistics

Statistics about the error Ethernet packets in the inbound direction on the Ethernet module. Errors might be included in packets or occur during the receiving process. The items include:

·     NullPoint—Number of packets that include null pointers.

·     ErrIfindex—Number of packets that include incorrect interface indexes.

·     ErrIfcb—Number of packets that include incorrect interface control blocks.

·     IfShut—Number of packets that are being received when the interface is shut down.

·     ErrAnalyse—Number of packets that include packet parsing errors.

·     ErrSrcMAC—Number of packets that include incorrect source MAC addresses.

·     ErrHdrLen—Number of packets that include header length errors.

ETH send packet statistics

Statistics about the Ethernet packets sent by the Ethernet module:

·     L3OutNum—Number of packets sent out of Layer 3 Ethernet interfaces.

·     VLANOutNum—Number of packets sent out of VLAN interfaces.

·     FastOutNum—Number of packets fast forwarded.

·     L2OutNum—Number of packets sent out of Layer 2 Ethernet interfaces.

ETH send error statistics

Statistics about the error Ethernet packets in the outbound direction on the Ethernet module:

·     MbufRelayNum—Number of packets transparently sent.

·     NullMbuf—Number of packets with null pointers.

·     ErrAdjFwd—Number of packets with adjacency table errors.

·     ErrPrepend—Number of packets with extension errors.

·     ErrHdrLen—Number of packets with header length errors.

·     ErrPad—Number of packets with padding errors.

·     ErrQoSTrs—Number of packets that failed to be sent by QoS.

·     ErrVLANTrs—Number of packets that failed to be sent in VLANs.

·     ErrEncap—Number of packets that failed to be sent due to link header encapsulation failures.

·     ErrTagVLAN—Number of packets that failed to be sent due to VLAN tag encapsulation failures.

·     IfShut—Number of packets that are being sent when the interface is shut down.

·     IfErr—Number of packets with incorrect outgoing interfaces.

Related commands

reset ethernet statistics

display interface

Use display interface to display interface information.

Syntax

display interface [ interface-type [ interface-number | interface-number.subnumber ] ] [ brief [ description | down ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

interface-type: Specifies an interface type.

interface-number: Specifies an interface number.

interface-number.subnumber: Specifies a subinterface number. The interface-number argument is an interface number. The subnumber argument is the number of a subinterface created under the interface. The value range for the subnumber argument is 1 to 4094.

brief: Displays brief interface information. If you do not specify this keyword, the command displays detailed interface information.

description: Displays complete interface descriptions. If you do not specify this keyword, the command displays only the first 25 characters of each interface description.

down: Displays information about interfaces in down state and the causes. If you do not specify this keyword, the command displays information about interfaces in all states.

Usage guidelines

If you do not specify an interface type, this command displays information about all interfaces.

If you specify an interface type but do not specify an interface number, this command displays information about all interfaces of the specified type.

Examples

# Display information about Layer 3 interface Ten-GigabitEthernet 3/0/1.

<Sysname> display interface ten-gigabitethernet 3/0/1

Ten-GigabitEthernet3/0/1

Current state: Administratively DOWN

Line protocol state: DOWN

Description: Ten-GigabitEthernet3/0/1 Interface

Bandwidth: 1000000 kbps

Maximum transmission unit: 1500

Allow jumbo frames to pass

Broadcast max-ratio: 100%

Multicast max-ratio: 100%

Unicast max-ratio: 100%

Known unicast max-ratio: 100%

Internet protocol processing: Disabled

IP packet frame type: Ethernet II, hardware address: 3822-d666-bd0c

IPv6 packet frame type: Ethernet II, hardware address: 3822-d666-bd0c

Loopback is not set

Media type is twisted pair, port hardware type is 1000_BASE_T

Port priority: 2

Unknown-speed mode, unknown-duplex mode

Link speed type is autonegotiation, link duplex type is autonegotiation

Flow-control is not enabled

Maximum frame length: 9216

Last link flapping: 6 hours 39 minutes 28 seconds

Last clearing of counters: Never

Current system time:2020-08-10 14:56:12

Last time when physical state changed to up:-

Last time when physical state changed to down:2020-08-10 14:55:25

Traffic statistic: Not include Inter-frame Gaps and Preambles

 Peak input rate: 0 bytes/sec, at 2020-07-07 16:07:11

 Peak output rate: 0 bytes/sec, at 2020-07-07 16:07:11

 Last 300 seconds input:  0 packets/sec 0 bytes/sec  0%

 Last 300 seconds output: 0 packets/sec 0 bytes/sec  0%

 Input  (total): 0 packets, 0 bytes

          0 unicasts, 0 broadcasts, 0 multicasts, - pauses

 Input  (normal): 0 packets, 0 bytes

          0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

 Input: 0 input errors, 0 runts, 0 giants, 0 throttles

          0 CRC, 0 frame, 0 overruns, - aborts

          - ignored, - parity errors

 Output  (total): 0 packets, 0 bytes

          0 unicasts, 0 broadcasts, 0 multicasts, - pauses

 Output  (normal): 0 packets, 0 bytes

          0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

 Output: 0 output errors, - underruns, - buffer failures

          0 aborts, 0 deferred, 0 collisions, 0 late collisions

          - lost carrier, - no carrier

IPv4 traffic statistics:

 Last 300 seconds input rate: 0 packets/sec, 0 bytes/sec

 Last 300 seconds output rate: 0 packets/sec, 0 bytes/sec

 Input: 0 packets, 0 bytes

 Output: 0 packets, 0 bytes

IPv6 traffic statistics:

 Last 300 seconds input rate: 0 packets/sec, 0 bytes/sec

 Last 300 seconds output rate: 0 packets/sec, 0 bytes/sec

 Input: 0 packets, 0 bytes

 Output: 0 packets, 0 bytes

# Display detailed information about Layer 2 interface Ten-GigabitEthernet 3/0/1.

<Sysname> display interface ten-gigabitethernet 3/0/1

Ten-GigabitEthernet3/0/1

Current state: DOWN

Line protocol state: DOWN

IP packet frame type: Ethernet II, hardware address: 000c-2963-b767

Description: Ten-GigabitEthernet3/0/1 Interface

Bandwidth: 100000 kbps

Loopback is not set

Media type is twisted pair, port hardware type is 1000_BASE_T_AN_SFP

Unknown-speed mode, unknown-duplex mode

Link speed type is autonegotiation, link duplex type is autonegotiation

Flow-control is not enabled

Maximum frame length: 9216

Allow jumbo frame to pass

Broadcast max-ratio: 100%

Multicast max-ratio: 100%

Unicast max-ratio: 100%

Known unicast max-ratio: 100%

PVID: 1

MDI type: Automdix

Port link-type: Access

 Tagged VLANs:   None

 UnTagged VLANs: 1

Port priority: 2

Last link flapping: 6 hours 39 minutes 25 seconds

Last clearing of counters:  14:34:09 Tue 11/01/2020

Current system time:2020-08-10 14:58:27

Last time when physical state changed to up:-

Last time when physical state changed to down:2020-08-10 14:57:58

Traffic statistic: Not include Inter-frame Gaps and Preambles

 Peak input rate: 0 bytes/sec, at 2020-07-17 22:06:19

 Peak output rate: 0 bytes/sec, at 2020-07-17 22:06:19

 Last 300 seconds input:  0 packets/sec 0 bytes/sec -%

 Last 300 seconds output:  0 packets/sec 0 bytes/sec -%

 Input (total):  0 packets, 0 bytes

          0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

 Input (normal):  0 packets, 0 bytes

          0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

 Input:  0 input errors, 0 runts, 0 giants, 0 throttles

          0 CRC, 0 frame, 0 overruns, 0 aborts

          0 ignored, 0 parity errors

 Output (total): 0 packets, 0 bytes

          0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

 Output (normal): 0 packets, 0 bytes

          0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

 Output: 0 output errors, 0 underruns, 0 buffer failures

          0 aborts, 0 deferred, 0 collisions, 0 late collisions

          0 lost carrier, 0 no carrier

Table 4 Command output

Field

Description

Current state

Physical link state of the interface:

·     Administratively DOWN—The interface has been shut down by using the shutdown command.

·     Administratively DOWN(Global)—The interface has been shut down by using the shutdown all-physical-interfaces command in system view.

·     DOWN—The interface is administratively up, but its physical state is down (possibly because no physical link exists or the link has failed).

·     DOWN ( Link-Aggregation interface down )—The aggregate interface to which the interface belongs has been shut down by using the shutdown command.

·     DOWN (Monitor-Link uplink down )—The interface has been shut down by Monitor Link.

·     IRF-link-down—The interface has been shut down by IRF. This state occurs when the IRF member device that contains the interface is detected to have lost the connectivity of all its IRF links in the MDC.

·     mac-address moving down—The interface has been shut down by the MAC address move suppression feature.

·     MAD ShutDown—The interface has been shut down by IRF MAD. This state occurs if the interface is on an IRF fabric placed in Recovery state after an IRF split.

·     OFP DOWN—The interface has been shut down by OpenFlow.

·     Storm-Constrain—The interface has been shut down because the storm control feature detected that multicast traffic or broadcast traffic exceeded the upper threshold.

·     STP DOWN—The interface has been shut down by the BPDU guard feature.

·     M-LAG MAD Shutdown—The interface was set to the M-LAG MAD DOWN state when the M-LAG system split.

·     UP—The interface is both administratively and physically up.

Line protocol state

Data link layer state of the interface. The state is determined through automatic parameter negotiation at the data link layer.

·     UP—The data link layer protocol is up.

·     UP (spoofing)—The data link layer protocol is up, but the link is an on-demand link or does not exist. This attribute is typical of null interfaces and loopback interfaces.

·     DOWN—The data link layer protocol is down.

·     DOWN (protocols)—The data link layer has been shut down by protocols included in the parentheses. Available protocols include:

¡     DLDP—Shuts down the data link layer when it detects that the link is unidirectional.

¡     OAM—Shuts down the data link layer when it detects a remote link failure.

¡     LAGG—Shuts down the data link layer when it detects that the aggregate interface does not have Selected ports.

¡     BFD—Shuts down the data link layer when it detects a link failure.

Bandwidth

Expected bandwidth of the interface.

Maximum transmission unit

MTU of the interface.

Internet protocol processing: Disabled

The interface is not assigned an IP address and cannot process IP packets.

Internet address

IP address of the interface. The primary attribute indicates that the address is the primary IP address.

Internet address: ip-address/mask-length (Type)

IP address of the interface and type of the address in parentheses.

Possible IP address types include:

·     Primary—Manually configured primary IP address.

·     Sub—Manually configured secondary IP address. If the interface has both primary and secondary IP addresses, the primary IP address is displayed. If the interface has only secondary IP addresses, the lowest secondary IP address is displayed.

·     DHCP-allocated—DHCP allocated IP address. For more information, see DHCP client configuration in Layer 3IP Services Configuration Guide.

·     BOOTP-allocatedBOOTP allocated IP address. For more information, see BOOTP client configuration in Layer 3IP Services Configuration Guide.

·     Unnumbered—IP address borrowed from another interface.

·     MAD—IP address assigned to an IRF member device for MAD on the interface. For more information, see IRF configuration in Virtual Technologies Configuration Guide.

IP packet frame type

IPv4 packet framing format.

hardware address

MAC address of the interface.

IPv6 packet frame type

IPv6 packet framing format.

Port priority

Port priority of the interface.

Loopback is set internal

An internal loopback test is running on the interface. This field depends on your configuration.

Loopback is set external

An external loopback test is running on the interface. This field depends on your configuration.

Loopback is not set

No loopback test is running on the interface. This field depends on your configuration.

10Mbps-speed mode

The interface is operating at 10 Mbps. This field depends on your configuration and the link parameter negotiation result.

100Mbps-speed mode

The interface is operating at 100 Mbps. This field depends on your configuration and the link parameter negotiation result.

1000Mbps-speed mode

The interface is operating at 1000 Mbps. This field depends on your configuration and the link parameter negotiation result.

10Gbps-speed mode

The interface is operating at 10 Gbps. This field depends on your configuration and the link parameter negotiation result.

40Gbps-speed mode

The interface is operating at 40 Gbps. This field depends on your configuration and the link parameter negotiation result.

100Gbps-speed mode

The interface is operating at 100 Gbps. This field depends on your configuration and the link parameter negotiation result.

Unknown-speed mode

The speed of the interface is unknown because the speed negotiation fails or the interface is physically disconnected.

half-duplex mode

The interface is operating in half duplex mode. This field depends on your configuration and the link parameter negotiation result.

full-duplex mode

The interface is operating in full duplex mode. This field depends on your configuration and the link parameter negotiation result.

unknown-duplex mode

The duplex mode of the interface is unknown because the duplex mode negotiation fails or the interface is physically disconnected.

Link speed type is autonegotiation

The interface is configured with the speed auto command.

Link speed type is force link

The interface is manually configured with a speed (for example, 1000 Mbps) by using the speed command.

link duplex type is autonegotiation

The interface is configured with the duplex auto command.

link duplex type is force link

The interface is manually configured with a duplex mode (for example, half or full) by using the duplex command.

Flow-control is not enabled

Generic flow control is disabled on the interface. This field depends on your configuration and the link parameter negotiation result.

Maximum frame length

Maximum length of Ethernet frames allowed to pass through the interface.

Allow jumbo frame to pass

The interface allows jumbo frames to pass through.

Broadcast max-

‌Broadcast storm suppression threshold.  

Multicast max-

‌Multicast storm suppression threshold.

Unicast max-

‌Unknown unicast storm suppression threshold.

Known-unicast max-

‌Known unicast storm suppression threshold.  

PVID

Port VLAN ID (PVID) of the interface.

MDI type

MDIX mode of the interface:

·     automdix.

·     mdi.

·     mdix.

Dampening enabled

Damping is enabled on the interface.

Penalty

Penalty value.

Ceiling

The penalty stops increasing when it reaches the ceiling.

Reuse

Reuse threshold.

Suppress

Suppression threshold.

Half-life

Amount of time after which a penalty is decreased, in seconds.

Max-suppress-time

Maximum amount of time the interface can be dampened, in seconds.

Flap count

Number of flaps (up/down events) on the interface.

Port link-type

Link type of the interface:

·     access.

·     trunk.

·     hybrid.

Tagged VLANs

VLANs for which the interface sends packets without removing VLAN tags.

Untagged VLANs

VLANs for which the interface sends packets after removing VLAN tags.

VLAN Passing

VLANs whose packets can be forwarded by the port. The VLANs must have been created.

VLAN permitted

VLANs whose packets are permitted by the port.

Trunk port encapsulation

Encapsulation protocol type for the trunk port.

Last link flapping

The amount of time that has elapsed since the most recent physical state change of the interface. This field displays Never if the interface has been physically down since device startup.

Last clearing of counters

Time when the reset counters interface command was last used to clear the interface statistics. This field displays Never if the reset counters interface command has never been used on the interface since device startup.

Last hardware down reason

Reasons for the last hardware shutdown:

·     PHY line side is down.

·     PHY system side is down.

·     No optical signal has been received at the optical port.

Current system time

Current system time in the YYYY/MM/DD HH:MM:SS format. If the time zone is configured, this field is in the YYYY/MM/DD HH:MM:SS zone-name±HH:MM:SS format, where the zone-name argument is the local time zone.

Last time when physical state changed to up

Last time when the physical state of the interface changed to up.

If the time zone is configured, this field is in the YYYY/MM/DD HH:MM:SS zone-name±HH:MM:SS format, where the zone-name argument is the local time zone.

A hyphen (-) indicates that the physical state of the interface has never changed.

Last time when physical state changed to down

Last time when the physical state of the interface changed to down.

If the time zone is configured, this field is in the YYYY/MM/DD HH:MM:SS zone-name±HH:MM:SS format, where the zone-name argument is the local time zone.

A hyphen (-) indicates that the physical state of the interface has never changed.

Last interval seconds input:  0 packets/sec 0 bytes/sec 0%

Last interval seconds output:  0 packets/sec 0 bytes/sec 0%

Average inbound or outbound traffic rate (in pps and Bps) in the last statistics polling interval, and the ratio of the actual rate to the interface bandwidth. To set the statistics polling interval (interval), use the flow-interval command.

A hyphen (-) indicates that the statistical item is not supported.

Traffic statistic

Whether to include interframe gap and preamble statistics in the traffic statistics:

·     Include Inter-frame Gaps and Preambles

·     Not include Inter-frame Gaps and Preambles

Input(total):  0 packets, 0 bytes

          0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

The two fields on the first line represent the inbound traffic statistics (in packets and bytes) for the interface. All inbound normal packets, abnormal packets, and normal pause frames were counted.

The four fields on the second line represent:

·     Number of inbound unicast packets.

·     Number of inbound broadcasts.

·     Number of inbound multicasts.

·     Number of inbound pause frames.

Layer 3 Ethernet interfaces do not support collecting statistics of Layer 3 multicast packets in the current software version.

Input(normal):  0 packets, 0 bytes

          0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

The two fields on the first line represent the inbound normal traffic and pause frame statistics (in packets and bytes) for the interface.

The four fields on the second line represent:

·     Number of inbound normal unicast packets.

·     Number of inbound normal broadcasts.

·     Number of inbound normal multicasts.

·     Number of inbound normal pause frames.

Layer 3 Ethernet interfaces do not support collecting statistics of Layer 3 multicast packets in the current software version.

input errors

Statistics of incoming error packets.

runts

Number of inbound frames meeting the following conditions:

·     Shorter than 64 bytes.

·     In correct format.

·     Containing valid CRCs.

giants

Number of inbound giants. Giants refer to frames larger than the maximum frame length supported on the interface.

For an Ethernet interface that does not permit jumbo frames, the maximum frame length is as follows:

·     1518 bytes (without VLAN tags).

·     1522 bytes (with VLAN tags).

For an Ethernet interface that permits jumbo frames, the maximum Ethernet frame length is set when you configure jumbo frame support on the interface.

throttles

Number of inbound frames that had a non-integer number of bytes.

CRC

Total number of inbound frames that had a normal length, but contained CRC errors.

frame

Total number of inbound frames that contained CRC errors and a non-integer number of bytes.

overruns

Number of packets dropped because the input rate of the port exceeded the queuing capability.

aborts

Total number of illegal inbound packets:

·     Fragment frames—CRC error frames shorter than 64 bytes. The length (in bytes) can be an integral or non-integral value.

·     Jabber frames—CRC error frames greater than the maximum frame length supported on the Ethernet interface (with an integral or non-integral length).

¡     For an Ethernet interface that does not permit jumbo frames, the maximum frame length is 1518 bytes (without VLAN tags) or 1522 bytes (with VLAN tags).

¡     For an Ethernet interface that permits jumbo frames, the maximum Ethernet frame length is set when you configure jumbo frame support on the interface.

·     Symbol error frames—Frames that contained a minimum of one undefined symbol.

·     Unknown operation code frames—Non-pause MAC control frames.

·     Length error frames—Frames whose 802.3 length fields did not match the actual frame length (46 to 1500 bytes).

ignored

Number of inbound frames dropped because the receiving buffer of the port ran low.

parity errors

Total number of frames with parity errors.

Output(total): 0 packets, 0 bytes

          0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

The two fields on the first line represent the outbound traffic statistics (in packets and bytes) for the interface. All outbound normal packets, abnormal packets, and normal pause frames were counted.

The four fields on the second line represent:

·     Number of outbound unicast packets.

·     Number of outbound broadcasts.

·     Number of outbound multicasts.

·     Number of outbound pause frames.

Layer 3 Ethernet interfaces do not support collecting statistics of Layer 3 multicast packets in the current software version.

Output(normal): 0 packets, 0 bytes

          0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

The two fields on the first line represent the outbound normal traffic and pause frame statistics (in packets and bytes) for the interface.

The four fields on the second line represent:

·     Number of outbound normal unicast packets.

·     Number of outbound normal broadcasts.

·     Number of outbound normal multicasts.

·     Number of outbound normal pause frames.

Layer 3 Ethernet interfaces do not support collecting statistics of Layer 3 multicast packets in the current software version.

output errors

Number of outbound packets with errors.

underruns

Number of packets dropped because the output rate of the interface exceeded the output queuing capability. This is a low-probability hardware anomaly.

buffer failures

Number of packets dropped because the transmitting buffer of the interface ran low.

aborts

Number of packets that failed to be transmitted, for example, because of Ethernet collisions.

deferred

Number of frames that the interface deferred to transmit because of detected collisions.

collisions

Number of frames that the interface stopped transmitting because Ethernet collisions were detected during transmission.

late collisions

Number of frames that the interface deferred to transmit after transmitting their first 512 bits because of detected collisions.

lost carrier

Number of carrier losses during transmission. This counter increases by one when a carrier is lost, and applies to serial WAN interfaces.

no carrier

Number of times that the port failed to detect the carrier when attempting to send frames. This counter increases by one when a port failed to detect the carrier, and applies to serial WAN interfaces.

Peak input rate

Peak rate of inbound traffic in Bps, and the time when the peak inbound traffic rate occurred.

Peak output rate

Peak rate of outbound traffic in Bps, and the time when the peak outbound traffic rate occurred.

IPv4 traffic statistics

IPv4 packet statistics.

IPv6 traffic statistics

IPv6 packet statistics.

# Display brief information about all interfaces.

<Sysname> display interface brief

Brief information on interfaces in route mode:

Link: ADM - administratively down; Stby - standby

Protocol: (s) – spoofing

 

Interface            Link Protocol Primary IP        Description

XGE3/0/1              DOWN DOWN     --

Loop0                UP   UP(s)    2.2.2.9

NULL0                UP   UP(s)    --

Vlan1                UP   UP       --

Vlan999              UP   UP       192.168.1.42

 

Brief information on interfaces in bridge mode:

Link: ADM - administratively down; Stby - standby

Speed: (a) - auto

Duplex: (a)/A - auto; H - half; F - full

Type: A - access; T - trunk; H - hybrid

Interface            Link Speed     Duplex Type PVID Description

XGE3/0/2              DOWN auto      A      A    1

XGE3/0/3              UP   1G(a)     F(a)   A    1    aaaaaaaaaaaaaaaaaaaaaaaaa

# Display brief information about Ten-GigabitEthernet 3/0/3, including the complete description of the interface.

<Sysname> display interface ten-gigabitethernet 3/0/3 brief description

Brief information on interfaces in bridge mode:

Link: ADM - administratively down; Stby - standby

Speed: (a) - auto

Duplex: (a)/A - auto; H - half; F - full

Type: A - access; T - trunk; H - hybrid

Interface            Link Speed     Duplex Type PVID Description

XGE3/0/3             UP   1G(a)     F(a)   A    1    aaaaaaaaaaaaaaaaaaaaaaaaaaa

aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa

# Display information about interfaces in DOWN state and the causes.

<Sysname> display interface brief down

Brief information on interfaces in route mode:

Link: ADM - administratively down; Stby - standby

Interface            Link Cause

XGE3/0/1             DOWN Not connected

Vlan2                DOWN Not connected

 

Brief information on interfaces in bridge mode:

Link: ADM - administratively down; Stby - standby

Interface            Link Cause

XGE3/0/2              DOWN Not connected

Table 5 Command output

Field

Description

Brief information on interfaces in route mode:

Brief information about Layer 3 interfaces.

Interface

Interface name.

Link

Physical link state of the interface:

·     UP—The interface is physically up.

·     DOWN—The interface is physically down.

·     ADM—The interface has been shut down by using the shutdown command. To restore the physical state of the interface, use the undo shutdown command.

·     Stby—The interface is a backup interface in standby state.

Protocol

Data link layer protocol state of the interface:

·     UP—The data link layer protocol of the interface is up.

·     DOWN—The data link layer protocol of the interface is down.

·     UP(s)—The data link layer protocol of the interface is up, but the link is an on-demand link or does not exist. The (s) attribute represents the spoofing flag. This value is typical of null interfaces and loopback interfaces.

Primary IP

Primary IP address of the interface. This field displays two hyphens (--) if the interface does not have an IP address.

Description

Description of the interface.

Brief information of interfaces in bridge mode:

Brief information about Layer 2 interfaces.

Type: A - access; T - trunk; H – hybrid

Link type options for interfaces.

Speed

Speed of the interface, in bps.

This field displays the (a) flag next to the speed if the speed is automatically negotiated.

This field displays auto if the interface is configured to autonegotiate its speed but the autonegotiation has not started.

Duplex

Duplex mode of the interface:

·     A—Autonegotiation. The interface is configured to autonegotiate its duplex mode but the autonegotiation has not started.

·     F—Full duplex.

·     F(a)—Autonegotiated full duplex.

·     H—Half duplex.

·     H(a)—Autonegotiated half duplex.

Type

Link type of the interface:

·     A—Access.

·     H—Hybrid.

·     T—Trunk.

PVID

Port VLAN ID.

Cause

Cause for the physical link state of an interface to be DOWN:

·     Administratively—The interface has been manually shut down by using the shutdown command. To restore the physical state of the interface, use the undo shutdown command.

·     DOWN ( Link-Aggregation interface down )—The interface is a member port of an aggregate interface, and the aggregate interface is down.

·     DOWN (Loopback detection down)—The loopback detection module has detected loops.

·     DOWN ( Monitor-Link uplink down )—The monitor link module has detected that the uplink is down.

·     IRF-link-down—The IRF member device that contains the interface has lost the connectivity of all its IRF links in the MDC.

·     MAD ShutDown—The interface is on an IRF fabric placed by IRF MAD in Recovery state after an IRF split.

·     Not connected—No physical connection exists (possibly because the network cable is disconnected or faulty).

·     Storm-Constrain—The storm control feature has detected that multicast traffic or broadcast traffic exceeded the upper threshold.

·     STP DOWN—The interface has been shut down by the BPDU guard feature.

·     Port Security Disabled—The interface has been shut down by the intrusion detection mechanism because the interface received illegal packets.

·     OFP DOWN—The interface has been shut down by OpenFlow.

Related commands

flow-interval

reset counters interface

display interface link-info

Use display interface link-info to display the status and packet statistics of interfaces.

Syntax

display interface link-info [ main ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

main: Specifies all interfaces except subinterfaces. If you do not specify this keyword, this command displays status and packet statistics of all interfaces.

Examples

# Display status and statistics of all interfaces.

<Sysname> display interface link-info

Link: ADM - administratively down; Stby - standby

Protocol: (s) - spoofing

Interface        Link Protocol  InUsage OutUsage         InErrs        OutErrs

XGE3/0/1          UP   UP            10%       0%              0              0

NULL0            UP   UP(s)          0%       0%              0              0

 

 Overflow: More than 7 digits.

       --: Not supported.

Table 6 Command output

Field

Description

Link: ADM - administratively down; Stby - standby

Physical link state of the interface:

·     ADM—The interface has been shut down by using the shutdown command. To restore the physical state of the interface, use the undo shutdown command.

·     Stby—The interface is a backup interface in standby state. To see the primary interface, use the display interface-backup state command.

Protocol: (s) – spoofing

The data link layer protocol of the interface is up, but the link is an on-demand link or does not exist. The (s) attribute represents the spoofing flag. This value is typical of null interfaces, loopback interfaces, and InLoopback interfaces.

Interface

Abbreviated interface name.

Link

Physical link state of the interface:

·     UP—The interface is physically up.

·     DOWN—The interface is physically down.

·     ADM—The interface has been shut down by using the shutdown command. To restore the physical state of the interface, use the undo shutdown command.

·     Stby—The interface is a backup interface in standby state.

Protocol

Data link layer protocol state of the interface:

·     UP—The data link layer protocol of the interface is up.

·     DOWN—The data link layer protocol of the interface is down.

·     UP(s)—The data link layer protocol of the interface is up, but the link is an on-demand link or does not exist. The (s) attribute represents the spoofing flag. This value is typical of null interfaces, loopback interfaces, and InLoopback interfaces.

InUsage

Inbound bandwidth usage within the most recent statistics polling interval. It is calculated by this formula: Average inbound speed of the interface within the most recent statistics polling interval/interface bandwidth. To set the statistics polling interval, use the flow-interval command.

OutUsage

Outbound bandwidth usage within the most recent statistics polling interval. It is calculated by this formula: Average outbound speed of the interface within the most recent statistics polling interval/interface bandwidth. To set the statistics polling interval, use the flow-interval command.

InErrs

Number of error packets received.

OutErrs

Number of error packets sent.

Overflow: More than 7 digits.

The data length of a statistical item value is greater than 7 decimal digits.

--: Not supported.

A hyphen (-) indicates that the corresponding statistical item is not supported.

 

Related commands

flow-interval

display interface main

Use display interface main to display operating status and information of all interfaces except subinterfaces.

Syntax

display interface [ interface-type ] [ brief [ description | down ] ] main

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

interface-type: Specifies an interface type. If you do not specify this argument, the command displays information about interfaces of all types.

brief: Displays brief interface information. If you do not specify this keyword, the command displays detailed interface information.

description: Displays complete interface descriptions. If you do not specify this keyword, the command displays only the first 25 characters of each interface description.

down: Displays information about interfaces in down state and the causes. If you do not specify this keyword, the command displays information about interfaces in all states.

Examples

# Display operating status and information of all interfaces except subinterfaces.

<Sysname> display interface main

Ten-GigabitEthernet3/0/1

Current state: Administratively DOWN

Line protocol state: DOWN

IP packet frame type: Ethernet II, hardware address: 4005-6538-0100

Description: Ten-GigabitEthernet3/0/1 Interface

Bandwidth: 1000000 kbps

Loopback is not set

Unknown-speed mode, unknown-duplex mode

Link speed type is autonegotiation, link duplex type is autonegotiation

Flow-control is not enabled

Maximum frame length: 9216

Allow jumbo frames to pass

Broadcast max-ratio: 100%

Multicast max-ratio: 100%

Unicast max-ratio: 100%

PVID: 1

MDI type: Automdix

Port link-type: Access

 Tagged VLANs:   None

 Untagged VLANs: 1

Port priority: 2

Last link flapping: Never

Last clearing of counters: Never

Current system time:2018-04-11 10:20:24

Last time when physical state changed to up:-

Last time when physical state changed to down:2018-04-11 09:11:09

 Peak input rate: 0 bytes/sec, at 00-00-00 00:00:00

 Peak output rate: 0 bytes/sec, at 00-00-00 00:00:00

 Last 300 seconds input: 0 packets/sec 0 bytes/sec -%

 Last 300 seconds output: 0 packets/sec 0 bytes/sec -%

 Input (total):  0 packets, 0 bytes

         0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

 Input (normal):  0 packets, 0 bytes

         0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

 Input:  0 input errors, 0 runts, 0 giants, 0 throttles

         0 CRC, 0 frame, 0 overruns, 0 aborts

         0 ignored, 0 parity errors

 Output (total): 0 packets, 0 bytes

         0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

 Output (normal): 0 packets, 0 bytes

         0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

 Output: 0 output errors, 0 underruns, 0 buffer failures

         0 aborts, 0 deferred, 0 collisions, 0 late collisions

         0 lost carrier, 0 no carrier

 

Ten-GigabitEthernet3/0/2

Current state: Administratively DOWN

Line protocol state: DOWN

Description: Ten-GigabitEthernet3/0/2 Interface

Bandwidth: 1000000 kbps

Flow-control is not enabled

Maximum transmission unit: 1500

Allow jumbo frames to pass

Broadcast max-ratio: 100%

Multicast max-ratio: 100%

Unicast max-ratio: 100%

Internet protocol processing: Disabled

IP packet frame type: Ethernet II, hardware address: 4005-6538-0107

IPv6 packet frame type: Ethernet II, hardware address: 4005-6538-0107

Output queue - Urgent queuing: Size/Length/Discards 0/100/0

Output queue - Protocol queuing: Size/Length/Discards 0/500/0

Output queue - FIFO queuing: Size/Length/Discards 0/75/0

Last link flapping: Never

Last clearing of counters: Never

Current system time:2018-04-11 10:20:24

Last time when physical state changed to up:-

Last time when physical state changed to down:2018-04-11 09:33:52

 Peak input rate: 0 bytes/sec, at 00-00-00 00:00:00

 Peak output rate: 0 bytes/sec, at 00-00-00 00:00:00

 Last 300 seconds input: 0 packets/sec 0 bytes/sec -%

 Last 300 seconds output: 0 packets/sec 0 bytes/sec -%

 Input (total):  0 packets, 0 bytes

         0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

 Input (normal):  0 packets, 0 bytes

         0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

 Input:  0 input errors, 0 runts, 0 giants, 0 throttles

         0 CRC, 0 frame, 0 overruns, 0 aborts

         0 ignored, 0 parity errors

 Output (total): 0 packets, 0 bytes

         0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

 Output (normal): 0 packets, 0 bytes

         0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

 Output: 0 output errors, 0 underruns, 0 buffer failures

         0 aborts, 0 deferred, 0 collisions, 0 late collisions

         0 lost carrier, 0 no carrier

# Display brief information for all interfaces except subinterfaces.

<Sysname> display interface brief main

Brief information on interfaces in route mode:

Link: ADM - administratively down; Stby - standby

Protocol: (s) – spoofing

 

Interface            Link Protocol Primary IP        Description

XGE3/0/1              DOWN DOWN     --

Loop0                UP   UP(s)    2.2.2.9

NULL0                UP   UP(s)    --

Vlan1                UP   DOWN     --

Vlan999              UP   UP       192.168.1.42

 

Brief information on interfaces in bridge mode:

Link: ADM - administratively down; Stby - standby

Speed: (a) - auto

Duplex: (a)/A - auto; H - half; F - full

Type: A - access; T - trunk; H - hybrid

Interface            Link Speed   Duplex Type PVID Description

XGE3/0/2             DOWN auto    A      A    1

# Display brief information about all interfaces except subinterfaces, including the complete interface descriptions.

<Sysname> display interface  brief description main

Brief information on interfaces in bridge mode:

Link: ADM - administratively down; Stby - standby

Speed: (a) - auto

Duplex: (a)/A - auto; H - half; F - full

Type: A - access; T - trunk; H - hybrid

Interface            Link Speed   Duplex Type PVID Description

XGE3/0/3              UP   auto    F(a)   A    1    aaaaaaaaaaaaaaaaaaaaaaaaaaaaa

aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa

# Display information about interfaces except subinterfaces in DOWN state and the causes.

<Sysname> display interface brief down main

Brief information on interfaces in route mode:

Link: ADM - administratively down; Stby - standby

Interface            Link Cause

XGE3/0/1              DOWN Not connected

Vlan2                DOWN Not connected

 

Brief information on interfaces in bridge mode:

Link: ADM - administratively down; Stby - standby

Interface            Link Cause

XGE3/0/2              DOWN Not connected

For description on the display interface main command output, see the display interface command.

display link-flap protection

Use display link-flap protection to display information about link flapping protection on an interface.

Syntax

display link-flap protection [ interface interface-type [ interface-number ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

interface-type: Specifies an interface type. If you do not specify an interface type, the command displays information about link flapping protection on all interfaces.

interface-number: Specifies an interface number. If you do not specify an interface number, the command displays information about link flapping protection on all interfaces of the specified type.

Examples

# Display information about link flapping protection on all interfaces.

<Sysname> display link-flap protection

Link-flap protection: Enabled

Interface            Link-flap  Status      Interval(L1/L2)     Threshold(L1/L2)

XGE3/0/1             Enabled    Down                   10/5                5/60

XGE3/0/2             Disabled   N/A                   --/--               --/--

Table 7 Command output

Field

Description

Link-flap protection

Status of global link flapping protection:

·     Enabled—Link flapping protection is enabled globally.

·     Disabled—Link flapping protection is disabled globally.

Link-flap

Status of link flapping protection on an interface:

·     Enabled—Link flapping protection is enabled on an interface.

·     Disabled—Link flapping protection is disabled on an interface.

Status

Status of an interface:

·     Down—The interface has been shut down by the link flapping protection feature.

·     N/A—The interface status is not affected by the link flapping protection feature.

Interval(L1/L2)

Level-1/Level-2 link flapping detection interval for an interface.

Threshold(L1/L2)

Level-1/Level-2 link flapping detection threshold for an interface.

Related commands

link-flap protect enable

port link-flap protect enable

display link-state-change statistics interface

Use display link-state-change statistics interface to display the physical link state change statistics of interfaces.

Syntax

display link-state-change statistics interface [ interface-type [ interface-number  ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

interface-type: Specifies an interface type.

interface-number: Specifies an interface number.

Usage guidelines

If you do not specify an interface type, this command displays the link state change statistics for all interfaces.

If you specify an interface type but do not specify an interface number, this command displays the link state change statistics for all interfaces of the specified type.

Examples

# Display the link state change statistics of all interfaces.

<Sysname> display link-state-change statistics interface

Interface              Change-times  Last-change-time     Reset link-state time

                                     Link-flap-begin      Link-flap-end

XGE3/0/1               0             Never                Never

                                     Never                Never

Table 8 Command output

Field

Description

Interface

Abbreviated interface name.

Change-times

Number of physical state changes.

Last-change-time

Last time when the physical state changed.

Reset link-state time

Time when the physical link state change statistics were cleared.

Link-flap-begin

Last time when a physical link state flapping began. If no link state flapping has occurred, this field displays Never.

Link-flap-end

Last time when a physical link state flapping ended. If no link state flapping has occurred, this field displays Never.

 

Related commands

reset link-state-change statistics interface

display packet-drop

Use display packet-drop to display information about packets dropped on an interface.

Syntax

In standalone mode:

display packet-drop { interface [ interface-type [ interface-number ] ] | slot [ slot-number ] | summary }

In IRF mode:

display packet-drop { interface [ interface-type [ interface-number ] ] | chassis [ chassis-number [ slot slot-number ] ] | summary }

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

interface-type: Specifies an interface type.

interface-number: Specifies an interface number.

summary: Displays the summary of dropped packets on only interfaces that support this command.

slot [ slot-number ]: Specifies a card by its slot number. If you do not specify a card, this command displays information about dropped packets on all the cards. (In standalone mode.)

chassis [ chassis-number [ slot slot-number ] ]: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a member device, this command applies to all cards of all member devices. If you do not specify a card, this command applies to all the member devices. (In IRF mode.)

Usage guidelines

If you do not specify an interface type, this command displays information about dropped packets on only interfaces that support this command on the device.

If you specify an interface type but do not specify an interface number, this command displays information about dropped packets on only interfaces of the specified type that support this command.

Examples

# Display information about dropped packets on Ten-GigabitEthernet 3/0/1.

<Sysname> display packet-drop interface ten-gigabitethernet 3/0/1

Ten-GigabitEthernet3/0/1:

  Packets dropped due to full GBP or insufficient bandwidth: 301

  Packets dropped due to Fast Filter Processor (FFP): 261

  Packets dropped due to STP non-forwarding state: 0

  Packets dropped due to insufficient data buffer. Input dropped: 0 Output dropped:0

  Packets of ECN marked: 0

# Display the summary of dropped packets on only interfaces that support this command.

<Sysname> display packet-drop summary

All interfaces:

  Packets dropped due to full GBP or insufficient bandwidth: 301

  Packets dropped due to Fast Filter Processor (FFP): 261

  Packets dropped due to STP non-forwarding state: 0

  Packets dropped due to insufficient data buffer. Input dropped: 0 Output dropped:0

  Packets of ECN marked: 0

# Display statistics about dropped packets on all slots. (In standalone mode.)

<Sysname> display packet-drop slot

Slot            Total

0               210

1               210

2               210

# Display statistics about dropped packets on all slots in all classis. (In IRF mode.)

<Sysname> display packet-drop chassis

Chassis         Slot            Total

1               0               210

2               0               210

                1               210

                2               210

Table 9 Command output

Field

Description

Packets dropped due to full GBP or insufficient bandwidth

Packets that are dropped because the buffer is used up or the bandwidth is insufficient.

Packets dropped due to Fast Filter Processor (FFP)

Packets that are filtered out.

Packets dropped due to STP non-forwarding state

Packets that are dropped because STP is in the non-forwarding state.

Packets of ECN marked

Packets with the ECN field set to 11 because WRED queue thresholds are reached. For more information about WRED and ECN, see ACL and QoS Configuration Guide.

Slot

Slot number.

Chassis

Chassis number.

Total

Statistics about dropped packets.

display lbn-group status

Use display lbn-group status to display LBN group information.

Syntax

display lbn-group status

Views

System view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Example

# Display LBN group information.

<System> display lbn-group status

Global lbn-group configuration: Enable

GroupName      GroupIndex    Index       Interface

Leaf1          1             0           Ten-GigabitEthernet3/0/2

                                         Ten-GigabitEthernet3/0/1

Leaf           2             0           Ten-GigabitEthernet3/0/3

                                         Ten-GigabitEthernet3/0/4

Table 10 Command output

Field

Description

Global lbn-group configuration

Status of the LBN group feature:

·     Disable

·     Enable

GroupName

Name of the LBN group.

GroupIndex

Index of an interface in the LBN group.

Index

Index of the LBN group.

Interface

Name of the interface.

 

Related commands

group-member interface

display slot-monitor

Use display slot-monitor to display alarm information for cards.

Syntax

In standalone mode:

display slot-monitor slot slot-number

In IRF mode:

display slot-monitor chassis chassis-number slot slot-number

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

slot slot-number: Specifies a card by its slot number. (In standalone mode.)

slot slot-number: Specifies an IRF member device by its member ID.

slot slot-number: Specifies an IRF member device by its member ID or specifies a PEX by its virtual slot number.

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. (In IRF mode.)

Examples

# Display alarm information for the card in slot 1.

<Sysname> display slot-monitor slot 1

Slot 1:

  Packet-Drop:

    Trap enable    : Y

    Trigger Action : Reboot

    Alarm status   : N

    High threshold : 1000

    Low threshold  : 100

    Interval       : 10 s

    Value          : 10

    Trigger at     : Never

Table 11 Command output

Field

Description

Trap enable

Whether SNMP notifications are enabled:

·     Y—SNMP notifications are disabled.

·     N—SNMP notifications are enabled.

Trigger Action

Action to take after the alarm threshold is reached:

·     Reboot—Reboots the card.

·     Down—Shuts down all the interfaces on the card.

Alarm status

Alarm status:

·     Y—An alarm was triggered on the card.

·     N—No alarm is triggered on the card.

High threshold

Alarm upper threshold.

Low threshold

Alarm lower threshold.

Interval

Statistics collection and comparison interval in seconds.

Value

If an error packet alarm is triggered, it indicates the number of error packets in the most recent statistics cycle.

Trigger at

Date and time when the most recent crossing of the alarm threshold occurred:

·     [L]YYYY/MM/DD HH:MM:SS—Date and time when the most recent crossing of the alarm lower threshold occurred.

·     [H]YYYY/MM/DD HH:MM:SS—Date and time when the most recent crossing of the alarm upper threshold occurred.

·     Never—No alarm threshold crossing occurred.

 

duplex

Use duplex to set the duplex mode for an Ethernet interface.

Use undo duplex to restore the default.

Syntax

duplex { auto | full | half }

undo duplex

Default

A management Ethernet fiber interface operates in full duplex mode. Other Ethernet interfaces operate in autonegotiation mode.

Views

Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Parameters

auto: Configures the interface to autonegotiate the duplex mode with the peer.

full: Configures the interface to operate in full duplex mode. In this mode, the interface can receive and transmit packets simultaneously.

half: Configures the interface to operate in half duplex mode. In this mode, the interface can only receive or transmit packets at a given time. Fiber ports do not support this keyword.

Usage guidelines

For Ethernet interfaces connected to the same physical link to operate correctly, you must configure the same duplex mode for them.

A management Ethernet fiber interface supports only the full duplex mode.

Examples

# Configure Ten-GigabitEthernet 3/0/1 to operate in full duplex mode.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] duplex full

eee enable

 

IMPORTANT

IMPORTANT:

Fiber ports do not support this command.

Use eee enable to enable Energy Efficient Ethernet (EEE) on an interface.

Use undo eee enable to disable EEE on an interface.

Syntax

eee enable

undo eee enable

Default

EEE is disabled.

Views

Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

With EEE enabled, a link-up interface enters low power state if it has not received any packet for a period of time. The time period depends on the chip specifications and is not configurable. When a packet arrives later, the interface restores to the normal state.

The eee enable and loopback commands are exclusive with each other, whichever is configured last will fail.

Examples

# Enable EEE on Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] eee enable

flow-control

Use flow-control to enable TxRx-mode generic flow control on an Ethernet interface.

Use undo flow-control to disable TxRx-mode generic flow control on the Ethernet interface.

Syntax

flow-control

undo flow-control

Default

TxRx-mode generic flow control is disabled on an Ethernet interface.

Views

Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

With TxRx-mode generic flow control configured, an interface can both send and receive flow control frames:

·     When congested, the interface sends a flow control frame to its peer.

·     Upon receiving a flow control frame from the peer, the interface suspends sending packets.

To implement flow control on a link, enable generic flow control at both ends of the link.

Examples

# Enable TxRx-mode generic flow control on Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] flow-control

flow-control receive enable

Use flow-control receive enable to enable Rx-mode generic flow control on an Ethernet port.

Use undo flow-control to disable Rx-mode generic flow control on an Ethernet port.

Syntax

flow-control receive enable

undo flow-control

Default

Rx-mode generic flow control is disabled on Ethernet interfaces.

Views

Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

With Rx-mode flow control enabled, an interface can receive but cannot send flow control frames.

·     When the interface receives a flow control frame from its peer, it suspends sending packets to the peer.

·     When traffic congestion occurs on the interface, it cannot send flow control frames to the peer.

To handle unidirectional traffic congestion on a link, configure the flow-control receive enable command at one end, and the flow-control command at the other. To enable both ends of the link to handle traffic congestion, configure the flow-control command at both ends.

Examples

# Enable Rx-mode generic flow control on Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-ten-gigabitethernet 3/0/1] flow-control receive enable

Related commands

flow-control

flow-interval

Use flow-interval to set the statistics polling interval.

Use undo flow-interval to restore the default.

Syntax

flow-interval interval

undo flow-interval

Default

The statistics polling interval is 300 seconds.

Views

System view

Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Parameters

interval: Sets the statistics polling interval in seconds. The interval is in the range of 5 to 300 and must be a multiple of 5 in system view. The interval is in the range of 1 to 300 and must be a multiple of 1 in Ethernet interface view.

Examples

# Set the statistics polling interval to 100 seconds on Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] flow-interval 100

group-member interface

Use group-member interface to assign interfaces to an LBN group.

Use undo group-member interface to remove interfaces from an LBN group.

Syntax

group-member interface interface-list

undo group-member interface interface-list

group-member interface interface-type interface-number index index-value

undo   group-member interface interface-type interface-number index index-value

Views

LBN group view

Default

An LBN group does not contain any interfaces.

Predefined user roles

network-admin

mdc-admin

Parameters

interface-list: Specifies a list of interfaces, in the format of interface-list= { interface-type interface-number1 [ to interface-type interface-number2 ] }&<1-n>. interface-type interface-number specifies an interface by its type and number. &<1-N> specifies a space-separated list of up to n items. The value of n depends on the device model. The number of interfaces assigned to an LBN group cannot exceed 128.

interface-type interface-number: Specifies an interface by its type and number.

index-value: Specifies an interface by its index, in the range of 0 to 63.

Usage guidelines

You can specify an index to assign an interface with the specified index to an LBN group or specify a list of interfaces to allow the device to automatically assign indexes to the interfaces and assign the interfaces in bulk to an LBN group.

When the device automatically assigns indexes to interfaces, it allocates the smallest current index to the first interface configured at the CLI. Then, it assigns indexes to the remaining interfaces in ascending order of their interface numbers.

As a best practice, do not manually specify an index. If you specify a list of non-contiguous interface indexes, the traffic outgoing interfaces will become discontinuous, causing unbalanced traffic. If you have to manually specify an index, do that under guidance of professionals. If removing an interface from an LBN group results in discontinuous interface indexes, you must manually adjust the indexes to have them become continuous again.

You can assign only physical interfaces to an LBN group, and the interfaces must be incoming interfaces.

IRF physical ports cannot be assigned to an LBN group.

An interface can belong to only one LBN group.

The display ip load-sharing path command does not take effect on an interface in an LBN group.

If you specify a list of interfaces, make sure the two interfaces before and after the to keyword are the same type.

Example

# Assign interfaces Ten-GigabitEthernet 3/0/1 through Ten-GigabitEthernet 3/0/4 to LBN group Leaf1.

<Sysname> system-view

[Sysname] lbn-group Leaf1

[Sysname-lbn-group-Leaf1] group-member interface Ten-GigabitEthernet3/0/1 to Ten-GigabitEthernet3/0/4

# Assign interface Ten-GigabitEthernet 3/0/1 with index 3 to LBN group Leaf1.

<Sysname> system-view

[Sysname] lbn-group Leaf1

[Sysname-lbn-group-Leaf1] group-member interface Ten-GigabitEthernet3/0/1 index 3

ifmonitor crc-error

Use ifmonitor crc-error to configure global CRC error packet alarm parameters.

Use undo ifmonitor crc-error to restore the default.

Syntax

In standalone mode:

ifmonitor crc-error slot slot-number high-threshold high-value low-threshold low-value interval interval [ down-auto-recovery | shutdown ]

undo ifmonitor crc-error slot slot-number

In IRF mode:

ifmonitor crc-error chassis chassis-number slot slot-number high-threshold high-value low-threshold low-value interval interval [ down-auto-recovery | shutdown ]

undo ifmonitor crc-error chassis chassis-number slot slot-number

Default

The upper threshold is 1000, the lower threshold is 100, and the statistics collection and comparison interval is 10 seconds for CRC error packet alarms.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

high-threshold high-value: Specifies the upper threshold for CRC error packet alarms, in the range of 1 to 4294967295 packets.

low-threshold low-value: Specifies the lower threshold for CRC error packet alarms, in the range of 1 to 4294967295 packets.

interval interval: Specifies the statistics collection and comparison interval for CRC error packets, in the range of 1 to 65535 seconds.

down-auto-recovery: Shuts down an interface when the number of incoming CRC error packets on the interface exceeds the upper threshold. Then, the interface stops forwarding all packets. After the port recovery time set by the shutdown-interval crc-error command, the port automatically restores to its actual physical state. If you do not specify this keyword, an upper threshold exceeding alarm is generated and the interface enters alarm state when the number of incoming CRC error packets exceeds the upper threshold on the interface.

shutdown: Shuts down an interface when the number of incoming CRC error packets on the interface exceeds the upper threshold. Then, the interface stops forwarding all packets. To recover the interface, execute the undo shutdown command on the interface. If you do not specify this keyword, an upper threshold exceeding alarm is generated and the interface enters the alarm state when the number of incoming CRC error packets exceeds the upper threshold on the interface, but the interface will not be shut down. If you specify this keyword when the upper threshold has been exceeded on an interface, the interface will be shut down.

slot slot-number: Specifies a card by its slot number. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. (In IRF mode.)

Usage guidelines

With the CRC error packet alarm function enabled, when the number of incoming CRC error packets on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the number of incoming CRC error packets on an interface in the alarm state within the specified interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.

You can configure the CRC error packet alarm parameters in system view and interface view.

·     The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

·     For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

When you execute this command multiple times, the most recent configuration takes effect.

Examples

# (In standalone mode.) Set the upper threshold to 5000, lower threshold to 400, and statistics collection and comparison interval to 6 seconds for CRC error packet alarms.

<Sysname> system-view

[Sysname] ifmonitor crc-error slot 1 high-threshold 5000 low-threshold 400 interval 6

# (In IRF mode.) Set the upper threshold to 5000, lower threshold to 400, and statistics collection and comparison interval to 6 seconds for CRC error packet alarms.

<Sysname> system-view

[Sysname] ifmonitor crc-error chassis 1 slot 1 high-threshold 5000 low-threshold 400 interval 6

Related commands

shutdown-interval crc-error

snmp-agent trap enable ifmonitor

ifmonitor input-buffer-drop

Use ifmonitor input-buffer-drop to configure packet-drop alarm parameters for the ingress buffer globally.

Use undo ifmonitor input-buffer-drop to restore the default.

Syntax

In standalone mode:

ifmonitor input-buffer-drop slot slot-number high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo ifmonitor input-buffer-drop slot slot-number

In IRF mode:

ifmonitor input-buffer-drop chassis chassis-number slot slot-number high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo ifmonitor input-buffer-drop chassis chassis-number slot slot-number

Default

The upper threshold is 1000, the lower threshold is 100, and the statistics collection and comparison interval is 10 seconds.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

high-threshold high-value: Specifies the upper packet-drop alarm threshold for the ingress buffer, in the range of 1 to 4294967295 packets.

low-threshold low-value: Specifies the lower packet-drop alarm threshold for the ingress buffer, in the range of 1 to 4294967295 packets.

interval interval: Specifies the statistics collection and comparison interval, in the range of 1 to 65535 seconds.

shutdown: Shuts down an interface when the number of dropped packets in the ingress buffer crosses the upper threshold on that interface. Then, the interface stops forwarding all packets. To recover the interface, execute the undo shutdown command on the interface. If you do not specify this keyword, an upper threshold crossing alarm is generated and the interface enters alarm state when the number of dropped packets in the ingress buffer crosses the upper threshold on the interface.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays information on the active MPU. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify this option,, the command displays information on the global active MPU. (In IRF mode.)

Usage guidelines

With this feature configured, when the number of dropped packets in the ingress buffer on an interface crosses the upper threshold within the specified interval, the interface generates an alarm and enters alarm state. When the number of dropped packets on that interface drops below the lower threshold within the specified interval, the interface generates an alarm and restores to normal state.

You can configure packet-drop alarm parameters for the ingress buffer in system view and interface view.

·     The configuration in system view takes effect on all interfaces. The configuration in interface view takes effect only on the current interface. (Devices that do not support the slot keyword.)

·     The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface. (Devices that support the slot keyword.)

·     For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

If you execute this command multiple times, the most recent configuration takes effect.

Examples

# Set the upper threshold to 5000, lower threshold to 400, and statistics collection and comparison interval to 6 seconds for ingress buffer packet-drop alarms.

<Sysname> system-view

[Sysname] ifmonitor input-buffer-drop high-threshold 5000 low-threshold 400 interval 6

Related commands

snmp-agent trap enable ifmonitor

ifmonitor input-error

Use ifmonitor input-error to configure global input error packet alarm parameters.

Use undo ifmonitor input-error to restore the default.

Syntax

In standalone mode:

ifmonitor input-error slot slot-number high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo ifmonitor input-error slot slot-number

In IRF mode:

ifmonitor input-error chassis chassis-number slot slot-number high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo ifmonitor input-error chassis chassis-number slot slot-number

Default

The upper threshold is 1000, the lower threshold is 100, and the statistics collection and comparison interval is 10 seconds for input error packet alarms.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

high-threshold high-value: Specifies the upper threshold for input error packet alarms, in the range of 1 to 4294967295 packets.

low-threshold low-value: Specifies the lower threshold for input error packet alarms, in the range of 1 to 4294967295 packets.

interval interval: Specifies the statistics collection and comparison interval for input error packets, in the range of 1 to 65535 seconds.

shutdown: Shuts down an interface when the number of input error packets on the interface exceeds the upper threshold. Then, the interface stops forwarding all packets. To recover the interface, execute the undo shutdown command on the interface. If you do not specify this keyword, an upper threshold exceeding alarm is generated and the interface enters the alarm state when the number of input error packets exceeds the upper threshold on the interface, but the interface will not be shut down. If you specify this keyword when the upper threshold has been exceeded on an interface, the interface will be shut down.

slot slot-number: Specifies a card by its slot number. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. (In IRF mode.)

Usage guidelines

With the input error packet alarm function enabled, when the number of input error packets on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the number of input error packets on an interface in the alarm state within the specified interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.

You can configure the input error packet alarm parameters in system view and interface view.

·     The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

·     For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

When you execute this command multiple times, the most recent configuration takes effect.

Examples

# (In standalone mode.) Set the upper threshold to 5000, lower threshold to 400, and statistics collection and comparison interval to 6 seconds for input error packet alarms.

<Sysname> system-view

[Sysname] ifmonitor input-error slot 1 high-threshold 5000 low-threshold 400 interval 6

# (In IRF mode.) Set the upper threshold to 5000, lower threshold to 400, and statistics collection and comparison interval to 6 seconds for input error packet alarms.

<Sysname> system-view

[Sysname] ifmonitor input-error chassis 1 slot 1 high-threshold 5000 low-threshold 400 interval 6

Related commands

snmp-agent trap enable ifmonitor

ifmonitor input-usage

Use ifmonitor input-usage to configure global input bandwidth usage alarm parameters.

Use undo ifmonitor input-usage to restore the default.

Syntax

In standalone mode:

ifmonitor input-usage slot slot-number high-threshold high-value low-threshold low-value

undo ifmonitor input-usage slot slot-number

In IRF mode:

ifmonitor input-usage chassis chassis-number slot slot-number high-threshold high-value low-threshold low-value

undo ifmonitor input-usage chassis chassis-number slot slot-number

Default

The upper threshold is 90, and the lower threshold is 80.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

high-threshold high-value: Specifies the upper threshold for input bandwidth usage alarms, in the range of 1 to 100.

low-threshold low-value: Specifies the lower threshold for input bandwidth usage alarms, in the range of 1 to 100.

slot slot-number: Specifies a card by its slot number. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. (In IRF mode.)

Usage guidelines

With the input bandwidth usage alarm function enabled, when the input bandwidth usage on an interface in normal state within the most recent statistics polling interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the input bandwidth usage on an interface in the alarm state within the most recent statistics polling interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.

You can use the flow-interval command to set the statistics polling interval.

You can configure the input bandwidth usage alarm parameters in system view and interface view.

·     The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

·     For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

For this command to take effect, you must use the snmp-agent trap enable ifmonitor command to enable the input bandwidth usage alarm function.

When you execute this command multiple times, the most recent configuration takes effect.

Examples

# (In standalone mode.) Set the upper threshold to 95 and lower threshold to 80 for input bandwidth usage alarms.

<Sysname> system-view

[Sysname] ifmonitor input-usage slot 1 high-threshold 95 low-threshold 80

# (In IRF mode.) Set the upper threshold to 95 and lower threshold to 80 for input bandwidth usage alarms.

<Sysname> system-view

[Sysname] ifmonitor input-usage chassis 1 slot 1 high-threshold 95 low-threshold 80

Related commands

flow-interval

snmp-agent trap enable ifmonitor

ifmonitor output-buffer-drop

Use ifmonitor output-buffer-drop to configure packet-drop alarm parameters for the egress buffer globally.

Use undo ifmonitor output-buffer-drop to restore the default.

Syntax

In standalone mode:

ifmonitor output-buffer-drop slot slot-number high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo ifmonitor output-buffer-drop slot slot-number

In IRF mode:

ifmonitor output-buffer-drop chassis chassis-number slot slot-number high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo ifmonitor output-buffer-drop chassis chassis-number slot slot-number

Default

By default, the upper threshold is 1000, the lower threshold is 100, and the statistics collection and comparison interval is 10 seconds.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

high-threshold high-value: Specifies the upper packet-drop alarm threshold for the egress buffer, in the range of 1 to 4294967295 packets.

low-threshold low-value: Specifies the lower packet-drop alarm threshold for the egress buffer, in the range of 1 to 4294967295 packets.

interval interval: Specifies the statistics collection and comparison interval, in the range of 1 to 65535 seconds.

shutdown: Shuts down an interface when the number of dropped packets in the egress buffer crosses the upper threshold on that interface. Then, the interface stops forwarding all packets. To recover the interface, execute the undo shutdown command on the interface. If you do not specify this keyword, an upper threshold crossing alarm is generated and the interface enters alarm state when the number of dropped packets in the egress buffer crosses the upper threshold on the interface.

slot slot-number: Specifies a card by its slot number. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. (In IRF mode.)

Usage guidelines

With the egress buffer packet-drop alarm function enabled, when the number of egress buffer packet-drops on an interface in normal state within the specified interval crosses the upper threshold, the interface generates an upper threshold crossing alarm and enters the alarm state. When the number of packet-drops on an interface in the alarm state within the specified interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.

You can configure packet-drop alarm parameters for the egress buffer in system view and interface view.

·     The configuration in system view takes effect on all interfaces. The configuration in interface view takes effect only on the current interface. (Devices that do not support the slot keyword.)

·     The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface. (Devices that support the slot keyword.)

·     For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

If you execute this command multiple times, the most recent configuration takes effect.

Examples

# Set the upper threshold to 5000, lower threshold to 400, and statistics collection and comparison interval to 6 seconds for egress buffer packet-drop alarms.

<Sysname> system-view

[Sysname] ifmonitor output-buffer-drop high-threshold 5000 low-threshold 400 interval 6

Related commands

snmp-agent trap enable ifmonitor

ifmonitor output-error

Use ifmonitor output-error to configure global output error packet alarm parameters.

Use undo ifmonitor output-error to restore the default.

Syntax

In standalone mode:

ifmonitor output-error slot slot-number high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo ifmonitor output-error slot slot-number

In IRF mode:

ifmonitor output-error chassis chassis-number slot slot-number high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo ifmonitor output-error chassis chassis-number slot slot-number

Default

The upper threshold is 1000, the lower threshold is 100, and the statistics collection and comparison interval is 10 seconds for output error packet alarms.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

high-threshold high-value: Specifies the upper threshold for output error packet alarms, in the range of 1 to 4294967295 packets.

low-threshold low-value: Specifies the lower threshold for output error packet alarms, in the range of 1 to 4294967295 packets.

interval interval: Specifies the statistics collection and comparison interval for output error packets, in the range of 1 to 65535 seconds.

shutdown: Shuts down an interface when the number of output error packets on the interface exceeds the upper threshold. Then, the interface stops forwarding all packets. To recover the interface, execute the undo shutdown command on the interface. If you do not specify this keyword, an upper threshold exceeding alarm is generated and the interface enters the alarm state when the number of output error packets exceeds the upper threshold on the interface, but the interface will not be shut down. If you specify this keyword when the upper threshold has been exceeded on an interface, the interface will be shut down.

slot slot-number: Specifies a card by its slot number. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. (In IRF mode.)

Usage guidelines

With the output error packet alarm function enabled, when the number of output error packets on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the number of output error packets on an interface in the alarm state within the specified interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.

You can configure the output error packet alarm parameters in system view and interface view.

·     The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

·     For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

When you execute this command multiple times, the most recent configuration takes effect.

Examples

# (In standalone mode.) Set the upper threshold to 5000, lower threshold to 400, and statistics collection and comparison interval to 6 seconds for output error packet alarms.

<Sysname> system-view

[Sysname] ifmonitor output-error slot 1 high-threshold 5000 low-threshold 400 interval 6

# (In IRF mode.) Set the upper threshold to 5000, lower threshold to 400, and statistics collection and comparison interval to 6 seconds for output error packet alarms.

<Sysname> system-view

[Sysname] ifmonitor output-error chassis 1 slot 1 high-threshold 5000 low-threshold 400 interval 6

Related commands

snmp-agent trap enable ifmonitor

ifmonitor output-usage

Use ifmonitor output-usage to configure global output bandwidth usage alarm parameters.

Use undo ifmonitor output-usage to restore the default.

Syntax

In standalone mode:

ifmonitor output-usage slot slot-number high-threshold high-value low-threshold low-value

undo ifmonitor output-usage slot slot-number

In IRF mode:

ifmonitor output-usage chassis chassis-number slot slot-number high-threshold high-value low-threshold low-value

undo ifmonitor output-usage chassis chassis-number slot slot-number

Default

The upper threshold is 90, and the lower threshold is 80.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

high-threshold high-value: Specifies the upper threshold for output bandwidth usage alarms, in the range of 1 to 100.

low-threshold low-value: Specifies the lower threshold for output bandwidth usage alarms, in the range of 1 to 100.

slot slot-number: Specifies a card by its slot number. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. (In IRF mode.)

Usage guidelines

With the output bandwidth usage alarm function enabled, when the output bandwidth usage on an interface in normal state within the most recent statistics polling interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the output bandwidth usage on an interface in the alarm state within the most recent statistics polling interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.

You can use the flow-interval command to set the statistics polling interval.

You can configure the output bandwidth usage alarm parameters in system view and interface view.

·     The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

·     For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

For this command to take effect, you must use the snmp-agent trap enable ifmonitor command to enable the output bandwidth usage alarm function.

When you execute this command multiple times, the most recent configuration takes effect.

Examples

# (In standalone mode.) Set the upper threshold to 80 and lower threshold to 60 for output bandwidth usage alarms.

<Sysname> system-view

[Sysname] ifmonitor output-usage slot 1 high-threshold 80 low-threshold 60

# (In IRF mode.) Set the upper threshold to 80 and lower threshold to 60 for output bandwidth usage alarms.

<Sysname> system-view

[Sysname] ifmonitor output-usage chassis 1 slot 1 high-threshold 80 low-threshold 60

Related commands

flow-interval

snmp-agent trap enable ifmonitor

ifmonitor rx-pause

Use ifmonitor rx-pause to configure global received pause frame alarm parameters.

Use undo ifmonitor rx-pause to restore the default.

Syntax

In standalone mode:

ifmonitor rx-pause slot slot-number high-threshold high-value low-threshold low-value interval interval

undo ifmonitor rx-pause slot slot-number

In IRF mode:

ifmonitor rx-pause chassis chassis-number slot slot-number high-threshold high-value low-threshold low-value interval interval

undo ifmonitor rx-pause chassis chassis-number slot slot-number

Default

The upper threshold is 500, the lower threshold is 100, and the statistics collection and comparison interval is 10 seconds for received pause frame alarms.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

high-threshold high-value: Specifies the upper threshold for received pause frame alarms, in the range of 1 to 4294967295 packets.

low-threshold low-value: Specifies the lower threshold for received pause frame alarms, in the range of 1 to 4294967295 packets.

interval interval: Specifies the statistics collection and comparison interval for received pause frames, in the range of 1 to 65535 seconds.

slot slot-number: Specifies a card by its slot number. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. (In IRF mode.)

Usage guidelines

With the received pause frame alarm function enabled, when the number of received pause frames on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the number of received pause frames on an interface in the alarm state within the specified interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.

You can configure the received pause frame alarm parameters in system view and interface view.

·     The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

·     For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

For this command to take effect, you must use the snmp-agent trap enable ifmonitor command to enable the received pause frame alarm function.

When you execute this command multiple times, the most recent configuration takes effect.

Examples

# (In standalone mode.) Set the upper threshold to 30, lower threshold to 20, and statistics collection and comparison interval to 4 seconds for received pause frame alarms.

<Sysname> system-view

[Sysname] ifmonitor rx-pause slot 1 high-threshold 30 low-threshold 20 interval 4

# (In IRF mode.) Set the upper threshold to 30, lower threshold to 20, and statistics collection and comparison interval to 4 seconds for received pause frame alarms.

<Sysname> system-view

[Sysname] ifmonitor rx-pause chassis 1 slot 1 high-threshold 30 low-threshold 20 interval 4

Related commands

snmp-agent trap enable ifmonitor

ifmonitor tx-pause

Use ifmonitor tx-pause to configure global sent pause frame alarm parameters.

Use undo ifmonitor tx-pause to restore the default.

Syntax

In standalone mode:

ifmonitor tx-pause slot slot-number high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo ifmonitor tx-pause slot slot-number

In IRF mode:

ifmonitor tx-pause chassis chassis-number slot slot-number high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo ifmonitor tx-pause chassis chassis-number slot slot-number

Default

The upper threshold is 500, the lower threshold is 100, and the statistics collection and comparison interval is 10 seconds for sent pause frame alarms.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

high-threshold high-value: Specifies the upper threshold for sent pause frame alarms, in the range of 1 to 4294967295 packets.

low-threshold low-value: Specifies the lower threshold for sent pause frame alarms, in the range of 1 to 4294967295 packets.

interval interval: Specifies the statistics collection and comparison interval for sent pause frames, in the range of 1 to 65535 seconds.

shutdown: Shuts down an interface when the number of sent pause frames on the interface exceeds the upper threshold. Then, the interface stops forwarding all packets. To recover the interface, execute the undo shutdown command on the interface. If you do not specify this keyword, an upper threshold exceeding alarm is generated and the interface enters the alarm state when the number of sent pause frames exceeds the upper threshold on the interface, but the interface will not be shut down. If you specify this keyword when the upper threshold has been exceeded on an interface, the interface will be shut down.

slot slot-number: Specifies a card by its slot number. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. (In IRF mode.)

Usage guidelines

With the sent pause frame alarm function enabled, when the number of sent pause frames on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the number of sent pause frames on an interface in the alarm state within the specified interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.

You can configure the sent pause frame alarm parameters in system view and interface view.

·     The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

·     For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

For this command to take effect, you must use the snmp-agent trap enable ifmonitor command to enable the sent pause frame alarm function.

When you execute this command multiple times, the most recent configuration takes effect.

Examples

# (In standalone mode.) Set the upper threshold to 20, lower threshold to 10, and statistics collection and comparison interval to 5 seconds for sent pause frame alarms.

<Sysname> system-view

[Sysname] ifmonitor tx-pause slot 1 high-threshold 20 low-threshold 10 interval 5

# (In IRF mode.) Set the upper threshold to 20, lower threshold to 10, and statistics collection and comparison interval to 5 seconds for sent pause frame alarms.

<Sysname> system-view

[Sysname] ifmonitor tx-pause chassis 1 slot 1 high-threshold 20 low-threshold 10 interval 5

Related commands

snmp-agent trap enable ifmonitor

interface

Use interface to enter interface view, create a subinterface and enter its view, or enter the view of an existing subinterface.

Syntax

interface interface-type { interface-number | interface-number.subnumber }

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

interface-type: Specifies an interface type.

interface-number: Specifies an interface number.

interface-number.subnumber: Specifies a subinterface number. The interface-number argument is an interface number. The subnumber argument is the number of a subinterface created under the interface. The value range for the subnumber argument is 1 to 4094.

Examples

# Enter the view of Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1]

# Create Ethernet subinterface Ten-GigabitEthernet 3/0/1.1 and enter its view.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1.1

[Sysname-Ten-GigabitEthernet3/0/1.1]

 

interface default-description output

Use interface default-description output to display the default description for interfaces when the interface information is displayed.

Use undo interface default-description output to not display the default description for interfaces when the interface information is displayed.

Syntax

interface default-description output

undo interface default-description output

Default

The device displays the default description for interfaces when it displays the interface information.

Views

System view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

This command takes effect only on physical interfaces.

Examples

# Configure the device to not display the default description for interfaces when it displays the interface information.

<Sysname> system-view

[Sysname] undo interface default-description output

Related commands

description

jumboframe enable

Use jumboframe enable to allow jumbo frames within the specified length to pass through.

Use undo jumboframe enable to prevent jumbo frames from passing through.

Use undo jumboframe enable size to restore the default.

Syntax

jumboframe enable [ size ]

undo jumboframe enable [ size ]

Default

The device allows jumbo frames within 13312 bytes to pass through.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Predefined user roles

network-admin

mdc-admin

size: Sets the maximum length (in bytes) of Ethernet frames that are allowed to pass through. The value range for this argument is 1536 to 13312.

Usage guidelines

If you execute this command multiple times, the most recent configuration takes effect.

The length of jumbo frames that are allowed to pass through is 13280 bytes between member devices in an IRF fabric.

Examples

# Allow jumbo frames to pass through Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] jumboframe enable

link-delay

Use link-delay to set the physical state change suppression interval on an Ethernet interface.

Use undo link-delay to restore the default.

Syntax

link-delay { down | up } [ msec ] delay-time

undo link-delay { down | up }

Default

Physical state change suppression is disabled.

Views

Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Parameters

down: Suppresses link-down events.

up: Suppresses link-up events.

msec: Enables the physical state change suppression interval to be accurate to milliseconds. If you do not specify this keyword, the suppression interval is accurate to seconds.

delay-time: Sets the physical state change suppression interval on the Ethernet interface. A value of 0 means that physical state changes are immediately reported to the CPU and are not suppressed.

·     If you do not specify the msec keyword, the value range is 0 to 120 seconds.

·     If you specify the msec keyword, the value range is 0 to 10000 milliseconds, and the value must be a multiple of 100.

Usage guidelines

You can configure this feature to suppress only link-down events, only link-up events, or both. If an event of the specified type still exists when the suppression interval expires, the system reports the event.

When you configure this feature, follow these guidelines:

·     To suppress link-down events, execute the link-delay down command.

·     To suppress link-up events, execute the link-delay up command.

On an interface, you can configure different suppression intervals for link-up and link-down events. If you execute the link-delay command multiple times on an interface, the following rules apply:

·     You can configure the suppression intervals for link-up and link-down events separately.

·     If you configure the suppression interval multiple times for link-up or link-down events, the most recent configuration takes effect.

Do not execute this command on an interface that has RRPP, spanning tree protocols, or Smart Link enabled.

This command, the dampening command, and the port link-flap protect enable command are mutually exclusive on an Ethernet interface.

Examples

# Set the link-down event suppression interval to 8 seconds on Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] link-delay down 8

# Set the link-up event suppression interval to 800 milliseconds on Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] link-delay up msec 800

Related commands

dampening

port link-flap protect enable

 

link-flap protect enable

Use link-flap protect enable to enable link flapping protection globally.

Use undo link-flap protect enable to disable link flapping protection globally.

Syntax

link-flap protect enable [ down-auto-recovery ]

undo link-flap protect enable

Default

Link flapping protection is disabled globally.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

down-auto-recovery: Shuts down an interface when the device detects link flapping on that interface. When the port status detection timer for the ports that are shut down by the link flapping protection feature expires (configured by the shutdown-interval link-flap command), the interface automatically comes up. If you do not specify this keyword, an interface does not come up automatically when the port status detection timer for the ports that are shut down by the link flapping protection feature expires.

Usage guidelines

Link flapping on any interface changes network topology and increases the system overhead. For example, in an active/standby link scenario, when the interface status on the active link changes between UP and DOWN, traffic switches between active and standby links. To solve this problem, execute this command.

With link flapping protection enabled on an interface, when the interface goes down, the system enables link flapping detection on the interface. During the link flapping detection interval, if the number of detected flaps reaches or exceeds the link flapping detection threshold, the system shuts down the interface.

Link flapping protection takes effect only when it is enabled in both system view and interface view.

If you specify the down-auto-recovery keyword in both system view and interface view, an interface comes up automatically when the port status detection timer for the ports that are shut down by the link flapping protection feature expires.

Examples

# Enable link flapping protection globally.

<Sysname> system-view

[Sysname] link-flap protect enable

Related commands

port link-flap protect enable

loopback

CAUTION

CAUTION:

After you enable loopback testing on an Ethernet interface, the interface does not forward data traffic.

Use loopback to enable loopback testing on an Ethernet interface.

Use undo loopback to disable loopback testing on an Ethernet interface.

Syntax

loopback internal

undo loopback

Default

Loopback testing is disabled on an Ethernet interface.

Views

Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Parameters

internal: Enables internal loopback testing on the Ethernet interface.

Usage guidelines

After you enable loopback testing on an Ethernet interface, the Ethernet interface switches to full duplex mode. After you disable loopback testing, the Ethernet interface restores to its duplex setting.

The shutdown, port up-mode, and loopback commands are mutually exclusive.

The eee enable and loopback commands are mutually exclusive.

Examples

# Enable internal loopback testing on Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] loopback internal

multicast-suppression

Use multicast-suppression to enable multicast storm suppression and set the multicast storm suppression threshold.

Use undo multicast-suppression to disable multicast storm suppression.

Syntax

multicast-suppression { ratio | pps max-pps | kbps max-kbps }

undo multicast-suppression

Default

Ethernet interfaces do not suppress multicast traffic.

Views

Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Parameters

ratio: Sets the multicast suppression threshold as a percentage of the interface bandwidth. The value range for this argument (in percentage) is 0 to 100. A smaller value means that less multicast traffic is allowed to pass through.

pps max-pps: Specifies the maximum number of multicast packets that the interface can forward per second. The value range for the max-pps argument (in pps) is 0 to 1.4881 × the interface bandwidth.

kbps max-kbps: Specifies the maximum number of kilobits of multicast traffic that the Ethernet interface can forward per second. The value range for this argument (in kbps) is 0 to the interface bandwidth.

Usage guidelines

The multicast storm suppression feature limits the size of multicast traffic to a threshold on an interface. When the multicast traffic on the interface exceeds this threshold, the system drops packets until the traffic drops below this threshold.

Both the storm-constrain command and the multicast-suppression command can suppress multicast storms on a port. The multicast-suppression command uses the chip to physically suppress multicast traffic. It has less influence on the device performance than the storm-constrain command, which uses software to suppress multicast traffic.

For the traffic suppression result to be determined, do not execute both the storm-constrain multicast command and the multicast-suppression command on an interface.

The configured suppression threshold value in pps or kbps will be converted into a multiple of a step supported by the chip. To determine the suppression threshold that takes effect, see the prompts on the device.

After you configure this command, the effective suppression threshold might have a 5% difference from the output of the display interface command.

Examples

# Set the multicast storm suppression threshold to 10000 kbps on Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] multicast-suppression kbps 10000

The actual value is 9984 on port Ten-GigabitEthernet3/0/1 currently.

For the SC and SD modules prefixed with LSCM2, the output shows that the value that takes effect is 9984 kbps.

Related commands

broadcast-suppression

unicast-suppression

port fec mode

Use port fec mode to set the forward error correction (FEC) mode of an interface.

Use undo port fec mode to restore the default.

Syntax

port fec mode auto

undo port fec mode

Default

The FEC mode of an interface is autonegotiation.

Views

100-GE interface view

Predefined user roles

network-admin

mdc-admin

Parameters

auto: Specifies the autonegotiation mode. The device autonegotiates the FEC mode or disables FEC according to the transceiver module type.

Usage guidelines

The FEC feature corrects packet errors to improve transmission quality. It attaches correction information to a packet at the sending end, and corrects error codes generated during transmission at the receiving end based on the correction information. You can set the FEC mode as needed.

Make sure you set the same FEC mode for both interfaces of a link.

When a QSFP28 BIDI transceiver module is installed into an interface, the port fec mode command can only configure the FEC mode of the interface as auto or none.

Examples

# Set the FEC mode of HundredGigE1/0/1 to autonegotiation.

<Sysname> system-view

[Sysname] interface hundredgige 1/0/1

[Sysname-HundredGigE1/0/1] port fec mode auto

 

 

 

port ifmonitor crc-error

Use port ifmonitor crc-error to configure CRC error packet alarm parameters for an interface.

Use undo port ifmonitor crc-error to restore the default.

Syntax

port ifmonitor crc-error [ ratio ] high-threshold high-value low-threshold low-value interval interval [ down-auto-recovery | shutdown ]

undo port ifmonitor crc-error

Default

An interface uses the global CRC error packet alarm parameters.

Views

Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Parameters

ratio: Specifies the alarm thresholds in percentage. If you do not specify this keyword, you configure the alarm thresholds in absolute value.

high-threshold high-value: Specifies the upper threshold for CRC error packet alarms. If you specify the ratio keyword, the value range is 1 to 100. If you do not specify the ratio keyword, the value range is 1 to 4294967295 packets.

low-threshold low-value: Specifies the lower threshold for CRC error packet alarms. If you specify the ratio keyword, the value range is 1 to 100. If you do not specify the ratio keyword, the value range is 1 to 4294967295 packets.

interval interval: Specifies the statistics collection and comparison interval for CRC error packets, in the range of 1 to 65535 seconds.

down-auto-recovery: Shuts down an interface when the number of incoming CRC error packets on the interface exceeds the upper threshold. When the port status detection timer for the ports that are shut down by the CRC error packet alarm feature expires, the interface automatically comes up. If you do not specify this keyword, an upper threshold exceeding alarm is generated and the interface enters alarm state when the number of incoming CRC error packets exceeds the upper threshold on the interface, but the interface will not be shut down.

shutdown: Shuts down an interface when the number of incoming CRC error packets on the interface exceeds the upper threshold. Then, the interface stops forwarding all packets. To recover the interface, execute the undo shutdown command on the interface. If you do not specify this keyword, an upper threshold exceeding alarm is generated and the interface enters the alarm state when the number of incoming CRC error packets exceeds the upper threshold on the interface, but the interface will not be shut down. If you specify this keyword when the upper threshold has been exceeded on an interface, the interface will be shut down.

Usage guidelines

With the CRC error packet alarm function enabled, when the number of incoming CRC error packets on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the number of incoming CRC error packets on an interface in the alarm state within the specified interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.

You can configure the CRC error packet alarm parameters in system view and interface view.

·     The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

·     For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

When you execute this command multiple times, the most recent configuration takes effect.

Examples

# Set the upper threshold to 5000, lower threshold to 400, and statistics collection and comparison interval to 6 seconds for CRC error packet alarms on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] port ifmonitor crc-error high-threshold 5000 low-threshold 400 interval 6

Related commands

snmp-agent trap enable ifmonitor

port ifmonitor input-buffer-drop

Use ifmonitor input-buffer-drop to configure packet-drop alarm parameters for the ingress buffer on an interface.

Use undo port ifmonitor input-buffer-drop to restore the default.

Syntax

port ifmonitor input-buffer-drop high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo port ifmonitor input-buffer-drop

Default

An interface uses the packet-drop alarm parameters globally configured for the ingress buffer.

Views

Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Parameters

high-threshold high-value: Specifies the upper packet-drop alarm threshold for the ingress buffer, in the range of 1 to 4294967295 packets.

low-threshold low-value: Specifies the lower packet-drop alarm threshold for the ingress buffer, in the range of 1 to 4294967295 packets.

interval interval: Specifies the statistics collection and comparison interval, in the range of 1 to 65535 seconds.

shutdown: Shuts down an interface when the number of dropped packets in the ingress buffer crosses the upper threshold on that interface. Then, the interface stops forwarding all packets. To recover the interface, execute the undo shutdown command on the interface. If you do not specify this keyword, an upper threshold crossing alarm is generated and the interface enters alarm state when the number of dropped packets in the ingress buffer crosses the upper threshold on the interface.

Usage guidelines

With this feature configured, when the number of dropped packets in the ingress buffer on an interface crosses the upper threshold within the specified interval, the interface generates an alarm and enters alarm state. When the number of dropped packets on that interface drops below the lower threshold within the specified interval, the interface generates an alarm and restores to normal state.

You can configure packet-drop alarm parameters for the ingress buffer in system view and interface view.

·     The configuration in system view takes effect on all interfaces. The configuration in interface view takes effect only on the current interface. (Devices that do not support the slot keyword.)

·     The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface. (Devices that support the slot keyword.)

·     For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

If you execute this command multiple times, the most recent configuration takes effect.

Examples

# Set the upper threshold to 5000, lower threshold to 400, and statistics collection and comparison interval to 6 seconds for ingress buffer packet-drop alarms on Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] port ifmonitor input-buffer-drop high-threshold 5000 low-threshold 400 interval 6

Related commands

snmp-agent trap enable ifmonitor

port ifmonitor input-error

Use port ifmonitor input-error to configure input error packet alarm parameters for an interface.

Use undo port ifmonitor input-error to restore the default.

Syntax

port ifmonitor input-error high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo port ifmonitor input-error

Default

An interface uses the global input error packet alarm parameters.

Views

Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Parameters

high-threshold high-value: Specifies the upper threshold for input error packet alarms, in the range of 1 to 4294967295 packets.

low-threshold low-value: Specifies the lower threshold for input error packet alarms, in the range of 1 to 4294967295 packets.

interval interval: Specifies the statistics collection and comparison interval for input error packets, in the range of 1 to 65535 seconds.

shutdown: Shuts down an interface when the number of input error packets on the interface exceeds the upper threshold. Then, the interface stops forwarding all packets. To recover the interface, execute the undo shutdown command on the interface. If you do not specify this keyword, an upper threshold exceeding alarm is generated and the interface enters the alarm state when the number of input error packets exceeds the upper threshold on the interface, but the interface will not be shut down. If you specify this keyword when the upper threshold has been exceeded on an interface, the interface will be shut down.

Usage guidelines

With the input error packet alarm function enabled, when the number of input error packets on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the number of input error packets on an interface in the alarm state within the specified interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.

You can configure the input error packet alarm parameters in system view and interface view.

·     The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

·     For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

When you execute this command multiple times, the most recent configuration takes effect.

Examples

# Set the upper threshold to 5000, lower threshold to 400, and statistics collection and comparison interval to 6 seconds for input error packet alarms on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] port ifmonitor input-error high-threshold 5000 low-threshold 400 interval 6

Related commands

snmp-agent trap enable ifmonitor

port ifmonitor input-usage

Use port ifmonitor input-usage to configure input bandwidth usage alarm parameters.

Use undo port ifmonitor input-usage to restore the default.

Syntax

port ifmonitor input-usage high-threshold high-value low-threshold low-value

undo port ifmonitor input-usage

Default

An interface uses the global input bandwidth usage alarm parameters.

Views

Interface view

Predefined user roles

network-admin

mdc-admin

Parameters

high-threshold high-value: Specifies the upper threshold for input bandwidth usage alarms, in the range of 1 to 100.

low-threshold low-value: Specifies the lower threshold for input bandwidth usage alarms, in the range of 1 to 100.

Usage guidelines

With the input bandwidth usage alarm function enabled, when the input bandwidth usage on an interface in normal state within the most recent statistics polling interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the input bandwidth usage on an interface in the alarm state within the most recent statistics polling interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.

You can use the flow-interval command to set the statistics polling interval.

You can configure the input bandwidth usage alarm parameters in system view and interface view.

·     The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

·     For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

For this command to take effect, you must use the snmp-agent trap enable ifmonitor command to enable the input bandwidth usage alarm function.

When you execute this command multiple times, the most recent configuration takes effect.

Examples

# Set the upper threshold to 80 and lower threshold to 60 for input bandwidth usage alarms on Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] port ifmonitor input-usage high-threshold 80 low-threshold 60

Related commands

flow-interval

snmp-agent trap enable ifmonitor

port ifmonitor output-buffer-drop

Use port ifmonitor output-buffer-drop to configure packet-drop alarm parameters for the egress buffer.

Use undo port ifmonitor output-buffer-drop to restore the default.

Syntax

port ifmonitor output-buffer-drop high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo port ifmonitor output-buffer-drop

Default

An interface uses the packet-drop alarm parameters globally configured for the egress buffer.

Views

Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Parameters

high-threshold high-value: Specifies the upper threshold for egress buffer packet-drop alarms, in the range of 1 to 4294967295 packets.

low-threshold low-value: Specifies the lower threshold for egress buffer packet-drop alarms, in the range of 1 to 4294967295 packets.

interval interval: Specifies the statistics collection and comparison interval for egress buffer packet-drop, in the range of 1 to 65535 seconds.

shutdown: Shuts down an interface when the number of dropped packets in the egress buffer crosses the upper threshold on that interface. Then, the interface stops forwarding all packets. To recover the interface, execute the undo shutdown command on the interface. If you do not specify this keyword, an upper threshold crossing alarm is generated and the interface enters alarm state when the number of dropped packets in the egress buffer crosses the upper threshold on the interface.

Usage guidelines

With this feature configured, when the number of dropped packets in the egress buffer on an interface crosses the upper threshold within the specified interval, the interface generates an alarm and enters alarm state. When the number of dropped packets on that interface drops below the lower threshold within the specified interval, the interface generates an alarm and restores to normal state.

You can configure packet-drop alarm parameters for the egress buffer in system view and interface view.

·     The configuration in system view takes effect on all interfaces. The configuration in interface view takes effect only on the current interface. (Devices that do not support the slot keyword.)

·     The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface. (Devices that support the slot keyword.)

·     For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

If you execute this command multiple times, the most recent configuration takes effect.

Examples

# Set the upper threshold to 5000, lower threshold to 400, and statistics collection and comparison interval to 6 seconds for egress buffer packet-drop alarms on Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] port ifmonitor output-buffer-drop high-threshold 5000 low-threshold 400 interval 6

Related commands

snmp-agent trap enable ifmonitor

port ifmonitor output-error

Use port ifmonitor output-error to configure output error packet alarm parameters for an interface.

Use undo port ifmonitor output-error to restore the default.

Syntax

port ifmonitor output-error high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo port ifmonitor output-error

Default

An interface uses the global output error packet alarm parameters.

Views

Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Parameters

high-threshold high-value: Specifies the upper threshold for output error packet alarms, in the range of 1 to 4294967295 packets.

low-threshold low-value: Specifies the lower threshold for output error packet alarms, in the range of 1 to 4294967295 packets.

interval interval: Specifies the statistics collection and comparison interval for output error packets, in the range of 1 to 65535 seconds.

shutdown: Shuts down an interface when the number of output error packets on the interface exceeds the upper threshold. Then, the interface stops forwarding all packets. To recover the interface, execute the undo shutdown command on the interface. If you do not specify this keyword, an upper threshold exceeding alarm is generated and the interface enters the alarm state when the number of output error packets exceeds the upper threshold on the interface, but the interface will not be shut down. If you specify this keyword when the upper threshold has been exceeded on an interface, the interface will be shut down.

Usage guidelines

With the output error packet alarm function enabled, when the number of output error packets on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the number of output error packets on an interface in the alarm state within the specified interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.

You can configure the output error packet alarm parameters in system view and interface view.

·     The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

·     For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

When you execute this command multiple times, the most recent configuration takes effect.

Examples

# Set the upper threshold to 5000, lower threshold to 400, and statistics collection and comparison interval to 6 seconds for output error packet alarms on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] port ifmonitor output-error high-threshold 5000 low-threshold 400 interval 6

Related commands

snmp-agent trap enable ifmonitor

port ifmonitor output-usage

Use port ifmonitor output-usage to configure output bandwidth usage alarm parameters.

Use undo port ifmonitor output-usage to restore the default.

Syntax

port ifmonitor output-usage high-threshold high-value low-threshold low-value

undo port ifmonitor output-usage

Default

An interface uses the global output bandwidth usage alarm parameters.

Views

Interface view

Predefined user roles

network-admin

mdc-admin

Parameters

high-threshold high-value: Specifies the upper threshold for output bandwidth usage alarms, in the range of 1 to 100.

low-threshold low-value: Specifies the lower threshold for output bandwidth usage alarms, in the range of 1 to 100.

Usage guidelines

With the output bandwidth usage alarm function enabled, when the output bandwidth usage on an interface in normal state within the most recent statistics polling interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the output bandwidth usage on an interface in the alarm state within the most recent statistics polling interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.

You can use the flow-interval command to set the statistics polling interval.

You can configure the output bandwidth usage alarm parameters in system view and interface view.

·     The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

·     For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

For this command to take effect, you must use the snmp-agent trap enable ifmonitor command to enable the output bandwidth usage alarm function.

When you execute this command multiple times, the most recent configuration takes effect.

Examples

# Set the upper threshold to 9 and lower threshold to 7 for output bandwidth usage alarms on Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] port ifmonitor output-usage high-threshold 9 low-threshold 7

Related commands

flow-interval

snmp-agent trap enable ifmonitor

port ifmonitor rx-pause

Use port ifmonitor rx-pause to configure received pause frame alarm parameters for an interface.

Use undo port ifmonitor rx-pause to restore the default.

Syntax

port ifmonitor rx-pause high-threshold high-value low-threshold low-value interval interval

undo port ifmonitor rx-pause

Default

An interface uses the global received pause frame alarm parameters.

Views

Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Parameters

high-threshold high-value: Specifies the upper threshold for received pause frame alarms, in the range of 1 to 4294967295.

low-threshold low-value: Specifies the lower threshold for received pause frame alarms, in the range of 1 to 4294967295.

interval interval: Specifies the statistics collection and comparison interval for received pause frame packets, in the range of 1 to 65535 seconds.

Usage guidelines

With the received pause frame alarm function enabled, when the number of received pause frame packets on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the number of received pause frame packets on an interface in the alarm state within the specified interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.

You can configure the received pause frame alarm parameters in system view and interface view.

·     The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

·     For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

For this command to take effect, you must use the snmp-agent trap enable ifmonitor command to enable the received pause frame alarm function.

When you execute this command multiple times, the most recent configuration takes effect.

Examples

# Set the upper threshold to 90, lower threshold to 50, and statistics collection and comparison interval to 5 seconds for received pause frame alarms on Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] port ifmonitor rx-pause high-threshold 90 low-threshold 50 interval 5

Related commands

snmp-agent trap enable ifmonitor

port ifmonitor tx-pause

Use port ifmonitor tx-pause to configure sent pause frame alarm parameters for an interface.

Use undo port ifmonitor tx-pause to restore the default.

Syntax

port ifmonitor tx-pause high-threshold high-value low-threshold low-value interval interval [ shutdown ]

undo port ifmonitor tx-pause

Default

An interface uses the global sent pause frame alarm parameters.

Views

Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Parameters

high-threshold high-value: Specifies the upper threshold for sent pause frame alarms, in the range of 1 to 4294967295.

low-threshold low-value: Specifies the lower threshold for sent pause frame alarms, in the range of 1 to 4294967295.

interval interval: Specifies the statistics collection and comparison interval for sent pause frame packets, in the range of 1 to 65535 seconds.

shutdown: Shuts down an interface when the number of sent pause frames on the interface exceeds the upper threshold. Then, the interface stops forwarding all packets. To recover the interface, execute the undo shutdown command on the interface. If you do not specify this keyword, an upper threshold exceeding alarm is generated and the interface enters the alarm state when the number of sent pause frames exceeds the upper threshold on the interface, but the interface will not be shut down. If you specify this keyword when the upper threshold has been exceeded on an interface, the interface will be shut down.

Usage guidelines

With the sent pause frame alarm function enabled, when the number of sent pause frame packets on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the number of sent pause frame packets on an interface in the alarm state within the specified interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.

You can configure the sent pause frame alarm parameters in system view and interface view.

·     The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.

·     For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.

For this command to take effect, you must use the snmp-agent trap enable ifmonitor command to enable the sent pause frame alarm function.

When you execute this command multiple times, the most recent configuration takes effect.

Examples

# Set the upper threshold to 50, lower threshold to 40, and statistics collection and comparison interval to 8 seconds for sent pause frame alarms on Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] port ifmonitor tx-pause high-threshold 50 low-threshold 40 interval 8

Related commands

snmp-agent trap enable ifmonitor

port link-flap protect enable

Use port link-flap protect enable to enable link flapping protection on an interface.

Use undo port link-flap protect enable to disable link flapping protection on an interface.

Syntax

port link-flap protect enable [ down-auto-recovery ] [ interval interval | threshold threshold ] * [ second-interval second-interval second-threshold second-threshold ]

undo port link-flap protect enable [ interval | threshold ]

Default

Link flapping protection is disabled on an interface.

Views

Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Parameters

down-auto-recovery: Shuts down an interface when the device detects link flapping. When the port status detection timer set by the shutdown-interval link-flap command expires, the port automatically restores to its actual physical state. If you do not specify this keyword, the system does not automatically restore the interface status, and you must execute the down-auto-recovery command to manually restore the interface status.

interval interval: Specifies the level-1 link flapping detection interval in seconds. The value range for this argument is 5 to 86400. The default value for this argument is 10.

threshold threshold: Specifies the level-1 link flapping detection threshold in the range of 2 to 1200. The default value for this argument is 5.

second-interval interval: Specifies the level-2 link flapping detection interval in seconds. The value range for this argument is 5 to 86400.

second-threshold threshold: Specifies the level-2 link flapping detection threshold in the range of 2 to 1200.

Usage guidelines

Operating mechanism

When you configure this feature on an interface, how link flapping protection is triggered depends on the parameters specified:

·     If you specify level-1 link flapping protection parameters but do not specify level-2 parameters, link flapping protection will be triggered and the interface will be shut down when the level-1 link flapping protection conditions are met.

·     If you specify both level-1 and level-2 link flapping protection parameters, link flapping protection will be triggered and the interface will be shut down when either of level-1 and level-2 link flapping protection conditions are met.

Restrictions and guidelines

Link flapping protection takes effect only when it is enabled in both system view and interface view.

If you specify the down-auto-recovery keyword in both system view and interface view, an interface comes up automatically when the port status detection timer for the ports that are shut down by the link flapping protection feature expires.

If you do not specify the interval interval or threshold threshold option, the command uses the default level-1 link flapping protection settings. If you do not specify the second-interval interval or second-threshold threshold option, the command uses only the level-1 link flapping protection settings.

If you specify the interval or threshold keyword when you execute the undo port link-flap protect enable command, the command restores the default setting for the keyword.

With link flapping protection enabled on an interface, when the interface goes down, the system enables link flapping detection on the interface. During a link flapping detection interval, if the number of detected flaps reaches or exceeds the corresponding link flapping detection threshold, the system shuts down the interface. If you specify both level-1 and level-2 link flapping protection settings, link flapping protection will be triggered and the interface will be shut down when either of level-1 and level-2 link flapping protection conditions are met.

This command, the dampening command, and the link-delay command are mutually exclusive on an Ethernet interface.

Examples

# Enable link flapping protection on an interface. Set the link flapping detection interval to 10 seconds, and set the link flapping detection threshold to 5.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet 3/0/1] port link-flap protect enable interval 10 threshold 5

Related commands

dampening

link-delay

link-flap protect enable

shutdown-interval link-flap

port link-mode

Use port link-mode to change the link mode of an Ethernet interface.

Use undo port link-mode to restore the default.

Syntax

port link-mode { bridge | route }

undo port link-mode

Default

Ethernet interfaces operate in bridge mode.

Views

Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Parameters

bridge: Specifies the Layer 2 mode.

route: Specifies the Layer 3 mode.

Usage guidelines

CAUTION

CAUTION:

Changing the link mode of an Ethernet interface also restores all commands (except description, duplex, jumboframe enable, speed, shutdown, port fec mode) on the Ethernet interface to their defaults in the new link mode.

 

For this switch series, the Ethernet interfaces can operate either as Layer 2 or Layer 3 Ethernet interfaces. You can use this command to set the link mode to bridge or route for these Ethernet interfaces.

Examples

# Configure Ten-GigabitEthernet 3/0/1 to operate in Layer 2 mode.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] port link-mode bridge

The configuration of the interface will be restored to the default. Continue? [Y/N]:y

port transceiver-power-low trigger

Use port transceiver-power-low trigger to enable optical power anomaly detection for an interface.

Use undo port transceiver-power-low trigger to disable optical power anomaly detection for an interface.

Syntax

port transceiver-power-low trigger { down-auto-recovery | error-down }

undo port transceiver-power-low trigger

Default

Optical power anomaly detection is disabled for an interface.

Views

Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Parameters

down-auto-recovery: Shuts down an interface when the optical power is abnormal on the device. When the port status detection timer set by the shutdown-interval transceiver-power-low command expires, the port automatically restores to its actual physical state.

error-down: Shuts down an interface when the optical power is abnormal on the device. Then, the interface stops forwarding all packets. After the optical power returns to normal, you must execute the undo shutdown command to restore the interface status.

Usage guidelines

When the optical power is abnormal on a device, failures such as service flapping might occur. To ensure service continuity, you can enable this feature on an interface. When the optical power is abnormal on an interface, the interface will be shut down and stop sending or receiving packets. Then, you can promptly switch service traffic to other interfaces for processing.

For the optical power anomaly detection feature to take effect, execute the transceiver monitor enable command to enable the transceiver module monitoring feature before you configure this feature. For more information about the transceiver monitor enable command, see Fundamentals Command Reference.

You can use the following methods to restore an interface when that interface is shut down because the port optical power anomaly detection feature detects interface optical power anomalies:

·     Automatic recovery—With the down-auto-recovery keyword specified, the device shuts down the interface when the optical power of a transceiver module is abnormal. When the port status detection timer set by the shutdown-interval transceiver-power-low command expires, the port automatically restores to its actual physical state.

·     Manual recovery—With the error-down keyword specified, the device shuts down the interface when the optical power of a transceiver module is abnormal. After the optical power returns to normal, you must execute the undo shutdown command to restore the interface status.

Examples

# Enable optical power anomaly detection on Ten-GigabitEthernet 3/0/1, and specify the manual interface restoration mode.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] port transceiver-power-low trigger error-down

Related commands

shutdown-interval transceiver-power-low

port up-mode

Use port up-mode to forcibly bring up a fiber Ethernet port.

Use undo port up-mode to restore the default.

Syntax

port up-mode

undo port up-mode

Default

A fiber Ethernet port is not forcibly brought up. The physical state of a fiber port depends on the physical state of the fibers.

Views

Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

This command forcibly brings up a fiber Ethernet port and enables the port to forward packets unidirectionally over a single link. In this way, transmission links are well utilized.

Only GE, 10-GE, 25-GE, and 40-GE fiber ports support this command. Copper ports do not support this command.

The shutdown, port up-mode, and loopback commands are mutually exclusive.

A fiber Ethernet port does not support this command if the port is shut down by a protocol or by using the shutdown command.

A GE fiber port forcibly brought up cannot correctly forward traffic if it is installed with a fiber-to-copper converter, 100/1000-Mbps transceiver module, or 100-Mbps transceiver module. To solve the problem, use the undo port up-mode command on the fiber port.

Examples

# Forcibly bring up fiber port Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] port up-mode

lbn-group

Use lbn-group to create an LBN group and enter its view.

Use undo lbn-group to delete an LBN group.

Syntax

lbn-group group-name

undo lbn-group group-name

Views

System view

Default

No LBN group exists.

Predefined user roles

network-admin

mdc-admin

Parameters

group-name: Specifies an LBN group name, a case-sensitive string of 1 to 31 characters.

Usage guidelines

The LBN group feature assigns different incoming interfaces on the device to an LBN group and assigns indexes to these interfaces. The device distributes traffic across various interfaces based on their configured index values by using a specific algorithm. Traffic that arrives at different incoming interfaces is then forwarded through different outgoing interfaces, achieving traffic load sharing.

Examples

# Create an LBN group named test and enter its view.

<Sysname> system-view

[Sysname] lbn-group test

[Sysname-lbn-group-test]

reset counters interface

Use reset counters interface to clear the interface statistics.

Syntax

reset counters interface [ interface-type [ interface-number | interface-number.subnumber ] ]

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

interface-type: Specifies an interface type.

interface-number: Specifies an interface number.

interface-number.subnumber: Specifies a subinterface number. The interface-number argument is an interface number. The subnumber argument is the number of a subinterface created under the interface. The value range for the subnumber argument is 1 to 4094.

Usage guidelines

Use this command to clear history statistics if you want to collect traffic statistics for a specific time period.

If you do not specify an interface type, this command clears statistics for all interfaces.

If you specify an interface type but do not specify an interface number, this command clears statistics for all interfaces of the specified type.

Examples

# Clear the statistics for Ten-GigabitEthernet 3/0/1.

<Sysname> reset counters interface ten-gigabitethernet 3/0/1

Related commands

display counters interface

display counters rate interface

display interface

reset counters mib interface

Use reset counters interface to clear the interface statistics on MIB.

Syntax

reset counters mib interface [ interface-type [ interface-number | interface-number.subnumber ] ]

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

interface-type: Specifies an interface type.

interface-number: Specifies an interface number.

interface-number.subnumber: Specifies a subinterface number. The interface-number argument is an interface number. The subnumber argument is the number of a subinterface created under the interface. The value range for the subnumber argument is 1 to 4094.

Usage guidelines

Use this command to clear the MIB node information related to packet statistics in the fTable and ifXTable tables. The ifTable and ifXTable tables are two table nodes defined in the IF-MIB file, which contain multiple leaf nodes for obtaining packet statistics about interfaces.

Use this command to clear history statistics on MIB if you want to collect traffic statistics for a specific time period.

If you do not specify an interface type, this command clears statistics for all interfaces except VA interfaces on MIB.

If you specify an interface type but do not specify an interface number, this command clears statistics for all interfaces of the specified type on MIB.

Examples

# Clear the statistics on MIB for Ten-GigabitEthernet 3/0/1.

<Sysname> reset counters interface ten-gigabitethernet 3/0/1

reset counters slot

Use reset counters slot to clear statistics on cards and statistics on the interfaces on the cards.

Syntax

In standalone mode:

reset counters slot [ slot-number ]

In IRF mode:

reset counters chassis [ chassis-number [ slot slot-number ] ]

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command clears statistics for all cards. (In standalone mode.)

chassis [ chassis-number [ slot slot-number ] ]: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a member device, this command applies to all cards of all member devices. If you do not specify a card, this command applies to all the member devices. (In IRF mode.)

Examples

# Clear the card statistics and interface statistics on card slot 1.

<Sysname> reset counter slot 1

 

reset ethernet statistics

Use reset ethernet statistics to clear the Ethernet module statistics.

Syntax

In standalone mode:

reset ethernet statistics [ slot slot-number ]

In IRF mode:

reset ethernet statistics [ chassis chassis-number slot slot-number ]

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command clears statistics for all cards. (In standalone mode.)  

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command clears statistics for all cards of all IRF member devices. (In IRF mode.)

Examples

# (In standalone mode.) Clear the Ethernet module statistics for the specified slot.

<Sysname> reset ethernet statistics slot 1

Related commands

display ethernet statistics

reset link-state-change statistics interface

Use reset link-state-change statistics interface to clear link state change statistics of interfaces.

Syntax

reset link-state-change statistics interface [ interface-type [ interface-number ] ]

Default

Link state change statistics of an interface are not cleared.

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

interface-type: Specifies an interface type.

interface-number: Specifies an interface number.

Usage guidelines

If you do not specify an interface type, this command clears the link state change statistics for all interfaces.

If you specify an interface type but do not specify an interface number, this command clears the link state change statistics for all interfaces of the specified type.

Examples

# Clear the link state change statistics of Ten-GigabitEthernet 3/0/1.

<Sysname> reset link-state-change statistics interface ten-gigabitethernet 3/0/1

Related commands

display link-state-change statistics interface

shutdown

Use shutdown to shut down an Ethernet interface or subinterface.

Use undo shutdown to bring up an Ethernet interface or subinterface.

Syntax

shutdown

undo shutdown

Default

Ethernet interfaces and subinterfaces are in up state.

Views

Ethernet interface view

Ethernet subinterface view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

CAUTION

CAUTION:

Executing the shutdown command on an interface will disconnect the link of the interface and interrupt communication. Use this command with caution.

Some interface configurations might require an interface restart before taking effect.

The shutdown, port up-mode, and loopback commands are mutually exclusive.

Examples

# Shut down and then bring up Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] shutdown

[Sysname-Ten-GigabitEthernet3/0/1] undo shutdown

shutdown all-physical-interfaces

Use shutdown all-physical-interfaces to shut down all physical interfaces except management Ethernet interfaces.

Use undo shutdown all-physical-interfaces to bring up all physical interfaces except management Ethernet interfaces.

Syntax

shutdown all-physical-interfaces [ include irf-physical-interface ]

undo shutdown all-physical-interfaces

Default

Physical interfaces are up.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

include irf-physical-interface: Shuts down all physical interfaces including the IRF physical interfaces. If you do not specify this keyword, this command does not shut down IRF physical interfaces.

Usage guidelines

With the shutdown all-physical-interfaces command, you can shut down all physical interfaces except the management Ethernet interfaces on the device. Physical interfaces shut down by using this command are in ADM state.

To shut down all physical interfaces or the specified interface, execute the shutdown all-physical-interfaces command in system view or execute the shutdown command in interface view.

To bring up interfaces shut down by using the shutdown all-physical-interfaces command, execute its undo form in system view. To bring up an interface shut down by using the shutdown command, execute its undo form in interface view.

If you execute this command with the include irf-physical-interface keyword multiple times, this command shuts down all physical interfaces except the management Ethernet interfaces on the device.

Examples

# Shut down all physical interfaces except management Ethernet interfaces and IRF physical interfaces.

<Sysname> system-view

[Sysname] shutdown all-physical-interfaces

Executing this command will shut down all physical ports on the device except for the management Ethernet interface and IRF physical interface. The interface status will change to ADM. Continue? [Y/N]:y

# Shut down all physical interfaces except management Ethernet interfaces.

<Sysname> system-view

[Sysname] shutdown all-physical-interfaces include irf-physical-interface

Execute this command to shut down all physical ports on the device except for the management Ethernet interface, the interface status will change to ADM. Continue? [Y/N]:y

# Bring up all physical interfaces except management Ethernet interfaces.

<Sysname> system-view

[Sysname] undo shutdown all-physical-interfaces

Execute this command will enable the interfaces that were shut down by the shutdown all-physical-interfaces command. Continue? [Y/N]:y

Related commands

shutdown

shutdown-interval crc-error

Use shutdown-interval crc-error to set the port status detection timer for the ports that are shut down by the CRC error packet alarm feature.

Use undo shutdown-interval crc-error to restore the default.

Syntax

shutdown-interval [ crc-error ] interval

undo shutdown-interval [ crc-error ]

Default

The port status detection timer is 30 seconds.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

crc-error: Specifies the CRC error packet alarm feature. If you do not specify this keyword, the port status detection timer configured by this command takes effect for all features that support the shutdown-interval command, for example, the CRC error packet alarm feature.

interval: Specifies the port status detection timer, in the range of 0 to 300 seconds. When the value is 0, the system does not automatically restore the interface status, and you must execute the undo shutdown command to manually restore the interface status.

Usage guidelines

Operating mechanism

When a port is shut down automatically by a feature, the device starts a port status detection timer. When the timer expires, the device restores the port status to its actual physical status automatically.

If you change the timer setting during port detection, the device compares the new setting (T1) with the time that elapsed since the port was shut down (T).

·     If T < T1, the port will be brought up after T1 – T seconds.

·     If T ≥ T1, the port is brought up immediately.

For example, the timer setting is 30 seconds. If you change it to 10 seconds 2 seconds after the port is shut down, the port will come up 8 seconds later. If you change the timer setting to 2 seconds 10 seconds after the port is shut down, the port comes up immediately.

Restrictions and guidelines

The ifmonitor crc-error command takes effect only if you specify the down-auto-recovery keyword.

Examples

# Set the port status detection timer to 100 seconds for the ports that are shut down by the CRC error packet alarm feature.

<Sysname> system-view

[Sysname] shutdown-interval crc-error 100

Related commands

ifmonitor crc-error

shutdown-interval link-flap

Use shutdown-interval link-flap to set the port status detection timer for the ports that are shut down by the link flapping protection feature.

Use undo shutdown-interval link-flap to restore the default.

Syntax

shutdown-interval [ link-flap ] interval

undo shutdown-interval [ link-flap ]

Default

The port status detection timer is 30 seconds.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

link-flap: Specifies the link flapping protection feature. If you do not specify this keyword, the port status detection timer configured by this command takes effect for all features that support the shutdown-interval command, for example, the CRC error packet alarm feature.

interval: Specifies the port status detection timer, in the range of 0 to 300 seconds. When the value is 0, the system does not automatically restore the interface status, and you must execute the undo shutdown command to manually restore the interface status.

Usage guidelines

Operating mechanism

When a port is shut down automatically by a feature, the device starts a port status detection timer. When the timer expires, the device restores the port status to its actual physical status automatically.

If you change the timer setting during port detection, the device compares the new setting (T1) with the time that elapsed since the port was shut down (T).

·     If T < T1, the port will be brought up after T1 – T seconds.

·     If T ≥ T1, the port is brought up immediately.

For example, the timer setting is 30 seconds. If you change it to 10 seconds 2 seconds after the port is shut down, the port will come up 8 seconds later. If you change the timer setting to 2 seconds 10 seconds after the port is shut down, the port comes up immediately.

Restrictions and guidelines

The ifmonitor crc-error command takes effect only if you specify the down-auto-recovery keyword.

Examples

# Set the port status detection timer to 100 seconds for the ports that are shut down by the link flapping protection feature.

<Sysname> system-view

[Sysname] shutdown-interval link-flap 100

Related commands

port link-flap protect enable

shutdown-interval transceiver-power-low

Use shutdown-interval transceiver-power-low to set the port status detection timer for the ports that are shut down by the optical power anomaly detection feature.

Use undo shutdown-interval transceiver-power-low to restore the default.

Syntax

shutdown-interval [ transceiver-power-low ] interval

undo shutdown-interval [ transceiver-power-low ]

Default

The port status detection timer is 30 seconds.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

transceiver-power-low: Specifies the optical power anomaly detection feature. If you do not specify this keyword, the port status detection timer configured by this command takes effect for all features that support the shutdown-interval command, for example, the CRC error packet alarm feature.

interval: Specifies the port status detection timer, in the range of 0 to 300 seconds. When the value is 0, the system does not automatically restore the interface status, and you must execute the undo shutdown command to manually restore the interface status.

Usage guidelines

Operating mechanism

When a port is shut down automatically by a feature, the device starts a port status detection timer. When the timer expires, the device restores the port status to its actual physical status automatically.

If you change the timer setting during port detection, the device compares the new setting (T1) with the time that elapsed since the port was shut down (T).

·     If T < T1, the port will be brought up after T1 – T seconds.

·     If T ≥ T1, the port is brought up immediately.

For example, the timer setting is 30 seconds. If you change it to 10 seconds 2 seconds after the port is shut down, the port will come up 8 seconds later. If you change the timer setting to 2 seconds 10 seconds after the port is shut down, the port comes up immediately.

Restrictions and guidelines

The ifmonitor crc-error command takes effect only if you specify the down-auto-recovery keyword.

Examples

# Set the port status detection timer to 100 seconds for the ports that are shut down by the optical power anomaly detection feature.

<Sysname> system-view

[Sysname] shutdown-interval transceiver-power-low 100

Related commands

port transceiver-power-low trigger

slot-monitor packet-drop

Use slot-monitor packet-drop to configure packet-drop alarm parameters for a specified card or all cards.

Use undo slot-monitor packet-drop to restore the default.

Syntax

In standalone mode:

slot-monitor packet-drop [ slot slot-number ] high-threshold high-threshold-value low-threshold low-threshold-value interval interval [ shutdown | reboot ]

undo slot-monitor packet-drop slot slot-number

In IRF mode:

slot-monitor packet-drop [ chassis chassis-number slot slot-number ] high-threshold high-threshold-value low-threshold low-threshold-value interval interval [ shutdown | reboot ]

undo slot-monitor packet-drop chassis chassis-number slot slot-number

Default

The upper threshold is 1000000, the lower threshold is 100, and the statistics collection and comparison interval is 30 seconds.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

high-threshold high-value: Specifies the upper packet-drop alarm threshold, in the range of 1 to 4294967295 packets.

low-threshold low-value: Specifies the lower packet-drop alarm threshold, in the range of 1 to 4294967295 packets.

interval interval: Specifies the statistics collection and comparison interval, in the range of 1 to 65535 seconds.

shutdown: Shuts down all interfaces on a card when the number of dropped packets on that card crosses the upper threshold. Then, the card stops forwarding all packets. To recover the interfaces, execute the undo shutdown command. If you do not specify this keyword, an upper threshold crossing alarm is generated and the card enters alarm state when the number of dropped packets crosses the upper threshold on the card.

reboot: Reboots a card when the number of dropped packets on that card crosses the upper threshold. If you do not specify this keyword, the card generates an upper threshold crossing alarm and enters alarm state.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command clears statistics for all cards. (In standalone mode.)

chassis [ chassis-number [ slot slot-number ] ]: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify this option, this command applies to all the cards. (In IRF mode.)

Usage guidelines

With this feature configured, when the number of dropped packets on a card crosses the upper threshold within the specified interval, the card generates an alarm and enters alarm state. When the number of dropped packets on that card drops below the lower threshold within the specified interval, the card generates a recovery alarm and restores to normal state.

If you do not specify the slot-number argument, this command takes effect on all slots. If you specify the slot-number argument, this command takes effect on the specified slot. If you configure both the slot-monitor packet-drop and slot-monitor packet-drop slot commands for a slot, the slot-monitor packet-drop slot command takes effect.

Examples

# Set the upper threshold to 5000, lower threshold to 400, and statistics collection and comparison interval to 60 seconds for packet-drop alarms.

<Sysname> system-view

[Sysname] slot-monitor packet-drop slot 1 high-threshold 5000 low-threshold 1000 interval 60 shutdown

Related commands

snmp-agent trap enable slot-monitor

snmp-agent trap enable eth

Use snmp-agent trap enable eth to enable SNMP notifications for the ETH module.

Use undo snmp-agent trap enable eth to disable SNMP notifications for the ETH module.

Syntax

snmp-agent trap enable eth

undo snmp-agent trap enable eth

Default

SNMP notifications are disabled for the ETH module.

Views

System view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

To report critical ETH events to an SNMP NMS, enable SNMP notifications for the ETH module.

For ETH SNMP notifications to be sent correctly, you must also configure SNMP on the device. For more information about SNMP configuration, see SNMP configuration in Network Management and Monitoring Configuration Guide.

Examples

# Enable SNMP notifications for the ETH module.

<Sysname> system-view

[Sysname] snmp-agent trap enable eth

snmp-agent trap enable ifmonitor

Use snmp-agent trap enable ifmonitor to enable interface alarm functions.

Use undo snmp-agent trap enable ifmonitor to disable interface alarm functions.

Syntax

snmp-agent trap enable ifmonitor [ crc-error | input-error | input-usage | output-error | output-usage | rx-pause | tx-pause ] *

undo snmp-agent trap enable ifmonitor [ crc-error | input-error | input-usage | output-error | output-usage | rx-pause | tx-pause ] *  

Default

All interface alarm functions are enabled.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

crc-error: Enables the input CRC error packet alarm function for interfaces. With the CRC error packet alarm function enabled, when the number of incoming CRC error packets on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters alarm state. When the number of incoming CRC error packets on an interface in the alarm state within the specified interval drops below the lower threshold, the interface generates a recovery alarm and restores to normal state.

giant: Enables the giant packet alarm function for interfaces.

input-buffer-drop: Enables the packet-drop alarm function for the ingress buffer.

input-error: Enables the input error packet alarm function for interfaces. With the input error packet alarm function enabled, when the number of input error packets on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters alarm state. When the number of input error packets on an interface in the alarm state within the specified interval drops below the lower threshold, the interface generates a recovery alarm and restores to normal state.

input-usage: Enables the input bandwidth usage alarm function for interfaces. With the input bandwidth usage alarm function enabled, when the input bandwidth usage on an interface in normal state within the most recent statistics polling interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters alarm state. When the input bandwidth usage on an interface in the alarm state within the most recent statistics polling interval drops below the lower threshold, the interface generates a recovery alarm and restores to normal state.

output-buffer-drop: Enables the packet-drop alarm function for the egress buffer.

output-error: Enables the output error packet alarm function for interfaces. With the output error packet alarm function enabled, when the number of output error packets on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters alarm state. When the number of output error packets on an interface in the alarm state within the specified interval drops below the lower threshold, the interface generates a recovery alarm and restores to normal state.

output-usage: Enables the output bandwidth usage alarm function for interfaces. With the output bandwidth usage alarm function enabled, when the output bandwidth usage on an interface in normal state within the most recent statistics polling interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters alarm state. When the output bandwidth usage on an interface in the alarm state within the most recent statistics polling interval drops below the lower threshold, the interface generates a recovery alarm and restores to normal state.

runt: Enables the runt packet alarm function for interfaces.

rx-pause: Enables the received pause frame alarm function for interfaces. guidelines With the received pause frame alarm function enabled, when the number of received pause frames on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters alarm state. When the number of received pause frames on an interface in the alarm state within the specified interval drops below the lower threshold, the interface generates a recovery alarm and restores to normal state.

tx-pause: Enables the sent pause frame alarm function for interfaces. With the sent pause frame alarm function enabled, when the number of sent pause frames on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters alarm state. When the number of sent pause frames on an interface in the alarm state within the specified interval drops below the lower threshold, the interface generates a recovery alarm and restores to normal state.

buffer-usage: Enables the sent traffic congestion alarm function for interfaces. With the sent traffic congestion alarm function enabled, when the buffer usage of an interface in normal state reaches the upper threshold, the interface generates an upper threshold exceeding alarm and enters alarm state. When the buffer usage of an interface in the alarm state drops below the lower threshold, the interface generates a recovery alarm and restores to normal state. 

Usage guidelines

Operating mechanism

With interface alarm functions enabled, when the number of incoming or outgoing error packets or the bandwidth usage on an interface exceeds the upper threshold or drops below the lower threshold, the interface generates an alarm. Error packets include CRC error packets, error packets, pause frames, SDH-B1 error packets, SDH-B2 error packets, and SDH error packets.

Prerequisites

To report critical interface events to an NMS, enable SNMP notifications for Ethernet interfaces. For interface alarms to be sent correctly, you must also configure SNMP as described in Network Management and Monitoring Configuration Guide.

For more information about the alarm thresholds, see the commands listed in related commands.

Restrictions and guidelines

If you do not specify any parameters, this feature enables or disables all alarm functions on interfaces. If you specify a parameter, this feature enables only the alarm function specified by that parameter.

Examples

# Enable the CRC error packet alarm function for interfaces.

<Sysname> system-view

[Sysname] snmp-agent trap enable ifmonitor crc-error

Related commands

ifmonitor crc-error

ifmonitor input-error

ifmonitor input-usage

ifmonitor output-error

ifmonitor output-usage

ifmonitor rx-pause

ifmonitor sdh-b1-error

ifmonitor sdh-b2-error

ifmonitor sdh-error

ifmonitor tx-pause

port ifmonitor crc-error

port ifmonitor input-error

port ifmonitor input-usage

port ifmonitor output-error

port ifmonitor output-usage

port ifmonitor rx-pause

port ifmonitor tx-pause

snmp-agent trap enable slot-monitor

Use snmp-agent trap enable slot-monitor to enable SNMP notifications for cards.

Use undo snmp-agent trap enable slot-monitor to disable SNMP notifications for cards.

Syntax

snmp-agent trap enable slot-monitor [ packet-drop ]

undo snmp-agent trap enable slot-monitor [ packet-drop ]

Default

SNMP notifications are enabled for cards.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

packet-drop: Enables SNMP notifications for packet-drop on cards.

Examples

# Enable SNMP notifications for packet-drop on cards.

<Sysname> system-view

[Sysname] snmp-agent trap enable slot-monitor packet-drop

speed

Use speed to set the speed of an Ethernet interface.

Use undo speed to restore the default.

Syntax

speed { 10 | 100 | 1000 | 2500 | 10000 | 40000 | 100000 | auto

undo speed

Default

A management Ethernet fiber interface operates at a speed of 1000 Mbps. Other Ethernet interfaces negotiate a speed with the peer.

Views

Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Parameters

10: Sets the interface speed to 10 Mbps.

100: Sets the interface speed to 100 Mbps.

1000: Sets the interface speed to 1000 Mbps.

2500: Sets the interface speed to 2500 Mbps.

10000: Sets the interface speed to 10000 Mbps.

40000: Sets the interface speed to 40000 Mbps.

100000: Sets the interface speed to 100000 Mbps.

auto: Enables the interface to negotiate a speed with its peer.

Usage guidelines

For an Ethernet copper port, use the speed command to set its speed to match the speed of the peer interface. Support of copper ports for keywords of this command varies by copper port type. For more information, use the speed ? command in interface view. If the system does not prompt that operation failed when you configure a speed for a copper port, the copper port supports this speed. Otherwise, the copper port does not support this speed.

For a fiber port, use the speed command to set its speed to match the rate of a transceiver module. Support of fiber ports for keywords of this command varies by fiber port type. For more information, use the speed ? command in interface view. If the system does not prompt that operation failed when you configure a speed for a fiber port, the fiber port supports this speed. Otherwise, the fiber port does not support this speed.

Additionally, you must select a speed for a fiber port according to the transceiver module installed to ensure that the transceiver module can be used properly. If the transceiver module installed in a fiber port does not support the speed for the fiber port, the transceiver module cannot be used. For example, if the transceiver module installed in an SFP+ fiber port is an SFP GE transceiver module and the speed 10000 command is executed on the fiber port or the transceiver module installed in an SFP+ fiber port is a 10-GE transceiver module and the speed 1000 command is executed on the fiber port, the transceiver module cannot be used.

Only SC cards prefixed with LSCM2, SD interface modules, and SF interface modules support the speed 2500 command.

The following interfaces do not support the speed command:

·     10-GE breakout interfaces split from a 100-GE or a 40-GE interface.

·     25-GE breakout interfaces split from a 100-GE interface.

Examples

# Configure Ten-GigabitEthernet 3/0/1 to autonegotiate the speed.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] speed auto

Related commands

speed auto

traffic-statistic include-interframe

Use traffic-statistic include-interframe to enable interframe gap and preamble statistics in the traffic statistics.

Use traffic-statistic include-interframe to restore the default.

Syntax

traffic-statistic include-interframe

undo traffic-statistic include-interframe

Default

Interframe gap and preamble statistics in the traffic statistics are disabled.

Views

Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

If you execute the display interface command, the Last 300 seconds input rate or Last 300 seconds output rate field in the command output displays the average outbound or inbound traffic rate in the last 300 seconds.

By default, traffic rate = native frame length × packet count per second. Execute the traffic-statistic include-interframe command if you need the total traffic statistics, including the native frame length, interframe gap length, and preamble length, for a specific time period. With this command executed, traffic rate = (native frame length + interframe gap length + preamble length) × packet throughput per second.

In aggregate interface view, this command takes effect on all Ethernet interfaces in the aggregation group. When an Ethernet interface joins an aggregation group, it uses the configuration of this command for the aggregation group. When an Ethernet interface leaves an aggregation group, it reverts to the configuration before it joins the aggregation group.

If you configure this command on both an Ethernet interface and an aggregation interface, the device clears the interface's statistics when the command is deployed for the first time. Reconfiguring this command will not clear the statistics. You do not need to configure this command when an interface joins or leaves an aggregation group, and the system will automatically clear the interface's statistics.

Examples

# Enable interframe gap and preamble statistics in the traffic statistics for Ten-GigabitEthernet3/0/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] traffic-statistic include-interframe

Set traffic statistic to include Inter-frame Gaps and Preambles, and clear the statistics count. Continue? [Y/N]:y

# Enable interframe gap and preamble statistics in the traffic statistics for Ten-GigabitEthernet3/0/1 Ten-GigabitEthernet3/0/1after it is assigned to an aggregation group.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] traffic-statistic include-interframe

Set traffic statistic to include Inter-frame Gaps and Preambles, and clear the statistics count. Continue? [Y/N]:y

This configuration takes effect on the port only when the port joins or leaves the aggregation group.

Related commands

display interface

unicast-suppression

Use unicast-suppression to enable unknown unicast storm suppression and set the unknown unicast storm suppression threshold.

Use undo unicast-suppression to disable unknown unicast storm suppression.

Syntax

unicast-suppression { ratio | pps max-pps | kbps max-kbps }

undo unicast-suppression

Default

Ethernet interfaces do not suppress unknown unicast traffic.

Views

Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Parameters

ratio: Sets the unknown unicast suppression threshold as a percentage of the interface bandwidth. The value range for this argument (in percentage) is 0 to 100. A smaller value means that less unknown unicast traffic is allowed to pass through.

pps max-pps: Specifies the maximum number of unknown unicast packets that the interface can forward per second. The value range for the max-pps argument (in pps) is 0 to 1.4881 × the interface bandwidth.

kbps max-kbps: Specifies the maximum number of kilobits of unknown unicast traffic that the Ethernet interface can forward per second. The value range for this argument (in kbps) is 0 to the interface bandwidth.

 Usage guidelines

The unknown unicast storm suppression feature limits the size of unknown unicast traffic to a threshold on an interface. When the unknown unicast traffic on the interface exceeds this threshold, the system discards packets until the unknown unicast traffic drops below this threshold.

Both the storm-constrain command and the unicast-suppression command can suppress unknown unicast storms on a port. The unicast-suppression command uses the chip to physically suppress unknown unicast traffic. It has less influence on the device performance than the storm-constrain command, which uses software to suppress unknown unicast traffic.

For the unknown unicast traffic suppression result to be determined, do not configure both the storm-constrain unicast command and the unicast-suppression command on an interface.

The configured suppression threshold value in pps or kbps might be converted into a multiple of a step supported by the chip. To determine the suppression threshold that takes effect, see the prompts on the device.

After you configure this command, the effective suppression threshold might have a 5% difference from the output of the display interface command.

Examples

# Set the unknown unicast storm suppression threshold to 10000 kbps on Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] unicast-suppression kbps 10000

The actual value is 9984 on port Ten-GigabitEthernet3/0/1 currently.

For the SC and SD modules prefixed with LSCM2, the output shows that the value that takes effect is 9984 kbps.

Related commands

broadcast-suppression

multicast-suppression

using fortygige

Use using fortygige to combine 10-GE breakout interfaces split from a 40-GE interface into a 40-GE interface.

Use undo using fortygige to cancel the configuration.

 

IMPORTANT

IMPORTANT:

Only 40-GE interfaces on the LSCM1QGS8CSSE0 and LSCM3QGS8CSSE0 interface modules support this command.

 

Syntax

using fortygige

undo using fortygige

Default

The 10-GE breakout interfaces are not combined and operate as single interfaces.

Views

10-GE breakout interface view

Predefined user roles

network-admin

Usage guidelines

This command is not supported on non-default MDCs.

If you need higher bandwidth on a single interface, you can combine four 10-GE breakout interfaces split from a 40-GE interface into a 40-GE interface. To do so, execute this command on any of these 10-GE breakout interfaces.

To have this command take effect, save the configuration and reboot the card after you execute this command.

Examples

# Combine Ten-GigabitEthernet 1/0/1:1 through Ten-GigabitEthernet 1/0/1:4 into a 40-GE interface.

<System> system-view

[System] interface ten-gigabitethernet1/0/1:1

[System-Ten-GigabitEthernet1/0/1:1] using fortygige

The interfaces Ten-GigabitEthernet1/0/1:1 through Ten-GigabitEthernet1/0/1:4 will be deleted. Continue? [Y/N]:y

Reboot the LPU to make the configuration take effect.

Related commands

using tengige

using hundredgige

Use using hundredgige to combine breakout interfaces split from a 100-GE interface into a 100-GE interface,.

Use undo using hundredgige to cancel the operation of combining breakout interface,

 

IMPORTANT

IMPORTANT:

The LSCM1QGS8CSSE0 and LSCM3QGS8CSSE0 interface modules do not support this command.

 

Syntax

using hundredgige

undo using hundredgige

Default

The breakout interfaces are not combined and operate as single interfaces.

Views

10-GE breakout interface view

25-GE breakout interface view

Predefined user roles

network-admin

Usage guidelines

This command is not supported on non-default MDCs.

If you need higher bandwidth on a single interface, perform the following tasks as needed:

·     You can combine ten or twelve 10-GE breakout interfaces split from a 100-GE interface into a 100-GE interface. To do so, execute this command on any of these 10-GE breakout interfaces.

·     You can combine four 25-GE breakout interfaces split from a 100-GE interface into a 100-GE interface. To do so, execute this command on any of these 25-GE breakout interfaces.

·     You can combine two 50-GE breakout interfaces split from a 100-GE interface into a 100-GE interface. To do so, execute this command on any of these 50-GE breakout interfaces.

·     You can restore a 40-GE interface that was changed from a 100-GE interface to a 100-GE interface. This command is only supported on a 40-GE interface that was changed from a 100-GE interface.

Device reboot is required for this command to take effect.

Examples

# Combine Ten-GigabitEthernet 1/0/1:1 through Ten-GigabitEthernet 1/0/1:4 into a 100-GE interface.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 1/0/1:1

[Sysname-Ten-GigabitEthernet1/0/1:1]using hundredgige

The interfaces Ten-GigabitEthernet1/0/1:1 through Ten-GigabitEthernet1/0/1:4 will be deleted. Continue? [Y/N]:y

 

Reboot device to make the configuration take effect.

# Combine Twenty-FiveGigE 1/0/1:1 through Twenty-FiveGigE 1/0/1:4 into a 100-GE interface.

<Sysname> system-view

[Sysname] interface twenty-fivegige 1/0/1:1

[Sysname-Twenty-FiveGigE1/0/1:1] using hundredgige

The interfaces Twenty-FiveGigE 1/0/1:1 through Twenty-FiveGigE 1/0/1:4 will be deleted. Continue? [Y/N]:y

Reboot device to make the configuration take effect.

Related commands

using fiftygige

using fortygige

using fourhundredgige

using tengige

using twenty-fivegige

using twohundredgige

using tengige

Use using tengige to split a high bandwidth interface into multiple 10-GE breakout interfaces.

Use undo using tengige to cancel the configuration.

 

IMPORTANT

IMPORTANT:

Only 40-GE interfaces on the LSCM1QGS8CSSE0 and LSCM3QGS8CSSE0 interface modules support this command.

 

Syntax

using tengige

undo using tengige

Default

A high bandwidth interface is not split and operates as a single interface.

Views

40-GE interface view

Predefined user roles

network-admin

Usage guidelines

This command is not supported on non-default MDCs.

To improve port density, reduce costs, and improve network flexibility, you can split a high bandwidth interface into multiple 10-GE breakout interfaces. For example:

·     Split 40-GE interface FortyGigE 1/0/1 into four 10-GE breakout interfaces Ten-GigabitEthernet 1/0/1:1 through Ten-GigabitEthernet 1/0/1:4.

The 10-GE breakout interfaces and the common 10-GE interfaces are numbered in a different way. The 10-GE breakout interfaces do not support the speed keyword.

To have this command take effect, save the configuration and reboot the device after you execute this command.

Examples

# Split FortyGigE 1/0/1 into four 10-GE breakout interfaces.

<System> system-view

[System] interface fortygige 1/0/1

[System-FortyGigE1/0/1] using tengige

The interface FortyGigE1/0/1 will be deleted. Continue? [Y/N]:y

Reboot the LPU to make the configuration take effect.

Related commands

using fortygige

using fourhundredgige

using twohundredgige

using twenty-fivegige

Use using twenty-fivegige to split a high-bandwidth interface into multiple 25-GE breakout interfaces.

Use undo using twenty-fivegige to cancel the configuration.

 

IMPORTANT

IMPORTANT:

The LSCM1QGS8CSSE0 and LSCM3QGS8CSSE0 interface modules do not support this command.

 

Syntax

using twenty-fivegige

undo using twenty-fivegige

Default

A high-bandwidth interface is not split and operates as a single interface.

Views

100-GE interface view

Predefined user roles

network-admin

Usage guidelines

This command is not supported on non-default MDCs.

To improve port density, reduce costs, and improve network flexibility, you can split a 100-GE interface into four 25-GE breakout interfaces. For example, you can split the 100-GE interface HundredGigE 1/0/1 into four 25-GE breakout interfaces Twenty-FiveGigE 1/0/1:1 through Twenty-FiveGigE 1/0/1:4.

The 25-GE breakout interfaces and the command 25-GE interfaces are numbered in a different way. The breakout interfaces do not support the speed keyword.

After executing this command, you must save the configuration and reboot the interface card.

Examples

# Split HundredGigE 1/0/1 into four 25-GE breakout interfaces.

<Sysname> system-view

[Sysname] interface hundredgige 1/0/1

[Sysname-HundredGigE1/0/1] using twenty-fivegige

The interface HundredGigE1/0/1 will be deleted. Continue? [Y/N]:y

Reboot the LPU to make the configuration take effect.

Related commands

using hundredgige

 

Layer 2 Ethernet interface commands

display storm-constrain

Use display storm-constrain to display storm control settings and statistics.

Syntax

display storm-constrain [ broadcast | multicast | unicast ] [ interface interface-type interface-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

broadcast: Displays broadcast storm control settings and statistics.

multicast: Displays multicast storm control settings and statistics.

unicast: Displays unknown unicast storm control settings and statistics.

interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify this option, the command displays storm control settings and statistics for all storm control-enabled interfaces.

Usage guidelines

If you do not specify any keywords, this command displays all storm control settings on all storm control-enabled interfaces.

Examples

# Display the storm control settings on all storm control-enabled ports.

<Sysname> display storm-constrain

 Abbreviation: BC - broadcast; MC - multicast; UC - unknown unicast;

               KNUC - known unicast; FW - forwarding

 Flow Statistic Interval: 5 (in seconds)

Port          Type Lower     Upper     Unit  Mode     Status   Trap Log StateChg

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

XGE3/0/1      MC   100       200       kbps  shutdown shutdown off  on  10

Table 12 Command output

Field

Description

Flow Statistic Interval

Traffic polling interval (in seconds) of the storm control module.

Port

Abbreviated interface name.

Type

Type of traffic subjected to storm control:

·     BC—Broadcast packets.

·     MC—Multicast packets.

·     UC—Unknown unicast packets.

·     KNUC—Known unicast packets. (This field is not supported in the current software version.)

Lower

Lower storm control threshold, in pps, kbps, or percentage.

Upper

Upper storm control threshold, in pps, kbps, or percentage.

Unit

Storm control threshold unit:

·     pps.

·     kbps.

·     percentage.

Mode

Action (block or shutdown) taken on the interface when the upper threshold is reached. N/A indicates that no action is configured.

Status

Packet forwarding status:

·     FW—The port is forwarding traffic correctly.

·     shutdown—The port has been shut down.

·     block—The port drops the type of traffic.

Trap

Status of the storm control threshold event trap switch:

·     on—The port sends threshold event traps.

·     off—The port does not send threshold event traps.

Log

Status of the storm control threshold event log switch:

·     on—The port sends threshold event log messages.

·     off—The port does not send threshold event log messages.

StateChg

Number of forwarding state changes of the interface.

When the StateChg field reaches 65535, it resets automatically.

mdix-mode

IMPORTANT

IMPORTANT:

Fiber ports do not support this command.

Use mdix-mode to configure the Medium Dependent Interface Cross-Over (MDIX) mode of an Ethernet interface.

Use undo mdix-mode to restore the default.

Syntax

mdix-mode { automdix | mdi| mdix }

undo mdix-mode

Default

Ethernet interfaces operate in automdix mode.

Views

Layer 2 Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Parameters

automdix: Specifies that the interface negotiates pin roles with its peer.

mdi: Specifies that pins 1 and 2 are transmit pins and pins 3 and 6 are receive pins.

mdix: Specifies that pins 1 and 2 are receive pins and pins 3 and 6 are transmit pins.

Examples

# Configure Ten-GigabitEthernet 3/0/1 to operate in automdix mode.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] mdix-mode automdix

port bridge enable

Use port bridge enable to enable bridging on an Ethernet interface.

Use undo port bridge enable to disable bridging on an Ethernet interface.

Syntax

port bridge enable

undo port bridge enable

Default

Bridging is disabled on an Ethernet interface.

Views

Layer 2 Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

By default, the device drops packets whose outgoing interface and incoming interface are the same.

To enable the device to forward such packets rather than drop them, configure this command in Ethernet interface view. After the device receives a broadcast or unknown unicast packet, the device forwards the packet through all interfaces in the VLAN to which the incoming interface of the packet belongs.

Do not add interfaces configured with this command to an aggregation group.

Examples

# Enable bridging on Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] port bridge enable

speed auto

Use speed auto to set options for speed autonegotiation.

Use undo speed to restore the default.

Syntax

speed auto { 10 | 100 | 1000 } *

undo speed

Default

No option is set for speed autonegotiation.

Views

100-Mbps or 1000-Mbps Layer 2 Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Parameters

10: Configures 10 Mbps as an option for speed autonegotiation.

100: Configures 100 Mbps as an option for speed autonegotiation.

1000: Configures 1000 Mbps as an option for speed autonegotiation.

Usage guidelines

The speed command and the speed auto command supersede each other. The most recent command that you configure takes effect. For example:

·     If you configure speed auto 100 1000 and then speed 100 on the interface, the interface speed is forcibly set to 100 Mbps.

·     If you configure speed 100 and then speed auto 100 1000 on the interface, the interface negotiates with its peer for a speed. The negotiated speed is either 100 Mbps or 1000 Mbps.

Speed autonegotiation enables an Ethernet interface to negotiate with its peer for the highest speed that both ends support. You can narrow down the speed option list for negotiation. To avoid negotiation failures, make sure a minimum of one speed option is supported at both ends.

Examples

# Configure Ten-GigabitEthernet 3/0/1 to use 10 Mbps and 1000 Mbps for speed negotiation.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] speed auto 10 1000

Related commands

speed

storm-constrain

Use storm-constrain to enable storm control and set thresholds for broadcast, multicast, or unknown unicast packets on an Ethernet interface.

Use undo storm-constrain to disable storm control for broadcast, multicast, unknown unicast, or all types of traffic.

Syntax

storm-constrain { broadcast | multicast | unicast } { pps | kbps | ratio } upperlimit lowerlimit

undo storm-constrain { all | broadcast | multicast | unicast }

Default

Traffic storm control is disabled.

Views

Layer 2 Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Parameters

all: Disables storm control for all types of traffic: broadcast, multicast, and unknown unicast.

broadcast: Enables or disables broadcast storm control.

multicast: Enables or disables multicast storm control.

unicast: Enables or disables unknown unicast storm control.

pps: Sets storm control thresholds in pps.

kbps: Sets storm control thresholds in kbps.

ratio: Sets storm control thresholds as a percentage of the transmission capacity of the interface.

upperlimit: Sets the upper threshold, in pps, kbps, or percentage.

·     If you specify the pps keyword, the value range for the upperlimit argument is 1 to 1.4881 × the interface bandwidth.

·     If you specify the kbps keyword, the value range for the upperlimit argument is 1 to the interface bandwidth.

·     If you specify the ratio keyword, the value range for the upperlimit argument is 1 to 100.

lowerlimit: Sets the lower threshold, in pps, kbps, or percentage.

·     If you specify the pps keyword, the value range for the lowerlimit argument is 1 to 1.4881 × the interface bandwidth.

·     If you specify the kbps keyword, the value range for the lowerlimit argument is 1 to the interface bandwidth.

·     If you specify the ratio keyword, the value range for the lowerlimit argument is 1 to 100.

Usage guidelines

After you configure storm control for a type of traffic, the device collects the statistics for the type of traffic at the interval configured by using the storm-constrain interval command. When the type of traffic exceeds its upper threshold, the interface takes an action configured by using the storm-constrain control command.

The storm-constrain, broadcast-suppression, multicast-suppression, and unicast-suppression commands can suppress storms on an interface. The broadcast-suppression, multicast-suppression, and unicast-suppression commands use the chip to physically suppress traffic. They have less influence on the device performance than the storm-constrain command, which uses software to suppress traffic.

For the traffic suppression result to be determined, do not configure both storm control and storm suppression for the same type of traffic.

When configuring this command, make sure upperlimit is greater than lowerlimit.

Examples

# Enable unknown unicast storm control on Ten-GigabitEthernet 3/0/1 and set the upper and lower thresholds to 200 pps and 150 pps, respectively.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] storm-constrain unicast pps 200 150

# Enable broadcast storm control on Ten-GigabitEthernet 3/0/2, and set the upper and lower thresholds to 2000 kbps and 1500 kbps, respectively.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/2

[Sysname-Ten-GigabitEthernet3/0/2] storm-constrain broadcast kbps 2000 1500

# Enable multicast storm control on Ten-GigabitEthernet 3/0/3, and set the upper and lower thresholds to 80% and 15%, respectively.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/3

[Sysname-Ten-GigabitEthernet3/0/3] storm-constrain multicast ratio 80 15

Related commands

storm-constrain control

storm-constrain interval

storm-constrain control

Use storm-constrain control to set the action to take on an Ethernet interface when a type of traffic (unknown unicast, multicast, or broadcast) exceeds the upper storm control threshold.

Use undo storm-constrain control to restore the default.

Syntax

storm-constrain control { block | shutdown }

undo storm-constrain control

Default

No action is taken on an Ethernet interface when a type of traffic exceeds the upper storm control threshold.

Views

Layer 2 Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Parameters

block: Blocks this type of traffic and forwards other types of traffic. Even though the interface does not forward the blocked traffic, it still counts the traffic. When the blocked traffic drops below the lower threshold, the port begins to forward the traffic.

shutdown: Goes down automatically. The interface goes down automatically and stops forwarding any traffic. When the blocked traffic drops below the lower threshold, the interface does not forward the traffic. To bring up the interface, use the undo shutdown command or disable storm control on the interface.

Examples

# Configure Ten-GigabitEthernet 3/0/1 to block a specific type of traffic when the type of traffic exceeds the upper storm control threshold.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] storm-constrain control block

Related commands

storm-constrain

storm-constrain control

storm-constrain enable log

Use storm-constrain enable log to enable an Ethernet interface to output log messages when it detects storm control threshold events.

Use undo storm-constrain enable log to disable an Ethernet interface from outputting log messages for storm control threshold events.

Syntax

storm-constrain enable log

undo storm-constrain enable log

Default

An Ethernet interface outputs log messages when monitored traffic exceeds the upper threshold or drops below the lower threshold from a value above the upper threshold.

Views

Layer 2 Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Examples

# Enable Ten-GigabitEthernet 3/0/1 to output log messages when it detects storm control threshold events.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] storm-constrain enable log

storm-constrain enable trap

Use storm-constrain enable trap to enable an Ethernet interface to send storm control threshold event traps.

Use undo storm-constrain enable trap to disable an Ethernet interface from sending storm control threshold event traps.

Syntax

storm-constrain enable trap

undo storm-constrain enable trap

Default

An interface sends out storm control threshold event traps when monitored traffic exceeds the upper threshold or drops below the lower threshold from a value above the upper threshold.

Views

Layer 2 Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Examples

# Enable Ten-GigabitEthernet 3/0/1 to send traps when it detects storm control threshold events.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] storm-constrain enable trap

storm-constrain interval

Use storm-constrain interval to set the traffic polling interval of the storm control module.

Use undo storm-constrain interval to restore the default.

Syntax

storm-constrain interval interval

undo storm-constrain interval

Default

The storm control module polls traffic statistics every 10 seconds.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

interval: Sets the traffic polling interval of the storm control module. The value range is 1 to 300 seconds. To ensure network stability, as a best practice, do not use a traffic polling interval shorter than 10 seconds.

Usage guidelines

The traffic polling interval set by using the storm-constrain interval command is specific to storm control. To set the statistics polling interval of an interface, use the flow-interval command.

Examples

# Set the traffic statistics polling interval of the storm control module to 60 seconds.

<Sysname> system-view

[Sysname] storm-constrain interval 60

Related commands

storm-constrain

storm-constrain control

virtual-cable-test

Use virtual-cable-test to test the cable connection of an Ethernet interface and display the test result.

Syntax

virtual-cable-test

Views

Layer 2 Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

This command is supported only on copper Ethernet ports, and is not supported on fiber ports or fiber-to-copper converters.

This command is supported by only the copper ports operating at a speed of 1000 Mbps.

If the link of an Ethernet interface is up, testing its cable connection will cause the link to go down and then up.

The test result is for reference only. The cable length detection error is up to 10 m (about 33 ft).

If a test item is not available, a hyphen (-) is displayed.

Examples

# Test the cable connection of Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] virtual-cable-test

Cable status:

  Pair A length: 12 meters

  Pair B length: 13 meters

  Pair C length: 14 meters

  Pair D length: 15 meters

  Pair A state: OK

  Pair B state: OK

  Pair C state: OK

  Pair D state: OK

Pair Impedance mismatch: yes

Pair skew: 38 ns

Pair swap: swap

Pair polarity: swap

Insertion loss: 12 db

Return loss: 11 db

Near-end crosstalk: 13 db

Table 13 Command output

Field

Description

Cable status

Cable status.

Pair x length

When the cable pair state is OK, this field displays the total length of the cable pair.

When the cable pair is in any other state, this field displays the length from the local interface to the faulty point.

Pair x state

Cable pair state:

·     OK—The cable pair is in good condition.

·     Abnormal—The cable pair is abnormal.

·     Abnormal (open)—An open circuit is detected.

·     Abnormal (short)—A short circuit is detected.

·     Invalid—The test failed.

Pair Impedance mismatch

Pair Impedance state:

·     Yes—The pair impedance is match.

·     No—The pair impedance is mismatch.

 

Layer 3 Ethernet interface or subinterface commands

mac-address

Use mac-address to set the MAC address of an Ethernet interface.

Use undo mac-address to restore the default.

Syntax

mac-address mac-address

undo mac-address

Default

No MAC address is set for a Layer 3 Ethernet interface.

Views

Layer 3 Ethernet interface view

Layer 3 Ethernet subinterface view

Predefined user roles

network-admin

mdc-admin

Parameters

mac-address: Specifies a MAC address in the format of H-H-H.

Examples

# Set the MAC address of Ten-GigabitEthernet 3/0/1 to 0001-0001-0001.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] mac-address 1-1-1

mtu

Use mtu to set the MTU for an Ethernet interface or subinterface.

Use undo mtu to restore the default.

Syntax

mtu size

undo mtu

Default

The MTU of an Ethernet interface or subinterface is 1500 bytes.

Views

Layer 3 Ethernet interface view

Layer 3 Ethernet subinterface view

Predefined user roles

network-admin

mdc-admin

Parameters

size: Sets the MTU in bytes.The value range for this argument is 46 to 10240.

Usage guidelines

A smaller MTU size results in more fragments. When you set the MTU for an interface, consider QoS queue lengths, for example, consider that the default FIFO queue length is 75. To prevent a too small MTU from causing packet drops in QoS queuing, you can perform one of the following configurations:

·     Tune the MTU with the mtu command.

·     Tune QoS queue lengths with the qos fifo queue-length command.

For more information about the qos fifo queue-length command, see ACL and QoS Command Reference.

This command takes effect only on protocol packets, not on forwarded data packets.

Examples

# Set the MTU to 1430 bytes for Ten-GigabitEthernet 3/0/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1

[Sysname-Ten-GigabitEthernet3/0/1] mtu 1430

# Set the MTU to 1430 bytes for Ten-GigabitEthernet 3/0/1.1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1.1

[Sysname-Ten-GigabitEthernet3/0/1.1] mtu 1430

 

traffic-statistic enable

Use traffic-statistic enable to enable packet statistics collection for a Layer 3 Ethernet subinterface.

Use undo traffic-statistic enable to disable packet statistics collection for a Layer 3 Ethernet subinterface.

Syntax

traffic-statistic enable

undo traffic-statistic enable

Default

Packet statistics collection is disabled for a Layer 3 Ethernet subinterface.

Views

Layer 3 Ethernet subinterface view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

You can use the display interface or display counters command to display the subinterface packet statistics.

On a device in standard system operating mode where the incoming interface and outgoing interface of traffic are on different cards, if this feature is enabled on the incoming and outgoing interfaces, packet statistics will not collected on the outgoing interface.

Examples

# Enable packet statistics collection for Ten-GigabitEthernet 3/0/1.1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/0/1.1

[Sysname-Ten-GigabitEthernet3/0/1.1] traffic-statistic enable

Related commands

display counters

display interface

flow-interval

  • Cloud & AI
  • InterConnect
  • Intelligent Computing
  • Intelligent Storage
  • Security
  • SMB Products
  • Intelligent Terminal Products
  • Product Support Services
  • Technical Service Solutions
All Services
  • Resource Center
  • Policy
  • Online Help
  • Technical Blogs
All Support
  • Become A Partner
  • Partner Policy & Program
  • Global Learning
  • Partner Sales Resources
  • Partner Business Management
  • Service Business
All Partners
  • Profile
  • News & Events
  • Online Exhibition Center
  • Contact Us
All About Us
新华三官网