Ethernet link aggregation configuration commands 1

default 1

description· 2

display interface· 2

display lacp system-id· 6

display link-aggregation load-sharing mode· 7

display link-aggregation member-port 8

display link-aggregation summary· 10

display link-aggregation verbose· 12

enable snmp trap updown· 14

interface bridge-aggregation· 15

interface route-aggregation· 15

lacp period short 16

lacp system-priority· 17

link-aggregation load-sharing mode· 17

link-aggregation mode· 18

link-aggregation port-priority· 19

link-aggregation selected-port minimum·· 20

mtu· 20

port link-aggregation group· 21

reset counters interface· 21

reset lacp statistics 22

shutdown· 23

 

 

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