The peer capability-advertise command enables optional BGP functions when a BGP peer advertises routes to its peer. The optional BGP functions include route-refresh, general function, 4-byte AS number, and Add-Path.
The undo peer capability-advertise command restores the default setting.
By default, the route-refresh and 4-byte AS number functions are enabled, but the general function and Add-Path are disabled.
Parameter | Description | Value |
---|---|---|
group-name |
Specifies the name of a peer group. |
The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string. |
add-path |
Indicates the Add-Path function. add-path takes effect only on IBGP peers. |
- |
both |
Enables the RR to receive Add-Path routes from and send Add-Path routes to a specified IBGP peer. |
- |
receive |
Enables the RR to receive Add-Path routes from a specified IBGP peer. |
- |
send |
Enables the RR to send Add-Path routes to a specified IBGP peer. |
- |
Usage Scenario
There are multiple optional BGP functions when a BGP peer advertises routes to its peer. The optional BGP functions include route-refresh, general function, 4-byte AS number, and Add-Path. You can run the peer capability-advertise command to select one of the functions based on the needs on the live network.
Configuration Impact
If you enable or disable the route-refresh, general function, 4-byte AS number, or Add-Path function, the BGP peer relationship will be re-established, which can lead to a temporary network interruption. Therefore, exercise caution when running the related commands.
Precautions
If a peer is specified when the peer capability-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.
<HUAWEI> system-view [~HUAWEI] bgp 100 [*HUAWEI-bgp] group test [*HUAWEI-bgp] ipv6-family vpnv6 [*HUAWEI-bgp-af-vpnv6] peer test enable [*HUAWEI-bgp-af-vpnv6] peer test capability-advertise add-path both