LACP Commands

This chapter contains the following sections:

lacp port-priority

To set the Link Aggregation Control Protocol (LACP) priority for an interface, use the lacp port-priority Interface Configuration mode command.

To revert to its default setting, use the no form of this command.

Syntax

lacp port-priority VALUE

no lacp port-priority

Parameters

VALUE—The LACP priority value for an interface. (Range: 1 to 65535)

Default Configuration

The default LACP port priority is 1.

Command Mode

Interface Configuration (Ethernet) mode

Example

switchxxxxxx(config)# interface gi6
switchxxxxxx(config-if)# lacp port-priority 247

lacp system-priority

To set the global LACP priority for all interfaces, use the lacp system-priority Global Configuration mode command.

To revert to its default setting, use the no form of this command.

Syntax

lacp system-priority VALUE

no lacp system-priority

Parameters

VALUE—The LACP priority value for all interfaces. (Range: 1 to 65535)

Default Configuration

The default LACP system priority is 32768.

Command Mode

Global Configuration mode

Example

switchxxxxxx(config)# lacp system-priority 120

lacp timeout

To assign an administrative LACP timeout to an interface, use the lacp timeout Interface Configuration mode command.

Syntax

lacp timeout {long | short}

Parameters

long—Specifies that the periodic transmissions of LACP PDUs occur at a slow transmission rate.

short—Specifies that the periodic transmissions of LACP PDUs occur at a fast transmission rate.

Default Configuration

The default timeout is long.

Command Mode

Interface Configuration (Ethernet) mode

Example

The following example assigns a long administrative LACP timeout to fa6:

switchxxxxxx(config)# interface gi6
switchxxxxxx(config-if)# lacp timeout long

show lacp

To show LACP channel-group information, use the show lacp Privileged EXEC mode command.

Syntax

show lacp sys-id

show lacp [channel-group-number] counters

show lacp [channel-group-number] {internal | neighbor} [detail]

Parameters

sys-id—Displays the system identifier that is being used by LACP. The system identifier is made up of the LAPC system priority and the switch MAC address.

channel-group-number—(Optional) Number of the channel group. The range is 1 to 8.

counters—Displays traffic information.

internal—Displays internal information.

neighbor—Displays neighbor information.

detail—(Optional) Displays detailed information.

Command Mode

Privileged EXEC Mode

User Guidelines

You can enter any show lacp command to display the active channel-group information.

To show information for a specific channel, enter the show lacp command with a channel-group number. If you do not specify a channel group, information for all channel groups appears.

You can enter the channel-group-number option to specify a channel group for all keywords except sys-id.

Examples

Example 1—The following example shows the LACP statistics:

switchxxxxxx# show lacp counters
             LACPDUs       LACPDUs
Port       Sent   Recv     Pkts Err
---------------------------------------
Channel group 1
fa1        5      3        0
fa2        8      0        0
Channel group 2
fa3        3      5        0
fa4        0      0        0

The following table describes the significant fields shown in the example:

Field

Description

Port

Port identifier.

LACPDUs Sent and Recv

Number of LACP packets sent and received by a port.

LACPDUs Pkts and Err

Number of unknown and illegal packets received by LACP for a port.

Example 2—The following example shows the LACP internal information:

switchxxxxxx# show lacp internal
Flags:  S - Device is requesting Slow LACPDUs
        F - Device is requesting Fast LACPDUs
        A - Device is in Active mode        P - Device is in Passive mode
Channel group 1
                            LACP port     Admin     Oper    Port        Port
Port      Flags   State     Priority      Key       Key     Number      State
fa1       SA      bndl      1             0x3e8     0x3e8   0x1         0x3d
fa2       SA      down      1             0x3e8     0x3e8   0x2         0x45
Channel group 2
                            LACP port     Admin     Oper    Port        Port
Port      Flags   State     Priority      Key       Key     Number      State
fa3       SA      bndl      1             0x3e9     0x3e9   0x3         0x3d
fa4       SA      down      1             0x3e9     0x3e9   0x4         0x45

The following table describes the significant fields shown in the example:

Field

Description

State

State of the specific port. The available values are:

  • bndl—Port is attached to an aggregator and bundled with other ports.

  • susp—Port is in a suspended state; it is not attached to any aggregator.

  • hot-sby—Port is in a hot-standby state.

  • 1indiv—Port is incapable of bundling with any other port.

  • 1indep—Port is in an independent state (not bundled but able to switch data traffic. In this case, LACP is not running on the partner port).

  • down—Port is down.

LACP Port Priority

Port priority setting. LACP uses the port priority to put ports in standby mode when there is a hardware limitation that prevents all compatible ports from aggregating.

Admin Key

Administrative key assigned to this port. LACP automatically generates an administrative key value as a hexadecimal number. The administrative key defines the ability of a port to aggregate with other ports. A port’s ability to aggregate with other ports is determined by the port physical characteristics (for example, data rate and duplex capability) and configuration restrictions that you establish.

Oper Key

Runtime operational key that is being used by this port. LACP automatically generates this value as a hexadecimal number.

Port Number

Port identifier.

Port State

State variables for the port, encoded as individual bits within a single octet with these meanings:

  • bit0—LACP_Activity

  • bit1—LACP_Timeout

  • bit2—Aggregation

  • bit3—Synchronization

  • bit4—Collecting

  • bit5—Distributing

  • bit6—Defaulted

  • bit7—Expired

    In the list above, bit7 is the MSB and bit0 is the LSB.

Example 3—The following example shows the LACP neighbor details:

switchxxxxxx# show lacp neighbor detail
Flags:  S - Device is requesting Slow LACPDUs
        F - Device is requesting Fast LACPDUs
        A - Device is in Active mode        P - Device is in Passive mode
Channel group 1
Partner's information
          Partner               Partner                     Partner
Port      System ID             Port Number     Age         Flags
gi13      32768, 00e0.4c86.7001 0x1             90s         SA
          LACP Partner         Partner         Partner
          Port Priority        Oper Key        Port State
          1                    0x3e8           0x3d
          Port State Flags Decode:
          Activity:   Timeout:   Aggregation:   Synchronization:
          Active      Long       Yes            Yes
          Collecting:   Distributing:   Defaulted:   Expired:
          Yes           Yes             No            No
          Partner               Partner                     Partner
Port      System ID             Port Number     Age         Flags
gi14      32768, 00e0.4c86.7001 0x2             63s         SA
          LACP Partner         Partner         Partner
          Port Priority        Oper Key        Port State
          1                    0x3e8           0x3d
          Port State Flags Decode:
          Activity:   Timeout:   Aggregation:   Synchronization:
          Active      Long       Yes            Yes
          Collecting:   Distributing:   Defaulted:   Expired:
          Yes           Yes             No            No
          Partner               Partner                     Partner
Port      System ID             Port Number     Age         Flags
gi15      32768, 00e0.4c86.7001 0x3             90s         SA
          LACP Partner         Partner         Partner
          Port Priority        Oper Key        Port State
          1                    0x3e8           0x3d
          Port State Flags Decode:
          Activity:   Timeout:   Aggregation:   Synchronization:
          Active      Long       Yes            Yes
          Collecting:   Distributing:   Defaulted:   Expired:
          Yes           Yes             No            No

Example 4—The following example shows the LACP system identifier information:

switchxxxxxx# show lacp sys-id
32768, 00e0.4c86.7001

The system identification is made up of the system priority and the system MAC address. The first two bytes are the system priority, and the last six bytes are the globally administered individual MAC address associated to the system.