- Table of Contents
-
- 03-Layer 2 - LAN Switching Command Reference
- 00-Preface
- 01-VLAN Commands
- 02-MAC Address Table Commands
- 03-Spanning Tree Commands
- 04-Ethernet Link Aggregation Commands
- 05-Port Isolation Commands
- 06-QinQ Commands
- 07-BPDU Tunneling Commands
- 08-GVRP Commands
- 09-VLAN Termination Commands
- 10-LLDP Commands
Title | Size | Download |
---|---|---|
04-Ethernet Link Aggregation Commands | 155.31 KB |
Contents
Ethernet link aggregation configuration commands
display link-aggregation load-sharing mode
display link-aggregation member-port
display link-aggregation summary
display link-aggregation verbose
link-aggregation load-sharing mode
link-aggregation port-priority
link-aggregation selected-port minimum
|
NOTE: In this documentation, SPC cards refer to the cards prefixed with SPC, for example, SPC-GT48L. SPE cards refer to the cards prefixed with SPE, for example, SPE-1020-E-II. |
default
Syntax
default
View
Layer 2 aggregate interface view, Layer 3 aggregate interface view, Layer 3 aggregate subinterface view
Default level
2: System level
Parameters
None
Description
Use the default command to restore the default settings for an aggregate interface or subinterface.
This command might fail to restore the default settings for some commands for reasons such as command dependencies and system restrictions. You can use the display this command in interface view to check for these commands, and perform their undo forms or follow the command reference to individually restore their default settings. If your restoration attempt still fails, follow the error message to resolve the problem.
|
CAUTION: The default command might interrupt ongoing network services. Make sure you are fully aware of the impacts of this command when you perform it on a live network. |
Examples
# Restore the default settings for Layer 2 aggregate interface Bridge-Aggregation 1.
<Sysname> system-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1] default
This command will restore the default settings. Continue? [Y/N]:y
description
Syntax
description text
undo description
View
Layer 2 aggregate interface view, Layer 3 aggregate interface view, Layer 3 aggregate subinterface view
Default level
2: System level
Parameters
text: Description of the interface, a string of 1 to 80 characters.
Description
Use the description command to set the description of the interface.
Use the undo description command to restore the default.
By default, the description of an interface is interface-name Interface. For example, the description of interface Bridge-Aggregation 1 is Bridge-Aggregation1 Interface.
Examples
# Set the description of interface Bridge-Aggregation 1 to link-aggregation interface.
<Sysname> system-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1] description link-aggregation interface
display interface
Syntax
display interface [ bridge-aggregation | route-aggregation ] [ brief [ down ] ] [ | { begin | exclude | include } regular-expression ]
display interface { bridge-aggregation | route-aggregation } interface-number [ brief ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
bridge-aggregation: Displays information about Layer 2 aggregate interfaces.
route-aggregation: Displays information about 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, this command displays detailed interface information.
down: Displays information about interfaces in the DOWN state and the causes. If you do not specify this keyword, this command displays information about interfaces in all states.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use the display interface command to display aggregate interface information.
· If bridge-aggregation | route-aggregation is not specified, this command displays information about all interfaces.
· If bridge-aggregation or route-aggregation is specified without any interface number specified, this command displays information about all aggregate interfaces.
· If bridge-aggregation interface-number or route-aggregation interface-number is specified, this command displays information about the specified aggregate interface.
Examples
# Display information about Layer 2 aggregate interface Bridge-Aggregation 1.
<Sysname> display interface bridge-aggregation 1
Bridge-Aggregation1 current state: DOWN
IP Packet Frame Type: PKTFMT_ETHNT_2, Hardware Address: 000f-e207-f2e0
Description: Bridge-Aggregation1 Interface
Unknown-speed mode, unknown-duplex mode
Link speed type is autonegotiation, link duplex type is autonegotiation
PVID: 1
Port link-type: access
Tagged VLAN ID : none
Untagged VLAN ID : 1
Last clearing of counters: Never
Last 300 seconds input: 0 packets/sec 0 bytes/sec -%
Last 300 seconds output: 0 packets/sec 0 bytes/sec -%
Input (total): 0 packets, 0 bytes
0 unicasts, 0 broadcasts, 0 multicasts
Input (normal): 0 packets, 0 bytes
0 unicasts, 0 broadcasts, 0 multicasts
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 broadcasts, 0 multicasts, 0 pauses
Output (normal): 0 packets, 0 bytes
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 information about Layer 3 aggregate interface Route-Aggregation 1.
<Sysname> display interface route-aggregation 1
Route-Aggregation1 current state: DOWN
Line protocol current state: DOWN
Description: Route-Aggregation1 Interface
The Maximum Transmit Unit is 1500
Internet protocol processing : disabled
IP Packet Frame Type: PKTFMT_ETHNT_2, Hardware Address: 000f-e20a-0001
IPv6 Packet Frame Type: PKTFMT_ETHNT_2, Hardware Address: 000f-e20a-0001
Output queue : (Urgent queuing : Size/Length/Discards) 0/100/0
Output queue : (Protocol queuing : Size/Length/Discards) 0/500/0
Output queue : (FIFO queuing : Size/Length/Discards) 0/75/0
Last clearing of counters: Never
Unknown-speed mode, unknown-duplex mode
Link speed type is autonegotiation, link duplex type is autonegotiation
Last 300 seconds input: 0 packets/sec 0 bytes/sec -%
Last 300 seconds output: 0 packets/sec 0 bytes/sec -%
Input (total): 0 packets, 0 bytes
0 broadcasts, 0 multicasts, 0 pauses
Input (normal): 0 packets, 0 bytes
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 broadcasts, 0 multicasts, 0 pauses
Output (normal): 0 packets, 0 bytes
0 broadcasts, 0 multicasts, 0 pauses
Output: 0 output errors, 0 underruns, 0 buffer failures
0 aborts, 0 deferred, 0 collisions, 0 late collisions
0 lost carrier, 0 no carrier
# Display brief information about Layer 2 aggregate interface Bridge-Aggregation 1.
<Sysname> display interface bridge-aggregation 1 brief
The brief information of 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 DOWN auto A A 1
# Display brief information about Layer 3 aggregate interface Route-Aggregation 1.
<Sysname> display interface route-aggregation 1 brief
The brief information of interface(s) under route mode:
Link: ADM - administratively down; Stby - standby
Protocol: (s) - spoofing
Interface Link Protocol Main IP Description
RAGG1 DOWN DOWN --
# Display information about all Layer 2 aggregate interfaces in DOWN state.
<Sysname> display interface bridge-aggregation brief down
The brief information of interface(s) under bridge mode:
Link: ADM - administratively down; Stby - standby
Interface Link Cause
BAGG1 DOWN Not connected
# Display information about all Layer 3 aggregate interfaces in DOWN state.
<Sysname> display interface route-aggregation brief down
The brief information of interface(s) under route mode:
Link: ADM - administratively down; Stby - standby
Interface Link Cause
RAGG1 DOWN Not connected
Table 1 Output description
Field |
Description |
Bridge-Aggregation1/Route-Aggregation1 current state |
The Layer 2/Layer 3 interface status, which can be: · DOWN ( Administratively )—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 is faulty). · UP—The Ethernet interface is both administratively and physically up. |
Unknown-speed mode, unknown-duplex mode |
The interface speed and duplex mode are unknown. |
PVID |
The default VLAN ID. |
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 router’s startup. |
Last 300 seconds input/output |
The average input/output rate over the last 300 seconds. |
Input/Output (total) |
The statistics of all packets received/sent on the interface. |
Input/Output (normal) |
The statistics of all normal packets received/sent on the interface. |
Line protocol current 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. |
Output queue : (Urgent queuing : Size/Length/Discards) |
Output queue (current message number in the urgent queue/ maximum number of messages allowed in the urgent queue/number of discarded messages). |
Output queue : (Protocol queuing : Size/Length/Discards) |
Output queue (current message number in the protocol queue/ maximum number of messages allowed in the protocol queue/number of discarded messages). |
Output queue : (FIFO queuing : Size/Length/Discards) |
Output queue (current message number in the FIFO queue/ maximum number of messages allowed in the FIFO queue/number of discarded messages). |
The brief information of interface(s) under route mode |
Brief information about Layer 3 interfaces. |
The brief information of 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, perform 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, letter a in parentheses. If the duplex mode of an interface is automatically negotiated, its duplex mode attribute includes the auto negotiation flag, letter a in parentheses or a capital A. Letter H indicates the half duplex mode, and 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 network 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 (an s in parentheses). |
Interface |
The abbreviated interface name. |
Link |
The physical link state of the interface. |
Speed |
The interface speed, in bps. |
Cause |
The cause of a DOWN physical link. |
display lacp system-id
Syntax
display lacp system-id [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use the display lacp system-id command to display the system ID of the local system.
The system ID comprises the system LACP priority and the system MAC address.
You can use the lacp system-priority command to change the LACP priority of the local system. When you do that, the LACP priority value you specify in the command is in decimal format. However, it is displayed as a hexadecimal value with the display lacp system-id command.
Related commands: lacp system-priority.
Examples
# Display the local system ID.
<Sysname> display lacp system-id
Actor System ID: 0x8000, 00e0-fc00-0100
Table 2 Output description
Field |
Description |
Actor System ID: 0x8000, 00e0-fc00-0100 |
The local system ID, which comprises the system LACP priority (0x8000) and the system MAC address (00e0-fc00-0100). |
display link-aggregation load-sharing mode
Syntax
display link-aggregation load-sharing mode [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use the display link-aggregation load-sharing mode command to display global link-aggregation load sharing criterion or criteria.
Examples
# Display the default global link-aggregation load sharing criteria.
<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 criteria.
<Sysname> display link-aggregation load-sharing mode
Link-Aggregation Load-Sharing Mode:
destination-mac address, source-mac address
Table 3 Output description
Field |
Description |
Link-Aggregation Load-Sharing Mode |
The global link-aggregation load sharing criteria. · By default, the link-aggregation load sharing criteria for Layer 2 traffic, Layer 3 traffic, Layer 4 traffic, and MPLS traffic are displayed. · If you have configured the global link-aggregation load sharing criteria, the configured ones are displayed. |
Layer 2 traffic |
The default link-aggregation load sharing criteria for Layer 2 traffic. |
Layer 3 traffic |
The default link-aggregation load sharing criteria for Layer 3 traffic. |
Layer 4 traffic |
The default link-aggregation load sharing criteria for Layer 4 traffic. |
MPLS traffic |
The default link-aggregation load sharing criteria for MPLS traffic. |
display link-aggregation member-port
Syntax
display link-aggregation member-port [ interface-list ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
interface-list: Specifies a list of link aggregation member ports, in the format interface-type interface-number [ to interface-type interface-number ], where interface-type interface-number indicates the port type and port number.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use the display link-aggregation member-port command to display the detailed link aggregation information of the specified member ports or all member ports if no member ports are specified.
For a member port in a static aggregation group, only the port number and operational key are displayed, because the aggregation group is unaware of information about the peer groups.
Examples
# Display detailed link aggregation information for GigabitEthernet 2/1/1, a member port in a static aggregation group.
<Sysname> display link-aggregation member-port GigabitEthernet 2/1/1
Flags: A -- LACP_Activity, B -- LACP_Timeout, C -- Aggregation,
D -- Synchronization, E -- Collecting, F -- Distributing,
G -- Defaulted, H -- Expired
GigabitEthernet2/1/1:
Aggregation Interface: Bridge-Aggregation1
Port Number: 1
Port Priority: 32768
Oper-Key: 1
# Display the detailed link aggregation information of GigabitEthernet 2/1/2, which is in a dynamic aggregation group.
<Sysname> display link-aggregation member-port GigabitEthernet 2/1/2
Flags: A -- LACP_Activity, B -- LACP_Timeout, C -- Aggregation,
D -- Synchronization, E -- Collecting, F -- Distributing,
G -- Defaulted, H -- Expired
GigabitEthernet2/1/2:
Aggregation 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 Output description
Field |
Description |
Flags |
LACP state flags: · A—LACP is enabled. · B—Indicates the LACP short timeout. · C—The sending system detects that the link is aggregatable. · D—The sending system detects that the link is synchronized. · E—The sending system detects that the incoming frames are collected. · F—The sending system detects that the outgoing frames are distributed. · G—The sending system receives frames in the default state. · H—The sending system receives frames in the expired state. |
Aggregation Interface |
Aggregate interface to which the port belongs |
Local Port Number Port Priority Oper-key Flag |
Information about the local end: · Port Number—Number of the port. · Port Priority—Aggregation priority of the port. · Oper-key—Operational key. · Flag—LACP protocol state flag. |
Remote System ID Port Number Port Priority Oper-key Flag |
Information about the remote end: · System ID—System ID of the remote end (comprising the system LACP priority and the system MAC address). · Port Number—Number of the port. · Port Priority—Aggregation priority of the port. · Oper-key—Operational key. · Flag—LACP protocol state flag. |
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
Syntax
display link-aggregation summary [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use the display link-aggregation summary command to display the summary information of all aggregation groups.
Information about the remote system for a static link aggregation group may be either displayed as none or not displayed, because the aggregation group is unaware of information about the peer groups.
Examples
# Display the summary information of all aggregation groups.
<Sysname> display link-aggregation summary
Aggregation 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, 00fe-2722-2000
AGG AGG Partner ID Select Unselect Share
Interface Mode Ports Ports Type
-------------------------------------------------------------------------
BAGG1 S none 1 0 Shar
BAGG10 D 0x8000, 000f-e267-57ad 2 0 Shar
Table 5 Output description
Field |
Description |
Aggregation Interface Type |
Aggregate interface type: · BAGG—Layer 2 aggregate interface. · RAGG—Layer 3 aggregate interface. |
Aggregation Mode |
Aggregation group type: · S—Static link aggregation. · D—Dynamic aggregation. |
Loadsharing Type |
Loadsharing type: · Shar—load sharing. · NonS—Non-load sharing. |
Actor System ID |
Local system ID, comprising 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, comprising the system LACP priority and the system MAC address. |
Select Ports |
Total number of Selected ports. |
Unselect Ports |
Total number of Unselected ports. |
Share Type |
Load sharing type. |
display link-aggregation verbose
Syntax
display link-aggregation verbose [ { bridge-aggregation | route-aggregation } [ interface-number ] ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
bridge-aggregation: Displays detailed information about the Layer 2 aggregation groups corresponding to Layer 2 aggregate interfaces.
route-aggregation: Displays detailed information about the Layer 3 aggregation groups corresponding to Layer 3 aggregate interfaces.
interface-number: Aggregate interface number. The value range for this argument is 1 to 1024. The router supports up to 240 aggregation groups.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Description
Use the display link-aggregation verbose command to display detailed information about the aggregation groups corresponding to the aggregate interfaces.
To display the information of a specific Layer 2 or Layer 3 aggregation group, use the display link-aggregation verbose bridge-aggregation interface-number or display link-aggregation verbose bridge-aggregation interface-number command.
To display the information of all Layer 2 or Layer 3 aggregation groups, use the display link-aggregation verbose bridge-aggregation or display link-aggregation verbose route-aggregation command.
To display the information of all aggregation groups, use the display link-aggregation verbose command.
The bridge-aggregation or route-aggregation keyword is available only after you create Layer 2 or Layer 3 aggregate interfaces on the device.
Examples
# Display detailed information about the aggregation group corresponding to Layer 2 aggregate interface Bridge-Aggregation 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
Flags: A -- LACP_Activity, B -- LACP_Timeout, C -- Aggregation,
D -- Synchronization, E -- Collecting, F -- Distributing,
G -- Defaulted, H -- Expired
Aggregation Interface: Bridge-Aggregation10
Aggregation Mode: Dynamic
Loadsharing Type: NonS
System ID: 0x8000, 000f-e201-2496
Local:
Port Status Priority Oper-Key Flag
-------------------------------------------------------------------------
GE2/1/1 U 32768 2 {ACG}
Remote:
Actor Partner Priority Oper-Key SystemID Flag
-------------------------------------------------------------------------
GE2/1/1 0 32768 0 0x8000, 0000-0000-0000 {EF}
# Display detailed information about the aggregation group corresponding to Layer 2 aggregate interface Bridge-Aggregation 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
Flags: A -- LACP_Activity, B -- LACP_Timeout, C -- Aggregation,
D -- Synchronization, E -- Collecting, F -- Distributing,
G -- Defaulted, H -- Expired
Aggregation Interface: Bridge-Aggregation20
Aggregation Mode: Static
Loadsharing Type: NonS
Port Status Priority Oper-Key
--------------------------------------------------------------------------------
GE2/1/21 U 32768 1
GE2/1/22 U 32768 1
GE2/1/23 U 63 1
Table 6 Output description
Field |
Description |
Loadsharing Type |
Load-sharing type: · Shar—Load sharing. · NonS—Non-load sharing. |
Port Status |
Port state: Selected or unselected. |
Flags |
LACP state flags: · A—LACP is enabled. · B—Indicates the LACP short timeout. · C—The sending system detects that the link is aggregatable. · D—The sending system detects that the link is synchronized. · E—The sending system detects that the incoming frames are collected. · F—The sending system detects that the outgoing frames are distributed. · G—The sending system receives frames in the default state. · H—The sending system receives frames in the expired state. |
Aggregation Interface |
Name of the aggregate interface. |
Aggregation Mode |
Type of the aggregation group: · Static—Static aggregation. · Dynamic—Dynamic aggregation. |
System ID |
Local system ID, comprising the system LACP priority and the system MAC address. |
Local: Port Status Priority Oper-Key Flag |
Other information of the local end, including the member ports, port state, port aggregation priority, operational key, and LACP protocol state flags. |
Remote: Actor Partner Priority Oper-Key SystemID Flag |
Detailed information about the remote end, including the corresponding local port, port ID, port aggregation priority, operational key, system ID, and LACP protocol state flags. |
enable snmp trap updown
Syntax
enable snmp trap updown
undo enable snmp trap updown
View
Layer 2 aggregate interface view, Layer 3 aggregate interface view, Layer 3 aggregate subinterface view
Default level
2: System level
Parameters
None
Description
Use the enable snmp trap updown command to enable link state trapping for the aggregate interface.
Use the undo enable snmp trap updown command to disable link state trapping for the aggregate interface.
By default, link state trapping is enabled for an aggregate interface.
For an aggregate interface to generate linkUp/linkDown traps when its link state changes, you must enable link state trapping globally with the snmp-agent trap enable [ standard [ linkdown | linkup ] * ] command.
Related commands: snmp-agent trap enable (Network Management and Monitoring Command Reference).
Examples
# Enable linkUp/linkDown trap generation on interface Bridge-Aggregation 1.
<Sysname> system-view
[Sysname] snmp-agent trap enable
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1] enable snmp trap updown
interface bridge-aggregation
Syntax
interface bridge-aggregation interface-number
undo interface bridge-aggregation interface-number
View
System view
Default level
2: System level
Parameters
interface-number: Layer 2 aggregate interface number, in the range 1 to 1024. The router supports up to 240 aggregation groups.
Description
Use the interface bridge-aggregation command to create a Layer 2 aggregate interface and enter the Layer 2 aggregate interface view.
Use the undo interface bridge-aggregation command to remove a Layer 2 aggregate interface.
When a Layer 2 aggregate interface is created, a Layer 2 aggregation group with the same number is automatically created. If you remove the Layer 2 aggregate interface, you also remove the Layer 2 aggregation group, and any member ports will 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
Syntax
interface route-aggregation { interface-number | interface-number.subnumber }
undo interface route-aggregation { interface-number | interface-number.subnumber }
View
System view
Default level
2: System level
Parameters
interface-number: Layer 3 aggregate interface number, in the range 1 to 1024. The router supports up to 240 aggregation groups.
interface-number.subnumber: Subinterface of a Layer 3 aggregate interface. The interface-number argument specifies the main interface number. The subnumber argument specifies the subinterface number and is separated from the main interface number by a dot (.). The value range for the subnumber argument is 1 to 4094.
Description
Use the interface route-aggregation command to create a Layer 3 aggregate interface/subinterface and enter the Layer 3 aggregate interface/subinterface view.
Use the undo interface route-aggregation command to remove a Layer 3 aggregate interface/subinterface.
Upon creation of a Layer 3 aggregate interface, a Layer 3 aggregation group numbered the same is created automatically. Removing the Layer 3 aggregate interface also removes the Layer 3 aggregation group. At the same time, the member ports of the aggregation group, if any, leave the aggregation group.
Removing 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.
<Sysname> system-view
[Sysname] interface route-aggregation 1
[Sysname-Route-Aggregation1]
lacp period short
Syntax
lacp period short
undo lacp period
View
Ethernet interface view
Default level
2: System level
Parameters
None
Description
Use the lacp period short command to set the LACP timeout interval on a port to the short timeout interval (1 second).
Use the undo lacp period command to restore the default setting.
The default LACP timeout interval is the long timeout interval (30 seconds).
Examples
# Set the LACP timeout interval on GigabitEthernet 2/1/1 to the short timeout interval (1 second).
<Sysname> system-view
[Sysname] interface gigabitethernet 2/1/1
[Sysname-GigabitEthernet2/1/1] lacp period short
lacp system-priority
Syntax
lacp system-priority system-priority
undo lacp system-priority
View
System view
Default level
2: System level
Parameters
system-priority: LACP priority of the local system, in the range of 0 to 65535. The smaller the value, the higher the system LACP priority.
Description
Use the lacp system-priority command to set the LACP priority of the local system.
Use the undo lacp system-priority command to restore the default.
By default, the system LACP priority is 32768.
A system ID comprises the system LACP priority and the system MAC address. The local system (the actor) negotiates with the remote system (the partner) to determine port state based on the port IDs on the end with the preferred system ID, that is, the smaller system ID.
Examples
# Set the system LACP priority to 64.
<Sysname> system-view
[Sysname] lacp system-priority 64
link-aggregation load-sharing mode
Syntax
link-aggregation load-sharing mode { destination-ip | destination-mac | destination-port | ingress-port | mpls-label1 | mpls-label2 | mpls-label3 | source-ip | source-mac | source-port }*
undo link-aggregation load-sharing mode
View
System view
Default level
2: System level
Parameters
destination-ip: Performs load sharing in link aggregation groups based on destination IP address.
destination-mac: Performs load sharing in link aggregation groups based on destination MAC address.
destination-port: Performs load sharing in link aggregation groups based on destination port.
ingress-port: Performs load sharing in link aggregation groups based on ingress port.
mpls-label1: Performs load sharing for MPLS traffic based on Layer 1 label.
mpls-label2: Performs load sharing for MPLS traffic based on Layer 2 label.
mpls-label3: Performs load sharing for MPLS traffic based on Layer 3 label.
source-ip: Performs load sharing in link aggregation groups based on source IP address.
source-mac: Performs load sharing in link aggregation groups based on source MAC address.
source-port: Performs load sharing in link aggregation groups based on source port.
Description
Use the link-aggregation load-sharing mode command to configure the global or group-specific link-aggregation load sharing criteria.
Use the undo link-aggregation load-sharing mode command to restore the default.
By default, the group-specific link-aggregation load sharing criteria are consistent with the global link-aggregation load sharing criteria.
The load sharing criteria you configured overwrite the old ones, if any.
You cannot use the ingress-port keyword together with any other keyword of this command.
|
NOTE: Only SPC cards support the configuration of link-aggregation load sharing criteria. Even though you can configure the link-aggregation load-sharing mode command on SPE cards, the command does not take effect. |
Examples
# Configure the destination MAC address as the global link-aggregation load sharing criterion.
<Sysname> system-view
[Sysname] link-aggregation load-sharing mode destination-mac
link-aggregation mode
Syntax
link-aggregation mode dynamic
undo link-aggregation mode
View
Layer 2 aggregate interface view, Layer 3 aggregate interface view
Default level
2: System level
Parameters
None
Description
Use the link-aggregation mode dynamic command to configure an aggregation group to work in dynamic aggregation mode.
Use the undo link-aggregation mode command to restore the default.
By default, an aggregation group works in static aggregation mode.
To change the aggregation mode of an aggregation group that contains member ports, remove all the member ports from the aggregation group first.
Examples
# Configure the aggregation group corresponding to Bridge-Aggregation 1 to work in dynamic aggregation mode.
<Sysname> system-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1] link-aggregation mode dynamic
link-aggregation port-priority
Syntax
link-aggregation port-priority port-priority
undo link-aggregation port-priority
View
Ethernet interface view
Default level
2: System level
Parameters
port-priority: Port aggregation priority, in the range of 0 to 65535.
Description
Use the link-aggregation port-priority command to set the aggregation priority of a port.
Use the undo link-aggregation port-priority command to restore the default.
The default aggregation priority of a port is 32768.
A port ID comprises the port aggregation priority and the port number. The local system (the actor) negotiates with the remote system (the partner) to determine port state based on the port IDs (ports with smaller port IDs are preferentially selected) on the end with the preferred system ID.
Examples
# Set the port aggregation priority of GigabitEthernet 4/1/1 to 64.
<Sysname> system-view
[Sysname] interface GigabitEthernet 4/1/1
[Sysname-GigabitEthernet4/1/1] link-aggregation port-priority 64
link-aggregation selected-port minimum
Syntax
link-aggregation selected-port minimum number
undo link-aggregation selected-port minimum
View
Layer 2 aggregate interface view, Layer 3 aggregate interface view
Default level
2: System level
Parameters
number: Specifies the minimum number of Selected ports in the aggregation group required to bring up the aggregate interface. The value ranges from 1 to 8.
Description
Use the link-aggregation selected-port minimum command to configure the minimum number of Selected ports in the aggregation group.
Use the undo link-aggregation selected-port minimum command to restore the default setting.
By default, the minimum number of Selected ports in an aggregation group is not specified.
Executing this command may cause all the member ports in the aggregation group to become unselected.
Examples
# Configure the minimum number of Selected ports as 3 in the aggregation group corresponding to Layer 2 aggregate interface Bridge-Aggregation 1.
<Sysname> system-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1] link-aggregation selected-port minimum 3
mtu
Syntax
mtu size
undo mtu
View
Layer 3 aggregate interface view, Layer 3 aggregate subinterface view
Default level
2: System level
Parameters
size: Maximum transmission unit (MTU) in bytes.
Description
Use the mtu command to set the MTU of the Layer 3 aggregate interface/subinterface.
Use the undo mtu command to restore the default.
By default, the MTU for Layer 3 aggregate interfaces/subinterfaces is 1500 bytes.
Related commands: display interface.
Examples
# Set the MTU of Layer 3 aggregate interface Route-Aggregation 1 to 1430 bytes.
<Sysname> system-view
[Sysname] interface route-aggregation 1
[Sysname-Route-Aggregation1] mtu 1430
port link-aggregation group
Syntax
port link-aggregation group agg-id
undo port link-aggregation group
View
Ethernet interface view
Default level
2: System level
Parameters
agg-id: Specifies the number of the aggregate interface corresponding to an aggregation group. The value ranges from 1 to 1024. The router supports up to 240 aggregation groups.
Description
Use the port link-aggregation group command to assign the Ethernet interface to the specified aggregation group.
Use the undo port link-aggregation group command to remove the Ethernet interface from the aggregation group to which it belongs.
A Layer 2 Ethernet interface can be assigned to a Layer 2 aggregation group only, and 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 GigabitEthernet 4/1/1 to aggregation group 22.
<Sysname> system-view
[Sysname] interface GigabitEthernet 4/1/1
[Sysname-GigabitEthernet4/1/1] port link-aggregation group 22
reset counters interface
Syntax
reset counters interface [ { bridge-aggregation | route-aggregation } [ interface-number ] ]
View
User view
Default level
2: System level
Parameters
bridge-aggregation: Clears statistics for Layer 2 aggregate interfaces.
route-aggregation: Clears statistics for Layer 3 aggregate interfaces.
interface-number: Aggregate interface number, ranging from 1 to 1024.
Description
Use the reset counters interface command to clear the statistics of the specified aggregate interface or interfaces.
Before collecting statistics for an interface within a specific period, clear the existing statistics of the interface.
· If no keywords or argument is specified, the command clears the statistics of all interfaces in the system.
· If only the bridge-aggregation or route-aggregation keyword is specified, the command clears the statistics of all Layer 2 or Layer 3 aggregate interfaces.
· If the bridge-aggregation interface-number or route-aggregation interface-number option is specified, the command clears the statistics of the specified Layer 2 or Layer 3 aggregate interface.
· The bridge-aggregation or route-aggregation keyword becomes available only after you create Layer 2 or Layer 3 aggregate interfaces on the router.
Examples
# Clear the statistics of Layer 2 aggregate interface Bridge-Aggregation 1.
<Sysname> reset counters interface bridge-aggregation 1
reset lacp statistics
Syntax
reset lacp statistics [ interface interface-list ]
View
User view
Default level
1: Monitor level
Parameters
interface-list: Specifies a list of link aggregation member ports, in the format interface-type interface-number [ to interface-type interface-number ], where interface-type interface-number indicates the port type and port number.
Description
Use the reset lacp statistics command to clear the LACP statistics for the specified member ports or all member ports if no member ports are specified.
Related commands: display link-aggregation member-port.
Examples
# Clear the LACP statistics on all link aggregation member ports.
<Sysname> reset lacp statistics
shutdown
Syntax
shutdown
undo shutdown
View
Layer 2 aggregate interface view, Layer 3 aggregate interface view, Layer 3 aggregate subinterface view
Default level
2: System level
Parameters
None
Description
Use the shutdown command to shut down the aggregate interface/subinterface.
Use the undo shutdown command to bring up the aggregate interface/subinterface.
By default, aggregate interfaces/subinterfaces are up.
Shutting down or bringing up a Layer 3 aggregate interface also shuts down or brings up its subinterfaces. Shutting down or bringing up a Layer 3 aggregate subinterface does not affect its parent interface.
Examples
# Shut down Layer 2 aggregate interface Bridge-Aggregation 1.
<Sysname> system-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1] shutdown