clear ip pim counters
To reset the Protocol Independent Multicast (PIM) traffic counters, use the clear ip pim counters command in privileged EXEC mode.
Syntax
clear ip pim counters
Parameters N/A
Command Mode
Privileged EXEC mode
User Guidelines
Using the clear ip pim counters command will reset all PIM traffic counters.
Example
The following example resets the PIM traffic counters:
switchxxxxxx# clear ip pim counters |
ip pim
To enable Protocol Independent Multicast (PIM) on an interface, use the ip pim command in interface configuration mode. To disable PIM on the interface, use the no form of this command.
Syntax
ip pim no ip pim
Parameters N/A
Default Configuration Disabled
Command Mode
Interface Configuration mode
User Guidelines
After a user has enabled the ip multicast-routing command, PIM is enabled to run on every interface. Because PIM is enabled on every interface by default, use the no form of the ip pim command to disable PIM on a specified interface.
Example
The following example turns off PIM on VLAN 100:
switchxxxxxx(config)# interface vlan 100 switchxxxxxx(config-if)# no ip pim switchxxxxxx(config-if)# exit |
ip pim accept-register
To configure a candidate rendezvous point (RP) router to filter Protocol Independent Multicast (PIM) register messages, use the ip pim accept-register command in global configuration mode. To disable this function, use the no form of this command.
Syntax
ip pim accept-register list access-list no ip pim accept-register list
Parameters
n acces-list—Defines the IP pair access list name.
Default Configuration The command is disabled.
Command Mode
Global Configuration mode
User Guidelines
Use this command to prevent unauthorized sources from registering with the RP. If an unauthorized source sends a register message to the RP, the RP will immediately send back a register-stop message.
Example
The following example shows how to deny register packets for source addresses 10.1.1.0/24 and 172.100.1.1 sending to the 232.0.0.0/8 group range. All other PIM register messages not matching the pair access list are permitted. These statements should be configured on all candidate RPs because candidate RPs will receive PIM registers from first hop routers:
switchxxxxxx(config)# ip pim accept-register list no-range switchxxxxxx(config)# ip access-list pair no-range deny 10.1.1.0/24232.0.0.0/8switchxxxxxx(config)# ip access-list pair no-range deny 172.100.1.1 232.0.0.0/8switchxxxxxx(config)# ip access-list pair no-range permit any any |
ip pim bsr-border
To configure a border for all bootstrap message (BSMs) on a specified interface, use the ip pim bsr-border command in interface configuration mode. To remove the border, use the no form of this command.
Syntax
ip pim bsr-border no ip pim bsr-border
Parameters N/A
Default Configuration No border is configured.
Command Mode
Interface Configuration mode
User Guidelines
The ip pim bsr-border command is used to configure a border. The command filters incoming or outgoing BSMs, preventing the BSMs from being forwarded or accepted on the interface on which the ip pim bsr-border command is configured.
When this command is configured on an interface, no Protocol Independent Multicast (PIM) Version 2 BSR messages will be sent or received through the interface. Configure an interface bordering another PIM domain with this command to avoid BSR messages from being exchanged between the two domains. BSR messages should not be exchanged between different domains, because routers in one domain may elect rendezvous points (RPs) in the other domain, resulting in protocol malfunction or loss of isolation between the domains.
Note. This command does not set up multicast boundaries. It sets up only a PIM domain BSR message border.
Example
The following example configures a BSR border on VLAN 100:
switchxxxxxx(config)# interface vlan 100switchxxxxxx(config-if)# ip pim bsr-borderswitchxxxxxx(config-if)# exit |
ip pim bsr-candidate
To configure a router to be a candidate bootstrap router (BSR), use the ip pim bsr-candidate command in global configuration mode. To remove this router as a candidate BSR, use the no form of this command.
Syntax
ip pim bsr-candidate ip-address [hash-mask-length] [priority priority-value] no ip pim bsr-candidate
Parameters
- ip-address—The IP address of the router to be configured as a candidate BSR.
- hash-mask-length—Length of a mask (32 bits maximum) that is to be ANDed with the group address before the hash function is called. All groups with the same seed hash (correspond) to the same RP. For example, if this value is 24, only the first 24 bits of the group addresses matter. This fact allows you to get one RP for multiple groups. The default value is 30.
- priority—Priority of the candidate BSR.
- priority-value—Integer from 0 through 192. The BSR with the larger priority is preferred. If the priority values are the same, the router with the larger IP address is the BSR. The default value is 0.
Default Configuration
Router is not enabled as a BSR.
Command Mode
Global Configuration mode
User Guidelines
The ip pim bsr-candidate command is used to configure a router as a candidate BSR. When a router is configured, it will participate in BSR election. If elected BSR, this router will periodically originate BSR messages advertising the group-to-RP mappings it has learned through candidate-RP-advertisement messages.
Example
The following example configures the router with the IPv6 address 112.8.3.3 as the candidate BSR, with a hash mask length of 24 and a priority of 10:
switchxxxxxx(config)# ip pim bsr-candidate 112.8.3.3 24 priority 10 |
ip pim dr-priority
To configure the designated router (DR) priority on a Protocol Independent Multicast (PIM) router, use the ip pim dr-priority command in interface configuration mode. To restore the default value, use the no form of this command.
Syntax
ip pim dr-priority value no ip pim dr-priority
Parameters
n value—An integer value to represent DR priority. Value range is from 0 to 4294967294.
Default Configuration
Default value is 1.
Command Mode
Interface Configuration mode
User Guidelines
The ip pim dr-priority command configures the neighbor priority used for PIM DR election. The router with the highest DR priority on an interface becomes the PIM DR. If several routers have the same priority, then the router with the highest IP address on the interface becomes the DR.
If a router does not include the DR priority option in its hello messages, then the router is considered to be the highest-priority router and becomes the DR. If several routers do not include the DR priority option in their hello messages, then the router with the highest IP address becomes the DR.
Example
The following example configures the router to use DR priority 3:
switchxxxxxx(config)# interface vlan 100switchxxxxxx(config-if)# ip pim dr-priority 3switchxxxxxx(config-if)# exit |
ip pim hello-interval
To configure the frequency of Protocol Independent Multicast (PIM) hello messages on an interface, use the ip pim hello-interval command in interface configuration mode. To return to the default interval, use the no form of this command.
Syntax
ip pim hello-interval seconds no ip pim hello-interval
Parameters
n seconds—Interval, in seconds, at which PIM hello messages are sent. The range is from 1 to 18000.
Default Configuration
Hello messages are sent at 30-second intervals with small random jitter.
Command Mode
Interface Configuration mode
User Guidelines
Periodic hello messages are sent out at 30-second intervals with a small jitter. The ip pim hello-interval command allows users to set a periodic interval.
Example
The following example sets the PIM hello message interval to 45 seconds:
switchxxxxxx(config)# interface vlan 100switchxxxxxx(config-if)# ip pim hello-interval 45switchxxxxxx(config-if)# exit |
ip pim join-prune-interval
To configure periodic join and prune announcement intervals for a specified interface, use the ip pim join-prune-interval command in interface configuration mode. To return to the default value, use the no form of the command.
Syntax
ip pim join-prune-interval seconds no ip pim join-prune-interval
Parameters
n seconds—The join and prune announcement intervals, in number of seconds. The range is from 1 to 18000.
Default Configuration
The default is 60 seconds.
Command Mode
Interface Configuration mode
User Guidelines
The ip pim join-prune-interval command allows users to set a periodic interval. The configured
PIM join/prune interval also determines the join/prune hold time used by a PIM router as follows:
3.5 * join/prune interval
Example
The following example sets the join and prune announcement intervals to 75 seconds:
switchxxxxxx(config)# interface vlan 100switchxxxxxx(config-if)# ip pim join-prune-interval 75switchxxxxxx(config-if)# exit |
ip pim neighbor-filter
To filter Protocol Independent Multicast (PIM) neighbor messages from specific IP addresses, use the ip pim neighbor-filter command in the interface configuration mode. To return to the router default, use the no form of this command.
Syntax
ip pim neighbor-filter access-list no ip pim neighbor-filter
Parameters
n access-list—Name of an IP standard access list that denies PIM hello packets from a source. The name may contain maximum 32 characters.
Default Configuration
PIM neighbor messages are not filtered.
Command Mode
Interface Configuration mode
User Guidelines
The ip pim neighbor-filter command is used to prevent unauthorized routers on the LAN from becoming PIM neighbors. Hello messages from addresses specified in this command are ignored.
Example
The following example causes PIM to ignore all hello messages from IP address 10.1.1.1:
switchxxxxxx(config)# interface vlan 100switchxxxxxx(config-if)# ip6 pim neighbor-filter nbr_filter_aclswitchxxxxxx(config-if)# exitswitchxxxxxx(config)# ip access-list nbr_filter_acl deny 10.1.1.1switchxxxxxx(config)# ip access-list nbr_filter_acl permit any |
ip pim rp-address
To configure the address of a Protocol Independent Multicast (PIM) rendezvous point (RP) for a particular group range, use the ip pim rp-address command in global configuration mode. To remove an RP address, use the no form of this command.
Syntax
ip pim rp-address rp-address [group-access-list] no ip pim rp-address rp-address
Parameters
- rp-address—The IP address of a router to be a PIM RP. This is a unicast IP address in four-part dotted-decimal notation.
- group-access-list—Name of an IP standard access list that defines for which multicast groups the RP should be used. The name may contain maximum 32 characters.
If the access list contains any group address ranges that overlap the assigned source-specific multicast (SSM) group address range, a warning message is displayed, and the overlapping ranges are ignored. If no access list is specified, the specified RP is used for all valid multicast non-SSM address ranges.
To support embedded RP, the router configured as the RP must use a configured access list that permits the embedded RP group ranges derived from the embedded RP address.
Default Configuration
No PIM RPs are preconfigured.
Command Mode
Global Configuration mode
User Guidelines
Groups in sparse mode need to have the IP address of one router to operate as the RP for the group. All routers in a PIM domain need to have a consistent configuration for the mode and RP addresses of the multicast groups.
PIM learns RP addresses of multicast groups through the following three mechanisms: static configuration, and bootstrap router (BSR). Use the ip pim rp-address command to statically define the RP address for multicast groups.
You can configure PIM to use a single RP for more than one group. The conditions specified by the access list determine for which groups the RP can be used. If no access list is configured, the RP is used for all groups. A PIM router can use multiple RPs, but only one per group.
If multiple ip pim rp-address commands are configured, the following rules apply to a multicast group:
- Highest RP IP address selection: If a group is matched by the access list of more than one ip pim rp-address command whose prefix masks are all the same lengths, then the mode and RP for the group are determined by the ip pim rp-address command with the highest RP address parameter.
- Static evaluation: The mode and RP selection for a group are static and do not depend on the reachability of the individual RPs. The router will not start using an RP with a lower IP address or a shorter prefix length match if the better RP is not reachable.
- One IP address per command: An IP address can be used as a parameter for only one ip pim rp-address If an ip pim rp-address command is configured with an IP address parameter that was previously used to configure an older ip pim rp-address command, then this old command will be replaced with the newly configured command.
- One access list per command: A specific access list can be used as a parameter for only one ip pim rp-address command. If an ip pim rp-address command is configured with an access list parameter that was previously used to configure an older ip pim rp-address command, then this old command will be replaced with the newly configured command.
Static definitions for the group mode and RP address of the ip pim rp-address command may be used together with dynamically learned group mode and RP address mapping through BSR. The mappings statistically defined by the ip pim rp-address command take precedences over mappings learned through BSR.
Example
Example 1. The following example shows how to set the PIM RP address to 192.168.0.0 for all multicast groups and defines all groups to operate in sparse mode: ip pim rp-address 192.168.0.0:
switchxxxxxx(config)# ip pim rp-address 192.168.0.0 |
Example 2. The following example shows how to set the PIM RP address to 172.16.0.0 for the multicast group 225.2.2.2 only:
switchxxxxxx(config)# ip access-list acc-grp-1 permit 225.2.2.2 switchxxxxxx(config)# ip pim rp-address 172.16.0.0 acc-grp-1 |
ip pim rp-candidate
To configure the candidate rendezvous point (RP) to send Protocol Independent Multicast (PIM) RP advertisements to the bootstrap router (BSR), use the ip pim rp-candidate command in global configuration mode. To disable PIM RP advertisements to the BSR, use the no form of this command.
Syntax
ip pim rp-candidate rp-address [group-list access-list-name] [priority priority-value] [interval seconds]
no ip pim rp-candidate ipv6-address
Parameters
- rp-address—The IP address of the router to be advertised as the candidate RP (C-RP).
- group-list—List of group prefixes. If no access list is specified, all valid multicast nonsource-specific multicast (SSM) address ranges are advertised in association with the specified RP address.
- access-list-name—Name of the IP standard access list containing group prefixes that will be advertised in association with the RP address. If the access list contains any group address ranges that overlap the assigned SSM group address range, a warning message is displayed, and the overlapping address ranges are ignored.
- priority—Priority of the candidate BSR.
- priority-value—Integer from 0 through 192. The RP with the higher priority is preferred. If the priority values are the same, the router with the higher IPv6 address is the RP. The default value is 192.
- interval—Configures the C-RP advertisement interval. The range is from 1 to 16383 seconds. The default value is 60 seconds.
- seconds—Advertisement interval in number of seconds.
Default Configuration
Router is not enabled as a candidate RP.
Command Mode
Global Configuration mode
User Guidelines
Use the ipv6 pim rp-candidate command to send PIM RP advertisements to the BSR.
The group prefixes defined by the access-list-name argument will also be advertised in association with the RP address. If a group prefix in the access list is denied, it will not be included in the C-RP advertisement.
If the priority priority-value keyword and argument are specified, then the router will announce itself to be a candidate RP with the specified priority.
Example
The following example shows how to configure the router to advertise itself as a candidate RP to the BSR in its PIM domain. Standard access list list1 specifies the group prefix associated with the 100.1.1.1 RP address. That RP is responsible for the groups with the prefix 239.0.0.0/8:
switchxxxxxx(config)# ip pim rp-candidate 100.1.1.1 group-list list1switchxxxxxx(config)# ip access-list list permit 239.0.0.0/8 |
ip pim ssm
To define the Source Specific Multicast (SSM) range of IP multicast addresses, use the ip pim ssm command in global configuration mode. To disable the SSM range, use the no form of this command.
Syntax
ip pim ssm {default | range access-list} no ip pim ssm
Parameters
- default—Defines the SSM range access list to 232/8 (see rfc4607).
- range access-list—Specifies the standard IP access list name defining the SSM range.
Default Configuration
The command is disabled.
Command Mode
Global Configuration mode
User Guidelines
Use the no ip pim ssm command to remove all defined ranges.
Example
The following example shows how to configure SSM service for the default IP address range and the IP address ranges defined by access lists list1 and list2 :
switchxxxxxx(config)# ip access-list list1 permit 224.2.151.0/24switchxxxxxx(config)# ip access-list list1 deny 224.2.152.141switchxxxxxx(config)# ip access-list list1 permit 224.2.152.0/24switchxxxxxx(config)# ip pim ssm range list1 |
show ip pim bsr
To display information related to Protocol Independent Multicast (PIM) bootstrap router (BSR) protocol processing, use the show ip pim bsr command in user EXEC or privileged EXEC mode.
Syntax
show ip pim bsr {election | rp-cache | candidate-rp}
Parameters
- election—Displays BSR state, BSR election, and bootstrap message (BSM)-related timers.
- rp-cache—Displays candidate rendezvous point (C-RP) cache learned from unicast C-RP announcements on the elected BSR.
- candidate-rp—Displays C-RP state on routers that are configured as C-RPs.
Command Mode User EXEC mode
Privileged EXEC mode
User Guidelines
Use the show ip pim bsr command to display details of the BSR election-state machine, C-RP advertisement state machine, and the C-RP cache. Information on the C-RP cache is displayed only on the elected BSR router, and information on the C-RP state machine is displayed only on a router configured as a C-RP.
Example
Example 1. The following example displays BSM election information:
switchxxxxxx# show ip pim bsr electionPIMv2 BSR informationBSR Election InformationScope Range List: 232.1.1.0/24This system is the Bootstrap Router (BSR)BSR Address: 110.60.1.4Uptime: 00:11:55, BSR Priority: 0, Hash mask length: 126RPF: 160.1.1.1,vlan0BS Timer: 00:00:07This system is candidate BSRCandidate BSR address: 110.2.1.4, priority: 0, hash mask length: 126 |
Description of Significant fields
Scope Range List—Scope range list to which this BSR information applies.
This system is the Bootstrap Router (BSR)—Indicates this router is the BSR and provides information on the parameters associated with it.
BS Timer—On the elected BSR, the BS timer shows the time in which the next BSM will be originated. On all other routers in the domain, the BS timer shows the time at which the elected BSR expires.
This system is candidate BSR—Indicates this router is the candidate BSR and provides information on the parameters associated with it.
Example 2. The following example displays information that has been learned from various C-RPs at the BSR. In this example, two candidate RPs have sent advertisements for the 232.1.1.0/24 or the default IP multicast range:
switchxxxxxx# show ip pim bsr rp-cachePIMv2 BSR C-RP CacheBSR Candidate RP CacheGroup(s) 232.1.1.0/24, RP count 2RP 12.1.1.3Priority 192, Holdtime 150Uptime: 00:12:36, expires: 00:01:55RP 20.1.1.1Priority 192, Holdtime 150Uptime: 00:12:36, expires: 00:01:5 |
Example 3. The following example displays information about the C-RP:
switchxxxxxx# show ip pim bsr candidate-rpPIMv2 C-RP informationCandidate RP: 10.1.1.3Priority 192, Holdtime 150Advertisement interval 60 seconds Next advertisement in 00:00:33 |
show ip pim counters
To display the Protocol Independent Multicast (PIM) counters, use the show ip pim counters command in user EXEC or privileged EXEC mode.
Syntax show
show ip pim counter
Parameters
N/A
Command Mode User EXEC mode
Privileged EXEC mode
User Guidelines
Use the show ip pim counters command to check if the expected number of PIM protocol messages have been received and sent.
Example
The following example shows the number of PIM protocol messages received and sent:
switchxxxxxx# show ip pim counters iPIM Traffic CountersElapsed time since counters cleared: 00:05:29Received SentValid PIM Packets 22 22Hello 22 22Join-Prune 0 0Register 0 0Register Stop 0 0Assert 0 0Bootstrap 0 0Errors:Send Errors 0Bad Checksums 0Packets Received on PIM-disabled Interface 0Packets Received with Unknown PIM Version 0 |
show ip pim group-map
To display an IPv6 Protocol Independent Multicast (PIM) group mapping table, use the show ip pim group-map command in user EXEC or privileged EXEC mode
Syntax
show ip pim group-map [group-address]
Parameters
n group-address—IP address of the multicast group.
Command Mode User EXEC mode
Privileged EXEC mode
User Guidelines
Use the show ip pim group-map command without the group-address argument to display mapping of all groups.
Example
The following example displays information about all groups:
switchxxxxxx# show ip pim group-mapGroup(s) 226.0.0.0/8SM RP 10.10.0.1 (?)Info source: LocalGroup(s) 227.0.0.0/8SM RP 10.10.0.2 (?)Info source: Static Group(s) 228.0.0.0/8SM RP 10.10.0.3 (?)Info source: From BSR 10.10.0.3 (?), Priority: 192Uptime:00:01:26, expires:00:00:34Group(s) 229.0.0.0/8SM RP 10.10.0.5 (mcast1.aaaa.com)Info source: From BSR 10.10.0.5 (mcast1.aaaa.com), Priority: 192Uptime:00:00:52, expires:00:00:37Group(s) 232.0.0.0/8 SMM |
show ip pim interface
To display information about interfaces configured for Protocol Independent Multicast (PIM), use the show ip pim interface command in privileged EXEC mode.
Syntax
show ip pim interface [state-on | state-off | interface-id]
Parameters
- state-on—Displays interfaces with PIM enabled (adminastrative mode).
- state-off—Displays interfaces with PIM disabled(adminastrative mode).
- interface-id—Display the interface with the Interface identifier.
Command Mode User EXEC mode
Privileged EXEC mode
User Guidelines
The show ipv6 pim interface command is used to check if PIM is enabled on an interface, the number of neighbors, and the designated router (DR) on the interface.
Example
Example 1. The following example displays only PIM state on interfaces:
switchxxxxxx# show ip pim interface IP Forwarding is enabledIP Multicast Routing is enabledPIM is enabled SSM IP ranges:default access list: list1 access list: list2Interface Address Status vlan 1 1.1.1.1 disabled vlan 100 102.1.1.1 enabled vlan 102 160.1.1.1 enabled vlan 103 enabled |
Example 2. The following is sample output from the show ip pim interface command using the state-on keyword when IP Multicast Routing is disabled:
switchxxxxxx# show ip pim interface state-onIP Forwarding is enabledIP Multicast Routing is disabled PIM is disabledSSM IP ranges: default access list: list1 access list: list2Interface Status Nbr Hello Join-Prune DR Count Intvl Intvl Prior vlan 1 disabled Address: 102.1.1.1 DR:Neighbor Filter List: filt vlan 100 disabled Address: 102.1.1.1 DR:Neighbor Filter List: nbr-filter vlan 102 enabled Address: 160.1.1.1 DR:Neighbor Filter List:vlan 103 enabled Address:DR:Neighbor Filter List: filter1 |
Example 3. The following is sample output from the show ip pim interface command using the state-on keyword:
switchxxxxxx# show ip pim interface state-onIP Forwarding is enabledIP Multicast Routing is enabledPIM is enabled SSM IP ranges: default access list: list1 access list: list2 Interface Statuse Nbr Hello Join-Prune DR Count Intvl Intvl Prior vlan 100 enabled 0 30 60 1Address: 102.1.1.1DR: this systemNeighbor Filter List: nbr-filter vlan 102 enabled 1 30 60 1Address: 160.1.1.1DR: 160.1.1.10 Neighbor Filter List:vlan 103 enabled Address:DR:Neighbor Filter List: filter1 |
Example 4. The following is sample output from the show ip pim interface command using the interface-id argument:
switchxxxxxx# show ip pim interface vlan 100IP Forwarding is enabledIP Multicast Routing is enabledPIM is enabled SSM IP ranges: default access list: list1 access list: list2Interface Statuse Nbr Hello Join-Prune DR Count Intvl Intvl Prior vlan 100 enabled 0 30 60 1Address: 102.1.1.1DR: this systemNeighbor Filter List: nbr-filter |
show ip pim neighbor
To display the Protocol Independent Multicast (PIM) neighbors discovered by the switch, use the show ip pim neighbor command in user EXEC or privileged EXEC mode.
Syntax
show ip pim neighbor [detail] [interface-id]
Parameters
- detail—Displays the additional addresses of the neighbors learned, if any, through the Address List (type 24) Hello option.
- interface-id—Interface identifier.
Command Mode User EXEC mode
Privileged EXEC mode
User Guidelines
The show ipv6 pim neighbor command displays which routers on the LAN are configured for PIM.
Example
The following is sample output from the show ip pim neighbor command using the detail keyword to identify the additional addresses of the neighbors learned through the routable address hello option:
switchxxxxxx# show ip pim neighbor detailNeighbor Address(es) Interface Uptime Expires DR pri10.1.1.1 vlan 100 01:34:16 00:01:16 1 60.1.1.310.1.1.4 vlan 140 01:34:15 00:01:18 160.1.1.4 |
show ip pim rp mapping
To display active rendezvous points (RPs) that are cached with associated multicast routing entries, use the show ip pim rp mapping command in user EXEC or privileged EXEC mode.
Syntax
show ip pim rp mapping [rp-address]
Parameters
n rp-address—RP IP address.
Command Mode User EXEC mode
Privileged EXEC mode
User Guidelines
Use the show ip pim rp mapping command with the rp-address argument to display information about the given RP.
Use the show ip pim rp mapping command without the rp-address argument to display information about all known RPs.
Example
The following example displays information about all known all RPs:
switchxxxxxx# show ip pim rp mappingThis system is an RPRegister Acces List: list1Group(s) 226.0.0.0/8 RP 10.10.0.1 (?)Info source: Local Uptime: 00:02:40Group(s) 227.0.0.0/8RP 10.10.0.2 (?)Info source: StaticUptime: 00:01:42Group(s) 228.0.0.0/8RP 10.10.0.3 (?)Info source: From BSR 10.10.0.3 (?), Priority: 192Uptime:00:01:26, expires:00:00:34Group(s) 229.0.0.0/8RP 10.10.0.5 (mcast1.aaaa.com)Info source: From BSR 10.10.0.5 (mcast1.aaaa.com), Priority: 192Uptime:00:00:52, expires:00:00:37 |
Leave A Comment?