Fat AP and Cloud AP

Command Reference 6 Interface Management Commands

6 Interface Management Commands

About This Chapter

6.1 Basic Interface Configuration Commands

6.2 Ethernet Interface Configuration Commands
6.3 Logical Interface Configuration Commands

6.1 Basic Interface Configuration Commands

6.1.1 bandwidth (interface view)

Function
The bandwidth command specifies the interface bandwidth acquired by the NMS
from the MIB.
The undo bandwidth command cancels the configured interface bandwidth
acquired by the NMS from the MIB.
By default, no interface bandwidth acquired by the NMS from the MIB is set.

Format
bandwidth bandwidth [ kbps ]
undo bandwidth

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 517

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Parameters
Parameter Description Value

bandwidth Specifies the bandwidth of an interface. The value is an integer

ranging from 1 to
1000000, in Mbit/s.

kbps Indicates that the unit of the interface -

bandwidth is kbit/s.
If this parameter is not specified, the
interface bandwidth is expressed in Mbit/s.

Views
Interface view

Default Level
2: Configuration level

Usage Guidelines
The bandwidth command mainly ensures that the network management station
(NMS) can acquire the bandwidth of an interface. The NMS can check the
interface bandwidth through the two objects ifSpeed and ifHighSpeed in IF-MIB.
● 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.

Example
# Set the bandwidth of GE0/0/1 to 10000 Mbit/s.
<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] bandwidth 10000

6.1.2 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 "HUAWEI, AP Series, interface-type

interface-number Interface".

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 518

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Format
description description
undo description

Parameters
Parameter Description Value

description Specifies the interface The value is a string of 1

description. to 242 characters. The
character string is case
sensitive. It can contain
blanks but cannot
contain the question
mark (?).

Views
Interface view

Default Level
2: Configuration level

Usage Guidelines
Usage Scenario
To facilitate device management and maintenance, you can configure descriptions
for interfaces. An interface description can contain the device where the interface
is located, interface type, and remote device. For example: To-[DeviceB]GE-0/0/1
indicates that an interface of this device is connected to GE0/0/1 of device B.
Precautions
The interface description is displayed from the first non-space character.

Example
# Configure the description of GE0/0/1 as To-[DeviceB]GE-0/0/1, indicating that
this device is connected to device B through GE0/0/1.
<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] description To-[DeviceB]GE-0/0/1

6.1.3 display default-parameter interface

Function
The display default-parameter interface command displays the default interface
configuration, including the interface status, MTU, interval for collecting traffic

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 519

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

statistics, alarm threshold, interface description, whether the alarm function is

enabled to send an alarm to the NMS when the interface status changes.

Format
display default-parameter interface interface-type interface-number

Parameters
Parameter Description Value

interface-type interface- Displays the default configuration of a -

number specified interface.

Views
All views

Default Level
1: Monitoring level

Usage Guidelines
Default configurations are not saved in the configuration file. To check the default
configuration of an interface, run the display default-parameter interface
command on the interface.
The displayed information varies according to interfaces.

Example
# Display the default configuration of GE0/0/1.
<HUAWEI> display default-parameter interface gigabitethernet 0/0/1
Interface state: undo shutdown
Flow-stat interval: 300s
Trap-threshold: input-rate 100, output-rate 100
Snmp trap updown: enable
Description: HUAWEI, AP Series, GigabitEthernet0/0/1 Interface

# Display the default configuration of the interface VLANIF 2.

<HUAWEI> display default-parameter interface vlanif 2
Interface state: undo shutdown
MTU: 1500
Flow-stat interval: 300s
Description: HUAWEI, AP Series, Vlanif2 Interface

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 520

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Table 6-1 Description of the display default-parameter interface command

output
Item Description

Interface state Default status of an interface:

● shutdown: The default status of a physical interface
is shutdown.
● undo shutdown: The default status of a logical
interface is undo shutdown.
To change the interface status, run the shutdown
command or the undo shutdown command in the
interface view.

MTU Default MTU value of the interface.

Flow-stat interval Interval for collecting traffic statistics on the interface.

To set the interval for collecting traffic statistics on an
interface, run the set flow-stat interval (interface
view) command in the interface view.

Trap-threshold Alarm threshold for outbound and inbound bandwidth

usage on the interface.
To set the alarm threshold for outbound and inbound
bandwidth usage on an interface, run the trap-
threshold command in the interface view.

Snmp trap updown Whether an alarm is sent to the NMS when the
interface status changes:
● disable: No alarm is sent to the NMS when the
interface status changes.
● enable: An alarm is sent to the NMS when the
interface status changes.
To configure an interface to send an alarm to the NMS
when the interface status changes, run the enable
snmp trap updown command in the interface view.

Description Interface description.

To configure the description for an interface, run the
description (interface view) command in the
interface view.

6.1.4 display interface

Function
The display interface command displays interface running status and statistics.

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 521

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Format
display interface [ interface-type [ interface-number | main ] | main ]

Parameters
Parameter Description Value

interface-type Displays the running -

[ interface-number ] status of an interface.
● interface-type
specifies the interface
type.
● interface-number
specifies the interface
number.
If the interface type is
specified but no interface
number is specified,
running status of all the
interfaces of this type is
displayed.

main Displays running status -

and traffic statistics
about an interface.
● If an interface has no
sub-interfaces, status
and traffic statistics
about the interface
are displayed whether
you specify the main
parameter or not.
● If an interface has
sub-interfaces, status
and traffic statistics
about the interface
and sub-interfaces are
displayed if you do
not specify the main
parameter.

Views
All views

Default Level
1: Monitoring level

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 522

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

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, running status of all the interfaces of this type is displayed.

Example
# Display the running status, basic configuration, and packet forwarding on Layer
2 Ethernet interface GigabitEthernet0/0/1.
<HUAWEI> display interface gigabitethernet 0/0/1
GigabitEthernet0/0/1 current state : UP
Line protocol current state : UP
Description:HUAWEI, AP Series, GigabitEthernet0/0/1 Interface
Switch Port, PVID : 1, TPID : 8100(Hex), The Maximum Frame Length is 9216
IP Sending Frames' Format is PKTFMT_ETHNT_2, Hardware address is dcd2-fc21-5d40
Last physical up time : 2013-03-20 19:05:41 UTC-05:13
Last physical down time : 2013-03-20 19:03:54 UTC-05:13
Current system time: 2013-03-22 12:34:24-05:13
Port Mode: COMMON COPPER
Speed : 1000, Loopback: NONE
Duplex: FULL, Negotiation: DISABLE
Mdi : AUTO
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, Total Error: 0

CRC: 0, Giants: 0
Jabbers: 0, Throttles: 0
Runts: 0, Alignments: 0
Symbols: 0, Ignoreds: 0
Frames: 0

Output: 0 packets, 0 bytes

Unicast: 0, Multicast: 0
Broadcast: 0, Jumbo: 0
Discard: 0, Total Error: 0

Collisions: 0, ExcessiveCollisions: 0
Late Collisions: 0, Deferreds: 0

Input bandwidth utilization threshold : 100.00%

Output bandwidth utilization threshold: 100.00%
Input bandwidth utilization : 0%
Output bandwidth utilization : 0%

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 523

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Table 6-2 Description of the display interface command output

Item Description

current state Current interface status:

● DOWN: indicates that the interface is disabled.
● UP: indicates that the interface is enabled.

Line protocol current Link layer protocol status of the interface:

state ● DOWN: indicates that the link layer protocol of the
interface fails or no IP address is assigned to the
interface.
● UP: indicates that the link layer protocol of the
interface is running properly.

Description Interface description. To configure the description for an

interface, run the description command.

Switch Port, PVID Default VLAN ID of the interface.

TPID Indicates the type of frames that are supported on the

interface.
By default, TPID is displayed as 0x8100, indicating an
802.1Q frame.
This field is displayed only when the interface is a Layer
2 interface.

The Maximum Frame Maximum frame length allowed by the interface. The
Length value varies according to the device model.

IP Sending Frames' Format of the frame contained in the sent IP packet,

Format which can be PKTFMT_ETHNT_2, Ethernet_802.3, or
Ethernet_SNAP.

Hardware address MAC address of the device.

Last physical up time Last time the interface went Up physically. If this field
displays "-", the physical status of the interface does not
change.

Last physical down Last time the interface went Down physically. If this
time field displays "-", the physical status of the interface
does not change.

