path: root/docs/configuration/protocols/bgp.rst

.. _bgp:

###
BGP
###

:abbr:`BGP (Border Gateway Protocol)` is one of the Exterior Gateway Protocols
and the de facto standard interdomain routing protocol. The latest BGP version
is 4. BGP-4 is described in :rfc:`1771` and updated by :rfc:`4271`. :rfc:`2858`
adds multiprotocol support to BGP.

VyOS makes use of :abbr:`FRR (Free Range Routing)` and we would like to thank
them for their effort!

Basic Concepts
==============

.. _bgp-autonomous-systems:

Autonomous Systems
------------------

From :rfc:`1930`:

   An AS is a connected group of one or more IP prefixes run by one or more
   network operators which has a SINGLE and CLEARLY DEFINED routing policy.

Each AS has an identifying number associated with it called an :abbr:`ASN
(Autonomous System Number)`. This is a two octet value ranging in value from 1
to 65535. The AS numbers 64512 through 65535 are defined as private AS numbers.
Private AS numbers must not be advertised on the global Internet.

The :abbr:`ASN (Autonomous System Number)` is one of the essential elements of
BGP. BGP is a distance vector routing protocol, and the AS-Path framework
provides distance vector metric and loop detection to BGP.

.. _bgp-address-families:

Address Families
----------------

Multiprotocol extensions enable BGP to carry routing information for multiple
network layer protocols. BGP supports an Address Family Identifier (AFI) for
IPv4 and IPv6.

.. _bgp-route-selection:

Route Selection
---------------

The route selection process used by FRR's BGP implementation uses the following
decision criterion, starting at the top of the list and going towards the
bottom until one of the factors can be used.

1. **Weight check**

   Prefer higher local weight routes to lower routes.

2. **Local preference check**

   Prefer higher local preference routes to lower.

3. **Local route check**

   Prefer local routes (statics, aggregates, redistributed) to received routes.

4. **AS path length check**

   Prefer shortest hop-count AS_PATHs.

5. **Origin check**

   Prefer the lowest origin type route. That is, prefer IGP origin routes to
   EGP, to Incomplete routes.

6. **MED check**

   Where routes with a MED were received from the same AS, prefer the route
   with the lowest MED.

7. **External check**

   Prefer the route received from an external, eBGP peer over routes received
   from other types of peers.

8. **IGP cost check**

   Prefer the route with the lower IGP cost.

9. **Multi-path check**

   If multi-pathing is enabled, then check whether the routes not yet
   distinguished in preference may be considered equal. If
   :cfgcmd:`bgp bestpath as-path multipath-relax` is set, all such routes are
   considered equal, otherwise routes received via iBGP with identical AS_PATHs
   or routes received from eBGP neighbours in the same AS are considered equal.

10. **Already-selected external check**

    Where both routes were received from eBGP peers, then prefer the route
    which is already selected. Note that this check is not applied if
    :cfgcmd:`bgp bestpath compare-routerid` is configured. This check can
    prevent some cases of oscillation.

11. **Router-ID check**

    Prefer the route with the lowest `router-ID`. If the route has an
    `ORIGINATOR_ID` attribute, through iBGP reflection, then that router ID is
    used, otherwise the `router-ID` of the peer the route was received from is
    used.

12. **Cluster-List length check**

    The route with the shortest cluster-list length is used. The cluster-list
    reflects the iBGP reflection path the route has taken.

13. **Peer address**

    Prefer the route received from the peer with the higher transport layer
    address, as a last-resort tie-breaker.

.. _bgp-capability-negotiation:

Capability Negotiation
----------------------

When adding IPv6 routing information exchange feature to BGP. There were some
proposals. :abbr:`IETF (Internet Engineering Task Force)`
:abbr:`IDR (Inter Domain Routing)` adopted a proposal called Multiprotocol
Extension for BGP. The specification is described in :rfc:`2283`. The protocol
does not define new protocols. It defines new attributes to existing BGP. When
it is used exchanging IPv6 routing information it is called BGP-4+. When it is
used for exchanging multicast routing information it is called MBGP.

*bgpd* supports Multiprotocol Extension for BGP. So if a remote peer supports
the protocol, *bgpd* can exchange IPv6 and/or multicast routing information.

