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.

Examples

# Display detailed information about Layer 2 aggregate interface Bridge-Aggregation 1.

<Sysname> display interface bridge-aggregation 1

Bridge-Aggregation1

Current state: DOWN

Line protocol state: DOWN

IP packet frame type: Ethernet II, hardware address: 0000-fc00-d218

Description: Bridge-Aggregation1 Interface

Unknown-speed mode, unknown-duplex mode

Link speed type is autonegotiation, link duplex type is autonegotiation

PVID: 1

Port link-type: Access

Tagged VLANs: None

Untagged VLANs: 1

Last clearing of counters: Never

Last 300 seconds input: 0 packets/sec 0 bytes/sec -%

Last 300 seconds output: 0 packets/sec 0 bytes/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 detailed information about Layer 3 aggregate interface Route-Aggregation 1.

<Sysname> display interface route-aggregation 1

Route-Aggregation1

Current state: DOWN

Line protocol state: DOWN

Description: Route-Aggregation1 Interface

Maximum transmission unit: 1500

Internet protocol processing: Disabled

IP packet frame type: Ethernet II, hardware address: 0000-fc00-d219

IPv6 packet frame type: Ethernet II, hardware address: 0000-fc00-d219

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

IPv4 traffic statistics:

Last 300 seconds input rate: 0 packets/sec, 0 bytes/sec

Last 300 seconds output rate: 0 packets/sec, 0 bytes/sec

Input: 0 packets, 0 bytes

Output: 0 packets, 0 bytes

IPv6 traffic statistics:

Last 300 seconds input rate: 0 packets/sec, 0 bytes/sec

Last 300 seconds output rate: 0 packets/sec, 0 bytes/sec

Input: 0 packets, 0 bytes

Output: 0 packets, 0 bytes

# 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. Possible IP address types include: · 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. · DHCP-Allocated—DHCP allocated IP address. For more information, see DHCP client configuration in Layer 3—IP Services Configuration Guide. · BOOTP-Allocated—BOOTP allocated IP address. For more information, see BOOTP client configuration in Layer 3—IP Services Configuration Guide. · Unnumbered—IP address borrowed from another interface.
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.
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).

Related commands

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.

Default link aggregation capability:

Maximum groups: 1000

Maximum Selected ports per group: 128

Current link aggregation capability:

Maximum groups: 1000

Maximum Selected ports per group: 128

Link aggregation capability at the next reboot:

Maximum groups: 1000

Maximum Selected ports per group: 128

Supported link aggregation capability list:

1000*128

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.

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

Only the S9855 switch series supports the interface keyword.

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 and route-aggregation keywords are available only when aggregate interfaces of the corresponding type 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:

0 (default)

Link-aggregation load-sharing offset:

0 (default)

Link-aggregation load-sharing seed:

0x0 (default)

Tunneled traffic load-sharing mode:

Default

Link-aggregation load-sharing mode:

Layer 2 traffic: ingress-port destination-mac address

source-mac address

Layer 3 traffic: ingress-port destination-ip address

source-ip address destination-port

source-port ip-protocol

# 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:

Link-aggregation load-sharing offset:

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 1. This example displays the default setting. (This example applies to products that do not support dynamic load sharing mode.)

<Sysname> display link-aggregation load-sharing mode interface bridge-aggregation 1

Bridge-Aggregation1 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 1. This example displays the default setting. (This example applies to products that support dynamic load sharing mode.)

<Sysname> display link-aggregation load-sharing mode interface bridge-aggregation 1

The dynamic load sharing mode takes effect if it exists.

Bridge-Aggregation1 load-sharing mode:

Dynamic:

N/A

Static:

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 1. This example displays a user-configured setting. (This example applies to products that do not support dynamic load sharing mode.)

<Sysname> display link-aggregation load-sharing mode interface bridge-aggregation 1

Bridge-Aggregation1 load-sharing mode:

destination-mac address, source-mac address

# Display the link-aggregation load sharing mode of Layer 2 aggregation group 1. This example displays a user-configured setting. (This example applies to products that support dynamic load sharing mode.)