Current system time Current system time.

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 524

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Item Description

Port Mode Working mode of the interface:

● COMMON COPPER: The interface works as an
electrical interface.
● COMMON FIBER: The interface works as an optical
interface.
If the interface is a combo interface:
● COMBO AUTO: The combo interface automatically
selects the working mode.
● FORCE FIBER: The combo interface is configured as
an optical interface.
● FORCE COPPER: The combo interface is configured as
an electrical interface.

Speed Current rate of the interface.

Loopback Loopback configuration of the interface. To configure

this parameter, run the loopback command.

Duplex Duplex mode of the interface.

Negotiation Auto-negotiation mode of the interface.

Mdi Network cable type of the interface.

Last 300 seconds Incoming packet rate (bits per second and packets per
input rate second) within the last 300 seconds.

Last 300 seconds Outgoing packet rate (bits per second and packets per
output rate second) within the last 300 seconds.

Input peak rate Maximum incoming packet rate.

Output peak rate Maximum outgoing packet rate.

Input Total number of received packets.

Output Total number of sent packets.

Unicast Number of unicast packets received or sent by the

interface.

Multicast Number of multicast packets received or sent by the

interface.

Broadcast Number of broadcast packets received or sent by the

interface.

Jumbo Number of jumbo frames received or sent by the

interface.

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 525

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Item Description

Discard Number of packets discarded by the interface during

physical layer detection. These packets are discarded
because the interface is congested.
Layer 2 Ethernet interfaces of the device do not support
this statistical item.

Total Error Number of error packets found during physical layer

detection.

CRC Number of CRC error packets received by the interface.

Giants Number of jumbo frames with correct Frame Check

Sequence (FCS) received by the interface.

Jabbers Number of jumbo frames with incorrect FCS received by

the interface, including alignment errors (the number of
bytes that a packet contains is not an integer).

Throttles Number of undersized frames with incorrect FCS

received by the interface. Undersized frames are the
frames that are shorter than 64 bytes and have the
correct format and valid CRC field.

Runts Number of undersized frames with correct FCS received

by the interface. Undersized frames are the frames that
are shorter than 64 bytes and have the correct format
and valid CRC field.

Alignments Number of received frames with alignment errors.

Symbols Number of received frames with coding errors.

Ignoreds Number of received MAC control frames with OpCode

not being PAUSE.

Frames Number of packets with incorrect 802.3 length.

Collisions Number of collision frames. A collision frame is a packet

that is not sent due to a detected collision.

ExcessiveCollisions Number of excessive frames that are not sent after 16

consecutive collisions occur. These frames are not sent
due to excessive collisions.

Late Collisions Number of frames that experience conflict events and

are delayed. The first 512 bits of these frames have
been sent but these frames are delay because conflicts
are detected.

Deferreds Number of deferred packets. A deferred packet refers to

a packet that is delayed due to a detected collision.

Input bandwidth Threshold for inbound bandwidth usage.

utilization threshold

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 526

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Item Description

Output bandwidth Threshold for outbound bandwidth usage.

utilization threshold

Input bandwidth Inbound bandwidth usage.

utilization

Output bandwidth Outbound bandwidth usage.

utilization

6.1.5 display interface brief

Function
The display interface brief command displays brief information about the status
and configuration of interfaces.

Format
display interface brief [ main ]

Parameters
Parameter Description Value

main Displays brief -

information about an
Ethernet main interface.

Views
All views

Default Level
1: Monitoring level

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.

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 527

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Example
# Display brief information about the status and configuration of interfaces.
<HUAWEI> display interface brief
PHY: Physical
*down: administratively down
(l): loopback
(s): spoofing
(e): ETHOAM down
(d): Dampening Suppressed
InUti/OutUti: input utility/output utility
Interface PHY Protocol InUti OutUti inErrors outErrors
GigabitEthernet0/0/1 up up 0.01% 0.01% 0 0
LoopBack0 up up(s) 0% 0% 0 0
LoopBack1 up up(s) 0% 0% 0 0
NULL0 up up(s) 0% 0% 0 0
Vlanif1 up down -- -- 0 0
Vlanif100 down down -- -- 0 0
Vlanif2001 up up -- -- 0 0
Wlan-Bss0 up up -- -- 0 0
Wlan-Radio0/0/0 up up -- -- 0 0
Wlan-Radio0/0/1 up up -- -- 0 0

Table 6-3 Description of the display interface brief command output

Item Description

Interface Type and number of an interface.

PHY Physical status of an interface:

● up: indicates that the interface is working properly.
● down: indicates that the physical layer of the interface
fails.
● *down: Administratively Down, indicating that the
administrator has run the shutdown command on the
interface.
● (l): indicates that the loopback function is enabled on
the interface.

Protocol Link layer protocol status of the interface:

● up: indicates that the interface is working properly.
● down: indicates that the link layer protocol of the
interface fails.
● (l): indicates that the loopback function is enabled on
the interface.
● (s): indicates that the spoofing function is enabled on
the interface.
● (e): indicates that the link layer of the interface is in
EFM Down state.
● (d): indicates that the protocol module of the interface
is suppressed.
● --: indicates that the link layer protocol status is not
obtained.

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 528

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Item Description

InUti Instantaneous bandwidth usage in the inbound direction

of an interface.
When the average bandwidth usage is smaller than
0.01% and greater than 0, the value 0.01% is displayed.
When the interface bandwidth becomes lower, 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.

OutUti Instantaneous bandwidth usage in the outbound direction

of an interface.
When the average bandwidth usage is smaller than
0.01% and greater than 0, the value 0.01% is displayed.
When the interface bandwidth becomes lower, 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 Number of error packets received by an interface. 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 Number of error packets sent by an interface. 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.

6.1.6 display interface description

Function
The display interface description command displays the description of an
interface.

Format
display interface description [ interface-type [ interface-number ] ]

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 529

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Parameters
Parameter Description Value

interface-type Displays the description -

[ interface-number ] 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.

Views
All views

Default Level
1: Monitoring level

Usage Guidelines
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.

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.

Example
# Display the description of GE0/0/1.
<HUAWEI> display interface description gigabitethernet 0/0/1
PHY: Physical
*down: administratively down
(l): loopback
(s): spoofing
(e): ETHOAM down
(d): Dampening Suppressed
Interface PHY Protocol Description
GE0/0/1 down down HUAWEI, AP Series, GigabitEthernet0/0/1 Interface

Table 6-4 Description of the display interface description command output

Item Description

Interface Type and number of an interface.

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 530

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Item Description

PHY Physical status of an interface:

● up: indicates that the interface is working properly.
● down: indicates that the physical layer of the interface
fails.
● *down: Administratively Down, indicating that the
administrator has run the shutdown command on the
interface.
● (l): indicates that the loopback function is enabled on
the interface.

Protocol Link layer protocol status of the interface:

● up: indicates that the interface is working properly.
● down: indicates that the link layer protocol of the
interface fails.
● (l): indicates that the loopback function is enabled on
the interface.
● (s): indicates that the spoofing function is enabled on
the interface.
● (e): indicates that the link layer of the interface is in
EFM Down state.
● (d): indicates that the protocol module of the interface
is suppressed.
● --: indicates that the link layer protocol status of the
interface is not obtained.

Description Interface description.

6.1.7 display interface counters

Function
The display interface counters command displays packet statistics on physical
interfaces.

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

Parameters
Parameter Description Value

interface-type Displays statistics about -

packets sent and
received by an interface.

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 531

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Parameter Description Value

inbound Displays statistics about -

packets received by an
interface.

outbound Displays statistics about -

packets sent by an
interface.

Views
All views

Default Level
2: Configuration level

Usage Guidelines
Usage Scenario

The display interface counters command can be used when you need to:

● Check whether an interface is sending and receiving packets normally during

interface fault diagnosis.
● Collect traffic statistics on an interface.
● Check whether an interface can send and receive multicast packets after the
multicast function is configured.

If no interface type is specified, the statistics of packets sent and received by all
interfaces are displayed. If an interface type is specified, the statistics about
packets sent and received by all interfaces of this type are displayed.

Follow-up Procedure

If you want to collect new traffic statistics, run the reset counters interface
command to clear the current statistics.

Example
# Display statistics about packets received by an interface.
<HUAWEI> display interface gigabitethernet counters inbound
Interface Total UniCast MultiCast BroadCast Err
(pkts) (pkts) (pkts) (pkts) (pkts)
GE0/0/1 375795 37306 14122 324367 0

