The expected bandwidth is an informational parameter used only by higher-layer protocols for calculation. You cannot adjust the actual bandwidth of an interface by using this command.

Examples

# Set the expected bandwidth to 10000 kbps for Layer 2 aggregate interface Bridge-Aggregation 1.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] bandwidth 10000

# Set the expected bandwidth to 10000 kbps for Layer 3 aggregate interface Route-Aggregation 1.

<Sysname> system-view

[Sysname] interface route-aggregation 1

[Sysname-Route-Aggregation1] bandwidth 10000

bridge-forwarding enable

Use bridge-forwarding enable to enable Layer 2 forwarding on a Layer 3 aggregate interface.

Use undo bridge-forwarding enable to disable Layer 2 forwarding on a Layer 3 aggregate interface.

Syntax

bridge-forwarding enable

undo bridge-forwarding enable

Default

Layer 2 forwarding is disabled on Layer 3 aggregate interfaces.

Views

Layer 3 aggregate interface view

Predefined user roles

network-admin

Usage guidelines

CAUTION:

This command will delete physical layer settings on a Layer 3 aggregate interface. Make sure you are fully aware of the impacts of this command when you execute it on a live network.

By default, a Layer 3 aggregate interface only performs Layer 3 forwarding. This command enables a Layer 3 aggregate interface to transmit VLAN tagged packets by creating a virtual Layer 2 aggregate interface for that Layer 3 aggregate interface. You can configure VLAN settings on the virtual Layer 2 interface.

This command shuts down the data link layer of a Layer 3 aggregate interface. While the Layer 3 aggregate interface cannot provide Layer 3 services, its subinterfaces can terminate VLANs and continue to provide Layer 3 services.

When you use this command, follow these restrictions and guidelines:

· You cannot execute this command on a main interface whose subinterfaces terminate the outermost VLAN ID 1.

· The outermost VLAN IDs terminated by subinterfaces of a main interface cannot contain the PVID of and VLAN IDs permitted by the virtual Layer 2 interface created for the main interface.

For more information about VLAN termination, see Layer 2—LAN Switching Configuration Guide.

‌After you execute this command on a Layer 3 aggregate interface, the following functions will take effect on the virtual Layer 2 aggregate interface created for the Layer 3 aggregate interface:

· Port mirroring configured on a member port of the Layer 3 aggregate interface.

For more information about port mirroring, see mirroring configuration in Network Management and Monitoring Configuration Guide.

· Outbound GTS, interface-specific rate limit, WRED, and queue scheduling profile configured on the Layer 3 aggregate interface or one of its member ports.

For more information about GTS, interface-specific rate limit, WRED, and queue scheduling profile, see QoS configuration in ACL and QoS Configuration Guide.

· Outbound rate limit and queue scheduling profile configured by applying a user profile to the interface with the qos apply user-profile command.

For more information about outbound rate limit and queue scheduling profile configuration in user profile view, see user profile commands in BRAS Services Command Reference.

Examples

# Enable Layer 2 forwarding on Route-Aggregation 1.

<Sysname> system-view

[Sysname] interface route-aggregation 1

[Sysname-Route-Aggregation1] bridge-forwarding enable

This operation will clear the routing configuration that affects bridge forwarding on the interface. Continue?[Y/N]:y

default

Use default to restore the default settings for an aggregate interface.

Syntax

default

Views

Layer 2 aggregate interface view

Layer 3 aggregate interface view

Layer 3 aggregate subinterface view

Predefined user roles

network-admin

Usage guidelines

CAUTION:

The default command might interrupt ongoing network services. Make sure you are fully aware of the impacts of this command when you execute it on a live network.

This command might fail to restore the default settings for some commands for reasons such as command dependencies and system restrictions. Use the display this command in interface view to identify these commands, and then use their undo forms or follow the command reference to restore their default settings. If your restoration attempt still fails, follow the error message instructions to resolve the problem.

Examples

# Restore the default settings for Layer 2 aggregate interface 1.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] default

# Restore the default settings for Layer 3 aggregate interface 1.

<Sysname> system-view

[Sysname] interface route-aggregation 1

[Sysname-Route-Aggregation1] default

description

Use description to configure the description of an interface.

Use undo description to restore the default.

Syntax

description text

undo description

Default

The description of an interface is interface-name Interface. For example, the default description of Bridge-Aggregation 1 is Bridge-Aggregation1 Interface.

Views

Layer 2 aggregate interface view

Layer 3 aggregate interface view

Layer 3 aggregate subinterface view

Virtual Layer 2 aggregate interface view

Predefined user roles

network-admin

Parameters

text: Specifies a description, a case-sensitive string of 1 to 255 characters.

Examples

# Configure the description as connect to the lab for Layer 2 aggregate interface Bridge-Aggregation 1.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] description connect to the lab

# Configure the description as connect to the lab for Layer 3 aggregate interface Route-Aggregation 1.

<Sysname> system-view

[Sysname] interface route-aggregation 1

[Sysname-Route-Aggregation1] description connect to the lab

display interface

Use display interface to display aggregate interface information.

Syntax

