maximum-paths (BGP)

Sets the maximum number of BGP4 and BGP4+ shared paths.
Syntax
maximum-paths num | use-load-sharing
no maximum-paths
Parameters
num
Specifies the maximum number of paths across which the device balances traffic to a given BGP destination. Valid values range is from 1 through 32. The default is 1.
use-load-sharing
Uses the maximum IP ECMP path value that is configured by means of the ip load-sharing command.
Modes

BGP configuration mode

BGP address-family IPv6 unicast configuration mode

BGP address-family IPv4 unicast VRF configuration mode

BGP address-family IPv6 unicast VRF configuration mode

Usage Guidelines

Use this command to change the maximum number of BGP4 shared paths, either by setting a value or using the value configured by the ip load-sharing command.

When this command is entered in BGP global configuration mode, it applies only to the IPv4 address family. Use this command in BGP address-family IPv6 unicast configuration mode for BGP4+ configurations.

The no form of the command restores the default.

Examples

The following example sets the maximum number of BGP4 shared paths to 8. 

device# configure terminal
device(config)# router bgp
device(config-bgp-router)# maximum-paths 8

The following example sets the maximum number of BGP4+ shared paths to that of the value already configured using the ip load-sharing command. 

device# configure terminal
device(config)# router bgp
device(config-bgp-router)# address-family ipv6 unicast
device(config-bgp-ipv6u)# maximum-paths use-load-sharing

The following example sets the maximum number of BGP4 shared paths to 2 in a nondefault VRF instance in the IPv4 address family. 

device# configure terminal
device(config)# router bgp
device(config-bgp-router)# address-family ipv4 unicast vrf red
device(config-bgp-ipv4u-vrf)# maximum-paths 2
History
Release version Command history
08.0.30 Support was added for the BGP address-family IPv6 unicast VRF configuration mode.
Parent topic: Commands M