Previous Topic

Next Topic

Book Contents

Port-Channel/LAG (802.3ad) Commands

This section describes the commands you use to configure port-channels, which are also known as link aggregation groups (LAGs). Link aggregation allows you to combine multiple full-duplex Ethernet links into a single logical link. Network devices treat the aggregation as if it were a single link, which increases fault tolerance and provides load sharing. The LAG feature initially load shares traffic based upon the source and destination MAC address.Assign the port-channel (LAG) VLAN membership after you create a port-channel. If you do not assign VLAN membership, the port-channel might become a member of the management VLAN which can result in learning and switching issues.

A port-channel (LAG) interface can be either static or dynamic, but not both. All members of a port channel must participate in the same protocols.) A static port-channel interface does not require a partner system to be able to aggregate its member ports.

NOTE: If you configure the maximum number of dynamic port-channels (LAGs) that your platform supports, additional port-channels that you configure are automatically static.

port-channel

This command configures a new port-channel (LAG) and generates a logical unit/slot/port number for the port-channel. The <name> field is a character string which allows the dash “-” character as well as alphanumeric characters. Use the show port channel command to display the unit/slot/port number for the logical interface. Before you include a port in a port-channel, set the port physical mode.

no port-channel

This command deletes a port-channel (LAG).

addport

This command adds one port to the port-channel (LAG). The first interface is a logical unit/slot/port number of a configured port-channel. Before adding a port to a port-channel, set the physical mode of the port. For more information, see “speed”.

deleteport (Interface Config)

This command deletes the port from the port-channel (LAG). The interface is a logical unit/slot/port number of a configured port-channel.

deleteport (Global Config)

This command deletes all configured ports from the port-channel (LAG). The interface is a logical unit/slot/port number of a configured port-channel. To clear the port channels, see “clear port-channel”

lacp admin key

Use this command to configure the administrative value of the key for the port-channel. The value range of <key> is 0 to 65535. This command can be used to configure a single interface or a range of interfaces.

NOTE: This command is applicable only to port-channel interfaces.

no lacp admin key

Use this command to configure the default administrative value of the key for the port-channel.

lacp collector max-delay

Use this command to configure the port-channel collector max delay. This command can be used to configure a single interface or a range of interfaces.The valid range of <delay> is 0-65535.

NOTE: This command is applicable only to port-channel interfaces.

no lacp collector max delay

Use this command to configure the default port-channel collector max delay.

lacp actor admin

Use this command to configure the LACP actor admin parameters.

lacp actor admin key

Use this command to configure the administrative value of the LACP actor admin key on an interface or range of interfaces. The valid range for <key> is 0-65535.

NOTE: This command is applicable only to physical interfaces.

no lacp actor admin key

Use this command to configure the default administrative value of the key.

lacp actor admin state

Use this command to configure the administrative value of actor state as transmitted by the Actor in LACPDUs. The valid value range is 0x00-0xFF. This command can be used to configure a single interfaces or a range of interfaces.

NOTE: This command is applicable only to physical interfaces.

no lacp actor admin state

Use this command to configure the default administrative values of actor state as transmitted by the Actor in LACPDUs.

lacp actor admin state individual

Use this command to set LACP actor admin state to individual.

NOTE: This command is applicable only to physical interfaces.

no lacp actor admin state individual

Use this command to set the LACP actor admin state to aggregation.

lacp actor admin state longtimeout

Use this command to set LACP actor admin state to longtimeout.

NOTE: This command is applicable only to physical interfaces.

no lacp actor admin state longtimeout

Use this command to set the LACP actor admin state to short timeout.

NOTE: This command is applicable only to physical interfaces.

lacp actor admin state passive

Use this command to set the LACP actor admin state to passive.

NOTE: This command is applicable only to physical interfaces.

no lacp actor admin state passive

Use this command to set the LACP actor admin state to active.

lacp actor port

Use this command to configure LACP actor port priority key.

lacp actor port priority

Use this command to configure the priority value assigned to the Aggregation Port for an interface or range of interfaces. The valid range for <priority> is 0 to 255.

NOTE: This command is applicable only to physical interfaces.

no lacp actor port priority

Use this command to configure the default priority value assigned to the Aggregation Port.

lacp partner admin key

Use this command to configure the administrative value of the Key for the protocol partner. This command can be used to configure a single interface or a range of interfaces. The valid range for <key> is 0 to 65535.

NOTE: This command is applicable only to physical interfaces.

no lacp partner admin key

Use this command to set the administrative value of the Key for the protocol partner to the default.

lacp partner admin state

Use this command to configure the current administrative value of actor state for the protocol Partner. The valid value range is 0x00-0xFF.

NOTE: This command is applicable only to physical interfaces.

no lacp partner admin state

Use this command to configure the default current administrative value of actor state for the protocol partner. This command can be used to configure a single interface or a range of interfaces.

lacp partner admin state individual

Use this command to set LACP partner admin state to individual

NOTE: This command is applicable only to physical interfaces

no lacp partner admin state individual

Use this command to set the LACP partner admin state to aggregation.

lacp partner admin state longtimeout

Use this command to set LACP partner admin state to longtimeout.

NOTE: This command is applicable only to physical interfaces.

no lacp partner admin state longtimeout

Use this command to set the LACP partner admin state to short timeout.

NOTE: This command is applicable only to physical interfaces.

lacp partner admin state passive

Use this command to set the LACP partner admin state to passive.

NOTE: This command is applicable only to physical interfaces.

no lacp partner admin state passive

Use this command to set the LACP partner admin state to active.

lacp partner port id

Use this command to configure the LACP partner port id. This command can be used to configure a single interface or a range of interfaces. The valid range for <port-id> is 0 to 65535.

