refresh bgp

Function

The refresh bgp command softly resets the BGP connection manually.

The softly resetting of BGP connection can refresh the BGP routing table and apply a new policy without cutting off the BGP connection.

Format

refresh bgp [ vpn-instance vpn-instance-name ipv4-family | vpnv4 | vpn-target ] { all | ipv4-address | group group-name | external | internal } { export | import }

refresh bgp ipv6 { all | ipv4-address | ipv6-address | group group-name | external | internal } { export | import }

refresh bgp vpn-instance vpn-instance-name ipv6-family { all | ipv6-address | group group-name | external | internal } { export | import }

refresh bgp vpnv6 { all | ipv4-address | group group-name | external | internal } { export | import }

refresh bgp multicast { ipv4-address | all | group group-name | internal | external } { import | export }

Parameters

Parameter	Description	Value
vpn-instance vpn-instance-name	Softly resets the BGP connection related to the VPN instance.	The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
ipv4-family	Softly resets the BGP connection related to the IPv4 unicast address family.	-
vpnv4	Softly resets the BGP connection related to Virtual Private Network version 4 (VPNv4).	-
vpn-target	Softly resets the BGP connection related to VPN-Target.	-
all	Softly resets all the BGP connections.	-
ipv4-address	Specifies the IPv4 address of the BGP peer.	It is in dotted decimal notation.
ipv6-address	Specifies the IPv6 address of the BGP peer.	The prefix is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X.
group group-name	Specifies the name of the BGP peer group.	The name is a string of 1 to 47 case-sensitive characters, with spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
external	Softly resets EBGP connections.	-
internal	Softly resets IBGP connections.	-
export	Triggers softly reset at the outgoing interface.	-
import	Triggers softly reset at the incoming interface.	-
ipv6	Softly resets the BGP4+ connections.	-
ipv6-family	Softly resets the BGP connection related to the IPv6 unicast address family.	-
vpnv6	Softly resets the BGP connections related to Virtual Private Network version 4 (VPNv6). Only the AntiDDoS8000 and support this parameter.	-

Views

User view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If a device's peer supports route-refresh, the refresh bgp command can be used on the device to softly reset the BGP connection with the peer. BGP soft resetting can be used to refresh the BGP routing table and apply new routing policies, without closing any BGP connection.

If a delay is configured to apply a route-policy:

If an import policy is configured to filter the routes learned from a peer or peer group using the peer route-policy import command, BGP applies the import policy immediately when the refresh bgp all command is run.
If an export policy is configured to filter the routes to be sent to a peer or peer group using the peer route-policy export command, BGP does not apply the export policy until the configured delay expires although the refresh bgp all command is run.

Prerequisites

The route-refresh capability has been enabled on all BGP devices on the network.

Precautions

Assume that a device supports route-refresh and is configured with the peer keep-all-routes command. After the refresh bgp command is run on the device, the device does not refresh its routing table.

Example

# Softly reset all the BGP connections at the incoming interface to validate the new configuration.

<sysname> refresh bgp all import

# Softly reset the BGP4+ connections of all peers on the outbound interface.

<sysname> refresh bgp ipv6 all export

# Softly reset the BGP VPNv6 connections with peer 1.1.1.1 on the outbound interface to validate new configurations.

<sysname> refresh bgp vpnv6 1.1.1.1 export