NOTICE
OverFlow :more than 14 decimal digits (8 digits for column "Err").
-- :not supported.

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 532

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Table 6-5 Description of the display interface counters command output

Item Description

Interface Type and number of an interface.

Total Total number of packets sent and received by an

interface.

UniCast Number of unicast packets sent or received by an

interface.

MultiCast Number of multicast packets sent or received by an

interface.

BroadCast Number of broadcast packets sent or received by an

interface.

Err Number of error packets sent or received by an

interface.

OverFlow :more than The character OverFlow is displayed when the statistics
14 decimal digits (8 value for each type exceeds the maximum value that
digits for column can be displayed.
"Err"). ● For Err frames, OverFlow is displayed when the value
exceeds 8 decimal numbers.
● For other data, OverFlow is displayed when the value
exceeds 14 decimal numbers.

-- :not supported. The device does not support statistics collection for the
specific type.

6.1.8 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 ] ]

display ip interface brief [ interface-type ] &<1-8>

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 533

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Parameters
Parameter Description Value
interface-type Specifies the type and number of an interface. If no -
interface-number 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.

Views
All views

Default Level
1: Monitoring level

Usage Guidelines
You can run the display ip interface brief command to view the following
information:
● 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
This command, however, cannot display the IP configurations of Layer 2 interfaces
or Eth-Trunk member interfaces.

NOTE

● 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.

Example
# Display IP information about VLANIF15.
<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

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 534

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

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

Table 6-6 Description of the display ip interface command output

Item Description

current state : Physical status of the interface:

● UP: indicates that the interface is physically
Up.
● DOWN: indicates that the interface is
physically Down.
● Administratively down: indicates that the
administrator has run the shutdown
command on the interface.

Line protocol current state : Link layer protocol status of the interface:
● UP: The link layer protocol of the interface
is running properly.
● DOWN: The link layer protocol of the
interface is Down or no IP address is
configured on 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 : Total number of packets, bytes, and multicast
41540847, multicasts : 681817 packets received by the interface.

output packets : 242239, Total number of packets, bytes, and multicast

bytes : 14679482, multicasts : packets sent by the interface.
172333

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.

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 535

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Item Description

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.

6.1.9 display ip interface description

Function
The display ip interface description command displays IP-related information
(such as the IP address, subnet mask, physical layer status, link layer protocol
status, and number of interfaces in different states) and description of an
interface.

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 536

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Format
display ip interface description [ interface-type [ interface-number ] | interface-
type &<1-8> ]

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- Indicates the interface number, which is used together -

number 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.

Views
All views

Default Level
1: Monitoring level

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.

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),

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 537

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

^D(standby), l(loopback), s(spoofing),

U(up), E(E-Trunk down)
------------------------------------------------------------------------------
Number of interfaces whose physical status is Up: 3
Number of interfaces whose physical status is Down: 1
Number of interfaces whose protocol status is Up: 2
Number of interfaces whose protocol status is Down: 2

Interface IP Address/Mask Phy Prot Description

NULL0 unassigned U U(s)
Vlanif1 unassigned U D
Vlanif102 unassigned D D
Vlanif400 192.168.40.1/24 U U

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 538

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Table 6-7 Description of the display ip interface description command output

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:
– Ana: Analogmodem interfaces
– Asy: Async interfaces
– Cell: Cellular interfaces
– Dia: Dialer interfaces
– Eth: Ethernet interfaces
– GE: GigabitEthernet interfaces
– H: HSSI interfaces
– Ima: IMA-Group interfaces
– Loop: Loopback interfaces
– MTun: MTunnel interfaces
– S: Serial interfaces
– Tun: Tunnel interfaces
– VE: Virtual-Ethernet interfaces
– VT: Virtual-Template interfaces
● Explanation of the abbreviated physical
status of the interface is as follows:
– U: indicates that the physical status of
the interface is Up. U(l) indicates that
the interface is enabled with the
loopback function.
– D: indicates that the physical status of
the interface is Down.
– *D: indicates that the network
administrator has run the shutdown
command on the interface.
– ^D: indicates that the FIB module is in
the standby state.
– s: indicates that the interface is in
spoofing status.
– E: indicates the physical status of the
Eth-Trunk.
● Explanation of the abbreviated link layer
protocol status is as follows:
– U: indicates that the status of the link
layer protocol on the interface is Up.

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 539

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Item Description

U(s) indicates that the link layer

protocol of the interface is Up even
though the interface is not configured
with an IP address. (s) is an inherent
attribute of the interface and will be
displayed when the interface is
configured with an IP address. (d)
indicates that the protocol module of
the interface is dampened.
– D: indicates that the link layer protocol
of the interface is Down or no IP
address is assigned to the interface.

Number of interfaces whose Indicates the number of interfaces whose

physical status is Up: physical status is Up.

Number of interfaces whose Indicates the number of interfaces whose

physical status is Down: physical status is Down.

Number of interfaces whose Indicates the number of interfaces whose link

protocol status is Up: layer protocol is Up.

Number of interfaces whose Indicates the number of interfaces whose link

protocol status is Down: 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 17 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.

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 540

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

6.1.10 display this interface

Function
The display this interface command displays interface information in the current
interface view.

Format
display this interface

Parameters
None

Views
Interface view

Default Level
1: Monitoring level

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.
Although the default level of the display this interface command is monitoring
level, this command must be run in the interface view. Therefore, to run this
command, you need to be of the configuration level or higher.

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 : DOWN
Description:HUAWEI, AP Series, GigabitEthernet0/0/1 Interface
Switch Port, PVID : 1, TPID : 8100(Hex), The Maximum Frame Length is 9216
IP Sending Frames' Format is PKTFMT_ETHNT_2, Hardware address is dcd2-fcf9-b5ca
Last physical up time : -
Last physical down time : 2011-12-12 03:36:09 UTC+08:00
Current system time: 2011-12-12 10:51:31+08:00
Port Mode: COMMON COPPER
Speed : 1000, Loopback: NONE
Duplex: FULL, Negotiation: ENABLE
Mdi : AUTO
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

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 541

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Broadcast: 0, Jumbo: 0
Discard: 0, Total Error: 0

CRC: 0, Giants: 0
Jabbers: 0, Throttles: 0
Runts: 0, Alignments: 0
Symbols: 0, Ignoreds: 0
Frames: 0

Output: 0 packets, 0 bytes

Unicast: 0, Multicast: 0
Broadcast: 0, Jumbo: 0
Discard: 0, Total Error: 0

Collisions: 0, ExcessiveCollisions: 0
Late Collisions: 0, Deferreds: 0

Input bandwidth utilization threshold : 100.00%

Output bandwidth utilization threshold: 100.00%
Input bandwidth utilization : 0%
Output bandwidth utilization : 0%

Table 6-8 Description of the display this interface command output

Item Description

current state Current interface status:

● DOWN: indicates that the interface is disabled.
● UP: indicates that the interface is enabled.

Line protocol current Link layer protocol status of the interface:

state ● DOWN: indicates that the link layer protocol of the
interface fails or no IP address is assigned to the
interface.
● UP: indicates that the link layer protocol of the
interface is running properly.

Description Interface description.

PVID Default VLAN ID of the interface.

TPID Type of frames that are supported on the interface.

By default, this field displays 0x8100, indicating an
802.1Q frame. If the device does not support 802.1Q
frames, the interface discards the 802.1Q frames
immediately after receiving them.
This field is displayed only for a Layer 2 interface.

The Maximum Frame Maximum frame length allowed by the interface.

Length

IP Sending Frames' Format of the frame contained in the sent IP packet,

Format which can be PKTFMT_ETHNT_2, Ethernet_802.3, or
Ethernet_SNAP.

Hardware address MAC address of the device.

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 542

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Item Description

Last physical up time Last time the interface went Up physically. If this field
displays "-", the physical status of the interface does not
change.

Last physical down Last time the interface went Down physically. If this
time field displays "-", the physical status of the interface
does not change.

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
UTC±HH:MM DST format.

Port Mode Working mode of the interface:

● COMMON COPPER: The interface works as an
electrical interface.
● COMMON FIBER: The interface works as an optical
interface.

Speed Current rate of an interface.

Loopback Loopback configuration of the interface.

Duplex Duplex mode of the interface.

Negotiation Auto-negotiation mode of the interface.

