The expected bandwidth of an interface affects link costs in OSPF, OSPFv3, and IS-IS. For more information, see Layer 3—IP Routing Configuration Guide.

Examples

# Set the expected bandwidth to 10000 kbps for Layer 2 aggregate interface Bridge-Aggregation 1.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] bandwidth 10000

default

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

Syntax

default

Views

Layer 2 aggregate interface view, Layer 3 aggregate interface view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

CAUTION:

The default command might interrupt ongoing network services. Make sure you are fully aware of the impacts of this command when you execute it on a live network.

This command might fail to restore the default settings for some commands for reasons such as command dependencies and system restrictions. Use the display this command in interface view to identify these commands, and then use their undo forms or follow the command reference to restore their default settings. If your restoration attempt still fails, follow the error message instructions to resolve the problem.

Examples

# Restore the default settings for Layer 2 aggregate interface 1.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] default

description

Use description to set a description for an interface.

Use undo description to restore the default.

Syntax

description text

undo description

Default

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

Views

Layer 2 aggregate interface view, Layer 3 aggregate interface view

Predefined user roles

network-admin

mdc-admin

Parameters

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

Examples

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

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

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

display interface

Use display interface to display aggregate interface information.

Syntax

display interface [ { bridge-aggregation | route-aggregation } [ interface-number ] ] [ brief [ description | down ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

bridge-aggregation: Specifies Layer 2 aggregate interfaces.

route-aggregation: Specifies Layer 3 aggregate interfaces.

interface-number: Specifies an existing aggregate interface number.

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

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

down: Displays information about interfaces in the down state and the causes for the down state. If you do not specify this keyword, the command displays information about interfaces in all states.

Usage guidelines

If you do not specify the bridge-aggregation and route-aggregation keywords, the command displays information about all interfaces.

If you specify the bridge-aggregation or route-aggregation keyword but do not specify an interface number, the command displays information about all Layer 2 or Layer 3 aggregate interfaces.

If you specify the bridge-aggregation interface-number or route-aggregation interface-number option, the command displays information about the specified aggregate interface.

Examples

# Display detailed information about Layer 2 aggregate interface Bridge-Aggregation 1.

<Sysname> display interface bridge-aggregation 1

Bridge-Aggregation1

Current state: UP

IP Packet Frame Type: PKTFMT_ETHNT_2, Hardware Address: 000f-e207-f2e0

Description: Bridge-Aggregation1 Interface

Bandwidth: 0kbps

2Gbps-speed mode, full-duplex mode

Link speed type is autonegotiation, link duplex type is autonegotiation

PVID: 1

Port link-type: access

Tagged Vlan: none

UnTagged Vlan: 1

Last clearing of counters: Never

Last 300 seconds input: 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, 0 pauses

Input (normal): 0 packets, 0 bytes

0 unicasts, 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 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

Output (normal): 0 packets, 0 bytes

0 unicasts, 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 detailed information about Layer 3 aggregate interface Route-Aggregation 1.

<Sysname> display interface route-aggregation 1

Route-Aggregation1

Current state: UP

Line protocol state: UP

Description: Route-Aggregation1 Interface

Bandwidth: 1000000kbps

Maximum Transmit Unit: 1500

Internet protocol processing: disabled

IP Packet Frame Type:PKTFMT_ETHNT_2, Hardware Address: 0000-fc00-2501

IPv6 Packet Frame Type:PKTFMT_ETHNT_2, Hardware Address: 0000-fc00-2501

Last clearing of counters: Never

Last 300 seconds input rate: 6 bytes/sec, 48 bits/sec, 0 packets/sec

Last 300 seconds output rate: 2 bytes/sec, 16 bits/sec, 0 packets/sec

11 packets input, 800 bytes, 0 drops

1 packets output, 80 bytes, 0 drops

# Display brief information about Layer 2 aggregate interface Bridge-Aggregation 1.

<Sysname> display interface bridge-aggregation 1 brief

Brief information on interface(s) under bridge mode:

Link: ADM - administratively down; Stby - standby

Speed or Duplex: (a)/A - auto; H - half; F - full

Type: A - access; T - trunk; H - hybrid

Interface Link Speed Duplex Type PVID Description

BAGG1 UP auto A A 1

# Display brief information about Layer 3 aggregate interface Route-Aggregation 1.

<Sysname> display interface route-aggregation 1 brief

Brief information on interface(s) under route mode:

Link: ADM - administratively down; Stby - standby

Protocol: (s) - spoofing

Interface Link Protocol Main IP Description

RAGG1 UP UP --

Table 1 Command output

Field	Description
Bridge-Aggregation1	Layer 2 aggregate interface name.
Route-Aggregation1	Layer 3 aggregate interface name.
Current state	Layer 3 aggregate interface status: · DOWN (Administratively down)—The interface is administratively shut down with the shutdown command. · DOWN—The interface is administratively up but physically down (possibly because no physical link is present or the link has failed). · UP—The Ethernet interface is both administratively and physically up.
IP Packet Frame Type	IPv4 packet frame format. The value PKTFMT_ETHNT_2 indicates that packets are encapsulated in Ethernet II format.
Bandwidth	Expected bandwidth of the interface.
Unknown-speed mode, unknown-duplex mode	The interface speed and duplex mode are unknown.
PVID	Port VLAN ID (PVID).
Port link-type	Port link type: access, trunk, or hybrid.
Tagged Vlan	VLAN whose packets are sent out of this interface with a tag.
Untagged Vlan	VLAN whose packets are sent out of this interface without a tag.
Last clearing of counters	Time when the reset counters interface command was last used to clear the interface statistics. If the reset counters interface command has never been used on the interface since the device startup, this field displays Never.
Last 300 seconds input/output rate	Average input/output rate over the last 300 seconds.
Input/Output (total)	Statistics of all packets received/sent on the interface.
Input/Output (normal)	Statistics of all normal packets received/sent on the interface.
Line protocol state	Data link layer protocol state of the interface: · UP—The data link layer protocol of the interface is up. · DOWN—The data link layer protocol of the interface is down.
Internet protocol processing	IP packet processing. Disabled indicates that IP packets cannot be processed. For an interface configured with an IP address, this field changes to Internet Address is.
Brief information on interface(s) under route mode	Brief information about Layer 3 interfaces.
Brief information on interface(s) under bridge mode	Brief information about Layer 2 interfaces.
Link: ADM - administratively down; Stby - standby	Link status: · ADM—The interface has been administratively shut down. To recover its physical layer state, run the undo shutdown command. · Stby—The interface is operating as a backup interface.
Speed or Duplex: (a)/A - auto; H - half; F - full	If the speed of an interface is automatically negotiated, the speed attribute of the interface includes the auto negotiation flag (the letter a in parentheses). If an interface is configured to autonegotiate its speed but the autonegotiation has not started, its speed attribute is displayed as auto. If the duplex mode of an interface is automatically negotiated, the duplex mode attribute of the interface includes the letter a in parentheses. H indicates the half duplex mode. F indicates the full duplex mode. If an interface is configured to autonegotiate its duplex mode but the autonegotiation has not started, its duplex mode attribute is displayed as A.
Type: A - access; T - trunk; H - hybrid	Port link type options for interfaces.
Protocol: (s) - spoofing	If the data link layer protocol state of an interface is shown as UP, but its link is an on-demand link or not present, its protocol attribute includes the spoofing flag (the letter s in parentheses).
Interface	Abbreviated interface name.
Link	Physical link state of the interface: · UP—The interface is physically up. · DOWN—The interface is physically down. · ADM—The interface has been administratively shut down. To bring up the interface, use the undo shutdown command. · Stby—The interface is operating as a backup interface.
Speed	Interface speed, in bps.
Protocol	Data link layer state of the interface: · UP—The data link layer of the interface is up. · DOWN—The data link layer of the interface is down. · UP(s)—The data link layer of the interface is shown as UP, but its link is an on-demand link or not present.
Cause	Cause of a DOWN physical link.
Description	Partial or complete interface description configured by using the description command. · If you do not specify the description keyword in the display interface brief command, this field displays only the first 27 characters of the interface description. · If you specify the description keyword in the display interface brief command, this field displays the complete interface description.

display lacp system-id

Use display lacp system-id to display the local system ID.

Syntax

display lacp system-id

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Usage guidelines

You can use the lacp system-priority command to change the LACP priority of the local system. The LACP priority value is specified in decimal format in the lacp system-priority command. However, it is displayed as a hexadecimal value in the output from the display lacp system-id command.

Examples

# Display the local system ID.

<Sysname> display lacp system-id

Actor System ID: 0x8000, 0000-fc00-6504

Table 2 Command output

Field	Description
Actor System ID: 0x8000, 0000-fc00-6504	Local system ID, which contains the system LACP priority (0x8000 in this sample output) and the system MAC address (0000-FC00-6504 in this sample output).

Related commands

lacp system-priority

display link-aggregation load-sharing mode

Use display link-aggregation load-sharing mode to display global or group-specific link-aggregation load sharing modes.

Syntax

display link-aggregation load-sharing mode [ interface [ { bridge-aggregation | route-aggregation } interface-number ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

bridge-aggregation: Specifies Layer 2 aggregate interfaces.

route-aggregation: Specifies Layer 3 aggregate interfaces.

interface-number: Specifies an existing aggregate interface number.

Usage guidelines

If you do not specify the interface keyword, the command displays the global link-aggregation load sharing modes.

If you specify the interface keyword, but do not specify an interface, the command displays all group-specific load sharing modes.

If you specify the bridge-aggregation interface-number or route-aggregation interface-number option, the command displays the load sharing mode of the specified aggregation group.

The bridge-aggregation or route-aggregation keyword is available only when Layer 2 or Layer 3 aggregate interfaces exist on the device.

Examples

# Display the default global link-aggregation load sharing modes.

<Sysname> display link-aggregation load-sharing mode

Link-Aggregation Load-Sharing Mode:

Layer 2 traffic: packet type-based sharing

Layer 3 traffic: packet type-based sharing

# Display the configured global link-aggregation load sharing mode.

<Sysname> display link-aggregation load-sharing mode

Link-Aggregation Load-Sharing Mode:

destination-mac address source-mac address

# Display the default link-aggregation load sharing modes of Layer 2 aggregation group 10.

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

Bridge-Aggregation10 Load-Sharing Mode:

Layer 2 traffic: packet type-based sharing

Layer 3 traffic: packet type-based sharing

# Display the configured link-aggregation load sharing mode of Layer 2 aggregation group 10.

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

Bridge-Aggregation10 Load-Sharing Mode:

destination-mac address source-mac address

Table 3 Command output

Field	Description
Link-Aggregation Load-Sharing Mode	Global link-aggregation load sharing mode. By default, this field displays the link-aggregation load sharing modes for Layer 2 traffic and Layer 3 traffic. If you have set the global link-aggregation load sharing mode, this field displays the set mode.
Bridge-Aggregation10 Load-Sharing Mode	Link-aggregation load sharing mode of Layer 2 aggregation group 10. By default, this field displays the global link-aggregation load sharing modes. If you have set a link-aggregation load sharing mode for this aggregation group, this field displays the set mode.
Route-Aggregation10 Load-Sharing Mode	Link-aggregation load sharing mode of Layer 3 aggregation group 10. By default, this field displays the global link-aggregation load sharing modes. If you have set a link-aggregation load sharing mode for this aggregation group, this field displays the set mode.
Layer 2 traffic: packet type-based sharing	Default link-aggregation load sharing mode for Layer 2 traffic. In this sample output, Layer 2 traffic is load shared based on the packet type.
Layer 3 traffic: packet type-based sharing	Default link-aggregation load sharing mode for Layer 3 traffic. In this sample output, Layer 3 traffic is load shared based on the packet type.
destination-mac address, source-mac address	User-configured link-aggregation load sharing mode. In this sample output, traffic is load shared based on source and destination MAC addresses.

display link-aggregation member-port

Use display link-aggregation member-port to display detailed link aggregation information for the specified member ports.

Syntax

display link-aggregation member-port [ interface-list ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

interface-list: Specifies a list of link aggregation member ports, in the format interface-type interface-number [ to interface-type interface-number ]. interface-type interface-number specifies an interface by its type and number.

Usage guidelines

A member port in a static aggregation group is unaware of information about the peer group. For such member ports, the command displays the port number, port priority, and operational key of only the local end.

Examples

# Display detailed link aggregation information for GigabitEthernet 1/0/1, which is a member port of a static aggregation group.

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

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

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

G -- Defaulted, H -- Expired

GigabitEthernet1/0/1:

Aggregate Interface: Bridge-Aggregation1

Port Number: 1

Port Priority: 32768

Oper-Key: 1

# Display detailed link aggregation information for RPR 4/0/1, which is a member port of a static aggregation group.

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

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

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

G -- Defaulted, H -- Expired

RPR4/0/1:

Aggregate Interface: Bridge-Aggregation1

Port Number: 1

Port Priority: 32768

Oper-Key: 1

# Display detailed link aggregation information for GigabitEthernet 1/0/2, which is a member port of a dynamic aggregation group.

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

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

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

G -- Defaulted, H -- Expired

GigabitEthernet1/0/2:

Aggregate Interface: Bridge-Aggregation10

Local:

Port Number: 2

Port Priority: 32768

Oper-Key: 2

Flag: {ACDEF}

Remote:

System ID: 0x8000, 000f-e267-6c6a

Port Number: 26

Port Priority: 32768

Oper-Key: 2

Flag: {ACDEF}

Received LACP Packets: 5 packet(s)

Illegal: 0 packet(s)

Sent LACP Packets: 7 packet(s)

Table 4 Command output

Field	Description
Flags	LACP state flags. This field is one byte long, represented by ABCDEFGH from the least significant bit to the most significant bit. The letter is present when its bit is 1 and absent when its bit is 0. · A—Indicates whether LACP is enabled. 1 indicates enabled, and 0 indicates disabled. · B—Indicates the LACP short or long timeout. 1 indicates short timeout, and 0 indicates long timeout. · C—Indicates whether the sending system considers that the link is aggregatable. 1 indicates yes, and 0 indicates no. · D—Indicates whether the sending system considers that the link is synchronized. 1 indicates yes, and 0 indicates no. · E—Indicates whether the sending system considers that the incoming frames are collected. 1 indicates yes, and 0 indicates no. · F—Indicates whether the sending system considers that the outgoing frames are distributed. 1 indicates yes, and 0 indicates no. · G—Indicates whether the sending system receives frames in the default state. 1 indicates yes, and 0 indicates no. · H—Indicates whether the sending system receives frames in the expired state. 1 indicates yes, and 0 indicates no.
Aggregate Interface	Aggregate interface to which the member port belongs.
Local	Information about the local end.
Oper-key	Operational key.
Flag	LACP protocol state flag.
Remote	Information about the peer end.
System ID	Peer system ID, containing the system LACP priority and the system MAC address.
Received LACP Packets	Total number of LACP packets received.
Illegal	Total number of illegal packets.
Sent LACP Packets	Total number of LACP packets sent.

display link-aggregation summary

Use display link-aggregation summary to display brief information about all aggregation groups.

Syntax

display link-aggregation summary

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Usage guidelines

Static link aggregation groups are unaware of information about the peer groups. As a result, the Partner ID field displays None for a static link aggregation group.

Examples

# Display brief information for all aggregation groups.

<Sysname> display link-aggregation summary

Aggregation Interface Type:

BAGG -- Bridge-Aggregation, BLAGG -- Blade-Aggregation, RAGG -- Route-Aggregatio

Aggregation Mode: S -- Static, D -- Dynamic

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

Actor System ID: 0x8000, 0000-fc00-2500

AGG AGG Partner ID Selected Unselected Individual Share

Interface Mode Ports Ports Ports Type

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

BLAGG1 S None 0 0 0 Shar

BAGG1 S None 0 0 0 Shar

RAGG1 S None 1 0 0 Shar

Table 5 Command output

Field	Description
Aggregate Interface Type	Aggregate interface type: · BAGG—Layer 2. · RAGG—Layer 3.
Aggregation Mode	Aggregation group type: · S—Static. · D—Dynamic.
Loadsharing Type	Load sharing type: · Shar—Load sharing. · NonS—Non-load sharing.
Actor System ID	Local system ID, which contains the local system LACP priority and the local system MAC address.
AGG Interface	Type and number of the aggregate interface.
AGG Mode	Aggregation group type.
Partner ID	System ID of the peer system, which contains the peer system LACP priority and the peer system MAC address.
Selected Ports	Total number of Selected ports.
Unselected Ports	Total number of Unselected ports.
Individual Ports	Total number of Individual ports.
Share Type	Load sharing type.

display link-aggregation verbose

Use display link-aggregation verbose to display detailed information about the aggregation groups that correspond to the specified aggregate interfaces.

Syntax

display link-aggregation verbose [ { bridge-aggregation | route-aggregation } [ interface-number ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

bridge-aggregation: Specifies Layer 2 aggregate interfaces.

route-aggregation: Specifies Layer 3 aggregate interfaces.

interface-number: Specifies an existing aggregate interface by its number.

Usage guidelines

If you specify the bridge-aggregation or route-aggregation keyword but do not specify an interface number, the command displays detailed information about all Layer 2 or Layer 3 aggregation groups.

If you do not specify an aggregate interface type, the command displays detailed information about all aggregation groups.

The bridge-aggregation or route-aggregation keyword is available only when Layer 2 or Layer 3 aggregate interfaces exist on the device.

Examples

# Display detailed information about Layer 2 aggregation group 10, which is a dynamic aggregation group.

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

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

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

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

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

G -- Defaulted, H -- Expired

Aggregate Interface: Bridge-Aggregation10

Aggregation Mode: Dynamic

Loadsharing Type: Shar

System ID: 0x8000, 000f-e267-6c6a

Local:

Port Status Priority Oper-Key Flag

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

GE1/0/1 S 32768 2 {ACDEF}

GE1/0/2 S 32768 2 {ACDEF}

GE1/0/3 S 32768 2 {AG}

Remote:

Actor Partner Priority Oper-Key SystemID Flag

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

GE1/0/1 1 32768 2 0x8000, 000f-e267-57ad {ACDEF}

GE1/0/2 2 32768 2 0x8000, 000f-e267-57ad {ACDEF}

GE1/0/3 0 32768 0 0x8000, 0000-0000-0000 {DEF}

# Display detailed information about Layer 2 aggregation group 20, which is a static aggregation group.

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

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

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

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

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

G -- Defaulted, H -- Expired

Aggregate Interface: Bridge-Aggregation20

Aggregation Mode: Static

Loadsharing Type: Shar

Port Status Priority Oper-Key

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

GE1/0/1 U 32768 1

GE1/0/2 U 32768 1

GE1/0/3 U 32768 1

Table 6 Command output

Field	Description
Loadsharing Type	Load sharing type: · Shar—Load sharing. · NonS—Non-load sharing.
Port Status	Port state: Selected, Unselected, or Individual.
Flags	LACP state flags. This field is one byte long, represented by ABCDEFGH from the least significant bit to the most significant bit. The letter is present when its bit is 1 and absent when its bit is 0. · A—Indicates whether LACP is enabled. 1 indicates enabled, and 0 indicates disabled. · B—Indicates the LACP short or long timeout. 1 indicates short timeout, and 0 indicates long timeout. · C—Indicates whether the sending system considers that the link is aggregatable. 1 indicates yes, and 0 indicates no. · D—Indicates whether the sending system considers that the link is synchronized. 1 indicates yes, and 0 indicates no. · E—Indicates whether the sending system considers that the incoming frames are collected. 1 indicates yes, and 0 indicates no. · F—Indicates whether the sending system considers that the outgoing frames are distributed. 1 indicates yes, and 0 indicates no. · G—Indicates whether the sending system receives frames in the default state. 1 indicates yes, and 0 indicates no. · H—Indicates whether the sending system receives frames in the expired state. 1 indicates yes, and 0 indicates no.
Aggregate Interface	Name of the aggregate interface.
Aggregation Mode	Aggregation group type: · S—Static. · D—Dynamic.
System ID	Local system ID, containing the local system LACP priority and the local system MAC address.
Local	Information about the local end: · Port—Port type and number. · Status—Port state, which can be Selected, Unselected, or Individual. · Priority—Port priority. · Oper-Key—Operational key. · Flag—LACP state flag. NOTE: For static aggregation groups, the Flag field is not displayed.
Remote	Information about the peer end: · Actor—Type and number of the local port. · Partner—Index of the peer port. · Priority—Priority of the peer port. · Oper-Key—Operational key of the peer port. · System ID—System ID of the peer end. · Flag—LACP state flag of the peer end.

interface bridge-aggregation

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

Use undo interface bridge-aggregation to delete a Layer 2 aggregate interface.

Syntax

interface bridge-aggregation interface-number

undo interface bridge-aggregation interface-number

Default

No Layer 2 aggregate interface is created.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

interface-number: Specifies a Layer 2 aggregate interface number. The value range for the interface-number argument is 1 to 1024.

Usage guidelines

When you create a Layer 2 aggregate interface, the system automatically creates a Layer 2 aggregation group with the same number. The aggregation group operates in static aggregation mode by default.

Deleting a Layer 2 aggregate interface also deletes 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]

interface route-aggregation

Use interface route-aggregation to create a Layer 3 aggregate interface and enter Layer 3 aggregate interface view.

Use undo interface route-aggregation to delete a Layer 3 aggregate interface.

Syntax

interface route-aggregation interface-number

undo interface route-aggregation interface-number

Default

No Layer 3 aggregate interface is created.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

interface-number: Specifies a Layer 3 aggregate interface number. The value range for the interface-number argument is 1 to 1024.

Usage guidelines

When you create a Layer 3 aggregate interface, the system automatically creates a Layer 3 aggregation group with the same number. The Layer 3 aggregation group operates in static aggregation mode by default.

Deleting a Layer 3 aggregate interface also deletes the Layer 3 aggregation group. At the same time, the member ports of the aggregation group, if any, leave the aggregation group.

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 edge-port

Use lacp edge-port to configure an aggregate interface as an edge aggregate interface.

Use undo lacp edge-port to restore the default.

Syntax

lacp edge-port

undo lacp edge-port

Default

An aggregate interface does not operate as an edge aggregate interface.

Views

Layer 2 aggregate interface view, Layer 3 aggregate interface view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

Use this command on the aggregate interface connecting an LACP-enabled device to an LACP-enabled server. This feature enables the aggregation member ports on the device to forward packets from the server (the peer system) during the server reboot process.

This command takes effect only on an aggregate interface corresponding to a dynamic aggregation group.

Link-aggregation traffic redirection cannot operate correctly on an edge aggregate interface.

Examples

# Configure Layer 2 aggregate interface Bridge-aggregation 1 as an edge aggregate interface.

<Sysname> System-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] lacp edge-port

lacp mode

Use lacp mode passive to configure LACP to operate in passive mode on a port.

Use undo lacp mode to restore the default.

Syntax

lacp mode passive

undo lacp mode

Default

LACP is operating in active mode on a port.

Views

Layer 2 Ethernet interface view, Layer 3 Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

When LACP is operating in passive mode on a local member port and its peer port, both ports cannot send LACPDUs. When LACP is operating in active mode on either end of a link, both ports can send LACPDUs.

This command takes effect only on member ports of dynamic aggregation groups.

Examples

# Configure LACP to operate in passive mode on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] lacp mode passive

lacp period short

Use lacp period short to set the short LACP timeout interval (3 seconds) on an interface.

Use undo lacp period to restore the default.

Syntax

lacp period short

undo lacp period

Default

The LACP timeout interval is the long timeout interval (90 seconds).

Views

Layer 2 Ethernet interface view, Layer 3 Ethernet interface view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

Do not set the LACP timeout interval to the short LACP timeout interval before performing an ISSU. Otherwise, traffic interruption will occur during the ISSU. For more information about ISSU, see Fundamentals Configuration Guide.

Examples

# Set the short LACP timeout interval (3 seconds) on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] lacp period short

lacp system-priority

Use lacp system-priority to set the system LACP priority.

Use undo lacp system-priority to restore the default.

Syntax

lacp system-priority system-priority

undo lacp system-priority

Default

The system LACP priority is 32768.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

system-priority: Specifies the system LACP priority in the range of 0 to 65535. The smaller the value, the higher the system LACP priority.

Examples

# Set the system LACP priority to 64.

<Sysname> system-view

[Sysname] lacp system-priority 64

Related commands

link-aggregation port-priority

link-aggregation global load-sharing mode

Use link-aggregation global load-sharing mode to set the global link-aggregation load sharing mode.

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

Syntax

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

undo link-aggregation global load-sharing mode

Default

The device load shares traffic automatically based on packet types.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

destination-ip: Load shares traffic based on destination IP addresses.

destination-mac: Load shares traffic based on destination MAC addresses.

destination-port: Load shares traffic based on destination ports.

ingress-port: Load shares traffic based on ingress ports.

source-ip: Load shares traffic based on source IP addresses.

source-mac: Load shares traffic based on source MAC addresses.

source-port: Load shares traffic based on source ports.

Usage guidelines

The load sharing mode that you configure overwrites the previous mode.

If an unsupported load sharing mode is configured, an error prompt appears.

In system view, the switch supports the following load sharing modes and combinations:

· Source IP address.

· Destination IP address.

· Source MAC address.

· Destination MAC address.

· Source IP address and destination IP address.

· Source IP address and source port.

· Destination IP address and destination port.

· Source IP address, source port, destination IP address, and destination port.

· Any combination of ingress port, source MAC address, and destination MAC address.

Examples

# Set the global load sharing mode to load share packets based on destination MAC addresses.

<Sysname> system-view

[Sysname] link-aggregation global load-sharing mode destination-mac

Related commands

link-aggregation load-sharing mode

link-aggregation ignore vlan

Use link-aggregation ignore vlan to configure a Layer 2 aggregate interface to ignore the specified VLANs.

Use undo link-aggregation ignore vlan to restore the default.

Syntax

link-aggregation ignore vlan vlan-id-list

undo link-aggregation ignore vlan vlan-id-list

Default

A Layer 2 aggregate interface does not ignore any VLANs.

Views

Layer 2 aggregate interface view

Predefined user roles

network-admin

mdc-admin

Parameters

vlan-id-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN ID or a range of VLAN IDs in the form of vlan-id1 to vlan-id2. The value range for VLAN IDs is 1 to 4094. The value for vlan-id2 must be equal to or greater than the value for vlan-id1.

Usage guidelines

With this command configured, a Layer 2 aggregate interface ignores the permitted VLAN and VLAN tagging mode configuration of the specified VLANs when choosing Selected ports.

Examples

# Configure Layer 2 aggregate interface bridge-aggregation 1 to ignore VLAN 50.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] link-aggregation ignore vlan 50

link-aggregation lacp traffic-redirect-notification enable

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.

Syntax

link-aggregation lacp traffic-redirect-notification enable

undo link-aggregation lacp traffic-redirect-notification enable

Default

Link-aggregation traffic redirection is disabled.

Views

System view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

When you restart a card that contains Selected ports, this feature redirects traffic of the card to other cards. Zero packet loss is guaranteed for known unicast traffic, but not for unknown unicast traffic. (In standalone mode.)

When you restart either an IRF member device or the device's card that contains Selected ports, this feature redirects traffic of the IRF member device or card to other IRF member devices or cards. Zero packet loss is guaranteed for known unicast traffic, but not for unknown unicast traffic. (In IRF mode.)

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

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

Do not enable both spanning tree and link-aggregation traffic redirection on a device. Otherwise, light packet loss might occur when a card or the device reboots.

Link-aggregation traffic redirection cannot operate correctly on an edge aggregate interface.

To avoid traffic interruption on Layer 2 dynamic aggregate links after link-aggregation traffic redirection is enabled, make sure the corresponding aggregate interfaces do not have static MAC address entries. For information about MAC address entries, see Layer 2—LAN Switching Configuration Guide.

Examples

# Enable link-aggregation traffic redirection.

<Sysname> system-view

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

link-aggregation load-sharing mode

Use link-aggregation load-sharing mode to set the link-aggregation load sharing mode.

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

Syntax

link-aggregation load-sharing mode { { destination-ip | destination-mac | mpls-label1 | mpls-label2 | source-ip | source-mac } * | flexible }

undo link-aggregation load-sharing mode

Default

The load sharing mode is the same as the global load sharing mode.

Views

Layer 2 aggregate interface view

Predefined user roles

network-admin

mdc-admin

Parameters

destination-ip: Load shares traffic based on destination IP addresses.

destination-mac: Load shares traffic based on destination MAC addresses.

mpls-label1: Load shares MPLS traffic based on Layer 1 labels.

mpls-label2: Load shares MPLS traffic based on Layer 2 labels.

source-ip: Load shares traffic based on source IP addresses.

source-mac: Load shares traffic based on source MAC addresses.

flexible: Load shares traffic flexibly based on the packet type (for example, Layer 2 protocol packets, IPv4 packets, IPv6 packets, or MPLS packets).

Usage guidelines

The load sharing mode that you configure overwrites the previous mode.

If an unsupported load sharing mode is configured, an error prompt appears.

In Layer 2 aggregate interface view, the switch supports the following load sharing modes and combinations:

· Source IP address.

· Destination IP address.

· Source MAC address.

· Destination MAC address.

· Layer 1 MPLS label.

· Destination IP address and source IP address.

· Destination MAC address and source MAC address.

· Layer 1 MPLS label and Layer 2 MPLS label.

Examples

# Configure Layer 2 aggregation group 1 to load share packets based on destination MAC addresses.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

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

Related commands

link-aggregation global load-sharing mode

link-aggregation load-sharing mode local-first

Use link-aggregation load-sharing mode local-first to enable local-first load sharing for link aggregation.

Use undo link-aggregation load-sharing mode local-first to disable local-first load sharing for link aggregation.

Syntax

link-aggregation load-sharing mode local-first

undo link-aggregation load-sharing mode local-first

Default

Local-first load sharing is enabled for link aggregation.

Views

System view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

When you disable local-first load sharing, the packets will be load shared among all Selected ports of the aggregate interface on all IRF member devices.

Examples

# Disable local-first load sharing for link aggregation.

<Sysname> system-view

[Sysname] undo link-aggregation load-sharing mode local-first

link-aggregation mode

Use link-aggregation mode dynamic to configure an aggregation group to operate in dynamic aggregation mode and enable LACP.

Use undo link-aggregation mode to restore the default.

Syntax

link-aggregation mode dynamic

undo link-aggregation mode

Default

An aggregation group operates in static aggregation mode.

Views

Layer 2 aggregate interface view, Layer 3 aggregate interface view

Predefined user roles

network-admin

mdc-admin

Examples

# Configure Layer 2 aggregation group 1 to operate in dynamic aggregation mode.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] link-aggregation mode dynamic

link-aggregation port-priority

Use link-aggregation port-priority to set the port priority of an interface.

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

Syntax

link-aggregation port-priority port-priority

undo link-aggregation port-priority

Default

The port priority of an interface is 32768.

Views

Layer 2 Ethernet interface view, Layer 3 Ethernet interface view, RPR logical interface view

Predefined user roles

network-admin

mdc-admin

Parameters

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

Examples

# Set the port priority to 64 for Layer 2 Ethernet interface GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

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

# Set the port priority to 64 for Layer 3 Ethernet interface GigabitEthernet 1/0/2.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/2

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

Related commands

lacp system-priority

link-aggregation selected-port maximum

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

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

Syntax

link-aggregation selected-port maximum number

undo link-aggregation selected-port maximum

Default

The maximum number of Selected ports allowed in an aggregation group depends on hardware limitation.

Views

Layer 2 aggregate interface view, Layer 3 aggregate interface view

Predefined user roles

network-admin

mdc-admin

Parameters

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

Usage guidelines

Executing this command might cause some of the Selected ports in an aggregation group to become Unselected ports.

The maximum number of Selected ports allowed in the aggregation groups of the local and peer ends must be consistent.

The maximum number of Selected ports allowed in an aggregation group is limited by one of the following values, whichever value is smaller:

· Maximum number configured by using the link-aggregation selected-port maximum command.

· Hardware limitation.

You can configure backup between two ports by performing the following tasks:

· Assigning two ports to an aggregation group.

· Setting the maximum number of Selected ports to 1 for the aggregation group.

Then, only one Selected port is allowed in the aggregation group at any point in time, while the Unselected port acts as a backup port.

Examples

# Set the maximum number of Selected ports to 5 for Layer 2 aggregation group 1.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] link-aggregation selected-port maximum 5

Related commands

link-aggregation selected-port minimum

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

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

Syntax

link-aggregation selected-port minimum number

undo link-aggregation selected-port minimum

Default

The minimum number of Selected ports in an aggregation group is not specified.

Views

Layer 2 aggregate interface view, Layer 3 aggregate interface view

Predefined user roles

network-admin

mdc-admin

Parameters

number: Specifies the minimum number of Selected ports in an aggregation group required to bring up the aggregate interface. The value range for this argument is 1 to 32.

Usage guidelines

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

The minimum number of Selected ports allowed in the aggregation groups of the local and peer ends must be consistent.

Examples

# Set the minimum number of Selected ports to 3 for Layer 2 aggregation group 1.

<Sysname> system-view

[Sysname] interface bridge-aggregation 1

[Sysname-Bridge-Aggregation1] link-aggregation selected-port minimum 3

Related commands

link-aggregation selected-port maximum

mtu

Use mtu to set the MTU for a Layer 3 aggregate interface.

Use undo mtu to restore the default.

Syntax

mtu size

undo mtu

Default

The MTU for Layer 3 aggregate interfaces is 1500 bytes.

Views

Layer 3 aggregate interface view

Predefined user roles

network-admin

mdc-admin

Parameters

size: Specifies the MTU in bytes. The value range is 46 to 1560.

Examples

# Set the MTU to 1430 bytes for Layer 3 aggregate interface Route-Aggregation 1.

<Sysname> system-view

[Sysname] interface route-aggregation 1

[Sysname-Route-Aggregation1] mtu 1430

Related commands

display interface

port link-aggregation group

Use port link-aggregation group to assign an Ethernet interface to an aggregation group.

Use undo port link-aggregation group to remove an Ethernet interface from the aggregation group to which it belongs.

Syntax

port link-aggregation group number

undo port link-aggregation group

Default

An Ethernet interface does not belong to any aggregation group.

Views

Layer 2 Ethernet interface view, Layer 3 Ethernet interface view, RPR logical interface view

Predefined user roles

network-admin

mdc-admin

Parameters

number: Specifies an aggregation group by its aggregate interface number. The value range for the number argument is 1 to 1024.

Usage guidelines

RPR logical interfaces cannot be assigned to dynamic aggregation groups.

A Layer 2 Ethernet interface or an RPR logical interface can be assigned to a Layer 2 aggregation group only. A Layer 3 Ethernet interface can be assigned to a Layer 3 aggregation group only.

You cannot assign a Layer 2 Ethernet interface and an RPR logical interface to the same Layer 2 aggregation group.

An interface can belong to only one aggregation group.

An RPR logical interface cannot be assigned to an aggregation group whose corresponding aggregate interface is assigned to an isolation group. For information about isolation groups, see Layer 2—LAN Switching Configuration Guide.

Examples

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

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

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

# Assign RPR logical interface RPR 4/0/1 to Layer 2 aggregation group 20.

<Sysname> system-view

[Sysname] interface rpr 4/0/1

[Sysname-RPR4/0/1] port link-aggregation group 20

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

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/2

[Sysname-GigabitEthernet1/0/2] port link-aggregation group 3

reset counters interface

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

Syntax

reset counters interface [ { bridge-aggregation | route-aggregation } [ interface-number ] ]

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

bridge-aggregation: Specifies Layer 2 aggregate interfaces.

route-aggregation: Specifies Layer 3 aggregate interfaces.

interface-number: Specifies an aggregate interface number.

Usage guidelines

Use this command to clear history statistics before you collect traffic statistics for a time period.

If you do not specify any options, the command clears statistics for all interfaces in the system.

If you specify only the bridge-aggregation or route-aggregation keyword, the command clears statistics for all Layer 2 or Layer 3 aggregate interfaces.

If you specify the bridge-aggregation interface-number or route-aggregation interface-number option, the command clears statistics for the specified Layer 2 or Layer 3 aggregate interface.

The bridge-aggregation or route-aggregation keyword is available only when Layer 2 or Layer 3 aggregate interfaces exist on the device.

Examples

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

<Sysname> reset counters interface bridge-aggregation 1

reset lacp statistics

Use reset lacp statistics to clear LACP statistics for the specified link aggregation member ports.

Syntax

reset lacp statistics [ interface interface-list ]

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

interface interface-list: Specifies a list of link aggregation member ports, in the format interface-type interface-number [ to interface-type interface-number ]. interface-type interface-number specifies an interface by its type and number. If you do not specify any member ports, the command clears LACP statistics for all member ports.

Examples

# Clear LACP statistics for all link aggregation member ports.

<Sysname> reset lacp statistics

Related commands

display link-aggregation member-port

rpr reserve-vlan

Use rpr reserve-vlan to reserve a VLAN interface resource for a Layer 2 aggregate interface whose corresponding aggregation group uses RPR logical interfaces as member ports.

Use undo rpr reserve-vlan to restore the default.

Syntax

rpr reserve-vlan vlan vlan-id

undo rpr reserve-vlan

Default

No VLAN interface resource is reserved for a Layer 2 aggregate interface.

Views

Layer 2 aggregate interface view

Predefined user roles

network-admin

mdc-admin

Parameters

vlan vlan-id: Specifies a nonexistent VLAN ID in the range of 1 to 4094. VLAN ID 1 is not supported in the current software version.

Usage guidelines

You must reserve a VLAN interface resource for a Layer 2 aggregate interface after assigning RPR logical interfaces to the corresponding Layer 2 aggregation group. The reserved VLAN interface resource is used for traffic forwarding on the RPR logical interfaces.

After the resource of a VLAN interface is reserved, you cannot use the vlan and undo vlan commands to create and delete the VLAN.

If you execute this command multiple times, the most recent configuration takes effect.

Examples

# Reserve the resource of VLAN-interface 4094 for Layer 2 aggregate interface Bridge-Aggregation 1 whose aggregation group uses RPR logical interfaces as member ports.

<Sysname> system-view

[Sysname] interface Bridge-Aggregation 1

[Sysname-Bridge-Aggregation1] rpr reserve-vlan vlan 4094

shutdown

Use shutdown to shut down an aggregate interface.

Use undo shutdown to bring up an aggregate interface.

Syntax

shutdown

undo shutdown

Default

An aggregate interface is up.

Views

Layer 2 aggregate interface view, Layer 3 aggregate interface view

Predefined user roles

network-admin

mdc-admin

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

bandwidth

display link-aggregation verbose

interface bridge-aggregation

interface route-aggregation

lacp edge-port

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