-
Interface and Hardware Component Command Reference, Cisco IOS XE Release 3SE (Catalyst 3850 Switches)
-
cable bundle through clock mode
-
clock rate through cut-through
-
D through E
-
F through H
-
I through K
-
l2 vfi manual through loopback (PA-MC-8TE1 + port adapter)
-
loopback (T1 interface) through nrzi-encoding
-
O through R
-
service-module t1 linecode through show controllers satellite
-
show controllers serial through show hw-module slot proc cpu
-
show hw-module slot tech-support through show interfaces vg-anylan
-
show interfaces vlan mapping through show scp
-
show service-module serial through standby port
-
squelch through system jumbomtu
-
tunnel bandwidth through yellow
-
Index
-
Feedback
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 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
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/4The 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/1Examples
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 IPExamples
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
NoteWhen 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:38sExamples
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: FixedThe 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
