Graceful BGP Session Shutdown
RFC 8326

Document Type RFC - Proposed Standard (March 2018; Errata)
Last updated 2018-06-22
Stream IETF
Formats plain text pdf html bibtex
Reviews GENART will not review this version
Stream WG state Submitted to IESG for Publication
Document shepherd Chris Morrow
Shepherd write-up Show (last changed 2017-09-25)
IESG IESG state RFC 8326 (Proposed Standard)
Consensus Boilerplate Yes
Telechat date
Responsible AD Warren Kumari
Send notices to Christopher Morrow <christopher.morrow@gmail.com>
IANA IANA review state IANA OK - Actions Needed
IANA action state RFC-Ed-Ack
Internet Engineering Task Force (IETF)                  P. Francois, Ed.
Request for Comments: 8326                        Individual Contributor
Category: Standards Track                               B. Decraene, Ed.
ISSN: 2070-1721                                                   Orange
                                                              C. Pelsser
                                                   Strasbourg University
                                                                K. Patel
                                                            Arrcus, Inc.
                                                             C. Filsfils
                                                           Cisco Systems
                                                              March 2018

                     Graceful BGP Session Shutdown

Abstract

   This document standardizes a new well-known BGP community,
   GRACEFUL_SHUTDOWN, to signal the graceful shutdown of paths.  This
   document also describes operational procedures that use this
   well-known community to reduce the amount of traffic lost when BGP
   peering sessions are about to be shut down deliberately, e.g., for
   planned maintenance.

Status of This Memo

   This is an Internet Standards Track document.

   This document is a product of the Internet Engineering Task Force
   (IETF).  It represents the consensus of the IETF community.  It has
   received public review and has been approved for publication by the
   Internet Engineering Steering Group (IESG).  Further information on
   Internet Standards is available in Section 2 of RFC 7841.

   Information about the current status of this document, any errata,
   and how to provide feedback on it may be obtained at
   https://www.rfc-editor.org/info/rfc8326.

Francois, et al.             Standards Track                    [Page 1]
RFC 8326              Graceful BGP Session Shutdown           March 2018

Copyright Notice

   Copyright (c) 2018 IETF Trust and the persons identified as the
   document authors.  All rights reserved.

   This document is subject to BCP 78 and the IETF Trust's Legal
   Provisions Relating to IETF Documents
   (https://trustee.ietf.org/license-info) in effect on the date of
   publication of this document.  Please review these documents
   carefully, as they describe your rights and restrictions with respect
   to this document.  Code Components extracted from this document must
   include Simplified BSD License text as described in Section 4.e of
   the Trust Legal Provisions and are provided without warranty as
   described in the Simplified BSD License.

Table of Contents

   1.  Introduction  . . . . . . . . . . . . . . . . . . . . . . . .   3
   2.  Terminology . . . . . . . . . . . . . . . . . . . . . . . . .   4
   3.  Packet Loss upon Manual EBGP Session Shutdown . . . . . . . .   4
   4.  Procedure for EBGP Graceful Shutdown  . . . . . . . . . . . .   4
     4.1.  Pre-configuration . . . . . . . . . . . . . . . . . . . .   5
     4.2.  Operations at Maintenance Time  . . . . . . . . . . . . .   5
     4.3.  BGP Implementation Support for Graceful Shutdown  . . . .   6
   5.  IANA Considerations . . . . . . . . . . . . . . . . . . . . .   6
   6.  Security Considerations . . . . . . . . . . . . . . . . . . .   6
   7.  References  . . . . . . . . . . . . . . . . . . . . . . . . .   6
     7.1.  Normative References  . . . . . . . . . . . . . . . . . .   6
     7.2.  Informative References  . . . . . . . . . . . . . . . . .   7
   Appendix A.  Alternative Techniques with Limited Applicability  .   8
     A.1.  Multi-Exit Discriminator Tweaking . . . . . . . . . . . .   8
     A.2.  IGP Distance Poisoning  . . . . . . . . . . . . . . . . .   8
   Appendix B.  Configuration Examples . . . . . . . . . . . . . . .   8
     B.1.  Cisco IOS XR  . . . . . . . . . . . . . . . . . . . . . .   9
     B.2.  BIRD  . . . . . . . . . . . . . . . . . . . . . . . . . .   9
     B.3.  OpenBGPD  . . . . . . . . . . . . . . . . . . . . . . . .  10
   Appendix C.  Beyond EBGP Graceful Shutdown  . . . . . . . . . . .  10
     C.1.  IBGP Graceful Shutdown  . . . . . . . . . . . . . . . . .  10
     C.2.  EBGP Session Establishment  . . . . . . . . . . . . . . .  10
   Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . . .  12
   Authors' Addresses  . . . . . . . . . . . . . . . . . . . . . . .  12

Francois, et al.             Standards Track                    [Page 2]
RFC 8326              Graceful BGP Session Shutdown           March 2018

1.  Introduction

   Routing changes in BGP can be caused by planned maintenance
   operations.  This document defines a well-known community [RFC1997],
   called GRACEFUL_SHUTDOWN, for the purpose of reducing the management
   overhead of gracefully shutting down BGP sessions.  The well-known
   community allows implementers to provide an automated graceful
   shutdown mechanism that does not require any router reconfiguration
Show full document text