<Sysname> display link-aggregation load-sharing mode interface bridge-aggregation 1

The dynamic load sharing mode takes effect if it exists.

Bridge-Aggregation1 load-sharing mode:

Dynamic:

Eligible (flowlet gap time: 1000 us)

Static:

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	It is not supported in the current software version. Load sharing mode for tunneled traffic on aggregate links. By default, this field displays Default. 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.
Blade-Aggregation1 load-sharing mode	Link-aggregation load sharing mode of Blade aggregation group 1. 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: ingress-port destination-mac address source-mac address	Default link-aggregation load sharing mode for Layer 2 traffic. In this sample output, Layer 2 traffic is load shared based on the ingress port, and source and destination MAC addresses.
Layer 3 traffic: ingress-port destination-ip address source-ip address destination-port source-port ip-protocol	Default link-aggregation load sharing mode for Layer 3 traffic. In this sample output, Layer 3 traffic is load shared based on the ingress port, source and destination IP addresses, source and destination port numbers, and protocol numbers.
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 | ethernet-type type-number | 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.

ethernet-type type-number: Specifies an Ethernet type code 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

CAUTION:

To ensure accuracy for the output information, make sure that the specified options are exactly matched with the fields in the packets transmitted in the aggregation group when you execute this command.

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.

To avoid inconsistency of the displayed forwarding information and the actual forwarding information, the options you entered for this command must be matched with the options in the display link-aggregation load-sharing mode command.

You cannot use this command to query broadcast packets, nonexistent forwarding entries, and illegal packets. You can use this command to query Layer 2 frames and Layer 3 packets only. For correctness of the query result, specify a correct aggregate interface and a destination MAC address when executing this command.

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. · vlan—Traffic is load shared based on VLAN IDs.
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 or nothing 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.
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 troubleshooting

Use display link-aggregation troubleshooting to display the aggregation states of aggregation member ports and the reason why a port was placed in Unselected state.

Syntax

