S1720, S2700, S5700, and S6720 V200R011C10 Command Reference
This document describes all the configuration commands of the device, including the command function, syntax, parameters, views, default level, usage guidelines, examples, and related commands.
This document describes all the configuration commands of the device, including the command function, syntax, parameters, views, default level, usage guidelines, examples, and related commands.
Basic Interface Configuration Commands
- Command Support
- collect counters top
- bandwidth (Interface view)
- description (interface view)
- display counters
- display counters error
- display counters interface
- display counters rate
- display counters top interface
- display interface
- display interface brief
- display interface description
- display ip interface
- display ip interface description
- display this interface
- interface
- mtu (Interface view)
- port description
- reset counters if-mib interface
- reset counters interface
- reset counters top interface
- restart (interface view)
- set flow-stat interval
- shutdown (interface view)
collect counters top
Function
The collect counters top command sets the parameters for top N interface traffic statistics and enables the function to generate top N interface traffic statistics reports.
Format
collect counters top [ number ] interface { interface-type | all | layer-2 | layer-3 } [ sort-by statistics-type | interval interval-value ] *
Parameters
Parameter | Description | Value |
---|---|---|
number | Specifies the number of busiest interfaces for which traffic statistics reports are to be generated. For example, if the value is 10, a traffic statistics report about top 10 busiest interfaces is generated. If you do not specify this parameter, a traffic statistics report about top 20 busiest interfaces is generated. |
The value is an integer ranging from 1 to 50000. |
interface { interface-type | all | layer-2 | layer-3 } | Specifies the type of the interfaces for which a top N traffic statistics report is to be generated:
|
The specified interfaces must be Ethernet physical interfaces or Eth-Trunk interfaces. |
sort-by statistics-type | Specifies the statistics type by which ports are determined to be the busiest. If you do not specify sort-by statistics-type, statistics are sorted by the total number of bytes in descending order. |
The value can be:
|
interval interval-value | Specifies the interval at which statistics are collected. | The value is an integer ranging from 1 to 999, in seconds. The default value is 30. |
Usage Guidelines
Usage Scenario
The display command allows you to view statistics about the traffic sent and received by each interface on a device, but cannot sort these statistics by traffic volume in descending order. The display counters top interface command allows you to view top N interface traffic statistics reports, facilitating interface monitoring. Before you view a top N interface traffic statistics report, run the collect counters top command to generate your desired top N interface traffic statistics report. For example, configure the device to generate a top N statistics report about packets dropped on Layer 2 interfaces within 50s.
The top N interface traffic statistics function sorts statistics about inbound and outbound traffic processed by interfaces within a collection interval in descending order and generates a top N interface traffic statistics report. The device stops collecting interface traffic statistics after the collection interval ends. To generate another top N interface traffic statistics report, run the collect counters top command again.
Configuration Impact
- After the collect counters top command is run, the device collects interface traffic statistics and generates a top N interface traffic statistics report based on the set parameters.
- The collect counters top command configuration is not saved in the configuration file.
Follow-up Procedure
To view a top N interface traffic statistics report, run the display counters top interface command.
Precautions
- When the master switch in a stack containing multiple member switches is faulty, the top N interface traffic statistics function takes effect only on a master switch. If the master switch encounters a fault and switches to the backup state, run the collect counters top command on the new master switch again.
- The collect counters top command can be run multiple times in succession with different parameters specified. For example, you can configure a device to generate a top N statistics report about interface multicast packets when the device is still generating a top N statistics report about interface broadcast packets.
- The top N interface traffic statistics function allows a device to generate a maximum of five top N interface traffic statistics reports. If you want the device to generate new top N interface traffic statistics reports when five top N interface traffic statistics reports already exist, run the reset counters top interface command to clear existing ones.
bandwidth (Interface view)
Function
The bandwidth command sets the interface bandwidth obtained by the NMS from the MIB.
The undo bandwidth command restores the default configuration.
By default, the interface bandwidth obtained by the NMS from the MIB depends on the interface type. For example, the bandwidth of a GE interface is 1000 Mbit/s.
Only the S2750EI, S5720EI, S5720HI, S6720EI and S6720S-EI support this command.
Parameters
Parameter | Description | Value |
---|---|---|
bandwidth | Specifies the bandwidth of an interface. | The value is an integer ranging from 1 to 1000000, and the unit is Mbit/s. |
Views
Ethernet interface view, GE interface view, XGE interface view, 40GE interface view, Tunnel interface view, Eth-Trunk interface view, VLANIF interface view, VE interface view, VE sub-interface view
Usage Guidelines
- If the configured bandwidth is smaller than 4000 Mbit/s, ifSpeed and ifHighSpeed are respectively displayed as bandwidth x 1000 x 1000 and bandwidth.
- If the configured bandwidth is equal to or larger than 4000 Mbit/s, ifSpeed and ifHighSpeed are respectively displayed as 4294967295 (0XFFFFFFFF) and bandwidth.
description (interface view)
Function
The description command configures the description for an interface.
The undo description command restores the default description of an interface.
By default, the description of an interface is null.
display counters
Format
display counters [ inbound | outbound ] [ interface interface-type [ interface-number ] ] [ nonzero ]
Parameters
Parameter | Description | Value |
---|---|---|
inbound | Displays incoming traffic statistics on an interface. | - |
outbound | Displays outgoing traffic statistics on an interface. | - |
interface interface-type [ interface-number ] | Displays traffic statistics on a specified interface.
If the interface number is not specified, traffic statistics on all the interfaces of the specified type are displayed. |
- |
nonzero | Displays statistics about interface traffic. If the numbers of bytes, octets packets, unicast packets, multicast packets, and broadcast packets on an interface are all 0s, traffic statistics on this interface are not displayed. |
- |
Usage Guidelines
Usage Scenario
You can run the display counters command to view incoming or outgoing traffic statistics based on the interface type for fault location.
Precautions
Only the S6720EI, S6720S-EI, S5720HI and S5720EI support sub-interfaces.
- The displayed information is repeatedly refreshed, causing desired information unable to be obtained.
- The system does not respond because of long-time information traversing and searching.
Example
# Display traffic statistics on GE0/0/1.
<HUAWEI> display counters interface gigabitethernet 0/0/1 Inbound Interface Octets(bytes) Unicast(pkts) Multicast(pkts) Broadcast(pkts) GE0/0/1 754918035105 1408179641 15018056 9668635374 Outbound Interface Octets(bytes) Unicast(pkts) Multicast(pkts) Broadcast(pkts) GE0/0/1 764800451602 1148151623 15086605 9957268821
<HUAWEI> display counters nonzero
Info: This operation may take a few seconds. Please wait for a moment... Inbound Interface Octets(bytes) Unicast(pkts) Multicast(pkts) Broadcast(pkts) GE0/0/1 1467604 0 2902 0 Outbound Interface Octets(bytes) Unicast(pkts) Multicast(pkts) Broadcast(pkts) GE0/0/1 2703904 0 13750 1
Item |
Description |
---|---|
Inbound |
Incoming traffic statistics on an interface. |
Interface |
Interface name. |
Octets(bytes) |
Total number of incoming or outgoing bytes. |
Unicast(pkts) |
Number of incoming or outgoing unicast packets. |
Multicast(pkts) |
Number of incoming or outgoing multicast packets. |
Broadcast(pkts) |
Number of incoming or outgoing broadcast packets. |
Outbound |
Outgoing traffic statistics on an interface. |
display counters error
Format
display counters error [ inbound | outbound ] [ interface interface-type [ interface-number ] ]
Parameters
Parameter | Description | Value |
---|---|---|
inbound | Displays inbound error packet statistics. | - |
outbound | Displays outbound error packet statistics. | - |
interface interface-type [ interface-number ] | Displays error packet statistics on the specified
interface.
If interface type and interface number are not specified, the statistics of error packets on all interfaces are displayed. |
- |
Usage Guidelines
You can run the display counters error command to view detailed error packet statistics on all types of interfaces, which facilitates maintenance when there is a large number of error packets.
Example
# Check all error packet statistics on the device.
<HUAWEI> display counters error Inbound Interface Total CRC Giants Fragments GE0/0/1 0 0 0 0 GE0/0/2 0 0 0 0 GE0/0/3 0 0 0 0 GE0/0/4 0 0 0 0 GE0/0/5 0 0 0 0 Interface Runts DropEvents Alignments Symbols GE0/0/1 0 0 0 0 GE0/0/2 0 0 0 0 GE0/0/3 0 0 0 0 GE0/0/4 0 0 0 0 GE0/0/5 0 0 0 0 Outbound Interface Total Collisions Excess-Col Late Collisions GE0/0/1 0 0 0 0 GE0/0/2 0 0 0 0 GE0/0/3 0 0 0 0 GE0/0/4 0 0 0 0 GE0/0/5 0 0 0 0
Item |
Description |
---|---|
Inbound |
Inbound error packet statistics. |
Outbound |
Outbound error packet statistics. |
Interface |
Interface name. |
Total |
Total number of inbound and outbound error packets. |
CRC |
Number of packets shorter than 1518 bytes and with incorrect FCS values. For the S5720SI, S5720S-SI, S5710X-LI, S5720HI, S5730SI, S5730S-EI, S6720SI, and S6720S-SI, the value of this field includes the number of received packets longer than the maximum jumbo frame length and with incorrect FCS values. For switches excluding the S5720EI, the value of this field contains the number of received packets with length ranging from 1518 bytes to the jumbo frame size configured on the interface and incorrect FCS values. |
Giants |
Number of received packets with length exceeding the maximum jumbo frame size. |
Fragments |
Number of fragmented packets received by the interface. A fragmented packet is a packet with length less than 64 bytes and incorrect CRC values. On the S5720SI, S5720S-SI, S5710-X-LI, S5730SI, S5730S-EI, S6720SI, S6720S-SI, S6720S-EI, and S6720EI, the command output does not contain the Fragments field to display statistics about received fragmented packets. |
Runts |
Number of received undersized frames with correct CRC values. An undersized frame is a frame that is shorter than 64 bytes, in correct format, and contains a valid CRC field. For the S5720SI, S5720S-SI, S5710-X-LI, S5730SI, S5730S-EI, S6720SI, S6720S-SI, S6720S-EI, and S6720EI, the value of this field includes the number of received fragmented packets shorter than 64 bytes and with incorrect CRC values. |
DropEvents |
Number of received packets that are discarded due to GBP full or back pressure. |
Alignments |
Number of received frames with alignment error. |
Symbols |
Number of received frames with coding error. |
Collisions |
Number of packets with 1 to 15 collisions during packet forwarding. For the S5720SI, S5720S-SI, S5710-X-LI, S5730SI, S5730S-EI, S6720SI, S6720S-SI, S6720S-EI, and S6720EI, the value of this field contains the number of frames that are not sent due to 16 consecutive collisions. |
Excess-Col |
After sixteen successive collisions, the system will take it as excessive collision statistics when another collision occurs. Frames that are not sent due to excessive collisions are counted in this field. On the S5720SI, S5720S-SI, S5710-X-LI, S5730SI, S5730S-EI, S6720SI, S6720S-SI, S6720S-EI, and S6720EI, the command output does not contain the Excess-Col field to display statistics about frames that are not sent due to 16 consecutive collisions. |
Late Collisions |
Number of delay collision frames. A delay collision frame is a frame that is delayed because a collision is detected when the first 512 bits of the frame are sent. |
display counters interface
Function
The display counters interface command displays traffic statistics on an interface, including typical packet statistics and number of packets discarded in queues.
Format
display counters interface [ interface-type interface-number ] [ verbose | nonzero ]
display counters interface verbose [ nonzero ]
Parameters
Parameter |
Description |
Value |
---|---|---|
interface-type interface-number | Specifies the interface type and number.
|
- |
verbose | Displays detailed traffic statistics on an interface, including typical packet statistics and number of packets discarded in queues. |
- |
nonzero | Displays non-zero traffic statistics on an interface, including typical packet statistics and number of packets discarded in queues. |
- |
Usage Guidelines
Usage Scenario
When diagnosing faults on an interface, run the display counters interface [ interface-type interface-number ] [ verbose | nonzero ] command to view detailed information about packets received and sent by the interface to determine whether the interface works properly. You can also run this command to view detailed traffic statistics on an interface, including typical packet statistics and number of packets discarded in queues. You can also run this command to view non-zero traffic statistics on an interface, including typical packet statistics and number of packets discarded in queues.
Follow-up Procedure
If you want to collect new traffic statistics, run the reset counters interface command to clear the current statistics.
Example
# Display traffic statistics on an interface, including typical packet statistics and number of packets discarded in queues. (The following uses a S5720EI as an example.)
<HUAWEI> display counters interface gigabitethernet 0/0/1 verbose GigabitEthernet0/0/1 InPackets : 0 InOctets : 0 InUcastPkts : 0 InMcastPkts : 0 InBcastPkts : 0 OutPackets : 0 OutOctets : 0 OutUcastPkts : 0 OutMcastPkts : 0 OutBcastPkts : 0 InJumbo : 0 InPause : 0 Frames : 0 OutJumbo : 0 OutPause : 0 InDiscards : 0 OutDiscards : 0 InErrors : 0 OutErrors : 0 CRC : 0 Giants : 0 Jabbers : 0 Fragments : 0 Runts : 0 DropEvents : 0 Alignments : 0 Symbols : 0 Ignoreds : 0 Collisions : 0 ExcessiveCollisions : 0 Late Collisions : 0 Deferreds : 0 Buffers purged : 0 InPkts64Octets : 0 InPkts65to127Octets : 0 InPkts128to255Octets : 0 InPkts256to511Octets : 0 InPkts512to1023Octets : 0 InPkts1024to1518Octets : 0 OutPkts64Octets : 0 OutPkts65to127Octets : 0 OutPkts128to255Octets : 0 OutPkts256to511Octets : 0 OutPkts512to1023Octets : 0 OutPkts1024to1518Octets : 0 Queue0lostPkts : 0 Queue1lostPkts : 0 Queue2lostPkts : 0 Queue3lostPkts : 0 Queue4lostPkts : 0 Queue5lostPkts : 0 Queue6lostPkts : 0 Queue7lostPkts : 0
Item |
Description |
---|---|
GigabitEthernet0/0/1 |
The interface type and number. |
InPackets |
Total number of packets received by the interface. |
InOctets |
Total number of bytes in packets received by the interface. |
InUcastPkts |
Number of unicast packets received by the interface. |
InMcastPkts |
Number of multicast packets received by the interface. |
InBcastPkts |
Number of broadcast packets received by the interface. |
OutPackets |
Total number of packets sent by the interface. |
OutOctets |
Total number of bytes in packets sent by the interface. |
OutUcastPkts |
Number of unicast packets sent by the interface. |
OutMcastPkts |
Number of multicast packets sent by the interface. |
OutBcastPkts |
Number of broadcast packets sent by the interface. |
InJumbo |
Number of Ethernet frames with length ranging from 1518 bytes to the maximum jumbo frame size and correct FCS values received by the interface, or number of VLAN frames with length ranging from 1522 bytes to the maximum jumbo frame size and correct FCS values received or sent by the interface. |
InPause |
Number of pause frames received by the interface. |
Frames |
Number of packets in which the 802.3 length field does not match the actual length received by the interface. |
OutJumbo |
Number of Ethernet frames with length ranging from 1518 bytes to the maximum jumbo frame size and correct FCS values sent by the interface, or number of VLAN frames with length ranging from 1522 bytes to the maximum jumbo frame size and correct FCS values received or sent by the interface. |
OutPause |
Number of pause frames sent by the interface. |
InDiscards |
Number of incoming packets discarded by the interface. The number is detected during physical layer detection. |
OutDiscards |
Number of outgoing packets discarded by the interface. The number is detected during physical layer detection. |
InErrors |
Number of incoming error packets on the interface. The number is detected during physical layer detection. |
OutErrors |
Number of outgoing error packets on the interface. The number is detected during physical layer detection. |
CRC |
Number of packets shorter than 1518 bytes and with incorrect FCS values. For the S5720LI, S5720SI, S5720S-SI, S5710X-LI, S5720HI, S5730SI, S5730S-EI, S6720SI, and S6720S-SI, the value of this field includes the number of received packets longer than the maximum jumbo frame length and with incorrect FCS values. For switches excluding the S5720EI, the value of this field contains the number of received packets with length ranging from 1518 bytes to the jumbo frame size configured on the interface and incorrect FCS values. |
Giants |
Number of received packets with length exceeding the maximum jumbo frame size.
To set the maximum jumbo frame size, run the jumboframe enable command. |
Jabbers |
Number of received packets with length ranging from 1518 bytes to the maximum jumbo frame size and incorrect FCS values on the S5720EI. The S2720EI, S5720LI, S5720SI, S5720S-SI, S5710-X-LI, S5730SI, S5730S-EI, S6720SI, S6720S-SI, S6720S-EI, and S6720EI do not have the Jabbers field. On the other product models, this field indicates the number of received packets with length exceeding the maximum jumbo frame size and incorrect FCS values. |
Fragments |
Number of received fragmented packets. A fragmented packet is a packet shorter than 64 bytes and with incorrect CRC values. For the S5720HI, the value of this field contains the number of undersized frames with the correct CRC values received is displayed. On the S2720EI, S5720LI, S5720SI, S5720S-SI, S5710-X-LI, S5730SI, S5730S-EI, S6720SI, S6720S-SI, S6720S-EI, and S6720EI, the command output does not contain the Fragments field to display statistics about received fragmented packets. |
Runts |
Number of undersized frames with correct CRC values received by the interface. For the S5720LI, S5720SI, S5720S-SI, S5710-X-LI, S5730SI, S5730S-EI, S6720SI, S6720S-SI, S6720S-EI, and S6720EI, the value of this field includes the number of received fragmented packets shorter than 64 bytes and with incorrect CRC values. |
DropEvents |
Number of received packets that are discarded due to GBP full or back pressure. |
Alignments |
Number of received frames with alignment errors. |
Symbols |
Number of received frames with coding errors. |
Ignoreds |
Number of received MAC control frames whose OpCode is not PAUSE. |
Collisions |
Number of packets with 1 to 15 collisions during packet forwarding. For the S5720SI, S5720S-SI, S5710-X-LI, S5730SI, S5730S-EI, S6720SI, S6720S-SI, S6720S-EI, and S6720EI, the value of this field contains the number of frames that are not sent due to 16 consecutive collisions. |
ExcessiveCollisions |
Number of packets with 16 collisions and fail to be sent. On the S2720EI, S5720SI, S5720S-SI, S5710-X-LI, S5730SI, S5730S-EI, S6720SI, S6720S-SI, S6720S-EI, and S6720EI, the command output does not contain the ExcessiveCollisions field to display statistics about frames that are not sent due to 16 consecutive collisions. |
Late Collisions |
Number of packets with conflict and delayed. |
Deferreds |
Number of delayed packets without conflict. |
Buffers Purged |
Number of packets aged in the cache. |
InOutPkts64Octets |
Number of packets shorter than 64 bytes received and sent by the interface. |
InOutPkts65to127Octets |
Number of packets with length ranging from 65 bytes to 127 bytes received and sent by the interface. |
InOutPkts128to255Octets |
Number of packets with length ranging from 128 bytes to 255 bytes received and sent by the interface. |
InOutPkts256to511Octets |
Number of packets with length ranging from 256 bytes to 511 bytes received and sent by the interface. |
InOutPkts512to1023Octets |
Number of packets with length ranging from 512 bytes to 1023 bytes received and sent by the interface. |
InOutPkts1024toMaxOctets |
Number of packets with length exceeding 1024 bytes received and sent by the interface. |
InPkts64Octets |
Number of packets shorter than 64 bytes received by the interface. |
InPkts65to127Octets |
Number of packets with length ranging from 65 bytes to 127 bytes received by the interface. |
InPkts128to255Octets |
Number of packets with length ranging from 128 bytes to 255 bytes received by the interface. |
InPkts256to511Octets |
Number of packets with length ranging from 256 bytes to 511 bytes received by the interface. |
InPkts512to1023Octets |
Number of packets with length ranging from 512 bytes to 1023 bytes received by the interface. |
InPkts1024to1518Octets |
Number of packets with length ranging from 1024 bytes to 1518 bytes received by the interface. |
OutPkts64Octets |
Number of packets shorter than 64 bytes sent by the interface. The value NA indicates that the interface does not support this field. |
OutPkts65to127Octets |
Number of packets with length ranging from 65 bytes to 127 bytes sent by the interface. The value NA indicates that the interface does not support this field. |
OutPkts128to255Octets |
Number of packets with length ranging from 128 bytes to 255 bytes sent by the interface. The value NA indicates that the interface does not support this field. |
OutPkts256to511Octets |
Number of packets with length ranging from 256 bytes to 511 bytes sent by the interface. The value NA indicates that the interface does not support this field. |
OutPkts512to1023Octets |
Number of packets with length ranging from 512 bytes to 1023 bytes sent by the interface. The value NA indicates that the interface does not support this field. |
OutPkts1024to1518Octets |
Number of packets with length ranging from 1024 bytes to 1518 bytes sent by the interface. The value NA indicates that the interface does not support this field. |
Queue0lostPkts |
Number of packets discarded in queue 0. |
Queue1lostPkts |
Number of packets discarded in queue 1. |
Queue2lostPkts |
Number of packets discarded in queue 2. |
Queue3lostPkts |
Number of packets discarded in queue 3. |
Queue4lostPkts |
Number of packets discarded in queue 4. |
Queue5lostPkts |
Number of packets discarded in queue 5. |
Queue6lostPkts |
Number of packets discarded in queue 6. |
Queue7lostPkts |
Number of packets discarded in queue 7. |
The number (InPkts) of packets received by the interface and the number (OutPkts) of packets sent by the interface can be displayed separately only on the S5720HI, S5720EI, S6720S-EI, and S6720EI. The S5720SI, S5720S-SI, S5700S-LI, S5700LI, S5720LI, S5720S-LI, S5710-X-LI, S1720GFR, S1720GW, S1720GWR, S1720X, S1720GW-E, S1720GWR-E, S1720X-E, S2720EI, S2750EI, S5730SI, S5730S-EI, S6720SI, S6720S-SI, S6720LI and S6720S-LI display only the total number (InOutPkts) of packets received and sent by the interface.
display counters rate
Function
The display counters rate command displays the incoming or outgoing traffic rate of an interface.
Format
display counters rate [ inbound | outbound ] [ interface interface-type [ interface-number ] ] [ nonzero ]
Parameters
Parameter | Description | Value |
---|---|---|
inbound | Displays the incoming traffic rate of an interface. | - |
outbound | Displays the outgoing traffic rate of an interface. | - |
interface interface-type [ interface-number ] | Displays the traffic rate of a specified interface.
If the interface number is not specified, the traffic rates of all the interfaces of the specified type are displayed. |
- |
nonzero | Displays the traffic rate of an interface. If the numbers of bytes, Octets packets, unicast packets, multicast packets, and broadcast packets on an interface are all 0s, the traffic rate of this interface is not displayed. |
- |
Usage Guidelines
Usage Scenario
You can run the display counters rate command to view the incoming or outgoing traffic rate based on the interface type for fault location.
Precautions
After the system is started, in the case of the first query or when the interval with the last query is longer than 600s, the system re-initiates rate statistics collection. In this case, you need to wait until the rate statistics collection result is displayed.
The minimum statistics collection interval is 5 seconds. If the interval is less than 5 seconds, the data collected last time is displayed.
- The displayed information is repeatedly refreshed, causing desired information unable to be obtained.
- The system does not respond because of long-time information traversing and searching.
Example
# Display the traffic rate of GE0/0/1.
<HUAWEI> display counters rate interface gigabitethernet 0/0/1 Inbound Interface Octets(bytes/s) Unicast(pkts/s) Multicast(pkts/s) Broadcast(pkts/s) GE0/0/1 18 0 0 0 Outbound Interface Octets(bytes/s) Unicast(pkts/s) Multicast(pkts/s) Broadcast(pkts/s) GE0/0/1 61 0 0 0
<HUAWEI> display counters rate nonzero Info: This operation may take a few seconds. Please wait for a moment... Inbound Interface Octets(bytes/s) Unicast(pkts/s) Multicast(pkts/s) Broadcast(pkts/s) GE0/0/1 82 1 0 0 Outbound Interface Octets(bytes/s) Unicast(pkts/s) Multicast(pkts/s) Broadcast(pkts/s) GE0/0/1 224 2 0 0
Item |
Description |
---|---|
Inbound |
Incoming traffic rate. |
Outbound |
Outgoing traffic rate. |
Interface |
Interface name. |
Octets(bytes/s) |
Total incoming or outgoing traffic rate, in bytes/s. |
Unicast(pkts/s) |
Incoming or outgoing rate of unicast packets, in pkts/s. |
Multicast(pkts/s) |
Incoming or outgoing rate of multicast packets, in pkts/s. |
Broadcast(pkts/s) |
Incoming or outgoing rate of broadcast packets, in pkts/s. |
display counters top interface
Function
The display counters top interface command displays top N interface traffic statistics reports.
Parameters
Parameter | Description | Value |
---|---|---|
report [ report-number ] | Specifies the number of a top N interface traffic statistics report. If you do not specify this parameter, the command output displays the summary information about all top N interface traffic statistics reports. | The value is an integer ranging from 1 to 5. |
Usage Guidelines
Usage Scenario
The collect counters top command generates top N interface traffic statistics reports, but does not display these reports. To view the generated reports, run the display counters top interface report [ report-number ] command.
Precautions
Before you run the display counters top interface report [ report-number ] command, ensure that a top N interface traffic statistics report has been generated using the collect counters top command. Otherwise, the "There is no TOPN interface counters report." message is displayed after you run the display counters top interface report [ report-number ] command.
Example
<HUAWEI> display counters top interface report
Id Start Time Interval Number Sort-By Status Interface-Type
-------------------------------------------------------------------------------
1 2012-09-05 09:03:13-08:00 30 20 bytes doing GigabitEthernet
Item |
Description |
---|---|
Id |
Indicates the number of a top N interface traffic statistics report. |
Start Time |
Indicates the start time of statistics collection. |
Interval |
Indicates the statistics collection interval. |
Number |
Indicates the number of busiest interfaces for which interface statistics reports are to be generated. |
Sort By |
Indicates the statistics type by which ports are determined
to be the busiest, which can be:
|
Status |
Indicates the generation status of a top N interface traffic
statistics report, which can be:
|
Interface-Type |
Indicates the type of interfaces for which the top N interface
traffic statistics report is generated, which can be:
|
<HUAWEI> display counters top interface report 1 Owner : RT1(10.1.1.1) Start Time : 2012-09-17 13:26:06 End Time : 2012-09-17 13:26:36 Interface Type : GigabitEthernet Sort By : bytes Interval : 30 seconds Port Band Util Bytes Packets Multicast Broadcast Error Discards width (In + Out) (In + Out) (In + Out) (In + Out) ------------------------------------------------------------------------------ GE0/0/1 1000 0.21% 537592 6892 0 54 0 0
Item |
Description |
---|---|
Owner |
Indicates the device on which the top N interface traffic statistics report is generated. |
Start Time |
Indicates the start time of statistics collection. |
End Time |
Indicates the end time of statistics collection. |
Interface Type |
Indicates the type of interfaces for which the top N interface
traffic statistics report is generated, which can be:
|
Sort-By |
Indicates the statistics type by which ports are determined
to be the busiest, which can be:
|
Interval | Indicates the statistics collection interval. |
Port |
Indicates the interface name. |
Band width |
Indicates interface bandwidth. |
Util |
Indicates bandwidth utilization. |
Bytes |
Indicates the total number of sent and received bytes. |
Packets |
Indicates the total number of sent and received packets. |
Multicast |
Indicates the total number of sent and received multicast packets. |
Broadcast |
Indicates the total number of sent and received broadcast packets. |
Error |
Indicates the total number of error packets. |
Discards |
Indicates the total number of dropped packets. |
display interface
Format
display interface [ interface-type [ interface-number [.subinterface-number ] | main ] | main ]
display interface slot slot-id [ main ]
Parameters
Parameter |
Description |
Value |
---|---|---|
interface-type [ interface-number ] | Displays the running status of an interface.
If the interface type is specified but no interface number is specified, the running status of all the interfaces of this type is displayed. |
- |
subinterface-number | Displays the running status of a sub-interface. |
The value is an integer that ranges from 1 to 4096. |
main | Displays running status and traffic statistics about an interface.
|
- |
slot slot-id | Specifies the slot ID. |
- |
Usage Guidelines
Usage Scenario
The running status and statistics of an interface includes the physical status, basic configuration, and packet forwarding of the interface. You can use the display interface command to collect traffic statistics or locate faults on an interface.
Precautions
If no interface type is specified, the running status and statistics of all the interfaces is displayed. If the interface type is specified but no interface number is specified, the running status of all the interfaces of this type is displayed.
Only the S6720EI, S6720S-EI, S5720HI and S5720EI support sub-interfaces.
Example
# Display the running status, basic configuration, and packet forwarding statistics on GE0/0/1.
<HUAWEI> display interface gigabitethernet 0/0/1 GigabitEthernet 0/0/1 current state : UP Line protocol current state : UP Description: Switch Port,Link-type : access(negotiated), PVID : 1, TPID : 8100(Hex), The Maximum Frame Length is 9216 IP Sending Frames' Format is PKTFMT_ETHNT_2, Hardware address is 0025-9ef4-abcd Last physical up time : - Last physical down time : 2015-12-21 16:12:29 UTC+08:00 Current system time: 2012-06-05 18:56:41 Port Mode: COMMON FIBER, Transceiver: 1000_BASE_SX_SFP Speed : 1000, Loopback: NONE Duplex: FULL, Negotiation: ENABLE Mdi : -, Flow-control: DISABLE Last 300 seconds input rate 0 bits/sec, 0 packets/sec Last 300 seconds output rate 0 bits/sec, 0 packets/sec Input peak rate 0 bits/sec, Record time: - Output peak rate 0 bits/sec, Record time: - Input: 0 packets, 0 bytes Unicast: 0, Multicast: 0 Broadcast: 0, Jumbo: 0 Discard: 0, Pause: 0 Frames: 0 Total Error: 0 CRC: 0, Giants: 0 Jabbers: 0, Fragments: 0 Runts: 0, DropEvents: 0 Alignments: 0, Symbols: 0 Ignoreds: 0 Output: 0 packets, 0 bytes Unicast: 0, Multicast: 0 Broadcast: 0, Jumbo: 0 Discard: 0, Pause: 0 Total Error: 0 Collisions: 0, ExcessiveCollisions: 0 Late Collisions: 0, Deferreds: 0 Buffers Purged: 0 Input bandwidth utilization threshold : 80.00% Output bandwidth utilization threshold: 80.00% Input bandwidth utilization : 0% Output bandwidth utilization : 0%
# Display the running status, basic configuration, and packet forwarding on GE0/0/1 of the S5720HI.
<HUAWEI> display interface gigabitethernet 0/0/1 GigabitEthernet 0/0/1 current state : UP Line protocol current state : UP Description: Switch Port, Link-type : access(negotiated), PVID : 1, TPID : 8100(Hex), The Maximum Frame Length is 9216 IP Sending Frames' Format is PKTFMT_ETHNT_2, Hardware address is 000b-09a9-c9d7 Last physical up time : - Last physical down time : 2015-12-21 16:12:29 UTC+08:00 Current system time: 2009-03-31 11:51:03 Port Mode: COMMON COPPER Speed : 1000, Loopback: NONE Duplex: FULL, Negotiation: ENABLE Mdi : AUTO, Flow-control: DISABLE Last 300 seconds input rate 176 bits/sec, 0 packets/sec Last 300 seconds output rate 440 bits/sec, 0 packets/sec Input peak rate 7032 bits/sec, Record time: 2009-03-30 19:12:09 Output peak rate 38624 bits/sec, Record time: 2009-03-30 20:41:44 Input: 7650 packets, 1327062 bytes Unicast: 0, Multicast: 7650 Broadcast: 0, Jumbo: 0 Discard: 0, Pause: 0 Total Error: 0 CRC: 0, Giants: 0 Runts: 0, Fragments: 0 Alignments: 0, Symbols: 0 Output: 38348 packets, 3683776 bytes Unicast: 0, Multicast: 32314 Broadcast: 6034, Discard: 0 Pause: 0 Input bandwidth utilization threshold : 80.00% Output bandwidth utilization threshold: 80.00% Input bandwidth utilization : 0% Output bandwidth utilization : 0%
Item |
Description |
---|---|
current state |
Current status of the interface:
NOTE:
There is a delay before the interface state is reported, so an interface undergoes a short-time intermediate state before it transitions to the ERROR DOWN state. The intermediate state is ERROR DOWN (ERROR DOWN reason), up. This state does not affect functioning of the interface. When the physical status of the interface is ERROR DOWN(data-integrity-error), perform the following operations:
|
Line protocol current state |
Link layer protocol status of the interface:
|
Description |
Interface description. To configure the description for an interface, run the description command. |
Switch Port |
A Layer 2 interface. To switch an interface to the Layer 3 mode, run the undo portswitch command. If the interface is a Layer 3 interface, Route Port is displayed here. |
PVID |
Default VLAN ID of the interface. |
Link-type |
Link type of an interface, which is displayed only when the interface works in Layer 2 mode:
|
The Maximum Frame Length |
Maximum frame length allowed by the interface. To set the maximum frame length, run the jumboframe enable command. |
TPID |
Type of frames that are supported on the interface. By default, this field displays 0x8100, indicating an 802.1Q frame. This field is displayed only for a Layer 2 interface. |
IP Sending Frames' Format |
Format of frames sent by the IP protocol, including PKTFMT_ETHNT_2, Ethernet_802.3, and Ethernet_SNAP. |
Hardware address |
MAC address of the interface. |
Port Mode |
Working mode of the interface:
If the interface is a combo interface:
To configure the working mode for an interface, run the combo-port command. |
Transceiver |
Type of the optical module.
|
Last physical up time |
Last time the interface went Up physically. If this field displays "-", the physical status of the interface does not change. If the system is configured with a time zone and is in the daylight saving time, the time is displayed in the format of YYYY-MM-DD HH:MM:SS UTC±HH:MM DST. |
Last physical down time |
Last time the interface went Down physically. If this field displays "-", the physical status of the interface does not change. If the system is configured with a time zone and is in the summer daylight saving time, the time is displayed in the format of YYYY-MM-DD HH:MM:SS UTC±HH:MM DST. |
Current system time |
Current system time. If the time zone is configured and the daylight saving time is used, the time is in YYYY-MM-DD HH:MM:SS±HH:MM format. |
Speed |
Current rate of the interface.
|
Loopback |
Loopback configuration of the interface. To configure loopback on an interface, run the loopback command. |
Duplex |
Duplex mode of the interface:
|
Negotiation |
Auto-negotiation mode of the interface:
To configure the auto-negotiation mode for an interface, run the negotiation auto command. |
Mdi |
Network cable type of the interface. To configure the network cable type of an interface, run the mdi command. The Mdi field displays - for an optical interface. |
Flow-control |
Whether flow control is enabled:
NOTE:
If the flow-control command has been executed to enable flow control on an Ethernet
interface, this field displays DISABLE in the following situations:
|
Last 300 seconds input rate |
Incoming packet rate (bits per second and packets per second) within the last 300 seconds. |
Last 300 seconds output rate |
Outgoing packet rate (bits per second and packets per second) within the last 300 seconds. |
Input peak rate 0 bits/sec,Record time |
Maximum rate of incoming packets and time when the maximum rate is reached. |
Output peak rate 0 bits/sec,Record time |
Maximum rate of outgoing packets and time when the maximum rate is reached. |
Input |
Total number of received packets. |
Output |
Total number of sent packets. |
Unicast |
Number of unicast packets that are received or sent by the interface. |
Multicast |
Number of multicast packets that are received or sent by the interface. For the S5720HI, the value of this field contains the number of pause frames. |
Broadcast |
Number of broadcast packets that are received or sent by the interface. |
Jumbo |
Number of received packets with length ranging from 1518 bytes to the maximum jumbo frame length and correct FCS values. Number of sent packets with lengths of over 1518 bytes and correct FCS. For the S5720HI, the value of this field contains the number of received packets with length ranging from 1518 bytes to the jumbo frame length configured on the interface and correct CRC values. To set the maximum jumbo frame length, run the jumboframe enable command. NOTE:
Only S6720EI, S6720S-EI, S5720HI and S5720EI support statistics on Jumbo frames. |
Discard |
Number of packets discarded by the interface during physical layer detection. On the S1720GFR, S1720GW, S1720GWR, S1720X, S1720GW-E, S1720GWR-E, S1720X-E, S2720EI, S2750EI, S5700LI, S5720LI, S5720S-LI, S5700S-LI, S5720SI, S5720S-SI, S5710-X-LI, S5730SI, S5730S-EI, S6720SI, S6720S-SI, S6720LI, and S6720S-LI, after you run the reset qos queue statistics command, the number of packets discarded by the interface is cleared. |
Total Error |
Number of error frames found during physical layer detection. |
CRC |
Number of packets shorter than 1519 bytes and with incorrect FCS values. For the S5720LI, S5720SI, S5720S-SI, S5710-X-LI, S5720HI, S5730SI, S5730S-EI, S6720SI, and S6720S-SI, the value of this field includes the number of received packets longer than the maximum jumbo frame length and with incorrect FCS values. For switches excluding the S5720EI, the value of this field contains the number of received packets with length ranging from 1518 bytes to the jumbo frame size configured on the interface and incorrect FCS values. |
Giants |
Number of received frames with length exceeding the maximum jumbo frame length. |
Jabbers |
Number of received packets with length ranging from 1518 bytes to the maximum jumbo frame length and incorrect FCS values on the S5720EI. The S2720EI, S5720LI, 720S-SI, S5710-X-LI, S5730SI, S5730S-EI, S6720SI, S6720S-SI, S6720S-EI, and S6720EI do not have the Jabbers field. On the other product models, this field indicates the number of received packets with length exceeding the maximum jumbo frame length and incorrect FCS values. |
Fragments |
Number of received fragmented packets. A fragmented packet is a packet shorter than 64 bytes and with incorrect CRC values. For the S5720HI, the value of this field contains the number of undersized frames with the correct CRC values received is displayed. On the S2720EI, S5720LI, S5720SI, S5720S-SI, S5710-X-LI, S5730SI, S5730S-EI, S6720SI, S6720S-SI, S6720S-EI, and S6720EI, the command output does not contain the Fragments field to display statistics about received fragmented packets. |
Runts |
Number of received undersized frames with correct CRC values. For the S5720LI, S5720SI, S5720S-SI, S5710-X-LI, S5730SI, S5730S-EI, S6720SI, S6720S-SI, S6720S-EI, and S6720EI, the value of this field includes the number of received fragmented packets shorter than 64 bytes and with incorrect CRC values. |
DropEvents |
Number of received packets that are discarded due to GBP full or back pressure. |
Alignments |
Number of received frames with alignment errors. |
Symbols |
Number of received frames with coding errors. |
Ignoreds |
Number of received MAC control frames whose OpCode is not PAUSE. |
Frames |
Number of packets with incorrect 802.3 length. |
Collisions |
Number of packets with 1 to 15 collisions during packet forwarding. For the S5720SI, S5720S-SI, S5710-X-LI, S5730SI, S5730S-EI, S6720SI, and S6720S-SI, the value of this field contains the number of frames that are not sent due to 16 consecutive collisions. |
ExcessiveCollisions |
Number of packets with 16 collisions and fail to be sent. On the S2720EI, S5720SI, S5720S-SI, S5710-X-LI, S5730SI, S5730S-EI, S6720SI, and S6720S-SI, the command output does not contain the ExcessiveCollisions field to display statistics about frames that are not sent due to 16 consecutive collisions. |
Late Collisions |
Number of packets with conflict and delayed. |
Deferreds |
Number of delayed packets without conflict. |
Buffers Purged |
Number of packets aged in the cache. The S5720SI, S5720S-SI, S5710X-LI, S6720S-EI, and S6720EI do not have the Buffers Purged field. On other models, the value of this field is always 0. |
Input bandwidth utilization threshold |
Threshold for inbound bandwidth usage. |
Output bandwidth utilization threshold |
Threshold for outbound bandwidth usage. |
Input bandwidth utilization |
Inbound bandwidth usage. For the S1720GFR, S1720GW, S1720GWR, S1720X, S1720GW-E, S1720GWR-E, S1720X-E, S2720EI, S2750EI, S5720SI, S5720S-SI, S5710-X-LI, S5700LI, S5720LI, S5720S-LI, S5700S-LI, S5730SI, S5730S-EI, S6720SI, S6720S-SI, S6720LI, and S6720S-LI, the bandwidth usage of Giants packets is calculated based on the configured jumbo frame length. To set the maximum jumbo frame length, run the jumboframe enable command. |
Output bandwidth utilization |
Outbound bandwidth usage. For the S1720GFR, S1720GW, S1720GWR, S1720X, S1720GW-E, S1720GWR-E, S1720X-E, S2720EI, S2750EI, S5720SI, S5720S-SI, S5710-X-LI, S5700LI, S5720LI, S5720S-LI, S5700S-LI, S5730SI, S5730S-EI, S6720SI, S6720S-SI, S6720LI, and S6720S-LI, the bandwidth usage of Giants packets is calculated based on the configured jumbo frame length. To set the maximum jumbo frame length, run the jumboframe enable command. |
display interface brief
Function
The display interface brief command displays brief information about the status and configuration of interfaces.
Usage Guidelines
Usage Scenario
The display interface brief command displays brief information about interfaces, including the physical status, link layer protocol status, inbound and outbound bandwidth usage within a certain period, and numbers of sent and received error packets. This information helps locate faults on interfaces.
Precautions
To clear statistics on an interface, run the reset counters interface command.
Example
# Display brief information about the status and configuration of interfaces.
<HUAWEI> display interface brief PHY: Physical *down: administratively down #down: LBDT down (l): loopback (s): spoofing (E): E-Trunk down (b): BFD down (e): ETHOAM down (dl): DLDP down (lb): LBDT block (ms): MACsec down InUti/OutUti: input utility/output utility Interface PHY Protocol InUti OutUti inErrors outErrors GigabitEthernet0/0/1 up up 0.06% 100% 0 21217388 GigabitEthernet0/0/2 up up 100% 100% 0 0 GigabitEthernet0/0/3 up up 0% 100% 0 0 GigabitEthernet0/0/4 up up 100% 100% 0 0 GigabitEthernet0/0/5 up up 99% 100% 0 0 GigabitEthernet0/0/6 down down 0% 0% 10 0 GigabitEthernet0/0/7 down down 0% 0% 12 0 GigabitEthernet0/0/8 down down 0% 0% 0 0 GigabitEthernet0/0/9 down down 0% 0% 0 0 GigabitEthernet0/0/10 down down 0% 0% 0 0 GigabitEthernet0/0/11 down down 0% 0% 0 0 GigabitEthernet0/0/12 down down 0% 0% 0 0 GigabitEthernet0/0/13 down down 0% 0% 0 0 GigabitEthernet0/0/14 down down 0% 0% 0 0 GigabitEthernet0/0/15 down down 0% 0% 0 0 GigabitEthernet0/0/16 down down 0% 0% 0 0 GigabitEthernet0/0/17 down down 0% 0% 0 0 GigabitEthernet0/0/18 down down 0% 0% 0 0 GigabitEthernet0/0/19 down down 0% 0% 0 0 GigabitEthernet0/0/20 down down 0% 0% 0 0 GigabitEthernet0/0/21 down down 0% 0% 0 0 GigabitEthernet0/0/22 down down 0% 0% 0 0 GigabitEthernet0/0/23 down down 0% 0% 0 0 GigabitEthernet0/0/24 down down 0% 0% 0 0 MEth0/0/1 down down 0% 0% 0 0 NULL0 up up(s) 0% 0% 0 0
Item |
Description |
---|---|
Interface |
Type and number of an interface. |
PHY |
Physical status of an interface:
|
Protocol |
Link layer protocol status of the interface:
NOTE:
(ms): MACsec down is displayed only after the MACsec plug-in is installed. Only the S5720SI, S5720S-SI, S6720SI, S5720EI, and S5720HI support MACsec. |
InUti |
Average inbound bandwidth usage of an interface within the last 300 seconds. Average inbound bandwidth usage within the last 300 seconds = Average inbound traffic rate within the last 300 seconds/Interface bandwidth When the average bandwidth usage is smaller than 0.005% and greater than 0, the value 0 is displayed. When the average bandwidth usage is smaller than 0.01% and greater than 0.005%, the value 0.01% is displayed. When the interface bandwidth becomes lower, for example, the speed command is executed to reduce the bandwidth of an Ethernet interface, the bandwidth usage be displayed as 100% because the traffic volume is not adjusted in time. "--" indicates that an interface does not support the display of bandwidth usage. |
OutUti |
Average outbound bandwidth usage within the last 300 seconds. Average outbound bandwidth usage within the last 300 seconds = Average outbound traffic rate within the last 300 seconds/Interface bandwidth When the average bandwidth usage is smaller than 0.005% and greater than 0, the value 0 is displayed. When the average bandwidth usage is smaller than 0.01% and greater than 0.005%, the value 0.01% is displayed. When the interface bandwidth becomes lower, for example, the speed command is executed to reduce the bandwidth of an Ethernet interface, the bandwidth usage may be displayed as 100% because the traffic volume is not adjusted in time. "--" indicates that an interface does not support the display of bandwidth usage. |
inErrors |
The number of error packets received by an interface. The value ranges from 0 to 4294967295. The count restarts after the value exceeds the upper limit. The value becomes 0 when you run the reset counters interface command in the user view or when the number of received packets reaches the maximum value 0xFFFFFFFF. |
outErrors |
The number of error packets sent by an interface. The value ranges from 0 to 4294967295. The count restarts after the value exceeds the upper limit. The value becomes 0 when you run the reset counters interface command in the user view or when the number of sent packets reaches the maximum value 0xFFFFFFFF. |
display interface description
Format
display interface description [ interface-type [ interface-number ] ]
display interface description [ interface-type ] main
Parameters
Parameter |
Description |
Value |
---|---|---|
interface-type [ interface-number ] | Displays the description of a specified interface. If an interface type is specified but no interface number is specified, the description of all interfaces of the specified type is displayed. |
- |
main | Displays the description of the main interface.
|
- |
Usage Guidelines
Usage Scenario
The display interface command can also display the description of an interface. To quickly view the description of an interface, you are advised to use the display interface description command.
Precautions
If no interface type is specified, the description of all interfaces is displayed. If an interface type is specified but no interface number is specified, the description of all interfaces of the specified type is displayed.
If there is a great deal of statistics about traffic on Eth-Trunk interfaces, you are recommended to specify trunk-id to filter output information. Otherwise, a problem may occur due to excessive output information: The displayed information is repeatedly refreshed, and therefore required information cannot be located.
Only the S6720EI, S6720S-EI, S5720HI and S5720EI support sub-interfaces.
Example
# Display the description of GE0/0/1.
<HUAWEI> display interface description gigabitethernet 0/0/1 PHY: Physical *down: administratively down #down: LBDT down (l): loopback (s): spoofing (E): E-Trunk down (b): BFD down (e): ETHOAM down (dl): DLDP down (lb): LBDT block (ms): MACsec down Interface PHY Protocol Description GE0/0/1 down down
Item |
Description |
---|---|
Interface |
Type and number of an interface. If the bandwidth of an interface exceeds 1 GB, the bandwidth value is displayed following the interface name. |
PHY |
Physical status of an interface:
|
Protocol |
Link layer protocol status of the interface:
NOTE:
(ms): MACsec down is displayed only after the MACsec plug-in is installed. Only the S5720SI, S5720S-SI, S6720SI, S5720EI, and S5720HI support MACsec. |
Description |
Interface description. |
display ip interface
Function
The display ip interface command displays the IP configuration and statistics on interfaces. The statistics include the number of packets and bytes received and sent by interfaces, number of multicast packets sent and received by interfaces, and number of broadcast packets received, sent, forwarded, and discarded by interfaces.
The display ip interface brief command displays brief information about interface IP addresses, including the IP address, subnet mask, physical status, link-layer protocol status, and number of interfaces in different states.
Format
display ip interface [ interface-type interface-number ]
display ip interface brief [ interface-type [ interface-number ] | slot slot-id [ card card-number ] ]
display ip interface brief [ interface-type ] &<1-8>
Parameters
Parameter | Description | Value |
---|---|---|
interface-type interface-number | Specifies the type and number of an interface. If no interface is specified, IP configuration and statistics about all interfaces are displayed. |
- |
brief | Displays brief information, including the IP address, subnet mask, physical status, link-layer protocol status, and number of interfaces in different states. | - |
slot slot-id | Displays the IP configuration and statistics of interfaces on the specified slot. If the slot number is not specified, brief information related to the IP addresses of the interfaces on all interface boards and main control boards is displayed. |
- |
card card-number | Displays the IP configuration and statistics of interfaces on specified card. |
- |
Usage Guidelines
- IP configurations of all interfaces
- IP configurations of interfaces of the specified type and a specified interface
- IP configurations of interfaces that have IP addresses
You can run the display interface description command to view the interface description.
You can run the display interface command to view detailed information about the running status and statistics on the interface.
Only the S6720EI, S6720S-EI, S5720HI and S5720EI support sub-interfaces.
Example
<HUAWEI> display ip interface vlanif 15 Vlanif15 current state : UP Line protocol current state : UP The Maximum Transmit Unit : 1500 bytes input packets : 766390, bytes : 41540847, multicasts : 681817 output packets : 242239, bytes : 14679482, multicasts : 172333 Directed-broadcast packets: received packets: 0, sent packets: 0 forwarded packets: 0, dropped packets: 0 Internet Address is 10.1.1.119/24 Broadcast address : 10.1.1.255 TTL being 1 packet number: 164035 TTL invalid packet number: 0 ICMP packet input number: 0 Echo reply: 0 Unreachable: 0 Source quench: 0 Routing redirect: 0 Echo request: 0 Router advert: 0 Router solicit: 0 Time exceed: 0 IP header bad: 0 Timestamp request: 0 Timestamp reply: 0 Information request: 0 Information reply: 0 Netmask request: 0 Netmask reply: 0 Unknown type: 0
Item |
Description |
---|---|
Vlanif15 current state |
Physical status of the interface:
|
Line protocol current state |
Link layer protocol status of the interface:
|
The Maximum Transmit Unit |
MTU of the interface. The default MTU of an Ethernet interface or a serial interface is 1500 bytes. Packets longer than the MTU are fragmented before being transmitted. If fragmentation is not allowed, the packets are discarded. |
input packets : 766390, bytes : 41540847, multicasts : 681817 |
Total number of packets, bytes, and multicast packets received by the interface. |
output packets : 242239, bytes : 14679482, multicasts : 172333 |
Total number of packets, bytes, and multicast packets sent by the interface. |
Directed-broadcast packets |
Number of packets broadcast on the interface directly. |
received packets |
Total number of received packets. |
sent packets |
Total number of sent packets. |
forwarded packets |
Total number of forwarded packets. |
dropped packets |
Total number of discarded packets. |
Internet Address is |
IP address assigned to the interface and mask length. |
Broadcast address |
Broadcast address of the interface. |
TTL being 1 packet number |
Number of packets with TTL 1. |
TTL invalid packet number |
Number of packets with invalid TTL. |
ICMP packet input number |
Number of received ICMP packets. |
Echo reply |
Number of Echo Reply packets. |
Unreachable |
Number of Destination Unreachable packets. |
Source quench |
Number of Source Quench packets. |
Routing redirect |
Number of Redirect packets. |
Echo request |
Number of Echo Request packets. |
Router advert |
Number of Router Advertisement packets. |
Router solicit |
Number of Router Solicitation packets. |
Time exceed |
Number of Time Exceeded packets. |
IP header bad |
Number of IP header error packets. |
Timestamp request |
Number of Timestamp Request packets. |
Timestamp reply |
Number of Timestamp Reply packets. |
Information request |
Number of Information Request packets. |
Information reply |
Number of Information Reply packets. |
Netmask request |
Number of Address Mask Request packets. |
Netmask reply |
Number of Address Mask Reply packets. |
Unknown type |
Number of unknown packets. |
<HUAWEI> display ip interface brief vlanif 15 *down: administratively down ^down: standby (l): loopback (s): spoofing (E): E-Trunk down Interface IP Address/Mask Physical Protocol Vlanif15 10.1.1.119/24 up up
Item |
Description |
---|---|
*down: |
Reason why an interface is physically Down. Administratively down indicates that the administrator has run the shutdown command on the interface. |
^down |
^down: indicates that the interface is a backup interface. |
(l): loopback |
The letter "l" refers to loopback. |
(s): spoofing |
The letter "s" refers to spoofing. |
(E): E-Trunk down | Indicates that the Eth-Trunk is Down because of the protocol negotiation on the E-Trunk. |
Interface |
Interface type and number. |
IP Address/Mask |
IP address and mask of an interface. |
Physical |
Physical status of an interface:
|
Protocol |
Link protocol status of the interface:
(l) indicates that the loopback function is configured on the interface. |
display ip interface description
Function
Format
display ip interface description [ interface-type [ interface-number ] | interface-type &<1-8> | slot slot-number [ card card-number ] ]
Parameters
Parameter | Description | Value |
---|---|---|
interface-type | Indicates the interface type. If no interface type is specified, IP-related configurations and statistics of all interfaces are displayed. | - |
interface-number | Indicates the interface number, which is used together with interface-type to identify an interface. If no interface number is specified, IP-related configurations and statistics of interfaces in the same type are displayed. | - |
interface-type | Indicates that the command can display IP-related information about interfaces of multiple types. The command can display IP-related information about interfaces in a maximum of eight types. | - |
slot slot-number | Specifies the interface board number. | - |
card card-number | Indicates the card number. If no card number is specified, IP-related information about all interfaces on all cards in a specified slot is displayed. | - |
Usage Guidelines
Usage Scenario
Instead of running the display ip interface brief and display interface description commands, you can run the display ip interface description command to view both IP-related information and description of an interface, which facilitates the user operation.
The display ip interface description command cannot display information about Layer 2 interfaces. When it runs on an Eth-Trunk interface, it displays the status and description of Eth-Trunk member interfaces.
Example
# View IP-related information and description of a specified interface.
<HUAWEI> display ip interface description Codes: Ana(Analogmodem), Asy(Async), Cell(Cellular), Dia(Dialer), Eth(Ethernet) GE(GigabitEthernet), H(Hssi), Ima(Ima-group), Loop(LoopBack), MTun(MTunnel), S(Serial), Tun(Tunnel), VE(Virtual-Ethernet), VT(Virtual-Template) d(dampened), D(down), *D(administratively down) ^D(standby), l(loopback), s(spoofing), U(up) E(E-Trunk down) ------------------------------------------------------------------------------ Number of interfaces whose physical status is Up: 9 Number of interfaces whose physical status is Down: 1 Number of interfaces whose protocol status is Up: 9 Number of interfaces whose protocol status is Down: 1 Interface IP Address/Mask Phy Prot Description Loop0 10.3.0.2/32 U U(s) Loop1 unassigned U U(s) MEth0/0/1 192.168.150.143/24 U U NULL0 unassigned U U(s) Tun1 unassigned U D Vlanif10 unassigned D D Vlanif20 10.1.2.2/24 D D Vlanif30 10.1.1.1/24 D D Vlanif100 unassigned *D D
Item |
Description |
---|---|
Codes: |
The following information provides the full spelling and explanation of the abbreviated interface names, physical status, and link layer protocols. Full spelling of the abbreviated interface
names is as follows:
Explanation of the abbreviated physical status of the
interface is as follows:
Explanation of the abbreviated link layer protocol status
is as follows:
|
Number of interfaces whose physical status is Up: |
Indicates the number of interfaces whose physical status is Up. |
Number of interfaces whose physical status is Down: |
Indicates the number of interfaces whose physical status is Down. |
Number of interfaces whose protocol status is Up: |
Indicates the number of interfaces whose link layer protocol is Up. |
Number of interfaces whose protocol status is Down: |
Indicates the number of interfaces whose link layer protocol is Down. |
Interface |
Indicates the name and number of an interface. |
IP Address/Mask |
Indicates the IP address and subnet mask of an interface. |
Phy |
Indicates the physical status of an interface. |
Prot |
Indicates the link layer protocol status of an interface. |
Description |
Indicates the description of an interface, expressed in characters. A maximum of 20 characters can be displayed. When the length of the description is greater than 20 characters, only the first 16 characters are displayed and the last 3 characters are replaced by ellipsis (...). If the description of an interface is the default setting, no information is displayed. |
display this interface
Function
The display this interface command displays interface information in the current interface view.
Usage Guidelines
In the interface view, you can run the display this interface command to rapidly view the status of the interface and packet statistics on the interface.
Example
# Display information about GE0/0/1.
<HUAWEI> system-view [HUAWEI] interface gigabitethernet 0/0/1 [HUAWEI-GigabitEthernet0/0/1] display this interface GigabitEthernet0/0/1 current state : UP Line protocol current state : UP Description: Switch Port,Link-type : access(negotiated), PVID : 1, TPID : 8100(Hex), The Maximum Frame Length is 9216 IP Sending Frames' Format is PKTFMT_ETHNT_2, Hardware address is 0025-9ef4-abcd Last physical up time : - Last physical down time : 2000-04-01 23:55:43 Current system time: 2012-08-24 00:41:35+08:00 Port Mode: COMMON FIBER, Transceiver: 1000_BASE_SX_SFP Speed : 1000, Loopback: NONE Duplex: FULL, Negotiation: ENABLE Mdi : -, Flow-control: DISABLE Last 300 seconds input rate 0 bits/sec, 0 packets/sec Last 300 seconds output rate 0 bits/sec, 0 packets/sec Input peak rate 0 bits/sec, Record time: 2007-12-26 07:23:14 Output peak rate 0 bits/sec, Record time: 2007-12-26 07:23:14 Input: 0 packets, 0 bytes Unicast: 0, Multicast: 0 Broadcast: 0, Jumbo: 0 Discard: 0, Pause: 0 Frames: 0 Total Error: 0 CRC: 0, Giants: 0 Jabbers: 0, Fragments: 0 Runts: 0, DropEvents: 0 Alignments: 0, Symbols: 0 Ignoreds: 0 Output: 0 packets, 0 bytes Unicast: 0, Multicast: 0 Broadcast: 0, Jumbo: 0 Discard: 0, Pause: 0 Total Error: 0 Collisions: 0, ExcessiveCollisions: 0 Late Collisions: 0, Deferreds: 0 Buffers Purged: 0 Input bandwidth utilization threshold : 80.00% Output bandwidth utilization threshold: 80.00% Input bandwidth utilization : 0% Output bandwidth utilization : 0%
Item |
Description |
---|---|
current state |
Current status of the interface:
NOTE:
There is a delay before the interface state is reported, so an interface undergoes a short-time intermediate state before it transitions to the ERROR DOWN state. The intermediate state is ERROR DOWN (ERROR DOWN reason), up. This state does not affect functioning of the interface. When the physical status of the interface is ERROR DOWN(data-integrity-error), perform the following operations:
|
Line protocol current state |
Link layer protocol status of the interface:
NOTE:
DOWN (MACsec down) is displayed only after the MACsec plug-in is installed. Only the S5720SI, S5720S-SI, S6720SI, S5720EI, and S5720HI support MACsec. |
Description |
Interface description. To configure the description for an interface, run the description command. |
Switch Port |
A Layer 2 interface. To switch an interface to the Layer 3 mode, run the undo portswitch command. If the interface is a Layer 3 interface, Route Port is displayed here. |
PVID |
Default VLAN ID of the interface. |
Link-type |
Link type of an interface, which
is displayed only when the interface works in Layer 2 mode:
|
The Maximum Frame Length |
Maximum frame length allowed by the interface. To set the maximum frame length, run the jumboframe enable command. |
TPID |
Type of frames that are supported on the interface. By default, this field displays 0x8100, indicating an 802.1Q frame. This field is displayed only for a Layer 2 interface. |
IP Sending Frames' Format |
Format of frames sent by the IP protocol, including PKTFMT_ETHNT_2, Ethernet_802.3, and Ethernet_SNAP. |
Hardware address |
MAC address of the interface. |
Port Mode |
Working mode of the interface:
If the interface is a combo interface:
To configure the working mode for an interface, run the combo-port command. |
Transceiver |
Type of the optical module.
|
Last physical up time |
Last time the interface went Up physically. If this field displays "-", the physical status of the interface does not change. If the system is configured with a time zone and is in the daylight saving time, the time is displayed in the format of YYYY-MM-DD HH:MM:SS UTC±HH:MM DST. |
Last physical down time |
Last time the interface went Down physically. If this field displays "-", the physical status of the interface does not change. If the system is configured with a time zone and is in the summer daylight saving time, the time is displayed in the format of YYYY-MM-DD HH:MM:SS UTC±HH:MM DST. |
Current system time |
Current system time. If the time zone is configured and the daylight saving time is used, the time is in YYYY-MM-DD HH:MM:SS±HH:MM format. |
Speed |
Current rate of the interface.
|
Loopback |
Loopback configuration of the interface. To configure loopback on an interface, run the loopback command. |
Duplex |
Duplex mode of the interface:
|
Negotiation |
Auto-negotiation mode of the interface:
To configure the auto-negotiation mode for an interface, run the negotiation auto command. |
Mdi |
Network cable type of the interface. To configure the network cable type of an interface, run the mdi command. The Mdi field displays - for an optical interface. |
Flow-control |
Whether flow control is enabled:
NOTE:
If the flow-control command has been executed to enable flow control on an Ethernet
interface, this field displays DISABLE in the following situations:
|
Last 300 seconds input rate |
Incoming packet rate (bits per second and packets per second) within the last 300 seconds. |
Last 300 seconds output rate |
Outgoing packet rate (bits per second and packets per second) within the last 300 seconds. |
Input peak rate 0 bits/sec,Record time |
Maximum rate of incoming packets and time when the maximum rate is reached. |
Output peak rate 0 bits/sec,Record time |
Maximum rate of outgoing packets and time when the maximum rate is reached. |
Input |
Total number of received packets. |
Output |
Total number of sent packets. |
Unicast |
Number of unicast packets that are received or sent by the interface. |
Multicast |
Number of multicast packets that are received or sent by the interface. For the S5720HI, the value of this field contains the number of pause frames. |
Broadcast |
Number of broadcast packets that are received or sent by the interface. |
Jumbo |
Number of received packets with length ranging from 1518 bytes to the maximum jumbo frame length and correct FCS values. Number of sent packets with lengths of over 1518 bytes and correct FCS. For the S5720HI, the value of this field contains the number of received packets with length ranging from 1518 bytes to the jumbo frame length configured on the interface and correct CRC values. To set the maximum jumbo frame length, run the jumboframe enable command. NOTE:
Only S6720EI, S6720S-EI, S5720HI and S5720EI support statistics on Jumbo frames. |
Discard |
Number of packets discarded by the interface during physical layer detection. On the S1720GFR, S1720GW, S1720GWR, S1720X, S1720GW-E, S1720GWR-E, S1720X-E, S2720EI, S2750, S5700LI, S5720LI, S5720S-LI, S5700S-LI, S5720SI, S5720S-SI, S5710–X-LI, S5730SI, S5730S-EI, S6720SI, S6720S-SI, S6720LI and S6720S-LI, after you run the reset qos queue statistics command, the number of packets discarded by the interface is cleared. |
Total Error |
Number of error frames found during physical layer detection. |
CRC |
Number of packets shorter than 1519 bytes and with incorrect FCS values. For the S5720LI, S5720SI, S5720S-SI, S5710X-LI, S5720HI, S5730SI, S5730S-EI, S6720SI, and S6720S-SI, the value of this field includes the number of received packets longer than the maximum jumbo frame length and with incorrect FCS values. For switches excluding the S5720EI, the value of this field contains the number of received packets with length ranging from 1518 bytes to the jumbo frame size configured on the interface and incorrect FCS values. |
Giants |
Number of received frames with length exceeding the maximum jumbo frame length. |
Jabbers |
Number of received packets with length ranging from 1518 bytes to the maximum jumbo frame length and incorrect FCS values on the S5720EI. The S5720LI, S5720SI, S5720S-SI, S5710X-LI, S5730SI, S5730S-EI, S6720SI, S6720S-SI, S6720S-EI, and S6720EI do not have the Jabbers field. On the other product models, this field indicates the number of received packets with length exceeding the maximum jumbo frame length and incorrect FCS values. |
Fragments |
Number of received fragmented packets. A fragmented packet is a packet shorter than 64 bytes and with incorrect CRC values. For the S5720HI, the value of this field contains the number of undersized frames with the correct CRC values received is displayed. On the S5720LI, S5720SI, S5720S-SI, S5710X-LI, S5730SI, S5730S-EI, S6720SI, S6720S-SI, S6720S-EI, and S6720EI, the command output does not contain the Fragments field to display statistics about received fragmented packets. |
Runts |
Number of received undersized frames with correct CRC values. For the S5720LI, S5720SI, S5720S-SI, S5710X-LI, S5730SI, S5730S-EI, S6720SI, S6720S-SI, S6720S-EI, and S6720EI, the value of this field includes the number of received fragmented packets shorter than 64 bytes and with incorrect CRC values. |
DropEvents |
Number of received packets that are discarded due to GBP full or back pressure. |
Alignments |
Number of received frames with alignment errors. |
Symbols |
Number of received frames with coding errors. |
Ignoreds |
Number of received MAC control frames whose OpCode is not PAUSE. |
Frames |
Number of packets with incorrect 802.3 length. |
Collisions |
Number of packets with 1 to 15 collisions during packet forwarding. For the S5720SI, S5720S-SI, S5710X-LI, S5730SI, S5730S-EI, S6720SI, S6720S-SI, S6720S-EI, and S6720EI, the value of this field contains the number of frames that are not sent due to 16 consecutive collisions. |
ExcessiveCollisions |
Number of packets with 16 collisions and fail to be sent. On the S5720SI, S5720S-SI, S5710X-LI, S5730SI, S5730S-EI, S6720SI, S6720S-SI, S6720S-EI, and S6720EI, the command output does not contain the ExcessiveCollisions field to display statistics about frames that are not sent due to 16 consecutive collisions. |
Late Collisions |
Number of packets with conflict and delayed. |
Deferreds |
Number of delayed packets without conflict. |
Buffers Purged |
Number of packets aged in the cache. |
Input bandwidth utilization threshold |
Threshold for inbound bandwidth usage. |
Output bandwidth utilization threshold |
Threshold for outbound bandwidth usage. |
Input bandwidth utilization |
Inbound bandwidth usage. For the S1720GFR, S1720GW, S1720GWR, S1720X, S1720GW-E, S1720GWR-E, S1720X-E, S2720EI, S2750EI, S5720SI, S5720S-SI, S5710-X-LI, S5700LI, S5720LI, S5720S-LI, S5700S-LI, S5730SI, S5730S-EI, S6720SI, S6720S-SI, S6720LI, and S6720S-LI, the bandwidth usage of Giants packets is calculated based on the configured jumbo frame length. To set the maximum jumbo frame length, run the jumboframe enable command. |
Output bandwidth utilization |
Outbound bandwidth usage. For the S1720GFR, S1720GW, S1720GWR, S1720X, S1720GW-E, S1720GWR-E, S1720X-E, S2720EI, S2750EI, S5720SI, S5720S-SI, S5710-X-LI, S5700LI, S5720LI, S5720S-LI, S5700S-LI, S5730SI, S5730S-EI, S6720SI, S6720S-SI, S6720LI, and S6720S-LI, the bandwidth usage of Giants packets is calculated based on the configured jumbo frame length. To set the maximum jumbo frame length, run the jumboframe enable command. |
interface
Function
The interface command displays the interface view or sub-interface view.
The undo interface command deletes a sub-interface.
Parameters
Parameter | Description | Value |
---|---|---|
interface-type interface-number | Specifies the type and number of an interface. The interface type and number can be closely next to each other or separated by a space character. To create a sub-interface, enter the sub-interface view, or delete a sub-interface, specify interface-number in the format of main interface number.sub-interface number. For example, the number of sub-interface 1 on GE0/0/1 is GE0/0/1.1. |
- |
Usage Guidelines
Usage Scenario
After the specified interface view is displayed, you can set attributes for the interface.
Precautions
Physical interfaces cannot be created or deleted. You can only run the interface interface-type interface-number command to enter the view of an existing physical interface.
You need to set the interface type before creating a sub-interface. Only hybrid and trunk interfaces on the preceding series of cards support Ethernet sub-interface configuration.
Sub-interfaces can be created. Run the interface interface-type interface-number command to create a sub-interface and enter the sub-interface view.
Sub-interfaces can be deleted. Run the undo interface interface-type interface-number command to delete a sub-interface.
Only the S6720EI, S6720S-EI, S5720HI and S5720EI support sub-interfaces.
Example
# Display the view of GE0/0/1.
<HUAWEI> system-view [HUAWEI] interface gigabitethernet 0/0/1 [HUAWEI-GigabitEthernet0/0/1]
# Create sub-interface GE0/0/1.1.
<HUAWEI> system-view [HUAWEI] interface gigabitethernet 0/0/1 [HUAWEI-GigabitEthernet0/0/1] port link-type hybrid [HUAWEI-GigabitEthernet0/0/1] quit [HUAWEI] interface gigabitethernet 0/0/1.1
# Delete sub-interface GE0/0/1.1.
<HUAWEI> system-view [HUAWEI] undo interface gigabitethernet 0/0/1.1
mtu (Interface view)
Function
Using the mtu command, you can set the maximum transmission unit (MTU) of an interface.
Using the undo mtu command, you can restore the default MTU of an interface.
By default, the MTU of an interface is 1500 bytes.
Parameters
Usage Guidelines
Usage Scenario
The maximum transmission unit (MTU) determines the maximum number of bytes in IP packets each time a sender can send. The MTU of an IP packet refers to the number of bytes from the IP header of the packet to the data.
The size of data frames is limited at the network layer. Any time the IP layer receives an IP packet to be sent, it checks to which local interface the packet needs to be sent and obtains the MTU configured on the interface. Then the IP layer compares the MTU with the packet length. If the packet length is longer than the MTU, the IP layer fragments the packet into smaller packets, which are shorter than or equal to the MTU. If unfragmentation is configured, some packets may be discarded during data transmission at the IP layer. To ensure jumbo packets are not dropped during transmission, you need to configure forcible fragmentation. In this case, you can run the mtu command to set the size of a fragment.
- If the configured MTU is excessively small and the packet size is larger, packets are discarded when being forwarded through the forwarding chip; packets are broken into a great number of fragments when being forwarded through the CPU, affecting proper data transmission.
- If the size of packets exceeds the MTU supported by a transit node or a receiver, the transit node or receiver fragments the packets or even discards them, aggravating the network transmission load.
The default MTU is recommended. When the size of packets to be transmitted or the device that receives packets changes, you can change the MTU based on the actual network.
The configured MTU takes effect for data packets on the control plane.
For S5720HI, the configured MTU takes effect for data packets on the forwarding plane after you run the ipv4 fragment enable command to enable packet fragmentation. The configured MTU takes effect for GRE packets on the forwarding plane without the need to execute the ipv4 fragment enable command.
For other devices, the configured MTU does not take effect for data packets on the forwarding plane.
Prerequisites
Run undo portswitch command to change the working mode of Ethernet interfaces from Layer 2 mode to Layer 3 mode.
Precautions
After changing the maximum transmission unit (MTU) using the mtu command on an interface, you need to restart the interface to make the new MTU take effect. To restart the interface, run the shutdown command and then the undo shutdown command, or run the restart command in the interface view.
If IPv6 is run on a tunnel interface and the MTU set using the mtu command on the interface is smaller than 1280, IPv6 works abnormally on this interface. To prevent this problem, set the MTU of a tunnel interface to a value greater than or equal to 1280 if IPv6 runs on the tunnel interface.
Configuring the MTU of an interface affects the maximum number of bytes for IP packets to be sent by the interface at a time. This configuration also affects the maximum frame length of sent Ethernet packets. The Ethernet packet size cannot exceed the maximum frame length allowed by the peer interface, which can be set using the jumboframe enable command.
Example
# Set the MTU of GE0/0/1 to 1200 bytes.
<HUAWEI> system-view [HUAWEI] interface gigabitethernet 0/0/1 [HUAWEI-GigabitEthernet0/0/1] undo portswitch [HUAWEI-GigabitEthernet0/0/1] mtu 1200 [HUAWEI-GigabitEthernet0/0/1] restart
# Set the MTU of the VLANIF interface to 1492 bytes.
<HUAWEI> system-view [HUAWEI] interface Vlanif 100 [HUAWEI-Vlanif100] mtu 1492 [HUAWEI-Vlanif100] restart
# Set the MTU of Tunnel 1 to 1492.
<HUAWEI> system-view [HUAWEI] interface tunnel 1 [HUAWEI-Tunnel1] mtu 1492 [HUAWEI-Tunnel1] shutdown [HUAWEI-Tunnel1] undo shutdown
port description
Function
The port description command configures description about the device type connected to an interface.
The undo port description command restores the default setting.
By default, no description about the device type connected to an interface is configured.
Parameters
Parameter |
Description |
Value |
---|---|---|
router |
Indicates that the interface is connected to a router. |
- |
switch |
Indicates that the interface is connected to a switch. |
- |
phone |
Indicates that the interface is connected to an IP phone. |
- |
desktop |
Indicates that the interface is connected to a desktop terminal, such as a PC. |
- |
Views
Ethernet interface view, GE interface view, XGE interface view, MultiGE interface view, 40GE interface view, Eth-Trunk interface view , port group view
Usage Guidelines
You can run this command to configure description about the device type connected to an interface to facilitate device management and maintenance. For example, you can run port description router command to indicate that the interface is connected to a router.
PrecautionsAfter you configure this command on an interface, the interface can still switch between Layer 2 and Layer 3 modes.
reset counters if-mib interface
Function
The reset counters if-mib interface command clears interface traffic statistics in the Network Management System (NMS).
Parameters
Parameter | Description | Value |
---|---|---|
interface-type [ interface-number ] | Clears traffic statistics on a specified interface
in the NMS.
If an interface type is specified but no interface number is specified, traffic statistics on all interfaces of the specified type are cleared. |
- |
Usage Guidelines
Usage Scenario
Before collecting traffic statistics on a specific interface within a period in the NMS, clear existing traffic statistics on this interface in the NMS.
For details on how to view interface traffic statistics in the NMS, see the NMS documentation.
Precautions
If no interface type and number are specified, traffic statistics of all interfaces in the NMS are cleared.
After you run the reset counters if-mib interface command, traffic statistics on all interfaces in the NMS are cleared. Therefore, confirm the action before you run this command.
Running the reset counters if-mib interface command does not affect the interface traffic statistics displayed by the display interface command. To clear the interface traffic statistics displayed by the display interface command, run the reset counters interface command.
reset counters interface
Function
The reset counters interface command clears traffic statistics about a specified interface.
Parameters
Parameter |
Description |
Value |
---|---|---|
interface-type [ interface-number ] |
Clears traffic statistics on a specified interface.
If an interface type is specified but no interface number is specified, traffic statistics on all interfaces of the specified type are cleared. |
- |
Usage Guidelines
Usage Scenario
Before collecting traffic statistics on an interface within a certain period, run the reset counters interface command to clear existing traffic statistics.
Precautions
Statistics cannot be restored after being cleared. Therefore, exercise caution before clearing the statistics.
Traffic accounting is based on the packet statistics on an interface. The clearing of the packet statistics on an interface by using the reset counters interface command affects the traffic accounting result. Therefore, do not randomly clear the packet statistics on an interface in a normal application environment.
If no interface type is specified, traffic statistics on all types of interfaces are cleared. If an interface type is specified but no interface number is specified, traffic statistics on all interfaces of the specified type are cleared.
Running the reset counters interface command clears the last part of the display interface command output. That is, statistics about received and transmitted packets on the interface are cleared.
reset counters top interface
Function
The reset counters top interface command clears top N interface traffic statistics reports.
Parameters
Parameter | Description | Value |
---|---|---|
report-number | Specifies the number of the top N interface traffic statistics report to be deleted. If you do not specify this parameter, the command clears all top N interface traffic statistics reports. | The value is an integer ranging from 1 to 5. |
Usage Guidelines
Usage Scenario
The top N interface traffic statistics function allows a device to generate a maximum of five top N interface traffic statistics reports. If you want to generate new top N interface traffic statistics reports when five top N interface traffic statistics reports already exist, run the reset counters top interface report [ report-number ] command to clear existing ones.
Precautions
- After you run the reset counters top interface report report-number command to clear a specified top N interface traffic statistics report, the numbers of other top N interface traffic statistics reports remain unchanged.
- You can run the reset counters top interface report [ report-number ] command even if less than five top N interface traffic statistics reports exist.
restart (interface view)
Views
Ethernet interface view, GE interface view, XGE interface view, MultiGE interface view, 40GE interface view, Eth-Trunk interface view, VLANIF interface view, Sub-interface view, Tunnel interface view, VE interface view, VE sub-interface view
Usage Guidelines
Usage Scenario
After modifying parameters of an interface, run the restart command to make the modification take effect.
Precautions
Restarting an interface during data transmission will cause data frame loss or service interruption. Exercise caution when you use the restart command.
Running the restart command is equivalent to running the shutdown command and the undo shutdown command in sequence.
Only the S6720EI, S6720S-EI, S5720HI and S5720EI support sub-interfaces.
set flow-stat interval
Function
The set flow-stat interval command sets the interval for collecting the traffic statistics on interfaces.
The undo set flow-stat interval command restores the default interval for collecting traffic statistics on interfaces.
By default, the interval for collecting traffic statistics on interfaces is 300 seconds.
Usage Guidelines
Usage Scenario
By using the set flow-stat interval command to set the interval for collecting traffic statistics on interfaces, you can collect and analyze traffic statistics according to your needs. You can also take traffic control measures based on the traffic statistics to prevent network congestion and service interruption.
When congestion occurs, set the interval for collecting traffic statistics on an interface to less than 300 seconds, or 30 seconds if congestion worsens. Then observe the traffic distribution on the interface within a short period of time. If data packets cause congestion, take proper measures to control the rate of the packets.
When the network bandwidth is sufficient and services are running properly, set the interval for collecting traffic statistics on an interface to more than 300 seconds. If the value of any traffic parameter is not within the specified range, change the interval for collecting traffic statistics to observe the traffic volume in real time.
Precautions
The interval configured in the system view takes effect on all the interfaces that use the default interval.
The interval configured in the interface view takes effect only on the current interface.
The interval configured in the interface view takes precedence over the interval configured in the system view.
shutdown (interface view)
Function
The shutdown command disables an interface.
The undo shutdown command enables an interface.
By default, interfaces are enabled.
Usage Guidelines
Usage Scenario
After modifying parameters of an interface, run the shutdown and undo shutdown commands to make the modification take effect.
When an interface is not connected to a cable or fiber, you can use the shutdown command to disable the interface to prevent exceptions caused by interference.
Precautions
When the device supports the autocomplete function, you must enter at least the characters shut before the device can automatically complete the shutdown command.
Disabling an interface during data transmission will cause data frame loss or service interruption. Exercise caution when you use the shutdown command.
Some logical interfaces, such as loopback, and null interfaces, do not support the shutdown and undo shutdown commands.
If you run the shutdown command in the Eth-Trunk interface view, all Eth-Trunk member interfaces are disabled.
Running the shutdown and undo shutdown commands is equivalent to running the restart command.
- Command Support
- collect counters top
- bandwidth (Interface view)
- description (interface view)
- display counters
- display counters error
- display counters interface
- display counters rate
- display counters top interface
- display interface
- display interface brief
- display interface description
- display ip interface
- display ip interface description
- display this interface
- interface
- mtu (Interface view)
- port description
- reset counters if-mib interface
- reset counters interface
- reset counters top interface
- restart (interface view)
- set flow-stat interval
- shutdown (interface view)