Interface and Hardware Component Command Reference, Cisco IOS XE Release 3SE (Catalyst 3850 Switches)
show controllers serial through show hw-module slot proc cpu
Downloads: This chapterpdf (PDF - 351.0KB) The complete bookPDF (PDF - 2.12MB) | Feedback

show controllers serial through show hw-module slot proc cpu

show controllers serial through show hw-module slot proc cpu

show etherchannel

To display EtherChannel information for a channel, use the showetherchannel command in privileged EXEC mode.

Cisco 2600 Series, Cisco 3600 Series, and Cisco 3700 Series Routers

show etherchannel [channel-group] { port-channel | brief | detail | summary | port | load-balance }

Cisco Catalyst Switches

show etherchannel [channel-group] { port-channel | brief | detail | summary | port | load-balance | protocol } [expression]

Syntax Description

channel -group

(Optional) Number of the channel group. If you do not specify a value for the channel -group argument, all channel groups are displayed.

port -channel

Displays port channel information.

brief

Displays a summary of EtherChannel information.

detail

Displays detailed EtherChannel information.

summary

Displays a one-line summary per channel group.

port

Displays EtherChannel port information.

load -balance

Displays load-balance information.

protocol

Displays the enabled protocol.

expression

(Optional) Expression in the output to use as a reference point.

Command Modes