display link-aggregation troubleshooting [ { 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 by its number.

Usage guidelines

If you do not specify an aggregate interface type, the command displays information about all aggregation groups.

If you specify an aggregate interface type but do not specify an interface number, the command displays information about all aggregation groups of the specified type.

You can specify the bridge-aggregation or route-aggregation keyword only when aggregate interfaces of the specified type exist on the device.

Examples

# Display the aggregation states of aggregation member ports for all aggregation groups and the reason why a port was placed in Unselected state.

<Sysname> display link-aggregation troubleshooting

Aggregate Interface: Bridge-Aggregation2

Member ports:

HGE1/0/2

Status: Selected

HGE1/0/3

Status: Unselected

Reason: The physical or line protocol state of the port is down

Advice: Check the connection

Table 8 Command output

Field	Description
Reason	Reason why the port was placed in Unselected state.
Advice	Recommended action.

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.

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

Role: P -- Primary, S -- Secondary

Aggregate Interface: Bridge-Aggregation10

Creation Mode: Manual

Aggregation Mode: Dynamic

Loadsharing Type: Shar

Management VLANs: None

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

Role: P -- Primary, S -- Secondary

Aggregate Interface: Bridge-Aggregation20

Aggregation Mode: Static

Loadsharing Type: Shar

Management VLANs: None

Port Status Priority Oper-Key Role

HGE1/0/1(R) S 32768 1 None

HGE1/0/2 S 32768 1 None

HGE1/0/3 S 32768 1 None

Table 9 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.
Role	Role of the port in the aggregation group operating in 1+1 backup mode: · Primary. · Secondary. If the aggregation group is not operating in 1+1 backup mode, None is displayed.
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.
Management VLANs	Management VLANs. If no management VLANs are specified, this field displays None.
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 1000.

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

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

[Sysname-Route-Aggregation1]

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 with a maximum length of 9216 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 9216.

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.

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-mac

Use lacp system-mac to set the LACP system MAC address.

Use undo lacp system to restore the default.

Syntax

lacp system-mac mac-address

undo lacp system-mac

Default

The LACP system MAC address is the bridge MAC address of the device.

Views

System view

Predefined user roles

network-admin

Parameters

mac-address: Specifies a MAC address in the format of H-H-H. The MAC address cannot be an all-zero, all-F, or multicast MAC address.

Usage guidelines

All S-MLAG devices must use the same LACP system MAC address.

LACPDUs carry the LACP system MAC address configured by using this command. To identify the LACP system MAC address used by a link aggregation group, examine the System ID field in the output from the display link-aggregation verbose command.

You can configure the LACP system MAC address globally and in aggregate interface view. The global LACP system MAC address takes effect on all aggregation groups, and an aggregate-interface-specific LACP system MAC address takes precedence over the global LACP system MAC address.

On an M-LAG system, M-LAG interfaces in the same M-LAG group cannot use the same LACP system MAC address.

Examples

# Set the LACP system MAC address to 0001-0001-0001.

<Sysname> system-view

[Sysname] lacp system-mac 1-1-1

Related commands

display link-aggregation verbose

lacp system-number

Use lacp system-number to set the LACP system number used by the local device.

Use undo lacp system-number to restore the default.

Syntax

lacp system-number number

undo lacp system-number

Default

The LACP system number is not set.

Views

System view

Predefined user roles

network-admin

Parameters

number: Specifies a number in the range of 1 to 3.

Usage guidelines

You must assign a unique LACP system number to each S-MLAG device.

The LACP system number configured by using this command takes effect only on aggregate interfaces in S-MLAG groups. Aggregate interfaces not in S-MLAG groups do not use the configured LACP system number in LACPDUs. To view the LACP system number in LACPDUs, examine the Index field in the output from the display link-aggregation verbose command.

Examples

# Set the LACP system number to 1.

<Sysname> system-view

[Sysname] lacp system-number 1

Related commands

display link-aggregation verbose

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.

Usage guidelines

LACPDUs carry the LACP system priority configured by using this command. To identify the LACP system priority used by a link aggregation group, examine the System ID field in the output from the display link-aggregation verbose command.

You can configure the LACP system priority globally and in aggregate interface view. The global LACP system priority takes effect on all aggregation groups, and an aggregate-interface-specific LACP system priority takes precedence over the global 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 bfd

Use link-aggregation bfd 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 ipv4-address destination ipv4-address

undo link-aggregation bfd [ ipv4 ]

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

ipv4: Specifies IPv4 BFD.

source: Specifies the unicast source IP address of BFD sessions.

destination: Specifies the unicast destination IP address of BFD sessions.

ipv4-address: Specifies an IPv4 address. The 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 bfd-compatible enable

Use link-aggregation bfd-compatible enable to enable BFD compatible mode on an aggregate interface.

Use undo link-aggregation bfd-compatible enable to disable BFD compatible mode on an aggregate interface.

Syntax

link-aggregation bfd-compatible enable

undo link-aggregation bfd-compatible enable

Default

BFD compatible mode is disabled on aggregate interfaces.

Views

Layer 2 aggregate interface view

Layer 3 aggregate interface view

Predefined user roles

network-admin

Usage guidelines

BFD compatible mode enables BFD to operate correctly on an aggregate link whose remote end is a third-party device that implements BFD differently from the device.

With BFD compatible mode enabled, all member ports in an aggregation group establish BFD sessions with their peer ports. The BFD sessions are not deleted or re-established when the aggregation states of the member ports change.

Examples

# Enable BFD compatible mode on Bridge-Aggregation 1.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] link-aggregation bfd-compatible enable

# Enable BFD compatible mode on Route-Aggregation 1.

<Sysname> system-view

[Sysname] interface route-aggregation 1

[Sysname-Route-Aggregation1] link-aggregation bfd-compatible enable

Related commands

link-aggregation bfd

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 S9855 switch series supports up to 1000 aggregation groups, with a maximum of 128 Selected ports per aggregation group.

The S9825 switch series supports up to 248 aggregation groups, with a maximum of 64 Selected ports per aggregation group.

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. On the S9855 switch series, the value is 1000. On the S9825 switch series, the value is 248.

max-selected-port max-selected-port-number: Specifies the maximum number of Selected ports per aggregation group. On the S9855 switch series, the value is 128. On the S9825 switch series, the value is 64.

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 1000 aggregation groups and a maximum of 128 Selected ports per aggregation group.

<Sysname> system-view

[Sysname] link-aggregation capability max-group 1000 max-selected-port 128

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

The link aggregation capability is not configured.

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

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 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 | flow-label | ingress-port | ip-protocol | source-ip | source-mac | source-port | vlan-id } *

undo link-aggregation global load-sharing mode

Default

Layer 2 frames are loaded shared based on the following modes:

· Ingress port.

· Destination MAC address.

· Source MAC address.

Layer 3 packets are loaded shared based on the following modes:

· Ingress port.

· Destination IP address.

· Source IP address.

· Destination port number.

· Source port number.

· Protocol number.

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.

flow-label: Distributes traffic based on flow labels.

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.

vlan-id: Distributes traffic based on VLAN IDs.

Usage guidelines

If you execute this command multiple times, the most recent configuration takes effect.

The global link-aggregation load sharing mode can be any combination of the hashing keys.

For the S9825 switch series, if you distribute traffic based on MAC addresses together with IP addresses or port numbers simultaneously, some of the hashing keys might not take effect. Make sure you are fully aware of the impacts of this operation.

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

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

No hash offset for the load balancing hash result is configured.

Views

System view

Predefined user roles

network-admin

Parameters

offset-value: Specifies a hash offset. The value range for this argument is 1 to 63.

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

No hash seed is configured.

Views

System view

Predefined user roles

network-admin

Parameters

seed seed-number: Specifies a seed. The value range for the seed-number argument is 1 to FFFFFFFF.

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

No load sharing mode is configured for tunneled traffic.

Views

System view

Predefined user roles

network-admin

Parameters

all: Distributes tunneled traffic based on the inner IP header and outer IP header. The S9825 switch series does not support this keyword. On the S9855 switch series, the device will distribute tunneled traffic based on the inner IP header and outer IP header after you specify the all keyword.

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.

On the S9825 switch series, when you configure both load sharing based on the inner IP header of tunnel packets and global link-aggregation load sharing based on Layer 2 fields, the tunnel packets will be load-shared according to the outer Layer 2 fields.

On the S9825 switch series, when you configure both load sharing based on the inner IP header of tunnel packets and global link-aggregation load sharing based on both Layer 2 and Layer 3 fields, the tunnel packets will be load-shared by packet type.

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 lacp isolate

Use link-aggregation lacp isolate to isolate aggregate interfaces on the device.

Use undo link-aggregation lacp isolate to remove aggregate interface isolation.

Syntax

link-aggregation lacp isolate

undo link-aggregation lacp isolate

Default

Aggregate interfaces are not isolated.

Views

System view

Predefined user roles

network-admin

Usage guidelines

Aggregate interface isolation is applicable to the aggregate interfaces that act as M-LAG interfaces when the device acts an M-LAG member device in an M-LAG system. It gracefully changes all M-LAG interfaces on the device to the Unselected state and switch traffic over to their counterpart M-LAG interfaces on the other M-LAG member device.

This feature takes effect only on dynamic aggregate interfaces. It cannot isolate static aggregate interfaces or peer-link interfaces in an M-LAG system.

As a best practice, make sure no M-LAG interfaces are in M-LAG MAD DOWN state before you isolate them. If one of the M-LAG interfaces is in M-LAG MAD DOWN state when you isolate them, that M-LAG interface will persist in that state and cannot forward traffic after the isolation is removed.

Examples

# Isolate aggregate interfaces.

<Sysname> system-view

[Sysname] link-aggregation lacp isolate

link-aggregation load-sharing ignore

Use link-aggregation load-sharing ignore to specify ignored packet fields for default link-aggregation load sharing.

Use undo link-aggregation load-sharing ignore to restore the default.

Syntax

link-aggregation load-sharing ignore { destination-ip | destination-mac | destination-port | ingress-port | ip-protocol | source-ip | source-mac | source-port | vlan-id } *

undo link-aggregation load-sharing ignore

Default

No ignored packet fields are specified for default link-aggregation load sharing.

Views

System view

Predefined user roles

network-admin

Parameters

destination-ip: Specifies the destination IP address.

destination-mac: Specifies the destination MAC address.

destination-port: Specifies the destination port.

ingress-port: Specifies the ingress port.

ip-protocol: Specifies IP protocol type.

source-ip: Specifies the source IP address.

source-mac: Specifies the source MAC address.

source-port: Specifies the source port.

vlan-id: Specifies the VLAN ID.

Usage guidelines

In default load sharing mode, an aggregation group might fail to load share traffic in a balanced manner. To resolve the problem, you can configure the device to ignore specific packet fields for link-aggregation load sharing. The specified packet field values are ignored in load sharing calculation.

Examples

# Configure the device to ignore the EtherType value for default link-aggregation load sharing.

<Sysname> system-view

[Sysname] link-aggregation load-sharing ignore vlan-id

Related commands

link-aggregation global load-sharing mode

link-aggregation load-sharing mode dynamic

Use link-aggregation load-sharing mode dynamic to configure a dynamic load sharing mode on an aggregate interface.

Use undo link-aggregation load-sharing mode dynamic to restore the default.

NOTE:

This command is supported only on the S9855 switch series.

Syntax

link-aggregation load-sharing mode dynamic { eligible [ flowlet-gap-time flowlet-gap-time ] | fixed | spray }

undo link-aggregation load-sharing mode dynamic

Default

An aggregation group uses the static load sharing mode.

Views

Layer 2 aggregate interface view

Predefined user roles

network-admin

Parameters

eligible: Specifies the eligible mode. This mode distributes the traffic from a flow on a per-flowlet basis. Flowlets are bursts of packets from a flow, which are separated based on the flowlet gap timer. If the forwarding latency between two bursts of packets is larger than the flowlet gap timer, they are two flowlets and can be forwarded on different links. The link selected for a flowlet is the least utilized link at the time of selection.

flowlet-gap-time flowlet-gap-time: Sets the flowlet gap timer, in the range of 16 to 3200 microseconds. The default is 1000.

fixed: Specifies the fixed mode. This mode distributes traffic across the aggregation member links on a per-flow basis. The link selected for a flow is the least utilized link at the time of selection.

spray: Specifies the spray mode. This mode distributes traffic across the aggregation member links on a per-packet basis. The link selected for a packet is the least utilized link at the time of selection.

IMPORTANT:

In spray mode, packets in a flow might be distributed to different links and arrive at the receiving device out of order. When you use this mode, you must make sure the receiving device supports packet reordering.

Usage guidelines

If you execute this command multiple times, the most recent configuration takes effect.

The dynamic load sharing mode has priority over the static load sharing mode configured by using the link-aggregation load-sharing mode command.

Dynamic load sharing is supported only for known unicast packets, and you can configure this feature only between devices of the same series.

Changing the global static load sharing mode affects the dynamic load sharing mode configured on an aggregation group and impacts load sharing.

Examples

# Enable the eligible dynamic load sharing mode on interface Bridge-Aggregation 1 and set the flowlet gap timer to 2000 microseconds.

<Sysname> system-view

[Syaname] interface bridge-aggregation 1

[Syaname-Bridge-Aggregation1] link-aggregation load-sharing mode dynamic eligible flowlet-gap-time 2000

Related commands

display link-aggregation load-sharing mode

link-aggregation mode

Use link-aggregation mode to set the aggregation mode of an aggregation group.

Use undo link-aggregation mode to restore the default.

Syntax

link-aggregation mode { dynamic | static [ backup ] }

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

Parameters

dynamic: Specifies dynamic mode and enables LACP.

static: Specifies static mode.

backup: Specifies static 1+1 backup mode. If you do not specify this keyword, 1+1 backup is not enabled. Only Layer 3 aggregate interfaces support this keyword.

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.

The following restrictions apply to an aggregation group operating in 1+1 backup mode:

· The aggregation group can contain a maximum of two member ports.

· The maximum and minimum limits on the number of Selected ports in the aggregation group do not take effect.

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 primary-port

Use link-aggregation primary-port to assign the primary role to a member port in a 1+1 backup aggregation group.

Use undo link-aggregation primary-port to restore the default.

Syntax

link-aggregation primary-port

undo link-aggregation primary-port

Default

A member port is not assigned the primary role in a 1+1 backup aggregation group.

Views

Layer 3 Ethernet interface view

Predefined user roles

network-admin

Usage guidelines

In a 1+1 backup aggregation group, the primary member port is placed in Selected state to forward all traffic, and the secondary member port is placed in Unselected state as a standby. You can specify a primary member port with this command or let the system to select a primary member port. If you specify a primary member port for a 1+1 backup aggregation group, the aggregation group can revert to the primary member port when that port recovers from failure. As a best practice, use this command to manually specify a primary member port.

If you do not specify a primary member port for an aggregation group, the system acts as follows:

· Assigns the primary role to the reference port if the member ports join the aggregation group simultaneously.

· Assigns the primary role to the member port that first becomes Selected if the member ports join the aggregation group successively.

This command is not available on a port that is not an aggregation group member or is in an aggregation group not operating in 1+1 backup mode.

A 1+1 backup aggregation group can have only one primary member port.

Examples

# Assign the primary role to HundredGigE 1/0/1.

<Sysname> system-view

[Sysname] interface hundredgige 1/0/1

[Sysname-HundredGigE1/0/1] port link-aggregation group 1

[Sysname-HundredGigE1/0/1] link-aggregation primary-port

link-aggregation reversion delay

Use link-aggregation reversion delay to set the reversion delay for a 1+1 backup aggregation group.

Use undo link-aggregation reversion delay to restore the default.

Syntax

link-aggregation reversion delay time-value

undo link-aggregation reversion delay

Default

A 1+1 backup aggregation group reverts to the primary member port immediately after that port recovers from failure.

Views

Layer 3 aggregate interface view

Predefined user roles

network-admin

Parameters

time-value: Sets a reversion delay in the range of 1 to 65535 seconds.

Usage guidelines

The reversion delay is the time a 1+1 backup aggregation group must wait before reverting to the primary member port after that port recovers from failure. This timer prevents link flapping from causing frequent primary/secondary member port switchovers.

For this command to take effect on an aggregation group, first configure the aggregation group to operate in 1+1 backup mode and manually specify its primary member port.

Examples

# Set the reversion delay to 5 seconds on Route-Aggregation 1.

<Sysname> system-view

[Sysname] interface route-aggregation 1

[Sysname-Route-Aggregation1] link-aggregation reversion delay 5

Related commands

link-aggregation mode

link-aggregation primary-port

link-aggregation secondary-down

Use link-aggregation secondary-down to configure a 1+1 backup aggregation group to place its secondary member port in down state.

Use undo link-aggregation secondary-down to restore the default.

Syntax

link-aggregation secondary-down

undo link-aggregation secondary-down

Default

In a 1+1 backup aggregation group, the secondary member port is in Unselected state.

Views

Layer 3 aggregate interface view

Predefined user roles

network-admin

Usage guidelines

If the peer for a 1+1 backup aggregation group is unaware of the member port roles, it might send traffic to the secondary member port, and traffic loss occurs consequently. To prevent traffic loss, configure the aggregation group to place its secondary member port in down state. This allows the peer and local ends to use only up ports to transmit traffic.

For this command to take effect on an aggregation group, first configure the aggregation group to operate in 1+1 backup mode.

Examples

# Configure Route-Aggregation 1 to place its secondary member port in down state.

<Sysname> system-view

[Sysname] interface route-aggregation 1

[Sysname-Route-Aggregation1] link-aggregation secondary-down

Related commands

link-aggregation mode

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 [ lacp-sync ]

undo link-aggregation selected-port maximum

Default

The maximum number of Selected ports allowed in an aggregation group is 128.

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

lacp-sync: Synchronizes the maximum number of Selected ports through LACPDUs. If you do not specify this keyword, the aggregate interface does not synchronize the maximum number of Selected ports with the peer.

Usage guidelines

Executing this command might cause some of the Selected ports in an aggregation group to become Unselected ports.

On a static aggregate link, you must set the maximum number of Selected ports to the same value at its two ends.

On a dynamic aggregate link, you must set the maximum number of Selected ports to the same value at its two ends if you do not specify the lacp-sync keyword. If you specify this keyword, the two ends of the aggregate link compare their maximum Selected port number settings and use the smaller value.

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

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. For the S9825 switch series, the value range for this argument is 1 to 64. For the S9855 switch series, the value range for this argument is 1 to 128.

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

link-aggregation switchover

Use link-aggregation switchover to perform a primary/secondary member port switchover in a 1+1 backup aggregation group.

Syntax

link-aggregation switchover

Views

Layer 3 aggregate interface view

Predefined user roles

network-admin

Usage guidelines

CAUTION:

This command might cause traffic loss. Make sure you are fully aware of the impacts of this command when you execute it on a live network.

Use this command to switch member port roles for a 1+1 backup aggregation group whose primary member port is set by the system when the state of peer ports changes.

If the link-aggregation secondary-down command has been executed for the aggregation group, the link-aggregation switchover command brings up the down secondary member port for it to take over the primary role.

Before you execute the link-aggregation switchover command for a 1+1 backup aggregation group, verify that the following requirements are met:

· The aggregation group contains one Selected port and one Unselected port.

· The primary member port is set by the system.

· The secondary member port can become Selected.

Examples

# Perform a primary/secondary member port switchover in the aggregation group of Route-Aggregation 1.

<Sysname> system-view

[Sysname] interface route-aggregation 1

[Sysname-Route-Aggregation1] link-aggregation switchover

This operation will change the current link status. Continue? [Y/N]:

Related commands

link-aggregation mode

link-aggregation primary-port

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.

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

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

Related commands

display interface

port lacp system-mac

Use port lacp system-mac to set the LACP system MAC address on an aggregate interface.

Use undo port lacp system to restore the default.

Syntax

port lacp system-mac mac-address

undo port lacp system-mac

Default

The LACP system MAC address is the bridge MAC address of the device.

Views

Layer 2 aggregate interface view

Layer 3 aggregate interface view

Predefined user roles

network-admin

Parameters

mac-address: Specifies a MAC address in the format of H-H-H. The MAC address cannot be an all-zero, all-F, or multicast MAC address.

Usage guidelines

Member devices in an S-MLAG system must use the same LACP system MAC address.

On an M-LAG system, M-LAG interfaces in the same M-LAG group must use the same LACP system MAC address.

Examples

# Set the LACP system MAC address to 0002-0002-0002 on Bridge-Aggregation 1.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] port lacp system-mac 2-2-2

Related commands

display link-aggregation verbose

lacp system-mac

port lacp system-priority

Use port lacp system-priority to set the LACP system priority on an aggregate interface.

Use undo port lacp system-priority to restore the default.

Syntax

port lacp system-priority priority

undo port lacp system-priority

Default

The LACP system priority is 32768.

Views

Layer 2 aggregate interface view

Layer 3 aggregate interface 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.

Usage guidelines

Member devices in an S-MLAG system must use the same LACP system priority.

Examples

# Set the LACP system priority to 32 on Bridge-Aggregation 1.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] port lacp system-priority 32

Related commands

display link-aggregation verbose

lacp system-priority

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

Layer 3 Ethernet subinterface 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 1000.

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/subinterface 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.

By default, an Ethernet interface cannot be assigned to the same aggregation group as an Ethernet subinterface. You cannot create subinterfaces on an Ethernet interface assigned to an aggregation group. You cannot assign an Ethernet interface with subinterfaces configured to an aggregation group.

You cannot create an aggregate subinterface on an aggregate interface with member ports as Ethernet subinterfaces. You cannot assign Ethernet subinterfaces to an aggregation group that has aggregate subinterfaces created.

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.

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

port s-mlag group

Use port s-mlag group to assign an aggregate interface to an S-MLAG group.

Use undo port s-mlag group to restore the default.

Syntax

port s-mlag group group-id

undo port s-mlag group

Default

An aggregate interface is not in any S-MLAG group.

Views

Layer 2 aggregate interface view

Predefined user roles

network-admin

Parameters

group-id: Specifies an S-MLAG group number in the range of 1 to 1024.

Usage guidelines

You can assign only Layer 2 aggregate interfaces in dynamic mode to an S-MLAG group.

Each S-MLAG group can contain only one aggregate interface on each device.

The aggregate interfaces in an S-MLAG group cannot be used as M-LAG interfaces or peer-link interfaces in M-LAG. For more information about M-LAG interfaces and peer-link interfaces, see M-LAG configuration in Layer 2—LAN Switching Configuration Guide.

Examples

# Assign Bridge-Aggregation 1 to S-MLAG group 1.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] port s-mlag group 1

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

Related commands

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

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)

