configure iproute sharing max-gateways

configure iproute sharing max-gateways max_gateways


Specifies the maximum number of gateways in each gateway set in the ECMP (Equal Cost Multi Paths) hardware table.

Syntax Description

max_gateways Specifies the maximum number of ECMP gateways in a gateway. The only values allowed are 2, 4, 8, 16, 32 and 64.


16 gateways.

Usage Guidelines

When IPv4 or IPv6 route sharing is enabled, the maximum number of gateways value represents the maximum number of next-hop gateways that can be used for communications with a destination subnet. Each gateway represents an alternative path to a subnet. The gateways can be defined with static routes, or they can be learned through the OSPF (Open Shortest Path First), OSPFv3 (Open Shortest Path First version 3), BGP (Border Gateway Protocol), or IS-IS protocols. The value for max-gateways applies to both IPv4 and IPv6 on all VRs.

When Pseudowire Label Switch Path Load Sharing is enabled, the maximum number of gateways value represents the maximum number of LSPs that a pseudowire can use for multi-path transport.

The max-gateways setting changes how the hardware is configured for multi-path; however, individual protocols have multi-path limitations that may be lower than the configured max-gateways setting. Additionally, the values supported for the max-gateways setting may vary, depending on the platform. See the ExtremeXOS Release Notes for the supported values of max-gateways for each protocol and platform.

The ExtremeXOS Release Notes also list the total number of route destinations and the total combinations of gateway sets that each platform can support with the different max-gateways option selections. For more information on selecting the maximum number of gateways and how this affects different platforms, see the “ECMP Hardware Table” in the ExtremeXOS 22.2 User Guide.

You must save the configuration and reboot the switch for the new value to take effect. To see the current and configured value, use the commands show ipconfig or show ipconfig ipv6.


The following example changes the maximum number of ECMP gateways per subnet or gateway set to 8:

configure iproute sharing max-gateways 8


This command was first available in ExtremeXOS 11.4.

The value 2 was first available in ExtremeXOS 12.0.2.

Support for shared gateway sets in the ECMP table was added in ExtremeXOS 12.4.

The values 16 and 32 were first available in ExtremeXOS 15.3.

This command first applied to IPv6 routes in ExtremeXOS 15.3.

The value 64 was added in ExtremeXOS 15.5.2

The default value for max. gateways was changed in ExtremeXOS 22.1 from 4 to 16. This applies only to new configurations. Existing configurations retain their settings.

Platform Availability

This command is available on the Summit X450-G2, X460-G2, X670-G2, X770, and ExtremeSwitching X440-G2, X620, X690, X870 series switches..