enable iproute sharing

enable iproute {ipv4 |ipv6} sharing {{vr} vrname} | {{vr} all}}


Enables load sharing if multiple routes to the same destination are available. When multiple routes to the same destination are available, load sharing can be enabled to distribute the traffic to multiple destination gateways. Only paths with the same lowest cost are shared.

Syntax Description

vrname VR or VRF name for which IP route sharing is being enabled.



Usage Guidelines

IP route sharing allows multiple equal-cost routes to be used concurrently. IP route sharing can be used with static routes or with OSPF (Open Shortest Path First), BGP (Border Gateway Protocol), or IS-IS routes. In OSPF, BGP, and IS-IS, this capability is referred to as ECMP (Equal Cost Multi Paths) routing.

Configure static routes and OSPF, BGP, or IS-IS as you would normally. The ExtremeXOS software supports route sharing across up to 64 way ECMP for OSPFv2, BGP, and static routes, or up to 64-way ECMP for OSPFv3 (Open Shortest Path First version 3) and 8 way for ISIS. However, on SummitStack, and Summit family switches, by default, up to four routes are supported. To support 2, 4, 8, 16, 32, or 64 routes on these switches, use the following command:

configure iproute sharing max-gateways max_gateways

If a VR is not specified, this command enables IP route sharing in the current VR context.


The following example enables load sharing for multiple routes:

enable iproute sharing


This command was first available in ExtremeXOS 11.1.

The vr option was added in ExtremeXOS 12.5.

The ipv6 option was first available in ExtremeXOS 15.3.

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.