Show LAG Commands

lag

Syntax

lag [lag-id] [detail] [statistics]

lag lag-id associations

lag lag-id bfd

lag [lag-id] description

lag lag-id [detail] lacp-partner

lag [lag-id] port

Context

show

Description

This command displays Link Aggregation Group (LAG) information.

If no command line options are specified, a summary listing of all LAGs is displayed.

Parameters

lag-id

displays information only on the specified LAG

Values

1 to 32

detail

displays detailed LAG information

Default

displays summary LAG information

statistics

displays LAG statistics information

associations

displays a list of current router interfaces with which the LAG is associated

bfd

displays LAG BFD information

description

displays a list of all LAGs and LAG ports and their descriptions

lacp-partner

displays information about the LACP partner (detail keyword provides detailed information)

port

displays information about the specified LAG port or all LAG ports

Output

The following outputs are examples of LAG information:

Output Example
*A:ALU-1># show lag
===============================================================================
Lag Data
===============================================================================
Lag-id         Adm     Opr     Port-Threshold   Up-Link-Count   MC Act/Stdby
-------------------------------------------------------------------------------
1              up      down    0                0               N/A
2              up      down    1                0               N/A
3              up      up      0                1               N/A
-------------------------------------------------------------------------------
Total Lag-ids: 3       Single Chassis: 3        MC Act: 0       MC Stdby: 0
===============================================================================
*A:ALU-1>#
Table: LAG Summary Field Descriptions

Label

Description

Lag-id

The LAG identifier

Adm

Up: the LAG is administratively up

Down: the LAG is administratively down

Opr

Up: the LAG is operationally up

Down: the LAG is operationally down

Port-Threshold

The number of operational links at or below which the LAG is considered to be operationally down

Up-Link-Count

The number of ports that are physically present and have physical links present

MC Act/Stdby

N/A

Output Example
*A:ALU-1># show lag 2 detail
===============================================================================
LAG Details
===============================================================================
Description        : LAG2
-------------------------------------------------------------------------------
Details
-------------------------------------------------------------------------------
Lag-id              : 2                     Mode                 : access
Adm                 : up                    Opr                  : down
Thres. Exceeded Cnt : 0                     Port Threshold       : 1
Thres. Last Cleared : 08/19/2011 14:35:28   Threshold Action     : down
Dynamic Cost        : false                 Encap Type           : null
Configured Address  : 2001:db8::            Lag-IfIndex          : 1342177282
Hardware Address    : 2001:db8::52:0:1      Adapt Qos            : N/A
Hold-time Down      : 0.0 sec               Port Type            : standard
LACP                : enabled               Mode                 : active
LACP Transmit Intvl : fast                  LACP xmit stdby      : enabled
Selection Criteria  : highest-count         Slave-to-partner     : disabled
Number of sub-groups: 2                     Forced               : -
System Id           : a4:58:ff:00:00:00     System Priority      : 32768
Admin Key           : 32769                 Oper Key             : 32769
Prtr System Id      :                       Prtr System Priority : 0
Prtr Oper Key       : 0
-------------------------------------------------------------------------------
Port-id        Adm     Act/Stdby Opr     Primary   Sub-group     Forced  Prio
-------------------------------------------------------------------------------
1/4/3          up      active    down    yes       1             -       1
1/5/3          up      standby   down              2             -       2
-------------------------------------------------------------------------------
Port-id        Role      Exp   Def   Dist  Col   Syn   Aggr  Timeout  Activity
-------------------------------------------------------------------------------
1/4/3          actor     Yes   Yes   No    No    No    Yes   Yes      Yes
1/4/3          partner   Yes   Yes   No    No    No    No    Yes      No
1/5/3          actor     Yes   Yes   No    No    No    Yes   Yes      Yes
1/5/3          partner   Yes   Yes   No    No    No    No    Yes      No
===============================================================================
*A:ALU-1>#

The following example displays LAG details with MC-LAG output