Mdi Network cable type of the interface.

Last 300 seconds Incoming packet rate (bits per second and packets per
input rate second) within the last 300 seconds.

Last 300 seconds Outgoing packet rate (bits per second and packets per
output rate second) within the last 300 seconds.

Input peak rate 0 Maximum rate of incoming packets and time when the
bits/sec,Record time maximum rate is reached.

Output peak rate 0 Maximum rate of outgoing packets and time when the
bits/sec,Record time maximum rate is reached.

Input Total number of received packets.

Output Total number of sent packets.

Unicast Number of unicast packets received or sent by the

interface.

Multicast Number of multicast packets received or sent by the

interface.

Broadcast Number of broadcast packets received or sent by the

interface.

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 543

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Item Description

Jumbo Number of jumbo frames received or sent by the

interface.

Discard Number of packets discarded by the interface during

physical layer detection.

Total Error Number of error packets found during physical layer

detection.

CRC Number of CRC error packets received by the interface.

Giants Number of jumbo frames with correct FCS received by

the interface.

Jabbers Number of jumbo frames with incorrect FCS received by

the interface, including alignment errors (the number of
bytes that a packet contains is not an integer).

Throttles Number of undersized frames with incorrect FCS

received by the interface.

Runts Number of undersized frames with correct FCS received

by the interface.

Alignments Number of received frames with alignment errors.

Symbols Number of received frames with coding errors.

Ignoreds Number of received MAC control frames with OpCode

not being PAUSE.

Frames Number of packets with incorrect 802.3 length.

Collisions Number of sent packets with 1 to 15 conflict events.

ExcessiveCollisions Number of packets with 16 conflict events and failing to

be sent.

Late Collisions Number of packets with conflict and delayed.

Deferreds Number of delayed packets without conflict.

Input bandwidth Threshold for inbound bandwidth usage.

utilization threshold

Output bandwidth Threshold for outbound bandwidth usage.

utilization threshold

Input bandwidth Inbound bandwidth usage.

utilization

Output bandwidth Outbound bandwidth usage.

utilization

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 544

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

6.1.11 interface
Function
The interface command displays the interface view.

Format
interface interface-type interface-number
undo interface interface-type interface-number

Parameters
Parameter Description Value

interface-type Specifies the type and number of an interface. The -

interface-number interface type and number can be closely next to
each other or separated by a space character.

Views
System view

Default Level
2: Configuration level

Usage Guidelines
Usage Scenario
After the specified interface view is displayed, you can set attributes for the
interface.
Precautions
● The interface command can display only the view of an existing physical
interface and cannot create a physical interface.
● The interface command can create a logical interface and display the view of
the logical interface.
● After an RU goes online, the central AP generates a virtual Ethernet interface.
If you cannot enter the Ethernet interface view, run the wired-port-profile
(WLAN view) command to enter the AP wired port profile view to configure
the Ethernet interface.

Example
# Display the view of GE0/0/1.
<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1]

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 545

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

6.1.12 reset counters if-mib interface

Function
The reset counters if-mib interface command clears interface traffic statistics in
the Network Management System (NMS).

Format
reset counters if-mib interface [ interface-type [ interface-number ] ]

Parameters
Parameter Description Value
interface-type Clears traffic statistics on a specified interface in the -
[ interface- NMS.
number ]
● interface-type specifies the interface type.
● interface-number specifies the interface number.
If an interface type is specified but no interface
number is specified, traffic statistics on all interfaces
of the specified type are cleared.

Views
User view

Default Level
3: Management level

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.

NOTE

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.

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 546

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

● 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.

Example
# Clear traffic statistics on GE0/0/1 in the NMS.
<HUAWEI> reset counters if-mib interface gigabitethernet 0/0/1

6.1.13 reset counters interface

Function
The reset counters interface command clears traffic statistics about a specified
interface.

Format
reset counters interface [ interface-type [ interface-number ] ]

Parameters
Parameter Description Value

interface-type Clears traffic statistics on -

[ interface-number ] a specified interface.
● interface-type
specifies the interface
type.
● interface-number
specifies the interface
number.
If an interface type is
specified but no interface
number is specified,
traffic statistics on all
interfaces of the
specified type are
cleared.

Views
User view

Default Level
3: Management level

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 547

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

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.

Example
# Clear traffic statistics on all interfaces.
<HUAWEI> reset counters interface

# Clear traffic statistics on VLANIF10.

<HUAWEI> reset counters interface vlanif 10

6.1.14 restart (interface view)

Function
The restart command restarts an interface.

Format
restart

Parameters
None

Views
GE interface view, Ethernet interface view, VLANIF interface view, MultiGE
interface view, Eth-Trunk interface view

Default Level
2: Configuration level

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 548

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

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.

Example
# Restart GE0/0/1.
<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] restart

6.1.15 set flow-stat interval (interface view)

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.

Format
set flow-stat interval interval-time
undo set flow-stat interval

Parameters
Parameter Description Value

interval-time Specifies the interval for The value is an integer

collecting traffic statistics that ranges from 10 to
on interfaces. 600, in seconds. In
addition, the value must
be a multiple of 10. The
default value is 300s.

Views
Interface view

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 549

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Default Level
2: Configuration level

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.

Example
# Set the interval for collecting traffic statistics on GE0/0/1 to 400s.
<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] set flow-stat interval 400

6.1.16 shutdown (interface view)

Function
The shutdown command disables an interface.
The undo shutdown command enables an interface.
By default, interfaces are enabled.

Format
shutdown
undo shutdown

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 550

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Parameters
None

Views
GE interface view, Ethernet interface view, VLANIF interface view, MultiGE
interface view, Eth-Trunk interface view

Default Level
2: Configuration level

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
● 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.
● To ensure that the cloud AP is managed by the SDN controller, you cannot
run the shutdown command on the cloud AP to disable the following
interfaces:
– Physical interface and VLANIF interface used to communicate with the
SDN controller
– VLANIF interface corresponding to the management VLAN

Example
# Shut down GE0/0/1.
<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] shutdown

6.1.17 shutdown interval

Function
The shutdown interval command sets the minimum interval for re-enabling an
interface.

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 551

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

The undo shutdown interval command restores the default minimum interval for
re-enabling an interface.

By default, the minimum interval for re-enabling an interface is 0 seconds.

Format
shutdown interval interval-value

undo shutdown interval

Parameters
Parameter Description Value

interval-value Specifies the minimum The value is an integer

interval for re-enabling that ranges from 5 to 15,
an interface. in seconds.

Views
System view

Default Level
2: Configuration level

Usage Guidelines
Usage Scenario

In some cases, for example, when parameters of an interface are modified but the
modification does not take effect immediately, run the shutdown and undo
shutdown commands to re-enable the interface. Then the modification can take
effect. To shorten the waiting time, run the shutdown interval command to set
the minimum interval for re-enabling an interface.

Precautions

● The minimum interval configured using this command also applies to the
restart command.

Example
# Set the minimum interval for re-enabling an interface to 5 seconds.
<HUAWEI> system-view
[HUAWEI] shutdown interval 5

6.2 Ethernet Interface Configuration Commands

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 552

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

6.2.1 am isolate
Function
The am isolate command isolates the current interface from a specified interface
unidirectionally.
The undo am isolate command cancels unidirectional isolation between the
current interface and a specified interface. If no interface is specified,
unidirectional isolation between the current interface and all the other interfaces
is canceled.
By default, no unidirectional isolation is configured between the current interface
and a specified interface

NOTE

Only the AD9431DN-24X support this function.

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

Parameters
Parameter Description Value

interface-type interface- Specifies the type and -

number number of the interface
from which the current
interface is isolated
unidirectionally.
● interface-type
specifies the type of
the interface.
● interface-number
specifies the number
of the interface.

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

Default Level
2: Configuration level

Usage Guidelines
Usage Scenario

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 553

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

The am isolate command isolates interfaces unidirectionally. For example, if

interface A is isolated from interface B unidirectionally, packets sent from interface
A cannot reach interface B, but packets sent from interface B can reach interface
A. Unidirectional isolation needs to be configured in the following scenarios:

● When multiple hosts connect to different interfaces of a device and a host

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

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

Precautions

An interface can be unidirectionally isolated from another type of interface.

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

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

6.2.2 auto duplex

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

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

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

the peer interface.

Format
auto duplex { half | full } *

undo auto duplex

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 554

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Parameters
Parameter Description Value

