- Table of Contents
-
- 04-Layer 2 - LAN Switching Command Reference
- 00-Preface
- 01-MAC address table commands
- 02-Ethernet link aggregation commands
- 03-Port isolation commands
- 04-VLAN commands
- 05-MVRP commands
- 06-QinQ commands
- 07-VLAN mapping commands
- 08-VLAN termination commands
- 09-Spanning tree commands
- 10-LLDP commands
- 11-Service loopback group commands
- 12-Loop detection commands
- Related Documents
-
Title | Size | Download |
---|---|---|
02-Ethernet link aggregation commands | 151.63 KB |
Ethernet link aggregation commands
display link-aggregation load-sharing mode
display link-aggregation member-port
display link-aggregation summary
display link-aggregation verbose
lacp default-selected-port disable
link-aggregation global load-sharing mode
link-aggregation lacp traffic-redirect-notification enable
link-aggregation port-priority
link-aggregation selected-port maximum
link-aggregation selected-port minimum
link-aggregation selected-port minimum percentage
route-aggregation different-mac-address enable
Ethernet link aggregation commands
bandwidth
Use bandwidth to set the expected bandwidth for an interface.
Use undo bandwidth to restore the default.
Syntax
bandwidth bandwidth-value
undo bandwidth
Default
The expected bandwidth (in kbps) is the interface baud rate divided by 1000.
Views
Layer 2 aggregate interface view
Layer 3 aggregate interface view
Layer 3 aggregate subinterface view
Predefined user roles
network-admin
Parameters
bandwidth-value: Specifies the expected bandwidth in the range of 1 to 400000000 kbps.
Usage guidelines
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 interface Route-Aggregation 1.
<Sysname> system-view
[Sysname] interface route-aggregation 1
[Sysname-Route-Aggregation1] bandwidth 10000
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 interface Route-Aggregation 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 Route-Aggregation 1 is Route-Aggregation1 Interface.
Views
Layer 2 aggregate interface view
Layer 3 aggregate interface view
Layer 3 aggregate subinterface 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 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 } [ interface-number ] ] [ brief [ description | down ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
bridge-aggregation: Specifies Layer 2 aggregate interfaces.
route-aggregation: Specifies Layer 3 aggregate interfaces.
interface-number: Specifies an existing aggregate interface number.
brief: Displays brief interface information. If you do not specify this keyword, the command displays detailed interface information.
description: Displays the complete interface description. 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 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
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
# Display detailed information about 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
# Display brief information about 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 interface Route-Aggregation 1.
<Sysname> display interface route-aggregation 1 brief
Brief information on interfaces in route mode:
Link: ADM - administratively down; Stby - standby
Protocol: (s) - spoofing
Interface Link Protocol Primary IP Description
RAGG1 UP UP --
Table 1 Command output
Field |
Description |
Bridge-Aggregation1 |
Layer 2 aggregate interface name. |
Route-Aggregation1 |
Layer 3 aggregate interface name. |
Current state |
Physical link state of the interface: · Administratively DOWN—The interface has been shut down by using the shutdown command. · DOWN—The interface is administratively up, but its physical state is down (possibly because no physical link exists or the link has failed). · UP—The interface is both administratively and physically up. |
IP packet frame type |
IPv4 packet framing format. |
Description |
Description of the interface. |
Bandwidth |
Expected bandwidth of the interface. This field is not displayed when the bandwidth is 0 kbps. |
Port priority |
Port priority of the interface. |
Unknown-speed mode, unknown-duplex mode |
The interface speed and duplex mode are unknown. |
Port link-type |
Port link type: · Access. · Trunk. · Hybrid. |
Tagged VLANs |
VLAN whose packets are sent out of this interface with a tag. |
Untagged VLANs |
VLAN whose packets are sent out of this interface without a tag. |
Last clearing of counters |
Time when the reset counters interface command was last used to clear the interface statistics. This field displays Never if the reset counters interface command has never been used on the interface since device startup. |
Last 300 seconds input/output rate |
Average input or output rate over the last 300 seconds. |
Input/Output (total) |
Statistics of all packets received or sent on the interface. |
Input/Output (normal) |
Statistics of all normal packets received or sent on the interface. |
Line protocol state |
Data link layer state of the interface: · UP. · DOWN. |
Maximum transmission unit |
MTU of the interface. |
Internet protocol processing: Disabled |
The interface is not assigned an IP address and cannot process IP packets. |
Internet address |
IP address of the interface. The primary attribute indicates that the address is the primary IP address. |
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). |
lacp system-priority
display link-aggregation load-sharing mode
Use display link-aggregation load-sharing mode to display the global link-aggregation load sharing mode.
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 |
Default link-aggregation load sharing mode for MPLS traffic. In this sample output, MPLS traffic is load shared based on Layer 1 and Layer 2 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 GigabitEthernet 3/1/1, which is a member port of a static aggregation group.
<Sysname> display link-aggregation member-port gigabitethernet 3/1/1
Flags: A -- LACP_Activity, B -- LACP_Timeout, C -- Aggregation,
D -- Synchronization, E -- Collecting, F -- Distributing,
G -- Defaulted, H -- Expired
GigabitEthernet3/1/1:
Aggregate Interface: Route-Aggregation1
Port Number: 1
Port Priority: 32768
Oper-Key: 1
# Display detailed link aggregation information about GigabitEthernet 3/1/2, which is a member port of a dynamic aggregation group.
<Sysname> display link-aggregation member-port gigabitethernet 3/1/2
Flags: A -- LACP_Activity, B -- LACP_Timeout, C -- Aggregation,
D -- Synchronization, E -- Collecting, F -- Distributing,
G -- Defaulted, H -- Expired
GigabitEthernet3/1/2:
Aggregate Interface: Route-Aggregation2
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
Aggregation Interface Type:
BAGG -- Bridge-Aggregation, BLAGG -- Blade-Aggregation, RAGG -- Route-Aggregatio
n, SCH-B -- Schannel-Bundle
Aggregation Mode: S -- Static, D -- Dynamic
Loadsharing Type: Shar -- Loadsharing, NonS -- Non-Loadsharing
Actor System ID: 0x8000, 7425-8ae3-9853
AGG AGG Partner ID Selected Unselected Individual Share
Interface Mode Ports Ports Ports Type
--------------------------------------------------------------------------------
RAGG1 D 0x8000, 0000-0000-0000 0 1 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 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. The value range for the interface-number argument varies by device model.
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.
The bridge-aggregation or route-aggregation keyword is available only when aggregate interfaces of that type exist.
Examples
# 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
Aggregate Interface: Route-Aggregation1
Aggregation Mode: Dynamic
Loadsharing Type: Shar
System ID: 0x8000, 7425-8ae3-9853
Local:
Port Status Priority Index Oper-Key Flag
GE3/1/1 U 32768 1 1 {ACG}
GE3/1/2 U 32768 2 1 {ACG}
Remote:
Actor Priority Index Oper-Key SystemID Flag
GE3/1/1 32768 0 0 0x8000, 0000-0000-0000 {DEF}
GE3/1/2 32768 0 0 0x8000, 0000-0000-0000 {DEF}
# 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
Aggregate Interface: Route-Aggregation1
Aggregation Mode: Static
Loadsharing Type: Shar
Port Status Priority Oper-Key
GE3/1/1 S 32768 1
GE3/1/2 S 32768 1
Table 6 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. |
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. · Oper-Key—Operational key. · Flag—LACP state flag. NOTE: For static aggregation groups, the Flag field is not displayed. |
Remote |
Information about the peer end: · Actor—Type and number of the local port. · Partner—Index of the peer port. · Priority—Priority of the peer port. · Oper-Key—Operational key of the peer port. · System ID—System ID of the peer end. · Flag—LACP state flag of the peer end. |
interface bridge-aggregation
Use interface bridge-aggregation to create a Layer 2 aggregate interface and enter its view, or enter the view of an existing Layer 2 aggregate interface.
Use undo interface bridge-aggregation to delete a Layer 2 aggregate interface.
Syntax
interface bridge-aggregation interface-number
undo interface bridge-aggregation interface-number
Default
No Layer 2 aggregate interfaces exist.
Views
System view
Predefined user roles
network-admin
Parameters
interface-number: Specifies a Layer 2 aggregate interface number. The value range for the interface-number argument is 1 to 1024.
Usage guidelines
When you create a Layer 2 aggregate interface, the system automatically creates a Layer 2 aggregation group with the same number. The aggregation group operates in static aggregation mode by default.
Deleting a Layer 2 aggregate interface also deletes the Layer 2 aggregation group. At the same time, the member ports of the aggregation group, if any, leave the aggregation group.
Examples
# Create Layer 2 aggregate interface Bridge-Aggregation 1, and enter its view.
<Sysname> system-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1]
interface route-aggregation
Use interface route-aggregation to create a Layer 3 aggregate interface or subinterface and enter its view, or enter the view of an existing Layer 3 aggregate interface or subinterface.
Use undo interface route-aggregation to delete a Layer 3 aggregate interface or subinterface.
Syntax
interface route-aggregation { interface-number | interface-number.subnumber }
undo interface route-aggregation { interface-number | interface-number.subnumber }
Default
No Layer 3 aggregate interfaces or subinterfaces exist.
Views
System view
Predefined user roles
network-admin
Parameters
interface-number: Specifies a Layer 3 aggregate interface number. The value range for the interface-number argument is 1 to 1024.
interface-number.subnumber: Specifies a subinterface of a Layer 3 aggregate interface. The interface-number argument specifies the main aggregate interface number. The subnumber argument specifies the subinterface number and is separated from the main interface number by a dot (.). The value range for the subnumber argument is 1 to 99999999 and you can create a maximum of 4094 subinterfaces on a main aggregate interface except that the aggregate interface contains member ports on the CSPC (except CSPC-GE16XP4L-E, CSPC-GE24L-E, and CSPC-GP24GE8XP2L-E) or CMPE-1104 card. If the main aggregate interface contain member ports on those cards, the value range for the subnumber argument is 1 to 4093.
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. At the same time, the member ports of the aggregation group, if any, leave the aggregation group.
Deleting a Layer 3 aggregate subinterface does not affect the state of the main interface and the corresponding aggregation group.
Examples
# Create Layer 3 aggregate interface Route-Aggregation 1 and enter its view.
<Sysname> system-view
[Sysname] interface route-aggregation 1
[Sysname-Route-Aggregation1]
# 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]
lacp default-selected-port disable
Use lacp default-selected-port disable to disable the default port selection action for dynamic aggregation groups.
Use undo lacp default-selected-port disable to enable the default port selection action for dynamic aggregation groups.
Syntax
lacp default-selected-port disable
undo lacp default-selected-port disable
Default
The default port selection action is enabled for dynamic aggregation groups.
Views
System view
Predefined user roles
network-admin
Usage guidelines
The default port selection action applies to dynamic aggregation groups.
This action automatically chooses the port with the lowest ID from among all up member ports as a Selected port if none of them has received LACPDUs before the LACP timeout interval expires.
After this action is disabled, a dynamic aggregation group will not have any Selected ports to forward traffic if it has not received LACPDUs before the LACP timeout interval expires.
Examples
# Disable the default port selection action.
<Sysname> system-view
[Sysname] lacp default-selected-port disable
lacp edge-port
Use lacp edge-port to configure an aggregate interface as an edge aggregate interface.
Use undo lacp edge-port to restore the default.
Syntax
lacp edge-port
undo lacp edge-port
Default
An aggregate interface does not operate as an edge aggregate interface.
Views
Layer 2 aggregate interface view
Layer 3 aggregate interface view
Predefined user roles
network-admin
Usage guidelines
Use this command on the aggregate interface that connects the device to a server if dynamic link aggregation is configured only on the device. This feature improves link reliability by enabling all member ports of the aggregation group to forward packets.
This command takes effect only on an aggregate interface corresponding to a dynamic aggregation group.
Link-aggregation traffic redirection cannot operate correctly on an edge aggregate interface.
Examples
# Configure 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
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 GigabitEthernet 3/1/1.
<Sysname> system-view
[Sysname] interface gigabitethernet3/1/1
[Sysname-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
Predefined user roles
network-admin
Examples
# Set the short LACP timeout interval (3 seconds) on GigabitEthernet 3/1/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 3/1/1
[Sysname-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.
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 ipv4
Use link-aggregation bfd ipv4 to enable BFD for an aggregation group.
Use undo link-aggregation bfd to disable BFD for an aggregation group.
Syntax
link-aggregation bfd ipv4 source ip-address destination ip-address
undo link-aggregation bfd
Default
BFD is disabled for an aggregation group.
Views
Layer 2 aggregate interface view
Layer 3 aggregate interface view
Predefined user roles
network-admin
Parameters
source ip-address: Specifies the unicast source IP address of BFD sessions. The source IP address cannot be 0.0.0.0.
destination ip-address: Specifies the unicast destination IP address of BFD sessions. The destination IP address cannot be 0.0.0.0.
Usage guidelines
This command is not supported on the CSPC-GE16XP4L-Em, CSPC-GE24L-E, CSPC-GP24GE8XP2L-E, CSPEX-1104-E, or CSPEX-1204 card.
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 a protocol to collaborate with BFD on a BFD-enabled aggregate interface.
Make sure the number of member ports in the BFD-enabled aggregation group is less than or identical to the number of BFD sessions supported by the device. If the aggregation group contains more member ports than the supported sessions, some Selected ports might change to the Unselected state.
If the number of BFD sessions differs between the two ends of an aggregate link, check their settings for inconsistency in the maximum number of Selected ports. You must make sure the two ends have the same setting for the maximum number of Selected ports.
Examples
# Enable BFD for Layer 3 aggregation group 1, and specify the source and destination IP addresses as 1.1.1.1 and 2.2.2.2 for BFD sessions.
<Sysname> system-view
[Sysname] interface route-aggregation 1
[Sysname-Route-Aggregation1] link-aggregation bfd ipv4 source 1.1.1.1 destination 2.2.2.2
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
Aggregation groups automatically choose a load sharing mode depending on the packet type.
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, an error prompt appears.
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
This command is supported only on the CSPC-GE16XP4L-E, CSPC-GE24L-E, CSPC-GP24GE8XP2L-E, CSPEX, and CEPC cards.
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 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
|
IMPORTANT: This feature might cause aggregation group communication failure if the peer aggregation system is a third-party device. Make sure you are fully aware of the impacts of this command when you use it on a live network. |
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.
Examples
# Enable link-aggregation traffic redirection.
<Sysname> system-view
[Sysname] link-aggregation lacp traffic-redirect-notification enable
link-aggregation mode
Use link-aggregation mode dynamic to configure an aggregation group to operate in dynamic aggregation mode and enable LACP.
Use undo link-aggregation mode to restore the default.
Syntax
link-aggregation mode dynamic
undo link-aggregation mode
Default
An aggregation group operates in static aggregation mode.
Views
Layer 2 aggregate interface view
Layer 3 aggregate interface view
Predefined user roles
network-admin
Examples
# 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
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 3 Ethernet interface GigabitEthernet 3/1/2.
<Sysname> system-view
[Sysname] interface gigabitethernet 3/1/2
[Sysname-GigabitEthernet3/1/2] link-aggregation port-priority 64
Related commands
lacp system-priority
link-aggregation selected-port maximum
Use link-aggregation selected-port maximum to set the maximum number of Selected ports allowed in an aggregation group.
Use undo link-aggregation selected-port maximum to restore the default.
Syntax
link-aggregation selected-port maximum max-number
undo link-aggregation selected-port maximum
Default
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. The value range for this argument is 1 to 32.
Usage guidelines
Executing this command might cause some of the Selected ports in an aggregation group to become Unselected ports.
The maximum number of Selected ports allowed in the aggregation groups must be the same for the local and peer ends.
For an aggregation group, the maximum number of Selected ports must be equal to or higher than the minimum number of Selected ports.
The maximum number of Selected ports allowed in an aggregation group is limited by one of the following values, whichever value is smaller:
· Maximum number set by using the link-aggregation selected-port maximum command.
· Maximum number of Selected ports allowed by the link aggregation capability.
You can implement backup between two ports by performing the following tasks:
· Assigning two ports to an aggregation group.
· Setting the maximum number of Selected ports to 1 for the aggregation group.
Then, only one Selected port is allowed in the aggregation group at any point in time, while the Unselected port acts as a backup port.
Examples
# Set the maximum number of Selected ports to 5 for Layer 3 aggregation group 1.
<Sysname> system-view
[Sysname] interface route-aggregation 1
[Sysname-Route-Aggregation1] link-aggregation selected-port maximum 5
Related commands
link-aggregation selected-port minimum
link-aggregation selected-port minimum
Use link-aggregation selected-port minimum to set the minimum number of Selected ports in an aggregation group.
Use undo link-aggregation selected-port minimum to restore the default.
Syntax
link-aggregation selected-port minimum min-number
undo link-aggregation selected-port minimum
Default
The minimum number of Selected ports in an aggregation group is not specified.
Views
Layer 2 aggregate interface view
Layer 3 aggregate interface view
Predefined user roles
network-admin
Parameters
min-number: Specifies the minimum number of Selected ports in an aggregation group required to bring up the aggregate interface. The value range for this argument is 1 to 32.
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 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.
Examples
# Set the minimum percentage of Selected ports to 50% for Layer 3 aggregate interface Route-Aggregation 1.
<Sysname> system-view
[Sysname] interface route-aggregation 1
[Sysname-Route-Aggregation1] link-aggregation selected-port minimum percentage 50
Related commands
link-aggregation selected-port minimum
mac-address
Use mac-address to assign a MAC address to an aggregate interface.
Use undo mac-address to restore the default.
Syntax
mac-address mac-address
undo mac-address
Default
The device automatically assigns a MAC address to an aggregate interface.
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
By default, all aggregate interfaces on a device use the same MAC address and aggregate interfaces on different devices use different MAC addresses.
Examples
# Assign MAC address 0001-0001-0001 to 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 of a Layer 3 aggregate interface or subinterface.
Use undo mtu to restore the default.
Syntax
mtu size
undo mtu
Default
The MTU of Layer 3 aggregate interfaces and subinterfaces is 1500 bytes.
Views
Layer 3 aggregate interface view
Layer 3 aggregate subinterface view
Predefined user roles
network-admin
Parameters
size: Specifies the MTU in bytes. The value range varies by card model.
Usage guidelines
The maximum MTU value supported on an interface varies by card. You must make sure the MTUs of a Layer 3 aggregate interface and its subinterfaces do not exceed the lowest maximum MTU supported among the aggregation member ports. For example, the maximum interface MTUs supported by MIC and PIC-PS2G4L subcards on the CSPEX-1204 card are 2980 bytes and 2000 bytes, respectively. Then, the MTU of the Layer 3 aggregate interface and its subinterfaces must not exceed 2000 bytes if the aggregation member ports are on those two subcards. For the MTU range supported by a card, see Ethernet interface commands in Interface Command Reference.
As a best practice, set an MTU larger than 1280 bytes on a Layer 3 aggregate interface or subinterface if the device contains CSPC-GE16XP4L-E, CSPC-GE24L-E, CSPC-GP24GE8XP2L-E, CSPEX, or CEPC cards. When forwarding the IP packets received from those cards, the aggregate interface will fragment the packets into 1280 bytes if its MTU is smaller than 1280 bytes.
When forwarding the IP packets received from the following cards, the aggregate interface ignores the MTU setting and does not fragment the packets:
· CSPC cards except CSPC-GE16XP4L-E, CSPC-GE24L-E, and CSPC-GP24GE8XP2L-E.
· CMPE-1104 card.
Examples
# Set the MTU to 1430 bytes for interface Route-Aggregation 1.
<Sysname> system-view
[Sysname] interface route-aggregation 1
[Sysname-Route-Aggregation1] mtu 1430
display interface
port link-aggregation group
Use port link-aggregation group to assign an interface to an aggregation group.
Use undo port link-aggregation group to remove an interface from the aggregation group to which it belongs.
Syntax
port link-aggregation group group-id
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
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 can be assigned only to a Layer 2 aggregation group. A Layer 3 Ethernet interface can be assigned only to a Layer 3 aggregation group.
An Ethernet interface can belong to only one aggregation group.
Examples
# Assign Layer 3 Ethernet interface GigabitEthernet 3/1/2 to Layer 3 aggregation group 2.
<Sysname> system-view
[Sysname] interface gigabitethernet 3/1/2
[Sysname-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 aggregate interfaces of that type exist.
Examples
# Clear the statistics about 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
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. The system operating mode is configurable with the system-working-mode command. For more information about the system operating mode, see device management configuration in Fundamentals Configuration Guide.
To assign unique MAC addresses to Layer 3 aggregate interfaces, make sure the member ports of all Layer 3 aggregation groups are on the following cards:
· CEPC cards.
· CSPEX cards.
· CSPC-GE16XP4L-E, CSPC-GE24L-E, and CSPC-GP24GE8XP2L-E cards.
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 aggregate interface or 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
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 interface Route-Aggregation 1.
<Sysname> system-view
[Sysname] interface route-aggregation 1
[Sysname-Route-Aggregation1] undo shutdown
sub-interface rate-statistic
Use sub-interface rate-statistic to enable rate statistics collection for the subinterfaces of a Layer 3 aggregate interface.
Use undo sub-interface rate-statistic to disable rate statistics collection for the subinterfaces of a Layer 3 aggregate interface.
Syntax
sub-interface rate-statistic
undo sub-interface rate-statistic
Default
Rate statistics collection is disabled for Layer 3 aggregate subinterfaces.
Views
Layer 3 aggregate interface view
Predefined user roles
network-admin
Usage guidelines
This command takes effect only if the member interfaces of the Layer 3 aggregate interface are on the following cards:
· CSPC-GE16XP4L-E, CSPC-GE24L-E, or CSPC-GP24GE8XP2L-E card.
· CSPEX cards.
· CEPC cards.
This command enables the device to periodically refresh rate statistics for the subinterfaces of a Layer 3 aggregate interface. The rate statistics are available in two statistics polling intervals after you execute this command. To set the statistics polling interval, use the flow-interval command.
Examples
# Enable rate statistics collection for the subinterfaces of Route-Aggregation 1.
<Sysname> system-view
[Sysname] interface route-aggregation 1
[Sysname-Route-Aggregation1] sub-interface rate-statistic
This configuration may make a negative effect on the performance. Are you sure to continue? [Y/N]:y
The configuration will take effect after 2 flow intervals.
Related commands
flow-interval (Interface Command Reference)
traffic-statistic 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
This command takes effect only if the member interfaces of the Layer 3 aggregate interface are on the following cards:
· CSPC-GE16XP4L-E, CSPC-GE24L-E, or CSPC-GP24GE8XP2L-E card.
· CSPEX cards.
· CEPC cards.
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)