enable iproute sharing

enable iproute {ipv4} 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, BGP, or IS-IS routes. In OSPF, BGP, and IS-IS, this capability is referred to as equal cost multipath (ECMP) routing.

Configure static routes and OSPF, BGP, or IS-IS as you would normally. The ExtremeXOS software supports route sharing across up to 32 ECMP static routes or up to 8 ECMP routes for OSPF, BGP, or IS-IS. However, on the BlackDiamond 8800 family, SummitStack, and Summit family switches, by default, up to four routes are supported. To support 2, 4, 8, 16 or 32 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.

Platform Availability

This command is available on all platforms, except Summit X440. If present in a SummitStack, any Summit X440 nodes ingressing IPv4 unicast packets will still perform unipath IPv4 forwarding in hardware.