display interface [ { bridge-aggregation | route-aggregation | vagg-bridge-port } [ interface-number ] ] [ brief [ description | down ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

bridge-aggregation: Specifies Layer 2 aggregate interfaces.

route-aggregation: Specifies Layer 3 aggregate interfaces.

vagg-bridge-port: Specifies virtual Layer 2 aggregate interfaces.

interface-number: Specifies an existing aggregate interface number.

brief: Displays brief interface information. If you do not specify this keyword, the command displays detailed interface information.

description: Displays complete interface descriptions. If you do not specify this keyword, the command displays only the first 27 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

IP packet frame type: Ethernet II, hardware address: 00fc-5ba5-d800

Description: Bridge-Aggregation1 Interface

Bandwidth: 1 kbps

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

Traffic statistic: Not include Inter-frame Gaps and Preambles

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

Last 300 second 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

Member Port:

PortName Status

XGE3/1/1 S

# 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: 00fc-5ba5-d802

IPv6 packet frame type: Ethernet II, hardware address: 00fc-5ba5-d802

Port priority: 0

Last clearing of counters: Never

Last 300 second input rate: 0 bytes/sec, 0 bits/sec, 0 packets/sec

Last 300 second output rate: 0 bytes/sec, 0 bits/sec, 0 packets/sec

Input: 0 packets, 0 bytes, 0 drops

Output: 0 packets, 0 bytes, 0 drops

Member Port:

PortName Status

XGE3/1/1 S

# Display detailed information about virtual Layer 2 aggregate interface VAGG-Bridge-Port 1.

<Sysname> display interface vagg-bridge-port1

VAGG-Bridge-Port1

Original interface: Route-Aggregation1

Current state: DOWN

Description: VAGG-Bridge-Port1 Interface

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

PVID: 1

Port link-type: Trunk

VLAN Passing: 1(default vlan)

VLAN permitted: 1(default vlan)

Trunk port encapsulation: IEEE 802.1q

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

# Display brief information about Layer 2 aggregate interface VAGG-Bridge-Port 1.

<Sysname> display interface vagg-bridge-port1 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

VAGGBP1 DOWN -- -- A 1

Table 1 Command output

Field	Description
Bridge-Aggregation1	Layer 2 aggregate interface name.
Route-Aggregation1	Layer 3 aggregate interface name.
VAGG-Bridge-Port1	Virtual Layer 2 aggregate interface name.
Derive Interface	Virtual Layer 2 aggregate interface name.
Origin interface	Layer 3 aggregate interface that uses the virtual Layer 2 aggregate interface.
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.
Port priority	Port priority of the interface.
Unknown-speed mode, unknown-duplex mode	The interface speed and duplex mode are unknown.
Link speed type is autonegotiation, link duplex type is autonegotiation	Both the link speed type and link duplex type are autonegotiation.
PVID	Port VLAN ID.
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(total): 0 packets, 0 bytes 0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses	The two fields on the first line represent the inbound traffic statistics (in packets and bytes) for the interface. All inbound normal packets, abnormal packets, and normal pause frames were counted. The four fields on the second line represent: · Number of inbound unicast packets. · Number of inbound broadcasts. · Number of inbound multicasts. · Number of inbound pause frames. A hyphen (-) indicates that the statistical item is not supported.
Input(normal): 0 packets, 0 bytes 0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses	The two fields on the first line represent the inbound normal traffic and pause frame statistics (in packets and bytes) for the interface. The four fields on the second line represent: · Number of inbound normal unicast packets. · Number of inbound normal broadcasts. · Number of inbound normal multicasts. · Number of inbound normal pause frames. A hyphen (-) indicates that the statistical item is not supported.
input errors	Statistics of incoming error packets.
runts	Number of inbound frames meeting the following conditions: · Shorter than 64 bytes. · In correct format. · Containing valid CRCs.
giants	Number of inbound giants. Giants refer to frames larger than the maximum frame length supported on the interface. For an Ethernet interface that does not permit jumbo frames, the maximum frame length is as follows: · 1518 bytes (without VLAN tags). · 1522 bytes (with VLAN tags). For an Ethernet interface that permits jumbo frames, the maximum Ethernet frame length is set when you configure jumbo frame support on the interface.
throttles	Number of inbound frames that had a non-integer number of bytes.
CRC	Total number of inbound frames that had a normal length, but contained CRC errors.
frame	Total number of inbound frames that contained CRC errors and a non-integer number of bytes.
overruns	Number of packets dropped because the input rate of the port exceeded the queuing capability.
aborts	Total number of illegal inbound packets: · Fragment frames—CRC error frames shorter than 64 bytes. The length (in bytes) can be an integral or non-integral value. · Jabber frames—CRC error frames greater than the maximum frame length supported on the Ethernet interface (with an integral or non-integral length). ¡ For an Ethernet interface that does not permit jumbo frames, the maximum frame length is 1518 bytes (without VLAN tags) or 1522 bytes (with VLAN tags). ¡ For an Ethernet interface that permits jumbo frames, the maximum Ethernet frame length is set when you configure jumbo frame support on the interface. · Symbol error frames—Frames that contained a minimum of one undefined symbol. · Unknown operation code frames—Non-pause MAC control frames. · Length error frames—Frames whose 802.3 length fields did not match the actual frame length (46 to 1500 bytes).
ignored	Number of inbound frames dropped because the receiving buffer of the port ran low.
parity errors	Total number of frames with parity errors.
Output(total): 0 packets, 0 bytes 0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses	The two fields on the first line represent the outbound traffic statistics (in packets and bytes) for the interface. All outbound normal packets, abnormal packets, and normal pause frames were counted. The four fields on the second line represent: · Number of outbound unicast packets. · Number of outbound broadcasts. · Number of outbound multicasts. · Number of outbound pause frames. A hyphen (-) indicates that the statistical item is not supported.
Output(normal): 0 packets, 0 bytes 0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses	The two fields on the first line represent the outbound normal traffic and pause frame statistics (in packets and bytes) for the interface. The four fields on the second line represent: · Number of outbound normal unicast packets. · Number of outbound normal broadcasts. · Number of outbound normal multicasts. · Number of outbound normal pause frames. A hyphen (-) indicates that the statistical item is not supported.
output errors	Number of outbound packets with errors.
underruns	Number of packets dropped because the output rate of the interface exceeded the output queuing capability. This is a low-probability hardware anomaly.
buffer failures	Number of packets dropped because the transmitting buffer of the interface ran low.
aborts	Number of packets that failed to be transmitted, for example, because of Ethernet collisions.
deferred	Number of frames that the interface deferred to transmit because of detected collisions.
collisions	Number of frames that the interface stopped transmitting because Ethernet collisions were detected during transmission.
late collisions	Number of frames that the interface deferred to transmit after transmitting their first 512 bits because of detected collisions.
lost carrier	Number of carrier losses during transmission. This counter increases by one when a carrier is lost, and applies to serial WAN interfaces.
no carrier	Number of times that the port failed to detect the carrier when attempting to send frames. This counter increases by one when a port failed to detect the carrier, and applies to serial WAN interfaces.
Input: 0 packets input, 0 bytes, - drops	Statistics about packets received on the interface. A hyphen (-) indicates that the statistical item is not supported.
Output: 0 packets output, 0 bytes, - drops	Statistics about packets sent on the interface. A hyphen (-) indicates that the statistical item is not supported.
Member Port	Member ports in the aggregation group. This field displays a maximum of 50 member ports.
PortName	Type and number of a member port.
Status	Member port status: · Selected. · Unselected. · Individual.
Line protocol state	Data link layer state of the interface: · UP. · DOWN.
Maximum transmission unit	MTU of the interface.
Internet protocol processing: Disabled	The interface is not assigned an IP address and cannot 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 BRAS Services Configuration Guide. · BOOTP-Allocated—BOOTP allocated IP address. For more information, see BOOTP client configuration in BRAS Services Configuration Guide. · PPP-Negotiated—IP address assigned by a PPP server during PPP negotiation. For more information, see PPP configuration in BRAS Services Configuration Guide. · Unnumbered—IP address borrowed from another interface. · MAD—IP address assigned to an IRF member device for MAD on the interface. For more information, see IRF configuration in Virtual Technologies Configuration Guide. · MTunnel—IP address of the multicast tunnel interface (MTI), which is the same as the IP address of the MVPN source interface. For more information, see multicast VPN configuration in IP Multicast Configuration Guide.
Brief information on interfaces in route mode	Brief information about Layer 3 interfaces.
Brief information on interfaces in bridge mode	Brief information about Layer 2 interfaces.
Interface	Abbreviated interface name.
Link	Physical link state of the interface: · UP—The interface is physically up. · DOWN—The interface is physically down. · ADM—The interface has been shut down by using the shutdown command. To restore the physical state of the interface, use the undo shutdown command. · Stby—The interface is a backup interface in standby state.
Speed	Speed of the interface, in bps. This field displays the (a) flag next to the speed if the speed is automatically negotiated. This field displays auto if the interface is configured to autonegotiate its speed but the autonegotiation has not started.
Duplex	Duplex mode of the interface: · A—Autonegotiation. The interface is configured to autonegotiate its duplex mode but the autonegotiation has not started. · F—Full duplex. · F(a)—Autonegotiated full duplex. · H—Half duplex. · H(a)—Autonegotiated half duplex.
Type	Link type of the interface: · A—Access. · H—Hybrid. · T—Trunk.
Protocol	Data link layer protocol state of the interface: · UP—The data link layer protocol of the interface is up. · DOWN—The data link layer protocol of the interface is down. · UP(s)—The data link layer protocol of the interface is up, but the link is an on-demand link or does not exist. The (s) attribute represents the spoofing flag. This value is typical of null interfaces and loopback interfaces.
Primary IP	Primary IP address of the interface. This field displays two hyphens (--) if the interface does not have an IP address.
Cause	Cause for the physical link state of an interface to be DOWN.

display lacp system-id

Use display lacp system-id to display the local system ID.

Syntax

display lacp system-id

Views

Any view

Predefined user roles

network-admin

network-operator

Usage guidelines

You can use the lacp system-priority command to change the LACP priority of the local system. The LACP priority value is specified in decimal format in the lacp system-priority command. However, it is displayed in hexadecimal format in the output from the display lacp system-id command.

Examples

# Display the local system ID.

<Sysname> display lacp system-id

Actor System ID: 0x8000, 0000-fc00-6504

Table 2 Command output

Field	Description
Actor System ID: 0x8000, 0000-fc00-6504	Local system ID, which contains the system LACP priority (0x8000 in this sample output) and the system MAC address (0000-FC00-6504 in this sample output).

Related commands

lacp system-priority

display link-aggregation load-sharing mode

Use display link-aggregation load-sharing mode to display global link-aggregation load sharing modes.

Syntax

display link-aggregation load-sharing mode

Views

Any view

Predefined user roles

network-admin

network-operator

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

Layer 2 traffic: destination-mac address source-mac address

Layer 3 traffic: destination-ip address source-ip address

Layer 4 traffic: destination-port source-port

MPLS traffic : mpls-label1 mpls-label2

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

destination-mac address source-mac address

Table 3 Command output

Field	Description
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, Layer 3, Layer 4, and MPLS traffic. If you have configured the global link-aggregation load sharing mode, this field displays the configured mode.
Layer 2 traffic: 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 source and destination MAC addresses.
Layer 3 traffic: destination-ip address, source-ip address	Default link-aggregation load sharing mode for Layer 3 traffic. In this sample output, Layer 3 traffic is load shared based on source and destination IP addresses.
Layer 4 traffic: destination-port, source-port	Default link-aggregation load sharing mode for Layer 4 traffic. In this sample output, Layer 4 traffic is load shared based on source and destination ports.
MPLS traffic : mpls-label1, mpls-label2, mpls-label3	Default link-aggregation load sharing mode for MPLS traffic. In this sample output, MPLS traffic is load shared based on Layer 1 through Layer 3 MPLS labels.
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 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 ]

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.

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 link aggregation information about Ten-GigabitEthernet 3/1/1, which is a member port of a static Layer 2 aggregation group.

<Sysname> display link-aggregation member-port ten-gigabitethernet 3/1/1

Flags: A -- LACP_Activity, B -- LACP_Timeout, C -- Aggregation,

D -- Synchronization, E -- Collecting, F -- Distributing,

G -- Defaulted, H -- Expired

Ten-GigabitEthernet3/1/1:

Aggregate Interface: Bridge-Aggregation1

Port Number: 1

Port Priority: 32768

Oper-Key: 1

# Display detailed link aggregation information about Ten-GigabitEthernet 3/1/1, which is a member port of a static Layer 3 aggregation group.

<Sysname> display link-aggregation member-port ten-gigabitethernet 3/1/1

Flags: A -- LACP_Activity, B -- LACP_Timeout, C -- Aggregation,

D -- Synchronization, E -- Collecting, F -- Distributing,

G -- Defaulted, H -- Expired

Ten-GigabitEthernet3/1/1:

Aggregate Interface: Route-Aggregation1

Port Number: 1

Port Priority: 32768

Oper-Key: 1

# Display detailed link aggregation information about Ten-GigabitEthernet 3/1/2, which is a member port of a dynamic Layer 2 aggregation group.

<Sysname> display link-aggregation member-port ten-gigabitethernet 3/1/2

Flags: A -- LACP_Activity, B -- LACP_Timeout, C -- Aggregation,

D -- Synchronization, E -- Collecting, F -- Distributing,

G -- Defaulted, H -- Expired

Ten-GigabitEthernet3/1/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)

