BGP Configuration Guide for Cisco 8000 Series Routers, Cisco IOS XR Releases

Clear BGP caches, tables, and databases

Updated: February 28, 2026

Want to summarize with AI?

Overview

Describes removing all entries from specified BGP data structures and resetting neighbor sessions for troubleshooting or data integrity.

Remove all entries from specified BGP data structures and reset neighbor sessions.

Context: Use for troubleshooting or when data integrity is in question.

Perform this procdure to remove all contents of a particular cache, table, or database. This can become necessary when the contents of the particular structure have become, or are suspected to be, invalid.

Before you begin

Try Reset BGP neighbors using hard reset to resolve the issue.

Procedure

Run the clear bgp command to clear BGP caches and sessions.

Example:

Router# clear bgp ipv4 172.20.1.1

clear bgp ipv4 <ip address> : This command clears the caches, tables, and databases for a specific neighbor.
clear bgp external : This command clears the caches, tables, and databases for all external peers.
clear bgp * : This command clears the caches, tables, and databases for all BGP neighbors.

The selected sessions, caches, and databases are reset or cleared.

Need help?

Open a support case

(Requires a Cisco Service Contract)

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.