bsr-candidate

Configures a bootstrap router (BSR) as a candidate to distribute rendezvous point (RP) information to the other PIM Sparse devices within a PIM Sparse domain.
Syntax
bsr-candidate ethernet unit/slot/port hash-mask-length [ priority ]
bsr-candidate lag lag-id hash-mask-length [ priority ]
bsr-candidate loopback num hash-mask-length [ priority ]
bsr-candidate ve num hash-mask-length [ priority ]
bsr-candidate tunnel num hash-mask-length [ priority ]
no bsr-candidate
Command Default

The PIM router does not participate in BSR election.

Parameters
ethernet unit/slot/port
Specifies the Ethernet interface for the candidate BSR.
lag lag-id
Specifies the LAG virtual interface.
loopback num
Specifies the loopback interface for the candidate BSR.
ve num
Specifies the virtual interface for the candidate BSR.
tunnel num
Specifies a GRE tunnel interface.
hash-mask-length
Specifies the number of bits in a group address that are significant when calculating the group-to-RP mapping. The range is 1 to 32.
Note: It is recommended that you specify 30 for IPv4 networks.
priority
Specifies the BSR priority. The range is from 0 to 255, from low to high. The default is 0.
Modes

PIM Router configuration mode

Usage Guidelines

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

Each PIM Sparse domain has one active BSR. For redundancy, you can configure ports on multiple devices as candidate BSRs. The PIM Sparse protocol 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, it is recommended that you configure the same interface on the same device as both a BSR and an RP.

Examples

The following example uses a physical interface to configure a device as a candidate BSR.

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

The following example uses a loopback interface to configure a device as a candidate BSR.

device(config)# router pim
device(config-pim-router)# bsr-candidate loopback 1 30 240

The following example uses a virtual interface to configure a device as a candidate BSR.

device(config)# router pim
device(config-pim-router)# bsr-candidate ve 120 30 250
History
Release version Command history
08.0.20 This command was modified to add the tunnel keyword.
08.0.61 This command was modified to add lag lag-id options.