# Display detailed link aggregation information about Ten-GigabitEthernet 3/1/2, which is a member port of a dynamic Layer 3 aggregation group.

<Sysname> display link-aggregation member-port ten-gigabitethernet 3/1/2

Flags: A -- LACP_Activity, B -- LACP_Timeout, C -- Aggregation,

D -- Synchronization, E -- Collecting, F -- Distributing,

G -- Defaulted, H -- Expired

Ten-GigabitEthernet3/1/2:

Aggregate Interface: Route-Aggregation1

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 4 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.
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 system LACP priority and the 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

Static link aggregation groups cannot obtain information about the peer groups. As a result, the Partner ID field displays None or nothing for a static link aggregation group.

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 5 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 system LACP priority and the local 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 system LACP priority and the peer 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:

XGE3/1/2

Status: Selected

XGE3/1/3

Status: Unselected

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

Advice: Check the connection

Table 6 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 of the specified aggregate interfaces. If you do not specify this keyword, the command displays only the aggregation member ports on the present cards.

Usage guidelines

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

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

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

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

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

Aggregation Mode: Dynamic

Loadsharing Type: Shar

System ID: 0x8000, 000f-e267-6c6a

Local:

Port Status Priority Index Oper-Key Flag

XGE3/1/1 S 32768 1 1 {ACDEF}

XGE3/1/2 S 32768 2 1 {ACDEF}

XGE3/1/3 S 32768 3 1 {ACDEF}

Remote:

Actor Priority Index Oper-Key SystemID Flag

XGE3/1/1 32768 1 1 0x8000, 000f-e267-57ad {ACDEF}

XGE3/1/2 32768 2 1 0x8000, 000f-e267-57ad {ACDEF}

XGE3/1/3 32768 3 1 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

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

Port Status Priority Oper-Key Role

XGE3/1/1 U 32768 1 None

XGE3/1/2 U 32768 1 None

XGE3/1/3 U 32768 1 None

# Display detailed information about Layer 3 aggregation group 1, which is a dynamic aggregation group.

<Sysname> display link-aggregation verbose route-aggregation 1

Loadsharing Type: Shar -- Loadsharing, NonS -- Non-Loadsharing

Port Status: S -- Selected, U -- Unselected, I -- Individual

Port: A -- Auto

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: Route-Aggregation1

Aggregation Mode: Dynamic

Loadsharing Type: Shar

System ID: 0x8000, 000f-e267-6c6a

Local:

Port Status Priority Index Oper-Key Flag

XGE3/1/1 S 32768 1 1 {ACDEF}

XGE3/1/2 S 32768 2 1 {ACDEF}

XGE3/1/3 S 32768 3 1 {ACDEF}

Remote:

Actor Priority Index Oper-Key SystemID Flag

XGE3/1/1 32768 1 1 0x8000, 000f-e267-57ad {ACDEF}

XGE3/1/2 32768 2 1 0x8000, 000f-e267-57ad {ACDEF}

XGE3/1/3 32768 3 1 0x8000, 000f-e267-57ad {ACDEF}

# Display detailed information about Layer 3 aggregation group 1, which is a static aggregation group.

<Sysname> display link-aggregation verbose route-aggregation 1

Loadsharing Type: Shar -- Loadsharing, NonS -- Non-Loadsharing

Port Status: S -- Selected, U -- Unselected, I -- Individual

Port: A -- Auto

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: Route-Aggregation1

Aggregation Mode: Static

Loadsharing Type: Shar

Port Status Priority Oper-Key Role

XGE3/1/1 S 32768 1 None