half Sets the duplex mode on -

an Ethernet electrical
interface in auto-
negotiation mode to
half-duplex.

full Sets the duplex mode on -

an Ethernet electrical
interface in auto-
negotiation mode to full-
duplex.

Views
GE interface view, MultiGE interface view

Default Level
2: Configuration level

Usage Guidelines
Usage Scenario

In auto-negotiation mode, interfaces on both ends of a link negotiate their duplex

mode. If the negotiated duplex mode is not the required one, you can run the
auto duplex command to set the required duplex mode in auto-negotiation
mode. For example, two interfaces on both ends support full-duplex mode and
half-duplex mode. If the two interfaces negotiate to work in half-duplex mode,
but they are required to work in full-duplex mode, you can run the auto duplex
full command to set the full-duplex mode for the two interfaces.

Prerequisites

The Ethernet interface works in auto-negotiation mode.

Precautions

● For details about the duplex modes that various Ethernet interfaces support,
see see Overview of Ethernet Interfaces in the Configuration Guide-
Overview of Ethernet Interfaces.
● In auto-negotiation mode, a GE electrical interface that works at a rate of
1000 Mbit/s supports the full-duplex mode. If the duplex mode is changed to
half-duplex, the GE electrical interface works at a maximum rate of 100
Mbit/s.
NOTE

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

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 555

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

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

6.2.3 auto speed

Function
The auto speed command configures the auto-negotiation rate of an Ethernet
electrical interface.
The undo auto speed command restores the default auto-negotiation rate of an
Ethernet electrical interface.
By default, Ethernet electrical interfaces on both ends can negotiate to any rate
they support.

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

undo auto speed

Parameters
Parameter Description Value

10 Sets the auto- -

negotiation rate of an
Ethernet electrical
interface to 10 Mbit/s.

100 Sets the auto- -

negotiation rate of an
Ethernet electrical
interface to 100 Mbit/s.

1000 Sets the auto- -

negotiation rate of an
Ethernet electrical
interface to 1000 Mbit/s.

2500 Sets the auto- -

negotiation rate of an
Ethernet electrical
interface to 2500 Mbit/s.

5000 Sets the auto- -

negotiation rate of an
Ethernet electrical
interface to 5000 Mbit/s.

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 556

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

NOTE

Only MultiGE interfaces support the parameters 2500/5000.

The auto-negotiation rate configured for an Ethernet interface cannot exceed the
interface's capability. For example, the auto-negotiation rate of a GE interface cannot be set
to 2500 Mbit/s.

Views
GE interface view, MultiGE interface view

Default Level
2: Configuration level

Usage Guidelines
Usage Scenario

In auto-negotiation mode, interfaces on both ends of a link negotiate their rate. If

the negotiated rate is not the required one, run the auto speed command to set
the auto-negotiation rate range to limit the negotiated rate. For example, if two
interfaces negotiate to work at a rate of 1000 Mbit/s, but they are required to
work at a rate of 100 Mbit/s, you can run the auto speed 100 command to set
the rate of the interfaces to 100 Mbit/s.

Prerequisites

The Ethernet interface works in auto-negotiation mode.

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

6.2.4 cable-snr-test

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

NOTE

This function is supported only by MultiGE electrical interfaces on the AP6052DN, AP7050DN-E,
AP7052DN, AP7152DN, AP7052DE, AP8082DN, and AP8182DN.

Format
cable-snr-test

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 557

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Parameters
None

Views
MultiGE interface view

Default Level
3: Management level

Usage Guidelines
Usage Scenario
You can check the quality of the network cable on a MultiGE electrical interface to
determine whether the network cable quality meets communication requirements.
Precautions
● This command checks real-time quality of the network cable on an interface,
and the network cable quality changes with the external environment.
● A MultiGE electrical interface supports the network cable quality check only
when it works at the rate of 2.5 Gbit/s or higher.
● An interface does not support the network cable quality check when it is
Down or in loopback detection mode.

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

6.2.5 display interface ethernet brief

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

Format
display interface ethernet brief [ main ]

Parameters
Parameter Description Value

main Displays brief -

information about all
Ethernet main interfaces.

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 558

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Views
All views

Default Level
1: Monitoring level

Usage Guidelines
Usage Scenario
You can use the display interface ethernet brief command to view brief
information about Ethernet interfaces, including the physical status, auto-
negotiation mode, duplex mode, bandwidth, and average inbound and outbound
bandwidth usages within the last period of time. This information helps you locate
and rectify faults.
Precautions
To clear statistics on an interface, run the reset counters interface command.

Example
# Display brief information about all Ethernet interfaces.
<HUAWEI> display interface ethernet brief
PHY: Physical
*down: administratively down
(l): loopback
InUti/OutUti: input utility/output utility
Interface PHY Auto-Neg Duplex Bandwidth InUti OutUti Trunk
GigabitEthernet0/0/1 up enable full 1000M 0.01% 0.01% --

Table 6-9 Description of the display interface ethernet brief command output
Item Description

Interface Type and number of an interface. All interfaces are displayed in

alphabetical order. Information about the following interfaces can
be displayed:
● GE interface

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 559

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Item Description

PHY Physical status of an interface:

● up: indicates that the interface works properly.
● down: indicates that the physical layer of the interface fails.
● *down: refers to Administratively Down, indicating that the
administrator has run the shutdown (interface view) command
on the interface.
● ^down: refers to standby, indicating that this interface is a
backup interface.
● (l): refers to loopback, indicating that the loopback function is
enabled on the interface.

Auto- Whether auto-negotiation is enabled on an interface:

Neg ● enable: indicates that auto-negotiation is enabled on the
interface.
● disable: indicates that auto-negotiation is disabled on the
interface.
To configure the auto-negotiation mode for an interface, run the
negotiation auto command.

Duplex Duplex mode of an interface:

● full: indicates the full-duplex mode.
● half: indicates the half-duplex mode.
● In auto-negotiation mode, use the auto duplex command to
configure the duplex mode of an interface.
● In non-auto negotiation mode, use the duplex command to
configure the duplex mode of an interface.

Bandwidt Bandwidth on the interface.

h

InUti Average inbound bandwidth usage within the last 5 minutes.

Average inbound bandwidth usage = Average inbound rate within
the last 5 minutes/Interface bandwidth
When the average bandwidth usage is smaller than 0.01% and
larger than 0, the value 0.01% is displayed. When the interface
bandwidth becomes smaller, for example, the bandwidth is changed
using the speed command, or when an Eth-Trunk member interface
becomes Down or is removed from the Eth-Trunk, the bandwidth
usage may be displayed as 100% because the communication traffic
is not adjusted in time.

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 560

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Item Description

OutUti Average outbound bandwidth usage within the last 5 minutes.

Average outbound bandwidth usage = Average outbound rate
within the last 5 minutes/Interface bandwidth
When the average bandwidth usage is smaller than 0.01% and
larger than 0, the value 0.01% is displayed. When the interface
bandwidth becomes smaller, for example, the bandwidth is changed
using the speed command, or when an Eth-Trunk member interface
becomes Down or is removed from the Eth-Trunk, the bandwidth
usage may be displayed as 100% because the communication traffic
is not adjusted in time.

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

6.2.6 display port-isolate group

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

NOTE

Only the AD9431DN-24X support this function.

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

Parameters
Parameter Description Value

group-id Displays the The value is an integer

configuration of a that ranges from 1 to 64.
specified port isolation
group.

all Displays the -

configurations of all port
isolation groups.

Views
All views

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 561

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Default Level
1: Monitoring level

Usage Guidelines
The port isolation feature isolates interfaces in a VLAN. By adding interfaces to a
port isolation group, you can implement Layer 2 isolation between these
interfaces. To view the configuration of the port isolation group, run the display
port-isolate group command.

Example
# Display the configurations of all port isolation groups.
<HUAWEI> display port-isolate group all
The ports in isolate group 3:
GigabitEthernet0/0/1
GigabitEthernet0/0/2
The ports in isolate group 4:
GigabitEthernet0/0/3
GigabitEthernet0/0/4

6.2.7 duplex

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

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

By default, an Ethernet electrical interface works in full-duplex mode when auto-

negotiation is disabled on the interface.

Format
duplex { full | half }

undo duplex

Parameters
Parameter Description Value

full Configures the Ethernet -

interface to work in full-
duplex mode when auto-
negotiation is disabled
on the interface.

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 562

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Parameter Description Value

