neighbor additional-paths advertise

Configures the additional-paths to advertise to a neighbor for a Border Gateway Protocol (BGP) address family.

Syntax

neighbor { ip-address | ipv6-address | peer-group-name } additional-paths advertise { all [ best num ] [ group-best ] | best num | group-best }

no neighbor { ip-address | ipv6-address | peer-group-name } additional-paths advertise all

no neighbor { ip-address | ipv6-address | peer-group-name } additional-paths advertise best num

no neighbor { ip-address | ipv6-address | peer-group-name } additional-paths advertise group-best

Parameters

ip-address: Address of the neighbor in IPv4 address format.
ipv6-address: Address of the neighbor in IPv6 address format.
peer-group-name: Peer group name of the neighbor.
all: Causes all routes to be advertised as additional-paths to the specified neighbor or peer group. A maximum of 16 routes is allowed.
best num: Specifies the number of best paths allowed for advertisement as additional-paths to the specified neighbor or peer group. The number ranges from 2 through 16.
group-best: Causes group-best paths to be advertised as additional-paths to the specified neighbor or peer group. Only routes with a rank less than or equal to 16 are allowed. A route with a rank greater than 16 (even when it is the group best path), is not eligible for selection as an additional path advertised to a neighbor or peer group.

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

Note

The set of paths configured by using the neighbor additional-paths advertise command must be a subset of selected paths; that is, paths previously configured by using the additional-paths select command under the particular BGP address-family configuration mode.

The additional-paths advertise command options ( all , best , and group-best ) are not mutually exclusive. When you configure a combination of these options, 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, by using the no neighbor additional-paths advertise command specifying the all option to disable the all configuration, and so on.

Examples

The following example shows how to configure the advertisement of all (a maximum of 16 is allowed) routes for a peer device, 10.123.123.1, under 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)# neighbor 10.123.123.1 additional-paths advertise all

The following example shows how to restore the default configuration when all options ( all , best , and group-best ) were previously configured under 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)# no neighbor 10.123.123.1 additional-paths advertise all
device(config-bgp-router-ipv4u)# no neighbor 10.123.123.1 additional-paths advertise best 2
device(config-bgp-router-ipv4u)# no neighbor 10.123.123.1 additional-paths advertise group-best

The following example shows how to configure the advertisement of all (a maximum of 16 routes is allowed) routes for a peer device, 10.123.123.1, under the IPv6 unicast address family.

 device# configure terminal
device(condig)# router bgp
device(config-bgp-router)# address-family ipv6 unicast
device(config-bgp-router-ipv6u)# neighbor 10.123.123.1 additional-paths advertise all