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:

•The specified VLAN contains an unknown unicast destination MAC address.

•The specified VLAN contains a known or an unknown multicast destination MAC or destination IP address.

•The specified VLAN contains a broadcast MAC address.

•The EtherChannel has only one active member.

•The destination MAC address is unknown when the load distribution is configured on the source IP address (src-ip), source port (l4-src-port), or source MAC address (src-mac).

•If multichassis EtherChannel trunk (MCT) is enabled and the traffic flows from a virtual port channel (vPC) peer link, the output displays "Outgoing port id (vPC peer-link traffic)".

To get accurate results, you must do the following:

•(For unicast frames) Provide the destination MAC address (dst-mac) and the VLAN for hardware hashing (vlan). When the destination MAC address is not provided, hardware hashing is assumed.

•(For multicast frames) For IP multicast, provide either the destination IP address (dst-ip) or destination MAC address (dst-mac) with the VLAN for hardware hashing (vlan). For non-ip multicast, provide the destination MAC address with the VLAN for hardware hashing.

•(For broadcast frames) Provide the destination MAC address (dst-mac) and the VLAN for hardware hashing (vlan).

Examples

This example shows how to display the port channel load balance 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#

Table 3-2 describes the fields shown in the display.

Table 3-2 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 balance 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 balance 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 balance 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 balance 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.