peer advertise add-path(BGP-MVPN address family view)

Function

The peer advertise add-path command configures the maximum number of routes that the device can send to a specified peer.

The undo peer advertise add-path command restores the default configurations.

By default, the device sends only the optimal route to a peer.

Format

peer ipv4-address advertise add-path path-number number

peer ipv6-address advertise add-path path-number number

undo peer ipv4-address advertise add-path

undo peer ipv6-address advertise add-path

Parameters

Parameter	Description	Value
ipv4-address	Specifies the IPv4 address of a peer.	The value is in dotted decimal notation.
path-number number	Specifies the maximum number of routes that the device can send.	The value is an integer ranging from 2 to 64.
ipv6-address	Specifies the address of the IPv6 peer to be displayed.	The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Parameter

Description

Value

ipv4-address

Specifies the IPv4 address of a peer.

The value is in dotted decimal notation.

path-number number

Specifies the maximum number of routes that the device can send.

The value is an integer ranging from 2 to 64.

ipv6-address

Specifies the address of the IPv6 peer to be displayed.

The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.

Views

BGP-MVPN address family view

Default Level

2: Configuration level

Task Name and Operations

Task Name	Operations
bgp	write

Usage Guidelines

Usage Scenario

After BGP Add-Path is configured on an RR, the RR needs to send routes to a specified peer. To configure the maximum number of routes that the RR can send to the peer, run the peer advertise add-path command. The actual number of routes that the RR can send to the peer is the smaller one of the value configured using the peer advertise add-path command and the actual number of routes selected by the RR. If the maximum number of routes that the RR can send to the peer is less than the actual number of routes selected by the RR, the RR selects the optimal and Add-Path routes based on the BGP route selection rules.

Prerequisites

The following operations have been performed:

BGP Add-Path has been enabled and the maximum number of routes that an RR can select has been configured using the bestroute add-path command.
The RR has been enabled to send Add-Path routes to a specified IBGP peer using the peer capability-advertise add-path send command.

Precautions

You need to run the peer capability-advertise add-path receive command on a peer so that the peer can have Add-Path routes from the specified RR.
The RR can send Add-Path routes to BGP peers, and Add-Path routes are advertised based on BGP route advertisement rules.
If a peer is specified when the peer advertise add-path command is run, a peer group is specified when the peer advertise best-external command is run, and then the peer is added to the peer group, the peer cannot inherit the configuration of the peer advertise best-external command from the peer group.

Example

# Set the maximum number of Add-Path routes that the device can send to a peer in the BGP-MVPN address family view.

<HUAWEI> system-view
[~HUAWEI] bgp 100
[*HUAWEI-bgp] peer 10.1.1.1 as-number 100
[*HUAWEI-bgp] ipv4-family mvpn
[*HUAWEI-bgp-af-mvpn] peer 10.1.1.1 enable
[*HUAWEI-bgp-af-mvpn] peer 10.1.1.1 advertise add-path path-number 3