neighbor graceful-shutdown

Configures graceful shutdown of a link to a BGP neighbor or peer group.

Syntax

neighbor [ ipv4-address | ipv6-address | peer-group-name ] graceful-shutdown seconds { community value [ local-preference value ] | local-preference value } [ route-map route-map-name ]

no neighbor [ ip-address | ipv6-address | peer-group-name ] graceful-shutdown seconds { community value [ local-preference value ] | local-preference value } [ route-map route-map-name ]

Command Default

BGP graceful shutdown is disabled.

Parameters

ipv4-address: Specifies a neighbor in IPv4 address format.
ipv6-address: Specifies a neighbor in IPv6 address format.
peer-group-name: Specifies a neighbor as a peer group name (that is configured by using the neighbor peer-group-name command).
graceful-shutdown seconds: Specifies the number of seconds to elapse before graceful shutdown occurs. The range is from 30 through 600.
community value: Specifies the community attribute for BGP graceful shutdown. The range is from 1 through 4294967295.
local-preference value: Specifies the local preference attribute for BGP graceful shutdown. The range is from 0 through 4294967295.
route-map route-map-name: Specifies the route map to apply for BGP graceful shutdown.

Modes

BGP configuration mode

Usage Guidelines

Note

neighbor send-community configuration enables sending community attribute information to a BGP peer. Before the graceful shutdown community attribute can be sent, the send community must be negotiated by using the neighbor send-community command specifying the both option.

When a neighbor address is not specified, this command configures graceful shutdown for all neighbors on the device.

This command s supported only on devices based on the DNX chipset family. For a list of such devices, see "Supported Hardware."

When a route map is not specified, the default GRACEFUL_SHUTDOWN parameters are applied.

When a route map is specified, only route-map parameters are applied.

Note

Modifications made to the specified route map during the graceful-shutdown period, which is specified using the graceful-shutdown parameter, are not effective for graceful shutdown advertisement routes.

The no form of the command removes the specified BGP graceful shutdown configuration.

Examples

The following example shows how to configure BGP graceful shutdown for a neighbor (10.11.22.23) and set the shutdown to occur after 580 seconds.

device# configure terminal
device(config)# router bgp
device(config-bgp-router)# neighbor 10.11.22.23 graceful-shutdown 580

The following example shows how to configure BGP graceful shutdown for a peer group named grp-1 and set the shutdown to occur after 620 seconds.

device# configure terminal
device(config)# router bgp
device(config-bgp-router)# neighbor grp-1 graceful-shutdown 620

The following example shows how to configure BGP graceful shutdown for a neighbor (10.11.22.23) and apply the attributes of a route map named myroutemap to the shutdown which is set to occur after 600 seconds.

device# configure terminal
device(config)# router bgp
device(config-bgp-router)# neighbor 10.11.22.23 graceful-shutdown 600 route-map myroutemap

The following example shows how to configure BGP graceful shutdown for a neighbor (10.11.22.23) with community attribute 20. The shutdown which is set to occur after 600 seconds.

device# configure terminal
device(config)# router bgp
device(config-bgp-router)# neighbor 10.11.22.23 graceful-shutdown 600 community 20