Traditional BGP did not have the feature to detect a remote peer's
capabilities, e.g. whether it can handle prefix types other than IPv4 unicast
routes. This was a big problem using Multiprotocol Extension for BGP in an
operational network. :rfc:`2842` adopted a feature called Capability
Negotiation. *bgpd* use this Capability Negotiation to detect the remote peer's
capabilities. If a peer is only configured as an IPv4 unicast neighbor, *bgpd*
does not send these Capability Negotiation packets (at least not unless other
optional BGP features require capability negotiation).

By default, FRR will bring up peering with minimal common capability for the
both sides. For example, if the local router has unicast and multicast
capabilities and the remote router only has unicast capability the local router
will establish the connection with unicast only capability. When there are no
common capabilities, FRR sends Unsupported Capability error and then resets the
connection.

.. _bgp-router-configuration:

BGP Router Configuration
========================

ASN and Router ID
-----------------

.. cfgcmd:: set protocols bgp <asn>

   First of all you must configure BGP router with the :abbr:`ASN (Autonomous
   System Number)`. The AS number is an identifier for the autonomous system.
   The BGP protocol uses the AS number for detecting whether the BGP connection
   is internal or external.

.. cfgcmd:: set protocols bgp <asn> parameters router-id

   This command specifies the router-ID. If router ID is not specified it will
   use the highest interface IP address.

Route Selection
---------------

.. cfgcmd:: set protocols bgp <asn> parameters always-compare-med

   This command provides to compare the MED on routes, even when they were 
   received from different neighbouring ASes. Setting this option makes the 
   order of preference of routes more defined, and should eliminate MED 
   induced oscillations.

.. cfgcmd:: set protocols bgp <asn> parameters bestpath as-path confed

   This command specifies that the length of confederation path sets and
   sequences should be taken into account during the BGP best path
   decision process.

.. cfgcmd:: set protocols bgp <asn> parameters bestpath as-path multipath-relax

   This command specifies that BGP decision process should consider paths
   of equal AS_PATH length candidates for multipath computation. Without
   the knob, the entire AS_PATH must match for multipath computation.

.. cfgcmd:: set protocols bgp <asn> parameters bestpath as-path ignore

   Ignore AS_PATH length when selecting a route

.. cfgcmd:: set protocols bgp <asn> parameters bestpath compare-routerid

   Ensure that when comparing routes where both are equal on most metrics, 
   including local-pref, AS_PATH length, IGP cost, MED, that the tie is 
   broken based on router-ID.

   If this option is enabled, then the already-selected check, where 
   already selected eBGP routes are preferred, is skipped.

   If a route has an ORIGINATOR_ID attribute because it has been reflected, 
   that ORIGINATOR_ID will be used. Otherwise, the router-ID of the peer 
   the route was received from will be used.

   The advantage of this is that the route-selection (at this point) will 
   be more deterministic. The disadvantage is that a few or even one lowest-ID 
   router may attract all traffic to otherwise-equal paths because of this 
   check. It may increase the possibility of MED or IGP oscillation, unless 
   other measures were taken to avoid these. The exact behaviour will be 
   sensitive to the iBGP and reflection topology.

.. cfgcmd:: set protocols bgp <asn> parameters bestpath med confed
   
   This command specifies that BGP considers the MED when comparing routes 
   originated from different sub-ASs within the confederation to which this 
   BGP speaker belongs. The default state, where the MED attribute is not 
   considered.

.. cfgcmd:: set protocols bgp <asn> parameters bestpath med missing-as-worst

   This command specifies that a route with a MED is always considered to be 
   better than a route without a MED by causing the missing MED attribute to 
   have a value of infinity. The default state, where the missing MED 
   attribute is considered to have a value of zero.

.. cfgcmd:: set protocols bgp <asn> parameters default local-pref <local-pref value>

   This command specifies the default local preference value. The local 
   preference range is 0 to 4294967295.
   
.. cfgcmd:: set protocols bgp <asn> parameters deterministic-med

   This command provides to compare different MED values that advertised by 
   neighbours in the same AS for routes selection. When this command is enabled, 
   routes from the same autonomous system are grouped together, and the best 
   entries of each group are compared.

Administrative Distance
-----------------------

.. cfgcmd:: set protocols bgp <asn> parameters distance global <external|internal|local> <distance>

   This command change distance value of BGP. The arguments are the distance 
   values for external routes, internal routes and local routes respectively.
   The distance range is 1 to 255.

