bgp soft reset - ciscobgp soft reset...
TRANSCRIPT
BGP Soft Reset
BGP Soft Reset feature provides automatic support for dynamic soft reset of inbound BGP routing tableupdates that is not dependent upon stored routing table update information. The new method requires nopreconfiguration (as with the neighbor soft-reconfiguration command) and requires much less memorythan the previous soft reset method for inbound routing table updates.
• Finding Feature Information, page 1
• Information About BGP Soft Reset, page 1
• How to Configure BGP Soft Reset, page 3
• Configuration Examples for BGP Soft Reset, page 8
• Additional References, page 9
• Feature Information for BGP Soft Reset, page 9
Finding Feature InformationYour software release may not support all the features documented in this module. For the latest caveats andfeature information, see Bug Search Tool and the release notes for your platform and software release. Tofind information about the features documented in this module, and to see a list of the releases in which eachfeature is supported, see the feature information table.
Use Cisco Feature Navigator to find information about platform support and Cisco software image support.To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.
Information About BGP Soft Reset
BGP Session ResetWhenever the routing policy changes due to a configuration change, BGP peering sessions must be reset byusing the clear ip bgp command. Cisco software supports the following three mechanisms to reset BGPpeering sessions:
IP Routing: BGP Configuration Guide, Cisco IOS XE Release 3SE (Catalyst 3650 Switches) 1
• Hard reset—A hard reset tears down the specified peering sessions including the TCP connection anddeletes routes coming from the specified peer.
• Soft reset—A soft reset uses stored prefix information to reconfigure and activate BGP routing tableswithout tearing down existing peering sessions. Soft reconfiguration uses stored update information, atthe cost of additional memory for storing the updates, to allow you to apply new BGP policy withoutdisrupting the network. Soft reconfiguration can be configured for inbound or outbound sessions.
• Dynamic inbound soft reset—The route refresh capability, as defined in RFC 2918, allows the localdevice to reset inbound routing tables dynamically by exchanging route refresh requests to supportingpeers. The route refresh capability does not store update information locally for nondisruptive policychanges. It instead relies on dynamic exchange with supporting peers. Route refresh must first beadvertised through BGP capability negotiation between peers. All BGP devices must support the routerefresh capability. To determine if a BGP device supports this capability, use the show ip bgp neighborscommand. The following message is displayed in the output when the device supports the route refreshcapability:
Received route refresh capability from peer.The bgp soft-reconfig-backup command was introduced to configure BGP to perform inbound softreconfiguration for peers that do not support the route refresh capability. The configuration of this commandallows you to configure BGP to store updates (soft reconfiguration) only as necessary. Peers that support theroute refresh capability are unaffected by the configuration of this command.
Routing Policy Change ManagementRouting policies for a peer include all the configurations for elements such as a route map, distribute list,prefix list, and filter list that may impact inbound or outbound routing table updates. Whenever there is achange in the routing policy, the BGP session must be soft-cleared, or soft-reset, for the new policy to takeeffect. Performing inbound reset enables the new inbound policy configured on the device to take effect.Performing outbound reset causes the new local outbound policy configured on the device to take effectwithout resetting the BGP session. As a new set of updates is sent during outbound policy reset, a new inboundpolicy of the neighbor can also take effect. This means that after changing inbound policy, you must do aninbound reset on the local device or an outbound reset on the peer device. Outbound policy changes requirean outbound reset on the local device or an inbound reset on the peer device.
There are two types of reset: hard reset and soft reset. The table below lists their advantages and disadvantages.
Table 1: Advantages and Disadvantages of Hard and Soft Resets
DisadvantagesAdvantagesType of Reset
The prefixes in the BGP, IP, andForwarding InformationBase (FIB)tables provided by the neighbor arelost. A hard reset is notrecommended.
No memory overhead.Hard reset
Does not reset inbound routingtable updates.
No configuration, and no storingof routing table updates.
Outbound soft reset
IP Routing: BGP Configuration Guide, Cisco IOS XE Release 3SE (Catalyst 3650 Switches)2
BGP Soft ResetRouting Policy Change Management
DisadvantagesAdvantagesType of Reset
Both BGP devices must supportthe route refresh capability.
Does not reset outboundrouting table updates.
Note
Does not clear the BGP session andcache.
Does not require storing of routingtable updates, and has no memoryoverhead.
Dynamic inbound soft reset
Requires preconfiguration.
Stores all received (inbound)routing policy updates withoutmodification; is memory-intensive.
Recommended only whenabsolutely necessary, such as whenboth BGP devices do not supportthe automatic route refreshcapability.
Does not reset outboundrouting table updates.
Note
Can be used when both BGPdevices do not support theautomatic route refresh capability.
The bgp soft-reconfig-backupcommand was introduced toconfigure inbound softreconfiguration for peers that donot support the route refreshcapability.
Configured inbound soft reset (usesthe neighbor soft-reconfigurationrouter configuration command)
Once you have defined two devices to be BGP neighbors, they will form a BGP connection and exchangerouting information. If you subsequently change a BGP filter, weight, distance, version, or timer, or if youmake a similar configuration change, you must reset BGP connections in order for the configuration changeto take effect.
A soft reset updates the routing table for inbound and outbound routing updates. Cisco software supports softreset without any prior configuration. This soft reset allows the dynamic exchange of route refresh requestsand routing information between BGP devices, and allows the subsequent readvertisement of the respectiveoutbound routing table. There are two types of soft reset:
•When soft reset is used to generate inbound updates from a neighbor, it is called dynamic inbound softreset.
•When soft reset is used to send a new set of updates to a neighbor, it is called outbound soft reset.
To use soft reset without preconfiguration, both BGP peers must support the soft route refresh capability,which is advertised in the OPEN message sent when the peers establish a TCP session.
How to Configure BGP Soft Reset
Performing BGP Dynamic Inbound Soft Reset
SUMMARY STEPS
1. enable2. clear ip bgp {* | autonomous-system-number | neighbor-address} soft in
IP Routing: BGP Configuration Guide, Cisco IOS XE Release 3SE (Catalyst 3650 Switches) 3
BGP Soft ResetHow to Configure BGP Soft Reset
DETAILED STEPS
PurposeCommand or Action
Enables privileged EXEC mode.enableStep 1
Example:
Device> enable
• Enter your password if prompted.
Performs a dynamic soft reset on the connectionspecified.
clear ip bgp {* | autonomous-system-number |neighbor-address} soft in
Example:
Device# clear ip bgp 192.168.1.2 soft in
Step 2
Performing BGP Outbound Soft Reset
SUMMARY STEPS
1. enable2. clear ip bgp {* | autonomous-system-number | neighbor-address} soft out
DETAILED STEPS
PurposeCommand or Action
Enables privileged EXEC mode.enableStep 1
Example:
Device> enable
• Enter your password if prompted.
Performs an outbound soft reset on the connectionspecified.
clear ip bgp {* | autonomous-system-number |neighbor-address} soft out
Example:
Device# clear ip bgp 192.168.1.2 soft out
Step 2
IP Routing: BGP Configuration Guide, Cisco IOS XE Release 3SE (Catalyst 3650 Switches)4
BGP Soft ResetPerforming BGP Outbound Soft Reset
Configuring Inbound Soft Reconfiguration When Route Refresh Capability IsMissing
Perform this task to configure inbound soft reconfiguration using the bgp soft-reconfig-backup commandfor BGP peers that do not support the route refresh capability. BGP peers that support the route refreshcapability are unaffected by the configuration of this command. Note that the memory requirements for storingthe inbound update information can become quite large.
SUMMARY STEPS
1. enable2. configure terminal3. router bgp autonomous-system-number4. bgp log-neighbor-changes5. bgp soft-reconfig-backup6. neighbor {ip-address | peer-group-name} remote-as autonomous-system-number7. neighbor {ip-address | peer-group-name} soft-reconfiguration [inbound]8. neighbor {ip-address | peer-group-name} route-map map-name {in | out}9. Repeat Steps 6 through 8 for every peer that is to be configured with inbound soft reconfiguration.10. exit11. route-map map-name [permit | deny] [sequence-number]12. set ip next-hop ip-address13. end14. show ip bgp neighbors [neighbor-address]15. show ip bgp [network] [network-mask]
DETAILED STEPS
PurposeCommand or Action
Enables privileged EXEC mode.enableStep 1
Example:
Device> enable
• Enter your password if prompted.
Enters global configuration mode.configure terminal
Example:
Device# configure terminal
Step 2
IP Routing: BGP Configuration Guide, Cisco IOS XE Release 3SE (Catalyst 3650 Switches) 5
BGP Soft ResetConfiguring Inbound Soft Reconfiguration When Route Refresh Capability Is Missing
PurposeCommand or Action
Enters router configurationmode for the specified routing process.router bgp autonomous-system-number
Example:
Device(config)# router bgp 45000
Step 3
Enables logging of BGP neighbor resets.bgp log-neighbor-changes
Example:
Device(config-router)# bgplog-neighbor-changes
Step 4
Configures a BGP speaker to perform inbound soft reconfigurationfor peers that do not support the route refresh capability.
bgp soft-reconfig-backup
Example:
Device(config-router)# bgpsoft-reconfig-backup
Step 5
• This command is used to configure BGP to perform inboundsoft reconfiguration for peers that do not support the routerefresh capability. The configuration of this command allowsyou to configure BGP to store updates (soft reconfiguration)only as necessary. Peers that support the route refreshcapability are unaffected by the configuration of thiscommand.
Adds the IP address of the neighbor in the specified autonomoussystem to the IPv4 multiprotocol BGP neighbor table of the localdevice.
neighbor {ip-address | peer-group-name}remote-as autonomous-system-number
Example:
Device(config-router)# neighbor 192.168.1.2remote-as 40000
Step 6
Configures the Cisco software to start storing updates.neighbor {ip-address | peer-group-name}soft-reconfiguration [inbound]
Step 7
• All the updates received from this neighbor will be storedunmodified, regardless of the inbound policy.When inbound
Example:
Device(config-router)# neighbor 192.168.1.2soft-reconfiguration inbound
soft reconfiguration is done later, the stored information willbe used to generate a new set of inbound updates.
Applies a route map to incoming or outgoing routes.neighbor {ip-address | peer-group-name}route-map map-name {in | out}
Step 8
• In this example, the route map named LOCAL will beapplied to incoming routes.
Example:
Device(config-router)# neighbor 192.168.1.2route-map LOCAL in
—Repeat Steps 6 through 8 for every peer that is tobe configured with inbound soft reconfiguration.
Step 9
IP Routing: BGP Configuration Guide, Cisco IOS XE Release 3SE (Catalyst 3650 Switches)6
BGP Soft ResetConfiguring Inbound Soft Reconfiguration When Route Refresh Capability Is Missing
PurposeCommand or Action
Exits router configuration mode and enters global configurationmode.
exit
Example:
Device(config-router)# exit
Step 10
Configures a route map and enters route-map configuration mode.route-map map-name [permit | deny][sequence-number]
Step 11
• In this example, a route map named LOCAL is created.
Example:
Device(config)# route-map LOCAL permit 10
Specifies where output packets that pass a match clause of a routemap for policy routing.
set ip next-hop ip-address
Example:
Device(config-route-map)# set ip next-hop192.168.1.144
Step 12
• In this example, the ip address is set to 192.168.1.144.
Exits route-map configuration mode and enters privileged EXECmode.
end
Example:
Device(config-route-map)# end
Step 13
(Optional) Displays information about the TCP and BGPconnections to neighbors.
show ip bgp neighbors [neighbor-address]
Example:
Device# show ip bgp neighbors 192.168.1.2
Step 14
Only the syntax applicable to this task is used in thisexample. For more details, see theCisco IOS IP Routing:BGP Command Reference.
Note
(Optional) Displays the entries in the BGP routing table.show ip bgp [network] [network-mask]Step 15
Example:
Device# show ip bgp
Only the syntax applicable to this task is used in thisexample. For more details, see theCisco IOS IP Routing:BGP Command Reference.
Note
Examples
The following partial output from the show ip bgp neighbors command shows information about the TCPand BGP connections to the BGP neighbor 192.168.2.1. This peer supports route refresh.
BGP neighbor is 192.168.1.2, remote AS 40000, external linkNeighbor capabilities:Route refresh: advertised and received(new)
The following partial output from the show ip bgp neighbors command shows information about the TCPand BGP connections to the BGP neighbor 192.168.3.2. This peer does not support route refresh so the
IP Routing: BGP Configuration Guide, Cisco IOS XE Release 3SE (Catalyst 3650 Switches) 7
BGP Soft ResetConfiguring Inbound Soft Reconfiguration When Route Refresh Capability Is Missing
soft-reconfig inbound paths for BGP peer 192.168.3.2 will be stored because there is no other way to updateany inbound policy updates.
BGP neighbor is 192.168.3.2, remote AS 50000, external linkNeighbor capabilities:Route refresh: advertised
The following sample output from the show ip bgp command shows the entry for the network 172.17.1.0.Both BGP peers are advertising 172.17.1.0/24, but only the received-only path is stored for 192.168.3.2.
BGP routing table entry for 172.17.1.0/24, version 11Paths: (3 available, best #3, table Default-IP-Routing-Table, RIB-failure(4))Flag: 0x820Advertised to update-groups:
150000192.168.3.2 from 192.168.3.2 (172.17.1.0)Origin incomplete, metric 0, localpref 200, valid, external
50000, (received-only)192.168.3.2 from 192.168.3.2 (172.17.1.0)Origin incomplete, metric 0, localpref 100, valid, external
40000192.168.1.2 from 192.168.1.2 (172.16.1.0)Origin incomplete, metric 0, localpref 200, valid, external, best
Configuration Examples for BGP Soft Reset
Examples: BGP Soft ResetThe following examples show two ways to reset the connection for BGP peer 192.168.1.1.
Example: Dynamic Inbound Soft Reset
The following example shows the command used to initiate a dynamic soft reconfiguration in the BGP peer192.168.1.1. This command requires that the peer support the route refresh capability.
clear ip bgp 192.168.1.1 soft in
Example: Inbound Soft Reset Using Stored Information
The following example shows how to enable inbound soft reconfiguration for the neighbor 192.168.1.1. Allthe updates received from this neighbor will be stored unmodified, regardless of the inbound policy. Wheninbound soft reconfiguration is performed later, the stored information will be used to generate a new set ofinbound updates.
router bgp 100neighbor 192.168.1.1 remote-as 200neighbor 192.168.1.1 soft-reconfiguration inboundThe following example clears the session with the neighbor 192.168.1.1:
clear ip bgp 192.168.1.1 soft in
IP Routing: BGP Configuration Guide, Cisco IOS XE Release 3SE (Catalyst 3650 Switches)8
BGP Soft ResetConfiguration Examples for BGP Soft Reset
Additional ReferencesRelated Documents
Document TitleRelated Topic
Cisco IOS Master Command List,All Releases
Cisco IOS commands
Cisco IOS IP Routing: BGPCommand Reference
BGP commands
Standards and RFCs
TitleStandard/RFC
Route Refresh Capability for BGP-4RFC 2918
Technical Assistance
LinkDescription
http://www.cisco.com/cisco/web/support/index.htmlThe Cisco Support and Documentation websiteprovides online resources to download documentation,software, and tools. Use these resources to install andconfigure the software and to troubleshoot and resolvetechnical issues with Cisco products and technologies.Access to most tools on the Cisco Support andDocumentation website requires a Cisco.com user IDand password.
Feature Information for BGP Soft ResetThe following table provides release information about the feature or features described in this module. Thistable lists only the software release that introduced support for a given feature in a given software releasetrain. Unless noted otherwise, subsequent releases of that software release train also support that feature.
Use Cisco Feature Navigator to find information about platform support and Cisco software image support.To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.
IP Routing: BGP Configuration Guide, Cisco IOS XE Release 3SE (Catalyst 3650 Switches) 9
BGP Soft ResetAdditional References
Table 2: Feature Information for BGP Soft Reset
Feature InformationReleasesFeature Name
BGP Soft Reset feature providesautomatic support for dynamic softreset of inbound BGP routing tableupdates that is not dependent uponstored routing table updateinformation. The new methodrequires no preconfiguration (aswith the neighborsoft-reconfiguration command)and requires much less memorythan the previous soft reset methodfor inbound routing table updates.
In Cisco IOS XE Release 3.3SE,support was added for the CiscoCatalyst 3650 Series Switches andCisco Catalyst 3850 SeriesSwitches.
Cisco IOS XE Release 3.2SE
Cisco IOS XE Release 3.3SE
BGP Soft Reset
IP Routing: BGP Configuration Guide, Cisco IOS XE Release 3SE (Catalyst 3650 Switches)10
BGP Soft ResetFeature Information for BGP Soft Reset