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.

Default

The default values are as follows:
  • For a Summit X440 switch: 16.
  • For a BlackDiamond 8000 e-series module: 464.
  • For a BlackDiamond 8900 xl-series module or a Summit X480 switch: 245728.
  • For a BlackDiamond X8 BDXA-series or BDXB-series, BlackDiamond 8000 c- or xm-series module, E4G-200 or E4G-400, or a Summit X450-G2, X460, X460-G2, X670, X670-G2 or X770 switch: 12240.
  • Note that the default value for a BlackDiamond X8 BDXB-XL-series, 8900 xl-series module or a Summit X480 switch depends on the value configured with the command: configure forwarding external-tables.
  • For a BlackDiamond X8 series: 507872.

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 16.2 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

For a BlackDiamond X8 BDXB-xl-series module, 8900 xl-series module or a Summit X480 switch, IPv6 routes are not included in the calculation for the number of reserved route entries if the configure forwarding external-tables command is set to include IPv4 routes (for example, l3-only, l3-only ipv4, l3-only ipv4-and-ipv6, l2-and-l3, and l2-and-l3-and-acl). When the external tables are configured for IPv4 routes, IPv6 routes occupy the entire Internal LPM table, or in the case of l3-only ipv4-and-ipv6, IPv6 routes occupy a separate partition within the External LPM table.

On a BlackDiamond X8 BDXA-series or BDXB-series, BlackDiamond 8000 c-, or xm-series modules, or Summit X460, X670, or 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 a Summit X440 switch: 32
  • For a BlackDiamond 8000 e-series module: 480
  • For a BlackDiamond 8000 c-series module, E4G-200 or E4G-400, or a Summit X460 or X460-G2 switch: 12256
  • For a BlackDiamond X8 BDXA-series or BDXB-series, BlackDiamond 8900 xm-series module or a Summit X450-G2, X670, X670-G2 or X770 switch: 16352
  • For a BlackDiamond 8900 xl-series module or a Summit X480 switch, the maximum value depends on the value configured with the configure forwarding external-tables command as follows:
    • l2-only, acl-only, l3-only ipv6 and none options: 16352 (default 12240)
    • l2-and-l3-and-acl option: 131040 (default 114656)
    • l2-and-l3 option: 262112 (default 245728)
    • l3-only {ipv4} option: 524256 (default 507872)
    • l3-only ipv4-and-ipv6 option: 475104 (default 458720)
    • l2-and-l3-and-ipmc option: 131040 (default 114656)
  • For a BlackDiamond X8 BDXB-XL-series module, the maximum value depends on the value configured with the configure forwarding external-tables command as follows:
    • l2-only, l2-and-l3-hosts, acl-only, l3-only ipv6 and none options: 16352 (default 12240)
    • l2-and-l3-and-acl option: 262112 (default 245728)
    • l2-and-l3 option: 524256 (default 507872)
    • l3-only {ipv4} option: 1048544 (default 1032160)
    • l3-only ipv4-and-ipv6 option: 868320 (default 851936)
    • l2-and-l3-and-ipmc option: 487392 (default 471008)

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, say 700 routes on a BlackDiamond 8000 e-series module, 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 on a BlackDiamond 8000 e-series module 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 BlackDiamond X8, BlackDiamond 8000 series modules, or on all Summit X440, X460, X480, and X670 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 BlackDiamond X8, BlackDiamond 8000 series modules, and Summit X440, X460, X480, X670, and X770 switches when operating independently or in a SummitStack.