This command specifies the peak number of prefixes that BGP will accept for installation into the Routing Information Base (RIB).
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. |
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.
BGP Router Configuration.
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.
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