*A:ALU-1># show lag 2 detail
===============================================================================
LAG Details
===============================================================================
Description        : LAG2
-------------------------------------------------------------------------------
Details
-------------------------------------------------------------------------------
Lag-id              : 2                     Mode                 : access
Adm                 : up                    Opr                  : down
Thres. Exceeded Cnt : 0                     Port Threshold       : 1
Thres. Last Cleared : 08/19/2011 14:35:28   Threshold Action     : down
Dynamic Cost        : false                 Encap Type           : null
Configured Address  : 2001:db8::            Lag-IfIndex          : 1342177282
Hardware Address    : 2001:db8::52:0:1      Adapt Qos            : N/A
Hold-time Down      : 0.0 sec               Port Type            : standard
LACP                : enabled               Mode                 : active
LACP Transmit Intvl : fast                  LACP xmit stdby      : enabled
Selection Criteria  : highest-count         Slave-to-partner     : disabled
Number of sub-groups: 2                     Forced               : -
System Id           : a4:58:ff:00:00:00     System Priority      : 32768
Admin Key           : 32769                 Oper Key             : 32769
Prtr System Id      :                       Prtr System Priority : 0
Prtr Oper Key       : 0
 
MC Peer Address     : 10.10.10.4            MC Peer Lag-id       : 1
MC System ID        : 11.11.11.11:11:11     MC System Priority   : 3
MC Admin Key        : 12                    MC Active/Standby    : active
MC Lacp ID in use   : true                  MC extended timeout  : false
MC Selection Logic  : peer timed out, selected local subgroup   
MC Config Mismatch  : no mismatch   
-------------------------------------------------------------------------------
Port-id        Adm     Act/Stdby Opr     Primary   Sub-group     Forced  Prio
-------------------------------------------------------------------------------
1/4/3          up      active    down    yes       1             -       1
1/5/3          up      standby   down              2             -       2
-------------------------------------------------------------------------------
Port-id        Role      Exp   Def   Dist  Col   Syn   Aggr  Timeout  Activity
-------------------------------------------------------------------------------
1/4/3          actor     Yes   Yes   No    No    No    Yes   Yes      Yes
1/4/3          partner   Yes   Yes   No    No    No    No    Yes      No
1/5/3          actor     Yes   Yes   No    No    No    Yes   Yes      Yes
1/5/3          partner   Yes   Yes   No    No    No    No    Yes      No
===============================================================================
*A:ALU-1>#
Table: LAG Detailed Field Descriptions

Label

Description

Lag-id

The LAG identifier

Mode

The mode of the LAG: access or network

Adm

Up: the LAG is administratively up

Down: the LAG is administratively down

Opr

Up: the LAG is operationally up

Down: the LAG is operationally down

Thres. Exceeded Cnt

The number of times that the drop count was reached

Port Threshold

The number of operational links at or below which the LAG is regarded as operationally down

Thres. Last Cleared

The last time that keepalive statistics were cleared

Threshold Action

Action to take when the number of operational links is equal to or below the port threshold

Dynamic Cost

n/a

Encap Type

The encapsulation method used to distinguish customer traffic on a LAG

Configured Address

The base chassis Ethernet MAC address

Lag-IfIndex

A unique number assigned to this interface

Hardware Address

The hardware address

Adapt Qos

The configured QoS mode

Hold-time Down

The hold-time, in tenths of seconds, before a failure is reported to higher levels

Port Type

Standard: standard Ethernet port types are supported

LACP

Enabled: LACP is enabled

Disabled: LACP is disabled

Mode

Active: LACP operates in active mode

Passive: LACP operates in passive mode

Role

Actor: local device (7705 SAR) participating in LACP negotiation

Partner: remote device participating in LACP negotiation

LACP Transmit Intvl

LACP timeout signaled to peer

LACP xmit stdby

LACP transmit on standby links enabled or disabled

Selection Criteria

Configured subgroup selection criteria

Slave-to-partner

Slave-to-partner flag enabled or disabled

Number of sub-groups

Total subgroups in LAG

Forced

n/a

System Id

System ID used by actor in LACP messages

System Priority

System priority used by actor in LACP messages

Admin Key

Configured LAG key

Oper Key

Key used by actor in LACP messages

Prtr System Id

System ID used by partner in LACP messages

Prtr System Priority

System priority used by partner in LACP messages

Prtr Oper Key

Key used by partner in LACP messages

MC Peer Address

IP address of the MC-LAG peer

MC Peer Lag-id

The LAG identifier of the MC-LAG peer

MC System Id

System ID used by the MC-LAG actor in LACP messages

