peer route-limit (BGP-VPN instance IPv6 address family view) (IPv6)

Function

The peer route-limit command sets the maximum number of routes that can be received from a peer.

The undo peer route-limit command cancels the configuration.

By default, there is no limit on the number of routes that can be received from a peer.

Format

peer ipv6-address route-limit [ accept-prefix ] limit [ percentage ] [ alert-only | idle-forever | idle-timeout times ]

undo peer ipv6-address route-limit

Parameters

Parameter	Description	Value
ipv6-address	Specifies an IPv6 peer address.	The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X
accept-prefix	Specifies the number of routes that match a policy. If accept-prefix is specified and the keep-all-routes command is run, only the routes that match the policy are counted into the maximum number of routes that can be accepted. If accept-prefix and alert-only are both set, the system keeps receiving routes and the routes are valid after the proportion of the number of received routes to the limit reaches percentage or 100%.	-
limit	Specifies the maximum number of routes that can be received from a peer.	The value is an integer ranging from 1 to 4294967295.
percentage	Specifies the proportion threshold of the number of received routes to the limit. If the proportion reaches percentage and is less than 100%, the device sends a threshold-reaching alarm named BGP_1.3.6.1.4.1.2011.5.25.177.1.3.1 ROUTETHRESHOLDEXCEED and properly receives routes. If the proportion reaches 100%, the device sends a threshold-crossing alarm named BGP_1.3.6.1.4.1.2011.5.25.177.1.3.6 ROUTEEXCEED and stops receiving routes.	The value is an integer ranging from 1 to 100. The default value is 75.
alert-only	Enables the device to send a threshold-reaching or threshold-crossing alarm and stops receiving excess routes if the proportion of the number of received routes to the limit reaches the percentage or 100%. In this situation, the peer relationship is not disconnected.	-
idle-forever	Enables the device to send an alarm if the proportion of the number of received routes to the limit reaches the percentage. After the number of received routes exceeds the limit, the connection is interrupted and will not be automatically re-established.	-
idle-timeout times	Enables the device to send an alarm if the proportion of the number of received routes to the limit reaches the percentage. After the number of received routes exceeds the limit, the connection is interrupted, and the device does not automatically re-establish the connection until the timer expires.	The value is an integer ranging from 1 to 1200, in minutes.

Views

BGP-VPN instance IPv6 address family view

Default Level

2: Configuration level

Task Name and Operations

Task Name	Operations
bgp	write

Usage Guidelines

Usage Scenario

The peer route-limit command is used to set the maximum number of routes that a BGP device is allowed to receive from its peer. This provides a mechanism for controlling the routes received from peers in addition to distribution lists, filtering lists, and route mappings.

Configuration Impact

If the peer route-limit command is run for a peer group, the peers of the peer group inherit the configuration.

If a peer relationship between two devices is in the Established state, the following situations occur:

If the number of routes received by the Router exceeds the maximum limit after you run the peer route-limit command for the first time or run the command to reduce the maximum limit:
a.If you specified alert-only in the command, the Router does not disconnect its BGP peer. The received routes are not removed, and no additional routes will be accepted.
b.If you specified idle-forever in the command, the Router disconnects its BGP peer. To re-establish the connection, run the reset bgp command.
c.If you specified idle-timeout in the command, the Router disconnects its BGP peer and re-establishes its BGP peer relationship automatically after the timeout timer expires. To re-establish the connection before the timeout timer expires, run the reset bgp command.
If the upper limit set on the Router is increased to be greater than the number of received routes, the Router sends Refresh packets to receive routes again. If the Router does not support the route-refresh capability, the Router needs to re-establish the connection with its peer.
If the upper limit set on the Router is reduced but is still greater than the number of received routes, only configuration parameters need to be modified.
If the alert-only, idle-forever, and idle-timeout are not specified and the proportion of the number of received routes to limit reaches percentage, the device generates an alarm; after the number of received routes exceeds the limit, the connection is interrupted and is automatically re-established in 30s.

Precautions

If the specified peer has the capability and the peer relationship is interrupted when the number of routes exceeds the threshold, the same peer in all address families will be affected, and the peer relationship will be re-established.

Example

# Set the maximum number of routes that can be received from peers to 10000.

<HUAWEI> system-view
[~HUAWEI] ip vpn-instance vpna
[*HUAWEI-vpn-instance-vpna] ipv6-family
[*HUAWEI-vpn-instance-vpn1-af-ipv6] route-distinguisher 100:1
[*HUAWEI-vpn-instance-vpna-af-ipv6] quit
[*HUAWEI-vpn-instance-vpna] quit
[*HUAWEI] bgp 100
[*HUAWEI-bgp] ipv6-family vpn-instance vpna
[*HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 as-number 100
[*HUAWEI-bgp-6-vpna] peer 2001:DB8:1::1 route-limit 10000