Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

show forwarding-options load-balance

Syntax

Description

Displays the load-balancing hash result. You can view this information for one, two, or three levels of load balancing. This command can be used in two ways to get different load-balancing information based on the parameters:

  • To get the load-balancing decision result for routed IPv4, IPv6, and other L3 traffic, use the following:

    show forwarding-options load-balance ingress-interface <interface-name> family <family-type> source-address <src-IP> destination-address <dest-IP> source-mac-address <source-mac-address> dest-mac-address <destination-mac-address> transport-protocol <transport-protocol> source-port <src-port> destination-port <dest-port> tos <TOS>

    Note:

    source-mac-address and dest-mac-address are only supported on BT based line-cards on PTX10001-36MR, LC1201 line card, LC1202 line card, PTX10004, PTX10008, PTX10016, PTX10003, and PTXX10002-36QDD.

    You can use this command when all the packet header details are available.

  • To get the load-balancing decision result for raw packet dump files, use the following:

    show forwarding-options load-balance ingress-interface <interface-name> family <family-type> packet-dump <pkt-dump>

    You can use this command when the packets in the traffic are complex to be described by the 5-tuple.

Note:
  • This feature is not supported for multicast flows and L2 packets.

  • The maximum size of the raw packets entered on the CLI is 1500 bytes.

Options

interface-name

Ingress logical interface.

family-type

Layer 3 family “inet/inet6”.

src-IP

Source IP address.

IP address of the source device/node/interface from where these packets are emanating

dest-IP

Destination IP address.

IP address of the eventual intended node for which these packets are destined for

source-mac-address

source MAC address.

MAC address of the node/interface hosting the Source IP address (PTX)

dest-mac-address

Destination MAC address.

MAC address of the Ingress interface on which this packet is being received on this device (PTX)

transport-protocol

Transport layer protocol “tcp/udp”.

src-port

Source port (0 – 65535).

dest-port

Destination port (0 – 65535).

TOS

Type of service field (0 – 255).

pkt-dump

Raw packet dump in hexadecimal without '0x'. The hexadecimal code of packet information must start from the L3 header (IPv4/IPv6) to the end of the packet. It should be less than 256,000 characters in length.

Required Privilege Level

view

Output Fields

Table 1 lists the output fields for the show forwarding-options load-balance command. Output fields are listed in the order in which they appear.

Table 1: show forwarding-options hyper-mode Output Fields

Field Name

Field Description

Outgoing logical aggregate interface

Egress aggregated Ethernet interface for current parameters

Outgoing member physical interface

Egress physical interface for current parameters

Outgoing next hop address

Egress next hop chosen for current parameters

Outgoing next hop id

Egress next-hop ID chosen for current parameters

Sample Output (MX)

AE Egress-IPv6 Egress

Sample Output (MX)

MPLS Egress IPv4

Sample Output

Packet hash:IPv4 (MPLS egress) (MX)

Note that for the MPLS egress, the outgoing next-hop address will not be displayed.

Sample Output

Packet hash:IPv6 (MPLS egress) (MX)

Release Information

To learn more about platform support for load-balance, refer Getting load-balancing hash result information.