Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation

show lacp interfaces

Syntax

show lacp interfaces<interface-name>

Release Information

Command introduced in Junos OS Release 7.6.

Description

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

Options

none

Display 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

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)

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

Aggregated interface

Aggregated interface value.

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.

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.

LACP Statistics

LACP statistics are returned when the extensive option is used and provides the following information:

  • LACP Rx—LACP received counter that increments for each normal hello.
  • LACP Tx—Number of LACP transmit packet errors logged.
  • Unknown Rx—Number of unrecognized packet errors logged.
  • Illegal Rx—Number of invalid packets received.

Sample Output

show lacp interfaces (Aggregated Ethernet)

user@host> show lacp interfaces ae0 extensive
 Aggregated interface: ae0
    LACP state:       Role   Exp   Def  Dist  Col  Syn  Aggr  Timeout    Activity
      ge-1/0/1       Actor    No   Yes    No   No   No   Yes     Fast      Active
      ge-1/0/1     Partner    No   Yes    No   No   No   Yes     Fast      Passive
      ge-1/0/2       Actor    No   Yes    No   No   No   Yes     Fast      Active
      ge-1/0/2     Partner    No   Yes    No   No   No   Yes     Fast      Passive
    LACP protocol:        Receive State    Transmit State      Mux State
      ge-1/0/1                CURRENT       Fast periodic      Collecting distributing
      ge-1/0/2                CURRENT       Fast periodic      Collecting distributing 
      ge-1/0/1 (active)       CURRENT       Fast periodic      Collecting distributing
      ge-1/0/2 (standby)      CURRENT       Fast periodic      WAITING 
    LACP Statistics:       LACP Rx     LACP Tx   Unknown Rx   Illegal Rx
      ge-1/0/1                   0           0            0   0
      ge-1/0/2                   0           0            0   0

show lacp interfaces (Gigabit Ethernet)

user@host> show lacp interfaces ge-0/3/0
Aggregated interface: ae0
    LACP State:       Role   Exp   Def  Dist  Col  Syn  Aggr  Timeout  Activity
      ge-0/3/0       Actor    No    No   Yes  Yes  Yes   Yes     Fast    Active
      ge-0/3/0     Partner    No    No   Yes  Yes  Yes   Yes     Fast    Active
    LACP Protocol:   Receive State    Transmit State           Mux State
      ge-0/3/0             Current     Fast periodic  Collecting distributing

Published: 2013-08-29

Published: 2013-08-29