When a device operating in IRF mode is enabled with enhanced IRF mode, it does not support creating Layer 3 Ethernet interfaces/subinterfaces or Layer 3 aggregate interfaces/subinterfaces.

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 default 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 identify these commands by using the display this command in interface view, and then use 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, which is a string of 1 to 80 characters.

Description

Use description to set the description of the interface.

Use undo description to restore the default.

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

Examples

# Set the description of Layer 2 aggregate 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 [ description ] ] [ | { 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.

description: Displays complete interface descriptions. If you do not specify this keyword, the command displays only the first 25 characters of each interface description.

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

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

…

# 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 the 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 the 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 Command output

Field	Description
Bridge-Aggregation1/Route-Aggregation1 current state	Layer 2 or Layer 3 interface status: · 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	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 switch’s startup.
Last 300 seconds input/output	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 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, execute 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	Abbreviated interface name.
Link	Physical link state of the interface.
Speed	Interface speed, in bps.
Cause	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.

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 display lacp system-id 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.

Although you specify the LACP priority value in decimal format in the lacp system-priority command, 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 Command output

Field	Description
Actor System ID	Local system ID, which comprises the system LACP priority (0x8000 in this sample output) and the system MAC address (00e0-fc00-0100 in this sample output).

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.

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 display link-aggregation load-sharing mode to display the load sharing criteria of load-sharing link aggregation groups.

Examples

# Display the default load sharing criteria when no load sharing criteria have been configured.

<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

# After you configure load sharing criteria, display the load sharing criteria configuration.

<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	Displays the load sharing criteria for load-sharing link aggregation groups. · By default, the link-aggregation load sharing criteria for Layer 2 traffic, Layer 3 traffic, Layer 4 traffic, and MPLS traffic are displayed. · Otherwise, the user-configured link-aggregation load sharing criteria are displayed.
Layer 2 traffic	Default link-aggregation load sharing criteria for Layer 2 traffic.
Layer 3 traffic	Default link-aggregation load sharing criteria for Layer 3 traffic.
Layer 4 traffic	Default link-aggregation load sharing criteria for Layer 4 traffic.
MPLS traffic	Default link-aggregation load sharing criteria for MPLS traffic.
destination-mac address, source-mac address	User-configured link-aggregation load sharing criteria.

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.

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 display link-aggregation member-port to display the detailed link aggregation information of the specified member ports or all member ports if no port is 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 the detailed link aggregation information of GigabitEthernet 4/0/1, a member port of a static aggregation group.

<Sysname> display link-aggregation member-port gigabitethernet 4/0/1

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

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

G -- Defaulted, H -- Expired

GigabitEthernet4/0/1:

Aggregation Interface: Bridge-Aggregation1

Port Number: 1

Port Priority: 32768

Oper-Key: 1

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.
Aggregation Interface	Aggregate interface to which the port belongs.
Port Priority	Aggregation priority of the port.
Oper-key	Operational key.

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.

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 display link-aggregation summary to display the summary information of all aggregation groups.

Information about the remote system for a static link aggregation group might be either shown 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, 00e0-fc00-9512

AGG AGG Partner ID Select Unselect Share

Interface Mode Ports Ports Type

-------------------------------------------------------------------------

BAGG2 S none 1 1 Shar

Table 5 Command output

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	Load-sharing type: · Shar—Load sharing. · NonS—Non-load sharing.
Actor System ID	Local system ID, which comprises 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 comprises the system LACP priority and the system MAC address.
Select Ports	Number of Selected ports.
Unselect Ports	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: Specifies an aggregate interface number in the range of 1 to 1024. You can configure up to 240 aggregation groups on the switch.

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

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 display link-aggregation verbose to display detailed information about the aggregation groups corresponding to the aggregate interfaces in the system.

If you do not specify an aggregate interface, this command displays detailed information about the aggregation groups corresponding to all aggregate interfaces.

If you specify only the aggregate interface type, this command displays detailed information about the aggregation groups corresponding to all aggregate interfaces of that type.

Examples

# Display the 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: Static

Loadsharing Type: Shar

Port Status Priority Oper-Key

-------------------------------------------------------------------------

GE3/0/1 S 32768 1

GE3/0/2 U 32768 2

