Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

show lacp interfaces

 

Syntax

Release Information

Command introduced in Junos OS Release 7.6.

extensive statement introduced in Junos OS Release 16.1R1

Command introduced in Junos OS Release 10.0 for EX Series switches.

Command introduced in Junos OS Release 11.1 for the QFX Series.

Command introduced in Junos OS Release 14.1X53-D20 for the OCX Series.

Command introduced in Junos OS Release 14.2R3

Description

Display Link Aggregation Control Protocol (LACP) information about the specified aggregated Ethernet, Fast Ethernet, or Gigabit Ethernet interface.

Options

noneDisplay LACP information for all interfaces.
interface-name(Optional) Display LACP information for the specified interface:
  • Aggregated Ethernet—aenumber

  • Fast Ethernet—fe-fpc/pic/port

  • Gigabit Ethernet—ge-fpc/pic/port

  • 10 Gigabit Ethernet—xe-fpc/pic/port

extensiveDisplay LACP information for the interface in detail.
Note

The show lacp interfaces command returns the following error message if your system is not configured in either active or passive LACP mode:

“Warning: lacp subsystem not running – not needed by configuration”

Required Privilege Level

view

List of Sample Output

show lacp interfaces (Aggregated Ethernet)

show lacp interfaces (Gigabit Ethernet)

show lacp interfaces (10 Gigabit Ethernet)

Output Fields

Table 1 lists the output fields for the show lacp interfaces command. Output fields are listed in the approximate order in which they appear.

Table 1: show lacp interfaces Output Fields

Field Name

Field Description

Level of Output

LACP State

For a child interface configured with the force-up statement, LACP state displays FUP along with the interface name.

All Levels

Aggregated interface

Aggregated interface value.

All Levels

LACP State

LACP state information for each aggregated interface:

  • Role—Role played by the interface. It can be one of the following:

    • Actor—Local device participating in LACP negotiation.

    • Partner—Remote device participating in LACP negotiation.

  • Exp—Expired state. Yes indicates the actor or partner is in an expired state. No indicates the actor or partner is not in an expired state.

  • Def—Default. Yes indicates that the actor’s receive machine is using the default operational partner information, administratively configured for the partner. No indicates the operational partner information in use has been received in an LACP PDU.

  • Dist—Distribution of outgoing frames. No indicates distribution of outgoing frames on the link is currently disabled and is not expected to be enabled. Otherwise, the value is Yes.

  • Col—Collection of incoming frames. Yes indicates collection of incoming frames on the link is currently enabled and is not expected to be disabled. Otherwise, the value is No.

  • Syn—Synchronization. If the value is Yes, the link is considered synchronized. It has been allocated to the correct link aggregation group, the group has been associated with a compatible aggregator, and the identity of the link aggregation group is consistent with the system ID and operational key information transmitted. If the value is No, the link is not synchronized. It is currently not in the right aggregation.

  • Aggr—Ability of aggregation port to aggregate (Yes) or to operate only as an individual link (No).

  • Timeout—LACP timeout preference. Periodic transmissions of LACP PDUs occur at either a slow or fast transmission rate, depending upon the expressed LACP timeout preference (Long Timeout or Short Timeout).

  • Activity—Actor or partner’s port activity. Passive indicates the port’s preference for not transmitting LAC PDUs unless its partner’s control value is Active. Active indicates the port’s preference to participate in the protocol regardless of the partner’s control value.

  • Core isolation state down (CDN)— LACP interface state. Down indicates the LACP interface is down because all the eBGP sessions for Ethernet VPN (EVPN) are down.

All Levels

LACP Protocol

LACP protocol information for each aggregated interface:

  • Link state (active or standby) indicated in parentheses next to the interface when link protection is configured.

  • Receive State—One of the following values:

    • Current—The state machine receives an LACP PDU and enters the Current state.

    • Defaulted—If no LACP PDU is received before the timer for the Current state expires a second time, the state machine enters the Defaulted state.

    • Expired—If no LACP PDU is received before the timer for the Current state expires once, the state machine enters the Expired state.

    • Initialize—When the physical connectivity of a link changes or a Begin event occurs, the state machine enters the Initialize state.

    • LACP Disabled—If the port is operating in half duplex, the operation of LACP is disabled on the port, forcing the state to LACP Disabled. This state is similar to the Defaulted state, except that the port is forced to operate as an individual port.

    • Port Disabled—If the port becomes inoperable and a Begin event has not occurred, the state machine enters the Port Disabled state.

  • Transmit State—Transmit state of state machine. One of the following values:

    • Fast Periodic—Periodic transmissions are enabled at a fast transmission rate.

    • No Periodic—Periodic transmissions are disabled.

    • Periodic Timer—Transitory state entered when the periodic timer expires.

    • Slow Periodic—Periodic transmissions are enabled at a slow transmission rate.

  • Mux State—State of the multiplexer state machine for the aggregation port. The state is one of the following values:

    • Attached—Multiplexer state machine initiates the process of attaching the port to the selected aggregator.

    • CollectingYes indicates that the receive function of this link is enabled with respect to its participation in an aggregation. Received frames are passed to the aggregator for collection. No indicates the receive function of this link is not enabled.

    • Collecting Distributing—Collecting and distributing states are merged together to form a combined state (coupled control). Because independent control is not possible, the coupled control state machine does not wait for the partner to signal that collection has started before enabling both collection and distribution.

    • Detached—Process of detaching the port from the aggregator is in progress.

    • DistributingYes indicates that the transmit function of this link is enabled with respect to its participation in an aggregation. Frames may be passed down from the aggregator’s distribution function for transmission. No indicates the transmit function of this link is not enabled.

    • Waiting—Multiplexer state machine is in a holding process, awaiting an outcome.

All Levels

LACP info

  • Role can be one of the following:

    • Actor—Local device participating in LACP negotiation.

    • Partner—Remote device participating in LACP negotiation.

  • System priority—Priority assigned to the system (by management or administrative policy), encoded as an unsigned integer.

  • System identifier—Actor or partner system ID, encoded as a MAC address.

  • Port priority—Priority assigned to the port by the actor or partner (by management or administrative policy), encoded as an unsigned integer.

  • Port number—Port number assigned to the port by the actor or partner, encoded as an unsigned integer.

  • Port key—Operational key value assigned to the port by the actor or partner, encoded as an unsigned integer.

Extensive

Sample Output

show lacp interfaces (Aggregated Ethernet)

user@host> show lacp interfaces ae0 extensive

show lacp interfaces (Gigabit Ethernet)

user@host> show lacp interfaces ge-0/3/0

show lacp interfaces (10 Gigabit Ethernet)

user@host> show lacp interfaces xe-1/0/2