02-Link Aggregation Commands
Chapters Download (93.06 KB)
Table of Contents
1 Link Aggregation Configuration Commands
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
Syntax
description text
undo description
View
Layer 2 aggregate interface view
Default Level
2: System level
Parameters
text: Description of an Ethernet interface, a string of 1 to 80 characters. Currently, the device supports the following types of characters or symbols: standard English characters (numbers and case-sensitive letters), special English characters, spaces, and other characters or symbols that conform to the Unicode standard.
l A port description can be the mixture of English characters and other Unicode characters. The mixed description cannot exceed the specified length.
l To use a type of Unicode characters or symbols in a port description, you need to install the corresponding Input Method Editor (IME) and log in to the device through remote login software that supports this character type.
l Each Unicode character or symbol (non-English characters) takes the space of two regular characters. When the length of a description string reaches or exceeds the maximum line width on the terminal software, the software starts a new line, possibly breaking a Unicode character into two. As a result, garbled characters may be displayed at the end of a line.
Description
Use the description command to set the description of the current interface.
Use the undo description command to restore the default.
By default, the description of an interface is interface-name Interface, such as Bridge-Aggregation1 Interface.
Examples
# Set the description of interface Bridge-aggregation 1 to link-aggregation interface.
<Sysname> system-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1] description link-aggregation interface
Syntax
display lacp system-id
View
Any view
Default Level
1: Monitor level
Parameters
None
Description
Use the display lacp system-id command to display the system ID of the local system (that is, the actor). The system ID comprises the system LACP priority and the system MAC address.
You can use the lacp system-priority command to change the LACP priority of the local system. When you do that, the LACP priority value you specify in the command is in decimal format. However, it is displayed as a hexadecimal value with the display lacp system-id command.
Related commands: lacp system-priority.
Examples
# Display the local system ID.
<Sysname> display lacp system-id
Actor System ID: 0x8000, 00e0-fc00-0100
Table 1-1 display lacp system-id command output description
|
Field |
Description |
|
Actor System ID: 0x8000, 00e0-fc00-0100 |
The local system ID, which comprises the LACP system priority (0x8000 in this sample output) and the system MAC address (00e0-fc00-0100 in this sample output). |
Syntax
display link-aggregation load-sharing mode
View
Any view
Default Level
1: Monitor level
Parameters
None
Description
Use the display link-aggregation load-sharing mode command to display load sharing mode for link aggregation groups.
Examples
# Display the default global link aggregation load sharing mode.
<Sysname> display link-aggregation load-sharing mode
Link-Aggregation Load-Sharing Mode:
Layer 2 traffic: destination-mac address, source-mac address
Layer 3 traffic: destination-mac address, source-mac address,
destination-ip address, source-ip address
# Display the configured global link aggregation load sharing mode.
<Sysname> display link-aggregation load-sharing mode
Link-Aggregation Load-Sharing Mode:
destination-mac address, source-mac address
Table 1-2 display link-aggregation load-sharing mode command output description
|
Field |
Description |
|
Link-Aggregation Load-Sharing Mode |
Displays the global link aggregation load sharing mode. l By default, the link aggregation load sharing modes for Layer 2 traffic, Layer 3 traffic are displayed. l If you have configured a global load sharing mode, the configured mode is displayed. |
|
Layer 2 traffic: destination-mac address, source-mac address |
The default load sharing mode for Layer 2 traffic. In this sample output, it is based on source MAC address and destination MAC address. |
|
Layer 3 traffic: destination-ip address, source-ip address, destination-mac address, source-mac address |
The default load sharing mode for Layer 3 traffic. In this sample output, it is based on source IP address and destination IP address, destination-mac address, source-mac address. |
|
destination-mac address, source-mac address |
The user-configured link aggregation load sharing mode. In this sample output, it is based on source MAC address and destination MAC address. |
Syntax
display link-aggregation member-port [ interface-type interface-number [ to interface-type interface-number ] ]
View
Any view
Default Level
1: Monitor level
Parameters
interface-type interface-number: Port type and port number.
to: Specifies an interface range in the form of interface-type interface-number to interface-type interface-number, where the start interface number must be smaller than the end interface number. Note that both the start interface and the end interface are inclusive.
Description
Use the display link-aggregation member-port command to display the detailed link aggregation information of the specified interface(s) or all interfaces if no interface is specified.
For an interface in a static aggregation group, only its port number and operational key are displayed, because it is not aware of the information of the partner.
Examples
# Display the detailed link aggregation information of GigabitEthernet1/0/1, which is in a static aggregation group.
<Sysname> display link-aggregation member-port gigabitethernet 1/0/1
Flags: A -- LACP_Activity, B -- LACP_Timeout, C -- Aggregation,
D -- Synchronization, E -- Collecting, F -- Distributing,
G -- Defaulted, H -- Expired
GigabitEthernet1/0/1:
Aggregation Interface: Bridge-Aggregation1
Port Number: 1
Oper-Key: 1
# Display the detailed link aggregation information of GigabitEthernet1/0/2, which is in a dynamic aggregation group.
<Sysname> display link-aggregation member-port gigabitethernet 1/0/2
Flags: A -- LACP_Activity, B -- LACP_Timeout, C -- Aggregation,
D -- Synchronization, E -- Collecting, F -- Distributing,
G -- Defaulted, H -- Expired
GigabitEthernet1/0/2:
Aggregation Interface: Bridge-Aggregation10
Local:
Port Number: 2
Port Priority: 32768
Oper-Key: 2
Flag: {ACDEF}
Remote:
System ID: 0x8000, 000f-e267-6c6a
Port Number: 26
Port Priority: 32768
Oper-Key: 2
Flag: {ACDEF}
Received LACP Packets: 5 packet(s)
Illegal: 0 packet(s)
Sent LACP Packets: 7 packet(s)
Table 1-3 display link-aggregation member-port command output description
|
Field |
Description |
|
Flags |
One-octet LACP state flags field. From the least to the most significant bit, they are represented by A through H as follows: l A indicates whether LACP is enabled. 1 for enabled and 0 for disabled. l B indicates the timeout control value. 1 for short timeout, and 0 for long timeout. l C indicates whether the link is considered as aggregatable by the sending system. 1 for true, and 0 for false. l D indicates whether the link is considered as synchronized by the sending system. 1 for true, and 0 for false. l E indicates whether the sending system considers that collection of incoming frames is enabled on the link. 1 for true and 0 for false. l F indicates whether the sending system considers that distribution of outgoing frames is enabled on the link. 1 for true and 0 for false. l G indicates whether the receive state machine of the sending system is using default operational partner information. 1 for true and 0 for false. l H indicates whether the receive state machine of the sending system is in the expired state. 1 for true and 0 for false. If a flag bit is set to 1, the corresponding English letter that otherwise is not output is displayed. |
|
Aggregation Interface |
Aggregate interface to which the port belongs |
|
Local: Port Number Port Priority Oper-key Flag |
Information about the local end: l Port Number: Number of the port. l Port Priority: LACP priority of the port. l Oper-key: Operational key l Flag: LACP protocol state flag. |
|
Remote: System ID Port Number Port Priority Oper-key Flag |
Information about the remote end: l System ID: System ID of the remote end, comprising the system LACP priority and the system MAC address. l Port Number: Number of the port. l Port Priority: LACP priority of the port. l Oper-key: Operational key l Flag: LACP protocol state flag. |
|
Received LACP Packets |
Number of LACP packets received |
|
Illegal |
Number of illegal packets |
|
Sent LACP Packets |
Number of LACP packets sent |
Syntax
display link-aggregation summary
View
Any view
Default Level
1: Monitor level
Parameters
None
Description
Use the display link-aggregation summary command to display the summary information of all aggregation groups.
You may find out that information about the remote system for a static link aggregation group is either replaced by none or not displayed at all. This is normal because this type of aggregation group is not aware of its partner.
Examples
# Display the summary information of all aggregation groups.
<Sysname> display link-aggregation summary
Aggregation Interface Type:
BAGG -- Bridge-Aggregation, RAGG -- Route-Aggregation
Aggregation Mode: S -- Static, D -- Dynamic
Loadsharing Type: Shar -- Loadsharing, NonS -- Non-Loadsharing
Actor System ID: 0x8000, 000f-e267-6c6a
AGG AGG Partner ID Select Unselect Share
Interface Mode Ports Ports Type
-------------------------------------------------------------------------
BAGG1 S none 1 0 Shar
BAGG10 D 0x8000, 000f-e267-57ad 2 0 Shar
Table 1-4 display link-aggregation summary command output description
|
Field |
Description |
|
Aggregation Interface Type |
Aggregate interface type: l BAGG for a Layer 2 aggregate interface l RAGG for a Layer 3 aggregate interface |
|
Aggregation Mode |
Aggregation group type: l S for static link aggregation l D for dynamic aggregation |
|
Loadsharing Type |
Loadsharing type: l Shar for load sharing l NonS for non-load sharing |
|
Actor System ID |
Local system ID, which comprises the system LACP priority and the system MAC address |
|
AGG Interface |
Abbreviated name of the aggregate interface |
|
AGG Mode |
Aggregation group type |
|
Partner ID |
System ID of the partner, which comprises the system LACP priority and the system MAC address |
|
Select Ports |
The number of selected ports |
|
Unselect Ports |
The number of unselected ports |
|
Share Type |
Load sharing type |
Syntax
display link-aggregation verbose [ bridge-aggregation [ interface-number ] ]
View
Any view
Default Level
1: Monitor level
Parameters
bridge-aggregation: Displays detailed information about the Layer 2 aggregate groups corresponding to Layer 2 aggregate interfaces.
interface-number: Aggregate interface number. Note that the aggregate interface you specify must already exist.
Description
Use the display link-aggregation verbose command to display detailed information about the aggregation groups corresponding to the aggregate interfaces.
To display the information of a specific Layer 2 aggregate group, use the display link-aggregation verbose bridge-aggregation interface-number command.
To display the information of all Layer 2 aggregate groups, use the display link-aggregation verbose bridge-aggregation command.
To display the information of all aggregate groups, use the display link-aggregation verbose command.
Examples
# Display the detailed information of the aggregation group corresponding to Layer 2 aggregate interface Bridge-aggregation 10.
<Sysname> display link-aggregation verbose bridge-aggregation 10
Loadsharing Type: Shar -- Loadsharing, NonS -- Non-Loadsharing
Port Status: S -- Selected, U -- Unselected
Flags: A -- LACP_Activity, B -- LACP_Timeout, C -- Aggregation,
D -- Synchronization, E -- Collecting, F -- Distributing,
G -- Defaulted, H -- Expired
Aggregation Interface: Bridge-Aggregation10
Aggregation Mode: Dynamic
Loadsharing Type: Shar
System ID: 0x8000, 000f-e267-6c6a
Local:
Port Status Priority Oper-Key Flag
-------------------------------------------------------------------------
GE1/0/6 S 32768 2 {ACDEF}
GE1/0/12 S 32768 2 {ACDEF}
Remote:
Actor Partner Priority Oper-Key SystemID Flag
-------------------------------------------------------------------------
GE1/0/6 32 32768 2 0x8000, 000f-e267-57ad {ACDEF}
GE1/0/12 26 32768 2 0x8000, 000f-e267-57ad {ACDEF}
Table 1-5 display link-aggregation verbose command output description
|
Field |
Description |
|
Loadsharing Type |
Loadsharing type: l Shar for load sharing l NonS for non-load sharing |
|
Port Status |
Port state: Selected or unselected. |
|
Flags |
One-octet LACP state flags field. From the least to the most significant bit, they are represented by A through H as follows: l A indicates whether LACP is enabled. 1 for enabled and 0 for disabled. l B indicates the timeout control value. 1 for short timeout, and 0 for long timeout. l C indicates whether the link is considered as aggregatable by the sending system. 1 for true, and 0 for false. l D indicates whether the link is considered as synchronized by the sending system. 1 for true, and 0 for false. l E indicates whether the sending system considers that collection of incoming frames is enabled on the link. 1 for true and 0 for false. l F indicates whether the sending system considers that distribution of outgoing frames is enabled on the link. 1 for true and 0 for false. l G indicates whether the receive state machine of the sending system is using default operational partner information. 1 for true and 0 for false. l H indicates whether the receive state machine of the sending system is in the expired state. 1 for true and 0 for false. If a flag bit is set to 1, the corresponding English letter that otherwise is not output is displayed. |
|
Aggregation Interface |
Name of the aggregate interface |
|
Aggregation Mode |
Type of the aggregation group: Static for static aggregation, and Dynamic for dynamic aggregation. |
|
System ID |
Local system ID, which comprises the system LACP priority and the system MAC address. |
|
Local: Port Status Priority Oper-Key Flag |
Other information of the local end, including the member ports, port state, port LACP priority, operational key, and LACP protocol state flags. |
|
Remote: Actor Partner Priority Oper-Key SystemID Flag |
Detailed information about the remote end, including the corresponding local port, port ID, port LACP priority, operational key, system ID, and LACP protocol state flags |
Syntax
enable snmp trap updown
undo enable snmp trap updown
View
Layer 2 aggregate interface view,
Default Level
2: System level
Parameters
None
Description
Use the enable snmp trap updown command to enable linkUp/linkDown trap generation for the current aggregate interface.
Use the undo enable snmp trap updown command to disable linkUp/linkDown trap generation for the current aggregate interface.
By default, linkUp/linkDown trap generation is enabled for an aggregate interface.
Note that for an aggregate interface to generate linkUp/linkDown traps when its link state changes, you must also enable linkUp/linkDown trap generation globally with the snmp-agent trap enable [ standard [ linkdown | linkup ] * ] command.
Refer to SNMP Commands in the System Volume for information about the snmp-agent trap enable command.
Examples
# Enable linkUp/linkDown trap generation on interface Bridge-aggregation 1.
<Sysname> system-view
[Sysname] snmp-agent trap enable
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1] enable snmp trap updown
Syntax
interface bridge-aggregation interface-number
undo interface bridge-aggregation interface-number
View
System view
Default Level
2: System level
Parameters
interface-number: Layer 2 aggregate interface number, in the range 1 to 25.
Description
Use the interface bridge-aggregation command to create a Layer 2 aggregate interface and enter the Layer 2 aggregate interface view.
Use the undo interface bridge-aggregation command to remove a Layer 2 aggregate interface.
Upon creation of a Layer 2 aggregate interface, a Layer 2 aggregation group numbered the same is created automatically. Removing the Layer 2 aggregate interface also removes the Layer 2 aggregation group. At the same time, the member ports of the aggregation group, if any, leave the aggregation group.
Examples
# Create Layer 2 aggregate interface Bridge-aggregation 1.
<Sysname> system-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1]
Syntax
lacp port-priority port-priority
undo lacp port-priority
View
Ethernet interface view
Default Level
2: System level
Parameters
port-priority: LACP port priority, in the range of 0 to 65535.
Description
Use the lacp port-priority command to set the LACP priority of a port.
Use the undo lacp port-priority command to restore the default.
The default LACP priority of a port is 32768.
Examples
# Set the LACP priority of GigabitEthernet1/0/1 to 64.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] lacp port-priority 64
Syntax
lacp system-priority system-priority
undo lacp system-priority
View
System view
Default Level
2: System level
Parameters
system-priority: LACP priority of the local system, in the range of 0 to 65535.
Description
Use the lacp system-priority command to set the LACP priority of the local system.
Use the undo lacp port-priority command to restore the default.
By default, the system LACP priority is 32768.
Examples
# Set the system LACP priority to 64.
<Sysname> system-view
[Sysname] lacp system-priority 64
Syntax
link-aggregation load-sharing mode { destination-ip | destination-mac | destination-port | ingress-port | source-ip | source-mac | source-port } *
undo link-aggregation load-sharing mode
View
System view
Default Level
2: System level
Parameters
destination-ip: Specifies to perform load sharing in link aggregation groups based on destination IP address.
destination-mac: Specifies to perform load sharing in load-sharing link aggregation groups based on destination MAC address.
destination-port: Specifies to perform load sharing in load-sharing link aggregation groups based on destination port.
ingress-port: Specifies to perform load sharing in load-sharing link aggregation groups based on ingress port.
source-ip: Specifies to perform load sharing in load-sharing link aggregation groups based on source IP address.
source-mac: Specifies to perform load sharing in load-sharing link aggregation groups based on source MAC address.
source-port: Specifies to perform load sharing in load-sharing link aggregation groups based on source port.
Description
Use the link-aggregation load-sharing mode command to configure the global or aggregation group-specific link aggregation load sharing mode.
Use the undo link-aggregation load-sharing mode command to restore the default.
By default, the hash keys for Layer 2 packets are source/destination MAC addresses, and those for Layer-3 packets are source/destination IP addresses and source/destination MAC addresses.
Note that:
l The load sharing mode you configured overwrites rather than adds to the old one, if any. Therefore, to change the load sharing mode from source port based to source and destination ports based for example, you must configure the link-aggregation load-sharing mode destination-port source-port to overwrite the link-aggregation load-sharing mode destination-port command rather than configure the link-aggregation load-sharing mode source-port command.
l Currently, the hash keys for a switch are source IP addresses, destination IP addresses, source MAC addresses, destination MAC addresses, source ports, destination ports, or the combination of these fields carried in packets. The ingress-port keyword can be used as a hash key only when it is used alone In case an unsupported load sharing mode is configured, you will be prompted of the error.
Examples
# Configure the global link aggregation load sharing mode as destination MAC-based.
<Sysname> system-view
[Sysname] link-aggregation load-sharing mode destination-mac
Syntax
link-aggregation mode dynamic
undo link-aggregation mode
View
Layer 2 aggregate interface view
Default Level
2: System level
Parameters
None
Description
Use the link-aggregation mode dynamic command to configure an aggregation group to work in dynamic aggregation mode.
Use the undo link-aggregation mode command to restore the default.
By default, an aggregation group works in static aggregation mode.
If there is any member port in an aggregation group, you cannot modify the aggregation mode of the aggregation group.
Examples
# Configure the aggregation group of Bridge-aggregation 1 to work in dynamic aggregation mode.
<Sysname> system-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1] link-aggregation mode dynamic
Syntax
port link-aggregation group number
undo port link-aggregation group
View
Ethernet interface view
Default Level
2: System level
Parameters
number: Aggregate group number, in the range of 0 to 25.
Description
Use the port link-aggregation group command to assign the current Ethernet interface to the specified aggregation group.
Use the port link-aggregation group command to remove the current Ethernet interface from the specified aggregation group.
Note that, An Ethernet interface can belong to only one aggregation group.
Examples
# Assign GigabitEthernet1/0/1 to aggregation group 22.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] port link-aggregation group 22
Syntax
reset counters interface [ bridge-aggregation [ interface-number ] ]
View
User view
Default Level
2: System level
Parameters
bridge-aggregation: Clears statistics for Layer 2 aggregate interfaces.
interface-number: Aggregate interface number, note that the aggregate interface you specify must already exist. If the interface-number argument is not specified, this command clears statistics of all aggregate interfaces of the specified type.
Description
Use the reset counters interface command to clear the statistics of the specified aggregate interface or interfaces.
Before collecting statistics for a Layer 2 aggregate interface within a specific period, you need to clear the existing statistics of the interface.
Note that:
l If none of the keywords and argument is specified, this command clears the statistics of all interfaces in the system.
l If only the bridge-aggregation keyword is specified, the command clears the statistics of all Layer 2 aggregate interfaces.
l If the bridge-aggregation interface-number keyword and argument combination is specified, this command clears the statistics of the specified Layer 2 aggregate interface.
Examples
# Clear the statistics of Layer 2 aggregate interface bridge-aggregation 1.
<Sysname> reset counters interface bridge-aggregation 1
Syntax
reset lacp statistics [ interface interface-type interface-number [ to interface-type interface-number ] ]
View
User view
Default Level
1: Monitor level
Parameters
interface-type interface-number: Interface type and interface number.
to: Specifies an interface range in the form of interface-type interface-number to interface-type interface-number, where the start interface number must be smaller than the end interface number. Note that both the start interface and the end interface are inclusive.
Description
Use the reset lacp statistics command to clear the LACP statistics for the specified interface(s) or all interfaces if no interface is specified.
Related commands: display link-aggregation member-port.
Examples
# Clear the LACP statistics for all Ethernet ports.
<Sysname> reset lacp statistics
Syntax
shutdown
undo shutdown
View
Layer 2 aggregate interface view
Default Level
2: System level
Parameters
None
Description
Use the shutdown command to shut down the current aggregate interface.
Use the undo shutdown command to bring up the current aggregate interface.
By default, aggregate interfaces are enabled.
Examples
# Shut down aggregate interface Bridge-Aggregation 1.
<Sysname> system-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1] shutdown