half Configures the Ethernet -

interface to work in half-
duplex mode when auto-
negotiation is disabled
on the interface.

Views
GE interface view

Default Level
2: Configuration level

Usage Guidelines
Usage Scenario
The duplex mode of an interface needs to be set in the following scenarios:
● To enable an interface to send and receive packets at the same time, set the
full-duplex mode on the interface.
● To disable an interface from sending and receiving packets at the same time,
set the half-duplex mode on the interface.
Prerequisites
The interface works in non-auto negotiation mode.
Precautions
● A GE electrical interface that works at 1000 Mbit/s supports only the full-
duplex mode. A GE electrical interface and its peer interface do not need to
negotiate the duplex mode.
NOTE

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

Example
# Configure Ethernet electrical interface GE0/0/1 to work in half-duplex mode
when non-auto negotiation is disabled on the interface.
<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] undo negotiation auto
[HUAWEI-GigabitEthernet0/0/1] duplex half

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 563

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

6.2.8 log-threshold

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

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

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

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

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

Parameters

Parameter Description Value

input-rate Specifies the inbound -

bandwidth.

output-rate Specifies the outbound -

bandwidth.

bandwidth-in-use Specifies the bandwidth The value is an integer that

usage threshold for ranges from 1 to 100.
generating a log, prompting
for a bandwidth increase
request.

resume-rate Specifies the bandwidth The value is an integer that

resume-threshold usage threshold for ranges from 1 to the value of
generating a log, indicating bandwidth-in-use. The
that bandwidth usage has default value is the value of
been restored. bandwidth-in-use.

Views
GE interface view, MultiGE interface view, XGE interface view

Default Level
2: Configuration level

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 564

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Usage Guidelines
Monitoring bandwidth usage helps you learn about current device load. If the
bandwidth usage exceeds a configured threshold, a log or an alarm is generated,
indicating that bandwidth resources become insufficient and need an increase. For
example, if bandwidth usage exceeds 95% of total bandwidth, an alarm is
generated, indicating that bandwidth is exhausted. Some services may be
interrupted before the bandwidth increases. To help prevent service interruption,
setting two bandwidth usage thresholds, one for generating a log and the other
for generating an alarm helps you increase bandwidth in time.

NOTE

Outbound bandwidth usage = (Outbound interface rate/Outbound physical interface

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

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

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

# Configure GE0/0/1 to generate a log when the outbound interface rate exceeds
80% of the bandwidth and to generate a log indicating that bandwidth usage has
been restored, when the outbound interface rate is lower than 60% of the
bandwidth.
<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] log-threshold output-rate 80 resume-rate 60

6.2.9 loopback
Function
The loopback command enables loopback detection on an interface.
The undo loopback command disables loopback detection on an interface.
By default, loopback detection is not configured.

NOTE

The AD9431DN-24X do not support the parameter remote.

Format
loopback { internal | remote }
undo loopback

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 565

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Parameters
Parameter Description Value

internal Configures internal -

loopback detection on a
specified interface.

remote Configures remote -

loopback detection on
an interface.

Views
GE interface view, MultiGE interface view, XGE interface view

Default Level
2: Configuration level

Usage Guidelines
Usage Scenario
Loopback detection can be enabled to test some special functions, for example,
locating faults on the Ethernet. After loopback detection is enabled, the Ethernet
interface works in full-duplex mode. After loopback detection is disabled, the
original duplex mode of the Ethernet interface is restored.
After internal loopback detection is enabled on an interface, packets sent from the
interface are sent back to this interface.
After remote loopback detection is configured, the local interface sends a packet
received from the peer interface back to the peer interface, rather than forwarding
the packet to the destination address.
Follow-up Procedure
Use a dedicated test tool to check whether the number of packets received and
the number of packets sent on the Ethernet interface are the same. If not, the
hardware is faulty. If yes, the hardware works properly.
Precautions
Loopback detection interrupts the operation of Ethernet interfaces and links. After
loopback detection is performed, run the undo loopback command to disable
loopback detection immediately.

Example
# Configure internal loopback detection on GE0/0/1.
<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] loopback internal
Info: This may interrupt the operation of Ethernet interfaces and links.Continue
? [Y/N]:y

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 566

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

6.2.10 negotiation auto

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

The undo negotiation auto command configures an Ethernet interface to work in

non-auto-negotiation mode.

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

Format
negotiation auto

undo negotiation auto

Parameters
None

Views
GE interface view

Default Level
2: Configuration level

Usage Guidelines
Usage Scenario

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

You can configure an interface to work in auto-negotiation mode only when

interfaces on both ends support the auto-negotiation mode.
● If interfaces on both ends support auto-negotiation and are required to work
in auto-negotiation mode, run the negotiation auto command.
● If one of the two interfaces does not support auto-negotiation or is not
required to work in auto-negotiation mode, run the undo negotiation auto
command.

Precautions

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 567

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

● For details about the auto-negotiation configuration supported by Ethernet

interfaces, see Overview of Ethernet Interfaces in the Configuration Guide-
Overview of Ethernet Interfaces.
● By default, GE interfaces do not support flow control auto-negotiation.

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

6.2.11 port-down holdoff-timer

Function
The port-down holdoff-timer command sets the delay time for an interface to
report the Down event.
The undo port-down holdoff-timer command configures an interface to report
the Down event immediately.
By default, an interface reports the Down event immediately.

Format
port-down holdoff-timer holdoff-timer
undo port-down holdoff-timer

Parameters
Parameter Description Value

holdoff-timer Specifies the delay time The value is an integer

for an interface to report that ranges from 50 to
the Down event. 3000, in milliseconds.

Views
GE interface view, MultiGE interface view, XGE interface view

Default Level
2: Configuration level

Usage Guidelines
When an interface becomes Down, services on the interface are interrupted even
if this interface becomes Up soon. To prevent services from being interrupted, set
the delay in reporting a Down event on the interface so that the system still
considers that this interface is in Up state within the delay time.

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 568

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Example
# Set the delay time for an interface to report the Down event to 100 ms.
<HUAWEI> system-view
[HUAWEI] interface gigabitEthernet 0/0/1
[HUAWEI-GigabitEthernet 0/0/1] port-down holdoff-timer 100

6.2.12 port-isolate enable

Function
The port-isolate enable command enables port isolation.
The undo port-isolate enable command disables port isolation.
By default, port isolation is disabled.

NOTE

Only the AD9431DN-24X support this function.

Format
port-isolate enable [ group group-id ]
undo port-isolate enable [ group group-id ]

Parameters
Parameter Description Value

group group-id Specifies the ID of a port The value is an integer

isolation group. that ranges from 1 to 64.

Views
GE interface view, XGE interface view, port group view

Default Level
2: Configuration level

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

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 569

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

● After port isolation is configured, ports are isolated at Layer 2 but can
communicate at Layer 3 by default. To configure both Layer 2 isolation and
Layer 3 isolation, run the port-isolate mode all command.
● Interfaces in a port isolation group are isolated from each other, but
interfaces in different port isolation groups can communicate. If group-id is
not specified, interfaces are added to port isolation group 1 by default.

Example
# Enable port isolation on GE0/0/1.
<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] port-isolate enable group 1

6.2.13 port-isolate mode

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

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

NOTE

Only the AD9431DN-24X support this function.

Format
port-isolate mode { l2 | all }

Parameters
Parameter Description Value

l2 Indicates that ports are -

isolated at Layer 2 but
can communicate at
Layer 3.

all Indicates that ports are -

isolated at both Layer 2
and Layer 3.

Views
System view

Default Level
2: Configuration level

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 570

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Usage Guidelines
Usage Scenario

To disable members in a port isolation group from communicating at Layer 2 but

allow them to access public resources, such as printer and server, run the port-
isolate mode command to set the port isolation mode to l2.

To disable members in a port isolation group from communicating at both Layer 2

and Layer 3, run the port-isolate mode command to set the port isolation mode
to all.

Precautions

● To isolate ports at both Layer 2 and Layer 3, run the port-isolate mode all
command.
● To isolate ports at Layer 2 but allow them to communicate at Layer 3, run the
port-isolate mode l2 command.

Example
# Configure Layer 2 isolation and Layer 3 communication.
<HUAWEI> system-view
[HUAWEI] port-isolate mode l2

6.2.14 speed

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

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

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

Format
speed { 10 | 100 | 1000 | 2500 | 5000 } *

