peer preferred-value
Function
The peer preferred-value command sets a preferred value for the routes that a BGP device learns from its peer.
The undo peer preferred-value command restores the default preferred value for the routes that a BGP device learns from its peer.
By default, the preferred value of a route learned from a BGP peer is 0.
Format
peer { group-name | ipv4-address | ipv6-address } preferred-value value
undo peer { group-name | ipv4-address | ipv6-address } preferred-value
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. |
| value | Specifies the preferred value of the routes that a BGP device learns from its peer. | The value is an integer that ranges from 0 to 65535. |
ipv4-address is valid only in the BGP view, BGP-IPv4 unicast address family view, BGP-IPv4 multicast address family view, BGP-VPN instance IPv4 address family view, BGP-VPNv4 address family view, BGP L2VPN-AD address family view, BGP-IPv6 unicast address family view, and BGP-VPNv6 address family view.
ipv6-address is valid only in the BGP-IPv6 unicast address family view and BGP-VPN instance IPv6 address family view.
Views
BGP view, BGP-IPv4 unicast address family view, BGP-IPv4 multicast address family view, BGP-VPN instance IPv4 address family view, BGP-VPNv4 address family view, BGP-IPv6 unicast address family view, BGP-VPN instance IPv6 address family view, BGP-VPNv6 address family view, BGP L2VPN-AD address family view
Usage Guidelines
Usage Scenario
After the peer preferred-value command is run, all the routes learned from the specified peer have the preferred value. If there are multiple routes to the same address prefix, the route with the highest preferred value is preferred.
Prerequisites
A BGP peer has been configured. If the peer preferred-value command is used but no BGP peer exists, a message is displayed, indicating that the peer does not exist.
Precautions
If a preferred value is set for the routes that a BGP device learns from a peer group, all members of the peer group inherit the configuration.