rp-candidate

Configures a device as a candidate rendezvous point (RP) for all multicast groups with the prefix 224.0.0.0/4 (IPv4), by default, or for a specified group range.

Syntax

rp-candidate [interface {ethernet | loopback | port-channel | ve}interface-number ] | [prefix prefix-list ]

Command Default

By default, the PIM router is not available for selection as an RP.

Parameters

interface ethernet | loopback | port-channel | ve interface-number
Specifies an interface for the candidate RP and the interface number in slot or slot/port format.
prefix prefix-list
Specifies the list that identifies the IPv4 or IPv6 group address range.

Modes

Router PIM configuration mode

Usage Guidelines

The RP is the meeting point for PIM-SM (Sparse Mode) sources and receivers. A PIM-SM domain can have multiple RPs, but each PIM-SM multicast group address can have only one active RP. PIM-SM routers learn the addresses of RPs and the groups for which they are responsible from messages that the bootstrap router (BSR) sends to PIM-SM router.

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 rp-candidate form of the command makes the PIM router cease to act as a candidate RP.

Examples

This example configures a physical device as a candidate RP.
device(config)# router pim
device(config-pim-router)# rp-candidate interface ethernet 1/1
This example configures a loopback interface as a candidate RP.
device(config)# router pim
device(config-pim-router)# rp-candidate interface loopback 11
device(config-pim-router)# rp-candidate prefix my-rp-cand-list
device(config)# ip prefix-list my-rp-cand-list permit 226.1.1.0/24
device(config)# ip prefix-list my-rp-cand-list permit 228.1.1.0/24

This example configures an IPv6 physical device as a candidate RP.

device(config)# ipv6 router pim
device(config-ipv6-router-pim-vrf-default-vrf)# rp-candidate interface ethernet 1/1

This example configures the candidate RP with an IPv6 prefix list.

device(config)# ipv6 router pim
device(config-ipv6-router-pim-vrf-default-vrf)# rp-candidate prefix group-plist1

This example configures an IPv6 loopback interface as a candidate RP.

device(config)# ipv6 router pim
device(config-ipv6-router-pim-vrf-default-vrf)# rp-candidate interface loopback 11
device(config-ipv6-router-pim-vrf-default-vrf)# rp-candidate prefix group-plist1
device(config)# ipv6 prefix-list group-plist1 permit ff08::/16
device(config)# ipv6 prefix-list group-plist1 permit ff05::/16