undo speed

Parameters
Parameter Description Value

10 Indicates that the interface works -

at 10 Mbit/s.

100 Indicates that the interface works -

at 100 Mbit/s.

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 571

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Parameter Description Value

1000 Indicates that the interface works -

at 1000 Mbit/s.

2500 Indicates that the interface works -

at 2500 Mbit/s.

5000 Indicates that the interface works -

at 5000 Mbit/s.

NOTE

Only MultiGE interfaces support the parameters 2500/5000.

The maximum rate configured for an Ethernet interface cannot exceed the interface's
capability. For example, the maximum rate of a GE interface cannot be set to 2500 Mbit/s.

Views
GE interface view, MultiGE interface view

Default Level
2: Configuration level

Usage Guidelines
Usage Scenario
In non-auto negotiation mode, if interfaces on two connected devices work at
different rates, use the speed command to change the rates of the interfaces to
be the same so that the two devices can communicate.
Precautions
● If the remote interface does not support the auto negotiation mode, run the
undo negotiation auto command on the local interface to configure the
interface to work in non-auto negotiation mode. You can then change the
rate of the local interface to be the same as the rate of the remote interface
to ensure proper communication.

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

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 572

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

6.2.15 trap-threshold

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

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

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

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

Parameters
Parameter Description Value

input-rate Indicates inbound -

bandwidth.

output-rate Indicates outbound -

bandwidth.

bandwidth-in-use Specifies the bandwidth The value is an integer that

usage threshold for ranges from 1 to 100.
generating a trap.

resume-rate Specifies the bandwidth The value is an integer that

resume-threshold usage threshold for ranges from 1 to bandwidth-
clearing a trap. in-use. The default value is
bandwidth-in-use.

Views
GE interface view, XGE interface view, MultiGE interface view

Default Level
2: Configuration level

Usage Guidelines
Usage Scenario

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 573

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

The bandwidth usage represents the load on a device. If the bandwidth usage
exceeds the threshold, bandwidth of the device is insufficient for services and
needs expansion. For example, if the bandwidth usage exceeds 95%, an alarm is
generated to indicate that bandwidth resources are used up. Services may be
interrupted before system expansion. You can set the upper and lower thresholds
for bandwidth usage. When the bandwidth usage exceeds the lower threshold, the
system generates a log. When the bandwidth usage exceeds the upper threshold,
the system triggers an alarm.

NOTE

Outbound bandwidth usage = (Outbound interface rate/Outbound physical interface

bandwidth) x 100
Inbound bandwidth usage = (Inbound interface rate/Inbound physical interface bandwidth) x
100
The interface rate and bandwidth are expressed in bits per second.

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

The trap-threshold command sets the bandwidth usage threshold for generating
a trap. The trap-threshold with the following parameters provides various
functions:
● trap-threshold input-rate bandwidth-in-use resume-rate resume-threshold:
sets the inbound bandwidth usage threshold for generating a trap.
– If inbound bandwidth usage exceeds the threshold specified in
bandwidth-in-use, an hwIfMonitorInputRateRising trap is generated,
indicating that inbound bandwidth usage exceeds the configured
threshold.
– If inbound bandwidth usage falls below the threshold specified in
resume-threshold, an hwIfMonitorInputRateResume trap is generated,
indicating that inbound bandwidth usage falls between the configured
threshold for clearing a trap.
● trap-threshold output-rate bandwidth-in-use resume-rate resume-
threshold: sets the outbound bandwidth usage threshold for generating a
trap.
– If outbound bandwidth usage exceeds the threshold specified in
bandwidth-in-use, an hwIfMonitorOutputRateRising trap is generated,
indicating that outbound bandwidth usage exceeds the configured
threshold.
– If outbound bandwidth usage falls below the threshold specified in
resume-threshold, an hwIfMonitorOutputRateResume trap is generated,
indicating that outbound bandwidth usage falls between the configured
threshold for clearing a trap.
Precautions
● When the bandwidth usage exceeds the threshold for generating a trap, the
system generates a trap. When the bandwidth usage falls below the threshold
for clearing a trap, the system clears the trap.
● If the offset between the value of bandwidth-in-use and the value of resume-
threshold is too small, trap information may be frequently displayed.
● The log threshold must be lower than the trap threshold, providing efficient
protection for services. For example, when the inbound bandwidth usage

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 574

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

reaches 80%, a log is generated. If the inbound bandwidth usage continues to

increase and reaches 95%, a trap is generated. This ensures that a log is
generated for inbound bandwidth usage of 80%, and a trap is generated for
inbound bandwidth usage of 95%. Either the log or the trap prompts for a
bandwidth increase, preventing service interruption.

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

# Configure GE0/0/1 to generate a trap when the outbound bandwidth usage

exceeds 80% and clear the trap when the outbound bandwidth usage falls below
60%.
<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] trap-threshold output-rate 80 resume-rate 60

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

Format
virtual-cable-test

Parameters
None

Views
GE interface view, XGE interface view, multi-GE interface view

Default Level
3: Management level

Usage Guidelines
Usage Scenario
You can run the virtual-cable-test command to check whether the cable works
properly. According to the command output, you can locate and rectify cable
faults.
● If the cable works properly, the total length of the cable is displayed.
● If the cable cannot work properly, the distance between the interface and the
failure point is displayed.

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 575

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Precautions
● Only the electrical interface or combo interface working as an electrical
interface supports the VCT function.
● Running the virtual-cable-test command may affect services on the interface
in a short period of time.
● The VCT function is supported only when the local and peer ends work at
1000 Mbit/s in auto-negotiation mode. The VCT function is supported only by
the R230D when its interfaces work at 100 Mbit/s in auto-negotiation mode.
● When the cable works properly, the VCT function is not supported by all or
some interfaces of the following APs. The cable length is 0 in the command
output of interfaces.
– AD9431DN-24X, AP4030DN and R230D: all interfaces
– AD9430DN-24: GE0 through GE5 and GE7 through GE23
– AP7050DN-E: GE0
– AP8082DN and AP8182DN: all GE interfaces
– AD9430DN-12: all interfaces except GE1, GE3, GE12, and GE13
– AP8030DN and AP4030TN: GE0
– AP5030DN: GE1
● If the cable cannot work properly, the distance between the interface and the
failure point is displayed.
● The test result is only for reference and may be inaccurate for cables of some
vendors.
● The test result is related to the signal attenuation of a cable. When the cable
length is shorter than 3 m, the signal attenuation mostly results from the
connector rather than the cable itself. Therefore, the test result is inaccurate.
● VCT detection cannot be performed on multiple interfaces of the device at the
same time.
● For wire sequence of cables, see Testing the Connection of Assembled Cables
in the Hardware Installation and Maintenance Guide.

Example
# Test the cable connected to GE0/0/1.
<HUAWEI> system-view
[HUAWEI] interface gigabitethernet 0/0/1
[HUAWEI-GigabitEthernet0/0/1] virtual-cable-test
Warning: The command will stop service for a while. Continue? [Y/N]y
Pair A length: 4 meter(s)
Pair B length: 4 meter(s)
Pair C length: 4 meter(s)
Pair D length: 4 meter(s)
Pair A state: OK
Pair B state: OK
Pair C state: OK
Pair D state: OK

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 576

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Table 6-10 Description of the virtual-cable-test command output

Item Description

Pair A/B/C/D Four pairs of circuits in a network cable.

Pair A length Length of a network cable.

● The length is the distance between
the interface and the failure point if a
failure occurs.
● The length is the actual length of the
cable when the cable works properly.
The test result is for reference only.

Pair A state Network cable status:

● OK: indicates that the circuit pair is
terminated normally.
● Open: indicates that the circuit pair is
not terminated.
● Short: indicates that the circuit pair is
short-circuited.
● Crosstalk: indicates that the circuit
pairs interfere with each other.
● Unknown: indicates that the circuit
pair has an unknown fault.

6.3 Logical Interface Configuration Commands

6.3.1 display interface loopback

Function
Using the display interface loopback command, you can view the status of a
loopback interface.

Format
display interface loopback [ loopback-number | main ]

Parameters
Parameter Description Value

loopback- Specifies the number of a loopback interface. -

number
If loopback-number is not specified, the status of all
loopback interfaces is displayed.

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 577

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Parameter Description Value

main Displays status and traffic statistics about a Loopback -