.. cfgcmd:: set protocols bgp <asn> parameters distance prefix <subnet> distance <distance>

   This command sets the administrative distance for a particular route. The 
   distance range is 1 to 255.
   
   .. note:: Routes with a distance of 255 are effectively disabled and not
      installed into the kernel.

Network Advertisement
---------------------

.. cfgcmd:: set protocols bgp <asn> address-family <ipv4-unicast|ipv6-unicast> network <prefix>

   This command is used for advertising IPv4 or IPv6 networks.
   
   .. note:: By default, the BGP prefix is advertised even if it's not present in
      the routing table. This behaviour differs from the implementation of some vendors.
   
.. cfgcmd::  set protocols bgp <asn> parameters network-import-check

   This configuration modifies the behavior of the network statement.
   If you have this configured the underlying network must exist in the 
   routing table.

Route Aggregation
-----------------

.. cfgcmd:: set protocols bgp <asn> address-family <ipv4-unicast|ipv6-unicast> aggregate-address <prefix>

   This command specifies an aggregate address. The router will also 
   announce longer-prefixes inside of the aggregate address.

.. cfgcmd:: set protocols bgp <asn> address-family <ipv4-unicast|ipv6-unicast> aggregate-address <prefix> as-set

   This command specifies an aggregate address with a mathematical set of 
   autonomous systems. This command summarizes the AS_PATH attributes of 
   all the individual routes. 

.. cfgcmd:: set protocols bgp <asn> address-family <ipv4-unicast|ipv6-unicast> aggregate-address <prefix> summary-only

   This command specifies an aggregate address and provides that 
   longer-prefixes inside of the aggregate address are suppressed 
   before sending BGP updates out to peers.

Redistribution
--------------

.. cfgcmd:: set protocols bgp <asn> address-family <ipv4-unicast|ipv6-unicast> redistribute connected

   Redistribute connected routes to BGP process.

.. cfgcmd:: set protocols bgp <asn> address-family <ipv4-unicast|ipv6-unicast> redistribute kernel

   Redistribute kernel routes to BGP process.

.. cfgcmd:: set protocols bgp <asn> address-family <ipv4-unicast|ipv6-unicast> redistribute ospf

   Redistribute OSPF routes to BGP process.

.. cfgcmd:: set protocols bgp <asn> address-family <ipv4-unicast|ipv6-unicast> redistribute rip

   Redistribute RIP routes to BGP process.

.. cfgcmd:: set protocols bgp <asn> address-family <ipv4-unicast|ipv6-unicast> redistribute static

   Redistribute static routes to BGP process.

.. cfgcmd:: set protocols bgp <asn> address-family <ipv4-unicast|ipv6-unicast> redistribute <route source> metric <number>

   This command specifies metric (MED) for redistributed routes. The 
   metric range is 0 to 4294967295.

.. cfgcmd:: set protocols bgp <asn> address-family <ipv4-unicast|ipv6-unicast> redistribute <route source> route-map <name>

   This command allows to use route map to filter redistributed routes.

Peers
-----

Defining Peers
^^^^^^^^^^^^^^

.. cfgcmd:: set protocols bgp <asn> neighbor <address|interface> remote-as <nasn>

   This command creates a new neighbor whose remote-as is NASN. The neighbor 
   address can be an IPv4 address or an IPv6 address or an interface to use 
   for the connection. The command it applicable for peer and peer group.

.. cfgcmd:: set protocols bgp <asn> neighbor <address|interface> remote-as internal

   Create a peer as you would when you specify an ASN, except that if the 
   peers ASN is different than mine as specified under the :cfgcmd:`protocols 
   bgp <asn>` command the connection will be denied.

.. cfgcmd:: set protocols bgp <asn> neighbor <address|interface> remote-as external

   Create a peer as you would when you specify an ASN, except that if the 
   peers ASN is the same as mine as specified under the :cfgcmd:`protocols 
   bgp <asn>` command the connection will be denied.

.. cfgcmd:: set protocols bgp <asn> neighbor <address|interface> shutdown
   
   This command disable the peer or peer group. To reenable the peer use 
   the delete form of this command.

.. cfgcmd:: set protocols bgp <asn> neighbor <address|interface> description <text>

   Set description of the peer or peer group.

