peer capability-advertise
Function
The peer capability-advertise command enables a BGP device to advertise optional BGP capabilities to its peer.
The undo peer capability-advertise command restores the default setting.
By default, a BGP device advertises route-refresh and 4-byte AS number capabilities to its peer.
Format
peer { group-name | ipv4-address } capability-advertise { 4-byte-as | route-refresh | conventional }
peer ipv6-address capability-advertise { 4-byte-as | route-refresh }
undo peer { group-name | ipv4-address } capability-advertise { 4-byte-as | route-refresh | conventional }
undo peer ipv6-address capability-advertise { 4-byte-as | route-refresh }
Parameters
| 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. |
| ipv4-address | Specifies the IPv4 address of a peer. | It is in dotted decimal notation. |
| ipv6-address | Specifies the IPv6 address of a peer. | The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X. |
| 4-byte-as | Indicates the 4-byte AS number capability. | - |
| route-refresh | Indicates the route-refresh capability. | - |
| conventional | Indicates the regular router capability. | - |
ipv4-address is valid only in the BGP view and BGP-VPN instance IPv4 address family view.
ipv6-address is valid only in the BGP view and BGP-VPN instance IPv6 address family view.
Views
BGP view, BGP-VPN instance IPv4 address family view, BGP-VPN instance IPv6 address family view
Usage Guidelines
Usage Scenario
The peer capability-advertise route-refresh command is used to configure a device to advertise the route-refresh capability to its peer.
The peer capability-advertise conventional command is used to configure a device to advertise the regular router capability to its peer. If conventional is specified in the command, the router does not have all extension functions such as route-refresh capability, GR capability, and multi-address family negotiation. This allows the router to be compatible with routers of earlier versions.
The peer capability-advertise 4-byte-as command is used to configure a device to advertise the 4-byte AS number capability to its peer. If AS number resources are used up, this command can be used to configure devices to use 4-byte AS numbers.
Prerequisites
Peer relationships have been established using the peer as-number command.
The corresponding BGP session must be in the Established state.
Precautions
If you enable or disable the route-refresh, general router, or 4-byte AS number 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.