- Table of Contents
-
- 03-Layer 2 Command Reference
- 00-Preface
- 01-Ethernet Interface Commands
- 02-Loopback and Null Interface Commands
- 03-MAC Address Table Commands
- 04-Spanning Tree Commands
- 05-Loopback Detection Commands
- 06-VLAN Commands
- 07-Layer 2 Forwarding Commands
- 08-PPP Commands
- 09-Ethernet Link Aggregation Commands
- 10-DCC Commands
- Related Documents
-
Title | Size | Download |
---|---|---|
09-Ethernet Link Aggregation Commands | 109.16 KB |
Ethernet link aggregation configuration commands
display link-aggregation load-sharing mode
display link-aggregation member-port
display link-aggregation summary
display link-aggregation verbose
link-aggregation load-sharing mode
link-aggregation port-priority
The device supports only Layer 2 aggregation groups and aggregate interfaces.
The following matrix shows the feature and hardware compatibility:
Hardware series |
Model |
Ethernet link aggregation compatibility |
WA4300 series |
WA4320-ACN |
No |
WA4320-ACN-PI |
No |
|
WA4320H-ACN |
No |
|
WA4320i-ACN |
Yes |
|
WA4600 series |
WA4620i-ACN/WA4620E-ACN |
Yes |
default
Use default to restore the default settings for an aggregate interface.
Syntax
default
Views
Layer 2 aggregate interface view
Default command level
2: System level
Usage guidelines
|
CAUTION: The default command might interrupt ongoing network services. Make sure you are fully aware of the impacts of this command when you perform it on a live network. |
This command might fail to restore the default settings for some commands for reasons such as command dependencies and system restrictions. You can identify these commands by using the display this command in interface view, and then use their undo forms or follow the command reference to individually restore their default settings. If your restoration attempt still fails, follow the error message to resolve the problem.
Examples
# Restore the default settings for Layer 2 aggregate interface Bridge-Aggregation 1.
<Sysname> system-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1] default
This command will restore the default settings. Continue? [Y/N]:y
description
Use description to set a description for an interface. For example, you can include information such as the purpose of the interface for the ease of management.
Use undo description to restore the default setting.
Syntax
description text
undo description
Default
The description of an interface is interface-name Interface. For example, the default description of Bridge-Aggregation1 is Bridge-Aggregation1 Interface.
Views
Layer 2 aggregate interface view
Default command level
2: System level
Parameters
text: Specifies the interface description, a string of 1 to 80 characters.
Examples
# Set the description of Layer 2 aggregate interface Bridge-Aggregation 1 to connect to the lab.
<Sysname> system-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1] description connect to the lab
display interface
Use display interface to display aggregate interface information.
Syntax
display interface bridge-aggregation [ interface-number ] [ brief [ down ] ] [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1: Monitor level
Parameters
bridge-aggregation: Displays information about Layer 2 aggregate interfaces.
interface-number: Specifies an aggregate interface number. The value for the interface-number argument can only be 1.
brief: Displays brief interface information. If you do not specify this keyword, this command displays detailed interface information.
down: Displays information about interfaces in DOWN state and the causes. If you do not specify this keyword, this command displays information about interfaces in all states.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
# Display information about Layer 2 aggregate interface Bridge-Aggregation 1.
<Sysname> display interface bridge-aggregation 1
Bridge-Aggregation1 current state: DOWN
IP Packet Frame Type: PKTFMT_ETHNT_2, Hardware Address: 000f-e207-f2e0
Description: Bridge-Aggregation1 Interface
Unknown-speed mode, unknown-duplex mode
Link speed type is autonegotiation, link duplex type is autonegotiation
PVID: 1
Port link-type: access
Tagged VLAN ID : none
Untagged VLAN ID : 1
Last clearing of counters: Never
# Display brief information about Layer 2 aggregate interface Bridge-Aggregation 1.
<Sysname> display interface bridge-aggregation 1 brief
The brief information of interface(s) under bridge mode:
Link: ADM - administratively down; Stby - standby
Speed or Duplex: (a)/A - auto; H - half; F - full
Type: A - access; T - trunk; H - hybrid
Interface Link Speed Duplex Type PVID Description
BAGG1 DOWN auto A A 1
# Display information about all Layer 2 aggregate interfaces in DOWN state.
<Sysname> display interface bridge-aggregation brief down
The brief information of interface(s) under bridge mode:
Link: ADM - administratively down; Stby - standby
Interface Link Cause
BAGG1 DOWN Not connected
Table 1 Command output
Field |
Description |
Bridge-Aggregation1 current state |
Layer 2 aggregate interface status: · DOWN (Administratively)—The interface is administratively shut down with the shutdown command. · DOWN—The interface is administratively up but physically down (possibly because no physical link is present or the link is faulty). · UP—The interface is both administratively and physically up. |
Unknown-speed mode, unknown-duplex mode |
The interface speed and duplex mode are unknown. |
PVID |
Port VLAN ID. |
Last clearing of counters |
Time when the reset counters interface command was last used to clear the interface statistics. Never indicates the reset counters interface command has never been used on the interface after the device's startup. |
The brief information of interface(s) under bridge mode |
Brief information about Layer 2 aggregate interfaces. |
Link: ADM - administratively down; Stby - standby |
Link status: · ADM—The interface has been administratively shut down. To recover its physical layer state, execute the undo shutdown command. · Stby—The interface is operating as a backup interface. |
Speed or Duplex: (a)/A - auto; H - half; F - full |
If the speed of an interface is automatically negotiated, its speed attribute includes the auto negotiation flag, letter a in parentheses. If the duplex mode of an interface is automatically negotiated, its duplex mode attribute includes the auto negotiation flag, letter a in parentheses or a capital A. Letter H indicates the half duplex mode, and letter F indicates the full duplex mode. |
Type: A - access; T - trunk; H - hybrid |
Link type options for Ethernet interfaces. |
Interface |
Abbreviated interface name. |
Link |
Physical link state of the interface. |
Speed |
Interface speed, in bps. |
Cause |
Cause of a DOWN physical link. |
display link-aggregation load-sharing mode
Use display link-aggregation load-sharing mode to display global or group-specific link-aggregation load sharing criteria.
Syntax
display link-aggregation load-sharing mode [ interface [ bridge-aggregation interface-number ] ] [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1: Monitor level
Parameters
bridge-aggregation: Displays the load sharing criteria of the aggregation group corresponding to the specified Layer 2 aggregate interface.
interface-number: Specifies an aggregate interface number. The value for the interface-number argument can only be 1.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Usage guidelines
To display the global link-aggregation load sharing criteria, run the command without the interface keyword.
To display all group-specific load sharing criteria, run the command with the interface keyword, but do not specify a particular interface.
To display the load sharing criteria of a particular aggregation group, use the command with the aggregate interface specified.
The bridge-aggregation keyword is available only when Layer 2 aggregate interfaces exist on the device.
Examples
# Display the default global link-aggregation load sharing criteria.
<Sysname> display link-aggregation load-sharing mode
Link-Aggregation Load-Sharing Mode:
Layer 2 traffic: destination-mac address, source-mac address
# Display the configured global link-aggregation load sharing criteria.
<Sysname> display link-aggregation load-sharing mode
Link-Aggregation Load-Sharing Mode:
destination-mac address, source-mac address
# Display the default link-aggregation load sharing criteria of the aggregation group corresponding to Layer 2 aggregate interface Bridge-Aggregation 1.
<Sysname> display link-aggregation load-sharing mode interface bridge-aggregation 1
Bridge-Aggregation1 Load-Sharing Mode:
Layer 2 traffic: destination-mac address, source-mac address
# Display the configured link-aggregation load sharing criteria of the aggregation group corresponding to Layer 2 aggregate interface Bridge-Aggregation 1.
<Sysname> display link-aggregation load-sharing mode interface bridge-aggregation 1
Bridge-Aggregation1 Load-Sharing Mode:
destination-mac address, source-mac address
Table 2 Command output
Field |
Description |
Link-Aggregation Load-Sharing Mode |
Global link-aggregation load sharing criteria. · By default, the link-aggregation load sharing criteria for Layer 2 traffic are displayed. · If you have configured the global link-aggregation load sharing criteria, the configured criteria are displayed. |
Bridge-Aggregation1 Load-Sharing Mode |
Link-aggregation load sharing criteria of the aggregation group corresponding to the aggregate interface Bridge-Aggregation 1. · By default, the global link-aggregation load sharing criteria are displayed. · If you have configured link-aggregation load sharing criteria especially for this aggregation group, the configured criteria are displayed. |
Layer 2 traffic: destination-mac address, source-mac address |
Default link-aggregation load sharing criteria for Layer 2 traffic. In this sample output, the criteria are the source and destination MAC addresses of packets. |
destination-mac address, source-mac address |
User-configured link-aggregation load sharing criteria. In this sample output, the criteria are the source and destination MAC addresses of packets. |
display link-aggregation member-port
Use display link-aggregation member-port to display detailed link aggregation information for the specified member ports. If no port is specified, this command displays detailed link aggregation information for all member ports.
Syntax
display link-aggregation member-port [ interface-list ] [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1: Monitor level
Parameters
interface-list: Specifies a list of link aggregation member ports, in the format interface-type interface-number1 [ to interface-type interface-number2 ], where interface-type interface-number specifies an interface by its type and number.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Usage guidelines
Only the port number and operational key of a member port in a static aggregation group are displayed, because the aggregation group is not aware of the partner's information.
Examples
# Display detailed link aggregation information for GigabitEthernet 1/0/1, a member port of a static aggregation group.
<Sysname> display link-aggregation member-port GigabitEthernet 1/0/1
GigabitEthernet1/0/1:
Aggregation Interface: Bridge-Aggregation1
Port Number: 1
Port Priority: 32768
Oper-Key: 1
Table 3 Command output
Field |
Description |
Aggregation Interface |
Aggregate interface to which the member port belongs. |
Port Priority |
Aggregation priority of the port. |
Oper-key |
Operational key. |
display link-aggregation summary
Use display link-aggregation summary to display the summary information for all aggregation groups.
Syntax
display link-aggregation summary [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Usage guidelines
The information about the remote system for a static link aggregation group may be displayed as none or may not be displayed, because the aggregation group is not aware of the partner's information.
Examples
# Display the summary information for all aggregation groups.
<Sysname> display link-aggregation summary
Aggregation Interface Type:
BAGG -- Bridge-Aggregation
Loadsharing Type: Shar -- Loadsharing, NonS -- Non-Loadsharing
AGG Select Unselect Share
Interface Ports Ports Type
--------------------------------------------------------------------------------
BAGG1 1 1 Shar
Table 4 Command output
Field |
Description |
Aggregation Interface Type |
Aggregate interface type. BAGG indicates Layer 2 aggregate interface. |
Loadsharing Type |
Load sharing type: · Shar—Load sharing. · NonS—Non-load sharing. |
AGG Interface |
Type and number of the aggregate interface. |
Select Ports |
Total number of Selected ports. |
Unselect Ports |
Total number of Unselected ports. |
Share Type |
Load sharing type. |
display link-aggregation verbose
Use display link-aggregation verbose to display detailed information about the aggregation groups corresponding to the aggregate interfaces.
Syntax
display link-aggregation verbose [ bridge-aggregation [ interface-number ] ] [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1: Monitor level
Parameters
bridge-aggregation: Displays detailed information about the Layer 2 aggregation groups corresponding to Layer 2 aggregate interfaces.
interface-number: Specifies an aggregate interface number. The value for the interface-number argument can only be 1.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Usage guidelines
To display the information about a specific Layer 2 aggregation group, use the display link-aggregation verbose bridge-aggregation interface-number command.
To display the information about all Layer 2 groups, use the display link-aggregation verbose bridge-aggregation command.
To display the information about all aggregation groups, use the display link-aggregation verbose command.
The bridge-aggregation keyword is available only when Layer 2 aggregate interfaces exist on the device.
Examples
# Display detailed information about the aggregation group corresponding to Layer 2 aggregate interface Bridge-Aggregation 1, which is a static aggregation group.
<Sysname> display link-aggregation verbose bridge-aggregation 1
Loadsharing Type: Shar -- Loadsharing, NonS -- Non-Loadsharing
Port Status: S -- Selected, U -- Unselected
Aggregation Interface: Bridge-Aggregation1
Aggregation Mode: Static
Loadsharing Type: Shar
Port Status Priority Oper-Key
--------------------------------------------------------------------------------
GE1/0/1 U 32768 1
GE1/0/2 U 32768 1
Table 5 Command output
Field |
Description |
Loadsharing Type |
Load sharing type: · Shar—Load sharing. · NonS—Non-load sharing. |
Port Status |
Port state: · S—Selected. · U—Unselected. |
Aggregation Interface |
Name of the aggregate interface. |
Aggregation Mode |
Mode of the aggregation group. |
Port |
Port type and number. |
Status |
Port state: Selected or Unselected. |
Priority |
Port aggregation priority. |
Oper-Key |
Operational key. |
enable snmp trap updown
Use enable snmp trap updown to enable linkUp/linkDown trap generation for the aggregate interface.
Use undo enable snmp trap updown to disable linkUp/linkDown trap generation for the aggregate interface.
Syntax
enable snmp trap updown
undo enable snmp trap updown
Default
LinkUp/linkDown trap generation is enabled for an aggregate interface.
Views
Layer 2 aggregate interface view
Default command level
2: System level
Usage guidelines
For an aggregate interface to generate linkUp/linkDown traps when its link state changes, you must enable linkUp/linkDown trap generation globally with the snmp-agent trap enable [ standard [ linkdown | linkup ] * ] command.
For more information about the snmp-agent trap enable command, see Network Management and Monitoring Command Reference.
Examples
# Enable linkUp/linkDown trap generation on Layer 2 aggregate interface Bridge-Aggregation 1.
<Sysname> system-view
[Sysname] snmp-agent trap enable
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1] enable snmp trap updown
interface bridge-aggregation
Use interface bridge-aggregation to create a Layer 2 aggregate interface and enter the Layer 2 aggregate interface view.
Use undo interface bridge-aggregation to remove a Layer 2 aggregate interface.
Syntax
interface bridge-aggregation interface-number
undo interface bridge-aggregation interface-number
Views
System view
Default command level
2: System level
Parameters
interface-number: Specifies a Layer 2 aggregate interface number. The value for the interface-number argument can only be 1.
Usage guidelines
When you create a Layer 2 aggregate interface, a Layer 2 aggregation group with the same number is automatically created. If you remove the Layer 2 aggregate interface, you also remove the Layer 2 aggregation group, and any member ports will leave the aggregation group.
Examples
# Create Layer 2 aggregate interface Bridge-Aggregation 1 and enter its view.
<Sysname> system-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1]
link-aggregation load-sharing mode
Use link-aggregation load-sharing mode to configure the global or group-specific link-aggregation load sharing criteria.
Use undo link-aggregation load-sharing mode to restore the default setting.
Syntax
link-aggregation load-sharing mode { destination-ip | destination-mac | source-ip | source-mac }
undo link-aggregation load-sharing mode
Default
The global and group-specific link-aggregation load sharing criteria are source and destination MAC addresses.
Views
System view, Layer 2 aggregate interface view
Default command level
2: System level
Parameters
destination-ip: Performs load sharing in link aggregation groups based on destination IP address.
destination-mac: Performs load sharing in link aggregation groups based on destination MAC address.
source-ip: Performs load sharing in link aggregation groups based on source IP address.
source-mac: Performs load sharing in link aggregation groups based on source MAC address.
Usage guidelines
The load sharing criteria that you configure will overwrite the previous criteria.
If unsupported load sharing criteria are configured, an error prompt will appear.
Examples
# Configure the source MAC address and destination MAC address as the global link-aggregation load sharing criteria.
<Sysname> system-view
[Sysname] link-aggregation load-sharing mode source-mac destination-mac
# Configure the destination MAC address as the load sharing criterion specific to the link aggregation group of aggregate interface Bridge-Aggregation 1.
<Sysname> system-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1] link-aggregation load-sharing mode destination-mac
link-aggregation port-priority
Use link-aggregation port-priority to set the aggregation priority of a port.
Use undo link-aggregation port-priority to restore the default setting.
Syntax
link-aggregation port-priority port-priority
undo link-aggregation port-priority
Default
The aggregation priority of a port is 32768.
Views
Ethernet interface view
Default command level
2: System level
Parameters
port-priority: Specifies a port aggregation priority, ranging from 0 to 65535. The smaller the value, the higher the port aggregation priority.
Usage guidelines
When the number of ports eligible for becoming Selected ports exceeds the maximum number of Selected ports allowed in an aggregation group, changing the aggregation priority of a port may affect the aggregation state of the ports in the aggregation group.
Examples
# Set the aggregation priority of port GigabitEthernet 1/0/1 to 64.
<Sysname> system-view
[Sysname] interface GigabitEthernet 1/0/1
[Sysname-GigabitEthernet1/0/1] link-aggregation port-priority 64
port link-aggregation group
Use port link-aggregation group to assign the Ethernet interface to the specified aggregation group.
Use undo port link-aggregation group to remove the Ethernet interface from the aggregation group to which it belongs.
Syntax
port link-aggregation group number
undo port link-aggregation group
Views
Ethernet interface view
Default command level
2: System level
Parameters
number: Specifies the number of the aggregate interface corresponding to an aggregation group. The value for the number argument can only be 1.
Usage guidelines
A Layer 2 Ethernet interface can be assigned to a Layer 2 aggregation group only.
An Ethernet interface can belong to only one aggregation group.
Examples
# Assign Layer 2 Ethernet interface GigabitEthernet 1/0/1 to Layer 2 aggregation group 1.
<Sysname> system-view
[Sysname] interface GigabitEthernet 1/0/1
[Sysname-GigabitEthernet1/0/1] port link-aggregation group 1
reset counters interface
Use reset counters interface to clear the statistics of the specified aggregate interface or interfaces.
Syntax
reset counters interface [ bridge-aggregation [ interface-number ] ]
Views
User view
Default command level
2: System level
Parameters
bridge-aggregation: Clears statistics for Layer 2 aggregate interfaces.
interface-number: Specifies an aggregate interface number. The range for the interface-number argument can only be 1.
Usage guidelines
Before collecting statistics for a Layer 2 aggregate interface within a specific period, clear the existing statistics of the interface.
· If no keyword or argument is specified, the command clears the statistics of all interfaces in the system.
· If only the bridge-aggregation keyword is specified, the command clears the statistics of all Layer 2 aggregate interfaces.
· If the bridge-aggregation interface-number option is specified, the command clears the statistics of the specified Layer 2 aggregate interface.
· The bridge-aggregation keyword is available only when Layer 2 aggregate interfaces exist on the device.
Examples
# Clear the statistics of Layer 2 aggregate interface Bridge-Aggregation 1.
<Sysname> reset counters interface bridge-aggregation 1
shutdown
Use shutdown to shut down an aggregate interface.
Use undo shutdown to bring up an aggregate interface.
Syntax
shutdown
undo shutdown
Default
Aggregate interfaces are up.
Views
Layer 2 aggregate interface view
Default command level
2: System level
Examples
# Shut down Layer 2 aggregate interface Bridge-Aggregation 1.
<Sysname> system-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1] shutdown