.. cfgcmd:: set protocols bgp <asn> neighbor <address|interface> update-source <address|interface>

   Specify the IPv4 source address to use for the BGP session to this neighbour,
   may be specified as either an IPv4 address directly or as an interface name.

Capability Negotiation
^^^^^^^^^^^^^^^^^^^^^^

.. cfgcmd:: set protocols bgp <asn> neighbor <address|interface> capability dynamic

   This command would allow the dynamic update of capabilities over an 
   established BGP session.

.. cfgcmd:: set protocols bgp <asn> neighbor <address|interface> capability extended-nexthop

   Allow bgp to negotiate the extended-nexthop capability with it’s peer. 
   If you are peering over a IPv6 Link-Local address then this capability 
   is turned on automatically. If you are peering over a IPv6 Global Address 
   then turning on this command will allow BGP to install IPv4 routes with 
   IPv6 nexthops if you do not have IPv4 configured on interfaces.

.. cfgcmd:: set protocols bgp <asn> neighbor <address|interface> disable-capability-negotiation

   Suppress sending Capability Negotiation as OPEN message optional 
   parameter to the peer. This command only affects the peer is 
   configured other than IPv4 unicast configuration.

   When remote peer does not have capability negotiation feature, 
   remote peer will not send any capabilities at all. In that case,
   bgp configures the peer with configured capabilities.

   You may prefer locally configured capabilities more than the negotiated 
   capabilities even though remote peer sends capabilities. If the peer is 
   configured by :cfgcmd:`override-capability`, VyOS ignores received capabilities 
   then override negotiated capabilities with configured values.

   Additionally you should keep in mind that this feature fundamentally 
   disables the ability to use widely deployed BGP features. BGP unnumbered,
   hostname support, AS4, Addpath, Route Refresh, ORF, Dynamic Capabilities,
   and graceful restart.

.. cfgcmd:: set protocols bgp <asn> neighbor <address|interface> override-capability

   This command allow override the result of Capability Negotiation with 
   local configuration. Ignore remote peer’s capability value.

.. cfgcmd:: set protocols bgp <asn> neighbor <address|interface> strict-capability-match

   This command forces strictly compare remote capabilities and local 
   capabilities. If capabilities are different, send Unsupported Capability
   error then reset connection.

   You may want to disable sending Capability Negotiation OPEN message 
   optional parameter to the peer when remote peer does not implement 
   Capability Negotiation. Please use :cfgcmd:`disable-capability-negotiation` 
   command to disable the feature.

Peer Parameters
^^^^^^^^^^^^^^^

.. cfgcmd:: set protocols bgp <asn> neighbor <address|interface> address-family <ipv4-unicast|ipv6-unicast> allowas-in number <number>

   This command accept incoming routes with AS path containing AS 
   number with the same value as the current system AS. This is 
   used when you want to use the same AS number in your sites,
   but you can’t connect them directly.

   The number parameter (1-10) configures the amount of accepted 
   occurences of the system AS number in AS path.

   This command is only allowed for eBGP peers. It is not applicable 
   for peer groups.

.. cfgcmd:: set protocols bgp <asn> neighbor <address|interface> address-family <ipv4-unicast|ipv6-unicast> as-override

   This command override AS number of the originating router with 
   the local AS number.

   Usually this configuration is used in PEs (Provider Edge) to 
   replace the incoming customer AS number so the connected CE (
   Customer Edge) can use the same AS number as the other customer 
   sites. This allows customers of the provider network to use the 
   same AS number across their sites.

   This command is only allowed for eBGP peers.

.. cfgcmd:: set protocols bgp <asn> neighbor <address|interface> address-family <ipv4-unicast|ipv6-unicast> attribute-unchanged <as-path|med|next-hop>

   This command specifies attributes to be left unchanged for 
   advertisements sent to a peer or peer group.

.. cfgcmd:: set protocols bgp <asn> neighbor <address|interface> address-family <ipv4-unicast|ipv6-unicast> maximum-prefix <number>

   This command specifies a maximum number of prefixes we can receive 
   from a given peer. If this number is exceeded, the BGP session 
   will be destroyed. The number range is 1 to 4294967295.
   
.. cfgcmd:: set protocols bgp <asn> neighbor <address|interface> address-family <ipv4-unicast|ipv6-unicast> nexthop-self

   This command forces the BGP speaker to report itself as the 
   next hop for an advertised route it advertised to a neighbor.