NOTE: This command is applicable only to physical interfaces.

no lacp partner port id

Use this command to set the LACP partner port id to the default.

lacp partner port priority

Use this command to configure the LACP partner port priority. This command can be used to configure a single interface or a range of interfaces. The valid range for <priority> is 0 to 255.

NOTE: This command is applicable only to physical interfaces.

no lacp partner port priority

Use this command to configure the default LACP partner port priority.

lacp partner system-id

Use this command to configure the 6-octet MAC Address value representing the administrative value of the Aggregation Port's protocol Partner's System ID. This command can be used to configure a single interface or a range of interfaces. The valid range of <system-id> is 00:00:00:00:00:00 - FF:FF:FF:FF:FF.

NOTE: This command is applicable only to physical interfaces.

no lacp partner system-id

Use this command to configure the default value representing the administrative value of the Aggregation Port’s protocol Partner’s System ID.

lacp partner system priority

Use this command to configure the administrative value of the priority associated with the Partner's System ID. This command can be used to configure a single interface or a range of interfaces. The valid range for <priority> is 0 to 65535.

NOTE: This command is applicable only to physical interfaces.

no lacp partner system priority

Use this command to configure the default administrative value of priority associated with the Partner’s System ID.

port-channel static

This command enables the static mode on a port-channel (LAG) interfaces only. By default the static mode for a new port-channel is enabled, which means the port-channel is static. If the maximum number of allowable dynamic port-channels are already present in the system, the static mode for a new port-channel is enabled, which means the port-channel is static. You can only use this command on port-channel interfaces.

no port-channel static

This command sets the static mode on a particular port-channel (LAG) interface to the default value. This command will be executed only for interfaces of type port-channel (LAG).

port lacpmode

This command enables Link Aggregation Control Protocol (LACP) on a port.

no port lacpmode

This command disables Link Aggregation Control Protocol (LACP) on a port.

port lacpmode enable all

This command enables Link Aggregation Control Protocol (LACP) on all ports.

no port lacpmode enable all

This command disables Link Aggregation Control Protocol (LACP) on all ports.

port lacptimeout (Interface Config)

This command sets the timeout on a physical interface of a particular device type (actor or partner) to either long or short timeout.

no port lacptimeout

This command sets the timeout back to its default value on a physical interface of a particular device type (actor or partner).

port lacptimeout (Global Config)

This command sets the timeout for all interfaces of a particular device type (actor or partner) to either long or short timeout.

no port lacptimeout

This command sets the timeout for all physical interfaces of a particular device type (actor or partner) back to their default values.

port-channel adminmode

This command enables a port-channel (LAG). The option all sets every configured portchannel with the same administrative mode setting.

no port-channel adminmode

This command disables a port-channel (LAG). The option all sets every configured portchannel with the same administrative mode setting.

port-channel linktrap

This command enables link trap notifications for the port-channel (LAG). The interface is a logical <unit/slot/port> for a configured port-channel. The option all sets every configured port-channel with the same administrative mode setting.

no port-channel linktrap

This command disables link trap notifications for the port-channel (LAG). The interface is a logical slot and port for a configured port-channel. The option all sets every configured port-channel with the same administrative mode setting.

port-channel load-balance

This command selects the load-balancing option used on a port-channel (LAG). Traffic is balanced on a portchannel (LAG) by selecting one of the links in the channel over which to transmit specific packets. The link is selected by creating a binary pattern from selected fields in a packet, and associating that pattern with a particular link.

Load-balancing is not supported on every device. The range of options for load-balancing may vary per device.

This command can be configured for a single interface, a range of interfaces, or all interfaces.

no port-channel load-balance

This command reverts to the default load balancing configuration

port-channel name

This command defines a name for the port-channel (LAG). The interface is a logical unit/slot/port for a configured port-channel, and <name> is an alphanumeric string up to 15 characters.

port-channel system priority

Use this command to configure port-channel system priority. The valid range of priority is <0-65535>.

no port-channel system priority

Use this command to configure the default port-channel system priority value.

show lacp actor

Use this command to display LACP actor attributes.

The display parameters for above command are:

show lacp partner

Use this command to display LACP partner attributes.

The display parameters for above command are:

show port-channel brief

This command displays the static capability of all port-channel (LAG) interfaces on the device as well as a summary of individual port-channel interfaces.

The display parameters for above command are:

show port-channel

This command displays an overview of all port-channels (LAGs) on the switch.

The display parameters for above command are:

show port-channel system priority

Use this command to display the port-channel system priority.

See also

Switching Commands

Port Configuration Commands

Spanning Tree Protocol (STP) Commands

VLAN Commands

Private VLAN Commands

Ethernet Ring Protection Commands

Double VLAN Commands

Voice VLAN Commands

Provider Bridge Commands

802.1AS Timesync Commands

Provisioning (IEEE 802.1p) Commands

Protected Ports Commands

GARP Commands

GVRP Commands

GMRP Commands

Port-Based Network Access Control Commands

Switch Port Auto-recovery (SPAR) Commands

802.1X Supplicant Commands

Storm-Control Commands

Link Local Protocol Filtering Commands

MMRP Commands

MSRP Commands

MVRP Commands

Port Mirroring

Static MAC Filtering

DHCP L2 Relay Agent Comamnds

DHCP Client Commands

DHCP Snooping Configuration Commands

Dynamic ARP Inspection Commands

IGMP Snooping Configuration Commands

IGMP Snooping Querier Commands

MLD Snooping Commands

MLD Snooping Querier Commands

Port Security Commands

LLDP (802.1AB) Commands

LLDP-MED Commands

Denial of Service Commands

MAC Database Commands

ISDP Commands

Ethernet in the First Mile Operations and Maintenance Commands

Connectivity Fault Management Commands