From 252c55900b3442a7ce35536edef1cab5cc915607 Mon Sep 17 00:00:00 2001 From: Rafael Zalamena Date: Tue, 4 Aug 2020 18:19:27 -0300 Subject: doc: document bgp AS override Document the command `as-override` and attempt to provide an useful explanation. Signed-off-by: Rafael Zalamena --- doc/user/bgp.rst | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/doc/user/bgp.rst b/doc/user/bgp.rst index 795ca00ec..741f0c7df 100644 --- a/doc/user/bgp.rst +++ b/doc/user/bgp.rst @@ -1341,6 +1341,19 @@ Configuring Peers This command is only allowed for eBGP peers. +.. index:: [no] neighbor as-override +.. clicmd:: [no] neighbor as-override + + 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. + .. index:: [no] neighbor PEER ttl-security hops NUMBER .. clicmd:: [no] neighbor PEER ttl-security hops NUMBER -- cgit v1.2.3 From ae1e0f32992a44c4899d8145bc69fa71c8290855 Mon Sep 17 00:00:00 2001 From: Rafael Zalamena Date: Tue, 4 Aug 2020 18:35:53 -0300 Subject: doc: document allowas-in Document the command `allowas-in` and attempt to provide an useful explanation. Signed-off-by: Rafael Zalamena --- doc/user/bgp.rst | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/doc/user/bgp.rst b/doc/user/bgp.rst index 741f0c7df..a56532765 100644 --- a/doc/user/bgp.rst +++ b/doc/user/bgp.rst @@ -1354,6 +1354,24 @@ Configuring Peers This command is only allowed for eBGP peers. +.. index:: [no] neighbor allowas-in [<(1-10)|origin>] +.. clicmd:: [no] neighbor allowas-in [<(1-10)|origin>] + + 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. This is an alternative to + `neighbor WORD as-override`. + + The parameter `(1-10)` configures the amount of accepted occurences of the + system AS number in AS path. + + The parameter `origin` configures BGP to only accept routes originated with + the same AS number as the system. + + This command is only allowed for eBGP peers. + .. index:: [no] neighbor PEER ttl-security hops NUMBER .. clicmd:: [no] neighbor PEER ttl-security hops NUMBER -- cgit v1.2.3 From 70335e0a8cd3adf17a8ae4bc1d015f146fdbf3b4 Mon Sep 17 00:00:00 2001 From: Rafael Zalamena Date: Tue, 4 Aug 2020 18:47:54 -0300 Subject: doc: improve neighbor shutdown Add more neighbor shutdown documentation and reference the RFC. Signed-off-by: Rafael Zalamena --- bgpd/bgp_vty.c | 4 ++-- doc/user/bgp.rst | 6 ++++-- doc/user/overview.rst | 4 ++++ 3 files changed, 10 insertions(+), 4 deletions(-) diff --git a/bgpd/bgp_vty.c b/bgpd/bgp_vty.c index cfdad6d6c..c53286cb3 100644 --- a/bgpd/bgp_vty.c +++ b/bgpd/bgp_vty.c @@ -4388,7 +4388,7 @@ DEFUN (neighbor_shutdown_msg, NEIGHBOR_STR NEIGHBOR_ADDR_STR2 "Administratively shut down this neighbor\n" - "Add a shutdown message (draft-ietf-idr-shutdown-06)\n" + "Add a shutdown message (RFC 8203)\n" "Shutdown message\n") { int idx_peer = 1; @@ -4420,7 +4420,7 @@ DEFUN (no_neighbor_shutdown_msg, NEIGHBOR_STR NEIGHBOR_ADDR_STR2 "Administratively shut down this neighbor\n" - "Remove a shutdown message (draft-ietf-idr-shutdown-06)\n" + "Remove a shutdown message (RFC 8203)\n" "Shutdown message\n") { int idx_peer = 2; diff --git a/doc/user/bgp.rst b/doc/user/bgp.rst index a56532765..98e84c8aa 100644 --- a/doc/user/bgp.rst +++ b/doc/user/bgp.rst @@ -1203,14 +1203,16 @@ Defining Peers Configuring Peers ^^^^^^^^^^^^^^^^^ -.. index:: [no] neighbor PEER shutdown -.. clicmd:: [no] neighbor PEER shutdown +.. index:: [no] neighbor PEER shutdown [message MSG...] +.. clicmd:: [no] neighbor PEER shutdown [message MSG...] Shutdown the peer. We can delete the neighbor's configuration by ``no neighbor PEER remote-as ASN`` but all configuration of the neighbor will be deleted. When you want to preserve the configuration, but want to drop the BGP peer, use this syntax. + Optionally you can specify a shutdown message `MSG`. + .. index:: [no] neighbor PEER disable-connected-check .. clicmd:: [no] neighbor PEER disable-connected-check diff --git a/doc/user/overview.rst b/doc/user/overview.rst index adc20936e..ac6a1e5a8 100644 --- a/doc/user/overview.rst +++ b/doc/user/overview.rst @@ -290,6 +290,8 @@ BGP :t:`A Border Gateway Protocol 4 (BGP-4). Updates RFC1771. Y. Rekhter, T. Li & S. Hares. January 2006.` - :rfc:`4364` :t:`BGP/MPLS IP Virtual Private Networks (VPNs). Y. Rekhter. Feb 2006.` +- :rfc:`4486` + :t:`Subcodes for BGP Cease Notification Message. E. Chen, V. Gillet. April 2006.` - :rfc:`4659` :t:`BGP-MPLS IP Virtual Private Network (VPN) Extension for IPv6 VPN. J. De Clercq, D. Ooms, M. Carugi, F. Le Faucheur. September 2006.` - :rfc:`4893` @@ -320,6 +322,8 @@ BGP :t:`BGP Large Communities Attribute. J. Heitz, Ed., J. Snijders, Ed, K. Patel, I. Bagdonas, N. Hilliard. February 2017` - :rfc:`8195` :t:`Use of BGP Large Communities. J. Snijders, J. Heasley, M. Schmidt, June 2017` +- :rfc:`8203` + :t:`BGP Administrative Shutdown Communication. J. Snijders, J. Heitz, J. Scudder. July 2017.` - :rfc:`8212` :t:`Default External BGP (EBGP) Route Propagation Behavior without Policies. J. Mauch, J. Snijders, G. Hankins. July 2017` - :rfc:`8277` -- cgit v1.2.3 From e03bf6fc89ae57b745cc56edb0cd9abc148df1bd Mon Sep 17 00:00:00 2001 From: Rafael Zalamena Date: Tue, 4 Aug 2020 19:31:11 -0300 Subject: doc: document addpath Document the commands `addpath-tx-all-paths`, `addpath-tx-bestpath-per-AS` and attempt to provide an useful explanation. Signed-off-by: Rafael Zalamena --- doc/user/bgp.rst | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/doc/user/bgp.rst b/doc/user/bgp.rst index 98e84c8aa..cc27bc202 100644 --- a/doc/user/bgp.rst +++ b/doc/user/bgp.rst @@ -1374,6 +1374,18 @@ Configuring Peers This command is only allowed for eBGP peers. +.. index:: [no] neighbor addpath-tx-all-paths +.. clicmd:: [no] neighbor addpath-tx-all-paths + + Configure BGP to send all known paths to neighbor in order to preserve multi + path capabilities inside a network. + +.. index:: [no] neighbor addpath-tx-bestpath-per-AS +.. clicmd:: [no] neighbor addpath-tx-bestpath-per-AS + + Configure BGP to send best known paths to neighbor in order to preserve multi + path capabilities inside a network. + .. index:: [no] neighbor PEER ttl-security hops NUMBER .. clicmd:: [no] neighbor PEER ttl-security hops NUMBER -- cgit v1.2.3