TechLibrary

Navigation

Supported Platforms

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

Related Documentation

Additional Information
Junos OS Interfaces Fundamentals Configuration Guide

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. Collecting—Yes 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. Distributing—Yes 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.

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.
- Collecting—Yes 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.
- Distributing—Yes 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

TechLibrary

Supported Platforms

Related Documentation

show lacp interfaces

Syntax

Release Information

Description

Options

Required Privilege Level

Related Documentation

List of Sample Output

Output Fields

Sample Output

Published: 2013-01-23

Supported Platforms

Related Documentation

Published: 2013-01-23