configure bgp maximum-paths

configure bgp maximum-paths max-paths


Enables or disables the BGP (Border Gateway Protocol) ECMP (Equal Cost Multi Paths) feature and specifies the maximum number of paths supported on the current VR.

Syntax Description

max-paths Specifies the maximum number of paths. The range is 1 to 64. The value 1 disables BGP ECMP. A value greater than 1 enables BGP ECMP and specifies the maximum number of paths.


One. BGP ECMP is disabled.

Usage Guidelines

This command triggers the BGP decision process, causing BGP to re-install the entire BGP routing table into the IP forwarding table. This activity requires a significant amount of switch processor resources, so we recommend that you enable or disable the BGP ECMP feature before enabling the BGP protocol globally on a VR. To ensure that BGP ECMP routes are programmed in the hardware, enter the enable iproute sharing command.



BGP must be disabled before you can change the configuration with this command.


The following command enables BGP ECMP and sets the maximum number of paths to 4 (the maximum number of possible paths is 64):

configure bgp maximum-paths 4


This command was first available in ExtremeXOS 12.1.3.

Platform Availability

This command is available on platforms that support the appropriate license. For complete information about software licensing, including how to obtain and upgrade your license and which licenses support the BGP feature, see the ExtremeXOS 22.2 Feature License Requirements document.