8-29 neighbor ip-address peer-group-name shutdown

8-29 neighbor { ip-address peer- group - name } shutdown

Syntax Description:

• ip-address ” Neighbor's IP address.

• peer-group-name ” Name of the peer group. See section 8-19.

Purpose: Prior to Cisco IOS Software Release 12.0, the only way you could shut down a BGP neighbor was to remove the neighbor configuration using no neighbor ip-address remote-as as-number. This was an inconvenience, because all configuration statements associated with the neighbor were also deleted. The shutdown form of the neighbor command terminates the BGP session without deleting the neighbor configuration commands.

Cisco IOS Software Release: 12.0

Configuration Example: Administratively Shutting Down a BGP Session

The following configuration administratively shuts down the BGP session. To reenable the session, use the no form of the command:

  router bgp 1   neighbor 10.1.1.2 remote-as 1    neighbor 10.1.1.2 shutdown   

Verification

Use the show ip bgp neighbors command to verify that the neighbor has been shut down:

 rtrA#  show ip bgp neighbors  BGP neighbor is 10.1.1.2,  remote AS 1, internal link  Administratively shut down  Index 1, Offset 0, Mask 0x2   BGP version 4, remote router ID 0.0.0.0   BGP state = Idle, table version = 0   Last read 00:00:15, hold time is 180, keepalive interval is 60 seconds   Minimum time between advertisement runs is 5 seconds   Received 259 messages, 0 notifications, 0 in queue   Sent 257 messages, 0 notifications, 0 in queue   Prefix advertised 0, suppressed 0, withdrawn 0   Connections established 5; dropped 5  Last reset 00:00:16, due to Admin. shutdown  

Troubleshooting

This is the one time that the neighbors should not be in the Established state. If they are, the only error can be in the IP address used with the shutdown command.