MC System Priority

System priority used by the MC-LAG actor in LACP messages

MC Admin Key

Configured MC-LAG key

MC Active/Standby

Indicates whether the port is in active or standby mode

MC Lacp ID in use

Indicates whether MC-LAG values such as system-id, system priority, and lacp-key are advertised to the LACP peer

MC extended timeout

Indicates whether the system is using a larger value than the value configured as the MC-LAG hold-on-neighbor-failure value

MC Selection Logic

The current state of the MC-LAG protocol, indicating which of the two MC-LAG redundancy systems is the master

MC Config Mismatch

Indicates whether there is a LAG configuration mismatch between redundancy systems, and what is mismatched

Port-id

The member physical port ID expressed in slot/mda/port format

Adm

Up: the member port is administratively up

Down: the member port is administratively down

Act/Stdby

Active: the member port is active

Standby: the member port is on standby

Opr

Up: the member port is operationally up

Down: the member port is operationally down

Primary

Indicates whether the member port is the primary port

Sub-group

The member port subgroup

Prio

The member port priority

Output Example
*A:ALU-1># show lag 2 statistics
===============================================================================
LAG Statistics
===============================================================================
Description        : LAG2
Port-id   Input       Input       Output      Output      Input      Output
          Bytes       Packets     Bytes       Packets     Errors     Errors
-------------------------------------------------------------------------------
1/4/3     0           9968        0           9833        0          0
1/5/3     0           435         0           401         0          0
-------------------------------------------------------------------------------
Totals    0           10403       0           10234       0          0
===============================================================================
*A:ALU-1>#
Table: LAG Statistics Field Descriptions

Label

Description

Port-id

The member physical port ID expressed in slot/mda/port format

Input Bytes

The number of inbound bytes for the LAG on a per-port basis

Input Packets

The number of inbound packets for the LAG on a per-port basis

Output Bytes

The number of outbound bytes for the LAG on a per-port basis

Output Packets

The number of outbound packets for the LAG on a per-port basis

Input Errors

The number of inbound packets (for packet-oriented interfaces) or inbound transmission units (for character-oriented or fixed-length interfaces) that contained errors preventing them from being delivered to higher layers

Output Errors

The number of outbound packets (for packet-oriented interfaces) or outbound transmission units (for character-oriented or fixed-length interfaces) that could not be transmitted because of errors

Output Example
*A:ALU-1># show lag 1 associations
===============================================================================
Interface Table
===============================================================================
Router/ServiceId                Name                            Encap Val      
-------------------------------------------------------------------------------
Router: Base                    ies-337-30.30.30.1              104            
-------------------------------------------------------------------------------
Interfaces
===============================================================================
*A:ALU-1>#
Table: LAG Associations Field Descriptions

Label

Description

Router/ServiceId

The service associated with the LAG

Name

The name of the IP interface

Encap Val

The dot1q or qinq values of the port for the IP interface

Output Example
A:7705:Dut-A# show lag 2 bfd �
===============================================================================�
LAG BFD�
===============================================================================�
Disable soft reset extension: false�
===============================================================================�
�
===============================================================================�
LAG BFD IP address families�
===============================================================================�
ipv4�
-------------------------------------------------------------------------------�
Administrative state        : enabled�
Local IP address            : 12.1.2.2�
Remote IP address           : 12.1.2.1�
Transmit interval (ms)      : 100�
Receive interval (ms)       : 100�
Multiplier                  : 3�
Max admin down time (s)     : 0�
Max set-up time (ms)        : infinite�
BFD on distributing         : false�
Last management change      : 03/16/2022 11:34:25�
===============================================================================�
�
===============================================================================�
LAG 2 member ports BFD                �
===============================================================================�
Port                        State           Session    Remaining     Remaining�
                                                       admin-down(s) set-up(ms)�
-------------------------------------------------------------------------------�
1/1/4                       up              up         0             0�
1/1/19                      up              up         0             0�
===============================================================================�
A:7705:Dut-A#�
Table: LAG BFD Field Descriptions

Label

Description

Disable soft reset extension

Displays whether the disable soft reset extension function is enabled (true) or disabled (false) (not applicable for the 7705 SAR)

LAG BFD IP address families

ipv4

Administrative state

