This is the documentation for the 20.02 version. Looking for the documentation of the latest version? Have a look here.
BGP Address Family Neighbor Configuration¶
From within a BGP address family configuration mode, the
<existing-neighbor> command specifies an existing neighbor defined in
BGP Neighbor Configuration mode. This command then enters an address-family-specific
neighbor mode. Like address families, the prefix for this mode varies based on
the family and type of address family it is run within. For example, with
IPv4 unicast mode, the prompt is
tnsr(config-bgp-ip4uni)# neighbor 203.0.113.14 tnsr(config-bgp-ip4uni-nbr)#
The following commands are available in
Activate this neighbor for use by BGP.
Advertise all known paths to this peer, instead of only advertising the base path.
Advertise only the best known base paths for each AS.
- allowas-in [<occurrence>|origin]
Allows routes to be received from this peer which are from the same AS of this router, but through a different path.
Allowed number of AS occurrences, from
Accept the AS of this router in an AS-path if the route originated in the AS of this router.
Override ASNs in outbound updates to this peer if the AS path is identical to the remote AS.
- attribute-unchanged [as-path|next-hop|med]
Propagates route attributes to this peer unchanged. This behavior can be optionally restricted to only specific attributes, including the
- capability orf prefix-list (send|receive|both)
Advertise outbound route filtering capability to this peer. This behavior can be restricted by direction,
- default-originate [route-map <route-map>]
Enables advertisement of a default route to this peer.
- route-map <route-map>
Restricts this behavior based on the specified route map.
- distribute-list <access-list-name> (in|out)
Defines an access list which is used by BGP to filter route updates for this peer, in either the
- filter-list <aspath-name> (in|out)
Defines a list which is used by BGP to filter route updates by AS path, rather than prefix.
- maximum-prefix [(limit|restart|threshold) <value>|warning-only]
Defines the maximum number of prefixes this router will accept from the peer before tearing down the BGP session.
This action is considered harsh and the best practice is to filter received prefixes by other mechanisms such as a
prefix-listrather than to abruptly break contact in this way.
- limit <val>
The maximum number of prefixes to allow from the peer, from
- restart <val>
Restarts the connection after limits are exceeded. The restart is performed at the defined interval, in minutes, from
- threshold <val>
Warning message threshold, from
Warn the peer when the limit is exceeded, rather than disconnecting.
- next-hop-self [force]
Uses the address of this router as the next-hop in routes announced to this peer if they are learned via eBGP.
When present, also sets the next-hop to the address of this router on reflected routes.
- prefix-list <prefix-list-name> (in|out)
Defines a prefix list which is used by BGP to filter route updates for this peer, in either the
- remove-private-AS [all] [replace-AS]
Prevents the BGP daemon from sending routes with private AS numbers to this peer.
When present, this action applies to all ASNs.
When present, replaces private AS numbers with the AS number of this router.
- route-map <name> (in|out)
Defines a route map which is used by BGP to filter route updates for this peer, in either the
Configures this peer as a route reflector client. This allows routes received from peers in the same AS or using iBGP to be reflected to other peers, avoiding the need for a full mesh configuration between all routing peers.
Configures this peer as a route server client. This enables transparent mode, which retains attributes unmodified, and maintains a local RIB for this peer.
- send-community (standard|large|extended)
Sends the community attribute to this peer, limited to the specified type (
- soft-reconfiguration inbound
Allows the peer to send requests for soft reconfiguration, to apply changes to routes or new attributes without the need for a session reset.
- unsuppress-map <route-map>
Configures a route map which BGP can use to unsuppress routes that would otherwise be suppressed by other configuration settings.
- weight <weight>
Applies the given weight to routes received from this peer.