Support of the H3C WX series access controllers for Ethernet link aggregation commands may vary by device model. For more information, see About the WX Series Access Controllers Command References.

default

Syntax

default

View

Layer 2 aggregate interface view

Default level

2: System level

Parameters

None

Description

Use default to restore the default settings for an aggregate interface.

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

Default level

2: System level

Parameters

text: Specifies the interface description, a string of 1 to 80 characters.

Description

Use description to configure a description for an interface. Fore example, you can include information such as the purpose of the interface for the ease of management.

Use undo description to restore the default setting.

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

Examples

# Set the description of Layer 2 aggregate interface Bridge-Aggregation 1 to connect to the lab.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] description connect to the lab

display interface

Syntax

display interface [ bridge-aggregation ] [ brief [ down ] ] [ | { begin | exclude | include } regular-expression ]

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

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 and varies with device models. For more information, see About the WX Series Access Controllers Command References.

brief: Displays brief interface information. If you do not specify this keyword, this command displays detailed interface information.

down: Displays information about interfaces in 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.

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 is not specified, this command displays information about all interfaces.

· If bridge-aggregation is specified without any interface number specified, this command displays information about all aggregate interfaces.

· If bridge-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

Port priority: 0

Last clearing of counters: 11:08:46 Thu 01/20/2011

# 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 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

NOTE:

The output from this command was collected on a WX5004 access controller and may vary with device models.

Table 1 Command output

Field	Description
Bridge-Aggregation1 current state	The Layer 2 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	Port VLAN ID.
Port priority	Aggregation priority of the port.
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 current interface since the device's startup.
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. To see the primary interface, use the display standby state command (see High Availability Command Reference).
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.
Interface	Abbreviated interface name.
Link	Physical link state of the interface.
Speed	Interface speed, in bps.
Cause	Cause of a DOWN physical link.

display link-aggregation load-sharing mode

Syntax

