Table Of Contents
ip pim state-refresh origination-interval
ip multicast route-limit
To limit the number of multicast routes (mroutes) that can be added to a multicast routing table, use the ip multicast route-limit command in global configuration mode. To disable this configuration, use the no form of this command.
ip multicast [vrf vrf-name] route-limit limit [threshold]
no ip multicast [vrf vrf-name] route-limit limit [threshold]
Syntax Description
Defaults
limit: 2147483647
Command Modes
Global configuration
Command History
12.0(23)S
This command was introduced.
12.2
This command was integrated into Cisco IOS Release 12.2.
Usage Guidelines
The ip multicast route-limit command limits the number of multicast routes that can be added to a router and generates an error message when the limit is exceeded. If the user sets the threshold argument, a threshold error message is generated when the threshold is exceeded, and the message continues to occur until the number of mroutes reaches the limit set by the limit argument.
The mroute warning threshold must not exceed the mroute limit.
Examples
The following example sets the mroute limit at 200,000 and the threshold at 20,000 for a VRF instance named cisco:
ip multicast vrf cisco route-limit 200000 20000
12.0(23)S
This command was introduced.
12.2
This command was integrated into Cisco IOS Release 12.2.
ip multicast rpf backoff
To configure the intervals at which Protocol Independent Multicast (PIM) Reverse Path Forwarding (RPF) failover will be triggered by changes in the routing tables, use the ip multicast rpf backoff command in global configuration mode. To set the triggered RPF check to the default values, use the no form of this command.
ip multicast rpf backoff minimum maximum [disable]
no ip multicast rpf backoff minimum maximum [disable]
Syntax Description
Defaults
This command is enabled by default.
minimum: 500 ms.
maximum: 5000 ms.Command Modes
Global configuration
Command History
Usage Guidelines
In an unstable unicast routing environment that uses triggered RPF checks, the environment could be constantly triggering RPF checks, which places a burden on the resources of the router. To avoid this problem, use the ip multicast rpf backoff command to prevent a second triggered RPF check from occurring for the length of time configured. That is, the PIM "backs off" from another triggered RPF check for a minimum amount of milliseconds as configured by the user.
If the backoff period expires without further routing table changes, PIM then scans for routing changes and accordingly establishes multicast RPF changes. However, if more routing changes occur during the backoff period, PIM doubles the backoff period to avoid overloading the router with PIM RPF changes while the routing table is still converging.
Note
Cisco recommends that users keep the default values for this command. The default values allow subsecond RPF failover.
The maximum argument is used to configure the maximum backoff interval. The backoff time is reset to the time configured by the minimum argument if an entire backoff interval has expired without routing changes.
The maximum argument default allows the RPF change behavior to be backward-compatible, allowing a 5-second RPF check interval in case of frequent route changes and a 500-ms RPF check interval in stable networks with only unplanned routing changes. Before the introduction of the ip multicast rpf backoff command, PIM polled the routing tables for changes every 5 seconds.
You likely need not change the defaults of the ip multicast rpf backoff command unless you have frequent route changes in your router (for example, on a dial-in router). Changing the defaults can allow you to reduce the maximum RPF check interval for faster availability of IP multicast on newly established routes or to increase the maximum RPF check interval to reduce the CPU load caused by the RPF check.
Examples
The following example configures the minimum backoff interval at 100 ms and the maximum backoff interval at 2500 ms:
ip multicast rpf backoff 100 2500ip multicast rpf interval
To modify the intervals at which periodic Reverse Path Forwarding (RPF) checks occur, use the ip multicast rpf interval command in global configuration mode. To return to the default interval, use the no form of this command.
ip multicast rpf interval seconds [list access-list | route-map route-map]
no ip multicast rpf interval seconds [list access-list | route-map route-map]
Syntax Description
Defaults
This command is enabled by default.
seconds: 10Command Modes
Global configuration
Command History
Usage Guidelines
You can configure multiple instances of this command by using an access list or a route map.
Note
Examples
The following example sets the periodic RPF check interval to 10 seconds:
ip multicast rpf interval 10The following example sets a periodic RPF check interval of 3 seconds for groups that are defined by access list 10:
ip multicast rpf interval 3 list 10The following example sets a periodic RPF check interval of 2 seconds for groups that are defined by the route map named map:
ip multicast rpf interval 2 route-map mapRelated Commands
ip igmp query-interval
Configures the frequency at which the Cisco IOS software sends IGMP host hello messages.
ip multicast ttl-threshold
To configure the time-to-live (TTL) threshold of packets being forwarded out an interface, use the ip multicast ttl-threshold command in interface configuration mode. To return to the default TTL threshold, use the no form of this command.
ip multicast ttl-threshold ttl-value
no ip multicast ttl-threshold ttl-value
Syntax Description
ttl-value
Time-to-live value, in hops. It can be a value from 0 to 255. The default value is 0, which means that all multicast packets are forwarded out the interface.
Defaults
The default TTL value is 0, which means that all multicast packets are forwarded out the interface.
Command Modes
Interface configuration
Command History
Usage Guidelines
Only multicast packets with a TTL value greater than the threshold are forwarded out the interface.
You should configure the TTL threshold only on border routers. Conversely, routers on which you configure a TTL threshold value automatically become border routers.
This command replaces the ip multicast-threshold command.
Examples
The following example sets the TTL threshold on a border router to 200, which is a very high value. In this example multicast packets must have a TTL greater than 200 in order to be forwarded out this interface. Multicast applications generally set this value well below 200. Therefore, setting a value of 200 means that no packets will be forwarded out the interface.
interface tunnel 0ip multicast ttl-threshold 200ip multicast use-functional
To enable the mapping of IP multicast addresses to the Token Ring functional address 0xc000.0004.0000, use the ip multicast use-functional command in interface configuration mode. To disable the function, use the no form of this command.
ip multicast use-functional
no ip multicast use-functional
Syntax Description
This command has no arguments or keywords.
Defaults
IP multicast address are mapped to the MAC-layer address 0xFFFF.FFFF.FFFF.
Command Modes
Interface configuration
Command History
Usage Guidelines
This command is accepted only on a Token Ring interface.
Neighboring devices on the Token Ring on which this feature is used should also use the same functional address for IP multicast traffic.
Because there are a limited number of Token Ring functional addresses, other protocols may be assigned to the Token Ring functional address 0xc000.0004.0000. Therefore, not every frame sent to the functional address is necessarily an IP multicast frame.
Examples
The following example configures any IP multicast packets going out Token Ring interface 0 to be mapped to MAC address 0xc000.0004.0000:
interface token 0ip address 10.0.0.0 255.255.255.0ip pim dense-modeip multicast use-functionalip multicast-routing
To enable IP multicast routing, use the ip multicast-routing command in global configuration mode. To disable IP multicast routing, use the no form of this command.
ip multicast-routing [vrf vrf-name] [distributed]
no ip multicast-routing [vrf vrf-name]
Syntax Description
Defaults
IP multicast routing is disabled.
Command Modes
Global configuration
Command History
Usage Guidelines
When IP multicast routing is disabled, the Cisco IOS software does not forward any multicast packets.
Examples
The following example shows how to enable IP multicast routing:
Router(config)# ip multicast-routingRelated Commands
ip pgm host
Note
To enable Pragmatic General Multicast (PGM) Host, use the ip pgm host command in global configuration mode. To disable PGM Host and close all open PGM Host traffic sessions, use the no form of this command.
ip pgm host [source-interface {interface-type interface-number} | connection-parameter]
no ip pgm host
Syntax Description
source-interface interface-type interface-number
(Optional) Specifies the interface type and number on which to run PGM Host.
connection-parameter
(Optional) Configures advanced PGM Host connection parameters. The optional configuration parameters should be configured only by experts in PGM technology. See Table 1 for a comprehensive list of the optional connection parameters and their definitions.
Defaults
PGM Host is not enabled.
Command Modes
Global configuration
Command History
Usage Guidelines
Using the ip pgm host command without a keyword or an argument enables PGM Host on the router and configures the router to source PGM packets through a virtual host interface.
Specifying a physical or logical interface type (for example, an Ethernet, serial, or loopback interface) with the ip pgm host source-interface command configures the router to source PGM packets out of the physical or logical interface.
Note
Sourcing PGM packets through a virtual host interface enables the router to send and receive PGM packets through any router interface. The virtual host interface also serves as the interface to the multicast applications that reside at the PGM network layer.
Sourcing IP multicast traffic out a specific physical or logical interface configures the router to send PGM packets out that interface only and to receive packets on any router interface.
When both PGM Host and Router Assist are enabled on the router, the router can process received PGM packets as a virtual PGM Host, originate PGM packets and serve as its own first hop PGM network element, and forward received PGM packets. Refer to the "Configuring PGM Host and Router Assist" chapter of the Cisco IOS IP Configuration Guide for more information about PGM Router Assist.
Table 1 lists the available parameters for the connection-parameter argument. The parameters should be configured only by experts in PGM technology. Use the no ip pgm host connection-parameter command to return a parameter to its default value.
Examples
The following example enables PGM Host (both the source and receiver part of the PGM network layer) globally on the router and configures the router to source PGM packets through a virtual host interface:
ip pgm hostThe following example enables PGM Host globally on the router and configures the router to source PGM packets out of physical Ethernet interface 0/1:
ip pgm hostip pgm host source-interface ethernet 0/1Related Commands
ip pgm router
To enable Pragmatic General Multicast (PGM) Router Assist and thereby allow PGM to operate more efficiently on the router, use the ip pgm router command in interface configuration mode. To disable PGM Router Assist for the interface, use the no form of this command.
ip pgm router
no ip pgm router
Syntax Description
This command has no arguments or keywords.
Defaults
PGM Router Assist is disabled for the interface.
Command Modes
Interface configuration
Command History
Usage Guidelines
This command is highly recommended for optimal deployment of PGM Reliable Transport Protocol on a host.
Examples
In the following example, PGM Router Assist is configured on Ethernet interfaces 0 and 1:
ip multicast-routinginterface ethernet 0ip pim sparse-dense-modeip pgm routerinterface ethernet 1ip pim sparse-dense-modeip pgm routerRelated Commands
clear ip pgm router
Clears PGM traffic statistics.
ip pgm host
Enables PGM Host.
show ip pgm router
Displays PGM Reliable Transport Protocol state and statistics.
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.
ip pim {sparse-mode | sparse-dense-mode | dense-mode [proxy-register {list access-list | route-map map-name}]}
no ip pim {sparse-mode | sparse-dense-mode | dense-mode [proxy-register {list access-list | route-map map-name}]}
Syntax Description
Defaults
IP multicast routing is disabled on all interfaces.
Command Modes
Interface configuration
Command History
Usage Guidelines
Enabling PIM on an interface also enables Internet Group Management Protocol (IGMP) operation on that interface. An interface can be configured to be in dense mode, sparse mode, or sparse-dense mode. The mode describes how the Cisco IOS software populates its multicast routing table and how the software forwards multicast packets it receives from its directly connected LANs. Dense mode interfaces are always added to the table when the multicast routing table is populated. Sparse mode interfaces are added to the table only when periodic join messages are received from downstream routers, or there is a directly connected member on the interface.
Dense Mode
Initially, a dense mode interface forwards multicast packets until the router determines that there are group members or downstream routers, or until a prune message is received from a downstream router. Then, the dense mode interface periodically forwards multicast packets out the interface until the same conditions occur. Dense mode assumes that multicast group members are present. Dense mode routers never send a join message. They do send prune messages as soon as they determine they have no members or downstream PIM routers. A dense mode interface is subject to multicast flooding by default.
Dense Mode with Proxy Registering
For a router in a PIM sparse mode (PIM-SM) domain configured to operate in sparse mode or sparse-dense mode, the ip pim dense-mode proxy-register command must be configured on the interface leading toward the bordering dense mode region. This configuration will enable the router to register traffic from the dense mode region with the rendezvous point (RP) in the sparse mode domain.
Prior to Cisco IOS Release 12.0 S, an RP needed to be running on the border router leading toward a dense mode region so that the RP could learn about traffic from sources in the dense mode region.
This command requires an extended access list or route map argument specifying which traffic the router needs to register with the RP. This command applies only to sources reachable through a PIM router. Cisco IOS software will always register traffic from remote sources if it arrives on a dense mode interface and if the Reverse Path Forwarding (RPF) neighbor leading toward the source is a Distance Vector Multicast Routing Protocol (DVMRP) but not a PIM router. This functionality has existed since Cisco IOS Release 10.0 and cannot be modified (restricted) with an access list or route map.
Sparse Mode
A sparse mode interface is used for multicast forwarding only if a join message is received from a downstream router or if group members are directly connected to the interface. Sparse mode assumes that no other multicast group members are present. When sparse mode routers want to join the shared path, they periodically send join messages toward the RP. When sparse mode routers want to join the source path, they periodically send join messages toward the source; they also send periodic prune messages toward the RP to prune the shared path.
Sparse-Dense Mode
An alternative to choosing just dense mode or just sparse mode is to run PIM in a single region in sparse mode for some groups and dense mode for other groups.
In sparse-dense mode, if the group is in dense mode, the interface will be treated as dense mode. If the group is in sparse mode, the interface will be treated in sparse mode. The group is "sparse" if the router knows about an RP for that group.
When an interface is treated in dense mode, it is populated in the outgoing interface list of the multicast routing table when either of the following conditions is true:
•
•
When an interface is treated in sparse mode, it is populated in the outgoing interface list of the multicast routing table when either of the following conditions is true:
•
•
Examples
The following example shows how to enable PIM-SM on tunnel interface 0 and set the address of the RP router to 226.0.0.8:
ip pim rp-address 226.0.0.8interface tunnel 0ip pim sparse-modeThe following example shows how to enable PIM dense mode (PIM-DM) on Ethernet interface 1:
interface ethernet 1ip pim dense-modeThe following example shows how to enable PIM sparse-dense mode on Ethernet interface 1:
interface ethernet 1ip pim sparse-dense-modeThe following example shows how to register the multicast traffic for any source and any multicast group:
interface ethernet 0ip address 172.16.0.0 255.255.255.0description Ethernet interface towards the PIM sparse-mode domainip pim sparse-dense-mode!interface ethernet 1ip address 192.44.81.5 255.255.255.0description Ethernet interface towards the PIM dens-mode regionip pim dense-mode proxy-register list 100!access-list 100 permit ip any anyRelated Commands
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.
ip pim [vrf vrf-name] accept-register {list access-list | route-map map-name}
no ip pim [vrf vrf-name] accept-register {list access-list | route-map map-name}
Syntax Description
Defaults
The command is disabled.
Command Modes
Global configuration
Command History
12.0(7)T
This command was introduced.
12.0(23)S
The vrf keyword and vrf-name argument were added.
12.2(13)T
The vrf keyword and vrf-name argument were added.
Usage 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.
Examples
The following example shows how to restrict the RP from allowing sources in the Source Specific Multicast (SSM) range of addresses to register with the RP. These statements need to be configured only on the RP.
ip pim accept-register list no-ssm-rangeip access-list extended no-ssm-rangedeny ip any 232.0.0.0 0.255.255.255permit ip any anyip pim accept-rp
To configure a router to accept join or prune messages destined for a specified rendezvous point (RP) and for a specific list of groups, use the ip pim accept-rp command in global configuration mode. To remove that check, use the no form of this command.
ip pim [vrf vrf-name] accept-rp {rp-address | auto-rp} [access-list]
no ip pim [vrf vrf-name] accept-rp {rp-address | auto-rp} [access-list]
Syntax Description
Defaults
The command is disabled, so all join messages and prune messages are processed.
Command Modes
Global configuration
Command History
10.2
This command was introduced.
12.0(23)S
The vrf keyword and vrf-name argument were added.
12.2(13)T
The vrf keyword and vrf-name argument were added.
Usage Guidelines
This command causes the router to accept only (*, G) join messages destined for the specified RP address. Additionally, the group address must be in the range specified by the access list.
When the rp-address argument is one of the addresses of the system, the system will be the RP only for the specified group range specified by the access list. When the group address is not in the group range, the RP will not accept join or register messages and will respond immediately to register messages with register-stop messages.
Examples
The following example states that the router will accept join or prune messages destined for the RP at address 172.17.1.1 for the multicast group 224.2.2.2:
ip pim accept-rp 172.17.1.1 3access-list 3 permit 224.2.2.2Related Commands
ip pim autorp listener
To cause IP multicast traffic for the two Auto-RP groups 224.0.1.39 and 224.0.1.40 to be Protocol Independent Multicast (PIM) dense mode flooded across interfaces operating in PIM sparse mode, use the ip pim autorp listener command in global configuration mode. To disable this feature, use the no form of this command.
ip pim autorp listener
no ip pim autorp listener
Syntax Description
This command has no arguments or keywords.
Defaults
This command is disabled by default.
Command Modes
Global configuration
Command History
Usage Guidelines
Use the ip pim autorp listener command with interfaces configured for PIM sparse mode operation in order to establish a network configuration where Auto-RP operates in PIM dense mode and multicast traffic can operate in sparse mode, bidirectional mode, or Source Specific Multicast (SSM) mode.
Examples
The following example enables IP multicast routing and the Auto-RP listener feature on a router. It also configures the router as a candidate RP for the multicast groups 239.254.2.0 through 239.254.2.255.
ip multicast-routingip pim autorp listenerip pim send-rp-announce Loopback0 scope 16 group-list 1ip pim send-rp-discovery Loopback1 scope 16access-list 1 permit 239.254.2.0 0.0.0.255ip pim bidir-enable
.To enable bidirectional Protocol Independent Multicast (bidir-PIM), use the ip pim bidir-enable command in global configuration mode. To disable bidir-PIM, use the no form of this command.
ip pim [vrf vrf-name] bidir-enable
no ip pim [vrf vrf-name] bidir-enable
Syntax Description
vrf
(Optional) Supports the multicast Virtual Private Network (VPN) routing and forwarding (VRF) instance.
vrf-name
(Optional) Name assigned to the VRF.
Defaults
The command is enabled.
Command Modes
Global configuration
Command History
Usage Guidelines
Bidir-PIM is disabled by default to ensure complete backward compatibility when upgrading a router to Cisco IOS Release 12.0(18)ST or a later release.
When bidir-PIM is disabled, the router will behave similarly to a router without bidir-PIM support. The following conditions will apply:
•
•
•
–
–
•
Examples
The following example shows how to configure a rendezvous point (RP) for both sparse mode and bidirectional mode groups: 224/8 and 227/8 are bidirectional groups, 226/8 is sparse mode, and 225/8 is dense mode. The RP must be configured to use different IP addresses for the sparse mode and bidirectional mode operations. Two loopback interfaces are used to allow this configuration. The addresses of these loopback interfaces must be routed throughout the PIM domain such that the other routers in the PIM domain can receive Auto-RP announcements and communicate with the RP.
ip multicast-routing !Enable IP multicast routingip pim bidir-enable !Enable bidir-PIM!interface loopback 0description One Loopback adddress for this routers Bidir Mode RP functionip address 10.0.1.1 255.255.255.0ip pim sparse-dense-mode!interface loopback 1description One Loopback adddress for this routers Sparse Mode RP functionip address 10.0.2.1 255.255.255.0ip pim sparse-dense-modeip pim send-rp-announce Loopback0 scope 10 group-list 45 bidirip pim send-rp-announce Loopback1 scope 10 group-list 46ip pim send-rp-discovery scope 10access-list 45 permit 224.0.0.0 0.255.255.255access-list 45 permit 227.0.0.0 0.255.255.255access-list 45 deny 225.0.0.0 0.255.255.255access-list 46 permit 226.0.0.0 0.255.255.255Related Commands
ip pim border
The ip pim border command is replaced by the ip pim bsr-border command. See the description of the ip pim bsr-border command for more information.
ip pim bsr-border
To prevent bootstrap router (BSR) messages from being sent or received through an interface, use the ip pim bsr-border command in interface configuration mode. To disable this configuration, use the no form of this command.
ip pim bsr-border
no ip pim bsr-border
Syntax Description
This command has no arguments or keywords.
Defaults
The command is disabled.
Command Modes
Interface configuration
Command History
11.3 T
The ip pim border command was introduced.
12.0(8)
The ip pim border command was replaced by the ip pim bsr-border command.
Usage Guidelines
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
Examples
The following example configures the interface to be the PIM domain border:
interface ethernet 1ip pim bsr-borderRelated Commands
ip multicast boundary
Configures an administratively scoped boundary.
ip pim bsr-candidate
Configures the router to announce its candidacy as a BSR.
ip pim bsr-candidate
To configure the router to announce its candidacy as a bootstrap router (BSR), use the ip pim bsr-candidate command in global configuration mode. To remove this router as a candidate for being a bootstrap router, use the no form of this command.
ip pim [vrf vrf-name] bsr-candidate interface-type interface-number [hash-mask-length] [priority]
no ip pim [vrf vrf-name] bsr-candidate interface-type interface-number [hash-mask-length] [priority]
Syntax Description
Defaults
The command is disabled.
priority: 0
Note
Command Modes
Global configuration
Command History
11.3 T
This command was introduced.
12.0(23)S
The vrf keyword and vrf-name argument were added.
12.2(13)T
The vrf keyword and vrf-name argument were added.
Usage Guidelines
This command causes the router to send bootstrap messages to all its PIM neighbors, with the address of the designated interface as the BSR address. Each neighbor compares the BSR address with the address it had from previous bootstrap messages (not necessarily received on the same interface). If the current address is the same or higher address, it caches the current address and forwards the bootstrap message. Otherwise, it drops the bootstrap message.
This router continues to be the BSR until it receives a bootstrap message from another candidate BSR saying that it has a higher priority (or if the same priority, a higher IP address).
Use this command only in backbone routers that have good connectivity to all parts of the PIM domain. That is, a stub router that relies on an on-demand dialup link to connect to the rest of the PIM domain is not a good candidate BSR.
Examples
The following example shows how to configure the IP address of the router on Ethernet interface 0/0 to be a candidate BSR with priority of 192:
ip pim bsr-candidate ethernet 0/0 192Related Commands
ip pim dm-fallback
To enable Protocol Independent Multicast (PIM) dense mode fallback, use the ip pim dm-fallback command in global configuration mode. To prevent PIM dense mode fallback and to block all multicast traffic for groups not specifically configured, use the no form of this command.
ip pim dm-fallback
no ip pim dm-fallback
Syntax Description
This command has no arguments or keywords.
Defaults
PIM dense mode fallback is enabled. That is, a multicast group in the absence of rendezvous point (RP) information will fall to dense mode, regardless of the interface mode configuration.
Command Modes
Global configuration
Command History
Usage Guidelines
Use this command to prevent a router from falling back into PIM dense mode when the RP becomes unavailable. This command also causes the router to block all multicast traffic for groups not specifically configured with an RP.
When IP multicast is used in mission-critical networks, you should avoid the use of PIM-DM. PIM makes the determination as to whether a multicast group operates in PIM-DM or PIM sparse-dense mode based solely on the existence of RP information in the group-to-RP mapping cache. If Auto-RP is configured or a bootstrap router (BSR) is used to distribute RP information, there is a risk that RP information can be lost if all RPs, Auto-RP, or the BSR for a group fails due to network congestion. This failure can lead to the network either partially or fully falling back into PIM-DM.
If a network falls back into PIM-DM, dense mode flooding will occur. Routers that lose RP information will switch all existing states into dense mode and any new states that must be created for the failed group will be created in dense mode.
Examples
The following example disables PIM dense mode fallback:
ip multicast-routinginterface ethernet 0/0ip pim sparse-dense-modeip pim send-rp-announce ethernet 0 scope 16 group-list 1ip pim rp-address 10.8.0.20 1no ip pim dm-fallbackRelated Commands
ip pim dense-mode
Enables PIM dense mode on the interface.
ip pim sparse-dense-mode
Enables PIM to operate in sparse or dense mode, depending on the group.
ip pim dr-priority
To set the priority for which a router is elected as the designated router (DR), use the ip pim dr-priority command in interface configuration mode. To disable this function, use the no form of this command.
ip pim dr-priority priority-value
no ip pim dr-priority priority-value
Syntax Description
priority-value
Value in the range from 0 to 4294967294 used to determine the priority of the router to be selected as the DR.
Defaults
The command is disabled.
Command Modes
Interface configuration
Command History
Usage Guidelines
When a DR is a candidate for election, the following conditions apply:
•
•
Examples
The following example sets the DR priority value of the Ethernet0 interface to 200:
interface Ethernet0ip address 10.0.1.2 255.255.255.0ip pim dr-priority 200ip pim minimum-vc-rate
To configure the minimum traffic rate to keep virtual circuits (VCs) from being idled, use the ip pim minimum-vc-rate command in interface configuration mode. To restore the default value, use the no form of this command.
ip pim minimum-vc-rate pps
no ip pim minimum-vc-rate
Syntax Description
pps
Rate, in packets per second, below which a VC is eligible for idling. The default value is 0, which means all VCs are eligible for idling. The range is from 0 to 4294967295.
Defaults
The default rate is 0 pps, which indicates all VCs are eligible for idling.
Command Modes
Interface configuration
Command History
Usage Guidelines
This command applies to an ATM interface only and also requires IP Protocol Independent Multicast sparse mode (PIM-SM).
An idling policy uses the ip pim vc-count number command to limit the number of VCs created by PIM. When the router stays at or below this number, no idling policy is in effect. When the next VC to be opened will exceed the number, an idling policy is exercised. Any virtual circuits with a traffic rate lower than the ip pim minimum-vc-rate command are subject to the idling policy, which is described in the section "Limit the Number of VCs" in the "Configuring IP Multicast Routing" chapter of the Cisco IOS IP Configuration Guide.
Examples
The following example configures a minimum rate of 2500 pps over a VC, below which the VC is eligible for idling:
ip pim minimum-vc-rate 2500Related Commands
ip pim multipoint-signalling
To enable Protocol Independent Multicast (PIM) to open ATM multipoint switched virtual circuits (VCs) for each multicast group that a receiver joins, use the ip pim multipoint-signalling command in interface configuration mode. To disable the feature, use the no form of this command.
ip pim multipoint-signalling
no ip pim multipoint-signalling
Syntax Description
This command has no arguments or keywords.
Defaults
The command is disabled.
All multicast traffic goes to the static map multipoint VC as long as the atm multipoint-signalling command is configured.Command Modes
Interface configuration
Command History
Usage Guidelines
This command is accepted only on an ATM interface. It allows optimal multicast trees to be built down to ATM switch granularity. This command can enhance router performance and link utilization because packets are not replicated and sent multiple times over the ATM interface.
Examples
The following example enables PIM to open ATM multipoint switched VCs for each multicast group that is joined:
ip pim multipoint-signallingRelated Commands
ip pim nbma-mode
To configure a multiaccess WAN interface to be in nonbroadcast multiaccess (NBMA) mode, use the ip pim nbma-mode command in interface configuration mode. To disable this function, use the no form of this command.
ip pim nbma-mode
no ip pim nbma-mode
Syntax Description
This command has no arguments or keywords.
Defaults
The command is disabled.
Command Modes
Interface configuration
Command History
Usage Guidelines
Use this command on Frame Relay, Switched Multimegabit Data Service (SMDS), or ATM only, especially when these media do not have native multicast available. Do not use this command on multicast-capable LANs such as Ethernet or FDDI.
When this command is configured, each Protocol Independent Multicast (PIM) join message is tracked in the outgoing interface list of a multicast routing table entry. Therefore, only PIM WAN neighbors that have joined for the group will get packets sent as data-link unicasts. This command should only be used when the ip pim sparse-mode command is configured on the interface. This command is not recommended for LANs that have natural multicast capabilities.
Examples
The following example configures an interface to be in NBMA mode:
ip pim nbma-modeRelated Commands
ip pim neighbor-filter
To prevent a router from participating in Protocol Independent Multicast (PIM) (for example, to configure stub multicast routing), use the ip pim neighbor-filter command in interface configuration mode. To remove the restriction, use the no form of this command.
ip pim neighbor-filter access-list
no ip pim neighbor-filter access-list
Syntax Description
Defaults
The command is disabled.
Command Modes
Interface configuration
Command History
Examples
The following example enables stub multicast routing on Router A, which has an outgoing interface with IP address 10.0.0.1. Router B is a central router with an incoming interface with address 10.0.0.2. Access list 1 filters PIM messages from the source (stub Router A).
Router A Configuration
ip multicast-routingip pim dense-modeip igmp helper-address 10.0.0.2Router B Configuration
ip multicast-routingip pim dense-mode : or ip pim sparse-modeip pim neighbor-filter 1access-list 1 deny 10.0.0.1Related Commands
ip pim query-interval
To configure the frequency of Protocol Independent Multicast (PIM) router query messages, use the ip pim query-interval command in interface configuration mode. To return to the default interval, use the no form of this command.
ip pim query-interval period [msec]
no ip pim query-interval
Syntax Description
Defaults
This command is enabled by default.
The PIM hello messages are sent every 30 seconds.Command Modes
Interface configuration
Command History
Usage Guidelines
Routers configured for IP multicast send PIM hello messages to determine which router will be the designated router for each LAN segment (subnet). The designated router sends Internet Group Management Protocol (IGMP) host query messages to all hosts on the directly connected LAN. When operating in sparse mode, the designated router sends source registration messages to the rendezvous point (RP). The designated router is the router with the highest IP address.
Examples
The following example changes the PIM hello interval to 45 seconds:
interface tunnel 0ip pim query-interval 45The following example changes the PIM hello interval to 100 milliseconds:
interface Ethernet1/0ip address 172.16.1.3 255.255.255.0ip pim query-interval 100 msecRelated Commands
ip igmp query-interval
Configures the frequency at which the Cisco IOS software sends IGMP host query messages.
ip pim register-rate-limit
To set a limit on the maximum number of Protocol Independent Multicast sparse mode (PIM-SM) register messages sent per second for each (S, G) routing entry, use the ip pim register-rate-limit command in global configuration mode. To disable this limit, use the no form of this command.
ip pim [vrf vrf-name] register-rate-limit rate
no ip pim [vrf vrf-name] register-rate-limit rate
Syntax Description
Defaults
No limit is defined.
Command Modes
Global configuration
Command History
11.3 T
This command was introduced.
12.0(23)S
The vrf keyword and vrf-name argument were added.
12.2(13)T
The vrf keyword and vrf-name argument were added.
Usage Guidelines
Use this command to limit the number of register messages that the designated router (DR) will allow for each (S, G) entry. Enabling this command will limit the load on the DR and RP at the expense of dropping those register messages that exceed the set limit. Receivers may experience data packet loss within the first second in which register messages are sent from bursty sources.
If the ip pim dense-mode proxy-register command is configured, then the ip pim register-rate-limit command must be configured because of the potentially large number of sources from the dense mode area that may send data into the sparse mode region (and thus need registering in the border router).
This command applies only to sparse mode (S, G) multicast routing entries.
Examples
The following example shows how to configure the ip pim register-rate-limit command with a maximum rate of two register messages per second:
ip pim register-rate-limit 2Related Commands
ip pim register-source
To configure the IP source address of a register message to an interface address other than the outgoing interface address of the designated router (DR) leading toward the rendezvous point (RP), use the ip pim register-source command in global configuration mode. To disable this configuration, use the no form of this command.
ip pim [vrf vrf-name] register-source interface-type interface-number
no ip pim [vrf vrf-name] register-source interface-type interface-number
Syntax Description
Defaults
By default, the IP address of the outgoing interface of the DR leading toward the RP is used as the IP source address of a register message.
Command Modes
Global configuration
Command History
12.0(8)T
This command was introduced.
12.0(23)S
The vrf keyword and vrf-name argument were added.
12.2(13)T
The vrf keyword and vrf-name argument were added.
Usage Guidelines
This command is required only when the IP source address of a register message is not a uniquely routed address to which the RP can send packets. This situation may occur if the source address is filtered such that packets sent to it will not be forwarded or if the source address is not unique to the network. In these cases, the replies sent from the RP to the source address will fail to reach the DR, resulting in Protocol Independent Multicast sparse mode (PIM-SM) protocol failures.
If no IP source address is configured or if the configured source address is not in service, the IP address of the outgoing interface of the DR leading toward the RP is used as the IP source address of the register message. Therefore, we recommend using a loopback interface with an IP address that is uniquely routed throughout the PIM-SM domain.
Examples
The following example shows how to configure the IP source address of the register message to the loopback 3 interface of a DR:
ip pim register-source loopback 3ip pim rp-address
To configure the address of a Protocol Independent Multicast (PIM) rendezvous point (RP) for multicast groups, use the ip pim rp-address command in global configuration mode. To remove an RP address, use the no form of this command.
ip pim [vrf vrf-name] rp-address rp-address [access-list] [override] [bidir]
no ip pim [vrf vrf-name] rp-address rp-address [access-list] [override] [bidir]
Syntax Description
Command Default
No PIM RPs are configured.
Command Modes
Global configuration
Command History
Usage Guidelines
In the Cisco IOS implementation of PIM, each multicast group individually operates in one of the following modes: dense mode, sparse mode, or bidirectional mode. Groups in sparse mode or bidirectional 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.
The Cisco IOS software learns the mode and RP addresses of multicast groups through the following three mechanisms: static configuration, Auto-RP, and bootstrap router (BSR). Use the ip pim rp-address command to statically define the mode of operations and RP address for multicast groups that are to operate in sparse mode or bidirectional mode. By default, groups will operate in dense mode. No commands explicitly define groups to operate in dense mode.
You can configure the Cisco IOS software 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:
•
•
•
•
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 Auto-RP or BSR. The following rules apply to a multicast group:
•
•
•
Examples
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
Note
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:
access list 1 225.2.2.2 0.0.0.0ip pim rp-address 172.16.0.0Related Commands
ip pim rp-announce-filter
To filter incoming Auto-RP announcement messages coming from the rendezvous point (RP), use the ip pim rp-announce-filter command in global configuration mode. To remove the filter, use the no form of this command.
ip pim [vrf vrf-name] rp-announce-filter rp-list access-list group-list access-list
no ip pim [vrf vrf-name] rp-announce-filter rp-list access-list group-list access-list
Syntax Description
Defaults
All RP announcements are accepted.
Command Modes
Global configuration
Command History
11.1
This command was introduced.
12.0(23)S
The vrf keyword and vrf-name argument were added.
12.2(13)T
The vrf keyword and vrf-name argument were added.
Usage Guidelines
Configure this command on the Protocol Independent Multicast (PIM) RP mapping agent. We recommend that if you use more than one RP mapping agent, make the filters among them consistent so that there are no conflicts in mapping state when the announcing agent goes down.
Examples
The following example configures the router to accept RP announcements from RPs in access list 1 for group ranges described in access list 2:
ip pim rp-announce-filter rp-list 1 group-list 2access-list 1 permit 10.0.0.1access-list 1 permit 10.0.0.2access-list 2 permit 224.0.0.0 192.168.255.255Related Commands
ip pim rp-candidate
To configure the router to advertise itself to the bootstrap router (BSR) as a Protocol Independent Multicast (PIM) Version 2 candidate rendezvous point (RP), use the ip pim rp-candidate command in global configuration mode. To remove this router as an RP candidate, use the no form of this command.
ip pim [vrf vrf-name] rp-candidate interface-type interface-number [bidir] [group-list access-list] [interval seconds] [priority value]
no ip pim [vrf vrf-name] rp-candidate
Syntax Description
Defaults
The command is disabled.
seconds: 60
priority: 0
Note
Command Modes
Global configuration
Command History
Usage Guidelines
This command causes the router to send a PIM Version 2 message advertising itself as a candidate RP to the BSR. The addresses allowed by the access list, together with the router identified by the type and number, constitute the RP and its range of addresses for which it is responsible.
Use this command only in backbone routers that have good connectivity to all parts of the PIM domain. That is, a stub router that relies on an on-demand dialup link to connect to the rest of the PIM domain is not a good candidate RP.
Use this command with the bidir keyword when you want bidirectional forwarding and you are using the PIM Version 2 BSR mechanism to distribute group-to-RP mappings. Other options are as follows:
•
•
When the interval keyword is specified, the candidate RP advertisement interval is set to a value specified by the seconds argument. The default interval is 60 seconds. Reducing this interval to a time of less than 60 seconds can reduce the time required to fail over to a secondary RP at the expense of generating more PIM Version 2 messages.
Examples
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 number 4 specifies the group prefix associated with the RP that has the address identified by Ethernet interface 2. That RP is responsible for the groups with the prefix 239.
ip pim rp-candidate ethernet 2 group-list 4access-list 4 permit 239.0.0.0 0.255.255.255Related Commands
ip pim send-rp-announce
To use Auto-RP to configure groups for which the router will act as a rendezvous point (RP), use the ip pim send-rp-announce command in global configuration mode. To unconfigure this router as an RP, use the no form of this command.
ip pim [vrf vrf-name] send-rp-announce interface-type interface-number scope ttl-value [group-list access-list] [interval seconds] [bidir]
no ip pim [vrf vrf-name] send-rp-announce interface-type interface-number scope ttl-value [group-list access-list] [interval seconds] [bidir]
Syntax Description
Defaults
Auto-RP is disabled.
seconds: 60Command Modes
Global configuration
Command History
Usage Guidelines
Use this command in the router you want to be an RP. When you are using Auto-RP to distribute group-to-RP mappings, this command causes the router to send an Auto-RP announcement message to the well-known group CISCO-RP-ANNOUNCE (224.0.1.39). This message announces the router as a candidate RP for the groups in the range described by the access list.
Use this command with the bidir keyword when you want bidirectional forwarding and you are using Auto-RP to distribute group-to-RP mappings. Other options are as follows:
•
•
Examples
The following example sends RP announcements out all Protocol Independent Multicast (PIM)-enabled interfaces for a maximum of 31 hops. The IP address by which the router wants to be identified as RP is the IP address associated with Ethernet interface 0. Access list 5 describes the groups for which this router serves as RP.
ip pim send-rp-announce ethernet0 scope 31 group-list 5access-list 5 permit 224.0.0.0 15.255.255.255Related Commands
ip pim send-rp-discovery
To configure the router to be a rendezvous point (RP) mapping agent, use the ip pim send-rp-discovery command in global configuration mode. To restore the default value, use the no form of this command.
ip pim [vrf vrf-name] send-rp-discovery [interface-type interface-number] scope ttl-value
no ip pim [vrf vrf-name] send-rp-discovery [interface-type interface-number] scope ttl-value
Syntax Description
Defaults
The router is not an RP mapping agent.
Command Modes
Global configuration
Command History
11.1
This command was introduced.
12.0(23)S
The vrf keyword and vrf-name argument were added.
12.2(13)T
The vrf keyword and vrf-name argument were added.
Usage Guidelines
Configure this command on the router designated as an RP mapping agent. Specify a TTL large enough to cover your Protocol Independent Multicast (PIM) domain.
When Auto-RP is used, the following events occur:
1.
2.
3.
Examples
The following example limits Auto-RP RP discovery messages to 20 hops:
ip pim send-rp-discovery scope 20ip pim spt-threshold
To configure when a Protocol Independent Multicast (PIM) leaf router should join the shortest path source tree for the specified group, use the ip pim spt-threshold command in global configuration mode. To restore the default value, use the no form of this command.
ip pim [vrf vrf-name] spt-threshold {kbps | infinity} [group-list access-list]
no ip pim [vrf vrf-name] spt-threshold {kbps | infinity} [group-list access-list]
Syntax Description
Defaults
When this command is not used, the PIM leaf router joins the shortest path tree immediately after the first packet arrives from a new source.
Command Modes
Global configuration
Command History
11.1
This command was introduced.
12.0(23)S
The vrf keyword and vrf-name argument were added.
12.2(13)T
The vrf keyword and vrf-name argument were added.
Usage Guidelines
If a source sends at a rate greater than or equal to traffic rate (the kbps value), a PIM join message is triggered toward the source to construct a source tree.
If the infinity keyword is specified, all sources for the specified group will use the shared tree. Specifying a group list access list indicates the groups to which the threshold applies.
If the traffic rate from the source drops below the threshold traffic rate, the leaf router will switch back to the shared tree and send a prune message toward the source.
Examples
The following example sets a threshold of 4 kbps, above which traffic to a group from a source will cause the router to switch to the shortest path tree to that source:
ip pim spt-threshold 4ip 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.
ip pim [vrf vrf-name] ssm {default | range access-list}
no ip pim [vrf vrf-name] ssm {default | range access-list}
Syntax Description
Defaults
The command is disabled.
Command Modes
Global configuration
Command History
12.1(3)T
This command was introduced.
12.0(23)S
The vrf keyword and vrf-name argument were added.
12.2(13)T
The vrf keyword and vrf-name argument were added.
Usage Guidelines
When an SSM range of IP multicast addresses is defined by the ip pim ssm command, no Multicast Source Discovery Protocol (MSDP) Source-Active (SA) messages will be accepted or originated in the SSM range.
Examples
The following example shows how to configure SSM service for the IP address range defined by access list 4:
access-list 4 permit 224.2.151.141ip pim ssm range 4Related Commands
ip pim state-refresh disable
To disable the processing and forwarding of PIM dense mode state refresh control messages on a Protocol Independent Multicast (PIM) router, use the ip pim state-refresh disable command in global configuration mode. To reenable the processing and forwarding of PIM dense mode state refresh control messages, use the no form of this command.
ip pim [vrf vrf-name] state-refresh disable
no ip pim [vrf vrf-name] state-refresh disable
Syntax Description
vrf
(Optional) Supports the multicast Virtual Private Network (VPN) routing and forwarding (VRF) instance.
vrf-name
(Optional) Name assigned to the VRF.
Defaults
The processing and forwarding of PIM dense mode state refresh control messages is enabled on PIM routers that are running a Cisco IOS software release that supports the PIM dense mode state refresh feature.
Command Modes
Global configuration
Command History
12.1(5)T
This command was introduced.
12.0(23)S
The vrf keyword and vrf-name argument were added.
12.2(13)T
The vrf keyword and vrf-name argument were added.
Usage Guidelines
Configuring this command removes PIM dense mode state refresh information from PIM hello messages.
Examples
The following example disables the periodic forwarding of the PIM dense mode state refresh control message down a source-based IP multicast distribution tree:
ip pim state-refresh disableRelated Commands
ip pim state-refresh origination-interval
To configure the origination of and the interval for PIM dense mode state refresh control messages on a Protocol Independent Multicast (PIM) router, use the ip pim state-refresh origination-interval command in interface configuration mode. To stop the origination of the PIM dense mode state refresh control message, use the no form of this command.
ip pim state-refresh origination-interval [interval]
no ip pim state-refresh origination-interval [interval]
Syntax Description
interval
(Optional) The number of seconds between PIM dense mode state refresh control messages. The default is 60 seconds. The available interval range is from 4 to 100 seconds.
Defaults
PIM dense mode state refresh control message origination is disabled. By default, all PIM routers that are running a Cisco IOS software release that supports PIM dense mode state refresh process and forward PIM dense mode state refresh control messages.
Command Modes
Interface configuration
Command History
Usage Guidelines
Configure this command on the interfaces of the first hop, PIM dense mode routers that are directly connected to sources for PIM-DM multicast groups.
By default, the processing and forwarding of PIM dense mode state refresh control messages is enabled on PIM routers that are running a Cisco IOS software release that supports PIM dense mode state refresh.
Examples
The following example configures the origination of the state refresh control message on Ethernet interface 0 of a PIM dense mode router with an interval of 80 seconds:
interface ethernet 0ip pim state-refresh origination-interval 80Related Commands
ip pim vc-count
To change the maximum number of virtual circuits (VCs) that Protocol Independent Multicast (PIM) can open, use the ip pim vc-count command in interface configuration mode. To restore the default value, use the no form of this command.
ip pim vc-count number
no ip pim vc-count
Syntax Description
number
Maximum number of VCs that PIM can open. The default is 200 VCs. The range is from 1 to 65535.
Defaults
200 VCs per ATM interface or subinterface
Command Modes
Interface configuration
Command History
Examples
The following example allows PIM to open a maximum of 250 VCs:
ip pim vc-count 250Related Commands
ip pim version
To configure the Protocol Independent Multicast (PIM) version of the interface, use the ip pim version command in interface configuration mode. To restore the default value, use the no form of this command.
ip pim version [1 | 2]
no ip pim version
Syntax Description
Defaults
Version 2
Command Modes
Interface configuration
Command History
Usage Guidelines
An interface in Version 2 mode automatically downgrades to Version 1 mode if that interface has a PIM Version 1 neighbor. The interface returns to Version 2 mode after all Version 1 neighbors disappear (that is, they are shut down or upgraded).
Examples
The following example configures the interface to operate in PIM Version 1 mode:
interface ethernet 0 ip address 10.0.0.0 255.0.0.0 ip pim sparse-dense-mode ip pim version 1ip rgmp
To enable the Router-Port Group Management Protocol (RGMP) on Ethernet, Fast Ethernet, and Gigabit Ethernet interfaces, use the ip rgmp command in interface configuration mode. To disable RGMP on the interfaces, use the no form of this command.
ip rgmp
no ip rgmp
Syntax Description
This command has no arguments or keywords.
Defaults
RGMP is not enabled.
Command Modes
Interface configuration
Command History
12.0(10)S
This command was introduced.
12.1(1)E
This command was integrated into Cisco IOS Release 12.1(1)E.
12.1(5)T
This command was integrated into Cisco IOS Release 12.1(5)T.
Usage Guidelines
RGMP is supported only on Ethernet, Fast Ethernet, and Gigabit Ethernet interfaces.
Before you enable RGMP, the following features must be enabled on your router:
•
•
•
If your router is in a bidirectional group, make sure to enable RGMP only on interfaces that do not function as a designated forwarder (DF). If you enable RGMP on an interface that functions as a DF, the interface will not forward multicast packets up the bidirectional shared tree to the rendezvous point (RP).
The following features must be enabled on your switch:
•
•
Examples
The following example enables RGMP on Ethernet interface 1/0:
interface ethernet 1/0ip rgmpRelated Commands
debug ip rgmp
Logs debug messages sent by an RGMP-enabled router.
show ip igmp interface
Displays multicast-related information about an interface.
ip sap cache-timeout
To limit how long a Session Announcement Protocol (SAP) cache entry stays active in the cache, use the ip sap cache-timeout command in global configuration mode. To restore the default value, use the no form of this command.
ip sap cache-timeout minutes
no ip sap cache-timeout
Syntax Description
Defaults
By default, session announcements remain for 1440 minutes (24 hours) in the cache.
Command Modes
Global configuration
Command History
11.2
The ip sdr cache-timeout command was introduced.
12.2
The ip sdr cache-timeout command was replaced by the ip sap cache-timeout command.
Usage Guidelines
This command defines how long session announcements are cached by the router. Active session announcements are periodically re-sent by the originating site, refreshing the cached state in the router. The minimum interval between announcements for a single group is 5 minutes. Setting the cache timeout to a value less than 30 minutes is not recommended. Set the cache timeout to 0 to keep entries in the cache indefinitely.
Examples
The following example causes SAP cache entries to remain in the cache for 30 minutes:
ip sap cache-timeout 30Related Commands
clear ip sap
Deletes a SAP cache entry or the entire SAP cache.
show ip sap
Displays the SAP cache.
ip sap listen
To enable the Cisco IOS software to listen to session directory announcements, use the ip sap listen command in interface configuration mode. To disable the function, use the no form of this command.
ip sap listen
no ip sap listen
Syntax Description
This command has no arguments or keywords.
Defaults
The command is disabled.
Command Modes
Interface configuration
Command History
11.1
The ip sdr listen command was introduced.
12.2
The ip sdr listen command was replaced by the ip sap listen command.
Usage Guidelines
Cisco IOS software can receive and store Session Description Protocol (SDP) and Session Announcement Protocol (SAP) session announcements.
SAP is a protocol used to announce multicast multimedia conferences and other multicast sessions, and it is used to communicate session setup information to prospective participants. A SAP announcer periodically sends an announcement packet to a well-known multicast address and port. The announcement is sent via multicast with the same scope as the session it is announcing to ensure that the recipients of the announcement can also be recipients of the session the announcement describes. SAP should be used for sessions of public interest where participants are not known in advance.
When the ip sap listen command is configured on an interface, the well-known session directory groups on that interface can receive and store session announcements. Each announcer listens to other announcements in order to determine the total number of sessions being announced on a particular group, and the interfaces are put into the outgoing interface list for the IP SAP group. The announcements can be displayed with the show ip sap command. The ip multicast rate-limit command uses stored session announcements. To configure the period of time after which received announcements will expire, use the ip sap cache-timeout command.
When the no ip multicast routing command is configured, announcements are only stored if they are received on an interface configured with the ip sap listen command. When a system is configured as a multicast router, it is sufficient to configure the ip sap listen command on only a single multicast-enabled interface. The well-known session directory groups are handled as local joined groups after the ip sap listen command is first configured. (See the L flag of the show ip mroute command.) This configuration causes announcements received from all multicast-enabled interfaces to be routed and stored within the system.
Examples
The following example shows how to enable a router to listen to session directory announcements:
ip routinginterface loopback 0ip address 10.0.0.51 255.255.255.0ip pim sparse-dense modeip sap listenRelated Commands
ip sdr cache-timeout
The ip sdr cache-timeout command is replaced by the ip sap cache-timeout command. See the description of the ip sap cache-timeout command for more information.
ip sdr listen
The ip sdr listen command is replaced by the ip sap listen command. See the description of the ip sap listen command for more information.
ip urd
To enable interception of TCP packets sent to the reserved URL Rendezvous Directory (URD) port 465 on an interface and processing of URD channel subscription reports, use the ip urd command in interface configuration mode. To disable URD on an interface, use the no form of this command.
ip urd [proxy]
no ip urd [proxy]
Syntax Description
Defaults
The command is disabled.
Command Modes
Interface configuration
Command History
Usage Guidelines
To use this command, you must first define a Source Specific Multicast (SSM) range of IP addresses using the ip pim ssm global configuration command. When URD is enabled, it is supported in the SSM range of addresses only. We recommend that you not enable URD on backbone interfaces, but only on interfaces connecting to hosts.
URD functionality is available for multicast process switching, fast switching, and distributed fast-switching paths.
Examples
The following example shows how to configure URD on Ethernet interface 3/3:
interface ethernet 3/3ip urdRelated Commands
