- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
02-Ethernet interface commands | 351.86 KB |
Contents
Common Ethernet interface commands
snmp-agent trap enable ifmonitor
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
mdc-admin
Parameters
bandwidth-value: Specifies the expected bandwidth in the range of 1 to 400000000 kbps.
Usage guidelines
The expected bandwidth is an informational parameter used only by higher-layer protocols for calculation. You cannot adjust the actual bandwidth of an interface by using this command.
Examples
# Set the expected bandwidth of GigabitEthernet 1/2/0/1 to 1000 kbps.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1
[Sysname-GigabitEthernet1/2/0/1] bandwidth 1000
# Set the expected bandwidth of GigabitEthernet 1/2/0/1.1 to 1000 kbps.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1.1
[Sysname-GigabitEthernet1/2/0/1.1] bandwidth 1000
dampening
Use dampening to enable the device to dampen an interface when the interface is flapping.
Use undo dampening to restore the default.
Syntax
dampening [ half-life reuse suppress max-suppress-time ]
undo dampening
Default
Interface dampening is disabled on Ethernet interfaces.
Views
Ethernet interface view
Predefined user roles
network-admin
mdc-admin
Parameters
half-life: Specifies the amount of time after which a penalty is decreased, in the range of 1 to 120 seconds. The default value is 54 seconds.
reuse: Specifies the reuse threshold in the range of 200 to 20000. The default value is 750. The reuse threshold must be less than the suppression threshold.
suppress: Specifies the suppression threshold in the range of 200 to 20000. The default value is 2000.
max-suppress-time: Specifies the maximum amount of time the interface can be dampened, in the range of 1 to 255 seconds. The default value is 162 seconds (three times the half-life timer).
Usage guidelines
This command and the link-delay 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 GigabitEthernet 1/2/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1
[Sysname-GigabitEthernet1/2/0/1] dampening
# Enable interface dampening on GigabitEthernet 1/2/0/1, and set the following parameters:
· Half life time to 2 seconds.
· Reuse value to 800.
· Suppression threshold to 3000.
· Maximum suppression interval to 5 seconds.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1
[Sysname-GigabitEthernet1/2/0/1] dampening 2 800 3000 5
Related commands
display interface
link-delay
default
Use default to restore the default settings for an interface.
Syntax
default
Views
Ethernet interface view
Ethernet subinterface view
Predefined user roles
network-admin
mdc-admin
Usage guidelines
CAUTION: 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 GigabitEthernet 1/2/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1
[Sysname-GigabitEthernet1/2/0/1] default
# Restore the default settings for GigabitEthernet 1/2/0/1.1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1.1
[Sysname-GigabitEthernet1/2/0/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, GigabitEthernet1/2/0/1 Interface).
Views
Ethernet interface view
Ethernet subinterface view
Predefined user roles
network-admin
mdc-admin
Parameters
text: Specifies the interface description, a case-sensitive string of 1 to 255 characters.
Examples
# Set the description of GigabitEthernet 1/2/0/1 to lan-interface.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1
[Sysname-GigabitEthernet1/2/0/1] description lan-interface
# Set the description of GigabitEthernet 1/2/0/1.1 to subinterface1/2/0/1.1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1.1
[Sysname-GigabitEthernet1/2/0/1.1] description subinterface1/2/0/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 ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
inbound: Displays inbound traffic statistics.
outbound: Displays outbound traffic statistics.
interface-type: Specifies an interface type.
interface-number: Specifies an interface number.
interface-number.subnumber: Specifies a subinterface number. The interface-number argument is an interface number. The subnumber argument is the number of a subinterface created under the interface. The value range for the subnumber argument is 1 to 4094.
Usage guidelines
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.
Examples
# Display inbound traffic statistics for all GigabitEthernet interfaces.
<Sysname> display counters inbound interface gigabitethernet
Interface Total(pkt) Broadcast(pkt) Multicast(pkt) Err(pkt)
GE1/2/0/1 100 100 0 0
GE1/2/0/2 Overflow Overflow Overflow Overflow
Overflow: More than 14 digits (7 digits for column "Err").
--: Not supported.
Table 1 Command output
Field |
Description |
Interface |
Abbreviated interface name. |
Total(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. |
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 ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
inbound: Displays inbound traffic rate statistics.
outbound: Displays outbound traffic rate statistics.
interface-type: Specifies an interface type.
interface-number: Specifies an interface number.
interface-number.subnumber: Specifies a subinterface number. The interface-number argument is an interface number. The subnumber argument is the number of a subinterface created under the interface. The value range for the subnumber argument is 1 to 4094.
Usage guidelines
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 GigabitEthernet 1/2/0/1.
<Sysname> display counters rate interface gigabitethernet 1/2/0/1
Usage: Bandwidth utilization in percentage
Interface InUsage(%) InTotal(pps) OutUsage(%) OutTotal(pps)
GE1/2/0/1 0.01 1000 0.01 1000
Overflow: More than 14 digits.
--: Not supported.
# Display the inbound traffic rate statistics for all GigabitEthernet interfaces.
<Sysname> display counters rate inbound interface gigabitethernet
Usage: Bandwidth utilization in percentage
Interface Usage(%) Total(pps) Broadcast(pps) Multicast(pps)
GE1/2/0/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. |
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
display ethernet statistics chassis chassis-number slot slot-number [ cpu cpu-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
chassis chassis-number slot slot-number: Specifies a card on a cluster member device. The chassis-number argument represents the member ID of the cluster 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.
Examples
# Display the Ethernet module statistics for the specified slot.
<Sysname> display ethernet statistics chassis 1 slot 2
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.Layer 2 forwarding is not supported in the current software version. · 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.This field is not supported in the current software version. · FastOutNum—Number of packets fast forwarded. · L2OutNum—Number of packets sent out of Layer 2 Ethernet interfaces.This field is not supported in the current software version. · MbufRelayNum—Number of packets transparently sent. |
ETH send error statistics |
Statistics about the error Ethernet packets in the outbound direction on the Ethernet module: · 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.This field is not supported in the current software version. · 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.This field is not supported in the current software version. · IfShut—Number of packets that are being sent when the interface is shut down. · IfErr—Number of packets with incorrect outgoing interfaces. |
Related commands
reset ethernet statistics
display interface
Use display interface to display interface information.
Syntax
display interface [ interface-type [ interface-number | interface-number.subnumber ] ] [ brief [ description | down ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
interface-type: Specifies an interface type.
interface-number: Specifies an interface number.
interface-number.subnumber: Specifies a subinterface number. The interface-number argument is an interface number. The subnumber argument is the number of a subinterface created under the interface. The value range for the subnumber argument is 1 to 4094.
brief: Displays brief interface information. If you do not specify this keyword, the command displays detailed interface information.
description: Displays complete interface descriptions. If you do not specify this keyword, the command displays only the first 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 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 GigabitEthernet 1/2/0/1.
<Sysname> display interface gigabitethernet 1/2/0/1
GigabitEthernet1/2/0/1
Current state: Administratively DOWN
Line protocol state: DOWN
Description: GigabitEthernet1/2/0/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: 3822-d666-bd0c
IPv6 packet frame type: Ethernet II, hardware address: 3822-d666-bd0c
Flow-control is not enabled
Loopback is not set
Media type is twisted pair, port hardware type is 1000_BASE_T
Port priority: 2
Unknown-speed mode, unknown-duplex mode
Last link flapping: 6 hours 39 minutes 28 seconds
Last clearing of counters: Never
Current system time:2017-10-27 15:10:03
Last time when physical state changed to up:-
Last time when physical state changed to down:2017-10-27 14:56:38
Last 300 second input: 0 packets/sec 0 bytes/sec 0%
Last 300 second output: 0 packets/sec 0 bytes/sec 0%
Input (total): 0 packets, 0 bytes
0 unicasts, 0 broadcasts, 0 multicasts, - pauses
Input (normal): 0 packets, 0 bytes
0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
Input: 0 input errors, 0 runts, 0 giants, 0 throttles
0 CRC, 0 frame, 0 overruns, - aborts
- ignored, - parity errors
Output (total): 0 packets, 0 bytes
0 unicasts, 0 broadcasts, 0 multicasts, - pauses
Output (normal): 0 packets, 0 bytes
0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
Output: 0 output errors, - underruns, - buffer failures
0 aborts, 0 deferred, 0 collisions, 0 late collisions
- lost carrier, - no carrier
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. · mac-address moving down—The interface has been shut down by the MAC address move suppression feature. · 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. |
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 Layer 3—IP Services Configuration Guide. · BOOTP-allocated—BOOTP allocated IP address. For more information, see BOOTP client configuration in Layer 3—IP Services Configuration Guide. · PPP-negotiated—IP address assigned by a PPP server during PPP negotiation. For more information, see PPP configuration in Layer 2—WAN Access Configuration Guide. · Unnumbered—IP address borrowed from another interface. · 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. |
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. |
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. |
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 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- |
This field is not supported in the current software version. Broadcast storm suppression threshold in ratio, pps, or kbps. The unit of the threshold depends on your configuration. |
Multicast max- |
This field is not supported in the current software version. Multicast storm suppression threshold in ratio, pps, or kbps. The unit of the threshold depends on your configuration. |
Unicast max- |
This field is not supported in the current software version. 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. |
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 second input: 0 packets/sec 0 bytes/sec 0% Last interval second output: 0 packets/sec 0 bytes/sec 0% |
Average inbound or outbound traffic rate (in pps and Bps) in the last statistics polling interval, and the ratio of the actual rate to the interface bandwidth. To set the statistics polling interval, execute the flow-interval command. A hyphen (-) indicates that the statistical item is not supported. |
Input(total): 0 packets, 0 bytes 0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses |
The two fields on the first line represent the inbound traffic statistics (in packets and bytes) for the interface. All inbound normal packets, abnormal packets, and normal pause frames were counted. The four fields on the second line represent: · Number of inbound unicast packets. · Number of inbound broadcasts. · Number of inbound multicasts. · Number of inbound pause frames. A hyphen (-) indicates that the statistical item is not supported. |
Input(normal): 0 packets, 0 bytes 0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses |
The two fields on the first line represent the inbound normal traffic and pause frame statistics (in packets and bytes) for the interface. The four fields on the second line represent: · Number of inbound normal unicast packets. · Number of inbound normal broadcasts. · Number of inbound normal multicasts. · Number of inbound normal pause frames. A hyphen (-) indicates that the statistical item is not supported. |
input errors |
Statistics of incoming error packets. |
runts |
Number of inbound frames meeting the following conditions: · Shorter than 64 bytes. · In correct format. · Containing valid CRCs. |
giants |
Number of inbound giants. Giants refer to frames larger than the maximum frame length supported on the interface. For an Ethernet interface that does not permit jumbo frames, the maximum frame length is as follows: · 1518 bytes (without VLAN tags). · 1522 bytes (with VLAN tags). For an Ethernet interface that permits jumbo frames, the maximum Ethernet frame length is set when you configure jumbo frame support on the interface. |
throttles |
Number of inbound frames that had a non-integer number of bytes. |
CRC |
Total number of inbound frames that had a normal length, but contained CRC errors. |
frame |
Total number of inbound frames that contained CRC errors and a non-integer number of bytes. |
overruns |
Number of packets dropped because the input rate of the port exceeded the queuing capability. |
aborts |
Total number of illegal inbound packets: · Fragment frames—CRC error frames shorter than 64 bytes. The length (in bytes) can be an integral or non-integral value. · Jabber frames—CRC error frames greater than the maximum frame length supported on the Ethernet interface (with an integral or non-integral length). ¡ For an Ethernet interface that does not permit jumbo frames, the maximum frame length is 1518 bytes (without VLAN tags) or 1522 bytes (with VLAN tags). ¡ For an Ethernet interface that permits jumbo frames, the maximum Ethernet frame length is set when you configure jumbo frame support on the interface. · Symbol error frames—Frames that contained a minimum of one undefined symbol. · Unknown operation code frames—Non-pause MAC control frames. · Length error frames—Frames whose 802.3 length fields did not match the actual frame length (46 to 1500 bytes). |
ignored |
Number of inbound frames dropped because the receiving buffer of the port ran low. |
parity errors |
Total number of frames with parity errors. |
Output(total): 0 packets, 0 bytes 0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses |
The two fields on the first line represent the outbound traffic statistics (in packets and bytes) for the interface. All outbound normal packets, abnormal packets, and normal pause frames were counted. The four fields on the second line represent: · Number of outbound unicast packets. · Number of outbound broadcasts. · Number of outbound multicasts. · Number of outbound pause frames. A hyphen (-) indicates that the statistical item is not supported. |
Output(normal): 0 packets, 0 bytes 0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses |
The two fields on the first line represent the outbound normal traffic and pause frame statistics (in packets and bytes) for the interface. The four fields on the second line represent: · Number of outbound normal unicast packets. · Number of outbound normal broadcasts. · Number of outbound normal multicasts. · Number of outbound normal pause frames. 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 |
This field is not supported in the current software version. Number of carrier losses during transmission. This counter increases by one when a carrier is lost, and applies to serial WAN interfaces. |
no carrier |
This field is not supported in the current software version. 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. |
# 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
GE1/2/0/1 DOWN DOWN --
Loop0 UP UP(s) 2.2.2.9
NULL0 UP UP(s) --
Vlan1 UP DOWN --
Vlan999 UP UP 192.168.1.42
# 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
GE1/2/0/1 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. To see the primary interface, use the display interface-backup state command. |
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. |
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. · Not connected—No physical connection exists (possibly because the network cable is disconnected or faulty). · STP DOWN—The interface has been shut down by the BPDU guard feature. · Standby—The interface is a backup interface in standby state. |
reset counters interface
display interface link-info
Use display interface link-info to display the status and packet statistics of interfaces.
Syntax
display interface link-info [ main ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
main: Specifies all interfaces except subinterfaces. If you do not specify this keyword, this command displays status and packet statistics of all interfaces.
Examples
# Display status and statistics of all interfaces.
<Sysname> display interface link-info
Link: ADM - administratively down; Stby - standby
Protocol: (s) - spoofing
Interface Link Protocol InUsage OutUsage InErrs OutErrs
GE1/2/0/1 UP UP 0.05% 0.05% 3000 3000
NULL0 UP UP(s) -% -% 0 0
BAGG11 ADM DOWN -- -- -- --
GE1/2/0/2 DOWN DOWN -- -- -- --
RAGG11 ADM DOWN -- -- -- --
GE1/2/0/3 DOWN DOWN -- -- -- --
Overflow: More than 7 digits.
--: Not supported.
Table 6 Command output
Field |
Description |
Link: ADM - administratively down; Stby - standby |
Physical link state of the interface: · ADM—The interface has been shut down by using the shutdown command. To restore the physical state of the interface, use the undo shutdown command. · Stby—The interface is a backup interface in standby state. |
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. |
Protocol |
Data link layer protocol state of the interface: · UP—The data link layer protocol of the interface is up. · DOWN—The data link layer protocol of the interface is down. · UP(s)—The data link layer protocol of the interface is up, but the link is an on-demand link or does not exist. The (s) attribute represents the spoofing flag. This value is typical of null interfaces, loopback interfaces, and InLoopback interfaces. |
InUsage |
Inbound bandwidth usage within the most recent statistics polling interval. It is calculated by this formula: Average inbound speed of the interface within the most recent statistics polling interval/interface bandwidth. 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. |
InErrs |
Number of error packets received. |
OutErrs |
Number of error packets sent. |
Overflow: More than 7 digits. |
The data length of a statistical item value is greater than 7 decimal digits. |
--: Not supported. |
A hyphen (-) indicates that the corresponding statistical item is not supported. |
Related commands
flow-interval
display interface main
Use display interface main to display operating status and information of all interfaces except subinterfaces.
Syntax
display interface [ interface-type ] [ brief [ description | down ] ] main
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
interface-type: Specifies an interface type. If you do not specify this argument, the command displays information about interfaces of all types.
brief: Displays brief interface information. If you do not specify this keyword, the command displays detailed interface information.
description: Displays complete interface descriptions. If you do not specify this keyword, the command displays only the first 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
GigabitEthernet1/2/0/1
Current state: Administratively DOWN
Line protocol state: DOWN
Description: GigabitEthernet1/2/0/1 Interface
Bandwidth: 1000000 kbps
Flow-control is not enabled
Maximum frame length: 9216
Allow jumbo frames to pass
Broadcast max-ratio: 100%
Multicast max-ratio: 100%
Unicast max-ratio: 100%
PVID: 1
MDI type: Automdix
Port link-type: Access
Tagged VLANs: None
Untagged VLANs: 1
Port priority: 2
Last link flapping: Never
Last clearing of counters: Never
Current system time:2018-04-11 10:20:24
Last time when physical state changed to up:-
Last time when physical state changed to down:2018-04-11 09:11:09
Peak input rate: 0 bytes/sec, at 00-00-00 00:00:00
Peak output rate: 0 bytes/sec, at 00-00-00 00:00:00
Last 300 second input: 0 packets/sec 0 bytes/sec -%
Last 300 second output: 0 packets/sec 0 bytes/sec -%
Input (total): 0 packets, 0 bytes
0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
Input (normal): 0 packets, 0 bytes
0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
Input: 0 input errors, 0 runts, 0 giants, 0 throttles
0 CRC, 0 frame, 0 overruns, 0 aborts
0 ignored, 0 parity errors
Output (total): 0 packets, 0 bytes
0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
Output (normal): 0 packets, 0 bytes
0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
Output: 0 output errors, 0 underruns, 0 buffer failures
0 aborts, 0 deferred, 0 collisions, 0 late collisions
0 lost carrier, 0 no carrier
GigabitEthernet1/2/0/2
Current state: Administratively DOWN
Line protocol state: DOWN
Description: GigabitEthernet1/2/0/2 Interface
Bandwidth: 1000000 kbps
Flow-control is not enabled
Maximum transmission unit: 1500
Allow jumbo frames to pass
Broadcast max-ratio: 100%
Multicast max-ratio: 100%
Unicast max-ratio: 100%
Internet protocol processing: Disabled
IP packet frame type: Ethernet II, hardware address: 4005-6538-0107
IPv6 packet frame type: Ethernet II, hardware address: 4005-6538-0107
Last link flapping: Never
Last clearing of counters: Never
Current system time:2018-04-11 10:20:24
Last time when physical state changed to up:-
Last time when physical state changed to down:2018-04-11 09:33:52
Peak input rate: 0 bytes/sec, at 00-00-00 00:00:00
Peak output rate: 0 bytes/sec, at 00-00-00 00:00:00
Last 300 second input: 0 packets/sec 0 bytes/sec -%
Last 300 second output: 0 packets/sec 0 bytes/sec -%
Input (total): 0 packets, 0 bytes
0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
Input (normal): 0 packets, 0 bytes
0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
Input: 0 input errors, 0 runts, 0 giants, 0 throttles
0 CRC, 0 frame, 0 overruns, 0 aborts
0 ignored, 0 parity errors
Output (total): 0 packets, 0 bytes
0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
Output (normal): 0 packets, 0 bytes
0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
Output: 0 output errors, 0 underruns, 0 buffer failures
0 aborts, 0 deferred, 0 collisions, 0 late collisions
0 lost carrier, 0 no carrier
# Display brief information 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
GE1/2/0/1 DOWN DOWN --
Loop0 UP UP(s) 2.2.2.9
NULL0 UP UP(s) --
Vlan1 UP DOWN --
Vlan999 UP UP 192.168.1.42
# 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
GE1/2/0/1 DOWN Not connected
Vlan2 DOWN Not connected
For description on the display interface main command output, see Table 4 and Table 5.
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
mdc-admin
mdc-operator
Parameters
interface-type: Specifies an interface type.
interface-number: Specifies an interface number.
Usage guidelines
If you do not specify an interface type, this command displays the 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 GigabitEthernet 1/0/1.
<Sysname> display interface gigabitethernet 1/0/1 phy-option
GigabitEthernet1/0/1
Current state: DOWN
Flow-control is not enabled
Media type is not sure,port hardware type is No connector
Loopback is not set
Unknown-speed mode, unknown-duplex mode
Link speed type is autonegotiation, link duplex type is autonegotiation
Maximum frame length: 9216
Transceiver information:
Transceiver Type: 1000_BASE_SX_SFP
Wavelength(nm): 850
Transfer Distance(m): 100
Digital Diagnostic Monitoring : YES
Vendor Name : H3C
RX power: -3564dBm/100, Alarm thresholds:[-30, -10]uw/10
TX power: -519dBm/100, Alarm thresholds:[0, 5]uw/10
# Display the physical attributes of Layer 3 Ethernet interface GigabitEthernet 1/0/1.
<Sysname> display interface gigabitethernet 1/0/1 phy-option
GigabitEthernet1/0/1
Current state: DOWN
Flow-control is not enabled
Media type is not sure,port hardware type is No connector
Loopback is not set
Unknown-speed mode, unknown-duplex mode
Link speed type is autonegotiation, link duplex type is autonegotiation
The maximum frame length is 9216
Transceiver information:
Transceiver Type: 1000_BASE_SX_SFP
Wavelength(nm): 850
Transfer Distance(m): 100
Digital Diagnostic Monitoring : YES
Vendor Name : H3C
RX power: -3564dBm/100, Alarm thresholds:[-30, -10]uw/10
TX power: -519dBm/100, Alarm thresholds:[0, 5]uw/10
Table 7 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. · mac-address moving down—The interface has been shut down by the MAC address move suppression feature. · STP DOWN—The interface has been shut down by the BPDU guard feature. · UP—The interface is both administratively and physically up. |
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. |
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. |
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 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 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
mdc-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
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 and J1 bytes are not set.
Views
10-GE interface view
Predefined user roles
network-admin
mdc-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 1/2/0/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/2/0/1
[Sysname-Ten-GigabitEthernet1/2/0/1] port-mode wan
[Sysname-Ten-GigabitEthernet1/2/0/1] flag j0 sdh Sysname
Related commands
port-mode
flow-interval
Use flow-interval to set the statistics polling interval.
Use undo flow-interval to restore the default.
Syntax
flow-interval interval
undo flow-interval
Default
The statistics polling interval is 300 seconds.
Views
System view
Ethernet interface view
Predefined user roles
network-admin
mdc-admin
Parameters
interval: Sets the statistics polling interval in seconds. 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
The statistics polling interval configured in system view takes effect on all Ethernet interfaces.
The statistics polling interval configured in Ethernet interface view takes effect only on the current interface.
The statistics polling interval configured in Ethernet interface view takes precedence over the statistics polling interval configured in system view. The interval configured in system view takes effect on an Ethernet interface only when no interval is configured or the default interval is configured for the Ethernet interface.
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 second input and Last interval second input fields in the display interface command output.
Examples
# Set the statistics polling interval to 100 seconds on GigabitEthernet 1/2/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1
[Sysname-GigabitEthernet1/2/0/1] flow-interval 100
Related commands
display interface
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
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
mdc-admin
Parameters
high-threshold high-value: Specifies the upper threshold for CRC error packet alarms, in the range of 1 to 4294967295 packets.
low-threshold low-value: Specifies the lower threshold for CRC error packet alarms, in the range of 1 to 4294967295 packets.
interval interval: Specifies the statistics collection and comparison interval for CRC error packets, in the range of 1 to 65535 seconds.
shutdown: Shuts down an interface when the number of incoming CRC error packets on the interface exceeds the upper threshold. Then, the interface stops forwarding all packets. To recover the interface, execute the undo shutdown command on the interface. If you do not specify this keyword, an upper threshold exceeding alarm is generated and the interface enters the alarm state when the number of incoming CRC error packets exceeds the upper threshold on the interface.
chassis chassis-number slot slot-number: Specifies a card on a cluster member device. The chassis-number argument represents the member ID of the cluster 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 CRC error packet alarm function enabled, when the number of incoming CRC error packets on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the number of incoming CRC error packets on an interface in the alarm state within the specified interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.
You can configure the CRC error packet alarm parameters in system view and interface view.
· The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.
· For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.
When you execute this command multiple times, the most recent configuration takes effect.
Examples
# Set the upper threshold to 5000, lower threshold to 400, and statistics collection and comparison interval to 6 seconds for CRC error packet alarms.
<Sysname> system-view
[Sysname] ifmonitor crc-error chassis 1 slot 2 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
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
mdc-admin
Parameters
high-threshold high-value: Specifies the upper threshold for input error packet alarms, in the range of 1 to 4294967295 packets.
low-threshold low-value: Specifies the lower threshold for input error packet alarms, in the range of 1 to 4294967295 packets.
interval interval: Specifies the statistics collection and comparison interval for input error packets, in the range of 1 to 65535 seconds.
shutdown: Shuts down an interface when the number of input error packets on the interface exceeds the upper threshold. Then, the interface stops forwarding all packets. To recover the interface, execute the undo shutdown command on the interface. If you do not specify this keyword, an upper threshold exceeding alarm is generated and the interface enters the alarm state when the number of input error packets exceeds the upper threshold on the interface.
chassis chassis-number slot slot-number: Specifies a card on a cluster member device. The chassis-number argument represents the member ID of the cluster 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 input error packet alarm function enabled, when the number of input error packets on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the number of input error packets on an interface in the alarm state within the specified interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.
You can configure the input error packet alarm parameters in system view and interface view.
· The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.
· For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.
When you execute this command multiple times, the most recent configuration takes effect.
Examples
# Set the upper threshold to 5000, lower threshold to 400, and statistics collection and comparison interval to 6 seconds for input error packet alarms.
<Sysname> system-view
[Sysname] ifmonitor input-error chassis 1 slot 2 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
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
mdc-admin
Parameters
high-threshold high-value: Specifies the upper threshold for input bandwidth usage alarms, in the range of 1 to 100.
low-threshold low-value: Specifies the lower threshold for input bandwidth usage alarms, in the range of 1 to 100.
chassis chassis-number slot slot-number: Specifies a card on a cluster member device. The chassis-number argument represents the member ID of the cluster 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 input bandwidth usage alarm function enabled, when the input bandwidth usage on an interface in normal state within the most recent statistics polling interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the input bandwidth usage on an interface in the alarm state within the most recent statistics polling interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.
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.
When 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 chassis 1 slot 2 high-threshold 95 low-threshold 80
Related commands
flow-interval
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
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
mdc-admin
Parameters
high-threshold high-value: Specifies the upper threshold for output error packet alarms, in the range of 1 to 4294967295 packets.
low-threshold low-value: Specifies the lower threshold for output error packet alarms, in the range of 1 to 4294967295 packets.
interval interval: Specifies the statistics collection and comparison interval for output error packets, in the range of 1 to 65535 seconds.
shutdown: Shuts down an interface when the number of output error packets on the interface exceeds the upper threshold. Then, the interface stops forwarding all packets. To recover the interface, execute the undo shutdown command on the interface. If you do not specify this keyword, an upper threshold exceeding alarm is generated and the interface enters the alarm state when the number of output error packets exceeds the upper threshold on the interface.
chassis chassis-number slot slot-number: Specifies a card on a cluster member device. The chassis-number argument represents the member ID of the cluster 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 output error packet alarm function enabled, when the number of output error packets on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the number of output error packets on an interface in the alarm state within the specified interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.
You can configure the output error packet alarm parameters in system view and interface view.
· The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.
· For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.
When you execute this command multiple times, the most recent configuration takes effect.
Examples
# Set the upper threshold to 5000, lower threshold to 400, and statistics collection and comparison interval to 6 seconds for output error packet alarms.
<Sysname> system-view
[Sysname] ifmonitor output-error chassis 1 slot 2 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
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
mdc-admin
Parameters
high-threshold high-value: Specifies the upper threshold for output bandwidth usage alarms, in the range of 1 to 100.
low-threshold low-value: Specifies the lower threshold for output bandwidth usage alarms, in the range of 1 to 100.
chassis chassis-number slot slot-number: Specifies a card on a cluster member device. The chassis-number argument represents the member ID of the cluster 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 output bandwidth usage alarm function enabled, when the output bandwidth usage on an interface in normal state within the most recent statistics polling interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the output bandwidth usage on an interface in the alarm state within the most recent statistics polling interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.
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.
When 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 output bandwidth usage alarms.
<Sysname> system-view
[Sysname] ifmonitor output-usage chassis 1 slot 2 high-threshold 80 low-threshold 60
Related commands
flow-interval
snmp-agent trap enable ifmonitor
ifmonitor sdh-b1-error
Use ifmonitor sdh-b1-error to configure global SDH-B1 error packet alarm parameters.
Use undo ifmonitor sdh-b1-error to restore the default.
Syntax
ifmonitor sdh-b1-error chassis chassis-number slot slot-number cpu cpu-number high-threshold high-value low-threshold low-value interval interval [ shutdown ]
undo ifmonitor sdh-b1-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 SDH-B1 error packet alarms.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
high-threshold high-value: Specifies the upper threshold for SDH-B1 error packet alarms, in the range of 1 to 4294967295 packets.
low-threshold low-value: Specifies the lower threshold for SDH-B1 error packet alarms, in the range of 1 to 4294967295 packets.
interval interval: Specifies the statistics collection and comparison interval for SDH-B1 error packets, in the range of 1 to 65535 seconds.
shutdown: Shuts down an interface when the number of incoming SDH-B1 error packets on the interface exceeds the upper threshold. Then, the interface stops forwarding all packets. To recover the interface, execute the undo shutdown command on the interface. If you do not specify this keyword, an upper threshold exceeding alarm is generated and the interface enters the alarm state when the number of incoming SDH-B1 error packets exceeds the upper threshold on the interface.
chassis chassis-number slot slot-number: Specifies a card on a cluster member device. The chassis-number argument represents the member ID of the cluster 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 SDH-B1 error packet alarm function enabled, when the number of incoming SDH-B1 error packets on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the number of incoming SDH-B1 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 SDH-B1 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.
For this command to take effect, you must use the snmp-agent trap enable ifmonitor command to enable the SDH-B1 error packet alarm function.
When you execute this command multiple times, the most recent configuration takes effect.
Examples
# Set the upper threshold to 65, lower threshold to 25, and statistics collection and comparison interval to 20 seconds for SDH-B1 error packet alarms.
<Sysname> system-view
[Sysname] ifmonitor sdh-b1-error chassis 1 slot 2 high-threshold 65 low-threshold 25 interval 20
Related commands
snmp-agent trap enable ifmonitor
ifmonitor sdh-b2-error
Use ifmonitor sdh-b2-error to configure global SDH-B2 error packet alarm parameters.
Use undo ifmonitor sdh-b2-error to restore the default.
Syntax
ifmonitor sdh-b2-error chassis chassis-number slot slot-number cpu cpu-number high-threshold high-value low-threshold low-value interval interval [ shutdown ]
undo ifmonitor sdh-b2-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 SDH-B2 error packet alarms.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
high-threshold high-value: Specifies the upper threshold for SDH-B2 error packet alarms, in the range of 1 to 4294967295 packets.
low-threshold low-value: Specifies the lower threshold for SDH-B2 error packet alarms, in the range of 1 to 4294967295 packets.
interval interval: Specifies the statistics collection and comparison interval for SDH-B2 error packets, in the range of 1 to 65535 seconds.
shutdown: Shuts down an interface when the number of incoming SDH-B2 error packets on the interface exceeds the upper threshold. Then, the interface stops forwarding all packets. To recover the interface, execute the undo shutdown command on the interface. If you do not specify this keyword, an upper threshold exceeding alarm is generated and the interface enters the alarm state when the number of incoming SDH-B2 error packets exceeds the upper threshold on the interface.
chassis chassis-number slot slot-number: Specifies a card on a cluster member device. The chassis-number argument represents the member ID of the cluster 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 SDH-B2 error packet alarm function enabled, when the number of incoming SDH-B2 error packets on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the number of incoming SDH-B2 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 SDH-B2 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.
For this command to take effect, you must use the snmp-agent trap enable ifmonitor command to enable the SDH-B2 error packet alarm function.
When you execute this command multiple times, the most recent configuration takes effect.
Examples
# Set the upper threshold to 6, lower threshold to 5, and statistics collection and comparison interval to 2 seconds for SDH-B2 error packet alarms.
<Sysname> system-view
[Sysname] ifmonitor sdh-b2-error chassis 1 slot 2 high-threshold 6 low-threshold 5 interval 2
Related commands
snmp-agent trap enable ifmonitor
ifmonitor sdh-error
Use ifmonitor sdh-error to configure global SDH error packet alarm parameters.
Use undo ifmonitor sdh-error to restore the default.
Syntax
ifmonitor sdh-error chassis chassis-number slot slot-number cpu cpu-number high-threshold high-value low-threshold low-value interval interval [ shutdown ]
undo ifmonitor sdh-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 SDH error packet alarms.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
high-threshold high-value: Specifies the upper threshold for SDH error packet alarms, in the range of 1 to 4294967295 packets.
low-threshold low-value: Specifies the lower threshold for SDH error packet alarms, in the range of 1 to 4294967295 packets.
interval interval: Specifies the statistics collection and comparison interval for SDH error packets, in the range of 1 to 65535 seconds.
shutdown: Shuts down an interface when the number of incoming SDH error packets on the interface exceeds the upper threshold. Then, the interface stops forwarding all packets. To recover the interface, execute the undo shutdown command on the interface. If you do not specify this keyword, an upper threshold exceeding alarm is generated and the interface enters the alarm state when the number of incoming SDH error packets exceeds the upper threshold on the interface.
chassis chassis-number slot slot-number: Specifies a card on a cluster member device. The chassis-number argument represents the member ID of the cluster 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 SDH error packet alarm function enabled, when the number of incoming SDH error packets on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the number of incoming SDH 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 SDH 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.
For this command to take effect, you must use the snmp-agent trap enable ifmonitor command to enable the SDH error packet alarm function.
When you execute this command multiple times, the most recent configuration takes effect.
Examples
# Set the upper threshold to 35, lower threshold to 20, and statistics collection and comparison interval to 8 seconds for SDH error packet alarms.
<Sysname> system-view
[Sysname] ifmonitor sdh-error chassis 1 slot 2 high-threshold 35 low-threshold 20 interval 8
Related commands
snmp-agent trap enable ifmonitor
interface
Use interface to enter interface view, create a subinterface and enter its view, or enter the view of an existing subinterface.
Syntax
interface interface-type { interface-number | interface-number.subnumber }
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
interface-type: Specifies an interface type.
interface-number: Specifies an interface number.
interface-number.subnumber: Specifies a subinterface number. The interface-number argument is an interface number. The subnumber argument is the number of a subinterface created under the interface. The value range for the subnumber argument is 1 to 4094.
Examples
# Enter the view of GigabitEthernet 1/2/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1
[Sysname-GigabitEthernet1/2/0/1]
# Create Ethernet subinterface GigabitEthernet 1/2/0/1.1 and enter its view.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1.1
[Sysname-GigabitEthernet1/2/0/1.1]
itf number
Use itf number to set the number of interframe filling tags.
Use undo itf number to restore the default.
Syntax
itf number number
undo itf number
Default
The number of interframe filling tags is 12.
Views
Ethernet interface view
Predefined user roles
network-admin
mdc-admin
Parameters
number: Sets the number of interframe filling tags, which can be 8 or 12.
The number of interframe filling tags is 12 for Ethernet interfaces operating in WAN mode on the CR-HIC-XP12, CR-HIC-XP12B, CR-19K-LPU-XP20CC02, CR-19K-LPU-XP40, CR-19K-LPU-XP48, and CR-19K-LPU-XP72 cards.
Usage guidelines
Ethernet frames are separated by the interframe gaps. By adjusting the interframe gap size for an interface, you can adjust the packet forwarding ratio and the forwarding capability of the interface. When rate limit is configured for an interface, to ensure smooth communication, you might need to adjust the interframe gap size. You must set the same interframe gap size for interfaces on both ends of a link.
Typically, use the default interframe gap size. To modify the interframe gap size, consult the professionals. An improper interframe gap size setting might cause packet loss or even interface failure.
For Ethernet interfaces on the CR-HIC-XP12, CR-HIC-XP12B, CR-19K-LPU-XP20CC02, CR-19K-LPU-XP40, CR-19K-LPU-XP48, and CR-19K-LPU-XP72 cards, the IPG capability varies by the interface operating mode, LAN or WAN. As a best practice to ensure successful switchover, restore the default IPG settings before switching between the LAN and WAN operating modes.
Examples
# Set the number of interframe filling tags to 8 for GigabitEthernet 1/2/0/1.
<Sysname> system view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] itf number 8
Itf number will be set. Continue? [Y/N]:y
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 9732 bytes to pass through.
Views
Layer 3 Ethernet interface view
Predefined user roles
network-admin
mdc-admin
Parameters
size: Sets the maximum length (in bytes) of Ethernet frames that are allowed to pass through. The value for this argument is fixed at 9732.
Usage guidelines
If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Allow jumbo frames to pass through GigabitEthernet 1/2/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1
[Sysname-GigabitEthernet1/2/0/1] jumboframe enable
link-delay
Use link-delay to set the physical state change suppression interval on an Ethernet interface.
Use undo link-delay to restore the default.
Syntax
link-delay { down | up } [ msec ] delay-time
undo link-delay { down | up }
Default
Physical state change suppression is not configured.
Views
Ethernet interface view
Predefined user roles
network-admin
mdc-admin
Parameters
down: Suppresses link-down events.
up: Suppresses link-up events.
msec: Enables the physical state change suppression interval to be accurate to milliseconds. If you do not specify this keyword, the suppression interval is accurate to seconds.
delay-time: Sets the physical state change suppression interval on the Ethernet interface. A value of 0 means that physical state changes are immediately reported to the CPU and are not suppressed.
· If you do not specify the msec keyword, the value is in seconds and the value range is 0 to 86400.
· 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.
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.
The link-delay and dampening commands are mutually exclusive on an interface.
Examples
# Set the link-down event suppression interval to 8 seconds on GigabitEthernet 1/2/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1
[Sysname-GigabitEthernet1/2/0/1] link-delay down 8
# Set the link-up event suppression interval to 800 milliseconds on GigabitEthernet 1/2/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1
[Sysname-GigabitEthernet1/2/0/1] link-delay up msec 800
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
mdc-admin
Parameters
external: Enables external loopback testing on the Ethernet interface.
internal: Enables internal loopback testing on the Ethernet interface.
Usage guidelines
After you enable loopback testing on an Ethernet interface, the Ethernet interface switches to full duplex mode. After you disable loopback testing, the Ethernet interface restores to its duplex setting.
The shutdown and loopback commands are mutually exclusive.
Examples
# Enable internal loopback testing on GigabitEthernet 1/2/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1
[Sysname-GigabitEthernet1/2/0/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 modeauto
undo port fec mode
Default
For 100-GE QSFP28 transceiver modules, the actual FEC state when FEC is in autonegotiation mode is as shown in the following table:
Transceiver module model |
Actual FEC state in auto mode |
_100GBASE_CR4_QSFP28 |
Enabled |
_100GBASE_SR4_QSFP28 |
Enabled |
_100GBASE_CWDM4_FEC_QSFP28 |
Enabled |
_100GBASE_LR4_QSFP28 |
Disabled |
_100GBASE_ER4_QSFP28 |
Disabled |
_100GBASE_ER4L_QSFP28 |
Disabled |
_100GBASE_DWDM2_QSFP28 |
Disabled |
Views
100-GE interface view
Predefined user roles
network-admin
mdc-admin
Parameters
auto: Autonegotiates the FEC mode or disables FEC according to the transceiver module type.
Usage guidelines
The FEC feature corrects packet errors to improve transmission quality. It attaches correction information to a packet at the sending end, and corrects error codes generated during transmission at the receiving end based on the correction information. You can set the FEC mode as needed.
Make sure you set the same FEC mode for both interfaces of a link.
Examples
# Set the FEC mode of HundredGigE 1/2/0/1 to autonegotiation.
<Sysname> system-view
[Sysname] interface hundredgige 1/2/0/1
[Sysname-HundredGigE1/2/0/1] port fec mode auto
port ifmonitor crc-error
Use port ifmonitor crc-error to configure CRC error packet alarm parameters for an interface.
Use undo port ifmonitor crc-error to restore the default.
Syntax
port ifmonitor crc-error [ ratio ] high-threshold high-value low-threshold low-value interval interval [ shutdown ]
undo port ifmonitor crc-error
Default
An interface uses the global CRC error packet alarm parameters.
Views
Ethernet interface view
Predefined user roles
network-admin
mdc-admin
Parameters
ratio: Specifies the alarm thresholds in percentage. If you do not specify this keyword, you configure the alarm thresholds in absolute value.
high-threshold high-value: Specifies the upper threshold for CRC error packet alarms. If you specify the ratio keyword, the value range is 1 to 100. If you do not specify the ratio keyword, the value range is 1 to 4294967295 packets.
low-threshold low-value: Specifies the lower threshold for CRC error packet alarms. If you specify the ratio keyword, the value range is 1 to 100. If you do not specify the ratio keyword, the value range is 1 to 4294967295 packets.
interval interval: Specifies the statistics collection and comparison interval for CRC error packets, in the range of 1 to 65535 seconds.
shutdown: Shuts down an interface when the number of incoming CRC error packets on the interface exceeds the upper threshold. Then, the interface stops forwarding all packets. To recover the interface, execute the undo shutdown command on the interface. If you do not specify this keyword, an upper threshold exceeding alarm is generated and the interface enters the alarm state when the number of incoming CRC error packets exceeds the upper threshold on the interface.
Usage guidelines
With the CRC error packet alarm function enabled, when the number of incoming CRC error packets on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the number of incoming CRC error packets on an interface in the alarm state within the specified interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.
You can configure the CRC error packet alarm parameters in system view and interface view.
· The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.
· For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.
When you execute this command multiple times, the most recent configuration takes effect.
Examples
# Set the upper threshold to 5000, lower threshold to 400, and statistics collection and comparison interval to 6 seconds for CRC error packet alarms on GigabitEthernet 1/2/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1
[Sysname-GigabitEthernet1/2/0/1] port ifmonitor crc-error high-threshold 5000 low-threshold 400 interval 6
Related commands
snmp-agent trap enable ifmonitor
port ifmonitor input-error
Use port ifmonitor input-error to configure input error packet alarm parameters for an interface.
Use undo port ifmonitor input-error to restore the default.
Syntax
port ifmonitor input-error high-threshold high-value low-threshold low-value interval interval [ shutdown ]
undo port ifmonitor input-error
Default
An interface uses the global input error packet alarm parameters.
Views
Ethernet interface view
Predefined user roles
network-admin
mdc-admin
Parameters
high-threshold high-value: Specifies the upper threshold for input error packet alarms, in the range of 1 to 4294967295 packets.
low-threshold low-value: Specifies the lower threshold for input error packet alarms, in the range of 1 to 4294967295 packets.
interval interval: Specifies the statistics collection and comparison interval for input error packets, in the range of 1 to 65535 seconds.
shutdown: Shuts down an interface when the number of input error packets on the interface exceeds the upper threshold. Then, the interface stops forwarding all packets. To recover the interface, execute the undo shutdown command on the interface. If you do not specify this keyword, an upper threshold exceeding alarm is generated and the interface enters the alarm state when the number of input error packets exceeds the upper threshold on the interface.
Usage guidelines
With the input error packet alarm function enabled, when the number of input error packets on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the number of input error packets on an interface in the alarm state within the specified interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.
You can configure the input error packet alarm parameters in system view and interface view.
· The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.
· For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.
When you execute this command multiple times, the most recent configuration takes effect.
Examples
# Set the upper threshold to 5000, lower threshold to 400, and statistics collection and comparison interval to 6 seconds for input error packet alarms on GigabitEthernet 1/2/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1
[Sysname-GigabitEthernet1/2/0/1] port ifmonitor input-error high-threshold 5000 low-threshold 400 interval 6
Related commands
snmp-agent trap enable ifmonitor
port ifmonitor input-usage
Use port ifmonitor input-usage to configure input bandwidth usage alarm parameters.
Use undo port ifmonitor input-usage to restore the default.
Syntax
port ifmonitor input-usage high-threshold high-value low-threshold low-value
undo port ifmonitor input-usage
Default
An interface uses the global input bandwidth usage alarm parameters.
Views
Interface view
Predefined user roles
network-admin
mdc-admin
Parameters
high-threshold high-value: Specifies the upper threshold for input bandwidth usage alarms, in the range of 1 to 100.
low-threshold low-value: Specifies the lower threshold for input bandwidth usage alarms, in the range of 1 to 100.
Usage guidelines
With the input bandwidth usage alarm function enabled, when the input bandwidth usage on an interface in normal state within the most recent statistics polling interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the input bandwidth usage on an interface in the alarm state within the most recent statistics polling interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.
You can use the flow-interval command to set the statistics polling interval.
You can configure the input bandwidth usage alarm parameters in system view and interface view.
· The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.
· For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.
For this command to take effect, you must use the snmp-agent trap enable ifmonitor command to enable the input bandwidth usage alarm function.
When you execute this command multiple times, the most recent configuration takes effect.
Examples
# Set the upper threshold to 80 and lower threshold to 60 for input bandwidth usage alarms on GigabitEthernet 1/2/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1
[Sysname-GigabitEthernet1/2/0/1] port ifmonitor input-usage high-threshold 80 low-threshold 60
Related commands
flow-interval
snmp-agent trap enable ifmonitor
port ifmonitor output-error
Use port ifmonitor output-error to configure output error packet alarm parameters for an interface.
Use undo port ifmonitor output-error to restore the default.
Syntax
port ifmonitor output-error high-threshold high-value low-threshold low-value interval interval [ shutdown ]
undo port ifmonitor output-error
Default
An interface uses the global output error packet alarm parameters.
Views
Ethernet interface view
Predefined user roles
network-admin
mdc-admin
Parameters
high-threshold high-value: Specifies the upper threshold for output error packet alarms, in the range of 1 to 4294967295 packets.
low-threshold low-value: Specifies the lower threshold for output error packet alarms, in the range of 1 to 4294967295 packets.
interval interval: Specifies the statistics collection and comparison interval for output error packets, in the range of 1 to 65535 seconds.
shutdown: Shuts down an interface when the number of output error packets on the interface exceeds the upper threshold. Then, the interface stops forwarding all packets. To recover the interface, execute the undo shutdown command on the interface. If you do not specify this keyword, an upper threshold exceeding alarm is generated and the interface enters the alarm state when the number of output error packets exceeds the upper threshold on the interface.
Usage guidelines
With the output error packet alarm function enabled, when the number of output error packets on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the number of output error packets on an interface in the alarm state within the specified interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.
You can configure the output error packet alarm parameters in system view and interface view.
· The configuration in system view takes effect on all interfaces of the specified slot. The configuration in interface view takes effect only on the current interface.
· For an interface, the configuration in interface view takes priority, and the configuration in system view is used only when no configuration is made in interface view.
When you execute this command multiple times, the most recent configuration takes effect.
Examples
# Set the upper threshold to 5000, lower threshold to 400, and statistics collection and comparison interval to 6 seconds for output error packet alarms on GigabitEthernet 1/2/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1
[Sysname-GigabitEthernet1/2/0/1] port ifmonitor output-error high-threshold 5000 low-threshold 400 interval 6
Related commands
snmp-agent trap enable ifmonitor
port ifmonitor output-usage
Use port ifmonitor output-usage to configure output bandwidth usage alarm parameters.
Use undo port ifmonitor output-usage to restore the default.
Syntax
port ifmonitor output-usage high-threshold high-value low-threshold low-value
undo port ifmonitor output-usage
Default
An interface uses the global output bandwidth usage alarm parameters.
Views
Interface view
Predefined user roles
network-admin
mdc-admin
Parameters
high-threshold high-value: Specifies the upper threshold for output bandwidth usage alarms, in the range of 1 to 100.
low-threshold low-value: Specifies the lower threshold for output bandwidth usage alarms, in the range of 1 to 100.
Usage guidelines
With the output bandwidth usage alarm function enabled, when the output bandwidth usage on an interface in normal state within the most recent statistics polling interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the output bandwidth usage on an interface in the alarm state within the most recent statistics polling interval drops below the lower threshold, the interface generates a recovery alarm and restores to the normal state.
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.
When you execute this command multiple times, the most recent configuration takes effect.
Examples
# Set the upper threshold to 9 and lower threshold to 7 for output bandwidth usage alarms on GigabitEthernet 1/2/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1
[Sysname-GigabitEthernet1/2/0/1] port ifmonitor output-usage high-threshold 9 low-threshold 7
Related commands
flow-interval
snmp-agent trap enable ifmonitor
port ifmonitor sdh-b1-error
Use port ifmonitor sdh-b1-error to configure SDH-B1 error packet alarm parameters for an interface.
Use undo port ifmonitor sdh-b1-error to restore the default.
Syntax
port ifmonitor sdh-b1-error high-threshold high-value low-threshold low-value interval interval [ shutdown ]
undo port ifmonitor sdh-b1-error
Default
An interface uses the global SDH-B1 error packet alarm parameters.
Views
Ethernet interface view
Predefined user roles
network-admin
mdc-admin
Parameters
high-threshold high-value: Specifies the upper threshold for SDH-B1 error packet alarms, in the range of 1 to 4294967295 packets.
low-threshold low-value: Specifies the lower threshold for SDH-B1 error packet alarms, in the range of 1 to 4294967295 packets.
interval interval: Specifies the statistics collection and comparison interval for SDH-B1 error packets, in the range of 1 to 65535 seconds.
shutdown: Shuts down an interface when the number of incoming SDH-B1 error packets on the interface exceeds the upper threshold. Then, the interface stops forwarding all packets. To recover the interface, execute the undo shutdown command on the interface. If you do not specify this keyword, an upper threshold exceeding alarm is generated and the interface enters the alarm state when the number of incoming SDH-B1 error packets exceeds the upper threshold on the interface.
Usage guidelines
With the SDH-B1 error packet alarm function enabled, when the number of incoming SDH-B1 error packets on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the number of incoming SDH-B1 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 SDH-B1 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.
For this command to take effect, you must use the snmp-agent trap enable ifmonitor command to enable the SDH-B1 error packet alarm function.
When you execute this command multiple times, the most recent configuration takes effect.
Examples
# Set the upper threshold to 20, lower threshold to 10, and statistics collection and comparison interval to 10 seconds for SDH-B1 error packet alarms on GigabitEthernet 1/2/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1
[Sysname-GigabitEthernet1/2/0/1] port ifmonitor sdh-b1-error high-threshold 20 low-threshold 10 interval 10
Related commands
snmp-agent trap enable ifmonitor
port ifmonitor sdh-b2-error
Use port ifmonitor sdh-b2-error to configure SDH-B2 error packet alarm parameters for an interface.
Use undo port ifmonitor sdh-b2-error to restore the default.
Syntax
port ifmonitor sdh-b2-error high-threshold high-value low-threshold low-value interval interval [ shutdown ]
undo port ifmonitor sdh-b2-error
Default
An interface uses the global SDH-B2 error packet alarm parameters.
Views
Ethernet interface view
Predefined user roles
network-admin
mdc-admin
Parameters
high-threshold high-value: Specifies the upper threshold for SDH-B2 error packet alarms, in the range of 1 to 4294967295 packets.
low-threshold low-value: Specifies the lower threshold for SDH-B2 error packet alarms, in the range of 1 to 4294967295 packets.
interval interval: Specifies the statistics collection and comparison interval for SDH-B2 error packets, in the range of 1 to 65535 seconds.
shutdown: Shuts down an interface when the number of incoming SDH-B2 error packets on the interface exceeds the upper threshold. Then, the interface stops forwarding all packets. To recover the interface, execute the undo shutdown command on the interface. If you do not specify this keyword, an upper threshold exceeding alarm is generated and the interface enters the alarm state when the number of incoming SDH-B2 error packets exceeds the upper threshold on the interface.
Usage guidelines
With the SDH-B2 error packet alarm function enabled, when the number of incoming SDH-B2 error packets on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the number of incoming SDH-B2 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 SDH-B2 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.
For this command to take effect, you must use the snmp-agent trap enable ifmonitor command to enable the SDH-B2 error packet alarm function.
When you execute this command multiple times, the most recent configuration takes effect.
Examples
# Set the upper threshold to 10, lower threshold to 8, and statistics collection and comparison interval to 3 seconds for SDH-B2 error packet alarms on GigabitEthernet 1/2/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1
[Sysname-GigabitEthernet1/2/0/1] port ifmonitor sdh-b2-error high-threshold 10 low-threshold 8 interval 3
Related commands
snmp-agent trap enable ifmonitor
port ifmonitor sdh-error
Use port ifmonitor sdh-error to configure SDH error packet alarm parameters for an interface.
Use undo port ifmonitor sdh-error to restore the default.
Syntax
port ifmonitor sdh-error high-threshold high-value low-threshold low-value interval interval [ shutdown ]
undo port ifmonitor sdh-error
Default
An interface uses the global SDH error packet alarm parameters.
Views
Ethernet interface view
Predefined user roles
network-admin
mdc-admin
Parameters
high-threshold high-value: Specifies the upper threshold for SDH error packet alarms, in the range of 1 to 4294967295 packets.
low-threshold low-value: Specifies the lower threshold for SDH error packet alarms, in the range of 1 to 4294967295 packets.
interval interval: Specifies the statistics collection and comparison interval for SDH error packets, in the range of 1 to 65535 seconds.
shutdown: Shuts down an interface when the number of incoming SDH error packets on the interface exceeds the upper threshold. Then, the interface stops forwarding all packets. To recover the interface, execute the undo shutdown command on the interface. If you do not specify this keyword, an upper threshold exceeding alarm is generated and the interface enters the alarm state when the number of incoming SDH error packets exceeds the upper threshold on the interface.
Usage guidelines
With the SDH error packet alarm function enabled, when the number of incoming SDH error packets on an interface in normal state within the specified interval exceeds the upper threshold, the interface generates an upper threshold exceeding alarm and enters the alarm state. When the number of incoming SDH 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 SDH 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.
For this command to take effect, you must use the snmp-agent trap enable ifmonitor command to enable the SDH error packet alarm function.
When you execute this command multiple times, the most recent configuration takes effect.
Examples
# Set the upper threshold to 50, lower threshold to 30, and statistics collection and comparison interval to 10 seconds for SDH error packet alarms on GigabitEthernet 1/2/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1
[Sysname-GigabitEthernet1/2/0/1] port ifmonitor sdh-error high-threshold 50 low-threshold 30 interval 10
Related commands
snmp-agent trap enable ifmonitor
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
mdc-admin
Parameters
bridge: Specifies the Layer 2 mode.
route: Specifies the Layer 3 mode.
Usage guidelines
Interfaces operate differently depending on the hardware structure of interface cards. For a device:
· Some Ethernet interfaces can operate only as Layer 2 Ethernet interfaces (in bridge mode).
· Some Ethernet interfaces can operate only as Layer 3 Ethernet interfaces (in route mode).
· Some 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.
Changing the link mode of an Ethernet interface also restores all commands (except shutdown) on the Ethernet interface to their defaults in the new link mode.
Examples
# Configure GigabitEthernet 1/2/0/1 to operate in Layer 2 mode.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1
[Sysname-GigabitEthernet1/2/0/1] port link-mode bridge
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
mdc-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
Interfaces on the interface card are separated into four-member interface groups. Interfaces in the same group must operate in the same mode. To modify the operating mode of the interfaces in a group, execute this command on the lowest numbered interface in the group. The change will be automatically synchronized to the remaining interfaces in the group.
If you have modified the number of interframe filling tags for an interface on a CR-HIC-XP12, CR-HIC-XP12B, CR-19K-LPU-XP20CC02, CR-19K-LPU-XP40, CR-19K-LPU-XP48, CR-19K-LPU-XP72 card, as a best practice to ensure a successful LAN/WAN operating mode switchover, restore the IPG settings to the default first.
Examples
# Configure Ten-GigabitEthernet 1/2/0/1 to operate in WAN mode.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/2/0/1
[Sysname-Ten-GigabitEthernet1/2/0/1] port-mode wan
# Configure Ten-GigabitEthernet 1/2/0/1 to operate in WAN mode on an interface card that supports interface grouping.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/2/0/1
[Sysname-Ten-GigabitEthernet1/2/0/1] port-mode wan
This command will take effect on Ten-GigabitEthernet1/2/0/1, Ten-GigabitEthernet1/2/
0/2, Ten-GigabitEthernet1/2/0/3, and Ten-GigabitEthernet1/2/0/4. Continue? [Y/N]:y
reset counters interface
Use reset counters interface to clear the interface statistics.
Syntax
reset counters interface [ interface-type [ interface-number | interface-number.subnumber ] ]
Views
User view
Predefined user roles
network-admin
mdc-admin
Parameters
interface-type: Specifies an interface type.
interface-number: Specifies an interface number.
interface-number.subnumber: Specifies a subinterface number. The interface-number argument is an interface number. The subnumber argument is the number of a subinterface created under the interface. The value range for the subnumber argument is 1 to 4094.
Usage guidelines
Use this command to clear history statistics if you want to collect traffic statistics for a specific time period.
If you do not specify an interface type, this command clears statistics for all interfaces.
If you specify an interface type but do not specify an interface number, this command clears statistics for all interfaces of the specified type.
Examples
# Clear the statistics for GigabitEthernet 1/2/0/1.
<Sysname> reset counters interface gigabitethernet 1/2/0/1
Related commands
display counters interface
display counters rate interface
display interface
reset ethernet statistics
Use reset ethernet statistics to clear the Ethernet module statistics.
Syntax
reset ethernet statistics [ chassis chassis-number slot slot-number [ cpu cpu-number ] ]
Views
User view
Predefined user roles
network-admin
mdc-admin
Parameters
chassis chassis-number slot slot-number: Specifies a card on a cluster member device. The chassis-number argument represents the member ID of the cluster 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 cluster member devices.
cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.
Examples
# Clear the Ethernet module statistics for the specified slot.
<Sysname> reset ethernet statistics chassis 1 slot 2
Related commands
display ethernet statistics
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
mdc-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 GigabitEthernet 1/2/0/1.
<Sysname> reset packet-drop interface gigabitethernet 1/2/0/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
mdc-admin
Usage guidelines
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 GigabitEthernet 1/2/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1
[Sysname-GigabitEthernet1/2/0/1] shutdown
[Sysname-GigabitEthernet1/2/0/1] undo shutdown
# Shut down and then bring up GigabitEthernet 1/2/0/1.1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1.1
[Sysname-GigabitEthernet1/2/0/1.1] shutdown
[Sysname-GigabitEthernet1/2/0/1.1] undo shutdown
snmp-agent trap enable ifmonitor
Use snmp-agent trap enable ifmonitor to enable interface alarm functions.
Use undo snmp-agent trap enable ifmonitor to disable interface alarm functions.
Syntax
snmp-agent trap enable ifmonitor[ crc-error | input-error | input-usage | output-error | output-usage | sdh-b1-error | sdh-b2-error | sdh-error ] *
undo snmp-agent trap enable ifmonitor[ crc-error | input-error | input-usage | output-error | output-usage | sdh-b1-error | sdh-b2-error | sdh-error ] *
Default
Interface alarm functions are enabled.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
crc-error: Enables the CRC error packet alarm function for interfaces.
input-error: Enables the input error packet alarm function for interfaces.
input-usage: Enables the input bandwidth usage alarm function for interfaces.
output-error: Enables the output error packet alarm function for interfaces.
output-usage: Enables the output bandwidth usage alarm function for interfaces.
sdh-b1-error: Enables the SDH-B1 error packet alarm function for interfaces.
sdh-b2-error: Enables the SDH-B2 error packet alarm function for interfaces.
sdh-error: Enables the SDH error 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
speed
Use speed to set the speed of an Ethernet interface.
Use undo speed to restore the default.
Syntax
speed { 1000 | 10000 }
undo speed
Default
The speed of an interface on an interace card is its initial speed.
Views
Ethernet interface view
Predefined user roles
network-admin
mdc-admin
Parameters
1000: Sets the interface speed to 1000 Mbps.
10000: Sets the interface speed to 10000 Mbps.
Usage guidelines
For an Ethernet copper port, use the speed command to set its speed to match the speed of the peer interface.
For a fiber port, use the speed command to set its speed to match the rate of a transceiver module.
Support of an interface for the keywords depends on the interface type. For more information, use the speed ? command in interface view,
Examples
# Configure GigabitEthernet 1/2/0/1 to autonegotiate the speed.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1
[Sysname-GigabitEthernet1/2/0/1] speed 10000
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 interface to a 40-GE interface.
Syntax
using fortygige
Default
The 10-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
This command is not supported on non-default MDCs.
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. 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 exist:
· The peer is a 40-GE interface.
· No 100-GE transceiver module is available, and 40-GE transceiver modules are available.
This command takes effect in real time, and cannot be rolled back.
40-GE interfaces changed from 100-GE interfaces cannot be split.
Examples
# Combine Ten-GigabitEthernet 1/2/0/1:1 through Ten-GigabitEthernet 1/2/0/1:4 into a 40-GE interface.
<System> system-view
[System] interface ten-gigabitethernet1/2/0/1:1
[System-Ten-GigabitEthernet1/2/0/1:1] using fortygige
The interfaces Ten-GigabitEthernet1/2/0/1:1 through Ten-GigabitEthernet1/2/0/1:4 will be deleted. Continue? [Y/N]:y
# Change HundredGigE 1/2/0/1 to a 40-GE interface.
<System> system-view
[System] interface hundredgige 1/2/0/1
[System-HundredGigE1/2/0/1] using fortygige
The interface HundredGigE1/2/0/1 will be deleted. Continue? [Y/N]:y
Related commands
using hundredgige
using tengige
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
This command is not supported on non-default MDCs.
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 takes effect in real time, and cannot be rolled back.
Examples
# Change Ten-GigabitEthernet 1/2/0/1 to a GE interface.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/2/0/1
[Sysname-Ten-GigabitEthernet1/2/0/1] using gigabit
The interface Ten-GigabitEthernet1/2/0/1 will be deleted. Continue? [Y/N]:y
Related commands
using tengige
using hundredgige
Use using hundredgige to combine 10-GE breakout interfaces split from a 100-GE interface into a 100-GE interface or restore a 40-GE interface changed from a 100-GE interface back to a 100-GE interface.
Syntax
using hundredgige
Default
The 10-GE breakout interfaces are not combined and operate as single interfaces. The 40-GE interface is not changed to a 100-GE interface.
Views
10-GE breakout interface view
View of a 40-GE interface changed from a 100-GE interface
Predefined user roles
network-admin
Usage guidelines
This command is not supported on non-default MDCs.
You can split a 100-GE interface into four 10-GE breakout interfaces.
If you need higher bandwidth on a single interface, perform the following tasks as needed:
· You can combine four 10-GE breakout interfaces split from a 100-GE interface into a 100-GE interface. To do so, execute this command on any of these 10-GE breakout interfaces.
· You can 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.
This command takes effect in real time, and cannot be rolled back.
Examples
# Combine Ten-GigabitEthernet 1/2/0/1:1 through Ten-GigabitEthernet 1/2/0/1:4 into a 100-GE interface.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/2/0/1:4
[Sysname-Ten-GigabitEthernet1/2/0/1:1]using hundredgige
The interfaces Ten-GigabitEthernet1/2/0/1:1 through Ten-GigabitEthernet1/2/0/1:4 will be deleted. Continue? [Y/N]:y
# Restore FortyGigE 1/2/0/1 to a 100-GE interface.
<Sysname> system-view
[Sysname] interface fortygige 1/2/0/1
[Sysname-FortyGigE1/2/0/1] using hundredgige
The interface FortyGigE1/2/0/1 will be deleted. Continue? [Y/N]:y
Related commands
using fortygige
using tengige
using tengige
Use using tengige to split a high bandwidth interface into multiple 10-GE breakout interfaces or restore a GE interface changed from a 10-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
100-GE interface view
40-GE interface view
GE interface view
Predefined user roles
network-admin
Usage guidelines
This command is not supported on non-default MDCs.
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.
This command takes effect in real time, and cannot be rolled back.
Examples
# Split FortyGigE 1/2/0/1 into four 10-GE breakout interfaces.
<System> system-view
[System] interface fortygige 1/2/0/1
[System-FortyGigE1/2/0/1] using tengige
The interface FortyGigE1/2/0/1 will be deleted. Continue? [Y/N]:y
Related commands
using gigabit
Layer 3 Ethernet interface or subinterface commands
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
mdc-admin
Parameters
size: Sets the MTU in the range of 1280 to 9600 bytes.
spread: Batch modifies the MTU for the subinterfaces of a main interface. Subinterfaces do not support this keyword.
Usage guidelines
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.
When a main interface and its subinterfaces are in the same MDC, 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.
Examples
# Set the MTU to 1430 bytes for GigabitEthernet 1/2/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1
[Sysname-GigabitEthernet1/2/0/1] mtu 1430
# Set the MTU to 1430 bytes for GigabitEthernet 1/2/0/1.1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1.1
[Sysname-GigabitEthernet1/2/0/1.1] mtu 1430
# Set the MTU to 1430 bytes for GigabitEthernet 1/2/0/1 and its subinterfaces.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1
[Sysname-GigabitEthernet1/2/0/1] mtu 1430 spread
This operation may take a long time to modify the MTU of subinterfaces on this interface. Continue? [Y/N]:y
traffic-statistic enable
Use traffic-statistic enable to enable packet statistics collection for a Layer 3 Ethernet subinterface.
Use undo traffic-statistic enable to disable packet statistics collection for a Layer 3 Ethernet subinterface.
Syntax
traffic-statistic enable
undo traffic-statistic enable
Default
Packet statistics collection is disabled for a Layer 3 Ethernet subinterface.
Views
Layer 3 Ethernet subinterface view
Predefined user roles
network-admin
mdc-admin
Usage guidelines
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.
Examples
# Enable packet statistics collection for GigabitEthernet 1/2/0/1.1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1.1
[Sysname-GigabitEthernet1/2/0/1.1] traffic-statistic enable
Related commands
display counters
display interface
flow-interval