The administrative state of the micro-BFD session, either enabled or disabled

Local IP address

The IPv4 address of the BFD source

Remote IP address

The IPv4 address of the BFD destination

Transmit interval (ms)

The transmit interval time used for micro-BFD sessions over the associated LAG links, in milliseconds

Receive interval (ms)

The receive interval time used for micro-BFD sessions over the associated LAG links, in milliseconds

Multiplier

The detect multiplier used for a micro-BFD session over the associated LAG links

Max admin down time (s)

The maximum length of time, in seconds, that the router continues to forward traffic over a link after the micro-BFD session has transitioned to a down state

Max set-up time (ms)

The maximum length of time, in milliseconds, that the router forwards traffic over a link that has transitioned from standby to active before the micro-BFD session is fully established (up state)

BFD on distributing

Displays whether the bfd-on-distributing-only function is enabled (true) or disabled (false)

Last management change

The date and time of the last management change

LAG x member ports BFD

Port

The LAG BFD member port

State

The administrative state of the LAG BFD member port, either up or down

Session

The administrative state of the micro-BFD session, either up or down

Remaining admin-down (s)

The max-admin-down-time remaining, in seconds, that the router continues to forward traffic over a link after the micro-BFD session has transitioned to a down state

Remaining set-up (ms)

The max-setup-time remaining, in milliseconds, that the router forwards traffic over a link that has transitioned from standby to active before the micro-BFD session is fully established (up state)

Output Example
*A:ALU-1># show lag description
===============================================================================
Lag Port States
LACP Status: e - Enabled, d - Disabled
===============================================================================
Lag-id Port-id   Adm   Act/Stdby Opr   Description
-------------------------------------------------------------------------------
1(e)             up              down  N/A
       1/1/7     up    standby   down  10/100/Gig Ethernet SFP
       1/6/1     up    active    down  10/100/Gig Ethernet SFP
2(e)             up              down  N/A
       1/6/3     up    active    down  10/100/Gig Ethernet SFP
       1/7/3     up    standby   down  10/100/Gig Ethernet SFP
===============================================================================
*A:ALU-1>#
Table: LAG Description Field Descriptions

Label

Description

Lag Port States

LACP Status

Indicates whether LACP is enabled or disabled

Lag-id

The LAG identifier and LACP status code

Port-id

The member physical port ID

Adm

Indicates the administrative state of the member port: up or down

Act/Stdby

Indicates whether the port is in active or standby mode

Opr

Indicates the operational state of the member port: up or down

Description

The description strings configured for the LAG and member ports

Output Example
*A:ALU-1># show lag 1 lacp-partner
===============================================================================
LAG Partner information
===============================================================================
Partner system ID           : ea:3e:ff:00:00:00
Partner system priority     : 32768
Partner operational key     : 2
===============================================================================
===============================================================================
LAG 1 Ports Partner operational information
===============================================================================
Port                        Actor Port  Prio  Key
                            port
-------------------------------------------------------------------------------
1/1/7                       33863 33864 5     2
1/6/1                       34177 34178 7     2
===============================================================================
===============================================================================
LAG 1 Ports Partner operational state information
===============================================================================
Port                        Exp  Def  Dist Col  Syn  Aggr Time Act
                                                          out
-------------------------------------------------------------------------------
1/1/7                       No   No   Yes  Yes  Yes  Yes  Yes  Yes
1/6/1                       No   No   Yes  Yes  Yes  Yes  Yes  Yes
===============================================================================
*A:ALU-1>#
Table: LAG LACP Partner Field Descriptions

Label

Description

LAG Partner information

Partner system ID

The system ID of the partner (remote device)

Partner system priority

The system priority used by the partner in LACP messages

Partner operational key

The key used by the partner in LACP messages

LAG 1 Ports Partner operational information

Port

The member physical port ID

Actor port

The actor (local device) port associated with the member port

Port

The partner port associated with the member port

Prio

The partner port priority associated with the member port

Key

The partner operational key associated with the member port

LAG 1 Ports Partner operational state information

Port

The member physical port ID

Exp

(Expired) – indicates whether the partner is in the Expired state; if Yes, the LAG is not operational

Def

(Default) – indicates whether the partner information (system priority, key, port priority, and state of the partner) is the default information that is configured administratively or is information received through LACPDUs. Default partner information is used if LACPDUs were not received on time.