traffic-statistic include-interframe

Use traffic-statistic include-interframe to enable interframe gap and preamble statistics in the traffic statistics.

Use traffic-statistic include-interframe to restore the default.

Syntax

traffic-statistic include-interframe

undo traffic-statistic include-interframe

Default

Interframe gap and preamble statistics in the traffic statistics are disabled.

Views

Layer 2 aggregate interface view

Layer 3 aggregate interface view

Predefined user roles

network-admin

Usage guidelines

If you execute the display interface command, the Last 300 seconds input rate or Last 300 seconds output rate field in the command output displays the average outbound or inbound traffic rate in the last 300 seconds.

By default, traffic rate = native frame length × packet throughput per second. Execute the traffic-statistic include-interframe command if you need the total traffic statistics, including the native frame length, interframe gap length and preamble length, for a specific time period. If you execute this command, traffic rate = (native frame length + interframe gap length + preamble length) × packet throughput per second.

If you execute this command on an aggregate interface, this command takes effect on all Ethernet interfaces in the aggregation group of the aggregate interface. The interframe gap and preamble statistics setting configured in Ethernet interface view do not take effect. If an Ethernet interface is removed from the aggregation group, the interframe gap and preamble statistics setting configured in Ethernet interface view takes effect.

When you execute this command on an Ethernet interface or aggregate interface for the first time, the system will clear statistics of the interface. Re-executing this command will not clear the statistics. When an interface joins or leaves an aggregation group, you do not need to execute this command, and the system will automatically clear the statistics of the interface.

