show port-channel load-balance

To display information about EtherChannel load balancing, use the show port-channel load-balance command.

show port-channel load-balance [ forwarding-path interface port-channel number { . | vlan vlan_ID } [ dst-ip ipv4-addr ] [ dst-ipv6 ipv6-addr ] [ dst-mac dst-mac-addr ] [ l4-dst-port dst-port ] [ l4-src-port src-port ] [ src-ip ipv4-addr ] [ src-ipv6 ipv6-addr ] [ src-mac src-mac-addr ]]

Syntax Description

forwarding-path interface port-channel
(Optional) Identifies the port in the EtherChannel interface that forwards the packet.
number
EtherChannel number for the load-balancing forwarding path that you want to display. The range is from 1 to 4096.
.
(Optional) Subinterface number separator. Use the EtherChannel number followed by a dot (.) indicator and the subinterface number. The format is portchannel-number . subinterface-number .
vlan
(Optional) Identifies the VLAN for hardware hashing.
vlan_ID
VLAN ID. The range is from 1 to 3967 and 4048 to 4093.
dst-ip
(Optional) Displays the load distribution on the destination IP address.
ipv4-addr
IPv4 address to specify a source or destination IP address. The format is A . B . C . D .
dst-ipv6
(Optional) Displays the load distribution on the destination IPv6 address.
ipv6-addr
IPv6 address to specify a source or destination IP address. The format is A : B :: C : D .
dst-mac
(Optional) Displays the load distribution on the destination MAC address.
dst-mac-addr
Destination MAC address. The format is AAAA : BBBB : CCCC .
l4-dst-port
(Optional) Displays the load distribution on the destination port.
dst-port
Destination port number. The range is from 0 to 65535.
l4-src-port
(Optional) Displays the load distribution on the source port.
src-port
Source port number. The range is from 0 to 65535.
src-ip
(Optional) Displays the load distribution on the source IP address.
src-ipv6
(Optional) Displays the load distribution on the source IPv6 address.
src-mac
(Optional) Displays the load distribution on the source MAC address.
src-mac-addr
source MAC address. The format is AA : BB : CC : DD : EE : FF .

Command Default

None

Command Modes

EXEC mode

Command History

Release
Modification
4.0(0)N1(1a)
This command was introduced.
4.2(1)N1(1)
The vlan keyword was added.

Usage Guidelines

You must use the vlan keyword to determine the use of hardware hashing.

When you do not use hardware hashing, the output displays all parameters used to determine the outgoing port ID. Missing parameters are shown as zero values in the output.

If you do not use hardware hashing, the outgoing port ID is determined by using control-plane selection. Hardware hashing is not used in the following scenarios:

To get accurate results, you must do the following:

Examples

This example shows how to display the port channel load-balancing information:

switch# show port-channel load-balance
Port Channel Load-Balancing Configuration:
System: source-dest-ip
 
Port Channel Load-Balancing Addresses Used Per-Protocol:
Non-IP: source-dest-mac
IP: source-dest-ip source-dest-mac
 
switch#
 

The table below describes the fields shown in the display.

show port-channel load-balance Field Descriptions
Field
Description
System
The load-balancing method configured on the switch.
Non-IP
The field that will be used to calculate the hash value for non-IP traffic.
IP
The fileds used for IPv4 and IPv6 traffic.

This example shows how to display the port channel load-balancing information when hardware hashing is not used:

switch# show port-channel load-balance forwarding-path interface port-channel 5 vlan 3 dst-ip 192.168.2.37
Missing params will be substituted by 0's.
Load-balance Algorithm on FEX: source-dest-ip
crc8_hash: Not Used Outgoing port id: Ethernet133/1/3
Param(s) used to calculate load-balance (Unknown unicast, multicast and broadcas
t packets):
dst-mac: 0000.0000.0000
vlan id: 3
switch#
 

This example shows how to display the port channel load-balancing information when hardware hashing is not used to determine the outgoing port ID:

switch# show port-channel load-balance forwarding-path interface port-channel 10 vlan 1 dst-ip 192.168.2.25 src-ip 192.168.2.10 dst-mac ffff.ffff.ffff src-mac aa:bb:cc:dd:ee:ff l4-src-port 0 l4-dst-port 1
Missing params will be substituted by 0's.
Load-balance Algorithm on switch: source-dest-port
crc8_hash: Not Used Outgoing port id: Ethernet1/1
Param(s) used to calculate load-balance (Unknown unicast, multicast and broadcast packets):
dst-mac: ffff.ffff.ffff
vlan id: 1
 
switch#
 

This example shows how to display the port channel load-balancing information when MCT is enabled and traffic flows from a vPC peer link:

switch# show port-channel load-balance forwarding-path interface port-channel 10 vlan 1 dst-ip 192.168.2.25 src-ip 192.168.2.10 dst-mac ffff.ffff.ffff src-mac aa:bb:cc:dd:ee:ff l4-src-port 0 l4-dst-port 1
Missing params will be substituted by 0's.
Load-balance Algorithm on switch: source-dest-port
crc8_hash: Not Used Outgoing port id (non vPC peer-link traffic): ethernet1/2
crc8_hash: Not Used Outgoing port id (vPC peer-link traffic): Ethernet1/1
Param(s) used to calculate load-balance (Unknown unicast, multicast and broadcast packets):
dst-mac: ffff.ffff.ffff
vlan id: 1
 
switch#
 

This example shows how to display the port channel load-balancing information when hardware hashing is used to determine the outgoing port ID:

switch# show port-channel load-balance forwarding-path interface port-channel 10 vlan 1 dst-ip 192.168.2.25 src-ip 192.168.2.10 src-mac aa:bb:cc:dd:ee:ff l4-src-port 0 l4-dst-port 1
Missing params will be substituted by 0's.
Load-balance Algorithm on switch: source-dest-port
crc8_hash: 204 Outgoing port id: Ethernet1/1
Param(s) used to calculate load-balance:
dst-port: 1
src-port: 0
dst-ip: 192.168.2.25
src-ip: 192.168.2.10
dst-mac: 0000.0000.0000
src-mac: aabb.ccdd.eeff
 
switch#
 

Related Commands

Command
Description
port-channel load-balance ethernet
Configures the load-balancing method among the interfaces in the channel-group bundle.