Dist

(Distributing) – indicates whether the distribution of outgoing frames is enabled or disabled on the link

Col

(Collecting) – indicates whether the collection of incoming frames is enabled or disabled on the link

Syn

(Synchronization) – indicates whether the link is allocated to the correct LAG

Aggr

(Aggregation) – indicates whether link aggregation is enabled or disabled on the port

Time out

Indicates whether a timeout value is set for the port

Act

(Activity) – indicates whether the link is active (port can send and receive LACPDU messages) or passive (port does not initiate LACP messages but will respond to LACP messages)

Output Example
*A:ALU-1># show lag 1 detail lacp-partner
===============================================================================
LAG Partner information
===============================================================================
Partner system ID           : de:41:ff:00:00:00
Partner system priority     : 32768
Partner operational key     : 32768
===============================================================================
-------------------------------------------------------------------------------
LAG port 1/1/7 partner information
-------------------------------------------------------------------------------
Actor port                  : 33863
Partner admin system prio   : 32768
Partner oper system prio    : 32768
Partner admin system ID     : 00:00:00:00:00:00
Partner oper system ID      : de:41:ff:00:00:00
Partner admin key           : 0
Partner oper key            : 32768
Partner admin port          : (Not Specified)
Partner oper port           : 33864
Partner admin port prio     : 32768
Partner oper port prio      : 32768
Partner admin state         : (Not Specified)
Partner oper state          : lacp-timeout, aggregation synchronization
                              collecting distributing
-------------------------------------------------------------------------------
LAG port 1/6/1 partner information
-------------------------------------------------------------------------------
Actor port                  : 34177
Partner admin system prio   : 32768
Partner oper system prio    : 32768
Partner admin system ID     : 00:00:00:00:00:00
Partner oper system ID      : de:41:ff:00:00:00
Partner admin key           : 0
Partner oper key            : 32768
Partner admin port          : (Not Specified)
Partner oper port           : 34178
Partner admin port prio     : 32768
Partner oper port prio      : 32768
Partner admin state         : (Not Specified)
Partner oper state          : lacp-timeout, aggregation synchronization
                              collecting distributing
-------------------------------------------------------------------------------
*A:ALU-1>#
Table: LAG Detailed LACP Partner Field Descriptions

Label

Description

LAG Partner information

Partner system ID

The system ID of the partner (remote device)

Partner system priority

The system priority used by the partner in LACP messages

Partner operational key

The key used by the partner in LACP messages

LAG port port-id partner information

Actor port

The actor (local device) port associated with the member port

Partner admin system prio

The partner administrative system priority associated with the member port

Partner oper system prio

The partner operational system priority associated with the member port

Partner admin system ID

The partner administrative system ID associated with the member port

Partner oper system ID

The partner operational system ID associated with the member port

Partner admin key

The partner administrative key associated with the member port

Partner oper key

The partner operational key associated with the member port

Partner admin port

The partner administrative port associated with the member port

Partner oper port

The partner operational port associated with the member port

Partner admin port prio

The partner administrative port priority associated with the member port

Partner oper port prio

The partner operational port priority associated with the member port

Partner admin state

The administrative state of the partner

Partner oper state

The operational state of the partner

Output Example
*A:ALU-1># show lag 1 port
===============================================================================
Lag Port States
LACP Status: e - Enabled, d - Disabled
===============================================================================
Lag-id Port-id   Adm   Act/Stdby Opr   Primary  Sub-group     Forced  Priority
-------------------------------------------------------------------------------
1(e)   1/1/7     up    standby   down  yes      2             -       32768
       1/6/1     up    active    down           1             -       32768
===============================================================================
*A:ALU-1>#
Table: LAG Port Field Descriptions

Label

Description

Lag Port States

LACP status

Indicates whether LACP is enabled or disabled

Lag-id

The LAG identifier and LACP status code

Port-id

The member physical port ID

Adm

Indicates the administrative state of the member port: up or down

Act/Stdby

Indicates whether the member port is in active or standby mode

Opr

Indicates the operational state of the member port: up or down

Primary

Indicates whether the member port is the primary port

Sub-group

The member port sub-group

Forced

n/a

Priority

The member port priority