configure iproute reserved-entries

configure iproute reserved-entries [ num_routes_needed | maximum | default ] slot [all | slot_num]

Description

Reserves storage space for IPv4 and IPv6 routes in the Longest Prefix Match (LPM) hardware tables, allowing individual local and remote IPv4 unicast hosts to occupy the unused portions of the tables.

Syntax Description

num_routes_needed Specifies a specific number of routes to reserve.
maximum Reserves the maximum amount of space for IP route entries. No IPv4 hosts are stored in the LPM and External tables.
default Reserves the default amount of space for IP route entries.
all For BlackDiamond X8, BlackDiamond 8800 series, and SummitStack switches only, this option applies the reservation to all applicable slots.
slot_num For BlackDiamond X8, BlackDiamond 8800 series, and SummitStack switches only, this option applies the reservation to the specified slot.

Usage Guidelines

Demand on the Layer 3 Hash table can be reduced by allowing IPv4 hosts to be stored in the LPM tables instead. This command allows you to reserve a portion of the LPM tables for routes, and this creates an unreserved portion that can be used to store IPv4 hosts. For more information, see the Extended IPv4 Host Cache section in the ExtremeXOS User Guide.

The default setting can support most networks, but if more than a few hundred local IP hosts and IP multicast entries are present, you can improve switch performance by calculating and configuring the reserved space for route entries to allow unreserved space for IPv4 hosts. Changing the number of reserved route entries does not require a reboot of the affected slots or switches.

You can view the current LPM hardware table usage by entering the show iproute reserved-entries statistics command. The LPM table statistics are in the columns under the In HW Route Table heading.

If the switch contains fewer routes than the capacity of the LPM tables, the number of route entries to reserve for a slot or switch should be the number of routes currently used in the hardware tables, plus an additional cushion for anticipated growth. Because each IPv6 route takes up the space of two IPv4 routes, the number of route entries to reserve is two times the value in the IPv6 routes column, plus the value in the IPv4 routes column, plus room for anticipated growth. For example, if you want to reserve space for 100 IPv4 routes and 20 IPv6 routes, the required number of route entries is 140 (100 + 2*20).

Note

Note

On Summit X770 switches, the capacity of the LPM table is 4,096 higher than the capacity for local IPv4 or IPv6 hosts. Therefore, on such hardware, there is no need to configure fewer than 4096 reserved route entries.

The maximum value for num_routes_needed is as follows:
  • For Summit X460-G2 switch: 12256
  • For a Summit X450-G2, X670-G2 or X770 switch: 16352

The maximum values shown above apply to Summit family switches operating independently or as part of a SummitStack. The maximum option can be used to specify the maximum values.

When maximum is specified, IPv4 hosts do not occupy LPM table space. Note that when maximum is specified, software forwarding can result, depending on the utilization and addresses in the Layer 3 Hash table, and is therefore not recommended.

If the switch contains more routes than the capacity of the LPM tables, a trade-off can be made. You can choose to reserve 400 iproute entries, for example. The 400 IPv4 routes with the longest length network masks will be installed in the LPM table, and the remainder of the LPM table can be used for cache space for local and remote hosts. The remote host entries are only required for IPv4 addresses matching one of the 300 routes not installed in the LPM table. Since not all 700 routes can be stored anyway, leaving appropriate room for individual remote hosts can result in more fast-path forwarding.

Depending on the actual routes present, IP route compression for IPv4 and/or IPv6 can be enabled to reduce the number of routes required in the LPM tables. For more information, see the description for the following command: enable iproute compression {vr vrname}

Example

The following command reserves up to 140 IPv4 routes or 70 IPv6 routes, or any combination in between, on all series modules, or switches in a SummitStack:

configure iproute reserved-entries 140 slot all

For details on the configuration changes, see the command descriptions for the following commands:

show iproute reserved-entries

show iproute reserved-entries statistics

History

This command was first available in ExtremeXOS 12.1.

Platform Availability

This command is available on all platforms.