neighbor graceful-shutdown

Syntax

neighbor {<IPV4-ADDR>|<IPV6-ADDR>|<PEER-GROUP-NAME>} graceful-shutdown 
     local-preference <LOCAL-PREFERENCE>

neighbor {<IPV4-ADDR>|<IPV6-ADDR>|<PEER-GROUP-NAME>} graceful-shutdown 
     <CONFIG-DELAY>

neighbor {<IPV4-ADDR>|<IPV6-ADDR>|<PEER-GROUP-NAME>} graceful-shutdown 
     <CONFIG-DELAY> local-preference <LOCAL-PREFERENCE>

neighbor {<IPV4-ADDR>|<IPV6-ADDR>|<PEER-GROUP-NAME>} graceful-shutdown

no neighbor {<IPV4-ADDR>|<IPV6-ADDR>|<PEER-GROUP-NAME>} graceful-shutdown 
     [local-preference <LOCAL-PREFERENCE>|<CONFIG-DELAY>|<CONFIG-DELAY> 
     local-preference <LOCAL-PREFERENCE>]

no neighbor {<IPV4-ADDR>|<IPV6-ADDR>|<PEER-GROUP-NAME>} graceful-shutdown

Description

This command configures the wait time in seconds before the BGP neighbor session is shut down. It can also configure the local-preference value to be advertised before graceful shutdown.

The no form of this command resets the wait time to the default value of 180 seconds and the local-preference value to the default of 0.

Command context

config-bgp

Parameters

<IPV4-ADDR>|<IPV6-ADDR>

Specifies an IPv4 address or IPv6 address.

<PEER-GROUP-NAME>

Specifies a peer group.

local-preference

Specifies the local-preference value to be advertised before the graceful shutdown.

<CONFIG-DELAY>

Specifies the time to wait before shutting down the neighbor. Default: 180 seconds. Range: 10 seconds to 1,200 seconds.

<LOCAL-PREFERENCE>

Specifies the local-preference value for exporting the iBGP routes during a graceful shutdown. The lower the value, the lower the local preference. A value of 0 indicates that the route is the least preferred. Default: 0. Range: 0-4294967295.

Authority

Administrators

Usage

If the graceful shutdown timer has already started and the administrator configures a command that triggers a session restart, traffic loss can occur if the graceful shutdown delay is not sufficient for the BGP peers to converge to a new route.

NOTE:

On each Autonomous System Boundary Router (ASBR) supporting the graceful shutdown receiver procedure, an inbound BGP route policy must be applied on all EBGP sessions of the ASBR.

The policy must match the GSHUT community and lower the precedence of the route by changing the route attributes.

The Graceful-Shutdown feature does not work for reflected routes because the route reflector (RR) does not modify local-preference attribute. The routes, originated by the RR, carry the GSHUT local-preference value. As per the RFC 4456, when an RR reflects a route, it should not modify the following path attributes:
  • NEXT-HOP

  • AS-PATH

  • LOCAL-PREF

  • MED

Their modification could potentially result in routing loops. In this situation, apply on the RR an inbound BGP route policy, meeting the following conditions:
  • Match the graceful-shutdown community.

  • Set the local preference attributes of the paths tagged with the graceful-shutdown community to a lower value than other routes to the same destination.

Examples

Configure wait time delay:
switch(config-bgp)# neighbor 1.1.1.1 graceful-shutdown 10
Configure local-preference value:
switch(config-bgp)# neighbor 1.1.1.1 graceful-shutdown local-preference 100
Configure wait time delay and local-preference value:
switch(config-bgp)# neighbor 1.1.1.1 graceful-shutdown 10 local-preference 100
Reset wait time delay to default of 180 seconds:
switch(config-bgp)# no neighbor 1.1.1.1 graceful-shutdown 10
Reset local-preference value to default of 0:
switch(config-bgp)# no neighbor 1.1.1.1 graceful-shutdown local-preference 100
Reset wait time delay and local-preference value to defaults (wait time default: 180 seconds, local-preference value default: 0):
switch(config-bgp)# no neighbor 1.1.1.1 graceful-shutdown 10 local-preference 100
Complete deletion:
switch(config-bgp)# no neighbor 1.1.1.1 graceful-shutdown