neighbor additional-paths

Enables an additional-paths capability for a specific peer or peer group in a Border Gateway Protocol (BGP) address family.

Syntax

neighbor { ip-address | ipv6-address | peer-group-name } additional-paths { receive [ send ] | send }
no neighbor { ip-address | ipv6-address | peer-group-name } additional-paths receive
no neighbor { ip-address | ipv6-address | peer-group-name } additional-paths send

Command Default

Specific peer devices or peer groups configured under a BGP address family are not capable of receiving or sending additional-paths.

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.
additional-paths
Enables an additional-paths capability.
receive
Enables the capability to receive additional-paths.
send
Enables the capability to send additional-paths.

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

Note

An additional-paths capability configured at peer level takes precedence over any additional-paths capability configured at either the peer group or BGP address family level.

Peers exchange and negotiate additional-paths capability during session establishment.

An additional-paths capability can be enabled for a specific peer or peer group as receive only, send only, or both send and receive.

The no form of the command disables the additional-paths capability for a specific peer device or peer group.

To remove the configuration when both the receive and send options have been set, you should enter both the no neighbor additional-paths command, specifying the receive option to disable the capability to receive additional-paths, and the no neighbor additional-paths command, specifying the send option to disable the capability to send additional-paths.

Examples

The following example shows how to enable a peer device (10.1.2.3) configured under the IPv4 unicast address family to both receive and send additional-paths. 

device# configure terminal
device(config)# router bgp
device(config-bgp-router)# address-family ipv4 unicast
device(config-bgp-ipv4u)# neighbor 10.1.2.3 additional-paths receive send

The following example shows how to disable the capability to receive additional-paths for a specific peer device (10.1.2.3) in the IPv4 unicast address family. 

device# configure terminal
device(config)# router bgp
device(config-bgp-router)# address-family ipv4 unicast
device(config-bgp-ipv4u)# no neighbor 10.1.2.3 additional-paths receive

The following example shows how to enable a peer device (10.1.2.3) configured under the IPv6 unicast address family to both receive and send additional-paths. 

device# configure terminal
device(config)# router bgp
device(config-bgp-router)# address-family ipv6 unicast
device(config-bgp-ipv6u)# neighbor 10.1.2.3 additional-paths receive send
9038039-00 Rev AA