LACP Commands

This chapter contains the following sections:

lacp port-priority

To set the physical port priority, use the lacp port-priority Interface (Ethernet) Configuration mode command. To restore the default configuration, use the no form of this command.

Syntax

lacp port-priority value

no lacp port-priority

Parameters

value—Specifies the port priority. (Range: 1–65535)

Default Configuration

The default port priority is 1.

Command Mode

Interface (Ethernet) Configuration mode

Example

The following example sets the priority of gi1/0/6.

switchxxxxxx(config)#  interface gi1/0/6
switchxxxxxx(config-if)#  lacp port-priority 247

lacp system-priority

To set the system priority, use the lacp system-priority Global Configuration mode command. To restore the default configuration, use the no form of this command.

Syntax

lacp system-priority value

no lacp system-priority

Parameters

value—Specifies the system priority value. (Range: 1–65535)

Default Configuration

The default system priority is 1.

Command Mode

Global Configuration mode

Example

The following example sets the system priority to 120.

switchxxxxxx(config)#  lacp system-priority 120

lacp timeout

To assign an administrative LACP timeout to an interface, use the lacp timeout Interface (Ethernet) Configuration mode command. To restore the default configuration, use the no form of this command.

Syntax

lacp timeout {long | short}

no lacp timeout

Parameters

  • long—Specifies the long timeout value.

  • short—Specifies the short timeout value.

Default Configuration

The default port timeout value is Long.

Command Mode

Interface (Ethernet) Configuration mode

Example

The following example assigns a long administrative LACP timeout to gi1/0/6.

switchxxxxxx(config)#  interface gi1/0/6
switchxxxxxx(config-if)#  lacp timeout long

show lacp

To display LACP information for all Ethernet ports or for a specific Ethernet port, use the show lacp Privileged EXEC mode command.

Syntax

show lacp interface-id [parameters | statistics | protocol-state]

Parameters

  • interface-id—Specify an interface ID. The interface ID must be an Ethernet port

  • parameters—(Optional) Displays parameters only.

  • statistics—(Optional) Displays statistics only.

  • protocol-state—(Optional) Displays protocol state only.

Command Mode

Privileged EXEC mode

Example

The following example displays LACP information for gi1/0/1.

switchxxxxxx#  show lacp ethernet gi1/0/1

Port gi1/0/1 LACP parameters:

Actor

system priority:
system mac addr:
port Admin key:
port Oper key:
port Oper number:
port Admin priority:
port Oper priority:
port Admin timeout:
port Oper timeout:
LACP Activity:
Aggregation:
synchronization:
collecting:
distributing:
expired:

1
00:00:12:34:56:78
30
30
21
1
1
LONG
LONG
ACTIVE
AGGREGATABLE
FALSE
FALSE
FALSE
FALSE

Partner

system priority:
system mac addr:
port Admin key:
port Oper key:
port Oper number:
port Admin priority:
port Oper priority:
port Admin timeout:
port Oper timeout:
LACP Activity:
Aggregation:
synchronization:
collecting:
distributing:
expired:

0
00:00:00:00:00:00
0
0
0
0
0
LONG
LONG
PASSIVE
AGGREGATABLE
FALSE
FALSE
FALSE
FALSE

Port gi1/0/1 LACP Statistics:
LACP PDUs sent:
LACP PDUs received:

2
2

Port gi1/0/1 LACP Protocol State:

LACP State Machines:

Receive FSM:
Mux FSM:

Port Disabled State
Detached State

Control Variables:

BEGIN:
LACP_Enabled:
Ready_N:
Selected:
Port_moved:
NNT:
Port_enabled:

FALSE
TRUE
FALSE
UNSELECTED
FALSE
FALSE
FALSE

Timer counters:

periodic tx timer:
current while timer:
wait while timer:

0
0
0

show lacp port-channel

To display LACP information for a port-channel, use the show lacp port-channel Privileged EXEC mode command.

Syntax

show lacp port-channel [port_channel_number]

Parameters

port_channel_number—(Optional) Specifies the port-channel number.

Command Mode

Privileged EXEC mode

Example

The following example displays LACP information about port-channel 1.

switchxxxxxx#  show lacp port-channel 1

Port-Channel 1:Port Type 1000 Ethernet

Actor

System Priority:
MAC Address:
Admin Key:
Oper Key:

1
000285:0E1C00
29
29

Partner

System Priority:
MAC Address:
Oper Key:

0
00:00:00:00:00:00
14