.. cfgcmd:: set protocols bgp <asn> neighbor <address|interface> address-family <ipv4-unicast|ipv6-unicast> remove-private-as

   This command removes the private ASN of routes that are advertised 
   to the configured peer. It removes only private ASNs on routes 
   advertised to EBGP peers.
   
   If the AS-Path for the route has only private ASNs, the private 
   ASNs are removed. 
   
   If the AS-Path for the route has a private ASN between public 
   ASNs, it is assumed that this is a design choice, and the 
   private ASN is not removed.

.. cfgcmd:: set protocols bgp <asn> neighbor <address|interface> address-family <ipv4-unicast|ipv6-unicast> weight <number>

   This command specifies a default weight value for the neighbor’s 
   routes. The number range is 1 to 65535.

.. cfgcmd:: set protocols bgp <asn> neighbor <address|interface> advertisement-interval <seconds>

   This command specifies the minimum route advertisement interval for 
   the peer. This number is between 0 and 600 seconds, with the default 
   advertisement interval being 0.
   
.. cfgcmd:: set protocols bgp <asn> neighbor <address|interface> disable-connected-check

   This command allows peerings between directly connected eBGP peers 
   using loopback addresses without adjusting the default TTL of 1.

.. cfgcmd:: set protocols bgp <asn> neighbor <address|interface> ebgp-multihop <number>

   This command allows sessions to be established with eBGP neighbors 
   when they are multiple hops away. When the neighbor is not directly 
   connected and this knob is not enabled, the session will not establish.
   The number of hops range is 1 to 255. This command is mutually 
   exclusive with :cfgcmd:`ttl-security hops`.

.. cfgcmd:: set protocols bgp <asn> neighbor <address|interface> local-as <asn> [no-prepend] [replace-as]

   Specify an alternate AS for this BGP process when interacting with 
   the specified peer or peer group. With no modifiers, the specified 
   local-as is prepended to the received AS_PATH when receiving routing 
   updates from the peer, and prepended to the outgoing AS_PATH (after 
   the process local AS) when transmitting local routes to the peer.

   If the :cfgcmd:`no-prepend` attribute is specified, then the supplied 
   local-as is not prepended to the received AS_PATH.

   If the :cfgcmd:`replace-as` attribute is specified, then only the supplied 
   local-as is prepended to the AS_PATH when transmitting local-route 
   updates to this peer.

   Note that replace-as can only be specified if no-prepend is.
   This command is only allowed for eBGP peers.

.. cfgcmd:: set protocols bgp <asn> neighbor <address|interface> passive

   Configures the BGP speaker so that it only accepts inbound connections 
   from, but does not initiate outbound connections to the peer or peer group.

.. cfgcmd:: set protocols bgp <asn> neighbor <address|interface> ttl-security hops <number>

   This command enforces Generalized TTL Security Mechanism (GTSM), 
   as specified in :rfc:`5082`. With this command, only neighbors 
   that are the specified number of hops away will be allowed to 
   become neighbors. The number of hops range is 1 to 254. This 
   command is mutually exclusive with :cfgcmd:`ebgp-multihop`.   

Peer Groups
^^^^^^^^^^^

Peer groups are used to help improve scaling by generating the same update 
information to all members of a peer group. Note that this means that the 
routes generated by a member of a peer group will be sent back to that 
originating peer with the originator identifier attribute set to indicated 
the originating peer. All peers not associated with a specific peer group 
are treated as belonging to a default peer group, and will share updates.

.. cfgcmd:: set protocols bgp <asn> peer-group <name>

   This command defines a new peer group. You can specify to the group 
   the same parameters that you can specify for specific neighbors.

.. cfgcmd:: set protocols bgp <asn> neighbor <address|interface> peer-group <name>

   This command bind specific peer to peer group with a given name.

General configuration
---------------------

.. cfgcmd:: set protocols bgp <asn> maximum-paths <ebgp|ibgp> <number>

   This command defines the maximum number of parallel routes that 
   the BGP can support. In order for BGP to use the second path, the 
   following attributes have to match: Weight, Local Preference, AS
   Path (both AS number and AS path length), Origin code, MED, IGP 
   metric. Also, the next hop address for each path must be different. 

.. cfgcmd:: set protocols bgp <asn> parameters default no-ipv4-unicast

   This command allows the user to specify that IPv4 peering is turned off by 
   default.

