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 and PTX10016 ,PTX10003

    .

    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 256 KB.

  • When injecting raw packets, ensure 24 bytes of trailing space, which is accounted for in the packet header length. This space will be used for inserting metadata to the injected probe packet.

Options

interface-name

Ingress logical interface.

family-type

Layer 3 family “inet/inet6”.

src-IP

Source IP address.

dest-IP

Destination IP address.

source-mac-address

source MAC address.

dest-mac-address

Destination MAC address.

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

AE Egress-IPv6 Egress

Sample Output

MPLS Egress IPv4

Sample Output

Packet hash:IPv4 (MPLS egress)

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

Sample Output

Packet hash:IPv6 (MPLS egress)

Release Information

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