- Table of Contents
-
- 04-Layer 2—LAN Switching Command Reference
- 00-Preface
- 01-MAC address table commands
- 02-Ethernet link aggregation commands
- 03-VLAN commands
- 04-VLAN mapping commands
- 05-Loop detection commands
- 06-Spanning tree commands
- 07-LLDP commands
- 08-Service loopback group commands
- 09-MVRP commands
- 10-PFC commands
- 11-Cut-through Layer 2 forwarding commands
- Related Documents
-
Title | Size | Download |
---|---|---|
02-Ethernet link aggregation commands | 225.31 KB |
Ethernet link aggregation commands
display link-aggregation capability
display link-aggregation load-sharing mode
display link-aggregation load-sharing path
display link-aggregation member-port
display link-aggregation summary
display link-aggregation verbose
lacp default-selected-port disable
link-aggregation auto-aggregation enable
link-aggregation global load-sharing algorithm
link-aggregation global load-sharing mode
link-aggregation global load-sharing offset
link-aggregation global load-sharing seed
link-aggregation global load-sharing tunnel
link-aggregation lacp traffic-redirect-notification enable
link-aggregation load-sharing mode
link-aggregation management-subnet
link-aggregation port-priority
link-aggregation selected-port maximum
link-aggregation selected-port minimum
link-aggregation selected-port minimum percentage
Ethernet link aggregation commands
display interface
Use display interface to display aggregate interface information.
Syntax
display interface [ { bridge-aggregation | route-aggregation } [ interface-number ] ] [ brief [ description | down ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
bridge-aggregation: Specifies Layer 2 aggregate interfaces.
route-aggregation: Specifies Layer 3 aggregate interfaces.
interface-number: Specifies an existing aggregate interface number.
brief: Displays brief interface information. If you do not specify this keyword, the command displays detailed interface information.
description: Displays complete interface descriptions. If you do not specify this keyword, the command displays only the first 25 characters of each interface description.
down: Displays information about interfaces in down state and the causes for the down state. If you do not specify this keyword, the command displays information about interfaces in all states.
Usage guidelines
If you do not specify an aggregate interface type, the command displays information about all interfaces.
If you specify an aggregate interface type but do not specify an interface number, the command displays information about all aggregate interfaces of the specified type.
If you specify a Layer 3 aggregate subinterface, the command displays only the total number of packets. The command does not display statistics about each packet type for the subinterface.
Examples
# Display detailed information about Layer 2 aggregate interface Bridge-Aggregation 1.
<Sysname> display interface bridge-aggregation 1
Bridge-Aggregation1
Current state: UP
Line protocol state: UP
IP packet frame type: Ethernet II, hardware address: 000f-e207-f2e0
Description: Bridge-Aggregation1 Interface
Bandwidth: 1000 kbps
2Gbps-speed mode, full-duplex mode
Link speed type is autonegotiation, link duplex type is autonegotiation
PVID: 1
Port link-type: Access
Tagged VLANs: None
UnTagged VLANs: 1
Last clearing of counters: Never
Last 300 seconds input: 6900 packets/sec 885160 bytes/sec 0%
Last 300 seconds output: 3150 packets/sec 404430 bytes/sec 0%
Input (total): 5364747 packets, 686688416 bytes
2682273 unicasts, 1341137 broadcasts, 1341337 multicasts, 0 pauses
Input (normal): 5364747 packets, 686688416 bytes
2682273 unicasts, 1341137 broadcasts, 1341337 multicasts, 0 pauses
Input: 0 input errors, 0 runts, 0 giants, 0 throttles
0 CRC, 0 frame, 0 overruns, - aborts
- ignored, - parity errors
Output (total): 1042508 packets, 133441832 bytes
1042306 unicasts, 0 broadcasts, 202 multicasts, - pauses
Output (normal): 1042508 packets, 133441832 bytes
1042306 unicasts, 0 broadcasts, 202 multicasts, 0 pauses
Output: 0 output errors, - underruns, - buffer failures
0 aborts, 0 deferred, 0 collisions, 0 late collisions
- lost carrier, - no carrier
# Display detailed information about Layer 3 aggregate interface Route-Aggregation 1.
<Sysname> display interface route-aggregation 1
Route-Aggregation1
Current state: UP
Line protocol state: UP
Description: Route-Aggregation1 Interface
Bandwidth: 1000 kbps
Maximum transmission unit: 1500
Internet protocol processing: Disabled
IP packet frame type: Ethernet II, hardware address: 0000-0000-0000
IPv6 packet frame type: Ethernet II, hardware address: 0000-0000-0000
Link speed type is autonegotiation, link duplex type is autonegotiation
Last clearing of counters: Never
Last 300 seconds input rate: 0 bytes/sec, 0 bits/sec, 0 packets/sec
Last 300 seconds output rate: 0 bytes/sec, 0 bits/sec, 0 packets/sec
Input (total): 0 packets, 0 bytes
0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
Input (normal): 0 packets, 0 bytes
0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
Input: 0 input errors, 0 runts, 0 giants, 0 throttles
0 CRC, 0 frame, 0 overruns, 0 aborts
0 ignored, 0 parity errors
Output (total): 0 packets, 0 bytes
0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
Output (normal): 0 packets, 0 bytes
0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
Output: 0 output errors, 0 underruns, 0 buffer failures
0 aborts, 0 deferred, 0 collisions, 0 late collisions
0 lost carrier, 0 no carrier
# Display brief information about Layer 2 aggregate interface Bridge-Aggregation 1.
<Sysname> display interface bridge-aggregation 1 brief
Brief information on interfaces in bridge mode:
Link: ADM - administratively down; Stby - standby
Speed: (a) – auto
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 brief information about Layer 3 aggregate interface Route-Aggregation 1.
<Sysname> display interface route-aggregation 1 brief
Brief information on interfaces in route mode:
Link: ADM - administratively down; Stby - standby
Protocol: (s) - spoofing
Interface Link Protocol Primary IP Description
RAGG1 UP UP --
Table 1 Command output
Field |
Description |
Bridge-Aggregation1 |
Layer 2 aggregate interface name. |
Route-Aggregation1 |
Layer 3 aggregate interface name. |
Current state |
Physical link state of the interface: · Administratively DOWN—The interface has been shut down by using the shutdown command. · DOWN—The interface is administratively up, but its physical state is down (possibly because no physical link exists or the link has failed). · UP—The interface is both administratively and physically up. |
IP packet frame type |
IPv4 packet framing format. |
Description |
Description of the interface. |
Bandwidth |
Expected bandwidth of the interface. This field is not displayed when the bandwidth is 0 kbps. |
Unknown-speed mode, unknown-duplex mode |
The interface speed and duplex mode are unknown. |
Port link-type |
Port link type: · Access. · Trunk. · Hybrid. |
Tagged VLANs |
VLAN whose packets are sent out of this interface with a tag. |
Untagged VLANs |
VLAN whose packets are sent out of this interface without a tag. |
Last clearing of counters |
Time when the reset counters interface command was last used to clear the interface statistics. This field displays Never if the reset counters interface command has never been used on the interface since device startup. |
Last 300 seconds input/output rate |
Average input or output rate over the last 300 seconds. |
Input/Output (total) |
Statistics of all packets received or sent on the interface. |
Input/Output (normal) |
Statistics of all normal packets received or sent on the interface. |
Line protocol state |
Data link layer state of the interface: · UP. · DOWN. |
Maximum transmission unit |
MTU of the interface. |
Internet protocol processing |
IP packet processing capability of the interface when the interface is not assigned an IP address: · Disabled—The interface cannot process IP packets. · Enabled—The interface can process IP packets. |
Internet address: ip-address/mask-length (Type) |
IP address of the interface and type of the address in parentheses. · Primary—Manually configured primary IP address. · Sub—Manually configured secondary IP address. If the interface has both primary and secondary IP addresses, the primary IP address is displayed. If the interface has only secondary IP addresses, the lowest secondary IP address is displayed. |
Brief information on interfaces in route mode |
Brief information about Layer 3 interfaces. |
Brief information on interfaces in bridge mode |
Brief information about Layer 2 interfaces. |
Interface |
Abbreviated interface name. |
Link |
Physical link state of the interface: · UP—The interface is physically up. · DOWN—The interface is physically down. · ADM—The interface has been shut down by using the shutdown command. To restore the physical state of the interface, use the undo shutdown command. · Stby—The interface is a backup interface in standby state. |
Speed |
Speed of the interface, in bps. This field displays the (a) flag next to the speed if the speed is automatically negotiated. This field displays auto if the interface is configured to autonegotiate its speed but the autonegotiation has not started. |
Duplex |
Duplex mode of the interface: · A—Autonegotiation. The interface is configured to autonegotiate its duplex mode but the autonegotiation has not started. · F—Full duplex. · F(a)—Autonegotiated full duplex. · H—Half duplex. · H(a)—Autonegotiated half duplex. |
Type |
Link type of the interface: · A—Access. · H—Hybrid. · T—Trunk. |
Protocol |
Data link layer protocol state of the interface: · UP—The data link layer protocol of the interface is up. · DOWN—The data link layer protocol of the interface is down. · UP(s)—The data link layer protocol of the interface is up, but the link is an on-demand link or does not exist. The (s) attribute represents the spoofing flag. This value is typical of null interfaces and loopback interfaces. |
Primary IP |
Primary IP address of the interface. This field displays two hyphens (--) if the interface does not have an IP address. |
Cause |
Cause for the physical link state of an interface to be DOWN. |
display lacp system-id
Use display lacp system-id to display the local system ID.
Syntax
display lacp system-id
Views
Any view
Predefined user roles
network-admin
network-operator
Usage guidelines
You can use the lacp system-priority command to change the LACP priority of the local system. The LACP priority value is specified in decimal format in the lacp system-priority command. However, it is displayed in hexadecimal format in the output from the display lacp system-id command.
Examples
# Display the local system ID.
<Sysname> display lacp system-id
Actor System ID: 0x8000, 0000-fc00-6504
Table 2 Command output
Field |
Description |
Actor System ID: 0x8000, 0000-fc00-6504 |
Local system ID, which contains the LACP system priority (0x8000 in this sample output) and the LACP system MAC address (0000-FC00-6504 in this sample output). |
lacp system-priority
display link-aggregation capability
Use display link-aggregation capability to display the link aggregation capability for the device.
Syntax
display link-aggregation capability
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display the link aggregation capability for the device.
<Sysname> display link-aggregation capability
Default link aggregation capability:
Maximum groups: 1024
Maximum Selected ports per group: 16
Current link aggregation capability:
Maximum groups: 1024
Maximum Selected ports per group: 16
Link aggregation capability at the next reboot:
Maximum groups: 1024
Maximum Selected ports per group: 16
Supported link aggregation capability list:
1024*16 512*32 256*64 128*128 64*256
Table 3 Command output
Field |
Description |
Supported link aggregation capability list |
Link aggregation capabilities supported by the device. Each item in the list is in the format of maximum number of aggregation groups*maximum number of Selected ports per aggregation group. |
Related commands
link-aggregation capability
display link-aggregation load-sharing mode
Use display link-aggregation load-sharing mode to display global or group-specific link-aggregation load sharing modes.
Syntax
display link-aggregation load-sharing mode [ interface [ { bridge-aggregation | route-aggregation } interface-number ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
bridge-aggregation: Specifies Layer 2 aggregate interfaces.
route-aggregation: Specifies Layer 3 aggregate interfaces.
interface-number: Specifies an existing aggregate interface number.
Usage guidelines
If you do not specify the interface keyword, the command displays the global link-aggregation load sharing modes.
If you specify the interface keyword, but do not specify an interface, the command displays all group-specific load sharing modes.
The bridge-aggregation or route-aggregation keyword is available only when the corresponding aggregate interfaces exist on the device.
Examples
# Display the global link-aggregation load sharing mode. This example displays the default setting.
<Sysname> display link-aggregation load-sharing mode
Link-aggregation load-sharing algorithm:
4 (default)
Link-aggregation load-sharing offset:
0 (default)
Link-aggregation load-sharing seed:
0x1 (default)
Tunneled traffic load-sharing mode:
Outer (default)
Link-aggregation load-sharing mode:
Layer 2 traffic: packet type-based sharing
Layer 3 traffic: packet type-based sharing
# Display the global link-aggregation load sharing mode. This example displays a user-configured setting.
<Sysname> display link-aggregation load-sharing mode
Link-aggregation load-sharing algorithm:
5
Link-aggregation load-sharing offset:
3
Link-aggregation load-sharing seed:
0x10
Tunneled traffic load-sharing mode:
Inner
Link-aggregation load-sharing mode:
destination-mac address source-mac address
# Display the link-aggregation load sharing mode of Layer 2 aggregation group 10. This example displays the default setting.
<Sysname> display link-aggregation load-sharing mode interface bridge-aggregation 10
Bridge-Aggregation10 load-sharing mode:
Layer 2 traffic: packet type-based sharing
Layer 3 traffic: packet type-based sharing
# Display the link-aggregation load sharing mode of Layer 2 aggregation group 10. This example displays a user-configured setting.
<Sysname> display link-aggregation load-sharing mode interface bridge-aggregation 10
Bridge-Aggregation10 load-sharing mode:
destination-mac address source-mac address
Table 4 Command output
Field |
Description |
Link-aggregation load-sharing algorithm |
Link aggregation load sharing algorithm. By default, this field displays the default setting. If you have configured the load sharing algorithm, this field displays the configured algorithm. |
Link-aggregation load-sharing offset |
Hash offset to adjust the load sharing hash results on aggregate links. By default, this field displays the default setting. If you have configured a hash offset, this field displays the configured offset value. |
Link-aggregation load-sharing seed |
Link aggregation load sharing hash seed. By default, this field displays the default setting. If you have configured the load sharing hash seed, this field displays the configured seed. |
Tunneled traffic load-sharing mode |
Load sharing mode for tunneled traffic on aggregate links. By default, this field displays the default setting. If you have configured a load sharing mode for tunneled traffic, this field displays the configured mode. |
Link-aggregation load-sharing mode |
Global link-aggregation load sharing mode. By default, this field displays the link-aggregation load sharing modes for Layer 2 and Layer 3 traffic. If you have configured the global link-aggregation load sharing mode, this field displays the configured mode. |
Bridge-Aggregation10 load-sharing mode |
Link-aggregation load sharing mode of Layer 2 aggregation group 10. By default, this field displays the global link-aggregation load sharing modes. If you have configured a link-aggregation load sharing mode for this aggregation group, this field displays the configured mode. |
Route-Aggregation10 load-sharing mode |
Link-aggregation load sharing mode of Layer 3 aggregation group 10. By default, this field displays the global link-aggregation load sharing modes. If you have configured a link-aggregation load sharing mode for this aggregation group, this field displays the configured mode. |
Layer 2 traffic: packet type-based sharing |
Default link-aggregation load sharing mode for Layer 2 traffic. In this sample output, the system automatically selects a load sharing mode for Layer 2 traffic. |
Layer 3 traffic: packet type-based sharing |
Default link-aggregation load sharing mode for Layer 3 traffic. In this sample output, the system automatically selects a load sharing mode for Layer 3 traffic. |
destination-mac address source-mac address |
User-configured link-aggregation load sharing mode. In this sample output, traffic is load shared based on source and destination MAC addresses. |
display link-aggregation load-sharing path
Use display link-aggregation load-sharing path to display forwarding information about the specified traffic flow.
Syntax
display link-aggregation load-sharing path interface { bridge-aggregation | route-aggregation } interface-number ingress-port interface-type interface-number [ route ] { { destination-ip ip-address | destination-ipv6 ipv6-address } | { source-ip ip-address | source-ipv6 ipv6-address } | destination-mac mac-address | destination-port port-id | ip-protocol protocol-id | source-mac mac-address | source-port port-id | vlan vlan-id } *
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
bridge-aggregation: Specifies Layer 2 aggregate interfaces.
route-aggregation: Specifies Layer 3 aggregate interfaces.
interface-number: Specifies an existing aggregate interface by its number.
ingress-port interface-type interface-number: Specifies an ingress port by its type and number. The ingress port must be a physical port.
route: Displays forwarding information about Layer 3 traffic. If you do not specify this keyword, the command displays forwarding information about Layer 2 traffic.
destination-ip ip-address: Specifies a destination IPv4 address.
destination-ipv6 ipv6-address: Specifies a destination IPv6 address.
source-ip ip-address: Specifies a source IPv4 address.
source-ipv6 ipv6-address: Specifies a source IPv6 address.
destination-mac mac-address: Specifies a destination MAC address in H-H-H format.
destination-port port-id: Specifies a destination port number in the range of 1 to 65535.
ip-protocol protocol-id: Specifies an IP protocol by its ID in the range of 0 to 255.
source-mac mac-address: Specifies a source MAC address in H-H-H format.
source-port port-id: Specifies a source port number in the range of 1 to 65535.
vlan vlan-id: Specifies a VLAN by its ID in the range of 1 to 4094.
Usage guidelines
A parameter specified in the command might not be used for selecting the egress port. The Load sharing parameters field displays the parameters that are used in egress port selection. For example, you can specify both the destination-mac mac-address and destination-ip ip-address options. If only the destination MAC address is used for selecting the egress port, the Load sharing parameters field does not display the destination-ip parameter.
If a parameter required for selecting the egress port is not specified, the default value of the parameter is used. If the parameter does not have any default values, the parameter is set to 0.
Examples
# Display forwarding information about the specified traffic flow to be sent out of Layer 2 aggregate interface Bridge-Aggregation 1.
<Sysname> display link-aggregation load-sharing path interface bridge-aggregation 1 ingress-port hundredgige 1/0/1 destination-mac 0000-fc00-0001 source-mac 0000-fc00-0002 source-ip 10.100.0.2 destination-ip 10.100.0.1
Load sharing mode: destination-mac, source-mac, source-ip, destination-ip
Unspecified parameters are set to 0.
Load-sharing parameters:
Ingress port: HundredGigE1/0/1
Destination MAC: 0000-fc00-0001
Source MAC: 0000-fc00-0002
Destination IP: 10.100.0.1
Source IP: 10.100.0.2
Egress port: HundredGigE1/0/3
Table 5 Command output
Field |
Description |
Load sharing mode: |
Load sharing mode set for the aggregation group: · destination-mac—Traffic is load shared based on destination MAC addresses. · source-mac—Traffic is load shared based on source MAC addresses. · destination-ip—Traffic is load shared based on destination IP addresses. · source-ip—Traffic is load shared based on source IP addresses. · destination-port—Traffic is load shared based on destination ports. · source-port—Traffic is load shared based on source ports. · ip-protocol—Traffic is load shared based on IP protocol types. · ingress-port—Traffic is load shared based on ingress ports. · packet type-based sharing—Traffic is load shared based on the load sharing mode automatically selected depending on the packet type. If no load sharing mode is set, this field also displays packet type-based sharing. |
Load sharing parameters |
Parameters that are used in egress port selection. |
Egress port |
Egress port of the specified traffic flow. If no egress port is found, this field displays N/A. |
display link-aggregation member-port
Use display link-aggregation member-port to display detailed link aggregation information about the specified member ports.
Syntax
display link-aggregation member-port [ interface-list | auto ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-list: Specifies a list of link aggregation member ports, in the format interface-type interface-number1 [ to interface-type interface-number2 ]. The value for the interface-number2 argument must be equal to or greater than the value for the interface-number1 argument.
auto: Specifies all link aggregation member ports that are enabled with automatic assignment.
Usage guidelines
A member port in a static aggregation group cannot obtain information about the peer group. For such member ports, the command displays the port number, port priority, and operational key of only the local end.
Examples
# Display detailed information about HundredGigE 1/0/1, which is a member port of a static aggregation group.
<Sysname> display link-aggregation member-port hundredgige 1/0/1
Flags: A -- LACP_Activity, B -- LACP_Timeout, C -- Aggregation,
D -- Synchronization, E -- Collecting, F -- Distributing,
G -- Defaulted, H -- Expired
HundredGigE1/0/1:
Aggregate Interface: Bridge-Aggregation1
Port Number: 1
Port Priority: 32768
Oper-Key: 1
# Display detailed information about HundredGigE 1/0/2, which is a member port of a dynamic aggregation group.
<Sysname> display link-aggregation member-port hundredgige 1/0/2
Flags: A -- LACP_Activity, B -- LACP_Timeout, C -- Aggregation,
D -- Synchronization, E -- Collecting, F -- Distributing,
G -- Defaulted, H -- Expired
HundredGigE1/0/2:
Aggregate 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 6 Command output
Field |
Description |
Flags |
LACP state flags. This field is one byte long, represented by ABCDEFGH from the least significant bit to the most significant bit. A letter appears when its bit is 1 and does not appear when its bit is 0. · A—Indicates whether LACP is active on the port. 1 indicates active. 0 indicates passive. · B—Indicates the LACP timeout interval. 1 indicates the short timeout interval. 0 indicates the long timeout interval. · C—Indicates whether the sending system considers that the link is aggregatable. 1 indicates yes. 0 indicates no. · D—Indicates whether the sending system considers that the link has been aggregated. 1 indicates yes. 0 indicates no. · E—Indicates whether the sending system considers that the link can collect frames. 1 indicates yes. 0 indicates no. · F—Indicates whether the sending system considers that the link can distribute frames. 1 indicates yes. 0 indicates no. · G—Indicates whether the RX state machine of the sending system is in default state. 1 indicates yes. 0 indicates no. · H—Indicates whether the RX state machine of the sending system is in expired state. 1 indicates yes. 0 indicates no. |
Aggregate Interface |
Aggregate interface to which the member port belongs. |
Preferred Aggregate Interface |
Aggregate interface to which you prefer to assign the member port during automatic assignment. |
Local |
Information about the local end. |
Oper-key |
Operational key. |
Flag |
LACP protocol state flag. |
Remote |
Information about the peer end. |
System ID |
Peer system ID, containing the LACP system priority and the LACP system MAC address. |
Received LACP Packets |
Total number of LACP packets received. |
Illegal |
Total number of illegal packets. |
Sent LACP Packets |
Total number of LACP packets sent. |
display link-aggregation summary
Use display link-aggregation summary to display brief information about all aggregation groups.
Syntax
display link-aggregation summary
Views
Any view
Predefined user roles
network-admin
network-operator
Usage guidelines
The Partner ID field in the command output always displays None for a static link aggregation group. This is because the local aggregation system cannot obtain information from the peer system in a static link aggregation.
Examples
# Display brief information about all aggregation groups.
<Sysname> display link-aggregation summary
Aggregate Interface Type:
BAGG -- Bridge-Aggregation, BLAGG –- Blade-Aggregation, RAGG -- Route-Aggregation, SCH-B – Schannel-Bundle
Aggregation Mode: S -- Static, D -- Dynamic
Loadsharing Type: Shar -- Loadsharing, NonS -- Non-Loadsharing
Actor System ID: 0x8000, 000f-e267-6c6a
AGG AGG Partner ID Selected Unselected Individual Share
Interface Mode Ports Ports Ports Type
--------------------------------------------------------------------------------
RAGG10 S None 1 0 0 NonS
BAGG20 D 0x8000,00e0-fcff-ff01 2 0 0 Shar
Table 7 Command output
Field |
Description |
Aggregate Interface Type |
Aggregate interface type: · BAGG—Layer 2. · RAGG—Layer 3. · BLAGG—Blade. This type is not available in the current software version. · SCH-B—S-channel bundle. This type is not available in the current software version. |
Aggregation Mode |
Aggregation group type: · S—Static. · D—Dynamic. |
Loadsharing Type |
Load sharing type: · Shar—Load-sharing. · NonS—Non-load-sharing. |
Actor System ID |
Local system ID, which contains the local LACP system priority and the local LACP system MAC address. |
AGG Interface |
Type and number of the aggregate interface. |
AGG Mode |
Aggregation group type. |
Partner ID |
System ID of the peer system, which contains the peer LACP system priority and the peer LACP system MAC address. |
Selected Ports |
Total number of Selected ports. |
Unselected Ports |
Total number of Unselected ports. |
Individual Ports |
Total number of Individual ports. |
Share Type |
Load sharing type. |
display link-aggregation verbose
Use display link-aggregation verbose to display detailed information about the aggregation groups that correspond to the specified aggregate interfaces.
Syntax
display link-aggregation verbose [ { bridge-aggregation | route-aggregation } [ interface-number ] ] [ all-configuration ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
bridge-aggregation: Specifies Layer 2 aggregate interfaces.
route-aggregation: Specifies Layer 3 aggregate interfaces.
interface-number: Specifies an existing aggregate interface by its number.
all-configuration: Specifies all member ports in an aggregation group. If you do not specify this keyword, the command displays the member ports on present cards.
Usage guidelines
If you do not specify an aggregate interface type, the command displays detailed information about all aggregation groups.
If you specify an aggregate interface type but do not specify an interface number, the command displays detailed information about all aggregation groups of the specified type.
The bridge-aggregation or route-aggregation keyword is available only when the corresponding aggregate interfaces exist on the device.
This command does not display the interfaces that are enabled with automatic assignment if they have not joined an aggregation group.
Examples
# Display detailed information about Layer 2 aggregation group 10, which is a dynamic aggregation group.
<Sysname> display link-aggregation verbose bridge-aggregation 10
Loadsharing Type: Shar -- Loadsharing, NonS -- Non-Loadsharing
Port Status: S -- Selected, U -- Unselected, I -- Individual
Port: A -- Auto port, M -- Management port, R -- Reference port
Flags: A -- LACP_Activity, B -- LACP_Timeout, C -- Aggregation,
D -- Synchronization, E -- Collecting, F -- Distributing,
G -- Defaulted, H -- Expired
Aggregate Interface: Bridge-Aggregation10
Creation Mode: Manual
Aggregation Mode: Dynamic
Loadsharing Type: Shar
System ID: 0x8000, 000f-e267-6c6a
Local:
Port Status Priority Index Oper-Key Flag
HGE1/0/1 S 32768 61 2 {ACDEF}
HGE1/0/2 S 32768 62 2 {ACDEF}
HGE1/0/3 S 32768 63 2 {ACDEF}
Remote:
Actor Priority Index Oper-Key SystemID Flag
HGE1/0/1(R) 32768 111 2 0x8000, 000f-e267-57ad {ACDEF}
HGE1/0/2 32768 112 2 0x8000, 000f-e267-57ad {ACDEF}
HGE1/0/3 32768 113 2 0x8000, 000f-e267-57ad {ACDEF}
# Display detailed information about Layer 2 aggregation group 20, which is a static aggregation group.
<Sysname> display link-aggregation verbose bridge-aggregation 20
Loadsharing Type: Shar -- Loadsharing, NonS -- Non-Loadsharing
Port Status: S -- Selected, U -- Unselected, I -- Individual
Port: A -- Auto port, M -- Management port, R -- Reference port
Flags: A -- LACP_Activity, B -- LACP_Timeout, C -- Aggregation,
D -- Synchronization, E -- Collecting, F -- Distributing,
G -- Defaulted, H -- Expired
Aggregate Interface: Bridge-Aggregation20
Aggregation Mode: Static
Loadsharing Type: Shar
Port Status Priority Oper-Key
HGE1/0/1(R) S 32768 1
HGE1/0/2 S 32768 1
HGE1/0/3 S 32768 1
Table 8 Command output
Field |
Description |
Loadsharing Type |
Load sharing type: · Shar—Load-sharing. · NonS—Non-load-sharing. |
Port Status |
Port state: · Selected. · Unselected. · Individual. |
Port |
Port type: · Auto port—The port is enabled with automatic assignment. · Management port—The port is a management port. This type is not available in the current software version. · Reference port—The port is a reference port. |
Flags |
LACP state flags. This field is one byte long, represented by ABCDEFGH from the least significant bit to the most significant bit. A letter appears when its bit is 1 and does not appear when its bit is 0. · A—Indicates whether LACP is active on the port. 1 indicates active. 0 indicates passive. · B—Indicates the LACP timeout interval. 1 indicates the short timeout interval. 0 indicates the long timeout interval. · C—Indicates whether the sending system considers that the link is aggregatable. 1 indicates yes. 0 indicates no. · D—Indicates whether the sending system considers that the link has been aggregated. 1 indicates yes. 0 indicates no. · E—Indicates whether the sending system considers that the link can collect frames. 1 indicates yes. 0 indicates no. · F—Indicates whether the sending system considers that the link can distribute frames. 1 indicates yes. 0 indicates no. · G—Indicates whether the RX state machine of the sending system is in default state. 1 indicates yes. 0 indicates no. · H—Indicates whether the RX state machine of the sending system is in expired state. 1 indicates yes. 0 indicates no. |
Aggregate Interface |
Name of the aggregate interface. |
Creation Mode |
Creation mode of the dynamic aggregate interface: · Auto. · Manual. |
Aggregation Mode |
Aggregation group type: · S—Static. · D—Dynamic. |
System ID |
Local system ID, containing the local LACP system priority and the local LACP system MAC address. |
Local |
Information about the local end: · Port—Port type and number. · Status—Port state, which can be Selected, Unselected, or Individual. · Priority—Port priority. · Index—Port index. · Oper-Key—Operational key. · Flag—LACP state flag. NOTE: For static aggregation groups, the Index and Flag fields are not displayed. |
Remote |
Information about the peer end: · Actor—Type and number of the local port. This field displays the (R) flag next to the port if its peer port is the reference port. · Priority—Priority of the peer port. · Index—Index of the peer port. · Oper-Key—Operational key of the peer port. · System ID—System ID of the peer end. · Flag—LACP state flag of the peer end. |
interface bridge-aggregation
Use interface bridge-aggregation to create a Layer 2 aggregate interface and enter its view, or enter the view of an existing Layer 2 aggregate interface.
Use undo interface bridge-aggregation to delete a Layer 2 aggregate interface.
Syntax
interface bridge-aggregation interface-number
undo interface bridge-aggregation interface-number
Default
No Layer 2 aggregate interfaces exist.
Views
System view
Predefined user roles
network-admin
Parameters
interface-number: Specifies a Layer 2 aggregate interface number. The value range for the interface-number argument is 1 to 1024.
Usage guidelines
When you create a Layer 2 aggregate interface, the system automatically creates a Layer 2 aggregation group with the same number. The aggregation group operates in static aggregation mode by default.
Deleting a Layer 2 aggregate interface also deletes 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, and enter its view.
<Sysname> system-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1]
interface route-aggregation
Use interface route-aggregation to create a Layer 3 aggregate interface or subinterface and enter its view, or enter the view of an existing Layer 3 aggregate interface or subinterface.
Use undo interface route-aggregation to delete a Layer 3 aggregate interface or subinterface.
Syntax
interface route-aggregation { interface-number | interface-number.subnumber }
undo interface route-aggregation { interface-number | interface-number.subnumber }
Default
No Layer 3 aggregate interfaces or subinterfaces exist.
Views
System view
Predefined user roles
network-admin
Parameters
interface-number: Specifies a Layer 3 aggregate interface number. The value range for the interface-number argument is 1 to 1024.
interface-number.subnumber: Specifies a subinterface of a Layer 3 aggregate interface. The interface-number argument specifies the main interface number. The subnumber argument specifies the subinterface number and is separated from the main interface number by a dot (.). The value range for the subnumber argument is 1 to 4094.
Usage guidelines
When you create a Layer 3 aggregate interface, the system automatically creates a Layer 3 aggregation group with the same number. The Layer 3 aggregation group operates in static aggregation mode by default.
Deleting a Layer 3 aggregate interface also deletes the Layer 3 aggregation group and all its aggregate subinterfaces. At the same time, the member ports of the aggregation group, if any, leave the aggregation group.
Deleting a Layer 3 aggregate subinterface does not affect the state of the main interface and the corresponding aggregation group.
Examples
# Create Layer 3 aggregate interface Route-Aggregation 1 and enter its view.
<Sysname> system-view
[Sysname] interface route-aggregation 1
jumboframe enable
Use jumboframe enable to allow the jumbo frames on an interface to pass through.
Use undo jumboframe enable to deny jumbo frames on an interface.
Use undo jumboframe enable size to restore the default.
Syntax
jumboframe enable [ size ]
undo jumboframe enable [ size ]
Default
An aggregate interface allows jumbo frames that are within 11996 bytes to pass through.
Views
Layer 2 aggregate interface view
Layer 3 aggregate interface view
Predefined user roles
network-admin
Parameters
size: Specifies the maximum length of jumbo frames, in bytes. The value range for this argument is 1536 to 11996.
Usage guidelines
If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Allow jumbo frames on Layer 2 aggregate interface Bridge-Aggregation 1.
<Sysname> System-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1] jumboframe enable
lacp default-selected-port disable
Use lacp default-selected-port disable to disable the default port selection action for dynamic aggregation groups.
Use undo lacp default-selected-port disable to enable the default port selection action for dynamic aggregation groups.
Syntax
lacp default-selected-port disable
undo lacp default-selected-port disable
Default
The default port selection action is enabled for dynamic aggregation groups.
Views
System view
Predefined user roles
network-admin
Usage guidelines
The default port selection action applies to dynamic aggregation groups.
This action automatically chooses the port with the lowest ID from among all up member ports as a Selected port if none of them has received LACPDUs before the LACP timeout interval expires.
After this action is disabled, a dynamic aggregation group will not have any Selected ports to forward traffic if it has not received LACPDUs before the LACP timeout interval expires.
Examples
# Disable the default port selection action.
<Sysname> system-view
[Sysname] lacp default-selected-port disable
lacp edge-port
Use lacp edge-port to configure an aggregate interface as an edge aggregate interface.
Use undo lacp edge-port to restore the default.
Syntax
lacp edge-port
undo lacp edge-port
Default
An aggregate interface does not operate as an edge aggregate interface.
Views
Layer 2 aggregate interface view
Layer 3 aggregate interface view
Predefined user roles
network-admin
Usage guidelines
Use this command on the aggregate interface that connects the device to a server if dynamic link aggregation is configured only on the device. This feature improves link reliability by enabling all member ports of the aggregation group to forward packets.
This command takes effect only on an aggregate interface corresponding to a dynamic aggregation group.
Link-aggregation traffic redirection cannot operate correctly on an edge aggregate interface.
Examples
# Configure Layer 2 aggregate interface Bridge-Aggregation 1 as an edge aggregate interface.
<Sysname> System-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1] lacp edge-port
lacp mode
Use lacp mode passive to configure LACP to operate in passive mode on a port.
Use undo lacp mode to restore the default.
Syntax
lacp mode passive
undo lacp mode
Default
LACP operates in active mode on a port.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Predefined user roles
network-admin
Usage guidelines
This command takes effect only on member ports of dynamic aggregation groups.
When LACP is operating in passive mode on a local member port and its peer port, both ports cannot send LACPDUs. When LACP is operating in active mode on either end of a link, both ports can send LACPDUs.
Examples
# Configure LACP to operate in passive mode on HundredGigE 1/0/1.
<Sysname> system-view
[Sysname] interface hundredgige 1/0/1
[Sysname-HundredGigE1/0/1] lacp mode passive
lacp period short
Use lacp period short to enable the short LACP timeout interval (3 seconds) on an interface.
Use undo lacp period to restore the default.
Syntax
lacp period short
undo lacp period
Default
The LACP timeout interval is the long timeout interval (90 seconds) on an interface.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Predefined user roles
network-admin
Examples
# Enable the short LACP timeout interval (3 seconds) on HundredGigE 1/0/1.
<Sysname> system-view
[Sysname] interface hundredgige 1/0/1
[Sysname-HundredGigE1/0/1] lacp period short
lacp select speed
Use lacp select speed to configure a dynamic aggregation group to use port speed as the prioritized criterion for reference port selection.
Use undo lacp select speed to restore the default.
Syntax
lacp select speed
undo lacp select speed
Default
Port ID is the prioritized criterion for reference port selection in a dynamic aggregation group.
Views
Layer 2 aggregate interface view
Layer 3 aggregate interface view
Predefined user roles
network-admin
Usage guidelines
CAUTION: Changing reference port selection criteria might cause transient traffic interruption. When you use this command, make sure you understand its impact on your network. |
This command enables a dynamic aggregation group to select a high-speed member port as the reference port.
You must execute this command at both ends of the aggregate link so the peer aggregation systems use the same criteria for reference port selection.
As a best practice, shut down the peer aggregate interfaces before you execute this command and bring up the interfaces after this command is executed on both of them.
This command takes effect only on dynamic aggregate interfaces. On a static aggregate interface, you can execute this command, but the setting cannot take effect.
Examples
# Specify port speed as the prioritized criterion for reference port selection on Layer 2 dynamic aggregate interface Bridge-Aggregation 1.
<Sysname> system-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1] link-aggregation mode dynamic
[Sysname-Bridge-Aggregation1] lacp select speed
lacp system-priority
Use lacp system-priority to set the LACP system priority.
Use undo lacp system-priority to restore the default.
Syntax
lacp system-priority priority
undo lacp system-priority
Default
The LACP system priority is 32768.
Views
System view
Predefined user roles
network-admin
Parameters
priority: Specifies the LACP system priority in the range of 0 to 65535. The smaller the value, the higher the LACP system priority.
Examples
# Set the LACP system priority to 64.
<Sysname> system-view
[Sysname] lacp system-priority 64
Related commands
link-aggregation port-priority
link-aggregation auto-aggregation enable
Use link-aggregation auto-aggregation enable to enable automatic link aggregation.
Use undo link-aggregation auto-aggregation enable to disable automatic link aggregation.
Syntax
link-aggregation auto-aggregation enable
undo link-aggregation auto-aggregation enable
Default
Automatic link aggregation is disabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
After you enable automatic link aggregation and LLDP on two connected devices, they automatically establish a dynamic link aggregation based on the information in incoming LLDP frames. The devices each automatically create a dynamic aggregate interface and assign the redundant ports connected to the peer to the aggregation group of that interface. If you disable LLDP or automatic link aggregation on one device, that device removes the aggregation member ports from the aggregation group, but it will retain the aggregate interface. This event will not trigger member port removal actions on the peer device.
If automatic link aggregation is enabled, subinterface creation might fail on LLDP-enabled Layer 3 Ethernet interfaces. As a best practice, do not create subinterfaces on LLDP-enabled Layer 3 Ethernet interfaces.
To ensure correct operation of an automatically created aggregate interface, do not modify the configuration on the member ports of its aggregation group. Doing so might cause the member ports to be removed from the aggregation group.
For DRNI to operate correctly, do not use this command on a DR system.
On an interface, the port link-aggregation group setting takes precedence over automatic link aggregation. The interface will not be added to the aggregation group of an automatically created aggregate interface if it has been the member port of a manually created aggregate interface.
Examples
# Enable automatic link aggregation.
<Sysname> system
[Sysname] link-aggregation auto-aggregation enable
Related commands
lldp enable
lldp global enable
link-aggregation bfd ipv4
Use link-aggregation bfd ipv4 to enable BFD for an aggregation group.
Use undo link-aggregation bfd to disable BFD for an aggregation group.
Syntax
link-aggregation bfd ipv4 source ip-address destination ip-address
undo link-aggregation bfd
Default
BFD is disabled for an aggregation group.
Views
Layer 2 aggregate interface view
Layer 3 aggregate interface view
Predefined user roles
network-admin
Parameters
source ip-address: Specifies the unicast source IP address of BFD sessions. The source IP address cannot be 0.0.0.0.
destination ip-address: Specifies the unicast destination IP address of BFD sessions. The destination IP address cannot be 0.0.0.0.
Usage guidelines
Make sure the source and destination IP addresses are reversed between the two ends of an aggregate link. For example, if you execute link-aggregation bfd ipv4 source 1.1.1.1 destination 2.2.2.2 at the local end, execute link-aggregation bfd ipv4 source 2.2.2.2 destination 1.1.1.1 at the peer end. The source and destination IP addresses cannot be the same.
The BFD parameters configured on an aggregate interface take effect on all BFD sessions established by the member ports in its aggregation group. BFD on a link aggregation supports only control packet mode for session establishment and maintenance. The two ends of an established BFD session can only operate in Asynchronous mode. For more information about BFD, see High Availability Configuration Guide.
As a best practice, do not configure BFD for any protocols on a BFD-enabled aggregate interface.
Make sure the number of member ports in the BFD-enabled aggregation group is less than or identical to the number of BFD sessions supported by the device. If the aggregation group contains more member ports than the supported sessions, some Selected ports might change to the Unselected state.
If the number of BFD sessions differs between the two ends of an aggregate link, check their settings for inconsistency in the maximum number of Selected ports. You must make sure the two ends have the same setting for the maximum number of Selected ports.
Examples
# Enable BFD for Layer 2 aggregation group 1, and specify the source and destination IP addresses as 1.1.1.1 and 2.2.2.2 for BFD sessions.
<Sysname> system-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1] link-aggregation bfd ipv4 source 1.1.1.1 destination 2.2.2.2
link-aggregation capability
Use link-aggregation capability to configure the link aggregation capability for the device.
Use undo link-aggregation capability to restore the default.
Syntax
link-aggregation capability max-group max-group-number max-selected-port max-selected-port-number
undo link-aggregation capability
Default
The device can have a maximum of 1024 aggregation groups and each aggregation group can have a maximum of 16 Selected ports.
Views
System view
Predefined user roles
network-admin
Parameters
max-group max-group-number: Specifies the maximum number of aggregation groups that the device supports. The value for the max-group-number argument can be 64, 128, 256, 512, or 1024.
max-selected-port max-selected-port-number: Specifies the maximum number of Selected ports per aggregation group. The value for the max-selected-port-number argument can be 16, 32, 64, 128, or 256.
Usage guidelines
After you execute this command, save the configuration and reboot the device for the configuration to take effect. Before rebooting the device, make sure you know the possible impact on the network.
This command fails if the number of existing aggregation groups exceeds the configured maximum number.
If you create aggregation groups after executing the link-aggregation capability command and the number of aggregation groups exceeds the configured number, some aggregation groups are deleted at the next reboot.
The maximum number of Selected ports allowed in an aggregation group is limited by one of the following values, whichever value is smaller:
· Maximum number set by using the link-aggregation selected-port maximum command.
· Maximum number of Selected ports allowed by the link aggregation capability.
For link aggregation to operate correctly, set the same link aggregation capability for both ends of an aggregate link.
If you execute this command multiple times, the most recent configuration takes effect at the next reboot.
Examples
# Configure the device to support a maximum of 1024 aggregation groups and a maximum of 16 Selected ports per aggregation group.
<Sysname> system-view
[Sysname] link-aggregation capability max-group 1024 max-selected-port 16
The configuration will take effect at the next reboot. Continue? [Y/N]:y
Please save the configuration, and reboot the device.
Related commands
display link-aggregation capability
link-aggregation global load-sharing algorithm
Use link-aggregation global load-sharing algorithm to configure a link aggregation load sharing algorithm.
Use undo link-aggregation global load-sharing algorithm to restore the default.
Syntax
link-aggregation global load-sharing algorithm algorithm-number
undo link-aggregation global load-sharing algorithm
Default
Algorithm 4 is used in link aggregation load sharing.
Views
System view
Predefined user roles
network-admin
Parameters
algorithm algorithm-number: Specifies an algorithm by its number. The value range for the algorithm-number argument is 1 to 11.
Usage guidelines
If you execute this command multiple times, the most recent configuration takes effect.
This command does not take effect on per-flow load sharing.
The load sharing algorithm determines the CRC calculation method. In default load sharing mode, if the device fails to load share traffic flows across all Selected ports, repeat the following procedure until the problem is resolved:
1. Configure the load sharing algorithm.
2. Use the display counters command to view traffic statistics on Selected ports.
You can use a load sharing algorithm and a hash seed individually or in combination to obtain the optimal load sharing performance.
Examples
# Specify algorithm 1 as the link aggregation load sharing algorithm.
<Sysname> system-view
[Sysname] link-aggregation global load-sharing algorithm 1
Related commands
display counters (Interface Command Reference)
display link-aggregation load-sharing mode
link-aggregation global load-sharing mode
link-aggregation global load-sharing seed
link-aggregation load-sharing mode
link-aggregation global load-sharing mode
Use link-aggregation global load-sharing mode to set the global link-aggregation load sharing mode.
Use undo link-aggregation global load-sharing mode to restore the default.
Syntax
link-aggregation global load-sharing mode { destination-ip | destination-mac | destination-port | ingress-port | ip-protocol | source-ip | source-mac | source-port } *
undo link-aggregation global load-sharing mode
Default
Traffic is distributed based on all supported hashing keys.
Views
System view
Predefined user roles
network-admin
Parameters
destination-ip: Distributes traffic based on destination IP addresses.
destination-mac: Distributes traffic based on destination MAC addresses.
destination-port: Distributes traffic based on destination ports.
ingress-port: Distributes traffic based on ingress ports.
ip-protocol: Distributes traffic based on IP protocol types.
source-ip: Distributes traffic based on source IP addresses.
source-mac: Distributes traffic based on source MAC addresses.
source-port: Distributes traffic based on source ports.
Usage guidelines
If you execute this command multiple times, the most recent configuration takes effect.
If an unsupported load sharing mode is set, the device displays an error message.
The global link-aggregation load sharing mode can be any combination of the hashing keys.
When symmetric load sharing is enabled, the device uses the source and destination MAC addresses, IP addresses, or port numbers as hash keys in pairs for link-aggregation load sharing. If you specify one of the hash keys in a pair, the device will use both hash keys in that pair for load sharing. For example, if you specify the source MAC address, the device uses both source and destination MAC addresses for load sharing.
For more information about symmetric load sharing, see IP forwarding basics configuration in Layer 3—IP Services Configuration Guide.
Examples
# Set the global load sharing mode to load share packets based on destination MAC addresses.
<Sysname> system-view
[Sysname] link-aggregation global load-sharing mode destination-mac
Related commands
link-aggregation load-sharing mode
link-aggregation global load-sharing offset
Use link-aggregation global load-sharing offset to set a hash offset to adjust the load balancing hash results on link aggregations.
Use undo link-aggregation global load-sharing offset to restore the default.
Syntax
link-aggregation global load-sharing offset offset-value
undo link-aggregation global load-sharing offset
Default
The hash offset of load balancing hash results is 0.
Views
System view
Predefined user roles
network-admin
Parameters
offset-value: Specifies a hash offset. The value range for this argument is 0 to 15.
Usage guidelines
IMPORTANT: Misuse of this command causes unbalanced traffic distribution. Make sure you are fully aware of the impacts of this command when you execute it on a live network. |
If undesirable traffic imbalance occurs on link aggregations, you can use this command to adjust the load sharing results on link aggregations.
If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Set the hash offset to 2 for the load balancing hash results on link aggregations.
<Sysname> system
[Sysname] link-aggregation global load-sharing offset 2
link-aggregation global load-sharing seed
Use link-aggregation global load-sharing seed to configure a link aggregation load sharing hash seed.
Use undo link-aggregation global load-sharing seed to restore the default.
Syntax
link-aggregation global load-sharing seed seed-number
undo link-aggregation global load-sharing seed
Default
The link aggregation load sharing hash seed is 0x1.
Views
System view
Predefined user roles
network-admin
Parameters
seed seed-number: Specifies a seed. The value range for the seed-number argument is 0 to FFFF.
Usage guidelines
If you execute this command multiple times, the most recent configuration takes effect.
This command does not take effect on per-flow load sharing.
The load sharing hash seed is a parameter used in hashing. In default load sharing mode, if the device fails to load share traffic flows across all Selected ports, repeat the following procedure until the problem is resolved:
1. Configure the load sharing hash seed.
2. Use the display counters command to view traffic statistics on Selected ports.
You can use a load sharing algorithm and a hash seed individually or in combination to obtain the optimal load sharing performance.
Examples
# Specify 1023 (3FF in hexadecimal format) as the link aggregation load sharing hash seed.
<Sysname> system-view
[Sysname] link-aggregation global load-sharing seed 3FF
Related commands
display counters (Interface Command Reference)
display link-aggregation load-sharing mode
link-aggregation global load-sharing algorithm
link-aggregation global load-sharing mode
link-aggregation load-sharing mode
link-aggregation global load-sharing tunnel
Use link-aggregation global load-sharing tunnel to set the load sharing mode for tunneled traffic on link aggregations.
Use undo link-aggregation global load-sharing tunnel to restore the default.
Syntax
link-aggregation global load-sharing tunnel { all | inner | outer }
undo link-aggregation global load-sharing tunnel
Default
Tunneled traffic is distributed based on the outer IP header on aggregate links.
Views
System view
Predefined user roles
network-admin
Parameters
all: Distributes tunneled traffic based on the inner IP header and outer IP header.
inner: Distributes tunneled traffic based on the inner IP header.
outer: Distributes tunneled traffic based on the outer IP header.
Usage guidelines
This command sets the criterion used by aggregation groups to distribute tunneled traffic for load sharing.
If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Set the load sharing mode to inner IP header for tunneled traffic on link aggregations.
<Sysname> system
[Sysname] link-aggregation global load-sharing tunnel inner
link-aggregation ignore speed
Use link-aggregation ignore speed to configure the system to ignore port speed when it sets the aggregation states of the member ports in an aggregation group.
Use undo link-aggregation ignore speed to restore the default.
Syntax
link-aggregation ignore speed
undo link-aggregation ignore speed
Default
The system does not ignore port speed when it sets the aggregation states of the member ports in an aggregation group.
Views
Layer 2 aggregate interface view
Layer 3 aggregate interface view
Predefined user roles
network-admin
Usage guidelines
IMPORTANT: Make sure you are fully aware of the impacts of this command when you execute it on a live network. · When you execute this command or its undo form, the operational key changes and the aggregate interface flaps temporarily. · This command might cause traffic loss on Selected ports operating at a speed lower than the other Selected ports in the aggregation group when traffic is distributed among the ports. |
This command allows ports at a different speed than the reference port to become Selected by ignoring the port speed during operational key calculation.
You must configure the same port speed ignoring setting at the two ends of a static configuration to ensure that the peer ports are placed in the same aggregation state. This requirement does not apply to a dynamic aggregation, on which the two ends negotiate the aggregation state of the peer ports automatically.
Examples
# Configure the system to ignore port speed when it sets the aggregation states of member ports in Layer 2 aggregation group 1.
<Sysname> system-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1] link-aggregation ignore speed
link-aggregation lacp traffic-redirect-notification enable
Use link-aggregation lacp traffic-redirect-notification enable to enable link-aggregation traffic redirection.
Use undo link-aggregation lacp traffic-redirect-notification enable to disable link-aggregation traffic redirection.
Syntax
link-aggregation lacp traffic-redirect-notification enable
undo link-aggregation lacp traffic-redirect-notification enable
Default
Link-aggregation traffic redirection is disabled.
Views
System view
Layer 2 aggregate interface view
Layer 3 aggregate interface view
Predefined user roles
network-admin
Usage guidelines
This feature redirects traffic on a Selected port to the remaining available Selected ports of an aggregation group if one of the following events occurs:
· The port is shut down by using the shutdown command.
· The slot that hosts the port reboots, and the aggregation group spans multiple slots.
|
NOTE: The device does not redirect traffic to member ports that become Selected during the traffic redirection process. |
This feature ensures zero packet loss for known unicast traffic, but does not protect unknown unicast traffic.
This feature applies only to dynamic link aggregation groups.
To prevent traffic interruption, enable link-aggregation traffic redirection on devices at both ends of the aggregate link.
To prevent packet loss that might occur when a slot reboots, do not enable spanning tree together with link-aggregation traffic redirection.
Global link-aggregation traffic redirection settings take effect on all aggregation groups. A link aggregation group preferentially uses the group-specific link-aggregation traffic redirection settings. If group-specific link-aggregation traffic redirection is not configured, the group uses the global link-aggregation traffic redirection settings.
As a best practice, enable link-aggregation traffic redirection on a per-interface basis. If you enable this feature globally, communication with a third-party peer device might be affected if the peer is not compatible with this feature.
Examples
# Enable link-aggregation traffic redirection.
<Sysname> system-view
[Sysname] link-aggregation lacp traffic-redirect-notification enable
link-aggregation load-sharing mode
Use link-aggregation load-sharing mode to set the link-aggregation load sharing mode for an aggregation group.
Use undo link-aggregation load-sharing mode to restore the default.
Syntax
link-aggregation load-sharing mode flexible
undo link-aggregation load-sharing mode
Default
The group-specific load sharing mode is the same as the global load sharing mode.
Views
Layer 2 aggregate interface view
Layer 3 aggregate interface view
Predefined user roles
network-admin
Parameters
flexible: Automatically chooses a load sharing mode depending on the packet type. For example, load sharing mode differs for Layer 2, IPv4, and IPv6 packets.
Examples
# Configure Layer 2 aggregation group 1 to automatically choose a load sharing mode depending on the packet type.
<Sysname> system-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1] link-aggregation load-sharing mode flexible
Related commands
link-aggregation global load-sharing mode
link-aggregation management-subnet
Use link-aggregation management-subnet to specify a link aggregation management subnet.
Use undo link-aggregation management-subnet to remove a link aggregation management subnet.
Syntax
link-aggregation management-subnet ip-address { mask | mask-length }
undo link-aggregation management-subnet ip-address { mask | mask-length }
Default
No link aggregation management subnets are specified.
Views
System view
Predefined user roles
network-admin
Parameters
ip-address: Specifies an IP address in dotted decimal notation.
mask: Specifies the subnet mask in dotted decimal notation.
mask-length: Specifies the mask length. The value range is 0 to 32.
Usage guidelines
Typically, an aggregate interface distributes traffic across its Selected member ports. The uplink and downlink traffic of a host might be distributed to different member ports. To make sure the bidirectional traffic of a subnet traverses the same member port, you can exclude that subnet from load sharing by specifying it as a link aggregation management subnet.
When a link aggregate interface receives an ARP packet from the management subnet, the device looks up the sender IP address in the ARP table for a matching entry.
· If no matching entry exists, the device creates an ARP entry on the aggregation member port from which the packet came in. This mechanism ensures that the returned downlink traffic will be forwarded out of the member port that received the uplink traffic.
· If an ARP entry already exists on a different port than the link aggregate interface or its member ports, the device does not update that ARP entry. Instead, the device broadcasts an ARP request out of all ports to relearn the ARP entry.
When a link aggregate interface sends an ARP packet to the management subnet, the device sends the packet out of all Selected member ports of the link aggregate interface.
You can configure a maximum of 20 management subnets.
To ensure correct packet forwarding, delete all ARP entries of a subnet before you specify it as a management subnet or after you remove it from the management subnet list.
If you are using link aggregation management subnets, do not configure ARP snooping. For more information about ARP snooping, see Layer 3—IP Services Configuration Guide.
Examples
# Specify 22.1.1.1/8 as a link aggregation management subnet.
<Sysname> system-view
[Sysname] link-aggregation management-subnet 22.1.1.1 255.0.0.0
link-aggregation mode
Use link-aggregation mode dynamic to configure an aggregation group to operate in dynamic aggregation mode and enable LACP.
Use undo link-aggregation mode to restore the default.
Syntax
link-aggregation mode dynamic
undo link-aggregation mode
Default
An aggregation group operates in static aggregation mode.
Views
Layer 2 aggregate interface view
Layer 3 aggregate interface view
Predefined user roles
network-admin
Usage guidelines
When you change the aggregation mode, make sure you understand the impact of the change on services.
Aggregation mode change might cause Selected member ports to become Unselected.
Examples
# Configure Layer 2 aggregation group 1 to operate in dynamic aggregation mode.
<Sysname> system-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1] link-aggregation mode dynamic
link-aggregation port-priority
Use link-aggregation port-priority to set the port priority of an interface.
Use undo link-aggregation port-priority to restore the default.
Syntax
link-aggregation port-priority priority
undo link-aggregation port-priority
Default
The port priority of an interface is 32768.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Predefined user roles
network-admin
Parameters
priority: Specifies the port priority in the range of 0 to 65535. The smaller the value, the higher the port priority.
Examples
# Set the port priority to 64 for Layer 2 Ethernet interface HundredGigE 1/0/1.
<Sysname> system-view
[Sysname] interface hundredgige 1/0/1
[Sysname-HundredGigE1/0/1] link-aggregation port-priority 64
# Set the port priority to 64 for Layer 3 Ethernet interface HundredGigE 1/0/2.
<Sysname> system-view
[Sysname] interface hundredgige 1/0/2
[Sysname-HundredGigE1/0/2] link-aggregation port-priority 64
Related commands
lacp system-priority
link-aggregation selected-port maximum
Use link-aggregation selected-port maximum to set the maximum number of Selected ports allowed in an aggregation group.
Use undo link-aggregation selected-port maximum to restore the default.
Syntax
link-aggregation selected-port maximum max-number
undo link-aggregation selected-port maximum
Default
An aggregation group can contain a maximum of 16 Selected ports.
Views
Layer 2 aggregate interface view
Layer 3 aggregate interface view
Predefined user roles
network-admin
Parameters
max-number: Specifies the maximum number of Selected ports allowed in an aggregation group. The value range for this argument is 1 to 256.
Usage guidelines
Executing this command might cause some of the Selected ports in an aggregation group to become Unselected ports.
The maximum number of Selected ports allowed in the aggregation groups must be the same for the local and peer ends.
For an aggregation group, the maximum number of Selected ports must be equal to or higher than the minimum number of Selected ports.
The maximum number of Selected ports allowed in an aggregation group is limited by one of the following values, whichever value is smaller:
· Maximum number set by using the link-aggregation selected-port maximum command.
· Maximum number of Selected ports allowed by the link aggregation capability.
You can implement backup between two ports by performing the following tasks:
· Assigning two ports to an aggregation group.
· Setting the maximum number of Selected ports to 1 for the aggregation group.
Then, only one Selected port is allowed in the aggregation group at any point in time, while the Unselected port acts as a backup port.
Examples
# Set the maximum number of Selected ports to 5 for Layer 2 aggregation group 1.
<Sysname> system-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1] link-aggregation selected-port maximum 5
Related commands
link-aggregation selected-port minimum
link-aggregation selected-port minimum
Use link-aggregation selected-port minimum to set the minimum number of Selected ports in an aggregation group.
Use undo link-aggregation selected-port minimum to restore the default.
Syntax
link-aggregation selected-port minimum min-number
undo link-aggregation selected-port minimum
Default
The minimum number of Selected ports in an aggregation group is not specified.
Views
Layer 2 aggregate interface view
Layer 3 aggregate interface view
Predefined user roles
network-admin
Parameters
min-number: Specifies the minimum number of Selected ports in an aggregation group required to bring up the aggregate interface. The value range for this argument is 1 to 256.
Usage guidelines
Executing this command might cause all member ports in the aggregation group to become Unselected ports.
The minimum number of Selected ports allowed in the aggregation groups must be the same for the local and peer ends.
For an aggregation group, the minimum number of Selected ports must be equal to or lower than the maximum number of Selected ports.
Examples
# Set the minimum number of Selected ports to 3 for Layer 2 aggregation group 1.
<Sysname> system-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1] link-aggregation selected-port minimum 3
Related commands
link-aggregation selected-port maximum
link-aggregation selected-port minimum percentage
Use link-aggregation selected-port minimum percentage to set the minimum percentage of Selected ports in an aggregation group.
Use undo link-aggregation selected-port minimum percentage to restore the default.
Syntax
link-aggregation selected-port minimum percentage number
undo link-aggregation selected-port minimum percentage
Default
The minimum percentage of Selected ports is not set for an aggregation group.
Views
Layer 2 aggregate interface view
Layer 3 aggregate interface view
Predefined user roles
network-admin
Parameters
number: Specifies the minimum percentage of Selected ports. The value range for this argument is 1 to 100.
Usage guidelines
CAUTION: After you execute this command, aggregate interface flapping might occur when ports join or leave an aggregation group. Make sure you are fully aware of the impacts of this command when you execute it on a live network. |
You must set the same minimum percentage of Selected ports at the two ends of an aggregate link.
The minimum number of Selected ports in an aggregation group equals the higher one of the following values:
· The number of member ports in the aggregation group multiplied by the minimum percentage of Selected ports.
· The limit set by using the link-aggregation selected-port minimum command.
Examples
# Set the minimum percentage of Selected ports to 50% for Layer 2 aggregate interface Bridge-Aggregation 1.
<Sysname> system-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1] link-aggregation selected-port minimum percentage 50
# Set the minimum percentage of Selected ports to 50% for Layer 3 aggregate interface Route-Aggregation 1.
<Sysname> system-view
[Sysname] interface route-aggregation 1
[Sysname-Route-Aggregation1] link-aggregation selected-port minimum percentage 50
Related commands
link-aggregation selected-port minimum
mac-address
Use mac-address to assign a MAC address to an aggregate interface or subinterface.
Use undo mac-address to restore the default.
Syntax
mac-address mac-address
undo mac-address
Default
No MAC address is assigned to an aggregate interface.
Views
Layer 3 aggregate interface view
Layer 3 aggregate subinterface view
Predefined user roles
network-admin
Parameters
mac-address: Specifies a MAC address in the format of H-H-H.
Usage guidelines
The default MAC address of Layer 3 aggregate interfaces varies by device. You can use the display interface command to view the MAC address of a Layer 3 aggregate interface.
When you assign a MAC address to a Layer 3 interface after a base MAC address has been configured, make sure the following requirements are met:
· The MAC address must have the same higher 36 bits as the base MAC address.
· The MAC address must be equal to or higher than the base MAC address plus 160 (decimal).
For more information about the base MAC address, see MAC address table configuration in Layer 2—LAN Switching Configuration Guide.
Examples
# Assign MAC address 0001-0001-0002 to interface Route-Aggregation 1.
<Sysname> system-view
[Sysname] interface route-aggregation 1
[Sysname-Route-Aggregation1] mac-address 1-1-2
mtu
Use mtu to set the MTU of a Layer 3 aggregate interface or subinterface.
Use undo mtu to restore the default.
Syntax
mtu size
undo mtu
Default
The MTU of Layer 3 aggregate interfaces and subinterfaces is 1500 bytes.
Views
Layer 3 aggregate interface view
Layer 3 aggregate subinterface view
Predefined user roles
network-admin
Parameters
size: Specifies an MTU in bytes. The value range for this argument is 46 to 9216..
Examples
# Set the MTU of interface Route-Aggregation 1 to 1430 bytes.
<Sysname> system-view
[Sysname] interface route-aggregation 1
[Sysname-Route-Aggregation1] mtu 1430
display interface
port link-aggregation group
Use port link-aggregation group to assign an interface to an aggregation group.
Use undo port link-aggregation group to remove an interface from the aggregation group to which it belongs.
Syntax
port link-aggregation group { group-id [ force ] | auto [ group-id ] }
undo port link-aggregation group
Default
An interface does not belong to any aggregation group.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Predefined user roles
network-admin
Parameters
group-id: Specifies an aggregation group by its aggregate interface number. The value range for the number argument is 1 to 1024.
force: Enables the current interface to synchronize attribute configurations from the aggregate interface. If you do not specify this keyword, the current interface does not synchronize attribute configurations from the aggregate interface when it joins the aggregation group. This keyword is supported only on Layer 2 Ethernet interfaces.
auto: Enables automatic assignment.
Usage guidelines
A Layer 2 Ethernet interface can be assigned only to a Layer 2 aggregation group. A Layer 3 Ethernet interface can be assigned only to a Layer 3 aggregation group.
An interface can belong to only one aggregation group.
An interface cannot join an aggregation group if it has different attribute configurations from the aggregate interface. After joining an aggregation group, an interface inherits the attribute configurations on the aggregate interface. You can modify the attribute configurations only on the aggregate interface.
The force keyword takes effect only when you assign the interface to an aggregation group. It cannot be saved in the running configuration or a configuration file.
Automatic assignment is available only on Layer 2 and Layer 3 Ethernet interfaces.
When you enable automatic assignment, you can specify a preferred aggregation group, which must be in dynamic mode.
The device assigns the interface to the preferred aggregation group as long as the LACPDUs received on the interface match the peer information of the reference port in the group.
If you do not specify a preferred group or if the preferred group match fails, the device attempts to select a matching group from the existing dynamic aggregation groups. If no match is found, the device creates a dynamic aggregation group based on the LACPDUs and assigns the interface to that aggregation group.
As a best practice, do not modify the configuration on an automatically created aggregate interface or its member ports.
You cannot assign the following interfaces to an aggregation group:
· Member interfaces of redundant Ethernet interfaces.
· Member interfaces of redundancy group nodes.
For more information about redundant Ethernet interfaces and redundancy group nodes, see High Availability Configuration Guide.
Examples
# Assign Layer 2 Ethernet interface HundredGigE 1/0/1 to Layer 2 aggregation group 1.
<Sysname> system-view
[Sysname] interface hundredgige 1/0/1
[Sysname-HundredGigE1/0/1] port link-aggregation group 1
# Assign Layer 3 Ethernet interface HundredGigE 1/0/2 to Layer 3 aggregation group 2.
<Sysname> system-view
[Sysname] interface hundredgige 1/0/2
[Sysname-HundredGigE1/0/2] port link-aggregation group 2
reset lacp statistics
Use reset lacp statistics to clear LACP statistics for the specified link aggregation member ports.
Syntax
reset lacp statistics [ interface interface-list ]
Views
User view
Predefined user roles
network-admin
Parameters
interface interface-list: Specifies a list of link aggregation member ports, in the format interface-type interface-number1 [ to interface-type interface-number2 ]. The value for the interface-number1 argument must be equal to or greater than the value for the interface-number2 argument. If you do not specify any member ports, the command clears LACP statistics for all member ports.
Examples
# Clear LACP statistics for all link aggregation member ports.
<Sysname> reset lacp statistics
display link-aggregation member-port
sub-interface rate-statistic
Use sub-interface rate-statistic to enable rate statistics collection for the subinterfaces of a Layer 3 aggregate interface.
Use undo sub-interface rate-statistic to disable rate statistics collection for the subinterfaces of a Layer 3 aggregate interface.
Syntax
sub-interface rate-statistic
undo sub-interface rate-statistic
Default
Rate statistics collection is disabled for Layer 3 aggregate subinterfaces.
Views
Layer 3 aggregate interface view
Predefined user roles
network-admin
Usage guidelines
Rate statistics collection for Layer 3 aggregate subinterfaces is resource intensive. When you use this feature on a live network, make sure you fully understand its impact.
This command enables the device to periodically refresh rate statistics for the subinterfaces of a Layer 3 aggregate interface. The rate statistics are available in two statistics polling intervals after you execute this command. To set the statistics polling interval, use the flow-interval command.
Examples
# Enable rate statistics collection for the subinterfaces of Route-Aggregation 1.
<Sysname> system-view
[Sysname] interface route-aggregation 1
[Sysname-Route-Aggregation1] sub-interface rate-statistic
This configuration may make a negative effect on the performance. Are you sure to continue? [Y/N]:y
The configuration will take effect after 2 flow intervals.
Related commands
flow-interval (Interface Command Reference)