configure pim dr-priority

configure pim {ipv4 | ipv6} [ {vlan} vlan_name | vlan all ] dr-priority priority


Configures the designated router (DR) priority that is advertised in PIM hello messages.

Syntax Description

ipv4 IPv4 address family (default).
ipv6 IPv6 address family.
vlan all Apply to all VLANs.
dr-priority Designated Router Priority for VLAN.
priority Priority value for VLAN (default 1). The range is 0–4294967295.


The default setting for dr-priority is 1.

Usage Guidelines

The dr-priority option allows a network administrator to give preference to a particular router in the DR election process by giving it a numerically larger DR priority. The dr-priority option is included in every hello message, even if no DR priority is explicitly configured on that interface. This is necessary because priority-based DR election is only enabled when all neighbors on an interface advertise that they are capable of using the dr-priority option.

The DR priority is a 32-bit unsigned number, and the numerically larger priority is always preferred. A router's idea of the current DR on an interface can change when a PIM hello message is received, when a neighbor times out, or when a router's own DR priority changes. If the router becomes the DR or ceases to be the DR, this will normally cause the DR register state machine to change states. Subsequent actions are determined by that state machine. The DR election process on interface is as follows:
  • If any one of the neighbor on the interface is not advertised the DR priority (not DR capable) then DR priority will not considered for the all the neighbors in the circuit, and the primary IP address will be considered for all the neighbors.
  • The higher DR priority or higher primary address will be elected as DR.


configure pim ipv4 vlan accounting dr-priority 10


This command was first available in ExtremeXOS 15.3.2.

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 PIM feature, see the Switch Engine 32.2 Feature License Requirements document.