configure bgp local-preference

configure bgp local-preference number


Changes the default local preference attribute.

Syntax Description

number Specifies a value used to advertise this router‘s degree of preference to other routers within the AS. Range is 0 to 2147483647.



Usage Guidelines

BGP must be disabled before the local preference attribute can be changed.

BGP selects routes based on the following precedence (from highest to lowest):
  • higher weight

  • higher local preference

  • shortest length (shortest AS path)

  • lowest origin code

  • lowest MED

  • route from external peer

  • lowest cost to Next Hop

  • lowest routerID

Local preference is used to determine a preferred exit point from an AS. Local preferences are exchanged throughout the AS. A change in the local-preference can result in a change in routing and forwarding of traffic leaving the AS.


The following command changes the default local preference attribute to 500:

configure bgp local-preference 500


This command was first available in ExtremeXOS 10.1.

This command required a specific license in ExtremeXOS 11.1.

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 Switch Engine 32.2 Feature License Requirements document.