peer route-limit (BGP-LS 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 limit [ percentage ] [ alert-only | idle-forever | idle-timeout times ]

undo peer ipv6-address route-limit

Parameters

Parameter	Description	Value
ipv6-address	Specify an IPv6 peer address.	The value is a 32-digit hexadecimal number, in the format of X:X:X:X:X:X:X:X
limit	Route limit value.	The value is an integer ranging from 1 to 4294967295.
percentage	Start to generate warning messages if it reaches maximum percentage value.	The value is a string of 1 to 100 case-sensitive characters.
alert-only	Allow the router to generate log message without terminating session when the maximum is exceeded.	-
idle-forever	Indicate that, when the threshold for the maximum number of routes is exceeded, the device does not automatically re-set up connections until the reset bgp command is run.	-
idle-timeout times	Value of idle-timeout timer(minutes).	The value is an integer ranging from 1 to 1200, in minutes.

Views

BGP-LS 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 a peer to 100.

<HUAWEI> system-view
[~HUAWEI] bgp 100
[*HUAWEI-bgp] peer 2001:DB8:1::1 as-number 100
[*HUAWEI-bgp] link-state-family unicast
[*HUAWEI-bgp-af-ls] peer 2001:DB8:1::1 enable
[*HUAWEI-bgp-af-ls] peer 2001:DB8:1::1 route-limit 100