`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>]

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

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.

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