ip pim rp-candidate

Use this command to enable the router to advertise itself as a PIM candidate rendezvous point (RP) to the BSR.

Syntax

ip pim rp-candidate pim-interface-address {group-address group-mask | priority priority | group-list group-list [priority priority]}
no ip pim rp-candidate pim-interface-address {group-address group-mask | group-list group-list [priority priority]}

Parameters

pim-interface-address Address of the interface to advertise as an RP candidate. With the exception of a loopback interface, the interface used as the RP candidate must be enabled with PIM as described in ip pim sparse-mode.
group-address Specifies the multicast group address.
group-mask Specifies the multicast group mask.
priority priority Specifies an RP priority value, ranging from 0–255. Lower values assign higher priority. Default value: 192.
group-list group-list Specifies a permit only standard access-list containing one or more multicast group addresses. All non-permit multicast groups are ignored.

Defaults

If no priority is specified when assigning a group-address or group-list, the priority defaults to 192.

Mode

Configuration command.

Usage

At least one group-address or a group list must be specified before this RP will be active. For each candidate RP, groups may be configured either individually or using a group-list. A group-list must exist before it may be used by this command. If a group-list referenced by this command is removed, that configuration will also be removed. Before using a group-list, any groups entered using the group-address and group-mask must be removed.

The “no” form of this command removes the candidate RP configuration for the group-list or group-address specified, but resets the priority to default of 192, if only the priority is specified. Groups specified using a group-list may not be removed by using the group-address group-mask option; they must be removed using the group-list option.

Examples

This example enables the PIM interface at address 35.0.0.1 to advertise itself as an RP candidate with a priority of 5:

System(su-config)->ip pim rp-candidate 35.0.0.1 priority 5

This example enables the PIM interface at address 35.0.0.1 to advertise itself as an RP candidate with a priority of 5, for groups specified in the pimrp standard access-list:

System(su-config)->ip pim rp-candidate 35.0.0.1 group-list pimrp priority 5