bsr-candidate

Configures a bootstrap router (BSR) as a candidate to distribute rendezvous point (RP) information to the other PIM-SM (Sparse Mode) devices in a PIM-SM domain.

Syntax

bsr-candidate interface {ethernet | loopback | port-channel | ve } num mask length [priority value]

no bsr-candidate

Command Default

By default, the PIM router is not part of the BSR election process.

Parameters

ethernet num

Specifies the Ethernet interface for the candidate BSR.

loopback num

Specifies the loopback interface for the candidate BSR.

ve num

Specifies the virtual interface for the candidate BSR.

port-channel num

Specifies the port-channel number for the candidate BSR.

mask

Specifies the mask for the candidate BSR.

length: Specifies the hash mask length. Valid values range from 1-32 for IPv4 PIM.

priority value: Specifies the BSR priority. Valid values range from 0-255.

Modes

PIM Router configuration mode

Usage Guidelines

Each PIM-SM domain has one active BSR. For redundancy, you can configure ports on multiple devices as candidate BSRs. PIM-SM uses an election process to select one of the candidate BSRs as the BSR for the domain. The BSR with the highest BSR priority is elected. If the priorities result in a tie, the candidate BSR interface with the highest IP address is elected.

Although you can configure the device as only a candidate BSR or an RP, a best practice is to configure the same interface on the same device as both a BSR and an RP.

The no bsr-candidate form of this command makes the PIM router cease to act as a candidate BSR.

Examples

The following example configures a physical interface as a candidate BSR.

device(config)# router pim
device(config-pim-router)# bsr-candidate ethernet 2/2 30 255

The following example configures a loopback interface as a candidate BSR.

device(config)# router pim
device(config-pim-router)# bsr-candidate interface loopback 11 mask 32

The following example configures a virtual interface as a candidate BSR.

device(config)# router pim
device(config-pim-router)# bsr-candidate ve 120 30 250

The following example configures an IPv6 virtual interface as a candidate BSR.

device(config)# ipv6 router pim
device(config-ipv6-router-pim-vrf-default-vrf)# bsr-candidate interface ve 30 mask 126 priority 10

The following example configures an IPv6 physical interface as a candidate BSR.

device(config)# ipv6 router pim
device(config-ipv6-router-pim-vrf-default-vrf)# bsr-candidate interface ethernet 2/2 mask 64

The following example configures an IPv6 loopback interface as a candidate BSR.

device(config)# ipv6 router pim
device(config-ipv6-router-pim-vrf-default-vrf)# bsr-candidate interface loopback 11 mask 96 priority 20