interface.
A Loopback interface has no sub-interfaces. Status and
traffic statistics about a Loopback interface are
displayed whether you specify the main parameter or
not.

Views
All views

Default Level
1: Monitoring level

Usage Guidelines
In the scenario where you need to monitor the status of an interface or locate an
interface fault, you can use the display interface loopback command to collect
the statistics on the interface including the status. Through the displayed
information, you can collect the traffic statistics and troubleshoot the interface.

Example
# Display the status of a specified loopback interface.
<HUAWEI> display interface loopback 6
LoopBack6 current state : UP
Line protocol current state : UP (spoofing)
Description:HUAWEI, AP Series, LoopBack6 Interface
Route Port,The Maximum Transmit Unit is 1500
Internet Address is 10.10.1.1/32
Physical is Loopback
Current system time: 2011-12-12 10:14:21+08:00
Last 300 seconds input rate 0 bits/sec, 0 packets/sec
Last 300 seconds output rate 0 bits/sec, 0 packets/sec
Realtime 0 seconds input rate 0 bits/sec, 0 packets/sec
Realtime 0 seconds output rate 0 bits/sec, 0 packets/sec
Input: 0 bytes
Output:0 bytes
Input bandwidth utilization : 0%
Output bandwidth utilization : 0%

Table 6-11 Description of the display interface loopback command output

Item Description

LoopBack6 current Physical status of a loopback interface. The physical

state status of a loopback interface is always Up after the
loopback interface is created.

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 578

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Item Description

Line protocol current Link layer protocol status of a loopback interface. The
state link layer protocol status of a loopback interface is
always Up after the loopback interface is created.

Description Indicates the description of the interface, which can be

set by using the description command.

Route Port,The Indicates the maximum transmission unit (MTU). The

Maximum Transmit default MTU is 1500 bytes. Packets longer than the
Unit is 1500 MTU are fragmented before being transmitted. If
fragmentation is not allowed, the packet is discarded.

Internet Address is Indicates the IP address of the interface.

Physical is Information about the physical layer of a loopback

interface.

Current system time Indicates the current system time.

Last 300 seconds Indicates the rates for sending and receiving the bytes
input rate and the packets by the interface in the last five minutes.
Last 300 seconds
output rate

Realtime 0 seconds Indicates the real-time rates of sending and receiving

input rate the bytes and the packets.
Realtime 0 seconds It refers to the interval between two display commands
output rate that are run on the same interface. The maximum value
is the statistical interval displayed in the previous piece
of information. This entry is displayed only when
information about a logical interface is viewed.

Input Indicates the total number of packets and the total

number of bytes received by the interface.

Output Indicates the total number of packets and the total

number of bytes sent by the interface.

Input bandwidth Indicates the percentage of the rate for receiving

utilization packets to the total bandwidth.

Output bandwidth Indicates the percentage of the rate for sending packets
utilization to the total bandwidth.

6.3.2 display interface null

Function
The display interface null command displays the status of a null interface.

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 579

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Format
display interface null [ 0 | main ]

Parameters
Parameter Description Value

0 Specifies the number of the null interface. The value can

be 0 only.

main Displays status and traffic statistics about a Null -

interface.
A Null interface has no sub-interfaces. Status and
traffic statistics about a Null interface are displayed
whether you specify the main parameter or not.

Views
All views

Default Level
1: Monitoring level

Usage Guidelines
Usage Scenario
The display interface null command displays the status of a null interface. The
interface status information includes: the physical status, link layer protocol status,
description, MTU, current system time, last time statistics about the null interface
are cleared, incoming and outgoing packet rates in bit/s and pps, total numbers of
packets and bytes received and sent by the null interface, and percentages of the
rates for receiving and sending packets to the total bandwidth.
Precautions
There is only one null interface, namely, NULL 0.

Example
# Display the status of Null 0 interface.
<HUAWEI> display interface null 0
NULL0 current state : UP
Line protocol current state : UP (spoofing)
Description:HUAWEI, AP Series, NULL0 Interface
Route Port,The Maximum Transmit Unit is 1500
Internet protocol processing : disabled
Physical is NULL DEV
Current system time: 2011-12-12 10:28:12+08:00
Last 300 seconds input rate 0 bits/sec, 0 packets/sec
Last 300 seconds output rate 0 bits/sec, 0 packets/sec
Realtime 0 seconds input rate 0 bits/sec, 0 packets/sec

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 580

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Realtime 0 seconds output rate 0 bits/sec, 0 packets/sec

Input: 0 bytes
Output:0 bytes
Input bandwidth utilization : 0%
Output bandwidth utilization : 0%

Table 6-12 Description of the display interface null command output

Item Description

NULL0 current state Physical status of the null interface.

The physical status of the null interface is always Up.

Line protocol current Link layer protocol status of the interface. The
state protocol status of the null interface is always Up.

Description Description of the interface, which can be set by

using the description command.

Route Port,The The MTU is 1500 bytes.

Maximum Transmit Unit
is 1500

Internet protocol Whether Internet protocol processing is enabled.

processing ● enabled: The Internet protocol processing is
enabled.
● disabled: The Internet protocol processing is
disabled.

Physical is NULL DEV The interface is null.

Current system time Current system time.

Last 300 seconds input Rates for sending and receiving the bytes and the
rate packets by the interface in the last five minutes.
Last 300 seconds output
rate

Realtime 0 seconds Real-time rates of sending and receiving the bytes

input rate and the packets.
Realtime 0 seconds It refers to the interval between two display
output rate commands that are run on the same interface. The
maximum value is the statistical interval displayed in
the previous piece of information. This entry is
displayed only when information about a logical
interface is viewed.

Input Total number of packets and the total number of

bytes received by the interface.

Output Total number of packets and the total number of

bytes sent by the interface.

Input bandwidth Percentage of the rate for receiving packets to the

utilization total bandwidth.

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 581

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Item Description

Output bandwidth Percentage of the rate for sending packets to the

utilization total bandwidth.

6.3.3 interface loopback

Function
The interface loopback command creates a loopback interface.

The undo interface loopback command deletes a loopback interface.

Format
interface loopback loopback-number

undo interface loopback loopback-number

Parameters
Parameter Description Value

loopback-number Specifies the number of a The value is an integer that

loopback interface. ranges from 0 to 1023.

Views
System view

Default Level
2: Configuration level

Usage Guidelines
A loopback interface is always Up at the physical layer and link layer unless it is
manually shut down.

The IP address of a loopback interface is usually specified as the source address of

packets.

Example
# Create loopback interface 5.
<HUAWEI> system-view
[HUAWEI] interface loopback 5
[HUAWEI-LoopBack5]

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 582

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

6.3.4 interface null

Function
Using the interface null command, you can enter the null interface view.

Format
interface null 0

Parameters
None

Views
System view

Default Level
2: Configuration level

Usage Guidelines
Usage Scenario

The Null0 interface never forwards or accepts any traffic. All traffic sent to this
interface is directly discarded. Unnecessary traffic can be sent to the Null0
interface to avoid using ACLs.

Precautions

There is only one null interface, named null0. This interface is always Up and
cannot be shut down or deleted.

Example
# Enter the view of the Null0 interface.
<HUAWEI> system-view
[HUAWEI] interface null 0
[HUAWEI-NULL0]

6.3.5 management-interface

Function
The management-interface command configures a VLANIF or dialer interface as
a management interface.

The undo management-interface command cancels the management interface

configuration.

By default, an interface is not configured as a management interface.

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 583

Fat AP and Cloud AP
Command Reference 6 Interface Management Commands

Format
management-interface
undo management-interface

Parameters
None

Views
VLANIF interface view, dialer interface view

Default Level
2: Configuration level

Usage Guidelines
Usage Scenario
To manage a device through a VLANIF or dialer interface, run this command to
configure this interface as a management interface.
Precautions
If no interface on a device is configured as a management interface, the device
can be managed through all interfaces. Once an interface on the device is
configured as a management interface, you cannot manage the device through
the other interfaces.
A maximum of four interfaces can be configured as management interfaces.
If an interface is specified as the management interface using the management-
interface command, it will still be considered as the management interface after
the management-plane isolate enable command is executed.

Example
# Configure VLANIF 10 as a management interface.
<HUAWEI> system-view
[HUAWEI] interface vlanif 10
[HUAWEI-Vlanif10] management-interface

Issue 08 (2021-11-15) Copyright © Huawei Technologies Co., Ltd. 584