Table Of Contents
mls ip multicast (global configuration)
mls ip multicast (interface configuration)
mls ip multicast bidir gm-scan-interval
mls ip multicast consistency-check
mls ip multicast flow-stat-timer
mls ip multicast non-rpf aging
mls ip multicast replication-mode
router-guard ip multicast switchports
ip 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
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:
•
IP routing
•
•
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
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
Usage Guidelines
Cisco IOS software can receive and store Session Description Protocol (SDP) and Session Announcement Protocol (SAP) session announcements. 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. 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
manager
To specify the interface that is to act as the Manager for Multicast Routing Monitor (MRM), and to specify the multicast group address the Test Receiver will listen to, use the manager command in MRM manager configuration mode. To remove the Manager or group address, use the no form of this command.
manager interface-type interface-number group ip-address
no manager interface-type interface-number group ip-address
Syntax Description
Command Default
There is no MRM Manager configured.
Command Modes
MRM manager configuration (config-mrm-manager)
Command History
Usage Guidelines
This command identifies the interface that acts as the Manager, and therefore is required in order to run MRM.
Examples
The following example shows how to configure Ethernet interface 0 as the Manager and the Test Receiver to listen to multicast group 239.1.1.1:
ip mrm manager test1manager ethernet 0 group 239.1.1.1Related Commands
mdt data
To configure the multicast group address range for data multicast distribution tree (MDT) groups, use the mdt data command in VRF configuration mode. To disable this function, use the no form of this command.
mdt data group-address-range wildcard-bits [threshold threshold-value] [list access-list]
no mdt data group-address-range wildcard-bits [threshold threshold-value] [list access-list]
Syntax Description
Defaults
The command is disabled.
Command Modes
VRF configuration
Command History
Usage Guidelines
A data MDT group can include a maximum of 256 multicast groups per Virtual Private Network (VPN). Multicast groups used to create the data MDT group are dynamically chosen from a pool of configured IP addresses.
This command configures a range of alternative multicast destination addresses for the tunnel header. The destination address chosen depends on the traffic profile (that is, the source and destination match the specified access list and the rate of the traffic has exceeded the bandwidth threshhold value).
Examples
In the following example, Protocol Independent Multicast (PIM) Source Specific Multicast (SSM) is configured in the backbone. Therefore, the default and data MDT groups are configured within the SSM range of IP addresses. Inside the VPN, PIM sparse mode (PIM-SM) is configured and only Auto-RP announcements are accepted.
!ip vrf vrf1rd 1:1route-target export 1:1route-target import 1:1mdt default 232.0.0.1mdt data 232.0.1.0 0.0.0.255 threshold 500 list 101!...!ip pim ssm defaultip pim vrf vrf1 accept-rp auto-rp!Related Commands
mdt default
To configure a default multicast distribution tree (MDT) group for a Virtual Private Network (VPN) routing and forwarding (VRF) instance, use the mdt default command in VRF configuration mode. To disable this function, use the no form of this command.
mdt default group-address
no mdt default group-address
Syntax Description
Defaults
The command is disabled.
Command Modes
VRF configuration
Command History
Usage Guidelines
The default MDT group must be the same group configured on all PE routers that belong to the same VPN.
If Source Specific Multicast (SSM) is used as the protocol for the default MDT, the source IP address will be the address used to source the Border Gateway Protocol (BGP) sessions.
A tunnel interface is created as a result of this command. By default, the destination address of the tunnel header is the group-address argument.
Examples
In the following example, Protocol Independent Multicast (PIM) SSM is configured in the backbone. Therefore, the default and data MDT groups are configured within the SSM range of IP addresses. Inside the VPN, PIM sparse mode (PIM-SM) is configured and only Auto-RP announcements are accepted.
!ip vrf vrf1rd 1:1route-target export 1:1route-target import 1:1mdt default 232.0.0.1mdt data 232.0.1.0 0.0.0.255 threshold 500 list 101!...!ip pim ssm defaultip pim vrf vrf1 accept-rp auto-rp!Related Commands
mdt log-reuse
To enable the recording of data multicast distribution tree (MDT) reuse, use the mdt log-reuse command in VRF configuration mode. To disable this function, use the no form of this command.
mdt log-reuse
no mdt log-reuse
Syntax Description
This command has no arguments or keywords.
Defaults
The command is disabled.
Command Modes
VRF configuration
Command History
Usage Guidelines
The mdt log-reuse command generates a syslog message whenever a data MDT is reused.
Examples
The following example shows how to enable MDT log reuse:
mdt log-reuseRelated Commands
mdt data
Configures the multicast group address range for data MDT groups.
mdt default
Configures a default MDT group for a VPN VRF.
mls ip multicast (global configuration)
To enable MLS IP and configure the hardware switching globally, use the mls ip multicast command in global configuration mode. To disable MLS IP, use the no form of this command.
mls ip multicast [capability]
mls ip multicast [vrf name] [connected | egress local | mfd | refresh-state | shared-tree-mfd | syslog | threshold ppsec]
no mls ip multicast [vrf]
Syntax Description
Defaults
The defaults are as follows:
•
•
•
•
•
•
•
•
Command Modes
Global configuration
Command History
Usage Guidelines
Note
Egress multicast replication is not supported on systems that are configured with a Supervisor Engine 32.
When entering the mls ip multicast egress local command, ensure that IPv6 multicast is not enabled. Since the egress multicast replication performance enhancement feature cannot separately turn on or turn off IPv4 and IPv6, you cannot have IPv4 and IPv6 multicast enabled when this feature is turned on.
These optional keywords are supported only on systems that are configured with a Supervisor Engine 720 with a PFC3:
•
•
•
•
•
The threshold ppsec optional keyword and argument do not impact flows that are already populated in the hardware cache.
The expiration time refresh is updated when flow statistics are received (indicating that the traffic is received from the RPF interface).
Examples
This example shows how to enable the MLS IP shortcuts:
Router(config)# mls ip multicastThis example shows how to enable the hardware switching on a specific multicast route:
Router(config)# mls ip multicast vrf test1This example shows how to export the information about egress capability from the switch processor to the route processor:
Router(config)# mls ip multicast capabilityThis example shows how to populate the multicast expansion table with local Layer 3-routed interfaces:
Router(config)# mls ip multicast egress localRelated Commands
mls rp ip (global configuration mode)
Enables external systems to establish IP shortcuts to the MSFC.
show mls ip multicast
Displays the MLS IP information.
mls ip multicast (interface configuration)
To enable MLS IP shortcuts on the interface, use the mls ip multicast command in interface configuration mode. To disable MLS IP shortcuts on the interface, use the no form of this command.
mls ip multicast
no mls ip multicast
Syntax Description
This command has no arguments or keywords.
Defaults
Multicast is disabled.
Command Modes
Interface configuration
Command History
Examples
This example shows how to enable the MLS IP shortcuts:
Router(config-if)# mls ip multicastRelated Commands
mls ip multicast bidir gm-scan-interval
To set the RPF scan interval for the Bidir rendevous point, use the mls ip multicast bidir gm-scan-interval command in global configuration mode. To disable the RPF scan interval for the Bidir rendevous point, use the no form of this command.
mls ip multicast bidir gm-scan-interval interval
no mls ip multicast bidir gm-scan-interval
Syntax Description
Defaults
10 seconds
Command Modes
Global configuration
Command History
12.2(14)SX
Support for this command was introduced on the Supervisor Engine 720.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2.
When you set the RPF scan interval for the Bidir rendevous point, you set the time that the periodic scan timer updates the RPF in the DF table for all Bidir rendevous points in the hardware.
Examples
This example shows how to set the RPF scan interval for the Bidir rendevous point:
Router(config)# mls ip multicast bidir gm-scan-interval 30Related Commands
mls ip multicast connected
To enable the downloading of directly connected subnets globally, use the mls ip multicast connected command in global configuration mode. To disable the downloading of directly connected subnets globally, use the no form of this command.
mls ip multicast connected
no mls ip multicast connected
Syntax Description
This command has no arguments or keywords.
Defaults
Disabled
Command Modes
Global configuration
Command History
Usage Guidelines
Do not create directly connected subnets for the following cases:
•
•
•
In these cases, if you enable the downloading of directly connected subnets, the directly connected source hits the MMLS (*,G) entry and is switched using the MMLS (*,G) entry. The registers are not sent to the route processor (in the case of PIM-SM), and the (S,G) state is not created on the first hop (in the case of PIM-DM).
The subnet entry is installed in the TCAM entries with a shorter mask to catch directly connected sources before they hit such entries. You can punt traffic from directly connected sources to the MSFC. Once the MSFC sees this traffic, it can install an MMLS (S,G) entry for this source, which gets installed before the subnet entry in the TCAM. New packets from this source are now switched with the (S,G) entry.
Examples
This example shows how to enable the downloading of directly connected subnets:
Router(config)# mls ip multicast connectedRelated Commands
mls ip multicast (global configuration)
Enables MLS IP and configures the hardware switching globally.
show mls ip multicast
Displays the MLS IP information.
mls ip multicast consistency-check
To enable and configure the hardware-shortcut consistency checker, use the mls ip multicast consistency-check command in global configuration mode. To disable the consistency checkers, use the no form of this command.
mls ip multicast consistency-check [auto-repair | error-message | settle-time seconds | type [rp-sp [table | vrf] | scan-mroute [count count-number] | settle-time seconds | period seconds]
no mls ip multicast consistency-check
Syntax Description
Defaults
The defaults are as follows:
•
•
•
•
Command Modes
Global configuration
Command History
Usage Guidelines
The consistency checker scans the mroute table and assures that the multicast-hardware entries are consistent with the mroute table. Whenever an inconsistency is detected, the inconsistency is automatically corrected.
To display the inconsistency error, use the show mls ip multicast consistency-check command.
Examples
This example shows how to enable the hardware-shortcut consistency checker:
Router(config)# mls ip multicast consistency-checkThis example shows how to enable the hardware-shortcut consistency checker and configure the scan check of the mroute table:
Router(config)# mls ip multicast consistency-check type scan-mroute count 20 period 35This example shows how to enable the hardware-shortcut consistency checker and specify the period between scans:
Router(config)# mls ip multicast consistency-check type scan-mroute period 35Related Commands
mls ip multicast flow-stat-timer
To set the time interval between two consecutive batches of flow-statistics messages from the switch processor to the route processor, use the mls ip multicast flow-stat-timer command in global configuration mode. To return to the default settings, use the no form of this command.
mls ip multicast flow-stat-timer num
no mls ip multicast flow-stat-timer
Syntax Description
num
Time interval between two consecutive batches of flow-statistics messages from the switch processor to the route processor.
Defaults
25 seconds
Command Modes
Global configuration
Command History
12.2(14)SX
Support for this command was introduced on the Supervisor Engine 720.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2.
Examples
This example shows how to configure the time interval between two consecutive batches of flow-statistics messages from the switch processor to the route processor:
Router(config)# mls ip multicast flow-stat-timer 10Related Commands
mls ip multicast non-rpf aging
To enable rate-limiting of non-RPF traffic, use the mls ip multicast non-rpf aging command in global configuration mode. To return to the default settings, use the no form of this command.
mls ip multicast non-rpf aging {global | fast} time
no mls ip multicast non-rpf aging {global | fast}
Syntax Description
Defaults
The fast aging time default is 2 seconds and the global aging time default is 20 seconds.
Command Modes
Global configuration
Command History
12.2(18)SXE
Support for this command was introduced for the Supervisor Engine 720.
Usage Guidelines
You should not configure ACL-based filtering of RPF failures.
Examples
This example shows how to enable rate-limiting of non-RPF traffic:
Router(config)# mls ip multicast non-rpf aging global 90This example shows how to display the multicast configuration of the router:
Router# show running | incl mls ip multicastmls ip multicast non-rpf aging global 90mls ip multicast non-rpf aging fast 4Router#Related Commands
mls ip multicast replication-mode
To enable and specify the replication mode, use the mls ip multicast replication-mode command in global configuration mode. To restore the system to automatic detection mode, use the no form of this command.
mls ip multicast replication-mode {egress | ingress}
no mls ip multicast replication-mode {egress | ingress}
Syntax Description
egress
Forces the system to the egress mode of replication.
ingress
Forces the system to the ingress mode of replication.
Defaults
The Supervisor Engine 720 automatically detects the replication mode based on the module types that are installed in the system. If all modules are capable of egress replication, the system uses egress-replication mode. If the supervisor engine detects the modules that are not capable of egress replication, the replication mode automatically switches to ingress replication.
If the system is functioning in the automatic-detection egress mode, and you install a module that cannot perform egress replication, the following occurs:
•
•
•
Command Modes
Global configuration
Command History
Usage Guidelines
This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 32.
This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2.
Note
If you enter the no mls ip multicast replication-mode egress command, only the forced-egress mode resets and not the forced-ingress mode.
If you enter the no mls ip multicast replication-mode ingress command, only the forced-ingress mode resets and not the forced-egress mode.
Examples
This example shows how to enable the ingress-replication mode:
Router(config)# mls ip multicast replication-mode ingressThis example shows how to enable the egress-replication mode:
Router(config)# mls ip multicast replication-mode egressThis example shows how to disable the current egress-replication mode and return to automatic detection mode:
Router(config)# no mls ip multicast replication-mode egressRelated Commands
mls ip multicast sso
To configure the stateful switchover (SSO) parameters, use the mls ip multicast sso command in global configuration mode. To return to the default settings, use the no form of this command.
mls ip multicast sso {convergence-time time | leak {interval seconds | percent percentage}}
no mls ip multicast sso {convergence-time time | leak {interval seconds | percent percentage}}
Syntax Description
Command Default
The defaults are as follows:
•
•
•
Command Modes
Global configuration
Command History
12.2(18)SXD
Support for this command was introduced on the Supervisor Engine 720.
12.2(33)SRA
This command was integrated into Cisco IOS Release 12.2(33)SRA.
Usage Guidelines
This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2.
Examples
This example shows how to set the maximum time to wait for protocol convergence to 300 seconds:
Router(config)# mls ip multicast sso convergence-time 300Router(config)#This example shows how to set the packet-leak interval to 200 seconds:
Router(config)# mls ip multicast sso leak interval 200Router(config)#This example shows how to set the packet-leak percentage to 55 percent:
Router(config)# mls ip multicast sso leak percent 55Router(config)#Related Commands
show mls ip multicast sso
Displays information about multicast high-availability SSO.
mls ip multicast stub
To enable the support for non-RPF traffic drops for PIM sparse-mode stub networks, use the mls ip multicast stub command in interface configuration mode. To disable support for non-RPF traffic drops for PIM sparse-mode stub networks, use the no form of this command.
mls ip multicast stub
no mls ip multicast stub
Syntax Description
This command has no arguments or keywords.
Defaults
Multicast is disabled.
Command Modes
Interface configuration
Command History
Usage Guidelines
When you enable the ACL-based method of filtering RPF failures by entering the mls ip multicast stub command on the redundant router, the following ACLs automatically download to the PFC and are applied to the interface that you specify:
•
•
•
•
•
The ACLs filter the RPF failures and drop them in the hardware so that they are not forwarded to the router.
Use the ACL-based method of filtering the RPF failures only in sparse-mode stub networks where there are no downstream routers. For dense-mode groups, the RPF failure packets have to be seen on the router for the PIM-assert mechanism to function properly. Use CEF-or NetFlow-based rate limiting to rate limit the RPF failures in dense-mode networks and sparse-mode transit networks.
Examples
This example shows how to enable the support for the non-RPF traffic drops for the PIM sparse-mode stub networks:
Router(config-if)# mls ip multicast stubRelated Commands
mls ip multicast threshold
To configure a threshold rate for installing hardware shortcuts, use the mls ip multicast threshold command in global configuration mode. To deconfigure the threshold rate, use the no form of this command.
mls ip multicast threshold pps
no mls ip multicast threshold
Syntax Description
Defaults
This command has no default settings.
Command Modes
Global configuration
Command History
Usage Guidelines
Use this command to prevent creation of MLS entries for short-lived multicast flows such as join requests.
If multicast traffic drops below the configured multicast rate threshold, all multicast traffic is routed by the MSFC.
This command does not affect already installed routes. For example, if you enter this command and the shortcuts are already installed, the shortcuts are not removed if they are disqualified. To apply the threshold to existing routes, clear the route and let it reestablish.
Examples
This example shows how to configure the IP MLS threshold to 10 packets per second:
Router(config)# mls ip multicast threshold 10Related Commands
mls rp ip (global configuration)
Enables external systems to establish IP shortcuts to the MSFC.
show mls ip multicast
Displays the MLS IP information.
mode bypass
To enable Virtual Multipoint Interfaces (VMI) to support multicast traffic, use the mode bypass command in interface configuration mode. To return the interface to the default mode of aggregate, use the no form of this command.
mode [aggregate | bypass]
no mode bypass
Syntax Description
aggregate
Sets the mode to aggregate. All virtual-access interfaces created by PPPoE sessions are logically aggregated under the VMI.
bypass
Sets the mode to bypass.
Command Default
No mode
Command Modes
Interface configuration
Command History
Usage Guidelines
Use the mode bypass command when you need to support multicast traffic in router-to-radio configurations.
Aggregate Mode
The default mode for operation of the VMI is aggregate mode. In aggregate mode, all of the virtual-access interfaces created by PPPoE sessions are logically aggregated under the VMI. As such, applications above Layer 2, such as, EIGRP and OSPFv3, should be defined on the VMI interface only. Packets sent to the VMI will be correctly forwarded to the correct virtual-access interface.
Bypass Mode
Using bypass mode is recommended for multicast applications.
In bypass mode, the virtual-access interfaces are directly exposed to applications running above Layer2. In bypass mode, definition of a VMI is still required because the VMI will continue to manage presentation of cross-layer signals, such as, neighbor up, neighbor down, and metrics. However, applications will still be aware on the actual underlying virtual-access interfaces and send packets to them directly.
Using bypass mode can cause databases in the applications to be larger because knowledge of more interfaces are required for normal operation.
After you enter the mode bypass command, Cisco recommends that you copy the running configuration to NVRAM. because the default mode of operation for VMI is to logically aggregate the virtual-access interfaces.
Examples
The following example sets the interface mode to bypass:
Router# enableRouter# configure terminalRouter(config)# interface vmi1Router(config-if)# mode bypassRelated Commands
mrinfo
To query which neighboring multicast routers are "peering" with the local router, use the mrinfo command in user EXEC or privileged EXEC mode.
mrinfo [host-name | host-address] [source-address | interface]
Syntax Description
Defaults
The command is disabled.
Command Modes
User EXEC
Privileged EXECCommand History
Usage Guidelines
The mrinfo command is the original tool of the multicast backbone (MBONE) to determine which neighboring multicast routers are peering with a multicast router. Cisco routers have supported responding to mrinfo requests since Cisco IOS Release 10.2.
Now you can query a multicast router using this command. The output format is identical to the multicast routed version of Distance Vector Multicast Routing Protocol (DVMRP). (The mrouted software is the UNIX software that implements DVMRP.)
Examples
The following is sample output from the mrinfo command:
Router# mrinfo192.31.7.37 (barrnet-gw.cisco.com) [version cisco 11.1] [flags: PMSA]:192.31.7.37 -> 192.31.7.34 (sj-wall-2.cisco.com) [1/0/pim]192.31.7.37 -> 192.31.7.47 (dirtylab-gw-2.cisco.com) [1/0/pim]192.31.7.37 -> 192.31.7.44 (dirtylab-gw-1.cisco.com) [1/0/pim]131.119.26.10 -> 131.119.26.9 (su-pr2.bbnplanet.net) [1/32/pim]The flags indicate the following:
•
•
•
•
mrm
To start or stop a Multicast Routing Monitor (MRM) test, use the mrm command in privileged EXEC mode.
mrm test-name {start | stop}
Syntax Description
test-name
Name of the MRM test to start or stop.
start
Starts the MRM test specified for the test-name argument.
stop
Stops the MRM test specified for the test-name argument.
Command Modes
Privileged EXEC
Command History
Usage Guidelines
You must use this command to run an MRM test. When the test runs, the Test Sender sends User Datagram Protocol (UDP) or UDP/Real-Time Transport Protocol (RTP) packets (depending on the senders command) to the Test Receiver.
Examples
The following example shows how to start an MRM test. In this example, the MRM test named test1 is started.
Router# mrm test1 startRelated Commands
mstat
To display IP multicast packet rate and loss information, use the mstat command in user EXEC or privileged EXEC mode.
mstat {source-name | source-address} [destination-name | destination-address] [group-name | group-address]
Syntax Description
Defaults
The command is disabled.
Command Modes
User EXEC
Privileged EXECCommand History
Usage Guidelines
If no arguments are entered, the router will interactively prompt you for them.
This command is a form of UNIX mtrace that reports packet rate and loss information.
Examples
The following is sample output from the mstat command in user EXEC mode:
Router> mstat lwei-home-ss2 172.16.0.1 224.0.255.255Type escape sequence to abort.Mtrace from 172.16.0.0 to 172.16.0.10 via group 224.0.255.255>From source (lwei-home-ss2.cisco.com) to destination (lwei-ss20.cisco.com)Waiting to accumulate statistics......Results after 10 seconds:Source Response Dest Packet Statistics For Only For Traffic172.16.0.0 172.16.0.10 All Multicast Traffic From 172.16.0.0| __/ rtt 48 ms Lost/Sent = Pct Rate To 224.0.255.255v / hop 48 ms --------------------- --------------------172.16.0.1 lwei-cisco-isdn.cisco.com| ^ ttl 1v | hop 31 ms 0/12 = 0% 1 pps 0/1 = --% 0 pps172.16.0.2172.16.0.3 eng-frmt12-pri.cisco.com| ^ ttl 2v | hop -17 ms -735/12 = --% 1 pps 0/1 = --% 0 pps172.16.0.4172.16.0.5 eng-cc-4.cisco.com| ^ ttl 3v | hop -21 ms -678/23 = --% 2 pps 0/1 = --% 0 pps172.16.0.6172.16.0.7 eng-ios-2.cisco.com| ^ ttl 4v | hop 5 ms 605/639 = 95% 63 pps 1/1 = --% 0 pps172.16.0.8172.16.0.9 eng-ios-f-5.cisco.com| \__ ttl 5v \ hop 0 ms 4 0 pps 0 0 pps172.16.0.0 172.16.0.10Receiver Query SourceTable 9 describes the significant fields shown in the display.
Related Commands
mtrace
Traces the path from a source to a destination branch for a multicast distribution tree.
mtrace
To trace the path from a source to a destination branch for a multicast distribution tree, use the mtrace user command in user EXEC or privileged EXEC mode.
mtrace {source-name | source-address} [destination-name | destination-address] [group-name | group-address]
Syntax Description
Defaults
The command is disabled.
Command Modes
User EXEC
Privileged EXECCommand History
Usage Guidelines
The trace request generated by the mtrace command is multicast to the multicast group to find the last hop router to the specified destination. The trace then follows the multicast path from destination to source by passing the mtrace request packet via unicast to each hop. Responses are unicast to the querying router by the first hop router to the source. This command allows you to isolate multicast routing failures.
If no arguments are entered, the router will interactively prompt you for them.
This command is identical in function to the UNIX version of mtrace.
Examples
The following is sample output from the mtrace command in user EXEC mode:
Router> mtrace 172.16.0.0 172.16.0.10 239.254.254.254Type escape sequence to abort.Mtrace from 172.16.0.0 to 172.16.0.10 via group 239.254.254.254From source (?) to destination (?)Querying full reverse path...0 172.16.0.10-1 172.16.0.8 PIM thresh^ 0 0 ms-2 172.16.0.6 PIM thresh^ 0 2 ms-3 172.16.0.5 PIM thresh^ 0 894 ms-4 172.16.0.3 PIM thresh^ 0 893 ms-5 172.16.0.2 PIM thresh^ 0 894 ms-6 172.16.0.1 PIM thresh^ 0 893 msTable 10 describes the significant fields shown in the display.
Related Commands
receivers
To establish Test Receivers for Multicast Routing Monitor (MRM) tests or modify the parameters of Test Receivers, use the receivers command in MRM manager configuration mode. To restore the default values, use the no form of this command.
Form of the Command to Establish Test Receivers
receivers access-list sender-list access-list [packet-delay]
no receivers access-list
Form of the Command to Modify the Parameters of Test Receivers
receivers access-list [window seconds] [report-delay seconds] [loss percentage] [no-join] [monitor | poll]
no receivers access-list
Syntax Description
Command Default
No Test Receivers are configured for MRM tests.
Command Modes
MRM manager configuration (config-mrm-manager)
Command History
Usage Guidelines
This command is required for MRM to work; the receivers access-list and sender-list access-list keyword-argument pairs must be specified.
Note
Optionally, you can use the receivers command to modify the parameters for Test Receivers.
Loss percentage is calculated based on the packet-delay value of the senders command, which defaults to 200 milliseconds, or 5 packets per second. If the window keyword defaults to 5 seconds, then the Test Receiver expects 5 packets per second for 5 seconds = 25 packets. If the Test Receiver receives only 15 packets, then 25 - 15 = 10 lost packets. Lost packets divided by packets expected equals loss percentage; 10/25 equals a loss percentage of 40 percent.
Examples
The following example shows how to establish a Test Receiver for an MRM test:
ip mrm manager test1manager Ethernet0/0 group 239.1.1.1senders 1receivers 2 sender-list 1!access-list 1 permit 10.1.1.2access-list 2 permit 10.1.4.2!Related Commands
router-guard ip multicast
To enable the router guard for switch ports that are connected to multicast routers, use the router-guard ip multicast command in interface configuration mode. To disable the router guard on switch ports that are connected to multicast routers, use the no form of this command.
router-guard ip multicast [vlan vlan-id]
no router-guard ip multicast [vlan vlan-id]
Syntax Description
Command Default
The router guard for switch ports that are connected to multicast routers is disabled by default.
Command Modes
Interface configuration (config-if)
Command History
Usage Guidelines
You can enter the vlan vlan-id keyword and argument if the port is a trunk port.
You cannot enter a range or multiple VLANs in a single command.
For the router guard to work on switch ports, you must enter the router-guard ip multicast switchports global configuration command command before entering the router-guard ip multicast interface configuration command.
Examples
This example shows how to enable the router guard on an interface:
Router(config-if)# router-guard ip multicastThis example shows how to disable router guard on an interface:
Router(config-if)# no router-guard ip multicast vlan 100Related Commands
router-guard ip multicast switchports
To enable the router guard on all switch ports, use the router-guard ip multicast switchports command in global configuration mode. To disable the router guard on all switch ports, use the no form of this command.
router-guard ip multicast switchports
no router-guard ip multicast switchports
Syntax Description
This command has no arguments or keywords.
Command Default
The router guard is disabled on all switch ports.
Command Modes
Global configuration (config)
Command History
Usage Guidelines
If received on a port that has router guard enabled, the following packet types are discarded and the statistics are updated indicating that packets are being dropped by the router guard:
•
•
•
•
•
•
Examples
This example shows how to enable the router guard on all switch ports:
Router(config)# router-guard ip multicast switchportsThis example shows how to disable the router guard on all switch ports:
Router(config)# no router-guard ip multicast switchportsRelated Commands
senders
To configure Test Sender parameters used for a Multicast Routing Monitor (MRM) test, use the senders command in MRM manager configuration mode. To restore the default settings, use the no form of this command.
senders access-list [packet-delay milliseconds] [rtp | udp] [target-only | all-multicasts | all-test-senders] [proxy-src]
no senders access-list
Syntax Description
Command Default
No test senders are configured to be involved in MRM tests.
Command Modes
MRM manager configuration (config-mrm-manager)
Command History
Usage Guidelines
Use this command to specify which Test Senders are involved in the test and are affected by these parameters.
Examples
The following example shows how to configure a Test Sender for an MRM test:
ip mrm manager test1manager Ethernet0/0 group 239.1.1.1senders 1receivers 2 sender-list 1!access-list 1 permit 10.1.1.2access-list 2 permit 10.1.4.2Related Commands
