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