Examples

# Enable interframe gap and preamble statistics in the traffic statistics for HundredGigE 1/0/1 after it is assigned to an aggregation group.

<Sysname> system-view

[Sysname] interface hundredgige 1/0/1

[Sysname-HundredGigE1/0/1] traffic-statistic include-interframe

Set traffic statistic to include Inter-frame Gaps and Preambles, and clear the statistics count. Continue? [Y/N]:y

# Enable interframe gap and preamble statistics in the traffic statistics for Layer 2 aggregate interface Bridge-Aggregation 1.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] traffic-statistic include-interframe

Traffic statistic will be set to include Inter-frame Gaps and Preambles. Continue? [Y/N]:y

# Enable interframe gap and preamble statistics in the traffic statistics for Layer 3 aggregate interface Route-Aggregation 1.

<Sysname> system-view

[Sysname] interface route-aggregation 1

[Sysname-Route-Aggregation1] traffic-statistic include-interframe

Traffic statistic will be set to include Inter-frame Gaps and Preambles. Continue? [Y/N]:y

Related commands

display interface

05-Layer 2—LAN Switching Command Reference

display link-aggregation verbose

interface bridge-aggregation

interface route-aggregation

link-aggregation port-priority

port s-mlag group

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Policy & Program

Global Learning

Partner Sales Resources

Service Business

News & Events

Contact Us