Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation
Guide That Contains This Content
[+] Expand All
[-] Collapse All

    show lacp interfaces

    Syntax

    show lacp interfaces<interface-name>

    Release Information

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

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

    Description

    Display Link Aggregation Control Protocol (LACP) information about the specified aggregated 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—aex
    • Gigabit Ethernet—ge-fpc/pic/port
    • 10-Gigabit Ethernet—xe-fpc/pic/port

    Required Privilege Level

    view

    List of Sample Output

    show lacp interfaces (EX Series Switches)
    show lacp interfaces (QFX Series)

    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 Ethernet interface name.

    LACP State

    LACP state information for each aggregated Ethernet interface:

    • For a child interface configured with the force-up statement, LACP state displays FUP along with the interface name.
    • Role—Role played by the interface. It can be one of the following:
      • Actor—Local device participating in the LACP negotiation.
      • Partner—Remote device participating in the LACP negotiation.
    • Exp—Expired state. Yes indicates that the actor or partner is in an expired state. No indicates that 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, which is administratively configured for the partner. No indicates that the operational partner information in use has been received in an LACP PDU.
    • Dist—Distribution of outgoing frames. No indicates that the 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 that the 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 to be synchronized. The link 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. The link is currently not in the right aggregation.
    • Aggr—Ability of the 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 a fast transmission rate, depending upon the expressed LACP timeout preference (Long Timeout or Short Timeout).
    • Activity—Actor’s 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 the state machine. The transmit state is 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—The 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 can be passed down from the aggregator’s distribution function for transmission. No indicates the transmit function of this link is not enabled.
      • Waiting—The multiplexer state machine is in a holding process, awaiting an outcome.

    Sample Output

    show lacp interfaces (EX Series Switches)

    user@switch> show lacp interfaces ae5
    Aggregated interface: ae5
        LACP state:       Role   Exp   Def  Dist  Col  Syn  Aggr  Timeout  Activity
          xe-2/0/7       Actor    No    No   Yes  Yes  Yes   Yes     Fast    Active
          xe-2/0/7     Partner    No    No   Yes  Yes  Yes   Yes     Fast    Passive
          xe-4/0/7       Actor    No    No    No   No   No   Yes     Fast    Active
          xe-4/0/7     Partner    No    No    No  Yes  Yes   Yes     Fast    Passive
        
    LACP protocol: Receive State Transmit State Mux State xe-2/0/7(Active) Current Fast periodic Collecting distributing xe-34/0/7(Standby) Current Fast periodic Waiting

    show lacp interfaces (QFX Series)

    user@switch> show lacp interfaces nodegroup1:ae0 extensive
     Aggregated interface: nodegroup1:ae0
        LACP state:       Role   Exp   Def  Dist  Col  Syn  Aggr  Timeout    Activity
          node1:xe-0/0/1FUP    Actor    No   Yes    No   No   No   Yes     Fast      Active
          node1xe-0/0/1FUP  Partner    No   Yes    No   No   No   Yes     Fast      Passive
          node2:xe-0/0/2       Actor    No   Yes    No   No   No   Yes     Fast      Active
          node2:xe-0/0/2     Partner    No   Yes    No   No   No   Yes     Fast      Passive
              LACP protocol:             Receive State    Transmit State      Mux State
          node1:xe-0/0/1FUP             Current       Fast periodic      Collecting distributing
          node2:xe-0/0/2                Current       Fast periodic      Collecting distributing 
          node1:xe-0/0/1 (active)       Current       Fast periodic      Collecting distributing
          node2:xe-0/0/2 (standby)      Current       Fast periodic      WAITING 
        
    

    Published: 2013-01-23