Privileged EXEC (#)

Command History

Release

Modification

12.0(7)XE

This command was introduced on Cisco Catalyst 6000 family switches.

12.1(3a)E3

This command was modified. The number of valid values for the channel -group argument were changed.

12.1(5c)EX

This command was modified. The number of valid values for the channel-group argument were changed.

12.2(2)XT

This command was modified to support switchport creation on Cisco 2600 series, Cisco 3600 series, and Cisco 3700 series routers.

12.2(14)SX

This command was implemented on the Supervisor Engine 720.

12.2(17a)SX1

This command was modified. The output of the showetherchannelload-balance command was changed to include IPv6 information. The display was changed to include Multiprotocol Label Switching (MPLS) information.

12.2(17d)SXB

This command was modified to support the Supervisor Engine 2.

12.2(8)T

This command was modified to support switchport creation.

12.2(33)SXH

This command was modified. The output of the showetherchannelport-channel and the showetherchanneldetailcommands was changed to include Link Aggregation Control Protocol (LACP) fast switchover status. The number of valid values for the channel -group argument was changed.

12.2(33)SRC

This command was modified. The output of the showetherchannelport-channel and the showetherchanneldetailcommands was changed to show the status of the LACP Single Fault Direct Load Balance Swap feature, to show the last applied hash distribution algorithm, and to include LACP fast switchover status.

12.2(33)SXI3

This command was modified. The output of the showetherchannelsummary, showetherchannelport-channel, and showetherchanneldetail commands was changed to show the standalone disable option.

Usage Guidelines

Cisco 2600 Series, Cisco 3600 Series, and Cisco 3700 Series Routers

The channel-group argument supports six EtherChannels and eight ports in each channel.

If you do not specify a value for the channel-group argument, all channel groups are displayed.

Cisco Catalyst Switches

The number of valid values for the channel-group argument depends on the software release. For software releases prior to Cisco IOS Release 12.1(3a)E3, valid values are from 1 to 256; for Cisco IOS Release 12.1(3a)E3, 12.1(3a)E4, and 12.1(4)E1, valid values are from 1 to 64. Cisco IOS Release 12.1(5c)EX and later support a maximum of 64 values ranging from 1 to 256. Cisco IOS Release 12.2(33)SXH supports a maximum of 64 values ranging fro m 1 to 282.

If you do not specify a value for the channel-group argument, all channel groups are displayed.

In the output, the Passive port list field is displayed for Layer 3 port channels only. This field means that the physical interface, which is still not up, is configured to be in the channel group (and indirectly in the only port channel in the channel group).

The channel-groupvalues from 257 to 282 are supported on the Catalyst 6500 series Cisco Services Module (CSM) and the Catalyst 6500 series Firewall Services Module (FWSM) only.

In the output, the Passive port list field is displayed for Layer 3 port channels only. This field means that the physical interface, which is still not up, is configured to be in the channel group (and indirectly is the only port channel in the channel group).

If the interface is configured as part of the channel in ON mode, theshowetherchannelprotocol command displays Protocol: - (Mode ON).

In the output of the showetherchannelsummary command, the following conventions apply:

  • In the column that displays the protocol that is used for the channel, if the channel mode is ON, a hyphen (-) is displayed.
  • For LACP, multiple aggregators are supported. For example, if two different bundles are created, Po1 indicates the primary aggregator, and Po1A and Po1B indicates the secondary aggregators.

In the output of the showetherchannelload-balance command, the following conventions apply:

  • For EtherChannel load balancing of IPv6 traffic, if the traffic is bridged onto an EtherChannel (for example, it is a Layer 2 channel and traffic in the same VLAN is bridged across it), the traffic is always load balanced by the IPv6 addresses or src, dest, or src-dest, depending on the configuration. For this reason, the switch ignores the MAC/IP/ports for bridged IPv6 traffic. If you configure src-dst-mac, the src-dst-ip(v6) address is displayed. If you configure src-mac, the src-ip(v6) address is displayed.
  • IPv6 traffic that is routed over a Layer 2 or a Layer 3 channel is load balanced based on MAC addresses or IPv6 addresses, depending on the configuration. The MAC/IP and the src/dst/src-dst are supported, but load balancing that is based on Layer 4 ports is not supported. If you use the port keyword, the IPv6 addresses or either src, dst, or src-dst, is displayed.

Examples

Examples

Protocol Information

The following example shows how to display the enabled protocol:

Router# show etherchannel protocol
Channel-group listing:
                -----------------------
Group: 12
----------
Protocol:  PAgP
Group: 24
----------
Protocol:   -  (Mode ON)
Router#

Examples

Port Channel Information for a Specific Group

The following example shows how to display port channel information for a specific group:

Router# show etherchannel 12 port-channel
Group: 12 
----------
                Port-channels in the group: 
                ----------------------
Port-channel: Po1
------------
Age of the Port-channel   = 143h:01m:12s
Logical slot/port   = 14/1           Number of ports = 2
GC                  = -              HotStandBy port = null
Port state          = Port-channel Ag-Inuse 
Protocol            = LACP
Fast-switchover     = enabled
Ports in the Port-channel: 
Index   Load   Port    EC state
------+------+------+------------
  0     55     Fa4/1   active
  1     AA     Fa4/2   active
Time since last port bundled:    16h:28m:58s    Fa4/1
Time since last port Un-bundled: 16h:29m:00s    Fa4/4

The following example shows that direct load swapping is enabled.

Router# show etherchannel 15 port-channel
                Port-channels in the group: 
Port-channel: Po15    (Primary Aggregator)
Age of the Port-channel   = 0d:18h:16m:49s
Logical slot/port   = 14/7          Number of ports = 1
HotStandBy port = null 
Port state              = Port-channel Ag-Inuse 
Protocol                =   LACP
! The following line of output is added with support 
of the LACP Single Fault Direct Load Swapping feature. !
Direct Load Swap = enabled
Ports in the Port-channel: 
Index   Load   Port     EC state        No of bits
------+------+------+------------------+-----------
  0     FF     Fa4/1    Active    8
Time since last port bundled:    0d:00h:06m:12s    Fa4/1

Examples

Load Balancing

The following examples show how to display load-balancing information:

Router#
 show etherchannel load-balance 
Source XOR Destination mac address
Router#
 show etherchannel load-balance 
EtherChannel Load-Balancing Configuration:
        dst-mac
        mpls label-ip
EtherChannel Load-Balancing Addresses Used Per-Protocol:
Non-IP: Destination MAC address
  IPv4: Destination MAC address
  IPv6: Destination MAC address (routed packets)
        Destination IP address (bridged packets)
  MPLS: Label or IP

Examples

Summary Information for a Specific Group

The following example shows how to display a summary of information for a specific group:

Router# 
show etherchannel 1 brief
Group state = L3
Ports: 2   Maxports = 8
port-channels: 1 Max port-channels = 1
Partner’s information:

The following example shows the hash distribution algorithm that was last applied:

Router# show etherchannel
 10 summary
Flags:  D - down        P - bundled in port-channel
        I - stand-alone s - suspended
        H - Hot-standby (LACP only)
        R - Layer3      S - Layer2
        U - in use      N - not in use, no aggregation
        f - failed to allocate aggregator
<snip>
Group  Port-channel  Protocol    Ports
------+-------------+-----------+-----------------------------------------------
10     Po10(RU)        LACP      Gi3/7(P)       Gi3/9(P)       
! The following line of output is added with support 
of the EtherChannel Load Distribution feature. !
Last applied Hash Distribution Algorithm: Fixed
Router#

Examples

Detailed Information for a Specific Group

The following example shows how to display detailed information for a specific group:

Router# 
show etherchannel 12 detail
Group state = L2
Ports: 1   Maxports = 8
Port-channels: 1 Max Port-channels = 1
Protocol:   PAgP
Fast-switchover = enabled
                Ports in the group:
                -------------------
Port: Fa5/2
------------
Port state    = Down Not-in-Bndl
Channel group = 12          Mode = Desirable-Sl     Gcchange = 0
Port-channel  = null        GC   = 0x00000000          Pseudo port-channel = Po1
2
Port index    = 0           Load = 0x00        Protocol =   PAgP
Flags:  S - Device is sending Slow LACPDUs F - Device is sending fast LACPDUs
        A - Device is in active mode       P - Device is in passive mode
Local information:
                            LACP Port    Admin     Oper    Port     Port
Port      Flags   State     Priority      Key      Key     Number   State
Fa4/1     SA      bndl      32768         100      100     0xc1     0x75
Partner’s information:
         Partner                Partner               Partner
Port     System ID              Port Number    Age    Flags
Fa4/1    8000,00b0.c23e.d861    0x81	           14s    SP
         LACP Partner    Partner     Partner
         Port Priority   Oper Key    Port State
         32768	           128         0x81		
Age of the port in the current state: 16h:27m:42s
                Port-channels in the group:
                ----------------------
Port-channel: Po12
------------
Age of the Port-channel   = 04d:02h:52m:26s
Logical slot/port   = 14/1          Number of ports = 0
GC                  = 0x00000000      HotStandBy port = null
Port state          = Port-channel Ag-Not-Inuse
Protocol            =   PAgP

Note


When LACP 1:1 redundancy is configured, the showetherchanneldetail command also displays fast-switchover status information.


Examples

One-Line Summary per Channel Group

The following example shows how to display a one-line summary per channel group:

Router# 
show etherchannel summary
U-in use  I-in port-channel   S-suspended   D-down  i-stand-alone  d-default 
Group Port-channel  Ports
----- ------------  ----------------------------------------------------------
1     Po1(U)        Fa5/4(I)  Fa5/5(I)
2     Po2(U)        Fa5/6(I)  Fa5/7(I)
255                 Fa5/9(i)
256                 Fa5/8(i)                  

Examples

Port Information for All Groups

The following example shows how to display EtherChannel port information for all ports and all groups:

Router# 
show etherchannel port 
                Channel-group listing:
                ----------------------- 
Group: 1
----------
                Ports in the group:
                -------------------
Port: Fa5/4
------------
Port state    = EC-Enbld Down Not-in-Bndl Usr-Config
Channel group = 1           Mode = Desirable     Gcchange = 0
Port-channel  = null        GC   = 0x00000000    Psudo-agport = Po1
Port indx     = 0           Load = 0x00
Flags:  S - Device is sending Slow hello.  C - Device is in Consistent state.
        A - Device is in Auto mode.        P - Device learns on physical port.
Timers: H - Hello timer is running.        Q - Quit timer is running.
        S - Switching timer is running.    I - Interface timer is running.
Local information:
                                Hello    Partner  PAgP     Learning  Group
Port      Flags State   Timers  Interval Count   Priority   Method  Ifindex
Fa5/4     d     U1/S1           1s       0        128        Any      0
 
Age of the port in the current state: 02h:40m:35s
Port: Fa5/5
------------
Port state    = EC-Enbld Down Not-in-Bndl Usr-Config
Channel group = 1           Mode = Desirable     Gcchange = 0
Port-channel  = null        GC   = 0x00000000    Psudo-agport = Po1
Port indx     = 0           Load = 0x00
Flags:  S - Device is sending Slow hello.  C - Device is in Consistent state.
        A - Device is in Auto mode.        P - Device learns on physical port.
Timers: H - Hello timer is running.        Q - Quit timer is running.
        S - Switching timer is running.    I - Interface timer is running.

Examples

Port Information for a Specific Group

The following example shows how to display the information about the EtherChannel port for a specific group:

Router# 
show etherchannel 1 port
                Channel-group listing:
                -----------------------
Group: 1
----------
                Ports in the group:
                -------------------
Port: Fa5/4
------------
Port state    = EC-Enbld Down Not-in-Bndl Usr-Config
Channel group = 1           Mode = Desirable     Gcchange = 0
Port-channel  = null        GC   = 0x00000000    Psudo-agport = Po1
Port index    = 0           Load = 0x00        Protocol =   LACP
Flags:  S - Device is sending Slow LACPDUs F - Device is sending fast LACPDUs
        A - Device is in active mode       P - Device is in passive mode
Local information:
                            LACP Port    Admin     Oper    Port     Port
Port      Flags   State     Priority      Key      Key     Number   State
Fa5/4     SA      bndl      32768         100      100     0xc1     0x75
Partner’s information:
         Partner                Partner               Partner
Port     System ID              Port Number    Age    Flags
Fa5/4    8000,00b0.c23e.d861    0x81	           14s    SP
         LACP Partner    Partner     Partner
         Port Priority   Oper Key    Port State
         32768	           128         0x81		
Age of the port in the current state: 04d:02h:57m:38s

Examples

Port Channel Information for the Standalone Disabled Option

The following example shows the showetherchannelsummary command output with a port in suspended state:

Router# show etherchannel 42 summary 
Flags:  D - down        P - bundled in port-channel
        I - stand-alone s - suspended
        H - Hot-standby (LACP only)
        R - Layer3      S - Layer2
        U - in use      f - failed to allocate aggregator
        M - not in use, minimum links not met
        u - unsuitable for bundling
        w - waiting to be aggregated
Number of channel-groups in use: 8
Number of aggregators:           8
Group  Port-channel  Protocol    Ports
------+-------------+-----------+-----------------------------------------------
2      Po42(SU)        LACP      Fa1/17(s)  Fa1/18(P)  Fa1/19(P)  Fa1/20(P)  

The following example shows the showetherchannelport-channel command output with the status of Standalone Disable option:

Router# show etherchannel 42 port-channel 
                Port-channels in the group: 
                ----------------------
Port-channel: Po42    (Primary Aggregator)
------------
Age of the Port-channel   = 0d:21h:28m:22s
Logical slot/port   = 14/42          Number of ports = 3
HotStandBy port = null 
Port state          = Port-channel Ag-Inuse 
Protocol            =   LACP
Fast-switchover     = disabled
Load share deferral = disabled
Standalone Disable  = enabled   
Ports in the Port-channel: 
Index   Load      Port          EC state       No of bits
------+------+------------+------------------+-----------
 2      49         Fa1/18             Active   3
 1      92         Fa1/19             Active   3
 3      24         Fa1/20             Active   2
Time since last port bundled:    0d:03h:37m:07s    Fa1/18
Time since last port Un-bundled: 0d:03h:34m:27s    Fa1/17
Last applied Hash Distribution Algorithm: Fixed

The following example shows the showetherchanneldetail command output with the status of Standalone Disable option:

Router# show etherchannel 42 detail
  
Group state = L2 
Ports: 4   Maxports = 16
Port-channels: 1 Max Port-channels = 16
Protocol:   LACP
Minimum Links: 2
Standalone Disable: enabled
                Ports in the group:
                -------------------
Port: Fa1/17
------------
Port state    = Up Cnt-bndl Suspend Not-in-Bndl 
Channel group = 42           Mode = Active      Gcchange = -
Port-channel  = null        GC   =   -         Pseudo port-channel = Po2
Port index    = 0           Load = 0x00        Protocol =   LACP
Flags:  S - Device is sending Slow LACPDUs   F - Device is sending fast LACPDUs.
        A - Device is in active mode.        P - Device is in passive mode.
Local information:
                            LACP port     Admin     Oper    Port        Port
Port      Flags   State     Priority      Key       Key     Number      State
Fa1/17    FP      susp      1             0x2       0x2     0x112       0x82  
Partner's information:
          Partner Partner   LACP Partner  Partner   Partner  Partner     Partner
Port      Flags   State     Port Priority Admin Key Oper Key Port Number Port State
Fa1/17    FP      susp      1             0x0       0x2      0x312       0x36  
Age of the port in the current state: 0d:03h:44m:04s
Port: Fa1/18
------------
Port state    = Up Mstr In-Bndl 
Channel group = 42           Mode = Active      Gcchange = -
Port-channel  = Po2         GC   =   -         Pseudo port-channel = Po2
Port index    = 2           Load = 0x49        Protocol =   LACP
Flags:  S - Device is sending Slow LACPDUs   F - Device is sending fast LACPDUs.
        A - Device is in active mode.        P - Device is in passive mode.
Local information:
                            LACP port     Admin     Oper    Port        Port
Port      Flags   State     Priority      Key       Key     Number      State
Fa1/18    SA      bndl      2             0x2       0x2     0x113       0x3D  
Partner's information:
          Partner Partner   LACP Partner  Partner   Partner  Partner     Partner
Port      Flags   State     Port Priority Admin Key Oper Key Port Number Port State
Fa1/18    SA      bndl      2             0x0       0x2      0x313       0x3D  
Age of the port in the current state: 0d:03h:43m:24s
Port-channels in the group: 
Port-channel: Po42    (Primary Aggregator)
Age of the Port-channel   = 0d:21h:34m:45s
Logical slot/port   = 14/42          Number of ports = 3
HotStandBy port = null 
Port state          = Port-channel Ag-Inuse 
Protocol            =   LACP
Fast-switchover     = disabled
Load share deferral = disabled  
Standalone Disable  = enabled   
Ports in the Port-channel: 
Index   Load      Port          EC state       No of bits
------+------+------------+------------------+-----------
 2      49         Fa1/18             Active   3
 1      92         Fa1/19             Active   3
 3      24         Fa1/20             Active   2
Time since last port bundled:    0d:03h:43m:30s    Fa1/18
Time since last port Un-bundled: 0d:03h:40m:50s    Fa1/17
Last applied Hash Distribution Algorithm: Fixed

Related Commands

Command

Description

channel-group

Assigns and configures an EtherChannel interface to an EtherChannel group.

channel-protocol

Sets the protocol that is used on an interface to manage channeling.

interface port-channel

Accesses or creates the IDB port channel.