Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

header-navigation
keyboard_arrow_up
close
keyboard_arrow_left
Junos CLI Reference
Table of Contents Expand all
list Table of Contents
file_download PDF
{ "lLangCode": "en", "lName": "English", "lCountryCode": "us", "transcode": "en_US" }
English
keyboard_arrow_right

show forwarding-options load-balance

date_range 19-Nov-23

Syntax

content_copy zoom_out_map
show forwarding-options load-balance

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

content_copy zoom_out_map
user@host> show forwarding-options load-balance family inet6 ingress-interface xe-5/0/3 transport-protocol tcp source-address 2201::2 destination-address 2202::2 source-port 1617 destination-port 1640 tos 224
================ fpc5 ================
 
Outgoing logical aggregate interface: ae0.0
Outgoing member physical interface  : xe-4/2/1
Outgoing next hop address           : fe80::2e21:72ff:fe71:1d
Outgoing next hop id                : 700

Sample Output

MPLS Egress IPv4

content_copy zoom_out_map
user@host> show forwarding-options load-balance ingress-interface xe-5/0/3 family inet source-address 102.1.1.2 destination-address 202.1.1.2 tos 4 transport-protocol udp source-port 1431 destination-port 6531
================ fpc5 ================
Outgoing logical interface          : xe-5/0/2.0
Outgoing next hop address           : 40.40.40.2
Outgoing next hop id                : 747

Sample Output

Packet hash:IPv4 (MPLS egress)

content_copy zoom_out_map
user@host> show forwarding-options load-balance ingress-interface xe-5/0/3 family inet packet-dump 4580004e000000003d114b1966010102ca01010205971983003a31abb9b7c07aa5bafa434978696000000001101112134bdfa97e00161a1b1c1d1e1f202122232425262728292a2b2c2d2e2fa073
================ fpc5 ================
Outgoing logical interface          : xe-4/1/1.0
Outgoing next hop address           : -
Outgoing next hop id                : 708

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

Sample Output

Packet hash:IPv6 (MPLS egress)

content_copy zoom_out_map
user@host> show forwarding-options load-balance ingress-interface xe-5/0/3 family inet6 packet-dump 6c0000000026113d210100000000000000000000000000022201000000000000000000000000000206b6078000265a60b9b7c07aa5bafa43497869600000000210111213361b3e6300021a1bd63a
================ fpc5 ================
 
Outgoing logical interface          : xe-4/1/2.0
Outgoing next hop address           : -
Outgoing next hop id                : 705

Release Information

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

footer-navigation