neighbor shutdown

Causes a device to shut down the session administratively with its BGP neighbor.

Syntax

neighbor { ip-address | ipv6-address | peer-group-name } shutdown [ generate-rib-out ]

no neighbor { ip-address | ipv6-address | peer-group-name } shutdown [ generate-rib-out ]

Parameters

ip-address: IPv4 address of the neighbor
ipv6-address: IPv6 address of the neighbor
peer-group-name: Peer group name configured by the neighbor peer-group-name command.
generate-rib-out: When a peer is put into the shutdown state, Routing Information Base (RIB) outbound routes are not produced for that peer. Use this option to produce those routes.

Modes

BGP configuration mode

BGP address-family IPv4 unicast VRF configuration mode

BGP address-family IPv6 unicast VRF configuration mode

Usage Guidelines

Shutting down a session lets you configure the neighbor and save the configuration without the need to establish a session with that neighbor.

Examples

The following example causes a device to shut down the session administratively with its neighbor.

device# configure terminal
device(config)# router bgp
device(config-bgp-router)# neighbor 10.11.12.13 shutdown

The following example causes a device to shut down the session administratively with its neighbor and generate RIB outbound routes for VRF instance "red".

device# configure terminal
device(config)# router bgp
device(config-bgp-router)# address-family ipv6 unicast vrf red
device(config-bgp-ipv6u-vrf)# neighbor 2001:2018:8192::125 shutdown generate-rib-out