display link-aggregation load-sharing mode [ interface [ bridge-aggregation interface-number ] ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

bridge-aggregation: Displays the load sharing criterion or criteria of the aggregation group corresponding to the specified Layer 2 aggregate interface.

interface-number: Specifies an existing aggregate interface number. The value range for the interface-number argument varies with device models. For more information, see About the WX Series Access Controllers Command References.

|: 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 global or group-specific link-aggregation load sharing criterion or criteria.

To display the global link-aggregation load sharing criterion or criteria, run the command without the interface keyword.

To display all the group-specific load sharing criteria, run the command with the interface keyword, but do not specify a particular interface.

To display the load sharing criterion or criteria of a particular aggregation group, perform the command with the aggregate interface specified.

The bridge-aggregation keyword becomes available only after you create Layer 2 aggregate interfaces on the device.

Examples

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

# Display the link-aggregation load sharing criteria of the aggregation group corresponding to Layer 2 aggregate interface Bridge-Aggregation 2.

<Sysname> display link-aggregation load-sharing mode interface bridge-aggregation 2

Bridge-Aggregation2 Load-Sharing Mode:

Layer 2 traffic: destination-mac address, source-mac address

Table 2 Command output

Field	Description
Link-Aggregation Load-Sharing Mode	Global link-aggregation load sharing criteria. · By default, the link-aggregation load sharing criteria for Layer 2 traffic are displayed. · If you have configured the global link-aggregation load sharing criteria, the configured ones are displayed.
Bridge-Aggregation2 Load-Sharing Mode	Link-aggregation load sharing criteria of the aggregation group corresponding to the aggregate interface Bridge-Aggregation 2. · By default, the global link-aggregation load sharing criteria are displayed. · If you have configured link-aggregation load sharing criteria especially for this aggregation group, the configured ones are displayed.
Layer 2 traffic: destination-mac address, source-mac address	Default link-aggregation load sharing criteria for Layer 2 traffic. In this sample output, the criteria are the source and destination MAC addresses of packets.

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

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

GigabitEthernet1/0/1:

Aggregation Interface: Bridge-Aggregation1

Port Number: 1

Port Priority: 32768

Oper-Key: 1

Table 3 Command output

Field	Description
Aggregation Interface	Aggregate interface to which the member 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 summary information about all aggregation groups.

You might find that information about the remote system for a static link aggregation group is either displayed as none or is not displayed at all. This is normal, because static link aggregation groups are unaware of information about the peer groups.

Examples

# Display summary information about all aggregation groups.

<Sysname> display link-aggregation summary

Aggregation Interface Type:

BAGG -- Bridge-Aggregation, RAGG -- Route-Aggregation

Loadsharing Type: Shar -- Loadsharing, NonS -- Non-Loadsharing

AGG Select Unselect Share

Interface Ports Ports Type

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

BAGG1 0 0 Shar

BAGG2 0 1 Shar

Table 4 Command output

Field	Description
Aggregation Interface Type	Aggregate interface type: BAGG for Layer 2 aggregate interface
Loadsharing Type	Load-sharing type: · Shar for load sharing · NonS for non-load sharing
AGG Interface	Type and number of the aggregate interface
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 [ 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.

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

To display information about a specific Layer 2 aggregation group, use the display link-aggregation verbose bridge-aggregation interface-number command.

To display information about all Layer 2 aggregation groups, use the display link-aggregation verbose bridge-aggregation command.

To display information about all aggregation groups, use the display link-aggregation verbose command.

The bridge-aggregation keyword is available only after you create Layer 2 aggregate interfaces on the device.

Examples

# Display detailed information about the aggregation group corresponding to Layer 2 aggregate interface Bridge-Aggregation 2, which is a static aggregation group.

<Sysname> display link-aggregation verbose bridge-aggregation 2

Loadsharing Type: Shar -- Loadsharing, NonS -- Non-Loadsharing

Port Status: S -- Selected, U -- Unselected

Aggregation Interface: Bridge-Aggregation2

Aggregation Mode: Static

Loadsharing Type: Shar

Port Status Priority Oper-Key

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

GE1/0/2 U 32768 1

Table 5 Command output

Field	Description
Loadsharing Type	Load-sharing type: · Shar for load sharing · NonS for non-load sharing
Port Status	Port state: Selected or Unselected
Aggregation Interface	Name of the aggregate interface
Aggregation Mode	Mode of the aggregation group: Static for static aggregation
Port	Port type and number
Status	Port state: selected or unselected
Priority	Port aggregation priority
Oper-Key	Operational key

enable snmp trap updown

Syntax

enable snmp trap updown

undo enable snmp trap updown

View

Layer 2 aggregate interface 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, link state trapping is enabled for an aggregate interface.

With the link state trapping function enabled, an aggregate interface generates linkUp trap messages when its link goes up, and linkDown trap messages when its link goes down.

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 Layer 2 aggregate 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. The value range for the interface-number argument varies with device models. For more information, see About the WX Series Access Controllers Command References.

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. At the same time, the member ports of the aggregation group, if any, leave the aggregation group.

Examples

# Create Layer 2 aggregate interface Bridge-Aggregation 1 and enter its view.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1]

link-aggregation load-sharing mode

Syntax

link-aggregation load-sharing mode { destination-ip | destination-mac | source-ip | source-mac } *

undo link-aggregation load-sharing mode

View

System view, Layer 2 aggregate interface 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.

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.

Description

Use link-aggregation load-sharing mode to configure the global or group-specific link-aggregation load sharing criteria.

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

By default, the device performs load sharing in link aggregation groups based on source and destination MAC addresses.

The load sharing criteria that you configure will overwrite the previous criteria.

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

# Configure the destination MAC address as the load sharing criterion specific to the link aggregation group of aggregate interface Bridge-Aggregation 1.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] link-aggregation load-sharing mode destination-mac

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, ranging from 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 setting.

The default aggregation priority of a port is 32768.

Examples

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

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

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

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: Specifies the number of the aggregate interface corresponding to an aggregation group. The value range for the number argument varies with device models. For more information, see About the WX Series Access Controllers Command References.

Description

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

Use undo port link-aggregation group to remove the current 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.

An Ethernet interface can belong to only one aggregation group.

Examples

# Assign Layer 2 interface GigabitEthernet 1/0/1 to Layer 2 aggregation group 1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] port link-aggregation group 1

reset counters interface

Syntax

reset counters interface [ bridge-aggregation [ interface-number ] ]

View

User view

Default level

2: System level

Parameters

bridge-aggregation: Clears statistics for Layer 2 aggregate interfaces.

interface-number: Specifies an aggregate interface number. The range for the interface-number argument varies with device models. For more information, see About the WX Series Access Controllers Command References.

Description

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

Before collecting statistics for a Layer 2 aggregate 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 keyword is specified, the command clears the statistics of all Layer 2 aggregate interfaces.

· If the bridge-aggregation interface-number option is specified, the command clears the statistics of the specified Layer 2 aggregate interface.

· The bridge-aggregation keyword becomes available only after you create Layer 2 aggregate interfaces on the device.

Examples

# Clear the statistics of Layer 2 aggregate interface Bridge-Aggregation 1.

<Sysname> reset counters interface bridge-aggregation 1

shutdown

Syntax

shutdown

undo shutdown

View

Layer 2 aggregate interface view

Default level

2: System level

Parameters

None

Description

Use shutdown to shut down the current aggregate interface.

Use undo shutdown to bring up the current aggregate interface.

By default, aggregate interfaces are up.

Examples

# Shut down Layer 2 aggregate interface Bridge-Aggregation 1.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] shutdown

03-Layer 2 Command Reference

display link-aggregation verbose

interface bridge-aggregation

link-aggregation load-sharing mode

link-aggregation port-priority

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