XGE3/1/2 S 32768 1 None

XGE3/1/3 S 32768 1 None

Table 7 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. Letter A indicates that the port was assigned to the aggregation group by the automatic link aggregation feature or the automatic member port assignment feature.
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.
Aggregation Mode	Aggregation group type: · S—Static. · D—Dynamic.
System ID	Local system ID, containing the local system LACP priority and the local 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 field are not displayed.
Remote	Information about the peer end: · Actor—Type and number of the local port. · Priority—Priority of the peer port. · Index—Index of the peer port. · Oper-Key—Operational key of the peer port. · System ID—System ID of the peer end. · Flag—LACP state flag of the peer end.

interface bridge-aggregation

Use interface bridge-aggregation to create a Layer 2 aggregate interface and enter its view, or enter the view of an existing Layer 2 aggregate interface.

Use undo interface bridge-aggregation to delete a Layer 2 aggregate interface.

Syntax

interface bridge-aggregation interface-number

undo interface bridge-aggregation interface-number

Default

No Layer 2 aggregate interfaces exist.

Views

System view

Predefined user roles

network-admin

Parameters

interface-number: Specifies a Layer 2 aggregate interface number. The value range for the interface-number argument is 1 to 1024.

Usage guidelines

When you create a Layer 2 aggregate interface, the system automatically creates a Layer 2 aggregation group with the same number. The aggregation group operates in static aggregation mode by default.

Deleting a Layer 2 aggregate interface also deletes the Layer 2 aggregation group. If member ports exist in the Layer 2 aggregation group, you cannot delete the Layer 2 aggregate interface.

Examples

# Create Layer 2 aggregate interface Bridge-Aggregation 1, and enter its view.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1]

interface route-aggregation

Use interface route-aggregation to create a Layer 3 aggregate interface or subinterface and enter its view, or enter the view of an existing Layer 3 aggregate interface or subinterface.

Use undo interface route-aggregation to delete a Layer 3 aggregate interface or subinterface.

Syntax

interface route-aggregation { interface-number | interface-number.subnumber }

undo interface route-aggregation { interface-number | interface-number.subnumber }

Default

No Layer 3 aggregate interfaces or subinterfaces exist.

Views

System view

Predefined user roles

network-admin

Parameters

interface-number: Specifies a Layer 3 aggregate interface number. The value range for the interface-number argument is 1 to 1024.

interface-number.subnumber: Specifies a subinterface of a Layer 3 aggregate interface. The interface-number argument specifies the main interface number. The subnumber argument specifies the subinterface number. The value range for the subnumber argument is 1 to 99999999, and you can create a maximum of 4094 subinterfaces on a main aggregate interface.

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. If member ports exist in the Layer 3 aggregation group or subinterfaces exist on the Layer 3 aggregate interface, you cannot delete the Layer 3 aggregate interface.

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]

# Create Layer 3 aggregate subinterface Route-Aggregation 1.1 and enter its view.

<Sysname> system-view

[Sysname] interface route-aggregation 1.1

[Sysname-Route-Aggregation1.1]

interface vagg-bridge-port

Use interface vagg-bridge-port to enter virtual Layer 2 aggregate interface view.

Syntax

interface vagg-bridge-port interface-number

Default

No virtual Layer 2 aggregate interfaces exist.

Views

System view

Predefined user roles

network-admin

Parameters

interface-number: Specifies an existing virtual Layer 2 aggregate interface number. A Layer 3 aggregate interface and its virtual Layer 2 aggregate interface have the same number.

Usage guidelines

When you execute the bridge-forwarding enable command on a Layer 3 aggregate interface, the device automatically creates a virtual Layer 2 aggregate interface for that Layer 3 aggregate interface. The virtual Layer 2 aggregate interface forwards Layer 2 traffic for the Layer 3 aggregate interface.

On a virtual Layer 2 aggregate interface, you can use the description command to configure a description and configure port-based VLANs. For more information about port-based VLAN commands, see "VLAN commands."

Examples

# Enter the view of VAGG-Bridge-Port 1.

<Sysname> system-view

[Sysname] interface vagg-bridge-port 1

[Sysname-VAGG-Bridge-Port1]

Related commands

bridge-forwarding enable

description

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 disabled for dynamic aggregation groups.

Views

System view

Predefined user roles

network-admin

Usage guidelines

The default port selection action applies to dynamic aggregation groups.

This action automatically chooses the port with the lowest ID from among all up member ports as a Selected port if none of them has received LACPDUs before the LACP timeout interval expires.

After this action is disabled, a dynamic aggregation group will not have any Selected ports to forward traffic if it has not received LACPDUs before the LACP timeout interval expires.

Examples

# Disable the default port selection action.

<Sysname> system-view

[Sysname] lacp default-selected-port disable

lacp edge-port

Use lacp edge-port to configure an aggregate interface as an edge aggregate interface.

Use undo lacp edge-port to restore the default.

Syntax

lacp edge-port

undo lacp edge-port

Default

An aggregate interface does not operate as an edge aggregate interface.

Views

Layer 2 aggregate interface view

Layer 3 aggregate interface view

Predefined user roles

network-admin

Usage guidelines

Use this command on the aggregate interface that connects the device to a server if dynamic link aggregation is configured only on the device. This feature improves link reliability by enabling all member ports of the aggregation group to forward packets.

This command takes effect only on an aggregate interface corresponding to a dynamic aggregation group.

Link-aggregation traffic redirection cannot operate correctly on an edge aggregate interface.

Examples

# Configure Layer 2 aggregate interface Bridge-Aggregation 1 as an edge aggregate interface.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] lacp edge-port

# Configure Layer 3 aggregate interface Route-Aggregation 1 as an edge aggregate interface.

<Sysname> system-view

[Sysname] interface route-aggregation 1

[Sysname-Route-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

Layer 2 FlexE logical interface view

Layer 3 FlexE logical 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 Ten-GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/1/1

[Sysname-Ten-GigabitEthernet3/1/1] lacp mode passive

lacp period short

Use lacp period short to set 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

Layer 2 FlexE logical interface view

Layer 3 FlexE logical interface view

Predefined user roles

network-admin

Examples

# Set the short LACP timeout interval (3 seconds) on Ten-GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/1/1

[Sysname-Ten-GigabitEthernet3/1/1] lacp period short

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.

The LACP system MAC address 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 MAC address to send LACPDUs. 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.

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 system LACP priority.

Use undo lacp system-priority to restore the default.

Syntax

lacp system-priority priority

undo lacp system-priority

Default

The system LACP priority is 32768.

Views

System view

Predefined user roles

network-admin

Parameters

priority: Specifies the system LACP priority in the range of 0 to 65535. The smaller the value, the higher the system LACP priority.

Usage guidelines

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

Examples

# Set the system LACP 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 | ipv6 } source { ipv4-address | ipv6-address } destination { ipv4-address | ipv6-address }

undo link-aggregation bfd [ ipv4 | ipv6 ]

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.

ipv6: Specifies IPv6 BFD.

source: Specifies the source IP address of BFD sessions.

destination: Specifies the destination IP address of BFD sessions.

ipv4-address: Specifies an IPv4 address. The address cannot be 0.0.0.0.

ipv6-address: Specifies an IPv6 address. The address cannot be 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 maximum number of Selected ports is inconsistent between the two ends of an aggregate link, do not enable BFD on these two ends. Otherwise, the number of BFD sessions might differ between the two ends of the aggregate link.

You can configure both IPv4 and IPv6 BFD. If you configure a BFD type multiple times, the most recent configuration takes effect.

If both IPv4 and IPv6 BFD sessions exist on an aggregate interface, the device places the aggregation member ports in Unselected state when either IPv4 or IPv6 BFD detects a link failure.

Examples

# Enable IPv4 BFD for Layer 2 aggregation group 1, and specify the source and destination IPv4 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

# Enable IPv4 BFD for Layer 3 aggregation group 1, and specify the source and destination IPv4 addresses as 1.1.1.1 and 2.2.2.2 for BFD sessions.

<Sysname> system-view

[Sysname] interface route-aggregation 1

[Sysname-Route-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 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

No link aggregation load sharing algorithm is 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 3.

Usage guidelines

This command is intended to help you optimize load sharing performance when the default load sharing mode is used. It does not take effect on per-packet load sharing.

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

Each load sharing algorithm represents a CRC calculation method.

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

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 | mpls-label1 | mpls-label2 | source-ip | source-mac | source-port } * | per-packet }