Table 6 Command output

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. 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.
Aggregation Interface	Name of the aggregate interface.
Aggregation Mode	Type of the aggregation group: · Static for static aggregation. · Dynamic for dynamic aggregation.
Port	Port type and number.
Status	State of the port.
Oper-Key	Operational key value.

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 enable snmp trap updown to enable link state trapping for the aggregate interface.

Use undo enable snmp trap updown to disable link state trapping for the aggregate interface.

By default, linkUp/linkDown trap generation 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.

For more information about the snmp-agent trap enable command, see 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: Specifies a Layer 2 aggregate interface number in the range of 1 to 1024. You can configure up to 240 aggregation groups on the switch.

Description

Use interface bridge-aggregation to create a Layer 2 aggregate interface and enter the Layer 2 aggregate interface view.

Use undo interface bridge-aggregation 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: Specifies a Layer 3 aggregate interface number.

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 4094and is separated from the main interface number by a dot (.).

Description

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 remove a Layer 3 aggregate interface or 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.

The switch operating in a non-standard operating mode does not support Layer 3 aggregation interfaces. For more information about system operating modes, see Fundamentals Configuration Guide.

Examples

# Create Layer 3 aggregate interface Route-Aggregation 1 and enter its view.

<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 lacp period short to set the LACP timeout interval on a port to the short timeout interval (1 second).

Use undo lacp period 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 4/0/1 to the short timeout interval (1 second).

<Sysname> system-view

[Sysname] interface gigabitethernet 4/0/1

[Sysname-GigabitEthernet4/0/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 lacp system-priority to set the LACP priority of the local system.

Use undo lacp system-priority to restore the default.

By default, the system LACP priority is 32768.

Examples

# Set the system LACP priority to 64.

<Sysname> system-view

[Sysname] lacp system-priority 64

link-aggregation irf-enhanced

Syntax

link-aggregation irf-enhanced

undo link-aggregation irf-enhanced

View

System view

Default level

2: System level

Description

Use link-aggregation irf-enhanced to enable link aggregation enhancement in IRF mode.

Use undo link-aggregation irf-enhanced to restore the default.

By default, link aggregation enhancement is disabled in IRF mode.

If one end is configured with this command, make sure the other end is also configured with this command. Otherwise, link aggregation might not work.

When this command is configured, the maximum number of aggregated links (Selected ports) supported in hardware for an aggregation is identical to the maximum number of aggregated links supported per chassis multiplied by the number of member chassis.

Examples

# Enable link aggregation enhancement in IRF mode.

<Sysname> system-view

[Sysname] link-aggregation irf-enhanced

link-aggregation lacp traffic-redirect-notification enable

Syntax

link-aggregation lacp traffic-redirect-notification enable

undo link-aggregation lacp traffic-redirect-notification enable

View

System view

Default level

2: System level

Parameters

None

Description

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

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

By default, link-aggregation traffic redirection is disabled.

Link-aggregation traffic redirection applies only to dynamic link aggregation groups.

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

Do not enable both MSTP and link-aggregation traffic redirection at the same time, because light packet loss might occur when a card or the switch reboots.

Examples

# Enable link-aggregation traffic redirection.

<Sysname> system-view

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

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 } * | per-packet }

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.

per-packet: Performs per-packet load sharing in link aggregation groups.

Description

Use link-aggregation load-sharing mode to configure link-aggregation load sharing criteria.

Use undo link-aggregation load-sharing mode to restore the default.

By default, the switch performs load sharing based on all the criteria except ingress port and per-packet.

The load sharing criteria that you configure will overwrite the previous criteria. For example, to change the load sharing criteria from source port based to source and destination ports based, you must configure the link-aggregation load-sharing mode destination-port source-port command (not the link-aggregation load-sharing mode source-port command) to overwrite the link-aggregation load-sharing mode destination-port command.

Per-packet load sharing is not configurable when the system is operating in IRF mode. Because per-packet load sharing might disorder the packets, H3C recommends not specifying the per-packet keyword 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 the criteria except mpls-label1, mpls-label2, mpls-label3 and per-packet, if configured, apply to equal-cost multi-path (ECMP) load sharing for unicast traffic. If the per-packet keyword is specified, ECMP load sharing is performed according to the default load sharing criteria supported by the switch. For more information about ECMP routing, see Layer 3—IP Routing Configuration Guide.

