neighbor maximum-prefix

This command specifies the peak number of prefixes that BGP will accept for installation into the Routing Information Base (RIB).

Syntax

neighbor ip-address maximum-prefix num [warning-only]
no neighbor ip-address maximum-prefix num [warning-only]

Parameters

ip-address Specifies a BGP peer as a valid IPv4 address in dotted-quad format or as a valid IPv6 address in colon-separated format.
num Specifies the maximum number of prefixes that will be installed in the BGP RIB. Valid values are 0 - 4294967295. Default value is 0 (unlimited).
warning-only (Optional) Specifies to log a warning message, stop accepting routes, and keep the established peering session.

Defaults

If warning-only is not specified, the default action is for the connection to be dropped, if the number of routes installed in the RIB exceeds the maximum allowed.

Mode

BGP Router Configuration.

Usage

The neighbor maximum-prefix command configures the maximum number of routes that a peer will accept for installation into the S- and 7100-Series router BGP RIB. In addition, an action can be configured to occur when this maximum number is exceeded. If warning-only is specified, a warning message is logged and additional routes are no longer accepted, but the established peer session is kept. If warning-only is not specified, the default action is for the connection to be dropped.

The no neighbor maximum-prefix command removes the configured route limit and returns this setting to its default value of unlimited.

Example

The following example causes the S- and 7100-Series Router to install a maximum of 1000 routes learned from peer 4.3.2.1 into the routing table. If this number is exceeded, then the S- and 7100-Series Router will log a warning message and stop accepting additional routes.

System(su-config)->router bgp 65151
System(su-config-bgp)->bgp router-id 159.1.1.9
System(su-config-bgp)->neighbor 4.3.2.1 remote-as 5
System(su-config-bgp)->neighbor 4.3.2.1 maximum-routes 1000 warning-only