undo link-aggregation global load-sharing mode

Default

By default, the device selects a load sharing mode for packets depending on their packet type, as follows:

· Fragment packets are load shared based on the source and destination IP addresses.

· Non-fragment packets are load shared as follows:

¡ Table 8 shows the default link-aggregation load sharing mode for the following cards:

Card category	Cards
CEPC	CEPC-XP4LX, CEPC-XP24LX, CEPC-XP48RX, CEPC-CP4RX, CEPC-CP4RXA, CEPC-CP4RX-L
CSPEX	CSPEX-1304X, CSPEX-1404X, CSPEX-1502X, CSPEX-1504X, CSPEX-1504XA, CSPEX-1602X, CSPEX-1602XA, CSPEX-1804X, CSPEX-1512X, CSPEX-1612X, CSPEX-1812X
SPE	RX-SPE200

Table 8 Link-aggregation load sharing mode

Packet type	Default link-aggregation load sharing mode
IP unicast packets	destination-ip, source-ip
IP multicast packets	destination-mac, source-mac
Layer 2 data frames	destination-mac, source-mac
MPLS L3VPN packets	destination-ip, source-ip
MPLS L2VPN packets	· For IP packets: destination-ip, source-ip · For other packets: destination-mac, source-mac
MPLS label switching packets	· For IP packets: mpls-label1, mpls-label2, destination-ip, source-ip · For other packets: mpls-label1, mpls-label2, destination-mac, source-mac
Other packets of MPLS	mpls-label1, mpls-label2
IP tunnel packets	· For IP packets: destination-ip (inner header), source-ip (inner header) · For packets not terminated by MPLS: mpls-label1, mpls-label2

‌

¡ Table 9 shows the default link-aggregation load sharing mode for the folliowing cards:

Card category	Cards
CEPC	CEPC-CQ8L, CEPC-CQ8LA, CEPC-CQ8L1A, CEPC-CQ16L1
CSPEX	CSPEX-1802X, CSPEX-1802XA, CSPEX-1812X-E, CSPEX-2304X-G, CSPEX-1502XA, CSPEX-2612XA
SPE	RX-SPE200-E

Table 9 Link-aggregation load sharing mode

Packet type	Default link-aggregation load sharing mode
IP unicast packets	destination-ip, source-ip, destination-port, source-port
IP multicast packets	destination-ip, source-ip, destination-port, source-port
Layer 2 data frames	destination-mac, source-mac
MPLS L3VPN packets	destination-ip, source-ip, destination-port, source-port
MPLS L2VPN packets	· For IP packets: destination-ip, source-ip, destination-port, source-port · For other packets: destination-mac, source-mac
MPLS label switching packets	· For IP packets: mpls-label1, mpls-label2, destination-ip, source-ip, destination-port, source-port · For other packets: mpls-label1, mpls-label2, destination-mac, source-mac
Other packets of MPLS	mpls-label1, mpls-label2
IP tunnel packets	· For IP packets: destination-ip (inner header), destination-port (inner header), source-port · For packets not terminated by MPLS: mpls-label1, mpls-label2

¡ Table 10 shows the default link-aggregation load sharing mode for the following cards:

Card category	Cards
CEPC	CSPC-GE16XP4L-E, CSPC-GE24L-E, CSPC-GP24GE8XP2L-E
CSPEX	CSPEX-1104-E, CSPEX-1204

Table 10 Link-aggregation load sharing mode

Packet type	Default link-aggregation load sharing mode
IP unicast packets	destination-ip, source-ip
IP multicast packets	destination-mac, source-mac
Layer 2 data frames	destination-mac, source-mac
MPLS L3VPN packets	destination-ip, source-ip
MPLS L2VPN packets	· For IP packets: destination-ip, source-ip · For MPLS VPLS packets: destination-mac, source-mac · For MPLS L2VPN packets: mpls-label1, mpls-label2 · For other packets: destination-mac, source-mac
MPLS label switching packets	mpls-label1, mpls-label2
Other packets of MPLS	mpls-label1, mpls-label2
IP tunnel packets	· For IP packets: destination-ip (inner header), source-ip (inner header) · For packets not terminated by MPLS: mpls-label1, mpls-label2

‌

Views

System view

Predefined user roles

network-admin

Parameters

destination-ip: Load shares traffic based on destination IP addresses.

destination-mac: Load shares traffic based on destination MAC addresses.

destination-port: Load shares traffic based on destination ports.

mpls-label1: Load shares MPLS traffic based on Layer 1 labels.

mpls-label2: Load shares MPLS traffic based on Layer 2 labels.

source-ip: Load shares traffic based on source IP addresses.

source-mac: Load shares traffic based on source MAC addresses.

source-port: Load shares traffic based on source ports.

per-packet: Load shares traffic on a per-packet basis.

Usage guidelines

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

If an unsupported load sharing mode is set, the device displays an error message.

Examples

# Set the global load sharing mode to load share packets based on destination MAC addresses.

<Sysname> system-view

[Sysname] link-aggregation global load-sharing mode destination-mac

Related commands

link-aggregation load-sharing mode

link-aggregation ignore speed

Use link-aggregation ignore speed to configure an aggregation group to ignore port speed in setting the aggregation states of member ports.

Use undo link-aggregation ignore speed to restore the default.

Syntax

link-aggregation ignore speed

undo link-aggregation ignore speed

Default

An aggregation group does not ignore port speed in setting the aggregation states of member ports.

Views

Layer 2 aggregate interface view

Layer 3 aggregate interface view

Predefined user roles

network-admin

Usage guidelines

IMPORTANT:

Make sure you are fully aware of the impacts of this command when you execute it on a live network.

This command allows ports at a different speed than the reference port to become Selected by ignoring the port speed during operational key calculation.

You must configure the same port speed ignoring setting at the two ends of a static configuration to ensure that the peer ports are placed in the same aggregation state. This requirement does not apply to a dynamic aggregation, on which the two ends negotiate the aggregation state of the peer ports automatically.

Examples

# Configure Layer 2 aggregation group 1 to ignore port speed in setting the aggregation states of member ports.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] link-aggregation ignore speed

# Configure Layer 3 aggregation group 1 to ignore port speed in setting the aggregation states of member ports.

<Sysname> system-view

[Sysname] interface route-aggregation 1

[Sysname-Route-Aggregation1] link-aggregation ignore speed

link-aggregation ignore vlan

