peer route-limit (BGP-IPv4 multicast address family view) (group)

Function

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

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 peerGroupName route-limit limit [ percentage ] [ alert-only | idle-forever | idle-timeout times ]

undo peer peerGroupName route-limit

Parameters

Parameter	Description	Value
peerGroupName	Specifies the name of an MBGP peer group.	The value is a string of 1 to 47 case-sensitive characters, spaces not supported.
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 ratio of the number of received routes to the maximum number of routes allowed (limit) when the router starts to generate alarms.	The value is an integer ranging from 1 to 100. The default value is 75.
alert-only	Indicates that if the number of received routes exceeds the limit, an alarm will be generated and no additional routes will be accepted.	-
idle-forever	Indicates that after the number of routes exceeds the limit, no connection is established automatically.	-
idle-timeout times	Specifies the value of the timeout timer. The connection, which is closed because the number of routes exceeds the threshold, is automatically re-established in the period specified by the timeout timer.	The value is an integer ranging from 1 to 1200, in minutes.

Views

BGP-IPv4 multicast 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 an MBGP device is allowed to receive from its peer. This adds a mechanism for controlling the routes received from peers in addition to distribution lists, filtering lists, and route mappings.

If the peer relationship between two peers 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:
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.
If you specified idle-forever in the command, the router disconnects its BGP peer. To re-establish the connection, run the reset bgp command.
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.

Example

# Set the maximum number of routes that a device is allowed to receive from its peer group.

<HUAWEI> system-view
[~HUAWEI] bgp 100
[*HUAWEI-bgp] peer test as-number 100
[*HUAWEI-bgp] ipv4-family multicast
[*HUAWEI-bgp-af-multicast] peer test enable
[*HUAWEI-bgp-af-multicast] peer test route-limit 10000