.. cfgcmd:: set protocols bgp <asn> parameters log-neighbor-changes

   Tis command enable logging neighbor up/down changes and reset reason.

.. cfgcmd:: set protocols bgp <asn> parameters no-client-to-client-reflection

   Tis command disables route reflection between route reflector clients.
   By default, the clients of a route reflector are not required to be 
   fully meshed and the routes from a client are reflected to other clients. 
   However, if the clients are fully meshed, route reflection is not required. 
   In this case, use the :cfgcmd:`no-client-to-client-reflection` command 
   to disable client-to-client reflection.

.. cfgcmd:: set protocols bgp <asn> parameters no-fast-external-failover
   
   Disable immediate sesison reset if peer's connected link goes down.

Timers
^^^^^^

.. cfgcmd:: set protocols bgp <asn> timers holdtime <seconds>

   This command specifies hold-time in seconds. The timer can 
   range from 4 to 65535.The default value is 180 second. If
   you set value to 0 VyOS will not hold routes.
   
.. cfgcmd:: set protocols bgp <asn> timers keepalive <seconds>

   This command specifies keep-alive time in seconds. The timer 
   can range from 4 to 65535.The default value is 60 second.

Operational Mode Commands
=========================

Show
----

.. opcmd:: show <ip|ipv6> bgp 

   This command displays all entries in BGP routing table.

.. code-block:: none

   BGP table version is 10, local router ID is 10.0.35.3, vrf id 0
   Default local pref 100, local AS 65000
   Status codes:  s suppressed, d damped, h history, * valid, > best, = multipath,
                  i internal, r RIB-failure, S Stale, R Removed
   Nexthop codes: @NNN nexthop's vrf id, < announce-nh-self
   Origin codes:  i - IGP, e - EGP, ? - incomplete

      Network          Next Hop            Metric LocPrf Weight Path
   *> 198.51.100.0/24  10.0.34.4                0             0 65004 i
   *> 203.0.113.0/24   10.0.35.5                0             0 65005 i

   Displayed  2 routes and 2 total paths

.. opcmd:: show <ip|ipv6> bgp <address|prefix>

   This command displays information about the particular entry in the BGP routing table.

