additional-paths select

Configures routes that are eligible for selection as additional-paths by peers configured under a Border Gateway Protocol (BGP) address family.

Syntax

additional-paths select { all [ best num ] [ group-best ] | best num | group-best }

no additional-paths select all

no additional-paths select best num

no additional-paths select group-best

Parameters

all: Causes all routes to be eligible for selection as additional-paths. A maximum of 16 routes is allowed.
best num: Specifies the number of best paths allowed for selection as additonal-paths. The number ranges from 2 through 16.
group-best: Causes all group-best paths to be eligible for selection as additional-paths. Only routes with a rank less than or equal to 16 are allowed. Even when it is the group best, a route with a rank greater than 16 is not eligible for selection as an additional path.

Modes

BGP address-family IPv4 unicast configuration mode

BGP address-family IPv4 unicast VRF configuration mode

BGP address-family IPv6 unicast configuration mode

BGP address-family IPv6 unicast VRF configuration mode

Usage Guidelines

The all, best, and group-best options are not mutually exclusive. When you perform a combination of these commands, the combined configuration is applied to the BGP address family.

The no form of the command removes the specified configuration.

When more than one option is configured, it is recommended that you disable each configured option separately; for example, disable the all configuration by using the no additional-paths select command specifying the all option, and so on.

Examples

The following example shows how to configure all (up to a maximum of 16) routes to be eligible for selection as additional-paths by all peers in the IPv4 unicast address family.

device# configure terminal
device(condig)# router bgp
device(config-bgp-router)# address-family ipv4 unicast
device(config-bgp-router-ipv4u)# additional-paths select all

The following example shows how to restore the default configuration when the all, best, and group-best options were previously configured for the IPv4 unicast address family. It is recommended that you disable each configuration option separately.

device# configure terminal
device(condig)# router bgp
device(config-bgp-router)# address-family ipv4 unicast
device(config-bgp-router-ipv4u)# no additional-paths select all
device(config-bgp-router-ipv4u)# no additional-paths select best 2
device(config-bgp-router-ipv4u)# no additional-paths select group-best