The ingress-port keyword is mutually exclusive with any other keyword of this command.

Examples

# Configure destination MAC-based load sharing for link aggregation groups.

<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 link-aggregation mode dynamic to configure an aggregation group to operate in dynamic aggregation mode.

Use undo link-aggregation mode to restore the default.

By default, an aggregation group operates in static aggregation mode.

You cannot change the aggregation mode of an aggregation group that contains member ports.

Examples

# Configure the aggregation group corresponding 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

Syntax

link-aggregation port-priority port-priority

undo link-aggregation port-priority

View

Ethernet interface view

Default level

2: System level

Parameters

port-priority: Specifies a port aggregation priority in the range of 0 to 65535. The smaller the value, the higher the port aggregation priority.

Description

Use link-aggregation port-priority to set the aggregation priority of a port.

Use undo link-aggregation port-priority to restore the default.

The default aggregation priority of a port is 32768.

Examples

# Set the aggregation priority of GigabitEthernet 4/0/1 to 64.

<Sysname> system-view

[Sysname] interface gigabitethernet 4/0/1

[Sysname-GigabitEthernet4/0/1] link-aggregation port-priority 64

link-aggregation selected-port maximum

Syntax

link-aggregation selected-port maximum number

undo link-aggregation selected-port maximum

View

Layer 2 aggregate interface view, Layer 3 aggregate interface view

Default level

2: System level

Parameters

number: Specifies the maximum number of Selected ports allowed in an aggregation group. The value is in the range of 1 to 48.

Description

Use link-aggregation selected-port maximum to configure the maximum number of Selected ports allowed in the aggregation group.

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

By default, the maximum number of Selected ports allowed in an aggregation group is limited only by the hardware capabilities of the member ports.

Executing this command might cause some of the selected member ports in the aggregation group to become unselected.

If you configure both the maximum number of Selected ports allowed in the aggregation group and the minimum number of Selected ports in the aggregation group, make sure that the former is no smaller than the latter. For more information about the minimum number of Selected ports in the aggregation group, see link-aggregation selected-port minimum.

Examples

# Configure the maximum number of Selected ports allowed 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 maximum 3

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 is in the range of 1 to 48.

Description

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

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

By default, the minimum number of Selected ports in an aggregation group is not specified.

Executing this command might cause all the member ports in the aggregation group to become unselected.

Make sure that the minimum number of Selected ports in the aggregation group is the same both ends.

Examples

# Configure the minimum number of Selected ports in the aggregation group corresponding to Layer 2 aggregate interface Bridge-Aggregation 1 as 3.

<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: Sets the maximum transmission unit (MTU) in bytes.

Description

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

Use undo mtu to restore the default.

By default, the MTU for Layer 3 aggregate interfaces and subinterfaces is 1500 bytes.

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 number

undo port link-aggregation group

View

Ethernet interface view

Default level

2: System level

Parameters

number: Sets an aggregation group number in the range of 1 to 1024. You can configure up to 240 aggregation groups on the switch.

Description

Use port link-aggregation group to assign the Ethernet interface to the specified aggregation group.

Use undo port link-aggregation group to remove the Ethernet interface from the specified aggregation group.

An Ethernet interface can belong to only one aggregation group.

Examples

# Assign GigabitEthernet 4/0/1 to aggregation group 22.

<Sysname> system-view

[Sysname] interface gigabitethernet 4/0/1

[Sysname-GigabitEthernet4/0/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: Specifies an aggregate interface number in the range of 1 to 1024.

Description

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

Before collecting statistics for an aggregate interface within a specific period, you must clear the existing statistics on 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 switch.

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

Description

Use reset lacp statistics 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 for all 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 shutdown to shut down the aggregate interface or subinterface.

Use undo shutdown to bring up the aggregate interface or 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 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

04-Layer 2 - LAN Switching Command Reference

default

display link-aggregation verbose

interface bridge-aggregation

interface route-aggregation

link-aggregation irf-enhanced

link-aggregation selected-port maximum

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Policy & Program

Global Learning

Partner Sales Resources

Service Business

News & Events

Contact Us