Use link-aggregation ignore vlan to configure a Layer 2 aggregate interface to ignore the specified VLANs.

Use undo link-aggregation ignore vlan to remove the specified ignored VLANs for a Layer 2 aggregate interface.

Syntax

link-aggregation ignore vlan vlan-id-list

undo link-aggregation ignore vlan vlan-id-list

Default

A Layer 2 aggregate interface does not ignore any VLANs.

Views

Layer 2 aggregate interface view

Predefined user roles

network-admin

Parameters

vlan-id-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN ID or a range of VLAN IDs in the form of vlan-id1 to vlan-id2. The value range for VLAN IDs is 1 to 4094. The value for the vlan-id2 argument must be equal to or greater than the value for the vlan-id1 argument.

Usage guidelines

This command takes effect only when the link type of the Layer 2 aggregate interface is hybrid or trunk.

With this command configured, a Layer 2 aggregate interface ignores the permitted VLAN and VLAN tagging mode configuration of the specified VLANs when choosing Selected ports.

Examples

# Configure Layer 2 aggregate interface bridge-aggregation 1 to ignore VLAN 50.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] link-aggregation ignore vlan 50

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 gracefully changes member ports of all dynamic aggregate interfaces to Unselected state. The member ports of the counterpart aggregation groups will also be placed in Unselected state.

This feature takes effect only on dynamic aggregate interfaces. It cannot isolate static aggregate interfaces.

Examples

# Isolate aggregate interfaces.

<Sysname> system-view

[Sysname] link-aggregation lacp isolate

link-aggregation lacp traffic-redirect-notification enable

Use link-aggregation lacp traffic-redirect-notification enable to enable link-aggregation traffic redirection.

Use undo link-aggregation lacp traffic-redirect-notification enable to disable link-aggregation traffic redirection.

Syntax

link-aggregation lacp traffic-redirect-notification enable

undo link-aggregation lacp traffic-redirect-notification enable

Default

Link-aggregation traffic redirection is disabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

This feature redirects traffic on a Selected port to the remaining available Selected ports of an aggregation group if one of the following events occurs:

· The port is shut down by using the shutdown command.

· The slot that hosts the port reboots, but the aggregation group contains Selected ports on other slots.

NOTE:

The device does not redirect traffic to member ports that become Selected during the traffic redirection process.

This feature ensures zero packet loss for known unicast traffic, but does not protect unknown unicast traffic.

This feature applies only to dynamic link aggregation groups.

To prevent traffic interruption, enable link-aggregation traffic redirection on devices at both ends of the aggregate link.

To prevent packet loss that might occur when a slot reboots, do not enable spanning tree together with link-aggregation traffic redirection.

Link-aggregation traffic redirection cannot operate correctly on an edge aggregate interface.

As a best practice, enable link-aggregation traffic redirection on a per-interface basis. If you enable this feature globally, communication with a third-party peer device might be affected if the peer is not compatible with this feature.

Examples

# Enable link-aggregation traffic redirection.

<Sysname> system-view

[Sysname] link-aggregation lacp traffic-redirect-notification enable

link-aggregation load-sharing mode local-first

Use link-aggregation load-sharing mode local-first to enable local-first load sharing for link aggregation.

Use undo link-aggregation load-sharing mode local-first to disable local-first load sharing for link aggregation.

Syntax

link-aggregation load-sharing mode local-first

undo link-aggregation load-sharing mode local-first

Default

Local-first load sharing is enabled for link aggregation.

Views

System view

Predefined user roles

network-admin

Usage guidelines

After you disable local-first load sharing, the packets will be load shared among all Selected ports of the aggregate interface on all IRF member devices.

This command is supported only in IRF mode.

Examples

# Disable local-first load sharing for link aggregation.

<Sysname> system-view

[Sysname] undo link-aggregation load-sharing mode local-first

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

Aggregation mode change might cause Selected member ports to become Unselected. When you change the aggregation mode, make sure you understand the impact of the change on services.

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

# Configure Layer 3 aggregation group 1 to operate in dynamic aggregation mode.

<Sysname> system-view

[Sysname] interface route-aggregation 1

