`neighbor graceful-shutdown`

Syntax

neighbor <ip/ipv6/peer-group-name>  graceful-shutdown  local-preference <0-4294967295>
neighbor <ip/ipv6/peer-group-name>  graceful-shutdown  <10-1200>
neighbor <ip/ipv6/peer-group-name>  graceful-shutdown  <10-1200> local-preference <0-4294967295>
neighbor <ip/ipv6/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.

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 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-router

Parameters

graceful-shutdown: Specifies delay value. Default: 180. Range: 10-1200.
local-preference: Specifies local-preference value. Default: 0. Range: 0-4294967295.

Authority

Administrators

Examples

Configure wait time delay:

switch(config-router)# neighbor 1.1.1.1 graceful-shutdown 10

Configure local-preference value:

switch(config-router)# neighbor 1.1.1.1 graceful-shutdown local-preference 100

Configure wait time delay and local-preference value:

switch(config-router)# neighbor 1.1.1.1 graceful-shutdown 10 local-preference 100

Reset wait time delay to default of 180 seconds:

switch(config-router)# no neighbor 1.1.1.1 graceful-shutdown 10

Reset local-preference value to default of 0:

switch(config-router)# 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-router)# no neighbor 1.1.1.1 graceful-shutdown 10 local-preference 100

Complete deletion:

switch(config-router)# no neighbor 1.1.1.1 graceful-shutdown