- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
02-Ethernet link aggregation commands | 178.55 KB |
Ethernet link aggregation commands
display link-aggregation load-sharing mode
display link-aggregation member-port
display link-aggregation summary
display link-aggregation verbose
link-aggregation global load-sharing mode
link-aggregation port-priority
link-aggregation selected-port maximum
link-aggregation selected-port minimum
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
mdc-admin
Parameters
bandwidth-value: Specifies the expected bandwidth in the range of 1 to 400000000 kbps.
Usage guidelines
The expected bandwidth of an interface affects link costs in OSPF, OSPFv3, and IS-IS. For more information, see Layer 3—IP Routing Configuration Guide.
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
default
Use default to restore the default settings for an interface.
Syntax
default
Views
Layer 2 aggregate interface view, Layer 3 aggregate interface view, Layer 3 aggregate subinterface view
Predefined user roles
network-admin
mdc-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
description
Use description to set a description for an interface.
Use undo description to restore the default.
Syntax
description text
undo description
Default
The description of an interface is the interface-name plus 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
Predefined user roles
network-admin
mdc-admin
Parameters
text: Specifies the interface description, a string of 1 to 255 characters.
Examples
# Set the description to 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
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
mdc-admin
mdc-operator
Parameters
bridge-aggregation: Specifies Layer 2 aggregate interfaces.
route-aggregation: Specifies Layer 3 aggregate interfaces.
interface-number: Specifies an existing aggregate interface number. The value range for the interface-number argument is the set of all existing aggregate interface numbers.
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 the down state and the causes. If you do not specify this keyword, the command displays information about interfaces in all states.
Usage guidelines
If you do not specify the bridge-aggregation and route-aggregation keywords, the command displays information about all interfaces.
If you specify the bridge-aggregation or route-aggregation keyword and do not specify an interface number, the command displays information about all aggregate interfaces of that type.
If you specify the bridge-aggregation interface-number or route-aggregation interface-number option, the command displays information about the specified aggregate interface.
Examples
# Display detailed information about Layer 2 aggregate interface Bridge-Aggregation 1.
<Sysname> display interface bridge-aggregation 1
Bridge-Aggregation1
Current state: UP
IP Packet Frame Type: PKTFMT_ETHNT_2, Hardware Address: 000f-e207-f2e0
Description: Bridge-Aggregation1 Interface
Bandwidth: 0kbps
2Gbps-speed mode, full-duplex mode
Link speed type is autonegotiation, link duplex type is autonegotiation
PVID: 1
Port link-type: access
Tagged Vlan: none
UnTagged Vlan: 1
Last clearing of counters: Never
Last 300 seconds input: 6900 packets/sec 885160 bytes/sec 0%
Last 300 seconds output: 3150 packets/sec 404430 bytes/sec 0%
Input (total): 5364747 packets, 686688416 bytes
2682273 unicasts, 1341137 broadcasts, 1341337 multicasts, 0 pauses
Input (normal): 5364747 packets, 686688416 bytes
2682273 unicasts, 1341137 broadcasts, 1341337 multicasts, 0 pauses
Input: 0 input errors, 0 runts, 0 giants, 0 throttles
0 CRC, 0 frame, 0 overruns, - aborts
- ignored, - parity errors
Output (total): 1042508 packets, 133441832 bytes
1042306 unicasts, 0 broadcasts, 202 multicasts, - pauses
Output (normal): 1042508 packets, 133441832 bytes
1042306 unicasts, 0 broadcasts, 202 multicasts, 0 pauses
Output: 0 output errors, - underruns, - buffer failures
0 aborts, 0 deferred, 0 collisions, 0 late collisions
- lost carrier, - no carrier
# Display detailed information about Layer 3 aggregate interface Route-Aggregation 1.
<Sysname> display interface route-aggregation 1
Route-Aggregation1
Current state: Administratively DOWN
Line protocol state: DOWN
Description: Route-Aggregation1 Interface
Bandwidth: 0kbps
Maximum Transmit Unit: 1500
Internet protocol processing: disabled
IP Packet Frame Type:PKTFMT_ETHNT_2, Hardware Address: b8af-6730-3300
IPv6 Packet Frame Type:PKTFMT_ETHNT_2, Hardware Address: b8af-6730-3300
Unknown-speed mode, unknown-duplex mode
Link speed type is autonegotiation, link duplex type is autonegotiation
Last clearing of counters: Never
Last 300 seconds input rate: 0 bytes/sec, 0 bits/sec, 0 packets/sec
Last 300 seconds input rate: 0 bytes/sec, 0 bits/sec, 0 packets/sec
0 packets input, 0 bytes, 0 drops
0 packets output, 0 bytes, 0 drops
# Display brief information about Layer 2 aggregate interface Bridge-Aggregation 1.
<Sysname> display interface bridge-aggregation 1 brief
Brief information on interface(s) under bridge mode:
Link: ADM - administratively down; Stby - standby
Speed or 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 interface(s) under route mode:
Link: ADM - administratively down; Stby - standby
Protocol: (s) - spoofing
Interface Link Protocol Main 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 |
Layer 3 aggregate interface status: · Administratively DOWN—The interface is administratively shut down with the shutdown command. · DOWN—The interface is administratively up but physically down (possibly because no physical link is present or the link has failed). · UP—The Ethernet interface is both administratively and physically up. |
IP Packet Frame Type |
IPv4 packet frame format. The value PKTFMT_ETHNT_2 indicates that packets are encapsulated in Ethernet II format. |
Description |
Partial or complete interface description configured by using the description command. · If you do not specify the description keyword in the display interface brief command, this field displays only the first 27 characters of the interface description. · If you specify the description keyword in the display interface brief command, this field displays the complete interface description. |
Bandwidth |
Expected bandwidth of the interface. |
Unknown-speed mode, unknown-duplex mode |
The interface speed and duplex mode are unknown. |
PVID |
Port VLAN ID (PVID). |
Port link-type |
Port link type: access, trunk, or hybrid. |
Tagged Vlan |
VLAN whose packets are sent out of this interface with a tag. |
Untagged Vlan |
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. Never indicates the reset counters interface command has never been used on the interface since the switch startup. |
Last 300 seconds input/output rate |
Average input/output rate over the last 300 seconds. |
Input/Output (total) |
Statistics of all packets received/sent on the interface. |
Input/Output (normal) |
Statistics of all normal packets received/sent on the interface. |
Line protocol state |
Link layer state of the interface. |
Internet protocol processing |
IP packet processing. Disabled indicates that IP packets cannot be processed. For an interface configured with an IP address, this field changes to Internet Address is. |
Brief information on interface(s) under route mode |
Brief information about Layer 3 interfaces. |
Brief information on interface(s) under bridge mode |
Brief information about Layer 2 interfaces. |
Link: ADM - administratively down; Stby - standby |
Link status: · ADM—The interface has been administratively shut down. To recover its physical layer state, run the undo shutdown command. · Stby—The interface is operating as a backup interface. |
Speed or Duplex: (a)/A - auto; H - half; F - full |
If the speed of an interface is automatically negotiated, its speed attribute includes the auto negotiation flag (the letter a in parentheses). If the duplex mode of an interface is automatically negotiated, its duplex mode attribute includes the letter a in parentheses or a capital A. The letter H indicates the half duplex mode, and the letter F indicates the full duplex mode. |
Type: A - access; T - trunk; H - hybrid |
Link type options for Ethernet interfaces. |
Protocol: (s) - spoofing |
If the data link layer protocol state of an interface is shown as UP, but its link is an on-demand link or not present, its protocol attribute includes the spoofing flag (the letter s in parentheses). |
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 administratively shut down. To bring up the interface, use the undo shutdown command. · Stby—The interface is operating as a backup interface. |
Speed |
Interface speed, in bps. |
Protocol |
Data link layer protocol state of the interface: · UP—The data link layer protocol is up on the interface. · DOWN—The data link layer protocol is down on the interface. · UP(s)—The data link layer protocol state of the interface is shown as UP, but its link is an on-demand link or not present. |
Cause |
Cause of a DOWN physical link. |
display lacp system-id
Use display lacp system-id to display the system ID of the local system.
Syntax
display lacp system-id
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-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 as a hexadecimal value by 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 global link-aggregation load sharing modes.
Syntax
display link-aggregation load-sharing mode
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Examples
# Display the default global link-aggregation load sharing modes.
<Sysname> display link-aggregation load-sharing mode
Link-aggregation load-sharing mode:
Layer 2 traffic: destination-mac address source-mac address
Layer 3 traffic: destination-mac address source-mac address
destination-ip address source-ip address
Layer 4 traffic: destination-mac address source-mac address
destination-ip address source-ip address
destination-port source-port
MPLS traffic : destination-mac address source-mac address
mpls-label1 mpls-label2
mpls-label3
# Display the configured global link-aggregation load sharing mode.
<Sysname> display link-aggregation load-sharing mode
Link-aggregation load-sharing mode:
destination-mac address source-mac address
Table 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 traffic, Layer 3 traffic, Layer 4 traffic, and MPLS traffic. · If you have configured the global link-aggregation load sharing mode, this field displays the configured mode. |
Layer 2 traffic |
Default link-aggregation load sharing mode for Layer 2 traffic. |
Layer 3 traffic |
Default link-aggregation load sharing mode for Layer 3 traffic. |
Layer 4 traffic |
Default link-aggregation load sharing mode for Layer 4 traffic. |
MPLS traffic |
Default link-aggregation load sharing mode for MPLS traffic. |
destination-mac address, source-mac address |
User-configured link-aggregation load sharing mode. In this sample output, traffic is load shared based on the source and destination MAC addresses. |
display link-aggregation member-port
Use display link-aggregation member-port to display detailed link aggregation information for the specified member ports.
Syntax
display link-aggregation member-port [ interface-list ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
interface-list: Specifies a list of link aggregation member ports, in the format interface-type interface-number [ to interface-type interface-number ]. interface-type interface-number specifies an interface by its type and number.
Usage guidelines
A member port in a static aggregation group is unaware of information about the peer group. For such member ports, the command displays the port number, port priority, and operational key of the local end only.
Examples
# (In IRF mode.) Display detailed link aggregation information for GigabitEthernet 1/4/0/6, which is a member port of a static aggregation group.
<Sysname> display link-aggregation member-port GigabitEthernet 1/4/0/6
Flags: A -- LACP_Activity, B -- LACP_Timeout, C -- Aggregation,
D -- Synchronization, E -- Collecting, F -- Distributing,
G -- Defaulted, H -- Expired
GigabitEthernet1/4/0/6:
Lite Aggregate Interface: Bridge-Aggregation1
Port Number: 214
Port Priority: 32768
Oper-Key: 1
# Display detailed link aggregation information for GigabitEthernet 3/0/2, which is a member port of a dynamic aggregation group.
<Sysname> display link-aggregation member-port GigabitEthernet 3/0/2
Flags: A -- LACP_Activity, B -- LACP_Timeout, C -- Aggregation,
D -- Synchronization, E -- Collecting, F -- Distributing,
G -- Defaulted, H -- Expired
GigabitEthernet3/0/2:
Aggregate Interface: Bridge-Aggregation10
Local:
Port Number: 2
Port Priority: 32768
Oper-Key: 2
Flag: {ACDEF}
Remote:
System ID: 0x8000, 000f-e267-6c6a
Port Number: 26
Port Priority: 32768
Oper-Key: 2
Flag: {ACDEF}
Received LACP Packets: 5 packet(s)
Illegal: 0 packet(s)
Sent LACP Packets: 7 packet(s)
Table 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. The letter is present when its bit is 1 and absent when its bit is 0. · A—Indicates whether LACP is enabled. 1 indicates enabled, and 0 indicates disabled. · B—Indicates the LACP short or long timeout. 1 indicates short timeout, and 0 indicates long timeout. · C—Indicates whether the sending system considers that the link is aggregatable. 1 indicates yes, and 0 indicates no. · D—Indicates whether the sending system considers that the link is synchronized. 1 indicates yes, and 0 indicates no. · E—Indicates whether the sending system considers that the incoming frames are collected. 1 indicates yes, and 0 indicates no. · F—Indicates whether the sending system considers that the outgoing frames are distributed. 1 indicates yes, and 0 indicates no. · G—Indicates whether the sending system receives frames in the default state. 1 indicates yes, and 0 indicates no. · H—Indicates whether the sending system receives frames in the expired state. 1 indicates yes, and 0 indicates no. |
Aggregate Interface |
Generic Layer 2 aggregate interface or Layer 3 aggregate interface to which the member port belongs. |
Lite Aggregate Interface |
Lite Layer 2 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 remote end. |
System ID |
Remote end 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 the summary information for all aggregation groups.
Syntax
display link-aggregation summary
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Usage guidelines
Static link aggregation groups are unaware of information about the peer groups. As a result, the Partner ID field displays none for a static link aggregation group.
Examples
# Display the summary information for all aggregation groups.
<Sysname> display link-aggregation summary
Aggregate Interface Type:
BAGG -- Bridge-Aggregation, RAGG -- Route-Aggregation
Aggregation Mode: S -- Static, D -- Dynamic
Loadsharing Type: Shar -- Loadsharing, NonS -- Non-Loadsharing
Actor System ID: 0x8000, 000f-e267-6c6a
AGG AGG Partner ID Selected Unselected Share
Interface Mode Ports Ports Type
-------------------------------------------------------------------------------
BAGG1 S none 1 0 Shar
BAGG10 D 0x8000, 000f-e267-57ad 2 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 system LACP priority and the system MAC address. |
AGG Interface |
Type and number of the aggregate interface. |
AGG Mode |
Aggregation group type. |
Partner ID |
System ID of the partner, which contains the system LACP priority and the system MAC address. |
Selected Ports |
Total number of Selected ports. |
Unselected Ports |
Total number of Unselected 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 ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-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 specify only the bridge-aggregation or route-aggregation keyword, the command displays detailed information about all Layer 2 or Layer 3 aggregation groups.
If you do not specify an aggregate interface type, the command displays detailed information about all aggregation groups.
The bridge-aggregation or route-aggregation keyword is available only when Layer 2 or Layer 3 aggregate interfaces exist on the switch.
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
Flags: A -- LACP_Activity, B -- LACP_Timeout, C -- Aggregation,
D -- Synchronization, E -- Collecting, F -- Distributing,
G -- Defaulted, H -- Expired
Aggregate Interface: Bridge-Aggregation10
Aggregation Mode: Dynamic
Loadsharing Type: Shar
System ID: 0x8000, 000f-e267-6c6a
Local:
Port Status Priority Oper-Key Flag
--------------------------------------------------------------------------------
GE3/0/1 S 32768 2 {ACDEF}
GE3/0/2 S 32768 2 {ACDEF}
Remote:
Actor Partner Priority Oper-Key SystemID Flag
--------------------------------------------------------------------------------
GE3/0/1 1 32768 2 0x8000, 000f-e267-57ad {ACDEF}
GE3/0/2 2 32768 2 0x8000, 000f-e267-57ad {ACDEF}
# Display detailed information about Layer 2 aggregation group 20, which is a static aggregation group.
<Sysname> display link-aggregation verbose bridge-aggregation 20
Loadsharing Type: Shar -- Loadsharing, NonS -- Non-Loadsharing
Port Status: S -- Selected, U -- Unselected, I -- Individual
Flags: A -- LACP_Activity, B -- LACP_Timeout, C -- Aggregation,
D -- Synchronization, E -- Collecting, F -- Distributing,
G -- Defaulted, H -- Expired
Aggregate Interface: Bridge-Aggregation20
Aggregation Mode: Static
Loadsharing Type: Shar
Port Status Priority Oper-Key
--------------------------------------------------------------------------------
GE3/0/1 U 32768 1
GE3/0/2 U 32768 1
GE3/0/3 U 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, or Individual. |
Flags |
LACP state flags. This field is one byte long, represented by ABCDEFGH from the least significant bit to the most significant bit. The letter is present when its bit is 1 and absent when its bit is 0. · A—Indicates whether LACP is enabled. 1 indicates enabled, and 0 indicates disabled. · B—Indicates the LACP short or long timeout. 1 indicates short timeout, and 0 indicates long timeout. · C—Indicates whether the sending system considers that the link is aggregatable. 1 indicates yes, and 0 indicates no. · D—Indicates whether the sending system considers that the link is synchronized. 1 indicates yes, and 0 indicates no. · E—Indicates whether the sending system considers that the incoming frames are collected. 1 indicates yes, and 0 indicates no. · F—Indicates whether the sending system considers that the outgoing frames are distributed. 1 indicates yes, and 0 indicates no. · G—Indicates whether the sending system receives frames in the default state. 1 indicates yes, and 0 indicates no. · H—Indicates whether the sending system receives frames in the expired state. 1 indicates yes, and 0 indicates no. |
Aggregate Interface |
Name of the aggregate interface. The aggregate interface can be either of the following: · Generic Layer 2 aggregate interface. · Layer 3 aggregate interface. |
Lite Aggregate Interface |
Name of a lite Layer 2 aggregate interface. |
Aggregation Mode |
Mode of the aggregation group: · Static for static aggregation. · Dynamic for dynamic aggregation. |
System ID |
Local system ID, containing the system LACP priority and the 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 remote 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 Layer 2 aggregate interface view.
Use undo interface bridge-aggregation to delete a Layer 2 aggregate interface.
Syntax
interface bridge-aggregation interface-number [ lite ]
undo interface bridge-aggregation interface-number
Default
No Layer 2 aggregate interface is created.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
interface-number: Specifies a Layer 2 aggregate interface number in the range of 1 to 16384.
lite : Specifies a lite Layer 2 aggregate interface, which is a special aggregate interface in IRF mode. If you do not specify this keyword, the system creates a generic Layer 2 aggregate interface.
Usage guidelines
When you configure a Layer 2 aggregate interface, follow these restrictions and 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.
· If you delete the Layer 2 aggregate interface, you also delete the Layer 2 aggregation group, and any member ports leave the aggregation group.
· To create a lite or a generic Layer 2 aggregate interface, delete the generic or the lite Layer 2 aggregate interface with the same aggregate interface number first.
When you configure a lite Layer 2 aggregate interface, also follow these restrictions and guidelines:
· You can create a lite Layer 2 aggregation group only in IRF mode. An IRF fabric supports up to 1024 lite Layer 2 aggregation groups. Each IRF member device can have a maximum of one Selected port in a lite Layer 2 aggregation group. The maximum number of Selected ports in a lite Layer 2 aggregation group is identical to the number of member devices.
· Make sure a port has no manually configured MAC address entries before assigning the port to a lite Layer 2 aggregation group.
· Do not manually modify or delete the MAC address entries of a port in a lite Layer 2 aggregation group. Otherwise, traffic cannot be forwarded correctly.
· In IRF mode, do not configure a lite Layer 2 aggregation group and an isolation group on the same device. Otherwise, traffic cannot be forwarded correctly. For more information about port isolation, see "Configuring port isolation."
· You cannot enable EVI on a member port in a lite Layer 2 aggregation group. Moreover, do not assign a transport-facing physical interface of an EVI tunnel to a lite Layer 2 aggregation group. Otherwise, traffic cannot be forwarded through the EVI tunnel. For more information about EVI, see EVI Configuration Guide.
· A lite Layer 2 aggregate interface cannot operate as an OpenFlow port. For more information about OpenFlow, see OpenFlow Configuration Guide.
Examples
# Create generic Layer 2 aggregate interface Bridge-Aggregation 1, and enter its view.
<Sysname> system-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1]
# Create lite Layer 2 aggregate interface Bridge-Aggregation 2, and enter its view.
<Sysname> system-view
[Sysname] interface bridge-aggregation 2 lite
[Sysname-Bridge-Aggregation2]
interface route-aggregation
Use interface route-aggregation to create a Layer 3 aggregate interface or subinterface and enter Layer 3 aggregate interface or subinterface view.
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 interface or subinterface is created.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
interface-number: Specifies a Layer 3 aggregate interface number in the range of 1 to 16384.
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 in the range of 1 to 4094 and is separated from the main interface number by a dot (.).
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.
You cannot create Layer 3 Ethernet interfaces or subinterfaces, or Layer 3 aggregate interfaces or subinterfaces in the following cases:
· The system is operating in standard mode. For more information about switch's operating modes, see Fundamentals Configuration Guide.
· The switch is operating in IRF mode and the enhanced IRF mode is enabled. For more information about IRF and the enhanced IRF mode, see Virtual Technologies Configuration Guide.
Deleting the 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 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 a network device to a server when the device and the server are two ends of a dynamic aggregate link. This feature enables the aggregation member ports on the device to forward packets from the server (the peer system) during the server reboot process.
This command takes effect only on an aggregate interface corresponding to a dynamic aggregation group.
Examples
# Configure Layer 2 aggregate interface Bridge-aggregation 1 as an edge aggregate interface.
<Sysname> System-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1] lacp edge-port
lacp mode
Use lacp mode passive to set 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 is operating in active mode on a port.
Views
Layer 2 Ethernet interface view, Layer 3 Ethernet interface view
Predefined user roles
network-admin
mdc-admin
Usage guidelines
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 the port on either end of a link, both ports can send LACPDUs.
This command takes effect only on a member port of a dynamic aggregation group.
Examples
# Set LACP to operate in passive mode on GigabitEthernet 3/0/1.
[Sysname] interface GigabitEthernet 3/0/1
[Sysname-GigabitEthernet3/0/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).
Views
Layer 2 Ethernet interface view, Layer 3 Ethernet interface view
Predefined user roles
network-admin
mdc-admin
Usage guidelines
To avoid traffic interruption during an ISSU, do not set the short LACP timeout interval before performing the ISSU. For more information about ISSU, see Fundamentals Configuration Guide.
Examples
# Set the short LACP timeout interval (3 seconds) on GigabitEthernet 3/0/1.
<Sysname> system-view
[Sysname] interface GigabitEthernet 3/0/1
[Sysname-GigabitEthernet3/0/1] lacp period short
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 system-priority
undo lacp system-priority
Default
The system LACP priority is 32768.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
system-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 global load-sharing mode
Use link-aggregation global load-sharing mode to configure the global link-aggregation load sharing mode.
Use undo link-aggregation global load-sharing mode to restore the default.
Syntax
link-aggregation global load-sharing mode { { destination-ip | destination-mac | destination-port | ingress-port | mpls-label1 | mpls-label2 | mpls-label3 | source-ip | source-mac | source-port } * | per-packet }
undo link-aggregation global load-sharing mode
Default
The switch performs load sharing based on all load sharing modes except ingress-port and per-packet load sharing.
Views
System view
Predefined user roles
network-admin
mdc-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.
ingress-port: Load shares traffic based on ingress ports.
mpls-label1: Load shares MPLS traffic based on Layer 1 labels.
mpls-label2: Load shares MPLS traffic based on Layer 2 labels.
mpls-label3: Load shares MPLS traffic based on Layer 3 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 by packet.
Usage guidelines
The load sharing mode that you configure overwrite the previous mode.
Ingress-port load sharing cannot cooperate with any other modes.
Per-packet load sharing is not configurable in IRF mode. Because per-packet load sharing might disorder the packets, H3C recommends not configuring per-packet load sharing when the internal interface on the OAP card belongs to an aggregation group. For more information about the OAP card, see OAA Configuration Guide.
All load sharing modes (except mpls-label1, mpls-label2, mpls-label3, and per-packet) take effect on ECMP load sharing of unicast traffic. If per-packet load sharing is configured, ECMP load sharing is performed according to the default load sharing modes supported by the switch. For more information about ECMP, see Layer 3—IP Routing Configuration Guide.
Examples
# Configure the global load sharing mode to load share packets based on destination MAC addresses.
<Sysname> system-view
[Sysname] link-aggregation global load-sharing mode destination-mac
link-aggregation 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 restore the default.
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
mdc-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 ID for vlan-id2 must be equal to or greater than the ID for vlan-id1.
Usage guidelines
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 irf-enhanced
Use link-aggregation irf-enhanced to enable link aggregation enhancement in IRF mode.
Use undo link-aggregation irf-enhanced to restore the default.
Syntax
link-aggregation irf-enhanced
undo link-aggregation irf-enhanced
Default
Link aggregation enhancement is disabled in IRF mode.
Views
System view
Predefined user roles
network-admin
mdc-admin
Usage guidelines
This command can be configured only on devices in IRF mode.
The maximum number of aggregated links in an aggregation group is subject to either of the following values, whichever is smaller:
· Maximum number configured by using the link-aggregation selected-port maximum command.
· The hardware limitation.
The hardware limitation varies depending on the following situations:
· If this command is not configured, the value is the maximum number supported by one IRF member device.
· If this command is configured, the value is the maximum number supported by one member device multiplied by the number of member devices.
If one end is configured with this command, make sure the other end is also configured with this command. Otherwise, link aggregation might not operate if the local end has more eligible Selected ports than the maximum number allowed. When both ends are configured with this feature, the smaller maximum number of Selected ports allowed applies.
Do not use this command when you configure backup between two ports in an aggregation group. Otherwise, backup between two ports does not take effect. Backup between two ports is implemented when you assign two ports to an aggregation group and configure the maximum number of Selected ports allowed in the aggregation group as one.
Examples
# Enhance the Selected port capacity for link aggregation in IRF mode.
<Sysname> system-view
[Sysname] link-aggregation irf-enhanced
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
mdc-admin
Examples
# Configure the aggregation group that corresponds to Bridge-Aggregation 1 to operate in dynamic aggregation mode.
<Sysname> system-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1] link-aggregation mode dynamic
link-aggregation port-priority
Use link-aggregation port-priority to set the port priority of an interface.
Use undo link-aggregation port-priority to restore the default.
Syntax
link-aggregation port-priority port-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
mdc-admin
Parameters
port-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 GigabitEthernet 3/0/1.
<Sysname> system-view
[Sysname] interface GigabitEthernet 3/0/1
[Sysname-GigabitEthernet3/0/1] link-aggregation port-priority 64
# Set the port priority to 64 for Layer 3 Ethernet interface GigabitEthernet 3/0/2.
<Sysname> system-view
[Sysname] interface GigabitEthernet 3/0/2
[Sysname-GigabitEthernet3/0/2] link-aggregation port-priority 64
Related commands
lacp system-priority
link-aggregation selected-port maximum
Use link-aggregation selected-port maximum to set the maximum number of Selected ports allowed in an aggregation group.
Use undo link-aggregation selected-port maximum to restore the default.
Syntax
link-aggregation selected-port maximum number
undo link-aggregation selected-port maximum
Default
The maximum number of Selected ports allowed in an aggregation group depends on hardware capabilities.
Views
Layer 2 aggregate interface view, Layer 3 aggregate interface view
Predefined user roles
network-admin
mdc-admin
Parameters
number: Specifies the maximum number of Selected ports allowed in an aggregation group, in the range of 1 to 48.
Usage guidelines
Executing this command might cause some of the Selected ports in an aggregation group to become unselected.
The maximum number of Selected ports allowed in the aggregation groups of the local and peer ends must be consistent.
The maximum number of Selected ports allowed in an aggregation group is limited by one of the following values, whichever is smaller:
· Maximum number configured by using the link-aggregation selected-port maximum command.
· Hardware limitation.
You can configure backup between two ports by performing the following tasks:
· Assigning two ports to an aggregation group.
· Setting the maximum number of Selected ports to 1 for the aggregation group.
Then, only one Selected port is allowed in the aggregation group at any point in time, while the Unselected port acts as a backup port.
Examples
# Set the maximum number of Selected ports to 5 for Layer 2 aggregation group 1.
<Sysname> system-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1] link-aggregation selected-port maximum 5
Related commands
· link-aggregation irf-enhanced
· 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 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
mdc-admin
Parameters
number: Specifies the minimum number of Selected ports in an aggregation group required to bring up the aggregate interface, in the range of 1 to 48.
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 of the local and peer ends must be consistent.
Examples
# Set the minimum number of Selected ports to 3 for Layer 2 aggregation group 1.
<Sysname> system-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1] link-aggregation selected-port minimum 3
Related commands
link-aggregation selected-port maximum
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
undo mtu
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
mdc-admin
Parameters
size: Specifies the MTU in bytes, in the range of 64 to 9198.
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
display interface
port link-aggregation group
Use port link-aggregation group to assign an Ethernet interface to an aggregation group.
Use undo port link-aggregation group to remove an Ethernet interface from the aggregation group to which it belongs.
Syntax
port link-aggregation group number
undo port link-aggregation group
Default
An Ethernet interface does not belong to any aggregation groups.
Views
Layer 2 Ethernet interface view, Layer 3 Ethernet interface view
Predefined user roles
network-admin
mdc-admin
Parameters
number: Specifies the number of the aggregate interface that corresponds to an aggregation group, in the range of 1 to 16384.
Usage guidelines
A Layer 2 Ethernet interface can be assigned to a Layer 2 aggregation group only. A Layer 3 Ethernet interface can be assigned to a Layer 3 aggregation group only.
An Ethernet interface can belong to only one aggregation group.
Examples
# Assign Layer 2 Ethernet interface GigabitEthernet 3/0/1 to Layer 2 aggregation group 1.
<Sysname> system-view
[Sysname] interface GigabitEthernet 3/0/1
[Sysname-GigabitEthernet3/0/1] port link-aggregation group 1
# Assign Layer 3 Ethernet interface GigabitEthernet 3/0/2 to Layer 3 aggregation group 2.
<Sysname> system-view
[Sysname] interface GigabitEthernet 3/0/2
[Sysname-GigabitEthernet3/0/2] port link-mode route
[Sysname-GigabitEthernet3/0/2] port link-aggregation group 2
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
mdc-admin
Parameters
bridge-aggregation: Clears statistics for Layer 2 aggregate interfaces.
route-aggregation: Clears statistics for 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 any options, the command clears statistics for all interfaces in the system.
If you specify only the bridge-aggregation or route-aggregation keyword, the command clears statistics for all Layer 2 or Layer 3 aggregate interfaces.
If you specify the bridge-aggregation interface-number or route-aggregation interface-number option, the command clears statistics for the specified Layer 2 or Layer 3 aggregate interface.
The bridge-aggregation or route-aggregation keyword is available only when Layer 2 or Layer 3 aggregate interfaces exist on the switch.
Examples
# Clear statistics for Layer 2 aggregate interface Bridge-Aggregation 1.
<Sysname> reset counters interface bridge-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
mdc-admin
Parameters
interface interface-list: Specifies a list of link aggregation member ports, in the format interface-type interface-number [ to interface-type interface-number ]. interface-type interface-number specifies an interface by its type and number. If no member ports are specified, the command clears LACP statistics for all member ports.
Examples
# Clear LACP statistics on all link aggregation member ports.
<Sysname> reset lacp statistics
display link-aggregation member-port
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
Layer 2 and Layer 3 aggregate interfaces are down, and Layer 3 aggregate subinterfaces are up.
Views
Layer 2 aggregate interface view, Layer 3 aggregate interface view, Layer 3 aggregate subinterface view
Predefined user roles
network-admin
mdc-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 Layer 2 aggregate interface Bridge-Aggregation 1.
<Sysname> system-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1] undo shutdown