Routing Configuration Guide, Cisco Catalyst SD-WAN Releases 17.x

Configure a PIM BSR

Updated: February 6, 2026

On this page

Overview

Configure Shortest-Path Tree mode for a multicast feature template
Configure a Cisco IOS XE Catalyst SD-WAN device as SPT-only using a CLI template
Configure a PIM feature template and add an interface
Configure the RP candidate
Configure the BSR candidate

Overview

Use this procedure to set up automated discovery by defining feature templates and candidate roles. This high-level workflow ensures that all necessary components are in place for the election process to function correctly.

Before you begin

Every Cisco Catalyst SD-WAN site must have its own RP.

SPT-only mode must be enabled on all Cisco Catalyst SD-WAN sites.

For a BSR to work for any multicast stream that spans across Cisco Catalyst SD-WAN sites, SPT-only mode is mandatory. For a BSR within a local-site multicast stream within a Cisco Catalyst SD-WAN site, it is not necessary to enable SPT-only mode.

For a PIM BSR to elect the RP, configure the following in Cisco SD-WAN Manager:

Procedure

	1.	Multicast feature template with SPT Only set to On for the selected Cisco IOS XE Catalyst SD-WAN device.
	2.	PIM feature template with an interface.
	3.	RP candidate.
	4.	BSR candidate.

Configure Shortest-Path Tree mode for a multicast feature template

Before you begin

In Cisco SD-WAN Manager, configure SPT Only mode to ensure that the RPs can communicate with each other using the shortest-path tree.

When configuring a BSR, configuration of SPT Only mode is mandatory.

Procedure

	1.	From the Cisco SD-WAN Manager menu, choose Configuration > Templates.
	2.	Click Feature Templates. In Cisco SD-WAN Release 20.7.x and earlier releases, Feature Templates is titled Feature.
	3.	Click Add Template.
	4.	From the Select Devices drop-down list, choose a Cisco IOS XE Catalyst SD-WAN device.
	5.	In the Template Name field, enter a name containing up to 128 alphanumeric characters. In the Description field, enter a description containing up to 2048 alphanumeric characters.
	6.	Under the Basic Configuration section for SPT Only, choose On.
	7.	To enable the Local Replicator on the device, choose On (otherwise keep it set to Off).
	8.	To configure a replicator, choose Threshold, and specify a value. (Optional, keep it set to the default value if you are not configuring a replicator).
	9.	Click Save.

Configure a Cisco IOS XE Catalyst SD-WAN device as SPT-only using a CLI template

Procedure

Configure a Cisco IOS XE Catalyst SD-WAN device as spt-only

Device(config)# sdwan multicast address-family ipv4 vrf 1 
spt-only

Use the show platform software sdwan multicast remote-nodes vrf command to verify that system IP addresses are configured with spt-only mode:

Device# show platform software sdwan multicast remote-nodes vrf 1                                         
Multicast SDWAN Overlay Remote Nodes (* - Replicator):                            
                                           Received                Sent           
                 SPT-Only               (X,G)      (S,G)      (X,G)      (S,G)    
 System IP       Mode         Label   Join/Prune Join/Prune Join/Prune Join/Prune 
 172.16.255.11   Yes          1003        0/0        0/0        0/0        0/0    
 172.16.255.14   Yes          1003        0/0        0/0        1/0      10/10    
 172.16.255.16   Yes          1003        0/0        0/0        0/0        0/0    
 172.16.255.21   Yes          1003        0/0        0/0        0/0        0/0

Example:

Sample Multicast Configuration With SPT-Only

Device(config)# sdwan
Device(config)# multicast
Device(config)# address-family ipv4 vrf 1
Device(config)# spt-only
!

Configure a PIM feature template and add an interface

Configure a PIM feature template and add an interface for an RP and the BSR candidate.

Procedure

	1.	From the Cisco SD-WAN Manager menu, choose Configuration > Templates.
	2.	Click Feature Templates. In Cisco SD-WAN Release 20.7.x and earlier releases, Feature Templates is titled Feature.
	3.	Click Add Template.
	4.	From the Select Devices drop-down list, choose a Cisco IOS XE Catalyst SD-WAN device.
	5.	Under Other Templates, choose Cisco PIM.
	6.	In the Template Name field, enter a name containing up to 128 alphanumeric characters. In the Description field, enter a description containing up to 2048 alphanumeric characters.
	7.	Click Interface > New Interface. In the Interface Name field, specify an interface with a value.
	8.	In the Query Interval (seconds) field, the field auto-populates. In the Join/Prune Interval (seconds) field, the field auto-populates.
	9.	Click Add and then click Save.

Configure the RP candidate

Configure the same Cisco IOS XE Catalyst SD-WAN device as the candidate RP for all multicast groups or selective groups.

Procedure

	1.	From the Cisco SD-WAN Manager menu, choose Configuration > Templates.
	2.	Click Feature Templates. In Cisco SD-WAN Release 20.7.x and earlier releases, Feature Templates is titled Feature.
	3.	Edit the PIM feature template that you created by clicking ... and then clicking Edit.
	4.	Click Basic Configuration.
	5.	Click RP Candidate > New RP Candidate.
	6.	From the Interface drop-down list, choose the interface that you used for configuring the PIM feature template. (Optional) In the Access List field, if you have configured the access list with a value, add the same value. (Optional) In the Interval field, if you have configured the interval with a value, add the same interval value.
	7.	In the Priority field, specify a higher priority on the Cisco IOS XE Catalyst SD-WAN device than on the service-side device.
	8.	Click Add.
	9.	Click Update to save your configuration changes.

Configure the BSR candidate

Procedure

	1.	Repeat Step 1 through Step 4 from the Configure the RP candidate section.
	2.	Click BSR Candidate.
	3.	In the BSR Candidate field, chose the same interface from the drop-down list that you used for configuring the PIM feature template.
	4.	(Optional) In the Hash Mask Length field, specify the hash mask length. Valid values for hash mask length range from 0 – 32.
	5.	In the Priority field, specify a higher priority on the Cisco IOS XE Catalyst SD-WAN device device than on the service-side device.
	6.	(Optional) In the RP Candidate Access List field, if you have configured the RP candidate access list with a value, add the same value. An RP candidate uses a standard access control list (ACL) where you can enter the name for the access list.
	7.	Click Update to save your configuration changes.

Need help?

Open a support case

(Requires a Cisco Service Contract)

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.