maximum-paths

Syntax

For BGP:

maximum-paths [ ibgp [ equal-cost ] | eibgp ] maxPaths

no maximum-paths [ ibgp [ equal-cost ] | eibgp ] [ maxPaths ]

For IS-IS and RIP:

maximum-paths maxPaths

no maximum-paths

For OSPF:

maximum-paths maxPaths

no maximum-paths maxPaths

Release Information

Command introduced before JunosE Release 7.1.0.

equal-cost keyword for BGP added in JunosE Release 13.2.0.

Description

Controls the maximum number of equal-cost paths to the same destination that BGP, IS-IS, OSPF, or RIP can install in the routing table to support ECMP.

For BGP and RIP, issue the command from Router Configuration mode to apply the value to routes in the global RIB. In Address Family Configuration mode, issue the command only in the context of IPv4 unicast and IPv6 unicast address families to apply the value only to routes in the global RIB or the specific VRF for the IPv4 unicast or IPv6 unicast address family; This command is not supported for VPNv4 or VPNv6 address families.

By default, for IBGP routes, unequal-cost multipaths are installed in the routing table. You must use the equal-cost keyword with the maximum-paths ibgp command to enable equal-cost multipaths to be used in the routing table for traffic forwarding.

For IS-IS or OSPF, issue the command from Router Configuration mode.

The no version restores the default value, 1 path for BGP or 4 paths for IS-IS, OSPF, and RIP.

Options

• ibgp—Specifies that the maxPaths value applies only to routes received from internal (IBGP) peers; if no keyword is specified, the maxPaths value applies only to routes received from external (EBGP) peers. By default, unequal-cost multipaths are used for traffic forwarding for IBGP routes.
• equal-cost—Specifies equal-cost routes received from IBGP peers to be installed in the routing table for traffic forwarding.
• eibgp—Specifies that the maxPaths value applies to routes received from IBGP and EBGP peers; can be used only for VRF IPv4 unicast and IPv6 unicast address families.
• maxPaths—Maximum number of parallel paths (routes) in the range 1–16.

Mode

Address Family Configuration, Router Configuration