[Sysname-Route-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

Layer 2 FlexE logical interface view

Layer 3 FlexE logical 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 Ten-GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/1/1

[Sysname-Ten-GigabitEthernet3/1/1] link-aggregation port-priority 64

# Set the port priority to 64 for Layer 3 Ethernet interface Ten-GigabitEthernet 3/1/2.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/1/2

[Sysname-Ten-GigabitEthernet3/1/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 Ten-GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/1/1

[Sysname-Ten-GigabitEthernet3/1/1] port link-aggregation group 1

[Sysname-Ten-GigabitEthernet3/1/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 depends on hardware limitation.

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. max-number: Specifies the maximum number of Selected ports allowed in an aggregation group. The value range for this argument is 1 to 64.

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

# Set the maximum number of Selected ports to 5 for Layer 3 aggregation group 1.

<Sysname> system-view

[Sysname] interface route-aggregation 1

[Sysname-Route-Aggregation1] link-aggregation selected-port maximum 5

link-aggregation selected-port minimum

Use link-aggregation selected-port minimum to set the minimum number of Selected ports in an aggregation group.

Use undo link-aggregation selected-port minimum to restore the default.

Syntax

link-aggregation selected-port minimum min-number

undo link-aggregation selected-port minimum

Default

The minimum number of Selected ports in an aggregation group is not specified.

Views

Layer 2 aggregate interface view

Layer 3 aggregate interface view

Predefined user roles

network-admin

Parameters

min-number: Specifies the minimum number of Selected ports in an aggregation group required to bring up the aggregate interface. The value range for this argument is 1 to 64.

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

# Set the minimum number of Selected ports to 3 for Layer 3 aggregation group 1.

<Sysname> system-view

[Sysname] interface route-aggregation 1

[Sysname-Route-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.

The system calculates the minimum percentage of Selected ports based on the total number of member ports in an aggregation group, including the member ports on an absent card. To view the total number of member ports in an aggregation group, execute the display link-aggregation verbose all-configuration command.

For the device to calculate the minimum number of Selected ports correctly, save the running configuration and reboot the device after you execute the link-aggregation selected-port minimum percentage 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

link-delay

Use link-delay to set the physical state change suppression interval on an aggregate interface.

Use undo link-delay to restore the default.

Syntax

link-delay { down | up } [ msec ] delay-time

undo link-delay { down | up }

Default

Each time the physical link of an aggregate interface goes up or comes down, the system immediately reports the change to the CPU.

Views

Layer 2 aggregate interface view

Layer 3 aggregate interface view

Predefined user roles

network-admin

Parameters

down: Suppresses link-down events.

up: Suppresses link-up events.

msec: Sets the physical state change suppression interval in milliseconds. If you do not specify this keyword, the suppression interval is in seconds.

delay-time: Sets the physical state change suppression interval. To report a physical state change immediately to the CPU, set the interval to 0.

· If you do not specify the msec keyword, the value range is 0 to 300 seconds.

· If you specify the msec keyword, the value range is 0 to 10000 milliseconds, and the value must be a multiple of 10.

Usage guidelines

You can configure this feature to suppress link-down events, link-up events, or both. If an event of the specified type still exists when the suppression interval expires, the system reports the event.

On an interface, you can configure different suppression intervals for link-up and link-down events. If you execute the link-delay command multiple times for an event type, the most recent configuration takes effect on that event type.

When you configure suppression interval settings on an aggregate interface, make sure its peer interface is also an aggregate interface in the same aggregation mode. In addition, the suppression interval settings must be the same between the peer aggregate interfaces.

As a best practice, use the default setting in an S-MLAG environment.

As a best practice, use this command on an aggregate interface if interface flapping affects upper layer services.

Examples

# Set the link-down event suppression interval to 500 milliseconds on Bridge-Aggregation 1.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] link-delay down msec 500

# Set the link-down event suppression interval to 500 milliseconds on Route-Aggregation 1.

<Sysname> system-view

[Sysname] interface route-aggregation 1

[Sysname-Route-Aggregation1] link-delay down msec 500

mac-address

Use mac-address to set the MAC address for an aggregate interface.

Use undo mac-address to restore the default.

Syntax

mac-address mac-address

undo mac-address

Default

The MAC address for an aggregate interface is assigned by the device.

Views

Layer 3 aggregate interface view

Predefined user roles

network-admin

Parameters

mac-address: Specifies the MAC address in the format of H-H-H.

Usage guidelines

This command is available only for the following cards:

Card category	Cards
CEPC	CEPC-CP4RX, CEPC-CP4RXA, CEPC-CP4RX-L, CEPC-CQ8LA, CEPC-CQ8L1A, CEPC-CQ8L, CEPC-XP4LX, CEPC-XP24LX, CEPC-XP48RX
CSPEX	CSPEX-1304X, CSPEX-1404X, CSPEX-1502X, CSPEX-1502XA, CSPEX-1504X, CSPEX-1504XA, CSPEX-1602X, CSPEX-1602XA, CSPEX-1802X, CSPEX-1802XA, CSPEX-1804X, CSPEX-1512X, CSPEX-1612X, CSPEX-1812X, CSPEX-1812X-E, CSPEX-2304X-G, CSPEX-2612XA
SPE	RX-SPE200-E

In standard mode, the value range for the MAC addresses assigned to Layer 3 aggregate interfaces is 000f-e2ff-8000 to 000f-e2ff-80ff if these aggregate interfaces contain member ports on the following cards:

Card category	Cards
CEPC	CEPC-CP4RX, CEPC-CP4RXA, CEPC-CP4RX-L, CEPC-CQ8LA, CEPC-CQ8L1A, CEPC-XP4LX, CEPC-XP24LX, CEPC-XP48RX
CSPEX	CSPEX-1304X, CSPEX-1404X, CSPEX-1502X, CSPEX-1502XA, CSPEX-1504X, CSPEX-1504XA, CSPEX-1602X, CSPEX-1602XA, CSPEX-1802XA, CSPEX-1804X, CSPEX-1512X, CSPEX-1612X, CSPEX-1812X, CSPEX-2304X-G, CSPEX-2612XA
SPE	RX-SPE200-E

You cannot use this command to assign a MAC address to an aggregate subinterface. All aggregate subinterfaces on an aggregate interface use the MAC address of the aggregate interface.

Do not assign the MAC addresses reserved for VRRP to aggregate interfaces.

By default, all aggregate interfaces on a device use the same MAC address and aggregate interfaces on different devices use different MAC addresses.

Examples

# Set the MAC address to 0001-0001-0001 for Layer 2 aggregate interface Bridge-Aggregation 1.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] mac-address 1-1-1

# Set the MAC address to 0001-0001-0001 for Layer 3 aggregate interface Route-Aggregation 1.

<Sysname> system-view

[Sysname] interface route-aggregation 1

[Sysname-Route-Aggregation1] mac-address 1-1-1

mtu

Use mtu to set the MTU for a Layer 3 aggregate interface or subinterface.

Use undo mtu to restore the default.

Syntax

mtu size [ spread ]

undo mtu [ spread ]

Default

The MTU for 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 the MTU in bytes. The value range for interfaces vary by card model.

spread: Issues the MTU of the interface to all its subinterfaces. This keyword is available only in Layer 3 aggregate interface view.

Usage guidelines

When you set the MTU of a Layer 3 aggregate interface, you can specify the spread keyword to issue the MTU setting to all its subinterfaces. If you do not specify the spread keyword, the MTU setting takes effect only on the Layer 3 aggregate interface.

On an aggregate subinterface, the MTU set in subinterface view takes precedence over the MTU inherited from the aggregate interface.

When you set the MTU of a Layer 3 aggregate interface, follow these restrictions and guidelines:

· If this interface receives IP packets and the MTU of the traffic outgoing interface is smaller than 1280 bytes, the IP packets are fragmented based on the MTU 1280 bytes. As a best practice, set the MTU to be larger than 1280 bytes on the traffic outgoing interface.

· The largest MTU of a Layer 3 aggregate interface and its subinterfaces cannot exceed the maximum MTU of the member ports of the Layer 3 aggregate interface.

Examples

# Set the MTU to 1430 bytes for Layer 3 aggregate interface Route-Aggregation 1.

<Sysname> system-view

[Sysname] interface route-aggregation 1

[Sysname-Route-Aggregation1] mtu 1430

Related commands

display interface

port link-aggregation group

Use port link-aggregation group to assign an interface to an aggregation group.

Use undo port link-aggregation group to remove an interface from the aggregation group to which it belongs.

Syntax

port link-aggregation group group-id

undo port link-aggregation group

Default

An interface does not belong to an aggregation group.

Views

Layer 2 Ethernet interface view

Layer 3 Ethernet interface view

Layer 2 FlexE logical interface view

Layer 3 FlexE logical interface view

Predefined user roles

network-admin

Parameters

group-id: Specifies an aggregation group by its aggregate interface number. The value range for the number argument is 1 to 1024.

Usage guidelines

A Layer 2 Ethernet interface or a Layer 2 FlexE logical interface can be assigned only to a Layer 2 aggregation group. A Layer 3 Ethernet interface or a Layer 3 FlexE logical interface can be assigned only to a Layer 3 aggregation group.

An Ethernet interface or a FlexE logical interface can belong to only one aggregation group.

Examples

# Assign Layer 2 Ethernet interface Ten-GigabitEthernet 3/1/1 to Layer 2 aggregation group 1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/1/1

[Sysname-Ten-GigabitEthernet3/1/1] port link-aggregation group 1

# Assign Layer 3 Ethernet interface Ten-GigabitEthernet 3/1/2 to Layer 3 aggregation group 2.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/1/2

[Sysname-Ten-GigabitEthernet3/1/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.

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

Use reset counters interface to clear statistics for the specified aggregate interfaces.

Syntax

reset counters interface [ { bridge-aggregation | route-aggregation } [ interface-number ] ]

Views

User view

Predefined user roles

network-admin

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

Use this command to clear history statistics before you collect traffic statistics for a time period.

If you do not specify an aggregate interface type, the command clears statistics for all interfaces.

If you specify only an aggregate interface type, the command clears statistics for all aggregate interfaces of the specified type.

The bridge-aggregation or route-aggregation keyword is available only when the corresponding aggregate interfaces exist on the device.

Examples

# Clear statistics for Layer 2 aggregate interface Bridge-Aggregation 1.

<Sysname> reset counters interface bridge-aggregation 1

# Clear statistics for Layer 3 aggregate interface Route-Aggregation 1.

<Sysname> reset counters interface route-aggregation 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-type interface-number1 argument must be equal to or greater than the value for the interface-type 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

route-aggregation different-mac-address enable

Use route-aggregation different-mac-address enable to enable the device to assign unique MAC addresses to Layer 3 aggregate interfaces .

Use undo route-aggregation different-mac-address enable to restore the default.

Syntax

route-aggregation different-mac-address enable

undo route-aggregation different-mac-address enable

Default

The device assigns the same MAC address to all Layer 3 aggregate interfaces.

Views

System view

Predefined user roles

network-admin

Usage guidelines

This command is supported only when the system is operating in standard mode. For more information about the system operating mode, see device management configuration in Fundamentals Configuration Guide.

In standard system operating mode, this command is available only for the following cards:

Card category	Cards
CEPC	CEPC-XP4LX, CEPC-XP24LX, CEPC-XP48RX, CEPC-CP4RX, CEPC-CP4RXA, CEPC-CP4RX-L, CEPC-CQ8L, CEPC-CQ8LA, CEPC-CQ8L1A, CEPC-CQ16L1
CSPEX	CSPEX-1304X, CSPEX-1404X, CSPEX-1502X, CSPEX-1504X, CSPEX-1504XA, CSPEX-1602X, CSPEX-1602XA, CSPEX-1804X, CSPEX-1512X, CSPEX-1612X, CSPEX-1812X, CSPEX-1802X, CSPEX-1802XA, CSPEX-1812X-E, CSPEX-2304X-G, CSPEX-1502XA, CSPEX-2612XA
SPE	RX-SPE200, RX-SPE200-E

This command is not supported when the system is operating in sdn-wan mode.

Examples

# Enable the device to assign unique MAC addresses to Layer 3 aggregate interfaces.

<Sysname> system-view

[Sysname] route-aggregation different-mac-address enable

shutdown

Use shutdown to shut down an aggregate interface or subinterface.

Use undo shutdown to bring up an aggregate interface or subinterface.

Syntax

shutdown

undo shutdown

Default

An interface or a subinterface is not manually shut down.

Views

Layer 2 aggregate interface view

Layer 3 aggregate interface view

Layer 3 aggregate subinterface view

Predefined user roles

network-admin

Usage guidelines

CAUTION:

The shutdown command will disconnect all links established on an interface. Make sure you are fully aware of the impacts of this command when you use it on a live network.

Shutting down or bringing up a Layer 3 aggregate interface shuts down or brings up its subinterfaces. Shutting down or bringing up a Layer 3 aggregate subinterface does not affect its main interface.

Examples

# Bring up Layer 2 aggregate interface Bridge-Aggregation 1.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] undo shutdown

# Bring up Layer 3 aggregate interface Route-Aggregation 1.

<Sysname> system-view

[Sysname] interface route-aggregation 1

[Sysname-Route-Aggregation1] undo shutdown

system-hash-mode

Use system-hash-mode to configure the hash value calculation mode of cards.

Use undo system-hash-mode to restore the default.

Syntax

system-hash-mode { lbid | mac }

undo system-hash-mode

IMPORTANT:

This command is supported only on CR16006-F, CR16010-F (single fan frame model), CR16010-F (double fan frame model), and CR16014-F devices.

Default

For the CR16006-F, CR16010-F (single fan frame model), CR16010-F (double fan frame model), and CR16014-F devices, the CSPEX-1204 card calculates the hash value based on the MAC address of the sent packets. Other service cards use the load balance ID (LBID) as the hash value.

Views

System view

Predefined user roles

network-admin

Parameters

lbid: Uses LBID as the hash value. The LBID has been calculated by the uplink device.

mac: Calculates the hash value based on the MAC address of the sent packets.

Usage guidelines

IMPORTANT:

Ensure that no service traffic exists on cards before switching the hash value calculation mode. If service traffic exists on a card, the service traffic will be interrupted when the hash value calculation mode is switched.

If the hash values of the cards are calculated in different ways, the interfaces on the cards cannot be added to the same aggregation group. If Ethernet link aggregation is performed on interfaces on different cards, ensure that the hash values of the cards are calculated in the same way.

This feature takes effect only on the following cards. If cards listed in the following table exist on the device, the hash value calculation mode of the cards will be changed simultaneously. Other cards can only use the default mode to calculate the card hash value.

Card category	Cards
CEPC	CSPC-GE16XP4L-E, CSPC-GE24L-E, CSPC-GP24GE8XP2L-E
CSPEX	CSPEX-1104-E, CSPEX-1304X, CSPEX-1404X, CSPEX-1502X, CSPEX-1504X, CSPEX-1602X
SPE	CEPC-CP4RX, CEPC-CP4RX-L, CEPC-XP4LX, CEPC-XP24LX, CEPC-XP48RX

· For cards whose hash value calculation mode is switched simultaneously, if the LBID is used as the hash value, the card can perform Ethernet link aggregation with the CSPEX-2304X-G card.

· For cards whose hash value calculation mode is switched simultaneously, if the hash value is calculated based on the MAC address of the sent packets, Ethernet link aggregation can be performed with the CSPEX-1204 card.

Examples

# Calculate the hash value of the card based on the MAC address of the sent packets.

<Sysname> system-view

[Sysname] system-hash-mode mac

An inconsistency exists in the hash calculation mode of the cards where the member ports of the aggregation group reside.

Changing the hash calculation mode might cause service anomaly in the HDLC link bundle or aggregation group.

Are you sure you want to continue? [Y/N]:y

The above information indicates that:

· After the hash value calculation mode of cards is switched, an inconsistency exists in the hash value calculation mode of the cards where the member ports of the aggregation group reside.

· Changing the hash calculation mode might cause service anomaly in the HDLC link bundle or aggregation group.

# Calculate the hash value of the current card based on the MAC address of the sent packets.

<Sysname> system-view

[Sysname] system-hash-mode mac

Changing the hash calculation mode might cause service anomaly in the HDLC link bundle or aggregation group.

Are you sure you want to continue? [Y/N]:y

The above information indicates that changing the hash calculation mode might cause service anomaly in the HDLC link bundle or aggregation group.

traffic-statistic enable

Use traffic-statistic enable to enable packet statistics for a Layer 3 aggregate subinterface.

Use undo traffic-statistic enable to disable packet statistics for a Layer 3 aggregate subinterface.

Syntax

traffic-statistic enable

undo traffic-statistic enable

Default

The packet statistics feature is disabled for a Layer 3 aggregate subinterface.

Views

Layer 3 aggregate subinterface view

Predefined user roles

network-admin

Usage guidelines

The packet statistics feature is CPU intensive. When you use this command for Layer 3 aggregate subinterfaces, make sure you fully understand its impact on system performance.

You can use the flow-interval command to adjust the interval at which the statistics are polled. To conserve hardware resources, increase the polling interval. For more information about this command, see Ethernet interface commands in Interface Command Reference.

To view packet statistics of Layer 3 aggregate subinterfaces, use the display interface command.

Examples

# Enable packet statistics for Layer 3 aggregate subinterface Route-Aggregation 1.1.

<Sysname> system-view

[Sysname] interface route-aggregation 1.1

[Sysname-Route-Aggregation1.1] traffic-statistic enable

Related commands

display interface

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

The interframe gap and preamble statistics are enabled in the traffic statistics.

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.

Examples

# 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

04-Layer 2—LAN Switching Command Reference

bandwidth

display link-aggregation verbose

interface bridge-aggregation

interface route-aggregation

link-aggregation port-priority

link-aggregation secondary-down

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

Company Information

News & Events

Contact Us