- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
02-Ethernet interface commands | 740.80 KB |
Contents
Common Ethernet interface commands
display ifindex-constant configuration
display link-state-change statistics interface
port ifmonitor input-buffer-drop
port ifmonitor output-buffer-drop
priority-flow-control inner-port
priority-flow-control inner-port no-drop
reset link-state-change statistics interface
shutdown all-physical-interface
snmp-agent trap enable ifmonitor
snmp-agent trap enable slot-monitor
traffic-statistic include-interframe
Layer 3 Ethernet interface or subinterface commands
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
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/1/1 to 1000 kbps.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/1] bandwidth 1000
# Set the expected bandwidth of Ten-GigabitEthernet 3/1/1.1 to 1000 kbps.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1.1
[Sysname-Ten-GigabitEthernet3/1/1.1] bandwidth 1000
Related commands
speed
combo enable
Use combo enable to activate the copper or fiber combo port of a combo interface.
Syntax
combo enable { copper | fiber }
Default
The copper combo port of a combo interface is activated.
Views
Ethernet interface view
Predefined user roles
network-admin
Parameters
copper: Activates the copper combo port. In this case, use twisted pairs to connect the port.
fiber: Activates the fiber combo port. In this case, use optical fibers to connect the port.
Usage guidelines
A combo interface is a logical interface that physically contains one fiber combo port and one copper combo port on the device panel. The two ports share one forwarding interface. As a result, they cannot work simultaneously. When you activate either port, the other port is automatically disabled. You can select to activate the copper combo port or fiber combo port.
Before using this command, perform the following tasks according to the marks on the device panel:
· Determine the combo interfaces on your device.
· Identify the two physical interfaces that belong to each combo interface.
Examples
# Activate the copper combo port of combo interface Ten-GigabitEthernet 3/1/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/1] combo enable copper
# Activate the fiber combo port of combo interface Ten-GigabitEthernet 3/1/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/1] combo enable fiber
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
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
This 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 MSTP enabled.
After an interface in down state is dampened, the interface state displayed through the display interface command or MIB is always down.
Examples
# Enable interface dampening on Ten-GigabitEthernet 3/1/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/1] dampening
# Enable interface dampening on Ten-GigabitEthernet 3/1/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/1/1
[Sysname-Ten-GigabitEthernet3/1/1] dampening 2 800 3000 5
Related commands
display interface
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
Usage guidelines
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/1/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/1] default
# Restore the default settings for Ten-GigabitEthernet 3/1/1.1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1.1
[Sysname-Ten-GigabitEthernet3/1/1.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/1/1 Interface).
Views
Ethernet interface view
Ethernet subinterface view
Virtual Layer 2 Ethernet interface view
Predefined user roles
network-admin
Parameters
text: Specifies the interface description, a case-sensitive string of 1 to 255 characters.
Examples
# Set the description of Ten-GigabitEthernet 3/1/1 to lan-interface.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/1] description lan-interface
# Set the description of Ten-GigabitEthernet 3/1/1.1 to subinterface3/1/1.1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1.1
[Sysname-Ten-GigabitEthernet3/1/1.1] description subinterface3/1/1.1
display counters
Use display counters to display interface traffic statistics.
Syntax
display counters { inbound | outbound } interface [ interface-type [ interface-number | interface-number.subnumber ] ] [ description ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
inbound: Displays inbound traffic statistics.
outbound: Displays outbound traffic statistics.
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.
description: Displays complete interface descriptions. If you do not specify this keyword, the command displays only the first 27 characters of each interface description.
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 or subinterface number, this command displays traffic statistics for all interfaces of the specified type.
If you specify an interface type and an interface or subinterface number, this command displays traffic statistics for the specified interface/subinterface.
Examples
# Display inbound traffic statistics for all Ten-GigabitEthernet interfaces.
<Sysname> display counters inbound interface ten-gigabitethernet
Interface Total(pkt) Broadcast(pkt) Multicast(pkt) Err(pkt)
Description
XGE3/1/1 100 100 0 0
XGE3/1/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(pkt) |
Total number of packets received or sent through the interface. |
Broadcast(pkt) |
Total number of broadcast packets received or sent through the interface. |
Multicast(pkt) |
Total number of multicast packets received or sent through the interface. |
Err(pkt) |
Total number of error packets received or sent through the interface. |
Description |
Description configured for 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 within the most recent statistics polling interval.
Syntax
display counters rate [ inbound | outbound ] interface [ interface-type [ interface-number | interface-number.subnumber ] ] [ description ]
Views
Any view
Predefined user roles
network-admin
network-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.
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.
description: Displays complete interface descriptions. If you do not specify this keyword, the command displays only the first 27 characters of each interface description.
Usage guidelines
If you do not specify the inbound or outbound keyword, this command displays both the inbound and outbound traffic rate statistics for interfaces in up state within the most recent statistics polling interval.
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 or subinterface number, this command displays traffic rate statistics for all up interfaces of the specified type.
If you specify an interface type and an interface or subinterface number, this command displays traffic rate statistics for the specified interface or subinterface.
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.
You can use the flow-interval command to set the statistics polling interval.
Examples
# Display the inbound and outbound traffic rate statistics for Ten-GigabitEthernet 3/1/1.
<Sysname> display counters rate interface ten-gigabitethernet 3/1/1
Usage: Bandwidth utilization in percentage
Interface InUsage(%) InTotal(pps) OutUsage(%) OutTotal(pps)
Description
XGE3/1/1 0.01 1000 0.01 1000
Overflow: More than 14 digits.
--: Not supported.
# Display the inbound traffic rate statistics for all Ten-GigabitEthernet interfaces.
<Sysname> display counters rate inbound interface ten-gigabitethernet
Usage: Bandwidth utilization in percentage
Interface Usage(%) Total(pps) Broadcast(pps) Multicast(pps)
Description
XGE3/1/1 0.03 200 100 100
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 within the most recent statistics polling interval. |
Total(pps) |
Average receiving or sending rate (in pps) for all packets within the most recent statistics polling interval. |
InUsage(%) |
Bandwidth usage (in percentage) of all inbound packets within the most recent statistics polling interval. When the usage is smaller than 0.01%, 0.01% is displayed. |
InTotal(pps) |
Average receiving rate (in pps) for all packets within the most recent statistics polling interval. |
OutUsage(%) |
Bandwidth usage (in percentage) of all outbound packets within the most recent statistics polling interval. When the usage is smaller than 0.01%, 0.01% is displayed. |
OutTotal(pps) |
Average sending rate (in pps) for all packets within the most recent statistics polling interval. |
Broadcast(pps) |
Average receiving or sending rate (in pps) for broadcast packets within the most recent statistics polling interval. |
Multicast(pps) |
Average receiving or sending rate (in pps) for multicast packets within the most recent statistics polling interval. |
Description |
Description configured for the interface. |
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 [ cpu cpu-number ]
In IRF mode:
display ethernet statistics chassis chassis-number slot slot-number [ cpu cpu-number ]
Views
Any view
Predefined user roles
network-admin
network-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.)
cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.
Examples
# (In standalone mode.) Display the Ethernet module statistics for the specified slot.
<Sysname> display ethernet statistics slot 3
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. · 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 ifindex-constant configuration
Use display ifindex-constant configuration to display the SNMP interface index constancy configuration information.
Syntax
display ifindex-constant configuration
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display the SNMP interface index constancy configuration information.
<Sysname> display ifindex-constant configuration
Ifindex constancy: Enabled
Ifindex max-number: 131070
Table 4 Command output
Field |
Description |
Ifindex constancy |
State of the SNMP interface index constancy: · Disabled · Enabled |
Ifindex max-number |
Maximum number of constant interface indexes. |
display ifindex-constant map
Use display ifindex-constant map to display the interface name-constant interface index mappings.
Syntax
display ifindex-constant map [ file filename ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
filename: Specifies a flash file in the format of filesystemname/filename to display the interface name-constant interface index mappings uploaded through the file. The filename is ifindex.dat or snmp_ifindex.dat, and must be saved in the root directory of a file system on the device. You can enter a maximum of 63 characters for this argument. Without this argument specified, the display ifindex-constant map command displays all interface name-constant interface index mappings on the device. For more information about specifying a folder and file, see File System Management in Fundamentals Configuration Guide.
Examples
# Display the interface name-constant interface index mappings on the device.
<Sysname> display ifindex-constant map
Total number of constant ifindexes: 1
Interface name Interface index
XGE3/1/1 386
Table 5 Command output
Field |
Description |
Total number of constant ifindexes |
Total number of constant interface indexes. |
Interface name |
Brief name of the interface. |
Interface index |
Constant interface index. |
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
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.
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 27 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 or subinterface number, this command displays information about all interfaces of the specified type.
Examples
# Display information about Layer 3 interface Ten-GigabitEthernet 3/1/1.
<Sysname> display interface ten-gigabitethernet 3/1/1
Ten-GigabitEthernet3/1/1
Interface index: 386
Current state: UP
Line protocol state: UP
Description: Ten-GigabitEthernet3/1/1 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: 1234-5678-9066
IPv6 packet frame type: Ethernet II, hardware address: 1234-5678-9066
Media type is twisted pair, port hardware type is 1000_BASE_T
Port priority: 0
Loopback is not set
1000Mbps-speed mode, full-duplex mode
Link speed type is autonegotiation, link duplex type is autonegotiation
The maximum frame length is 10240
Last link flapping: 0 hours 30 minutes 52 seconds
Last clearing of counters: Never
Current system time:2017-12-21 09:10:12
Last time when physical state changed to up:2017-12-21 08:39:19
Last time when physical state changed to down:2017-12-21 08:37:21
Traffic statistic: Include Inter-frame Gaps and Preambles
Peak input rate: 0 bytes/sec, at 2017-12-21 07:02:00
Peak output rate: 0 bytes/sec, at 2017-12-21 09:10:07
Last 300 seconds input: 0 packets/sec 0 bytes/sec 0 bits/sec -%
Last 300 seconds output: 0 packets/sec 0 bytes/sec 0 bits/sec -%
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
0 ignored, - parity errors
Output (total): 0 packets, 0 bytes
0 unicasts, 0 broadcasts, 0 multicasts, - pauses
Output (normal): 0 packets, 0 bytes
- unicasts, - broadcasts, - multicasts, 0 pauses
Output: 0 output errors, - underruns, - buffer failures
0 aborts, 0 deferred, - collisions, 0 late collisions
- lost carrier, - no carrier
# Display information about Layer 3 Ethernet subinterface Ten-GigabitEthernet 3/1/1.1.
<Sysname> display interface ten-gigabitethernet 3/1/1.1
Ten-GigabitEthernet3/1/1.1
Current state: DOWN
Line protocol state: DOWN
Description: Ten-GigabitEthernet3/1/1.1 Interface
Bandwidth: 1000000 kbps
Maximum transmission unit: 1500
Internet protocol processing: Disabled
IP packet frame type: Ethernet II, hardware address: 80f6-fe00-f4a3
IPv6 packet frame type: Ethernet II, hardware address: 80f6-fe00-f4a3
Last clearing of counters: Never
Traffic statistic: Include Inter-frame Gaps and Preambles
Last 300 seconds input rate: 0.00 bytes/sec, 0 bits/sec, 0.00 packets/sec
Last 300 seconds output rate: 0.00 bytes/sec, 0 bits/sec, 0.00 packets/sec
Input (total): 0 packets, 0 bytes
(broadcasts) 0 packets, 0 bytes
(multicasts) 0 packets, 0 bytes
(unicasts) 0 packets, 0 bytes
Output (total): 0 packets, 0 bytes
(broadcasts) 0 packets, 0 bytes
(multicasts) 0 packets, 0 bytes
(unicasts) 0 packets, 0 bytes
# Display detailed information about Layer 2 interface Ten-GigabitEthernet 3/1/1.
<Sysname> display interface ten-gigabitethernet 3/1/1
Ten-GigabitEthernet3/1/1
Interface index: 386
Current state: DOWN
Line protocol state: DOWN
IP packet frame type: Ethernet II, hardware address: 00fc-5ba5-d800
Description: Ten-GigabitEthernet3/1/1 Interface
Bandwidth: 1000000 kbps
Loopback is not set
Media type is not sure,port hardware type is No connector
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: 0
Last link flapping: Never
Last clearing of counters: Never
Current system time:2017-12-13 12:07:43
Last time when physical state changed to up:-
Last time when physical state changed to down:2017-12-11 17:51:41
Traffic statistic: Include Inter-frame Gaps and Preambles
Peak input rate: 0 bytes/sec, at 2017-12-12 17:27:42
Peak output rate: 0 bytes/sec, at 2017-12-12 17:27:42
Last 300 seconds input: 0 packets/sec 0 bytes/sec 0 bits/sec -%
Last 300 seconds output: 0 packets/sec 0 bytes/sec 0 bits/sec -%
Input (total): 0 packets, 0 bytes
0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
Input (normal): 0 packets, - bytes
0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
Input: 0 input errors, 0 runts, 0 giants, 0 throttles
0 CRC, 0 frame, - overruns, 0 aborts
- ignored, - parity errors
Output (total): 0 packets, 0 bytes
0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
Output (normal): 0 packets, - bytes
0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
Output: 0 output errors, 0 giants, - underruns, - buffer failures
0 aborts, 0 deferred, 0 collisions, 0 late collisions
0 lost carrier, - no carrier
Field |
Description |
Derive Interface |
Name of the virtual Layer 2 Ethernet interface corresponding to the Layer 3 Ethernet interface. |
Origin interface |
Name of the Layer 3 Ethernet interface corresponding to the virtual Layer 2 Ethernet interface. |
Current state |
Physical link state of the interface: · Administratively DOWN—The interface has been shut down by using the shutdown command. · 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. · ETH-rddc Shutdown—The interface has been shut down by the Reth module. · 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. · 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. · Storm-Constrain—The interface has been shut down because the storm control feature detected that unknown unicast traffic, multicast traffic, or broadcast traffic exceeded the upper threshold. · STP DOWN—The interface has been shut down by the BPDU guard feature. · 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. ¡ MACSEC—Shuts down the data link layer when it fails to negotiate the encryption parameters. ¡ VBP—Shuts down the data link layer because Layer 2 forwarding is configured. |
Bandwidth |
Expected bandwidth of the interface. |
Maximum transmission unit |
MTU of the interface. |
Internet protocol processing |
IP configuration parameter of the interface when the interface is not assigned an IP address: · Disabled—The interface cannot process IP packets. · Enabled—The interface can process IP packets. |
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 BRAS Services Configuration Guide. · BOOTP-allocated—BOOTP allocated IP address. For more information, see BOOTP client configuration in BRAS Services Configuration Guide. · PPP-negotiated—IP address assigned by a PPP server during PPP negotiation. For more information, see PPP configuration in BRAS 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. · MTunnel—IP address of the multicast tunnel interface (MTI), which is the same as the IP address of the MVPN source interface. For more information, see multicast VPN configuration in IP Multicast 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. |
FEC mode |
FEC mode of the interface, which depends on the configuration. When the FEC mode of an interface is set to autonegotiation, the actual FEC mode depends on the model of the transceiver module installed in the fiber port. |
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, 10 Mbps or 100 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 in ratio, pps, or kbps. The unit of the threshold depends on your configuration. |
Multicast max- |
Multicast storm suppression threshold in ratio, pps, or kbps. The unit of the threshold depends on your configuration. |
Unicast max- |
Unknown unicast storm suppression threshold in ratio, pps, or kbps. The unit of the threshold depends on your configuration. |
PVID |
Port VLAN ID (PVID) of the interface. |
MDI type |
MDIX mode of the interface: · automdix. · mdi. · mdix. |
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. |
Ethernet port mode |
Operating mode of a 10-GE interface: · LAN. · WAN. For more information, see the port-mode command. |
Regenerator section layer |
Alarm and error statistics of the regenerator section. |
J0(TX) |
Sent J0 trace byte value. |
J0(RX) |
Received J0 trace byte value. |
Error |
Error statistics, |
Multiplex section layer |
Alarm and error statistics of the multiplex section. |
Higher order path layer |
Alarm and error statistics of the higher order path. |
J1(TX) |
Sent J1 trace byte value. |
J1(RX) |
Received J1 trace byte value. |
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 UTC±HH:MM:SS format. |
Last time when physical state changed to up |
Last time when physical state of the interface changed to up. A hyphen (-) indicates that the physical state of the interface has not changed to up. |
Last time when physical state changed to down |
Last time when physical state of the interface changed to down. A hyphen (-) indicates that the physical state of the interface has not changed to down. |
Last interval seconds input: 0 packets/sec 0 bytes/sec 0 bits/sec 0% Last interval seconds output: 0 packets/sec 0 bytes/sec 0 bits/sec 0% |
Average inbound or outbound traffic rate (in pps, Bps, 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, execute the flow-interval command. A hyphen (-) indicates that the statistical item is not supported. |
Traffic statistic |
Whether or not enable interframe gap and preamble statistics in the traffic statistics: · Include Inter-frame Gaps and Preambles · Not include Inter-frame Gaps and Preambles |
Input (total): 123220 packets, 11777588 bytes 482 unicasts, 87316 broadcasts, 35422 multicasts, - 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. A hyphen (-) indicates that the statistical item is not supported. |
Input (normal): 123220 packets, - bytes - unicasts, - broadcasts, - 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. A hyphen (-) indicates that the statistical item is not supported. |
Last 300 seconds input rate: 0.00 bytes/sec, 0 bits/sec, 0.00 packets/sec Last 300 seconds output rate: 0.00 bytes/sec, 0 bits/sec, 0.00 packets/sec |
Average inbound or outbound traffic rate (in Bps, bps, and pps) in the last 300 seconds. These fields are displayed only when the traffic-statistic enable command is configured. |
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 and outbound 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, - 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. A hyphen (-) indicates that the statistical item is not supported. |
Output (normal): 0 packets, 0 bytes - unicasts, - broadcasts, - 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. A hyphen (-) indicates that the statistical item is not supported. |
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. |
Last 300 seconds input rate: 0 packets/sec, 0 bytes/sec |
Average inbound traffic rate (in pps and Bps) in the last 300 seconds. A hyphen (-) indicates that the statistical item is not supported. |
Last 300 seconds output rate: 0 packets/sec, 0 bytes/sec |
Average outbound traffic rate (in pps and Bps) in the last 300 seconds. A hyphen (-) indicates that the statistical item is not supported. |
Input: 0 packets, 0 bytes |
Inbound traffic statistics (in packets and bytes) for the interface. A hyphen (-) indicates that the statistical item is not supported. |
Output: 0 packets, 0 bytes |
Outbound traffic statistics (in packets and bytes) for the interface. A hyphen (-) indicates that the statistical item is not supported. |
# 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/1/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/1/2 DOWN auto A A 1
XGE3/1/3 UP 100M(a) F(a) A 1 aaaaaaaaaaaaaaaa
# Display brief information about Ten-GigabitEthernet 3/1/3, including the complete description of the interface.
<Sysname> display interface ten-gigabitethernet 3/1/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/1/3 UP 100M(a) F(a) A 1 aaaaaaaaaaaaaaaa
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/1/1 DOWN Not connected
Brief information on interfaces in bridge mode:
Link: ADM - administratively down; Stby - standby
Interface Link Cause
XGE3/1/2 DOWN Not connected
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. · IRF-link-down—The IRF member device that contains the interface has lost the connectivity of all its IRF links. · 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 unknown unicast traffic, 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. · Standby—The interface is a backup interface in standby state. |
Link physical state |
Physical state of the IRF port. This field is displayed only when the VLAN used for sending and receiving IRF protocol packets is configured when IRF port is bound to the IRF physical interface. |
Link detect state |
State of the link where the IRF port resides. This field is displayed only when the VLAN used for sending and receiving IRF protocol packets is configured when IRF port is bound to the IRF physical interface. |
Related commands
reset counters interface
display interface link-info
Use display interface link-info to display the status and packet statistics of interfaces.
Syntax
display interface [ interface-type [ interface-number | interface-number.subnumber ] ] link-info [ down | up ] [ description ] [ main ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-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.
down: Displays information about interfaces in down state. If you do not specify this keyword, the command displays information about interfaces in all states.
up: Displays information about interfaces in up state. If you do not specify this keyword, the command displays information about interfaces in all states.
description: Displays complete interface descriptions. If you do not specify this keyword, the command displays only the first 27 characters of each interface description.
main: Specifies all interfaces except subinterfaces. If you do not specify this keyword, this command displays status and packet statistics of all interfaces.
verbose: Displays detailed information. If you do not specify this keyword, this command displays brief information.
Examples
# Display status and statistics of all interfaces.
<Sysname> display interface link-info
Link: ADM - administratively down; Stby - standby
Protocol: (s) - spoofing
Interface Link Pro InUsage OutUsage InErrs OutErrs Description
XGE3/1/1 UP UP 0.05% 0.05% 3000 3000
NULL0 UP UP(s) -% -% 0 0
Overflow: More than 7 digits.
--: Not supported.
# Display detailed information such as status and statistics of all interfaces.
<Sysname> display interface link-info verbose
Link: ADM - administratively down; Stby - standby
Protocol: (s) - spoofing
Interface Link Pro InUsage OutUsage InTotal(pps) Ou
tTotal(pps) InTotal(pkt) OutTotal(pkt) InErrs OutErrs Description
XGE3/1/2 DOWN DOWN -- -- -- --
-- -- -- --
Table 8 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. |
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. |
Pro |
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. When the usage is smaller than 0.01%, 0.01% is displayed. 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. When the usage is smaller than 0.01%, 0.01% is displayed. To set the statistics polling interval, use the flow-interval command. |
InTotal(pps) |
Average receiving rate (in pps) for all packets within the most recent statistics polling interval. |
OutTotal(pps) |
Average sending rate (in pps) for all packets within the most recent statistics polling interval. |
InTotal(pkt) |
Total number of received packets. |
OutTotal(pkt) |
Total number of sent packets. |
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
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 27 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
GigabitEthernet3/1/1
Current state: UP
Line protocol state: UP
Description: GigabitEthernet3/1/1 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: 1234-5678-9066
IPv6 packet frame type: Ethernet II, hardware address: 1234-5678-9066
Media type is twisted pair, port hardware type is 1000_BASE_T
Port priority: 0
Loopback is not set
1000Mbps-speed mode, full-duplex mode
Link speed type is autonegotiation, link duplex type is autonegotiation
The maximum frame length is 10240
Last link flapping: 0 hours 30 minutes 52 seconds
Last clearing of counters: Never
Current system time:2017-12-21 09:10:12
Last time when physical state changed to up:2017-12-21 08:39:19
Last time when physical state changed to down:2017-12-21 08:37:21
Peak input rate: 0 bytes/sec, at 2017-12-21 07:02:00
Peak output rate: 0 bytes/sec, at 2017-12-21 09:10:07
Last 300 seconds input: 0 packets/sec 0 bytes/sec 0 bits/sec -%
Last 300 seconds output: 0 packets/sec 0 bytes/sec 0 bits/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, - aborts
0 ignored, - parity errors
Output (total): 0 packets, 0 bytes
0 unicasts, 0 broadcasts, 0 multicasts, - pauses
Output (normal): 0 packets, 0 bytes
- unicasts, - broadcasts, - multicasts, 0 pauses
Output: 0 output errors, - underruns, - buffer failures
0 aborts, 0 deferred, - collisions, 0 late collisions
- lost carrier, - no carrier
# Display brief information of 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/1/1 DOWN DOWN --
Loop0 UP UP(s) 2.2.2.9
NULL0 UP UP(s) --
REG0 UP -- --
VT1 DOWN DOWN --
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/1/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/1/3 UP auto F(a) A 1 aaaaaaaaaaaaaaaa
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/1/1 DOWN Not connected
Brief information on interfaces in bridge mode:
Link: ADM - administratively down; Stby - standby
Interface Link Cause
XGE3/1/2 DOWN Not connected
For description on the display interface main command output, see Table 6 and Table 7.
display interface phy-option
Use display interface phy-option to display the physical attributes of an interface.
Syntax
display interface [ interface-type [ interface-number ] ] phy-option
Views
Any view
Predefined user roles
network-admin
network-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 physical attributes of all interfaces.
If you specify an interface type but do not specify an interface number, this command displays the physical attributes of all interfaces of the specified type.
Examples
# Display the physical attributes of Layer 2 Ethernet interface Ten-GigabitEthernet 3/1/1.
<Sysname> display interface ten-gigabitethernet 3/1/1 phy-option
Ten-GigabitEthernet3/1/1
Current state: UP
Flow-control is not enabled
Media type is twisted pair, port hardware type is 1000_BASE_T_AN_SFP
Loopback is not set
1000Mbps-speed mode, full-duplex mode
Link speed type is autonegotiation, link duplex type is autonegotiation
Maximum frame length: 3072
Transceiver information:
Transceiver Type : 1000_BASE_T_AN_SFP
Wavelength(nm) : 2147483647
Transfer Distance(m) : 100
Digital Diagnostic Monitoring : NO
Vendor Name : FINISAR CORP.
RX power: 2147483647dBm/100, Alarm thresholds:[0, 0]uw/10
RT power: 2147483647dBm/100, Alarm thresholds:[0, 0]uw/10
# Display the physical attributes of Layer 3 Ethernet interface Ten-GigabitEthernet 3/1/1.
<Sysname> display interface ten-gigabitethernet 3/1/1 phy-option
Ten-GigabitEthernet3/1/1
Current state: UP
Flow-control is not enabled
Media type is twisted pair, port hardware type is 1000_BASE_T_AN_SFP
Loopback is not set
1000Mbps-speed mode, full-duplex mode
Link speed type is autonegotiation, link duplex type is autonegotiation
The maximum frame length is 3072
Transceiver information:
Transceiver Type : 1000_BASE_T_AN_SFP
Wavelength(nm) : 2147483647
Transfer Distance(m) : 100
Digital Diagnostic Monitoring : NO
Vendor Name : FINISAR CORP.
RX power: 2147483647dBm/100, Alarm thresholds:[0, 0]uw/10
RT power: 2147483647dBm/100, Alarm thresholds:[0, 0]uw/10
Table 9 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. · 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. · ETH-rddc Shutdown—The interface has been shut down by the Reth module. · 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. · Storm-Constrain—The interface has been shut down because the storm control feature detected that unknown unicast traffic, multicast traffic, or broadcast traffic exceeded the upper threshold. · STP DOWN—The interface has been shut down by the BPDU guard feature. · UP—The interface is both administratively and physically up. |
Flow-control is enabled |
Generic flow control is enabled on the interface. This field depends on your configuration and the link parameter negotiation result. |
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. |
Media type is |
Media type 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. |
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. |
20Gbps-speed mode |
The interface is operating at 20 Gbps. This field depends on your configuration and the link parameter negotiation result. |
25Gbps-speed mode |
The interface is operating at 25 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. |
50Gbps-speed mode |
The interface is operating at 50 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, 10 Mbps or 100 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. |
Maximum frame length |
Maximum length of Ethernet frames allowed to pass through the interface. |
Transceiver information |
Transceiver module information. |
Transceiver Type |
Physical model of the transceiver module. |
Wavelength(nm) |
Central wavelength (in nm) of the transmit laser. If the transceiver module supports multiple wavelengths, every two wavelength values are separated by a comma. For a copper cable, this field displays N/A. |
Transfer Distance(xx) |
Transmission distance, where xx indicates the distance unit: · km—Kilometers, for single-mode transceiver modules. · m—Meters, for other transceiver modules. If the transceiver module supports multiple types of transmission media, this field displays the transmission distance for each type, in the form of transmission distance (medium type). Transmission medium types include: · 9 um—9/125 µm single-mode fiber. · 50 um—50/125 µm multimode fiber. · 62.5 um—62.5/125 µm multimode fiber. · TP—Twisted pair. · CX4—CX4 cable. |
Digital Diagnostic Monitoring |
Support for digital diagnostic monitoring: · YES. · NO. |
Vendor Name |
Manufacturer or custom vendor of the transceiver module. |
RX power(dBm/100) |
Rx power in dBm/100. |
TX power(dBm/100) |
Tx power in dBm/100. |
Alarm thresholds |
Alarm thresholds for the Rx or Tx power. |
Related commands
display interface
display transceiver interface (Fundamentals Command Reference)
display link-flap protection
Use display link-flap protection to display information about link flapping protection on an interface.
display link-flap protection [ interface interface-type [ interface-number ] ]
Views
Any view
Predefined user roles
network-admin
network-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: Enable
Interface Link-flap Status Interval Threshold
XGE3/1/1 Enable Down 10 5
XGE3/1/2 Disable N/A -- --
Field |
Description |
Link-flap protection |
Status of global link flapping protection: · Enable—Link flapping protection is enabled globally. · Disable—Link flapping protection is disabled globally. |
Link-flap |
Status of link flapping protection on an interface: · Enable—Link flapping protection is enabled on an interface. · Disable—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 |
Link flapping detection interval for an interface. |
Threshold |
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 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
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 up interfaces that have traffic counters.
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/1/1 0 Never Never
Never Never
Table 11 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 link state change statistics were cleared. |
Link-flap-begin |
Last time when a link state flapping began. If no link state flapping has occurred, this field displays Never. |
Link-flap-end |
Last time when a 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 card.
Syntax
display packet-drop slot [ slot-number ]
display packet-drop chassis [ chassis-number [ slot slot-number ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
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.
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.
Examples
# Display statistics about dropped packets on all slots.
<Sysname> display packet-drop slot
Slot Total
0 210
1 210
2 210
# Display statistics about dropped packets on all slots in all classis.
<Sysname> display packet-drop chassis
Chassis Slot Total
1 0 210
2 0 210
1 210
2 210
3 0 210
1 210
Table 12 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. |
Slot |
Slot number. |
Chassis |
Chassis number. |
Total |
Statistics about dropped packets. |
display slot-monitor
Use display slot-monitor to display alarm information for cards.
Syntax
display slot-monitor slot slot-number
display slot-monitor chassis chassis-number slot slot-number
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
slot slot-number: Specifies a card by its 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.
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 13 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. |
display this interface
Use display this interface to display the operating status and information of an interface.
Syntax
display this interface
Views
Ethernet interface view
Predefined user roles
network-admin
Usage guidelines
In interface view, to quickly view the operating status or packet statistics of the interface, execute this command.
For an interface, the output from the display this interface command in interface view is the same as the output from the display interface interface-type interface-number command in any view.
Related commands
display interface
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
10-GE, 40-GE, and 100-GE interfaces operate in full duplex mode, and all other types of Ethernet interfaces operate in autonegotiation mode.
Views
Ethernet interface view
Predefined user roles
network-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.
Usage guidelines
Fiber ports do not support the half keyword.
On an interface subcard in a CSPEX-1104-E or CSPEX-1204 card, copper ports do not support half duplex mode. On an interface subcard in any other CSPEX card, only copper ports on an MIC-GP4L interface subcard support half duplex mode.
GE interfaces on a MIC interface subcard in a CSPEX-1204 card do not support the full or half duplex mode when operating at 10 Mbps or 100 Mbps.
When you configure the speed for interfaces on a MIC-GP10L2 or MIC-GT20L1 interface subcard in a CSPEX-2304X-G or CSPEX-2304X-LG card, follow these restrictions and guidelines:
· The MIC-GP10L2 and MIC-GT20L1 interface subcards support the duplex auto and duplex full commands, but do not support the duplex half command.
· The interface speed configured for the MIC-GP10L2 or MIC-GT20L1 interface subcard must be consistent with that for the peer end.
· Interfaces on a MIC-XP2L-LAN interface subcard in a CSPEX-2304X-G card do not support the auto duplex mode.
Examples
# Configure Ten-GigabitEthernet 3/1/1 to operate in full duplex mode.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/1] duplex full
flag sdh
IMPORTANT: This command is effective only when the 10-GE interface is operating in WAN mode. |
Use flag sdh to set the value for the overhead byte J0 or J1 in SDH frames on a 10-GE interface.
Use undo flag sdh to restore the default.
Syntax
flag { j0 | j1 } sdh value
undo flag { j0 | j1 } sdh
Default
The J0 byte is SR8800.
Views
10-GE interface view
Predefined user roles
network-admin
Parameters
j0: Specifies the Regenerator Section Trace byte J0.
j1: Specifies the Path Trace byte J1.
value: Specifies the value for the J0 or J1 byte, a string of 1 to 15 characters.
Examples
# Set the value of the J0 byte in SDH frames to Sysname on Ten-GigabitEthernet 3/1/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/1] port-mode wan
[Sysname-Ten-GigabitEthernet3/1/1] flag j0 sdh Sysname
Related commands
port-mode
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
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.
When a MIC subcard is installed in a CSPEX-1104-E, CSPEX-2304X-G, CSPEX-2304X-LG, or SPEX-1024 card, Ethernet interfaces on that subcard do not support this feature.
Examples
# Enable TxRx-mode generic flow control on Ten-GigabitEthernet 3/1/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/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
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.
When a MIC subcard is installed in a CSPEX-1104-E, CSPEX-2304X-G, CSPEX-2304X-LG, or SPEX-1204 card, Ethernet interfaces on that subcard do not support this feature.
Examples
# Enable Rx-mode generic flow control on Ten-GigabitEthernet 3/1/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-ten-gigabitethernet 3/1/1] flow-control receive enable
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
Parameters
interval: Sets the statistics polling interval in seconds. In system view, the interval is in the range of 5 to 300 and must be a multiple of 5. In Ethernet interface view, the interval is in the range of 1 to 300 and must be a multiple of 1.
Usage guidelines
You can use this command in system view or interface view.
· In system view, the command takes effect on all interfaces.
· In interface view, the command takes effect only on the specified interface.
When the statistics polling interval uses the default setting in interface view, the setting in system view takes effect. When the command is executed in both system view and interface view, the setting in interface view takes priority.
As a best practice, use the default value for the flow-interval command in system view. A short static polling interval in system view might decrease the system performance and result in inaccurate statistics.
You can use the display interface command to view the statistics only after two consecutive statistics polling intervals. The statistics are displayed by the Last interval seconds input and Last interval seconds output fields in the display interface command output.
Examples
# Set the statistics polling interval to 100 seconds on Ten-GigabitEthernet 3/1/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/1] flow-interval 100
Related commands
display interface
frame-format
Use frame-format to set the framing format on a 10-GE interface operating in WAN mode.
Use undo frame-format to restore the default.
Syntax
frame-format sdh
undo frame-format
Default
The framing format is SDH on a 10-GE interface.
Views
10-GE interface view
Predefined user roles
network-admin
Parameters
sdh: Specifies the SDH framing format.
sonet: This keyword is not supported.
Usage guidelines
SDH and SONET are two optical transmission standards made by different organizations. They are similar in substantial contents and major specifications and different only in some detailed technical parameters. However, they have different application scopes, and devices from different vendors have different default framing formats. Configure the same framing format as that of the transmission device.
This command is effective only when the 10-GE interface is operating in WAN mode.
Examples
# Set the framing format to SONET on Ten-GigabitEthernet 3/1/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/1] port-mode wan
[Sysname-Ten-GigabitEthernet3/1/1] frame-format sdh
ifindex-constant enable
Use ifindex-constant enable to enable SNMP interface index constancy.
Use undo ifindex-constant enable to disable SNMP interface index constancy.
Syntax
ifindex-constant enable [ file filename ]
undo ifindex-constant enable
Default
SNMP interface index constancy is disabled.
Views
System view
Predefined user roles
network-admin
Parameters
filename: Specifies a flash file in the format of filesystemname/filename to upload the constant interface indexes through the file. The filename is ifindex.dat or snmp_ifindex.dat, and must be saved in the root directory of a file system on the device. You can enter a maximum of 63 characters for this argument. For more information about specifying a folder and file, see File System Management in Fundamentals Configuration Guide.
Usage guidelines
For an application that uses interface indexes for billing, the interface indexes must be constant. You can enable SNMP interface index constancy to make the interface indexes not being affected by adding or deleting interfaces, system reboots, and software or hardware changes. With this command configured, indexes of both the existing interfaces and newly created interfaces are constant.
Before rebooting the system, execute the save command first. Otherwise, interface indexes on the device might change after the reboot.
Examples
# Enable SNMP interface index constancy.
<Sysname> system-view
[Sysname] ifindex-constant enable
ifindex-constant max-number
Use ifindex-constant max-number to set the maximum number of constant interface indexes.
Use undo ifindex-constant max-number to restore the default.
Syntax
ifindex-constant max-number number
undo ifindex-constant max-number
Default
The maximum number of constant interface indexes is 131070.
Views
System view
Predefined user roles
network-admin
Parameters
number: Specifies the maximum number of constant interface indexes. The value range for this argument is 0 to 131070. With the maximum number of constant interface indexes set to 0, no interface indexes will be constant.
Usage guidelines
Before configuring this command, enable SNMP interface index constancy on MIB.
Examples
# Set the maximum number of constant interface indexes to 1000.
<Sysname> system-view
[Sysname] ifindex-constant max-number 1000
Related commands
ifindex-constant enable
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 [ cpu cpu-number ] high-threshold high-value low-threshold low-value interval interval [ shutdown ]
undo ifmonitor crc-error slot slot-number [ cpu cpu-number ]
In IRF mode:
ifmonitor crc-error chassis chassis-number slot slot-number [ cpu cpu-number ] high-threshold high-value low-threshold low-value interval interval [ shutdown ]
undo ifmonitor crc-error chassis chassis-number slot slot-number [ cpu cpu-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
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.
shutdown: Shuts down an interface when the number of incoming CRC error packets on the interface crosses 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 crossing alarm is generated and the interface enters the alarm state when the number of incoming CRC error packets 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.)
cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.
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 crosses the upper threshold, the interface generates an upper threshold crossing 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.
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 CRC error packet alarms.
<Sysname> system-view
[Sysname] ifmonitor crc-error slot 3 high-threshold 5000 low-threshold 400 interval 6
Related commands
snmp-agent trap enable ifmonitor
ifmonitor giant
Use ifmonitor giant to configure global giant packet alarm parameters.
Use undo ifmonitor giant to restore the default.
Syntax
In standalone mode:
ifmonitor giant slot slot-number [ cpu cpu-number ] high-threshold high-value low-threshold low-value interval interval [ shutdown ]
undo ifmonitor giant slot slot-number [ cpu cpu-number ]
In IRF mode:
ifmonitor giant chassis chassis-number slot slot-number [ cpu cpu-number ] high-threshold high-value low-threshold low-value interval interval [ shutdown ]
undo ifmonitor giant chassis chassis-number slot slot-number [ cpu cpu-number ]
Default
The upper threshold is 1000, the lower threshold is 100, and the statistics collection and comparison interval is 10 seconds for giant packet alarms.
Views
System view
Predefined user roles
network-admin
Parameters
high-threshold high-value: Specifies the upper threshold for giant packet alarms, in the range of 1 to 4294967295 packets.
interval interval: Specifies the statistics collection and comparison interval for giant packets, in the range of 1 to 65535 seconds.
interval interval: Specifies the statistics collection and comparison interval for giant packets, in the range of 1 to 65535 seconds.
shutdown: Shuts down an interface when the number of incoming giant packets on the interface crosses 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 crossing alarm is generated and the interface enters the alarm state when the number of incoming giant packets 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.)
cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.
Usage guidelines
With the giant packet alarm function enabled, when the number of incoming giant packets 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 incoming giant 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 giant 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.
If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Set the upper threshold to 5, lower threshold to 4, and statistics collection and comparison interval to 6 seconds for giant packet alarms.
<Sysname> system-view
[Sysname] ifmonitor giant slot 3 high-threshold 5 low-threshold 4 interval 6
Related commands
port ifmonitor giant
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
ifmonitor input-buffer-drop slot slot-number [ cpu cpu-number ] high-threshold high-value low-threshold low-value interval interval [ shutdown ]
undo ifmonitor input-buffer-drop slot slot-number [ cpu cpu-number ]
ifmonitor input-buffer-drop chassis chassis-number slot slot-number [ cpu cpu-number ] high-threshold high-value low-threshold low-value interval interval [ shutdown ]
undo ifmonitor input-buffer-drop chassis chassis-number slot slot-number [ cpu cpu-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
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.
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.
cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.
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 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.
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 slot 3 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 [ cpu cpu-number ] high-threshold high-value low-threshold low-value interval interval [ shutdown ]
undo ifmonitor input-error slot slot-number [ cpu cpu-number ]
In IRF mode:
ifmonitor input-error chassis chassis-number slot slot-number [ cpu cpu-number ] high-threshold high-value low-threshold low-value interval interval [ shutdown ]
undo ifmonitor input-error chassis chassis-number slot slot-number [ cpu cpu-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
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 crosses 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 crossing alarm is generated and the interface enters the alarm state when the number of input error packets 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.)
cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.
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 crosses the upper threshold, the interface generates an upper threshold crossing 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.
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 input error packet alarms.
<Sysname> system-view
[Sysname] ifmonitor input-error slot 3 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 [ cpu cpu-number ] high-threshold high-value low-threshold low-value
undo ifmonitor input-usage slot slot-number [ cpu cpu-number ]
In IRF mode:
ifmonitor input-usage chassis chassis-number slot slot-number [ cpu cpu-number ] high-threshold high-value low-threshold low-value
undo ifmonitor input-usage chassis chassis-number slot slot-number [ cpu cpu-number ]
Default
The upper threshold is 90, and the lower threshold is 80.
Views
System view
Predefined user roles
network-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.)
cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.
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 crosses the upper threshold, the interface generates an upper threshold crossing 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.
To set the statistics polling interval, use the flow-interval command.
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.
If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Set the upper threshold to 95 and lower threshold to 80 for input bandwidth usage alarms.
<Sysname> system-view
[Sysname] ifmonitor input-usage slot 3 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
ifmonitor output-buffer-drop slot slot-number [ cpu cpu-number ] high-threshold high-value low-threshold low-value interval interval [ shutdown ]
undo ifmonitor output-buffer-drop slot slot-number [ cpu cpu-number ]
ifmonitor output-buffer-drop chassis chassis-number slot slot-number [ cpu cpu-number ] high-threshold high-value low-threshold low-value interval interval [ shutdown ]
undo ifmonitor output-buffer-drop chassis chassis-number slot slot-number [ cpu cpu-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
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.
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.
cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.
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 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.
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 slot 3 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 [ cpu cpu-number ] high-threshold high-value low-threshold low-value interval interval [ shutdown ]
undo ifmonitor output-error slot slot-number [ cpu cpu-number ]
In IRF mode:
ifmonitor output-error chassis chassis-number slot slot-number [ cpu cpu-number ] high-threshold high-value low-threshold low-value interval interval [ shutdown ]
undo ifmonitor output-error chassis chassis-number slot slot-number [ cpu cpu-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
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 crosses 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 crossing alarm is generated and the interface enters the alarm state when the number of output error packets 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.)
cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.
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 crosses the upper threshold, the interface generates an upper threshold crossing 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.
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 output error packet alarms.
<Sysname> system-view
[Sysname] ifmonitor output-error slot 3 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 [ cpu cpu-number ] high-threshold high-value low-threshold low-value
undo ifmonitor output-usage slot slot-number [ cpu cpu-number ]
In IRF mode:
ifmonitor output-usage chassis chassis-number slot slot-number [ cpu cpu-number ] high-threshold high-value low-threshold low-value
undo ifmonitor output-usage chassis chassis-number slot slot-number [ cpu cpu-number ]
Default
The upper threshold is 90, and the lower threshold is 80.
Views
System view
Predefined user roles
network-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.)
cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.
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 crosses the upper threshold, the interface generates an upper threshold crossing 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.
To set the statistics polling interval, use the flow-interval command.
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.
If 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 output bandwidth usage alarms.
<Sysname> system-view
[Sysname] ifmonitor output-usage slot 3 high-threshold 80 low-threshold 60
Related commands
flow-interval
snmp-agent trap enable ifmonitor
ifmonitor runt
Use ifmonitor runt to configure global runt packet alarm parameters.
Use undo ifmonitor runt to restore the default.
Syntax
In standalone mode:
ifmonitor runt slot slot-number [ cpu cpu-number ] high-threshold high-value low-threshold low-value interval interval [ shutdown ]
undo ifmonitor runt slot slot-number [ cpu cpu-number ]
In IRF mode:
ifmonitor runt chassis chassis-number slot slot-number [ cpu cpu-number ] high-threshold high-value low-threshold low-value interval interval [ shutdown ]
undo ifmonitor runt chassis chassis-number slot slot-number [ cpu cpu-number ]
Default
The upper threshold is 1000, the lower threshold is 100, and the statistics collection and comparison interval is 10 seconds for runt packet alarms.
Views
System view
Predefined user roles
network-admin
Parameters
high-threshold high-value: Specifies the upper threshold for runt packet alarms, in the range of 1 to 4294967295 packets.
low-threshold low-value: Specifies the lower threshold for runt packet alarms, in the range of 1 to 4294967295 packets.
interval interval: Specifies the statistics collection and comparison interval for runt packets, in the range of 1 to 65535 seconds.
shutdown: Shuts down an interface when the number of incoming runt packets on the interface crosses 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 crossing alarm is generated and the interface enters the alarm state when the number of incoming runt packets 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.)
cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.
Usage guidelines
With the runt packet alarm function enabled, when the number of incoming runt packets 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 incoming runt 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 runt 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.
If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Set the upper threshold to 5, lower threshold to 4, and statistics collection and comparison interval to 6 seconds for runt packet alarms.
<Sysname> system-view
[Sysname] ifmonitor runt slot 3 high-threshold 5 low-threshold 4 interval 6
Related commands
port ifmonitor runt
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
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 99999999. On a main interface, you can create up to 16383 subinterfaces.
Examples
# Enter the view of Ten-GigabitEthernet 3/1/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/1]
# Create Ethernet subinterface Ten-GigabitEthernet 3/1/1.1 and enter its view.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1.1
[Sysname-Ten-GigabitEthernet3/1/1.1]
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 the maximum length to pass through.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Predefined user roles
network-admin
Parameters
size: Sets the maximum length (in bytes) of Ethernet frames that are allowed to pass through. The value range for this argument varies as follows:
· For interfaces on PIC-PS2G4L and PIC-TCP8L subcards in an SPEX-1204 card, the value range is 1552 to 2048 bytes.
· For interfaces on PIC-XP1L subcards in an SPEX-1204 card, the value range is 1552 to 9600 bytes.
· For interfaces on PIC-GP10L subcards in an SPEX-1204 card, the value range is 1552 to 3072 bytes.
· For interfaces on MIC-XP10LF interface subcards, the value range is 1552 to 10240 bytes.
Usage guidelines
If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Allow jumbo frames to pass through Ten-GigabitEthernet 3/1/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/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 for link-down events is not configured.The physical state change suppression interval for link-up events is one second.
Views
Ethernet interface view
Predefined user roles
network-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 is in seconds and the value range is 0 to 300.
· If you specify the msec keyword, the value range is 0 to 10000 milliseconds, and the value must be a multiple of 10.
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.
Interfaces on a MIC-GP4L subcard in a CSPEX-2304X-G or CSPEX-2304X-LG card do not support this command.
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 with spanning tree protocols enabled.
Examples
# Set the link-down event suppression interval to 8 seconds on Ten-GigabitEthernet 3/1/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/1] link-delay down 8
# Set the link-up event suppression interval to 800 milliseconds on Ten-GigabitEthernet 3/1/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/1] link-delay up msec 800
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
undo link-flap protect enable
Default
Link flapping protection is disabled globally.
Views
System view
Predefined user roles
network-admin
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 crosses 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.
Examples
# Enable link flapping protection globally.
<Sysname> system-view
[Sysname] link-flap protect enable
Related commands
port link-flap protect enable
loopback
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 { external | internal }
undo loopback
Default
Loopback testing is disabled on an Ethernet interface.
Views
Ethernet interface view
Predefined user roles
network-admin
Parameters
external: Enables external loopback testing on the Ethernet interface.
internal: Enables internal loopback testing on the Ethernet interface.
Usage guidelines
The internal keyword can be configured but does not take effect on the following interfaces:
· Interfaces on the CEPC-XP48RX card.
· Interfaces on the MIC-CP1L, MIC-QP1L, and MIC-XP2L-LAN subcards.
· The first interface on the MIC-XP5L subcard.
After the following interfaces are changed to GE interfaces by using the using gigabit command, they do not support the internal keyword:
· All interfaces on the MIC-XP2L, and MIC-XP4L1, MIC-XP5L2, and MIC-XP20L subcards.
· The last four interfaces on the MIC-XP5L and MIC-XP5L1 subcards.
Interfaces on the MIC-XP10LF interface subcards support external loopback testing. When you perform external loopback testing on such interfaces, you must make sure the peed of interfaces at both ends is 10GE.
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 and loopback commands are mutually exclusive.
Examples
# Enable internal loopback testing on Ten-GigabitEthernet 3/1/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/1] loopback internal
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 | base-r | none | rs-fec }
undo port fec mode
Default
The FEC mode of an interface is autonegotiated.
Views
25-GE interface view
100-GE interface view
Predefined user roles
network-admin
Parameters
auto: Autonegotiates the FEC mode or disables FEC according to the transceiver module type.
base-r: Specifies the BASE-R FEC mode. 100-GE interfaces do not support this keyword.
none: Performs no FEC.
rs-fec: Specifies the RS-FEC mode.
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.
When the FEC mode of an interface is auto, the FEC mode of the interface is determined by the transceiver module installed in the interface.
Make sure you set the same FEC mode for both interfaces of a link. The current Ethernet interface is operating at 10 Gbps. If you configure the port fec mode command on the interface, interface flapping will occur.
Examples
# Set the FEC mode of Twenty-FiveGigE 3/1/1 to autonegotiation.
<Sysname> system-view
[Sysname] interface twenty-fivegige 3/1/1
[Sysname-Twenty-FiveGigE3/1/1] port fec mode auto
# Set the FEC mode of HundredGigE 3/1/1 to autonegotiation.
<Sysname> system-view
[Sysname] interface hundredgige 3/1/1
[Sysname-HundredGigE3/1/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 [ 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
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.
shutdown: Shuts down an interface when the number of incoming CRC error packets on the interface crosses 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 crossing alarm is generated and the interface enters the alarm state when the number of incoming CRC error packets crosses the upper threshold on the interface.
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 crosses the upper threshold, the interface generates an upper threshold crossing 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.
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 CRC error packet alarms on Ten-GigabitEthernet 3/1/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/1] port ifmonitor crc-error high-threshold 5000 low-threshold 400 interval 6
Related commands
snmp-agent trap enable ifmonitor
port ifmonitor giant
Use port ifmonitor giant to configure giant packet alarm parameters for an interface.
Use undo port ifmonitor giant to restore the default.
Syntax
port ifmonitor giant high-threshold high-value low-threshold low-value interval interval [ shutdown ]
undo port ifmonitor giant
Default
An interface uses the global giant packet alarm parameters.
Views
Ethernet interface view
Predefined user roles
network-admin
Parameters
high-threshold high-value: Specifies the upper threshold for giant packet alarms, in the range of 1 to 4294967295.
low-threshold low-value: Specifies the lower threshold for giant packet alarms, in the range of 1 to 4294967295.
interval interval: Specifies the statistics collection and comparison interval for giant packets, in the range of 1 to 65535 seconds.
shutdown: Shuts down an interface when the number of incoming giant packets on the interface crosses 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 crossing alarm is generated and the interface enters the alarm state when the number of incoming giant packets crosses the upper threshold on the interface.
Usage guidelines
With the giant packet alarm function enabled, when the number of incoming giant packets 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 incoming giant 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 giant 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.
If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Set the upper threshold to 5, lower threshold to 4, and statistics collection and comparison interval to 6 seconds for giant packet alarms on Ten-GigabitEthernet 3/1/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/1] port ifmonitor giant high-threshold 5 low-threshold 4 interval 6
Related commands
ifmonitor giant
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
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 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.
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-GigabitEthernet3/1/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/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
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 crosses 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 crossing alarm is generated and the interface enters the alarm state when the number of input error packets crosses the upper threshold on the interface.
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 crosses the upper threshold, the interface generates an upper threshold crossing 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.
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 input error packet alarms on Ten-GigabitEthernet 3/1/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/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
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 crosses the upper threshold, the interface generates an upper threshold crossing 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.
To set the statistics polling interval, use the flow-interval command.
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.
If 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/1/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/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
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 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.
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-GigabitEthernet3/1/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/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
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 crosses 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 crossing alarm is generated and the interface enters the alarm state when the number of output error packets crosses the upper threshold on the interface.
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 crosses the upper threshold, the interface generates an upper threshold crossing 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.
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 output error packet alarms on Ten-GigabitEthernet 3/1/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/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
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 crosses the upper threshold, the interface generates an upper threshold crossing 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.
To set the statistics polling interval, use the flow-interval command.
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.
If 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/1/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/1] port ifmonitor output-usage high-threshold 9 low-threshold 7
Related commands
flow-interval
snmp-agent trap enable ifmonitor
port ifmonitor runt
Use port ifmonitor runt to configure runt packet alarm parameters for an interface.
Use undo port ifmonitor runt to restore the default.
Syntax
port ifmonitor runt high-threshold high-value low-threshold low-value interval interval [ shutdown ]
undo port ifmonitor runt
Default
An interface uses the global runt packet alarm parameters.
Views
Ethernet interface view
Predefined user roles
network-admin
Parameters
high-threshold high-value: Specifies the upper threshold for runt packet alarms, in the range of 1 to 4294967295.
low-threshold low-value: Specifies the lower threshold for runt packet alarms, in the range of 1 to 4294967295.
interval interval: Specifies the statistics collection and comparison interval for runt packets, in the range of 1 to 65535 seconds.
shutdown: Shuts down an interface when the number of incoming runt packets on the interface crosses 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 crossing alarm is generated and the interface enters the alarm state when the number of incoming runt packets crosses the upper threshold on the interface.
Usage guidelines
With the runt packet alarm function enabled, when the number of incoming runt packets 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 incoming runt 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 runt 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.
If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Set the upper threshold to 5, lower threshold to 4, and statistics collection and comparison interval to 6 seconds for runt packet alarms on Ten-GigabitEthernet 3/1/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/1] port ifmonitor runt high-threshold 5 low-threshold 4 interval 6
Related commands
ifmonitor runt
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 [ interval interval | threshold threshold ] *
undo port link-flap protect enable [ interval | threshold ]
Default
Link flapping protection is disabled on an interface.
Ethernet interface view
Predefined user roles
network-admin
Parameters
interval: Specifies the link flapping detection interval in seconds. The value range for this argument is 10 to 60. The default value for this argument is 10.
threshold: Specifies the link flapping detection threshold. The default value for this argument is 5. The value range for this argument is 5 to 10.
Usage guidelines
Link flapping protection takes effect only when it is enabled in both system view and interface view.
If you do not specify the interval interval or threshold threshold option when you execute the port link-flap protect enable command, the command uses the default 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 the link flapping detection interval, if the number of detected flaps reaches or crosses the link flapping detection threshold, the system shuts down the interface.
To bring up an interface that has been shut down by link flapping protection, execute the undo shutdown command.
This command and the dampening 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/1/1
[Sysname-Ten-GigabitEthernet 3/1/1] port link-flap protect enable interval 10 threshold 5
Related commands
dampening
link-flap protect enable
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
An Ethernet interface operates in Layer 3 mode.
Views
Ethernet interface view
Predefined user roles
network-admin
Parameters
bridge: Specifies the Layer 2 mode.
route: Specifies the Layer 3 mode.
Usage guidelines
CAUTION: Changing the link mode of an Ethernet interface also restores all commands (except shutdown and combo enable) on the Ethernet interface to their defaults in the new link mode. |
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/1/1 to operate in Layer 2 mode.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/1] port link-mode bridge
The configuration of the interface will be restored to the default. Continue? [Y/N]:y
port training
Use port training to configure link compensation on an interface.
Use undo port training to restore the default.
Syntax
port training enable
undo port training
Default
Link compensation is disabled on an interface.
Views
25-GE interface view
Predefined user roles
network-admin
Parameters
enable: Enables link compensation.
The disable keyword is not supported.
Usage guidelines
Link compensation enables the sending and receiving ends to exchange pre-emphasis and equalization parameters through frames. This feature improves the performance of pre-emphasis and equalization.
You must enable or disable link compensation on both interfaces of a link.
Examples
# Enable link compensation on Twenty-FiveGigE 3/1/1.
<Sysname> system-view
[Sysname] interface twenty-fivegige 3/1/1
[Sysname-Twenty-FiveGigE3/1/1] port training enable
port-mode
Use port-mode to configure a 10-GE interface to operate in LAN or WAN mode.
Use undo port-mode to restore the default.
Syntax
port-mode { lan | wan }
undo port-mode
Default
A 10-GE interface operates in LAN mode.
Views
10-GE interface view
Predefined user roles
network-admin
Parameters
lan: Configures the interface to operate in LAN mode. An interface operating in this mode transmits Ethernet packets and connects an Ethernet network.
wan: Configures the interface to operate in WAN mode. An interface operating in this mode transmits SDH packets and connects an SDH network. In addition, it supports point-to-point links only.
Usage guidelines
Only interfaces on a MIC-XP2L, MIC-XP2L-LAN, MIC-XP4L1, MIC-XP5L1, MIC-XP8L, MIC-XP10LF, MIC-XP20L, NIC-XP5L, NIC-XP10L, NIC-XP20L, NIC-XP20L1, PIC-XP1L RX-NIC-XP5L, RX-NIC-XP10L, or RX-NIC-XP20L subcard and the last four interfaces on a MIC-XP5L interface subcard support this command.
A 10-GE interface on a MIC-XP2L, MIC-XP2L-LAN, MIC-XP4L1, MIC-XP5L, MIC-XP5L1, or MIC-XP10L-LAN subcard in a CSPEX-2304X-G or CSPEX-2304X-LG card does not support WAN mode.
A 10-GE interface on a NIC-XP5L or NIC-XP10L subcard in a CSPEX-2612X-E card does not support WAN mode.
A 10-GE interface on a MIC-XP5L2 subcard does not support WAN mode.
Examples
# Configure Ten-GigabitEthernet 3/1/1 to operate in WAN mode.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet3/1/1
[Sysname-Ten-GigabitEthernet3/1/1] port-mode wan
priority-flow-control inner-port
Use priority-flow-control inner-port to enable PFC on inner interfaces.
Use undo priority-flow-control inner-port to disable PFC on inner interfaces.
Syntax
priority-flow-control inner-port { auto | enable }
undo priority-flow-control inner-port
Default
PFC is disabled on inner interfaces.
Views
System view
Predefined user roles
network-admin
Parameters
auto: Specifies PFC in auto mode. In this mode, the local end automatically negotiates the PFC status with its peer.
enable: Forcibly enables PFC.
Usage guidelines
An inner interface is the inner Ethernet interface through which a card communicates with the device, and is invisible for users.
With PFC enabled on an inner interface, when the traffic from an LPU to a switching fabric module is congested, the inner interface on the switching fabric module sends PFC pause frames to the inner interface on the LPU to notify the LPU to stop sending packets to the switching fabric module. When congestion is eliminated, the inner interface on the switching fabric module notifies the LPU to continue to send packets to the switching fabric module. This rule also applies to the traffic from a switching fabric module to an LPU.
Examples
# Enable PFC on inner interfaces.
<Sysname> system-view
[Sysname] priority-flow-control inner-port enable
Related commands
priority-flow-control inner-port no-drop
priority-flow-control inner-port no-drop
Use priority-flow-control inner-port no-drop to enable PFC for 802.1p priorities on inner interfaces.
Use undo priority-flow-control inner-port no-drop to disable PFC for 802.1p priorities on inner interfaces.
Syntax
priority-flow-control inner-port no-drop dot1p dot1p-list
undo priority-flow-control inner-port no-drop dot1p dot1p-list
Default
PFC is disabled for all 802.1p priorities on inner interfaces.
Views
System view
Predefined user roles
network-admin
Parameters
dot1p-list: Specifies an 802.1p priority (or dot1p priority) list to identify flows that are subject to PFC (for example: 1,3-5). A hyphen (-) connects two numeric values, which together indicate a continuous value range. Different values or value ranges are separated with commas (,). You can configure up to 16 characters for this argument.
Usage guidelines
With PFC enabled and this command configured on inner interfaces, when an inner interface is congested, the inner interface will send PFC pause frames to notify the peer inner interface to stop sending packets carrying the specified 802.1p priorities to prevent these packets from being dropped due to congestion. For more information about 802.1p priorities, see ACL and QoS Configuration Guide.
Examples
# Enable PFC for 802.1p priority 1 on inner interfaces.
<Sysname> system-view
[Sysname] priority-flow-control inner-port no-drop dot1p 1
Related commands
priority-flow-control inner-port enable
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
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.
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/1/1.
<Sysname> reset counters interface ten-gigabitethernet 3/1/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
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.
Usage guidelines
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 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/1/1.
<Sysname> reset counters interface ten-gigabitethernet 3/1/1
reset counters slot
Use reset counters slot to clear statistics on cards and statistics on the interfaces on the cards.
Syntax
reset counters slot [ slot-number ]
reset counters chassis [ chassis-number [ slot slot-number ] ]
Views
User view
Predefined user roles
network-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.
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.
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 [ cpu cpu-number ] ]
In IRF mode:
reset ethernet statistics [ chassis chassis-number slot slot-number [ cpu cpu-number ] ]
Views
User view
Predefined user roles
network-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.)
cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.
Examples
# (In standalone mode.) Clear the Ethernet module statistics for the specified slot.
<Sysname> reset ethernet statistics slot 3
Related commands
display ethernet statistics
reset ifindex-constant map
Use reset ifindex-constant map to clear the interface name-constant interface index mappings.
Syntax
reset ifindex-constant map
Views
User view
Predefined user roles
network-admin
Usage guidelines
This command clears only the interface name-constant interface index mappings on the device. The interface name-constant interface index mappings in the flash files will not be cleared by this command. After executing this command, the system will also update the interface name-interface index mappings according to existing interface indexes.
Before executing this command, enable SNMP interface index constancy.
Examples
# Clear the interface name-constant interface index mappings.
<Sysname> reset ifindex-constant map
Related commands
display ifindex-constant map
ifindex-constant enable
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
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 up interfaces that have traffic counters.
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/1/1.
<Sysname> reset link-state-change statistics interface ten-gigabitethernet 3/1/1
Related commands
display link-state-change statistics interface
reset packet-drop interface
Use reset packet-drop interface to clear the dropped packet statistics for an interface.
Syntax
reset packet-drop interface [ interface-type [ interface-number ] ]
Views
User view
Predefined user roles
network-admin
Parameters
interface-type: Specify an interface type. If you do not specify an interface type, this command clears dropped packet statistics for all interfaces on the device.
interface-number: Specify an interface number. If you do not specify this argument, the command clears dropped packet statistics for all interfaces of the specified type.
Examples
# Clear dropped packet statistics for Ten-GigabitEthernet 3/1/1.
<Sysname> reset packet-drop interface ten-gigabitethernet 3/1/1
# Clear dropped packet statistics for all interfaces.
<Sysname> reset packet-drop interface
Related commands
display packet-drop
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
An Ethernet interface or subinterface is up.
Views
Ethernet interface view
Ethernet subinterface view
Predefined user roles
network-admin
Usage guidelines
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 and loopback commands are mutually exclusive.
Examples
# Shut down and then bring up Ten-GigabitEthernet 3/1/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/1] shutdown
[Sysname-Ten-GigabitEthernet3/1/1] undo shutdown
# Shut down and then bring up Ten-GigabitEthernet 3/1/1.1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1.1
[Sysname-Ten-GigabitEthernet3/1/1.1] shutdown
[Sysname-Ten-GigabitEthernet3/1/1.1] undo shutdown
shutdown all-physical-interface
Use shutdown all-physical-interfaces to shut down all physical interfaces.
Use undo shutdown all-physical-interfaces to bring up all physical 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
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 and IRF physical 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 a shutdown interface, execute the undo shutdown all-physical-interfaces command in system view and execute the undo shutdown command 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.
<Sysname> system-view
[Sysname] shutdown all-physical-interfaces
Related commands
shutdown
slot-monitor packet-drop
Use snmp-agent trap enable ifmonitor to configure packet-drop alarm parameters for a specified card or all cards.
Use undo snmp-agent trap enable ifmonitor to restore the default.
Syntax
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
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
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.
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.
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 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 | giant | input-buffer-drop | input-error | input-usage | output-buffer-drop | output-error | output-usage | runt ] *
undo snmp-agent trap enable ifmonitor [ crc-error | giant | input-buffer-drop | input-error | input-usage | output-buffer-drop | output-error | output-usage | runt ] *
Default
Interface alarm functions are enabled.
Views
System view
Predefined user roles
network-admin
Parameters
crc-error: Enables the CRC error packet alarm function for interfaces.
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.
input-usage: Enables the input bandwidth usage alarm function for interfaces.
output-buffer-drop: Enables the packet-drop alarm function for the egress buffer.
output-error: Enables the output error packet alarm function for interfaces.
output-usage: Enables the output bandwidth usage alarm function for interfaces.
runt: Enables the runt packet alarm function for interfaces.
Examples
# Enable the CRC error packet alarm function for interfaces.
<Sysname> system-view
[Sysname] snmp-agent trap enable ifmonitor crc-error
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
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 | 10000 | 25000 | 40000 | 50000 | 100000 | auto }
undo speed
Default
The speed of a GE interface is autonegotiated. The speed of a 10-GE/40-GE/100-GE interface is its maximum speed.
Views
Ethernet interface view
Predefined user roles
network-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.
10000: Sets the interface speed to 10000 Mbps.
25000: Sets the interface speed to 25000 Mbps.
40000: Sets the interface speed to 40000 Mbps.
50000: Sets the interface speed to 50000 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, the transceiver module cannot be used if either of the following conditions exists:
· 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.
· 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.
Support of an interface for the keywords of this command varies. For more information, use the speed ? command in interface view.
A 40-GE or 100-GE interface can only operate at its maximum speed.
When you configure the speed for interfaces on 10-GE interface subcards in CEPC-XP4LX, CEPC-XP24LX, CEPC-XP48RX, CEPC-CP4RX, CEPC-CP4RX-L, CSPEX-1304X, CSPEX-1304S, CSPEX-1404X, CSPEX-1404S, CSPEX-1502X, CSPEX-1504X, CSPEX-1504S, CSPEX-1602X, CSPEX-1804X, CSPEX-1512X, CSPEX-1612X, CSPEX-1812X, and RX-SPE200, follow these restrictions and guidelines:
· Only MIC-XP2L, MIC-XP2L-LAN, MIC-XP4L1, MIC-XP5L, MIC-XP5L1, MIC-XP5L2, MIC-XP20L, NIC-XP10L, NIC-XP20L, and NIC-XP20L1 interface subcards support switching the speed between 1000 Mbps and 10000 Mbps. The other 10-GE interface subcards do not support switching the speed between 1000 Mbps and 10000 Mbps.
· After the speed auto command is executed on an interface in a MIC-XP2L, MIC-XP2L-LAN, MIC-XP4L1, MIC-XP5L, MIC-XP5L1, MIC-XP5L2, MIC-XP20L, NIC-XP10L, or NIC-XP20L interface subcard, the speed can be autonegotiated to 10 Mbps, 100 Mbps, or 1000 Mbps.
· After the speed auto command is executed on an interface in a NIC-XP20L1 interface subcard, the speed can be autonegotiated to 10 Mbps, 100 Mbps, 1000 Mbps, or 10000 Mbps.
· Interfaces 1 and 2 on a MIC-XP2L or MIC-XP2L-LAN interface subcard are in the same interface group. When you change the speed for an interface, the speed is changed for all the other interfaces in the same interface group.
· On a MIC-XP4L1 interface subcard, interfaces 1 and 3 are in the same interface group, and interfaces 2 and 4 are in the same interface group. When you change the speed for an interface, the speed is changed for all the other interfaces in the same interface group.
· On a MIC-XP20L interface subcard, interfaces 1 and 2, interfaces 3 and 4, interfaces 5 and 6, interfaces 7 and 8, interfaces 9 and 10, interfaces 11 and 12, interfaces 13 and 14, interfaces 15 and 16, interfaces 17 and 18, and interfaces 19 and 20 are in the same interface groups separately. When you change the speed for an interface, the speed is changed for all the other interfaces in the same interface group.
· On a NIC-XP10L interface subcard, interfaces 1 and 2, interfaces 3 and 4, interfaces 5 and 6, interfaces 7 and 8, and interfaces 9 and 10 are in the same interface groups separately. When you change the speed for an interface, the speed is changed for all the other interfaces in the same interface group.
· On a NIC-XP20L interface subcard, interfaces 1 and 4, interfaces 2 and 6, interfaces 3 and 7, interfaces 5 and 8, interfaces 9 and 12, interfaces 10 and 11, interfaces 13 and 16, interfaces 14 and 15, interfaces 17 and 20, and interfaces 18 and 19 are in the same interface groups separately. When you change the speed for an interface, the speed is changed for all the other interfaces in the same interface group.
· On a NIC-XP20L1 interface subcard, you can change the speed for a single interface.
When you configure the speed for interfaces on 10-GE interface subcards in CEPC-CQ8L, CEPC-CQ16L1, CEPC-DQ2L1-G, CSPEX-1802XB, CSPEX-1802X, CSPEX-1812X-E, CSPEX-2304X-G, CSPEX-2304X-LG, CSPEX-2612X-E, and RX-SPE200-E, follow these restrictions and guidelines:
· Only MIC-XP5L, MIC-XP5L1, MIC-XP5L2, and NIC-XP20L1 interface subcards support switching the speed between 1000 Mbps and 10000 Mbps. The other 10-GE interface subcards do not support switching the speed between 1000 Mbps and 10000 Mbps.
· After the speed auto command is executed on an interface in a NIC-XP20L1 interface subcard, the speed can be autonegotiated to 10 Mbps, 100 Mbps, 1000 Mbps, or 10000 Mbps.
· On a NIC-XP20L1 interface subcard, you can change the speed for a single interface.
When you configure the speed for interfaces on a NIC-XP5L or NIC-XP10L subcard on a CSPEX-2612X-E card, follow these restrictions and guidelines:
· The speeds of interfaces on a NIC-XP5L subcard can only be autonegotiated to 10000 Mbps.
· Use the speed 1000, speed 10000, using gigabit, and using tengige command to switch the speed of interfaces on a NIC-XP10L subcard between 1000 Mbps and 10000 Mbps. The speed auto command is not supported.
· The speeds of interfaces on a NIC-XP10L subcard cannot be autonegotiated to 10 Mbps or 100 Mbps.
· The speed of interfaces on a MIC-GP4L, MIC-XP5L, MIC-XP5L1, or MIC-XP5L2 subcard in a CSPEX-2304X-G or CSPEX-2304X-LG card cannot be autonegotiated to 10 Mbps or 100 Mbps.
· When you configure the speed for interfaces on a MIC-GP10L2, MIC-GT20L1, or MIC-XP2L-LAN interface subcard in a CSPEX-2304X-G or CSPEX-2304X-LG card, follow these restrictions and guidelines:
¡ After the speed auto command is executed on an interface on the MIC-GP10L2 or MIC-GT20L1 interface subcard, the speed can be autonegotiated to 10 Mbps, 100 Mbps, or 1000 Mbps.
¡ Interfaces on the MIC-GP10L2 or MIC-GT20L1 interface subcard support the speed 10, speed 100, and speed 1000 commands.
¡ The interface speed configured for the MIC-GP10L2 and MIC-GT20L1 interface subcards must be consistent with that for the peer end.
¡ Interfaces on a MIC-XP2L-LAN interface subcard support operating only at 1000 Mbps or 10000 Mbps.
¡ Interfaces on a MIC-XP2L-LAN interface subcard do not support the autonegotiation mode.
· When you configure the speed for interfaces on a MIC-XP5L, MIC-XP5L1, or MIC-XP5L2 interface subcard, follow these restrictions and guidelines:
¡ On a MIC-XP5L, MIC-XP5L1, or MIC-XP5L2 interface subcard in a CSPEX-1304X, CSPEX-1404X, or CSPEX-1504X card, interfaces 2 and 4 are in the same interface group, and interfaces 3 and 5 are in the same interface group. When you change the speed for an interface, the speed is changed for all the other interfaces in the same interface group. You cannot change the speed for interface 1 in a MIC-XP5L, MIC-XP5L1, or MIC-XP5L2 interface subcard.
¡ On a MIC-XP5L or MIC-XP5L1 interface subcard in a CSPEX-2304X-G or CSPEX-2304X-LG card, you can change the speed for a single interface.
¡ Interfaces 1 through 5 on a MIC-XP5L2 interface subcard in a CSPEX-2304X-G or CSPEX-2304X-LG card are in the same interface group. When you change the speed for an interface, the speed is changed for all the other interfaces in the same interface group. After speed change, the interface type will not change.
A GE interface on a MIC subcard in a SPEX-1204 card does not support the full or half duplex mode when it is operating at 10 Mbps or 100 Mbps.
MIC-XP10LF interface subcards support the speed 10, speed 100, speed 1000, speed 10000, and speed auto commands.
Examples
# Configure Ten-GigabitEthernet 3/1/1 to autonegotiate the speed.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/1] 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
The interframe gap and preamble statistics are enabled in the traffic statistics.
Views
Ethernet interface view
Predefined user roles
network-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.
Examples
# Enable interframe gap and preamble statistics in the traffic statistics for Ten-GigabitEthernet 3/1/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/1] traffic-statistic include-interframe
Traffic statistic will be set to include Inter-frame Gaps and Preambles. Continue? [Y/N]:y
Related commands
display interface
using fiftygige
Use using fiftygige to change a 100-GE interface or a 50-GE interface.
Syntax
using fiftygige
Default
A 100-GE interface is not changed to a 50-GE interface.
Views
100-GE interface view
Predefined user roles
network-admin
Usage guidelines
Change a 100-GE interface to a 50-GE interface when either of the following conditions is met:
· The peer is a 50-GE interface.
· No 100-GE transceiver module is available, and 50-GE transceiver modules are available.
Only fiber port 1 on a MIC-CQ1LF interface subcards supports this command. If fiber port 1 is a 100GE interface, fiber port 2 is not available. To use fiber port 2, execute this command to change the 100GE interface to 50GE fiber port 1 and 50GE fiber port 2.
Examples
# Change HundredGigE 3/1/1 to a 50-GE interface.
<Sysname> system-view
[Sysname] interface hundredgige 3/1/1
[Sysname-HundredGigE3/1/1] using fiftygige
The interface HundredGig 3/1/1 will be deleted. Continue? [Y/N]:y
Related commands
using hundredgige
using fortygige
Use using fortygige to combine breakout interfaces split from a 40-GE interface into a 40-GE interface or change a 100-GE to a 40-GE interface.
Syntax
using fortygige
Default
The 40-GE breakout interfaces are not combined and operate as single interfaces. A 100-GE interface is not changed to a 40-GE interface.
Views
10-GE breakout interface view
100-GE interface view
Predefined user roles
network-admin
Usage guidelines
If you need higher bandwidth on a single interface, you can combine 10-GE breakout interfaces split from a 40-GE interface into a 40-GE interface. 10-GE breakout interfaces split from a 40-GE interface can be combined only on the MIC-QP1L subcards.
To do so, execute this command on any of these 10-GE breakout interfaces.
Change a 100-GE interface to a 40-GE interface when the following conditions are met:
· The peer is a 40-GE interface.
· No 100-GE or 50-GE transceiver module is available, and 40-GE transceiver modules are available.
100-GE interfaces on MIC-CQ1L1, MIC-CQ1L2, and MIC-CQ2L subcards and CEPC-CP4RX-L cards can be changed to 40-GE interfaces.
Only fiber port 1 on a MIC-CQ1LF interface subcards supports this command. If fiber port 1 is a 100GE interface, fiber port 2 is not available. To use fiber port 2, execute this command to change the 100GE interface to 40GE fiber port 1 and 40GE fiber port 2.
Fiber ports 1, 2, 7, 8, 9, 10, 15, and 16 on CEPC-CQ16L1 cards support changing a 100-GE interface to a 40-GE interface.
Examples
# Combine Ten-GigabitEthernet 3/1/1:1 through Ten-GigabitEthernet 3/1/1:4 into a 40-GE interface.
<System> system-view
[System] interface ten-gigabitethernet3/1/1:1
[System-Ten-GigabitEthernet3/1/1:1] using fortygige
The interfaces Ten-GigabitEthernet3/1/1:1 through Ten-GigabitEthernet3/1/1:4 will be deleted. Continue? [Y/N]:y
# Change HundredGigE 3/1/1 to a 40-GE interface.
<System> system-view
[System] interface hundredgige 3/1/1
[System-HundredGigE3/1/1] using fortygige
The interface HundredGigE3/1/1 will be deleted. Continue? [Y/N]:y
Related commands
using hundredgige
using gigabit
Use using gigabit to change a 10-GE interface to a GE interface.
Syntax
using gigabit
Default
A 10-GE interface is not changed to a GE interface.
Views
10-GE interface view
Predefined user roles
network-admin
Usage guidelines
Change a 10-GE interface to a GE interface when either of the following conditions exists:
· The peer is a GE interface.
· No 10-GE transceiver module is available, and GE transceiver modules are available.
This command is available only for the following cards:
Card category |
Cards |
CEPC |
CEPC-XP4LX |
CSPEX |
CSPEX-1304X, CSPEX-1304S, CSPEX-1404X, CSPEX-1404S, CSPEX-1502X, CSPEX-1504X, CSPEX-1504S, CSPEX-1602X, CSPEX-1512X, CSPEX-1612X, CSPEX-1812X |
SPE |
RX-SPE200 |
The following subcards support this command: MIC-XP2L, MIC-XP2L-LAN, MIC-XP4L1, MIC-XP5L, MIC-XP5L1, MIC-XP5L2, MIC-XP10L-LAN, MIC-XP20L, NIC-XP10L, NIC-XP20L, RX-NIC-XP5L, RX-NIC-XP10L, and RX-NIC-XP20L.
When you switch a 10-GE interface to a GE interface, follow these restrictions and guidelines:
· On a MIC-XP5L, MIC-XP5L1, or MIC-XP5L2 interface subcard in a CSPEX-1304X, CSPEX-1404X, or CSPEX-1504X card, interfaces 2 and 4 are in the same interface group, and interfaces 3 and 5 are in the same interface group. When you change the speed for an interface, the speed is changed for all the other interfaces in the same interface group. You cannot change the speed for interface 1 in a MIC-XP5L, MIC-XP5L1, or MIC-XP5L2 interface subcard.
· On a MIC-XP5L or MIC-XP5L1 interface subcard in a CSPEX-2304X-G or CSPEX-2304X-LG card, you can change the speed for a single interface.
· Interfaces 1 through 5 on a MIC-XP5L2 interface subcard in a CSPEX-2304X-G or CSPEX-2304X-LG card are in the same interface group. When you change the speed for an interface, the speed is changed for all the other interfaces in the same interface group. After speed change, the interface type will not change.
· For the other interface subcards or cards, when you execute this command on an interface, this command changes two interfaces in the same group. For more information, see the command prompt. When a group contains an aggregation group member port, this command is not supported.
A GE interface switched from a 10-GE interface on a MIC-XP2L, MIC-XP4L1, MIC-XP5L, MIC-XP5L1, MIC-XP5L2, or MIC-XP10L-LAN subcard in a CSPEX-2304X-G or CSPEX-2304X-LG card cannot operate at 10 Mbps or 100 Mbps.
Examples
# Change Ten-GigabitEthernet 3/1/1 and Ten-GigabitEthernet 3/1/2 to GE interfaces.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/1] using gigabit
The interface Ten-GigabitEthernet3/1/1 and Ten-GigabitEthernet3/1/2 will be deleted. Continue? [Y/N]:y
Related commands
using tengige
using hundredgige
Use using hundredgige to restore a 40-GE/50-GE interface changed from a 100-GE interface back to a 100-GE interface.
Syntax
using hundredgige
Default
The 40-GE/50-GE interface is not changed to a 100-GE interface.
Views
View of a 40-GE interface changed from a 100-GE interface
50-GE breakout interface view
Predefined user roles
network-admin
Usage guidelines
If you need higher bandwidth on a single interface, perform the following tasks as needed:
· 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.
· You can restore a 50-GE interface that was changed from a 100-GE interface to a 100-GE interface. This command is only supported on a 50-GE interface that was changed from a 100-GE interface.
100-GE interfaces on MIC-CQ1L1, MIC-CQ1L2, and MIC-CQ2L subcards and CEPC-CP4RX-L and CEPC-CQ16L1 cards can be restored from 40-GE interfaces to 100-GE interfaces.
Only fiber port 1 on a MIC-CQ1LF interface subcards supports this command. If fiber port 1 is a 100GE interface, fiber port 2 is not available.
Fiber ports 1, 2, 7, 8, 9, 10, 15, and 16 on CEPC-CQ16L1 cards support restoring 40-GE interfaces changed from 100-GE interfaces to 100-GE interfaces.
Examples
# Restore FortyGigE 3/1/1 to a 100-GE interface.
<Sysname> system-view
[Sysname] interface fortygige 3/1/1
[Sysname-FortyGigE3/1/1] using hundredgige
The interface FortyGigE3/1/1 will be deleted. Continue? [Y/N]:y
Related commands
using fiftygige
using fortygige
using tengige
In 40-GE or 100-GE interface view, use using tengige to split a high bandwidth interface into multiple 10-GE breakout interfaces.
In the view of a GE interface changed from a 10-GE interface, use using tengige to restore a GE interface back to a 10-GE interface.
Syntax
using tengige
Default
A high bandwidth interface is not split and operates as a single interface. A GE interface changed from a 10-GE interface is not restored back to a 10-GE interface.
Views
40-GE interface view
GE interface view
25-GE interface view
Predefined user roles
network-admin
Usage guidelines
A high-bandwidth interface can be split into multiple 10-GE interfaces only on a MIC-QP1L subcard.
Only interfaces 1 through 4 on a MIC-XP10LF interface subcard supports splitting from a 25GE interface into 10-GE interfaces. When you do that, follow these restrictions and guidelines:
· Interfaces 1 and 7 are in the same group. When you split interface 1 from 25-GE into 10-GE interfaces, interface 7 is available.
· Interfaces 2 and 8 are in the same group. When you split interface 2 from 25-GE into 10-GE interfaces, interface 8 is available.
· Interfaces 3 and 9 are in the same group. When you split interface 3 from 25-GE into 10-GE interfaces, interface 9 is available.
· Interfaces 4 and 10 are in the same group. When you split interface 4 from 25-GE into 10-GE interfaces, interface 10 is available.
Restoring a GE interface changed from a 10-GE interface back to a 10-GE interface is supported only on the following cards:
Card category |
Cards |
CEPC |
CEPC-XP4LX |
CSPEX |
CSPEX-1304X, CSPEX-1304S, CSPEX-1404X, CSPEX-1404S, CSPEX-1502X, CSPEX-1504X, CSPEX-1504S, CSPEX-1602X, CSPEX-1512X, CSPEX-1612X, CSPEX-1812X |
SPE |
RX-SPE200 |
You can restore the interfaces on the following subcards back to 10-GE interfaces after you change them to GE interfaces: MIC-XP2L, MIC-XP2L-LAN, MIC-XP4L1, MIC-XP5L, MIC-XP5L1, MIC-XP5L2, MIC-XP10L-LAN, MIC-XP20L, NIC-XP10L, NIC-XP20L, RX-NIC-XP5L, RX-NIC-XP10L, and RX-NIC-XP20L.
When you restore a GE interface changed from a 10-GE interface to a 10-GE interface, follow these restrictions and guidelines:
· On a MIC-XP5L, MIC-XP5L1, or MIC-XP5L2 interface subcard in a CSPEX-1304X, CSPEX-1404X, or CSPEX-1504X card, interfaces 2 and 4 are in the same interface group, and interfaces 3 and 5 are in the same interface group. When you change the speed for an interface, the speed is changed for all the other interfaces in the same interface group. You cannot change the speed for interface 1 in a MIC-XP5L, MIC-XP5L1, or MIC-XP5L2 interface subcard.
· On a MIC-XP5L or MIC-XP5L1 interface subcard in a CSPEX-2304X-G or CSPEX-2304X-LG card, you can change the speed for a single interface.
· Interfaces 1 through 5 on a MIC-XP5L2 interface subcard in a CSPEX-2304X-G or CSPEX-2304X-LG card are in the same interface group. When you change the speed for an interface, the speed is changed for all the other interfaces in the same interface group. After speed change, the interface type will not change.
· For the other interface subcards or cards, when you execute this command on an interface, this command changes two interfaces in the same group. For more information, see the command prompt. When a group contains an aggregation group member port, this command is not supported.
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:
· You can split a 40GE FortyGigE 3/1/1 into four 10-GE breakout interfaces Ten-GigabitEthernet 3/1/1:1 through Ten-GigabitEthernet3/1/1:4.
· You can split a 25-GE interface Twenty-FiveGigE 3/1/1 into one 10-GE interface Ten-GigabitEthernet3/1/1.
The 10-GE breakout interfaces support the same configuration and attributes as common 10-GE interfaces, except that they are numbered in a different way.
If you need higher bandwidth, you can restore a GE interface that was changed from a 10-GE interface to a 10-GE interface.
Examples
# Split FortyGigE 3/1/1 into four 10-GE breakout interfaces.
<System> system-view
[System] interface fortygige 3/1/1
[System-FortyGigE3/1/1] using tengige
The interface FortyGigE3/1/1 will be deleted. Continue? [Y/N]:y
Reboot device to make the configuration take effect.
# Restore GigabitEthernet 3/1/1 and GigabitEthernet 3/1/2 back to 10-GE interfaces.
<Sysname> system-view
[Sysname] interface gigabitethernet 3/1/1
[Sysname-GigabitEthernet3/1/1] using tengige
The interface GigabitEthernet3/1/1 and GigabitEthernet3/1/2 will be deleted. Continue? [Y/N]:y
# Split Twenty-FiveGigE 3/1/1 into one 10-GE interface.
<System> system-view
[System] interface twenty-fivegige 3/1/1
[System-Twenty-FiveGigE3/1/1] using tengige
The interface Twenty-FiveGigE3/1/1 will be deleted. Continue? [Y/N]:y
Related commands
using using fortygige
using gigabit
using twenty-fivegige
using twenty-fivegige
Use using twenty-fivegige to split a 10-GE interface into a 25-GE breakout interface.
Syntax
using twenty-fivegige
Default
A 10-GE operates as a single interface.
Views
10-GE interface view
Predefined user roles
network-admin
Usage guidelines
To improve port density, reduce costs, and improve network flexibility, you can split a 10-GE interface into one 25-GE breakout interface. For example, you can split the 10-GE interface Ten-GigabitEthernet 3/1/1 into a 25-GE breakout interface Twenty-FiveGigE 3/1/1.
Only interfaces 1 through 4 on a MIC-XP10LF interface subcard supports splitting from a 10-GE interface into a 25-GE interface. When you do that, follow these restrictions and guidelines:
· Interfaces 1 and 7 are in the same group. When you split interface 1 from 10-GE into a 25-GE interface, interface 7 is not available.
· Interfaces 2 and 8 are in the same group. When you split interface 2 from 10-GE into a 25-GE interface, nterface 8 is not available.
· Interfaces 3 and 9 are in the same group. When you split interface 3 from 10-GE into a 25-GE interface, interface 9 is not available.
· Interfaces 4 and 10 are in the same group. When you split interface 4 from 10-GE into a 25-GE interface, interface 10 is not available.
Examples
# Change Ten-GigabitEthernet 3/1/1 to a 25-GE interface.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/1] using twenty-fivegige
The interface Ten-GigabitEthernet3/1/1 will be deleted. Continue? [Y/N]:y
Related commands
using tengige
Layer 3 Ethernet interface or subinterface commands
bridge-forwarding enable
Use bridge-forwarding enable to enable Layer 2 forwarding on an interface.
Use undo bridge-forwarding enable to disable Layer 2 forwarding on an interface.
Syntax
bridge-forwarding enable
undo bridge-forwarding enable
Default
Layer 2 forwarding is disabled on an interface.
Views
Layer 3 Ethernet interface view
Predefined user roles
network-admin
Usage guidelines
CAUTION: Executing this command on a Layer 3 Ethernet interface deletes physical layer-related configuration on that Layer 3 Ethernet interface. Use this command as needed. |
This command is available only for the following cards:
Card category |
Cards |
CEPC |
CEPC-XP4LX, CEPC-XP24LX, CEPC-XP48RX, CEPC-CP4RX, CEPC-CP4RX-L, CEPC-CQ8L, CEPC-CQ16L1, CEPC-DQ2L1-G |
CSPEX |
CSPEX-1304X, CSPEX-1304S, CSPEX-1404X, CSPEX-1404S, CSPEX-1502X, CSPEX-1504X, CSPEX-1504S, CSPEX-1602X, CSPEX-1804X, CSPEX-1512X, CSPEX-1612X, CSPEX-1812X, CSPEX-1802XB, CSPEX-1802X, CSPEX-1812X-E, CSPEX-2304X-G, CSPEX-2304X-LG, CSPEX-2612X-E |
SPE |
RX-SPE200, RX-SPE200-E |
After you execute this command, port mirroring configured on a Layer 3 Ethernet interface takes effect on the newly generated virtual Layer 2 interfaces. For more information about port mirroring, see Network Management and Monitoring Configuration Guide.
After you execute this command, outbound traffic shaping, rate limiting, WRED, and the queue scheduling profile configured on a Layer 3 Ethernet interface take effect on the newly generated virtual Layer 2 interfaces. For more information about traffic shaping, rate limiting, WRED, and the queue scheduling profile, see ACL and QoS Configuration Guide.
After this command is executed, the outbound rate limiting function and the queue scheduling profile configured through the user profile applied to an interface by using the qos apply user-profile command take effect on the newly generated virtual Layer 2 interface. For more information about the outbound rate limiting function and the queue scheduling profile configured through the user profile applied to an interface by using the qos apply user-profile command, see BRAS Services Configuration Guide.
By default, a Layer 3 interface only performs Layer 3 forwarding. This command enables a Layer 3 Ethernet interface to transmit VLAN tagged packets by creating a virtual Layer 2 Ethernet interface for that Layer 3 Ethernet interface. You can configure VLAN settings on the virtual Layer 2 Ethernet interface.
This command shuts down the data link layer of a Layer 3 Ethernet interface. While the Layer 3 Ethernet interface cannot provide Layer 3 services, its subinterfaces can terminate VLANs and continue to provide Layer 3 services.
When you use this command, follow these restrictions and guidelines:
· This command is not supported on a Layer 3 Ethernet interface that has been assigned to a Layer 3 aggregate interface.
· You cannot execute this command on a main interface whose subinterfaces terminate the outermost VLAN ID 1.
· The outermost VLAN IDs terminated by subinterfaces of a main interface cannot contain the PVID of and VLAN IDs permitted by the virtual Layer 2 interface created for the main interface.
· On a Layer 3 Ethernet interface with this command executed, you cannot perform the following tasks:
¡ Splitting an interface and switching the interface type.
¡ Switching the interface mode between bridge and route.
¡ Binding the interface to an IRF port as an IRF physical interface.
¡ Assigning an interface to a Layer 3 aggregation group.
Examples
# Enable Layer 2 forwarding on Layer 3 Ethernet interface Ten-GigabitEthernet 3/1/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/1] bridge-forwarding enable
This operation will clear the routing configuration that affects bridge forwarding on the interface. Continue?[Y/N]:y
interface virtual-bridge-port
Use interface virtual-bridge-port to enter virtual Layer 2 Ethernet interface view.
Syntax
interface virtual-bridge-port interface-number
Default
No virtual Layer 2 Ethernet interface exists.
Views
System view
Predefined user roles
network-admin
Parameters
interface-number: Specifies an interface number.
Usage guidelines
When you execute the bridge-forwarding enable command on a Layer 3 Ethernet interface, the device automatically creates a virtual Layer 2 Ethernet interface for that Layer 3 Ethernet interface. The virtual Layer 2 Ethernet interface forwards Layer 2 traffic for the Layer 3 Ethernet interface.
On a virtual Layer 2 Ethernet interface, you can execute the description command and port-based VLAN commands. For more information about port-based VLAN commands, see VLAN commands in Layer 2—LAN Switching Command Reference.
Examples
# Enter the view of the virtual Layer 2 Ethernet interface Virtual-Bridge-Port 3/1/1.
<Sysname> system-view
[Sysname] interface virtual-bridge-port 3/1/1
[Sysname-Virtual-Bridge-Port3/1/1]
Related commands
bridge-forwarding enable
description
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
The MAC address of a Layer 3 Ethernet interface is assigned by the device.
Views
Ethernet interface view
Predefined user roles
network-admin
Parameters
mac-address: Specifies a MAC address in the format of H-H-H.
Usage guidelines
This command is available only for the following cards:
Card category |
Cards |
CEPC |
CEPC-CP4RX, CEPC-CP4RX-L, CEPC-CQ8L, CEPC-XP4LX, CEPC-XP24LX, CEPC-XP48RX |
CSPEX |
CSPEX-1304X, CSPEX-1304S, CSPEX-1404X, CSPEX-1404S, CSPEX-1502X, CSPEX-1504X, CSPEX-1504S, CSPEX-1602X, CSPEX-1802X, CSPEX-1802XB, CSPEX-1804X, CSPEX-1512X, CSPEX-1612X, CSPEX-1812X, CSPEX-1812X-E, CSPEX-2304X-G, CSPEX-2304X-LG, CSPEX-2612X-E |
SPE |
RX-SPE200-E |
In standard mode, the MAC address range supported is 000f-e2ff-8000 to 000f-e2ff-80ff for Layer 3 aggregate interfaces with member ports in the following cards:
Card category |
Cards |
CEPC |
CEPC-CP4RX, CEPC-CP4RX-L, CEPC-CQ8L, CEPC-XP4LX, CEPC-XP24LX, CEPC-XP48RX |
CSPEX |
CSPEX-1304X, CSPEX-1304S, CSPEX-1404X, CSPEX-1404S, CSPEX-1502X, CSPEX-1504X, CSPEX-1504S, CSPEX-1602X, CSPEX-1802XB, CSPEX-1804X, CSPEX-1512X, CSPEX-1612X, CSPEX-1812X, CSPEX-2304X-G, CSPEX-2304X-LG, CSPEX-2612X-E |
SPE |
RX-SPE200-E |
When a main interface or subinterface has BRAS users online, you cannot use this command to modify the MAC address of the interface.
You cannot directly configure a MAC address for a subinterface. A subinterface uses the MAC address of its main interface. All subinterfaces of the same main interface use the same MAC address.
Do not set a VRRP-reserved MAC address for a Layer 3 Ethernet interface.
Examples
# Set the MAC address of Ten-GigabitEthernet 3/1/1 to 0001-0001-0001.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/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 [ spread ]
undo mtu [ spread ]
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
Parameters
size: Sets the MTU in bytes. The value range for this argument varies by card model.
· For interfaces on MIC subcards in a CSPEX-1104-E or SPEX-1204 card, the value range is 46 to 2980 bytes.
· For interfaces on PIC-PS2G4L or PIC-TCP8L subcards in an SPEX-1204 card, the value range is 46 to 2000 bytes.
· For interfaces on PIC-GP10L subcards in an SPEX-1204 card, the value range is 46 to 3000 bytes.
· For interfaces on other PIC subcards in an SPEX-1204 card, the value range is 46 to 9100 bytes.
spread: Batch modifies the MTU for the subinterfaces of a main interface. Subinterfaces do not support this keyword.
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.
The mtu size command executed in main interface view takes effect only on the main interface. The mtu size command executed in subinterface view takes effect only on the subinterface.
The mtu size spread command executed in main interface view can modify the MTU for both the main interface and its subinterfaces. However, the MTU separately configured for a subinterface takes priority.
The outgoing interface uses the MTU of 1280 bytes if its MTU is smaller than 1280 bytes and the incoming interface is on the specified cards. As a best practice, set the MTU of the outgoing interface to a value greater than 1280 bytes when the device is installed with the cards mentioned above.
Examples
# Set the MTU to 1430 bytes for Ten-GigabitEthernet 3/1/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/1] mtu 1430
# Set the MTU to 1430 bytes for Ten-GigabitEthernet 3/1/1.1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1.1
[Sysname-Ten-GigabitEthernet3/1/1.1] mtu 1430
# Set the MTU to 1430 bytes for Ten-GigabitEthernet 3/1/1 and its subinterfaces.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1
[Sysname-Ten-GigabitEthernet3/1/1] mtu 1430 spread
port-type switch
Use port-type switch to change the type of an interface.
Syntax
In standard POS interface view:
port-type switch gigabitethernet
In Layer 3 GigabitEthernet interface view:
port-type switch pos
Views
Standard POS interface view
Layer 3 GigabitEthernet interface view
Predefined user roles
network-admin
Parameters
gigabitethernet: Changes a standard POS interface to a Layer 3 GigabitEthernet interface.
pos: Changes a Layer 3 GigabitEthernet interface to a standard POS interface.
Usage guidelines
CAUTION: After the type of an interface is changed, the system deletes the original interface and creates a new interface that is numbered the same as the original interface. All the other commands are restored to the default on the new interface. |
Only interfaces on MIC-TCP8L and PIC-TCP8L subcards support this command.
This command creates the target interface with the same number as the original interface.
The device enters the view of the new interface automatically after you execute this command.
Examples
# Change POS 3/1/1 to GigabitEthernet 3/1/1.
<Sysname> system-view
[Sysname] interface pos 3/1/1
[Sysname-Pos3/1/1] port-type switch gigabitethernet
Changing port type can result in loss of port configuration. Are you sure to continue? [Y/N]:y
[Sysname-GigabitEthernet3/1/1]
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
The default setting for this command varies by device model.
Views
Layer 3 Ethernet subinterface view
Predefined user roles
network-admin
Usage guidelines
This command is resource intensive. The system becomes busy and the CPU usage increases when you enable this feature on a large number of Ethernet subinterfaces or set a shorter interval by using the flow-interval command.
You can use the display interface or display counters command to display the subinterface traffic statistics.
On a Layer 3 Ethernet subinterface, the command is mutually exclusive with the IPoE L2VPN-leased users. For more information about IPoE L2VPN-leased users, see BRAS Services Configuration Guide.
Examples
# Enable packet statistics collection for Ten-GigabitEthernet 3/1/1.1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/1/1.1
[Sysname-Ten-GigabitEthernet3/1/1.1] traffic-statistic enable
Related commands
display counters
display interface
flow-interval