.. code-block:: none

   BGP routing table entry for 198.51.100.0/24
   Paths: (1 available, best #1, table default)
     Advertised to non peer-group peers:
     10.0.13.1 10.0.23.2 10.0.34.4 10.0.35.5
     65004
       10.0.34.4 from 10.0.34.4 (10.0.34.4)
         Origin IGP, metric 0, valid, external, best (First path received)
         Last update: Wed Jan  6 12:18:53 2021

.. opcmd:: show ip bgp cidr-only

   This command displays routes with classless interdomain routing (CIDR).

.. opcmd:: show <ip|ipv6> bgp community <value>

   This command displays routes that belong to specified BGP communities.
   Valid value is a community number in the range from 1 to 4294967200, 
   or AA:NN (autonomous system-community number/2-byte number), no-export,
   local-as, or no-advertise.

.. opcmd:: show <ip|ipv6> bgp community-list <name>

   This command displays routes that are permitted by the BGP 
   community list.

.. opcmd:: show ip bgp dampened-paths

   This command displays BGP dampened routes.

.. opcmd:: show <ip|ipv6> bgp neighbors <address> advertised-routes

   This command displays BGP routes advertised to a neighbor.

.. opcmd:: show <ip|ipv6> bgp neighbors <address> received-routes

   This command displays BGP routes originating from the specified BGP 
   neighbor before inbound policy is applied. To use this command inbound 
   soft reconfiguration must be enabled.

.. opcmd:: show <ip|ipv6> bgp neighbors <address> routes

   This command displays BGP received-routes that are accepted after filtering.
   
.. opcmd:: show <ip|ipv6> bgp neighbors <address> dampened-routes

   This command displays dampened routes received from BGP neighbor.
   
.. opcmd:: show <ip|ipv6> bgp regexp <text>

   This command displays information about BGP routes whose AS path 
   matches the specified regular expression. 

.. opcmd:: show <ip|ipv6> bgp summary

   This command displays the status of all BGP connections.

.. code-block:: none

   IPv4 Unicast Summary:
   BGP router identifier 10.0.35.3, local AS number 65000 vrf-id 0
   BGP table version 11
   RIB entries 5, using 920 bytes of memory
   Peers 4, using 82 KiB of memory
   
   Neighbor        V         AS MsgRcvd MsgSent   TblVer  InQ OutQ  Up/Down State/PfxRcd
   10.0.13.1       4      65000     148     159        0    0    0 02:16:01            0
   10.0.23.2       4      65000     136     143        0    0    0 02:13:21            0
   10.0.34.4       4      65004     161     163        0    0    0 02:16:01            1
   10.0.35.5       4      65005     162     166        0    0    0 02:16:01            1
   
   Total number of neighbors 4

Reset
-----

.. opcmd:: reset <ip|ipv6> bgp <address> [soft [in|out]]

   This command resets BGP connections to the specified neighbor IP address.
   With argument :cfgcmd:`soft` this command initiates a soft reset. If
   you do not specify the :cfgcmd:`in` or :cfgcmd:`out` options, both 
   inbound and outbound soft reconfiguration are triggered.

.. opcmd:: reset ip bgp all

   This command resets all BGP connections of given router.

.. opcmd:: reset ip bgp dampening

   This command uses to clear BGP route dampening information and to 
   unsuppress suppressed routes.

.. opcmd:: reset ip bgp external

   This command resets all external BGP peers of given router.
   
.. opcmd:: reset ip bgp peer-group <name> [soft [in|out]]

   This command resets BGP connections to the specified peer group.
   With argument :cfgcmd:`soft` this command initiates a soft reset. If
   you do not specify the :cfgcmd:`in` or :cfgcmd:`out` options, both 
   inbound and outbound soft reconfiguration are triggered.

Configuration Examples
----------------------

IPv4
^^^^

A simple eBGP configuration:

**Node 1:**

.. code-block:: none

  set protocols bgp 65534 neighbor 192.168.0.2 ebgp-multihop '2'
  set protocols bgp 65534 neighbor 192.168.0.2 remote-as '65535'
  set protocols bgp 65534 neighbor 192.168.0.2 update-source '192.168.0.1'
  set protocols bgp 65534 address-family ipv4-unicast network '172.16.0.0/16'
  set protocols bgp 65534 parameters router-id '192.168.0.1'

**Node 2:**

.. code-block:: none

  set protocols bgp 65535 neighbor 192.168.0.1 ebgp-multihop '2'
  set protocols bgp 65535 neighbor 192.168.0.1 remote-as '65534'
  set protocols bgp 65535 neighbor 192.168.0.1 update-source '192.168.0.2'
  set protocols bgp 65535 address-family ipv4-unicast network '172.17.0.0/16'
  set protocols bgp 65535 parameters router-id '192.168.0.2'


Don't forget, the CIDR declared in the network statement MUST **exist in your
routing table (dynamic or static), the best way to make sure that is true is
creating a static route:**

**Node 1:**

.. code-block:: none

  set protocols static route 172.16.0.0/16 blackhole distance '254'

**Node 2:**

.. code-block:: none

  set protocols static route 172.17.0.0/16 blackhole distance '254'


IPv6
^^^^

A simple BGP configuration via IPv6.

**Node 1:**

.. code-block:: none

  set protocols bgp 65534 neighbor 2001:db8::2 ebgp-multihop '2'
  set protocols bgp 65534 neighbor 2001:db8::2 remote-as '65535'
  set protocols bgp 65534 neighbor 2001:db8::2 update-source '2001:db8::1'
  set protocols bgp 65534 neighbor 2001:db8::2 address-family ipv6-unicast
  set protocols bgp 65534 address-family ipv6-unicast network '2001:db8:1::/48'
  set protocols bgp 65534 parameters router-id '10.1.1.1'

**Node 2:**

.. code-block:: none

  set protocols bgp 65535 neighbor 2001:db8::1 ebgp-multihop '2'
  set protocols bgp 65535 neighbor 2001:db8::1 remote-as '65534'
  set protocols bgp 65535 neighbor 2001:db8::1 update-source '2001:db8::2'
  set protocols bgp 65535 neighbor 2001:db8::1 address-family ipv6-unicast
  set protocols bgp 65535 address-family ipv6-unicast network '2001:db8:2::/48'
  set protocols bgp 65535 parameters router-id '10.1.1.2'

Don't forget, the CIDR declared in the network statement **MUST exist in your
routing table (dynamic or static), the best way to make sure that is true is
creating a static route:**

**Node 1:**

.. code-block:: none

  set protocols static route6 2001:db8:1::/48 blackhole distance '254'

**Node 2:**

.. code-block:: none

  set protocols static route6 2001:db8:2::/48 blackhole distance '254'

Route Filter
^^^^^^^^^^^^

Route filter can be applied using a route-map:

**Node1:**

.. code-block:: none

  set policy prefix-list AS65535-IN rule 10 action 'permit'
  set policy prefix-list AS65535-IN rule 10 prefix '172.16.0.0/16'
  set policy prefix-list AS65535-OUT rule 10 action 'deny'
  set policy prefix-list AS65535-OUT rule 10 prefix '172.16.0.0/16'
  set policy prefix-list6 AS65535-IN rule 10 action 'permit'
  set policy prefix-list6 AS65535-IN rule 10 prefix '2001:db8:2::/48'
  set policy prefix-list6 AS65535-OUT rule 10 action 'deny'
  set policy prefix-list6 AS65535-OUT rule 10 prefix '2001:db8:2::/48'
  set policy route-map AS65535-IN rule 10 action 'permit'
  set policy route-map AS65535-IN rule 10 match ip address prefix-list 'AS65535-IN'
  set policy route-map AS65535-IN rule 10 match ipv6 address prefix-list 'AS65535-IN'
  set policy route-map AS65535-IN rule 20 action 'deny'
  set policy route-map AS65535-OUT rule 10 action 'deny'
  set policy route-map AS65535-OUT rule 10 match ip address prefix-list 'AS65535-OUT'
  set policy route-map AS65535-OUT rule 10 match ipv6 address prefix-list 'AS65535-OUT'
  set policy route-map AS65535-OUT rule 20 action 'permit'
  set protocols bgp 65534 neighbor 2001:db8::2 address-family ipv4-unicast route-map export 'AS65535-OUT'
  set protocols bgp 65534 neighbor 2001:db8::2 address-family ipv4-unicast route-map import 'AS65535-IN'
  set protocols bgp 65534 neighbor 2001:db8::2 address-family ipv6-unicast route-map export 'AS65535-OUT'
  set protocols bgp 65534 neighbor 2001:db8::2 address-family ipv6-unicast route-map import 'AS65535-IN'

**Node2:**

.. code-block:: none

  set policy prefix-list AS65534-IN rule 10 action 'permit'
  set policy prefix-list AS65534-IN rule 10 prefix '172.17.0.0/16'
  set policy prefix-list AS65534-OUT rule 10 action 'deny'
  set policy prefix-list AS65534-OUT rule 10 prefix '172.17.0.0/16'
  set policy prefix-list6 AS65534-IN rule 10 action 'permit'
  set policy prefix-list6 AS65534-IN rule 10 prefix '2001:db8:1::/48'
  set policy prefix-list6 AS65534-OUT rule 10 action 'deny'
  set policy prefix-list6 AS65534-OUT rule 10 prefix '2001:db8:1::/48'
  set policy route-map AS65534-IN rule 10 action 'permit'
  set policy route-map AS65534-IN rule 10 match ip address prefix-list 'AS65534-IN'
  set policy route-map AS65534-IN rule 10 match ipv6 address prefix-list 'AS65534-IN'
  set policy route-map AS65534-IN rule 20 action 'deny'
  set policy route-map AS65534-OUT rule 10 action 'deny'
  set policy route-map AS65534-OUT rule 10 match ip address prefix-list 'AS65534-OUT'
  set policy route-map AS65534-OUT rule 10 match ipv6 address prefix-list 'AS65534-OUT'
  set policy route-map AS65534-OUT rule 20 action 'permit'
  set protocols bgp 65535 neighbor 2001:db8::1 address-family ipv4-unicast route-map export 'AS65534-OUT'
  set protocols bgp 65535 neighbor 2001:db8::1 address-family ipv4-unicast route-map import 'AS65534-IN'
  set protocols bgp 65535 neighbor 2001:db8::1 address-family ipv6-unicast route-map export 'AS65534-OUT'
  set protocols bgp 65535 neighbor 2001:db8::1 address-family ipv6-unicast route-map import 'AS65534-IN'

We could expand on this and also deny link local and multicast in the rule 20
action deny.