Table Of Contents
ip rgmp
ip sap cache-timeout
ip sap listen
ip sdr cache-timeout
ip sdr listen
ip urd
manager
mdt data
mdt default
mdt log-reuse
mls ip multicast (global configuration)
mls ip multicast (interface configuration)
mls ip multicast bidir gm-scan-interval
mls ip multicast connected
mls ip multicast consistency-check
mls ip multicast flow-stat-timer
mls ip multicast non-rpf aging
mls ip multicast replication-mode
mls ip multicast sso
mls ip multicast stub
mls ip multicast threshold
mode bypass
mrinfo
mrm
mstat
mtrace
receivers
router-guard ip multicast
router-guard ip multicast switchports
senders
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
Release
|
Modification
|
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.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2SX
|
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
|
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
•
IP multicast
•
PIM in sparse mode, sparse-dense mode, source specific mode, or bidirectional mode
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:
•
IP multicast
•
IGMP snooping
Examples
The following example enables RGMP on Ethernet interface 1/0:
Related Commands
Command
|
Description
|
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
minutes
|
Time (in minutes) that a SAP cache entry is active in the cache.
|
Defaults
By default, session announcements remain for 1440 minutes (24 hours) in the cache.
Command Modes
Global configuration
Command History
Release
|
Modification
|
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.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2SX
|
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
|
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:
Related Commands
Command
|
Description
|
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
Release
|
Modification
|
11.1
|
The ip sdr listen command was introduced.
|
12.2
|
The ip sdr listen command was replaced by the ip sap listen command.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2SX
|
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
|
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 address 10.0.0.51 255.255.255.0
Related Commands
Command
|
Description
|
clear ip sap
|
Deletes a SAP cache entry or the entire SAP cache.
|
ip multicast rate-limit
|
Controls the rate a sender from the source list can send to a multicast group in the group list.
|
ip multicast-routing
|
Enables IP multicast routing or multicast distributed switching.
|
ip sap cache-timeout
|
Limits how long a SAP cache entry stays active in the cache.
|
show ip mroute
|
Displays the contents of the IP mroute routing table.
|
show ip sap
|
Displays the SAP cache.
|
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
proxy
|
(Optional) Allows an interface to accept URL requests from any TCP connection sent to that interface. If the proxy keyword is not configured, the interface will accept URL requests from TCP connections only if the requests originated from directly connected hosts.
The proxy option must be enabled on an interface if it is unnumbered or if it has downstream routers configured with Internet Group Management Protocol (IGMP) proxy routing. To prevent users on the backbone from creating URD state on your router, do not enable the proxy option on a backbone interface of your router.
|
Defaults
The command is disabled.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.1(3)T
|
This command was introduced.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2SX
|
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
|
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:
Related Commands
Command
|
Description
|
ip pim ssm
|
Defines the SSM range of IP multicast addresses.
|
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
interface-type interface-number
|
Interface type and number of the Manager. The IP address associated with this interface is the source address of the Manager.
|
group ip-address
|
Specifies the IP multicast group address that the Test Receiver will listen to.
|
Command Default
There is no MRM Manager configured.
Command Modes
MRM manager configuration (config-mrm-manager)
Command History
Release
|
Modification
|
12.0(5)S
|
This command was introduced.
|
12.0(5)T
|
This command was integrated into Cisco IOS Release 12.0(5)T.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2SX
|
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
|
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:
manager ethernet 0 group 239.1.1.1
Related Commands
Command
|
Description
|
beacon (multicast routing monitor)
|
Changes the frequency, duration, or scope of beacon messages that the Manager sends to Test Senders and Test Receivers during an MRM test.
|
ip mrm accept-manager
|
Configures a Test Sender or Test Receiver to accept requests only from Managers that pass an access list.
|
show ip mrm manager
|
Displays test information for MRM.
|
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
group-address-range
|
Multicast group address range. The range is from 224.0.0.1 to 239.255.255.255.
|
wildcard-bits
|
Wildcard bits to be applied to the multicast group address range.
|
threshold threshold-value
|
(Optional) Defines the bandwidth threshold value. The range is from 1 through 4294967.
|
list access-list
|
(Optional) Defines the access list name or number.
|
Defaults
The command is disabled.
Command Modes
VRF configuration
Command History
Release
|
Modification
|
12.0(23)S
|
This command was introduced.
|
12.2(13)T
|
This command was integrated into Cisco IOS Release 12.2(13)T.
|
12.2(14)S
|
This command was integrated into Cisco IOS Release 12.2(14)S.
|
12.2(18)SXE
|
Support for this command was introduced on the Supervisor Engine 720.
|
12.2(27)SBC
|
This command was integrated into Cisco IOS Release 12.2(27)SBC.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2SX
|
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
|
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.
mdt data 232.0.1.0 0.0.0.255 threshold 500 list 101
ip pim vrf vrf1 accept-rp auto-rp
Related Commands
Command
|
Description
|
mdt default
|
Configures a default MDT group for a VPN VRF.
|
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
group-address
|
IP address of the default MDT group. This address serves as an identifier for the community in that provider-edge (PE) routers configured with the same group address become members of the group, allowing them to receive packets sent by each other.
|
Defaults
The command is disabled.
Command Modes
VRF configuration
Command History
Release
|
Modification
|
12.0(23)S
|
This command was introduced.
|
12.2(13)T
|
This command was integrated into Cisco IOS Release 12.2(13)T.
|
12.2(14)S
|
This command was integrated into Cisco IOS Release 12.2(14)S.
|
12.2(18)SXE
|
Support for this command was introduced on the Supervisor Engine 720.
|
12.2(27)SBC
|
This command was integrated into Cisco IOS Release 12.2(27)SBC.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
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.
mdt data 232.0.1.0 0.0.0.255 threshold 500 list 101
ip pim vrf vrf1 accept-rp auto-rp
Related Commands
Command
|
Description
|
mdt data
|
Configures the multicast group address range for data MDT groups.
|
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
Release
|
Modification
|
12.0(23)S
|
This command was introduced.
|
12.2(13)T
|
This command was integrated into Cisco IOS Release 12.2(13)T.
|
12.2(14)S
|
This command was integrated into Cisco IOS Release 12.2(14)S.
|
12.2(18)SXE
|
Support for this command was introduced on the Supervisor Engine 720.
|
12.2(27)SBC
|
This command was integrated into Cisco IOS Release 12.2(27)SBC.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
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:
Related Commands
Command
|
Description
|
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
capability
|
(Optional) Exports the information about the egress capability from the switch processor to the route processor.
|
vrf name
|
(Optional) Specifies the VRF name.
|
connected
|
(Optional) Installs the interface/mask entries for bridging directly connected sources to the internal router.
|
egress local
|
(Optional) Populates the multicast expansion table with local Layer 3-routed interfaces.
|
mfd
|
(Optional) Enables complete hardware switching.
|
refresh-state
|
(Optional) Refreshes the expiration time of the (S,G) entry or the (*,G) entry with NULL OIF.
|
shared-tree-mfd
|
(Optional) Enables the complete shortcut for (*,G) flows.
|
syslog
|
(Optional) Enables the display of multicast related syslog messages on console.
|
threshold ppsec
|
(Optional) Sets the minimum traffic rate; below this rate, the flow is software-switched instead of hardware-switched. Valid values are from 10 to 10000 seconds.
|
Defaults
The defaults are as follows:
•
Multicast is disabled.
•
Hardware switching is allowed for all eligible multicast routes.
•
connected is enabled.
•
egress local is disabled.
•
mfd is enabled.
•
refresh-state is enabled.
•
shared-tree-mfd is enabled.
•
syslog is disabled.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(14)SX
|
Support for this command was introduced on the Supervisor Engine 720.
|
12.2(17a)SX
|
This command was changed to include the capability keyword.
|
12.2(17d)SXB
|
Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
|
12.2(18)SXF
|
This command was changed to include the egress local keywords.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2(33)SXI
|
Support for the syslog feature was added.
|
Usage Guidelines
Note
After you enter the mls ip multicast egress local command, you must perform a system reset for the configuration to take effect.
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:
•
threshold
•
connected
•
refresh-state
•
shared-tree-mfd
•
mfd
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 multicast
This example shows how to enable the hardware switching on a specific multicast route:
Router(config)# mls ip multicast vrf test1
This example shows how to export the information about egress capability from the switch processor to the route processor:
Router(config)# mls ip multicast capability
This example shows how to populate the multicast expansion table with local Layer 3-routed interfaces:
Router(config)# mls ip multicast egress local
Related Commands
Command
|
Description
|
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
Release
|
Modification
|
12.2(14)SX
|
Support for this command was introduced on the Supervisor Engine 720.
|
12.2(17d)SXB
|
Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
Examples
This example shows how to enable the MLS IP shortcuts:
Router(config-if)# mls ip multicast
Related Commands
Command
|
Description
|
show mls ip multicast
|
Displays the MLS IP information.
|
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
interval
|
RPF scan interval for the Bidir rendevous point; valid values are from 1 to 1000 seconds.
|
Defaults
10 seconds
Command Modes
Global configuration
Command History
Release
|
Modification
|
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 30
Related Commands
Command
|
Description
|
show mls ip multicast bidir
|
Displays the Bidir hardware-switched entries.
|
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
Release
|
Modification
|
12.2(14)SX
|
Support for this command was introduced on the Supervisor Engine 720.
|
12.2(17d)SXB
|
Support for this command on the Supervisor Engine 2 was extended to Release12.2(17d)SXB.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
Usage Guidelines
Do not create directly connected subnets for the following cases:
•
To make more room available in the FIB TCAM
•
The switch is the first-hop router for a source
•
The entries are for Bidir, SSM, and DM mode groups
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 connected
Related Commands
Command
|
Description
|
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
auto-repair
|
(Optional) Specifies the automatic repair for the consistency checker.
|
error-message
|
(Optional) Specifies the error message for the consistency checker.
|
settle-time seconds
|
(Optional) Specifies the settle time for the consistency checker; valid values are from 2 to 3600 seconds.
|
type rp-sp
|
(Optional) Specifies the type of consistency check as a MLSM route switch processor.
|
table
|
(Optional) Specifies the VRF multicast table to check. Valid values are 0 to 65535.
|
vrf
|
(Optional) Specifies the VPN routing/forwarding instance to check.
|
type scan-mroute
|
(Optional) Specifies the type of consistency check as a scan check of the mroute table.
|
count count-number
|
(Optional) Specifies the maximum number of prefixes to check per scan; valid values are from 2 to 500.
|
period seconds
|
(Optional) Specifies the period between scans; valid values are from 2 to 3600 seconds.
|
Defaults
The defaults are as follows:
•
Consistency check is enabled.
•
count count-number is 20.
•
period seconds is 2 seconds.
•
settle-time seconds is 60 seconds.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(14)SX
|
Support for this command was introduced on the Supervisor Engine 720.
|
12.2(17d)SXB
|
Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
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-check
This 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 35
This 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 35
Related Commands
Command
|
Description
|
show mls ip multicast consistency-check
|
Displays the MLS IP information.
|
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
Release
|
Modification
|
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 10
Related Commands
Command
|
Description
|
show mls ip multicast
|
Displays the MLS IP information.
|
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
global time
|
Specifies the global aging time interval. Valid values are 1 to 180; by default the time is set to 20 seconds.
|
fast time
|
Specifies the fast aging time interval. Valid values are 2 to 10; by default the time is set to 2 seconds.
|
Defaults
The fast aging time default is 2 seconds and the global aging time default is 20 seconds.
Command Modes
Global configuration
Command History
Release
|
Modification
|
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 90
This example shows how to display the multicast configuration of the router:
Router# show running | incl mls ip multicast
mls ip multicast non-rpf aging global 90
mls ip multicast non-rpf aging fast 4
Related Commands
Command
|
Description
|
show mls ip multicast
|
Displays the MLS IP information.
|
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:
•
The Cisco 7600 series router reverts to ingress mode.
•
A system log is generated.
•
A system reload occurs to revert to the old configuration.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(14)SX
|
Support for this command was introduced on the Supervisor Engine 720.
|
12.2(18)SXF
|
Thic command was changed to support the egress keyword.
|
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 32.
This command is not supported on Cisco 7600 series routers that are configured with a Supervisor Engine 2.
Note
During the change from egress- to ingress-replication mode, traffic interruptions may occur because the shortcuts are purged and reinstalled. To avoid interruptions in traffic forwarding, enter the mls ip multicast replication-mode ingress command.
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 ingress
This example shows how to enable the egress-replication mode:
Router(config)# mls ip multicast replication-mode egress
This example shows how to disable the current egress-replication mode and return to automatic detection mode:
Router(config)# no mls ip multicast replication-mode egress
Related Commands
Command
|
Description
|
show mls ip multicast capability
|
Displays the MLS IP information.
|
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
convergence-time time
|
Specifies the maximum time to wait for protocol convergence; valid values are from 0 to 3600 seconds.
|
leak interval seconds
|
Specifies the packet-leak interval; valid values are from 0 to 3600 seconds.
|
leak percent percentage
|
Specifies the percentage of multicast packets leaked to the router during switchover so that protocol convergence can take place; valid values are from 1 to 100 percent.
|
Command Default
The defaults are as follows:
•
convergence-time time—20 seconds
•
leak interval—60 seconds
•
leak percentage—10 percent
Command Modes
Global configuration
Command History
Release
|
Modification
|
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 300
This example shows how to set the packet-leak interval to 200 seconds:
Router(config)# mls ip multicast sso leak interval 200
This example shows how to set the packet-leak percentage to 55 percent:
Router(config)# mls ip multicast sso leak percent 55
Related Commands
Command
|
Description
|
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
Release
|
Modification
|
12.2(14)SX
|
Support for this command was introduced on the Supervisor Engine 720.
|
12.2(17d)SXB
|
Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
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:
•
access-list 100 permit ip A.B.C.0 0.0.0.255 any
•
access-list 100 permit ip A.B.D.0 0.0.0.255 any
•
access-list 100 permit ip any 224.0.0.0 0.0.0.255
•
access-list 100 permit ip any 224.0.1.0 0.0.0.255
•
access-list 100 deny ip any 224.0.0.0 15.255.255.255
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 stub
Related Commands
Command
|
Description
|
show mls ip multicast
|
Displays the MLS IP information.
|
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
pps
|
Threshold in packets per seconds. Valid values are from 10 to 10000.
|
Defaults
This command has no default settings.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.2(14)SX
|
Support for this command was introduced on the Supervisor Engine 720.
|
12.2(17d)SXB
|
Support for this command on the Supervisor Engine 2 was extended to Release 12.2(17d)SXB.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
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 10
Related Commands
Command
|
Description
|
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
Release
|
Modification
|
12.4(15)XF
|
This command was introduced.
|
12.4(15)T
|
This command was integrated into Cisco IOS Release 12.4(15)T to support multicast traffic on Virtual Multipoint Interfaces (VMIs).
|
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# configure terminal
Router(config)# interface vmi1
Router(config-if)# mode bypass
Related Commands
Command
|
Description
|
interface vmi
|
Creates a VMI interface.
|
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
host-name | host-address
|
(Optional) The Domain Name System (DNS) name or IP address of the multicast router to query. If omitted, the router queries itself.
|
source-address
|
(Optional) Source address used on multicast routing information (mrinfo) requests. If omitted, the source is based on the outbound interface for the destination.
|
interface
|
(Optional) Source interface used on mrinfo requests. If omitted, the source is based on the outbound interface for the destination.
|
Defaults
The command is disabled.
Command Modes
User EXEC
Privileged EXEC
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2SX
|
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
|
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:
192.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:
•
P: prune-capable
•
M: mtrace-capable
•
S: SNMP-capable
•
A: Auto-RP-capable
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
Release
|
Modification
|
12.0(5)S
|
This command was introduced.
|
12.0(5)T
|
This command was integrated into Cisco IOS Release 12.0(5)T.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2SX
|
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
|
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.
Related Commands
Command
|
Description
|
ip mrm manager
|
Identifies an MRM test and enters the mode in which you specify the test parameters.
|
senders
|
Configures Test Sender parameters used in MRM.
|
show ip mrm status-report
|
Displays the status reports in the MRM status report cache.
|
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
source-name | source-address
|
Domain Name System (DNS) name or the IP address of the multicast-capable source.
|
destination-name | destination-address
|
(Optional) DNS name or address of the destination. If omitted, the command uses the system at which the command is typed.
|
group-name | group-address
|
(Optional) DNS name or multicast address of the group to be displayed. Default address is 224.2.0.1 (the group used for multicast backbone [MBONE] Audio).
|
Defaults
The command is disabled.
Command Modes
User EXEC
Privileged EXEC
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2SX
|
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
|
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.255
Type 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 Traffic
172.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.255
v / hop 48 ms --------------------- --------------------
172.16.0.1 lwei-cisco-isdn.cisco.com
v | hop 31 ms 0/12 = 0% 1 pps 0/1 = --% 0 pps
172.16.0.3 eng-frmt12-pri.cisco.com
v | hop -17 ms -735/12 = --% 1 pps 0/1 = --% 0 pps
172.16.0.5 eng-cc-4.cisco.com
v | hop -21 ms -678/23 = --% 2 pps 0/1 = --% 0 pps
172.16.0.7 eng-ios-2.cisco.com
v | hop 5 ms 605/639 = 95% 63 pps 1/1 = --% 0 pps
172.16.0.9 eng-ios-f-5.cisco.com
v \ hop 0 ms 4 0 pps 0 0 pps
Table 9 describes the significant fields shown in the display.
Table 9 mstat Field Descriptions
Field
|
Description
|
Source
|
Traffic source of packet.
|
Response Dest
|
Place where the router sends the results of the mstat command.
|
ttl
|
Number of hops required from the traffic source to the current hop.
|
hop
|
Number of milliseconds of delay.
|
Only For Traffic From
|
0 packets dropped out of 2 packets received. If, for example, -2/2 was indicated, then there are 2 extra packets, which could indicate a loop condition.
|
Related Commands
Command
|
Description
|
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
source-name | source-address
|
Domain Name System (DNS) name or the IP address of the multicast-capable source. This is a unicast address of the beginning of the path to be traced.
|
destination-name | destination-address
|
(Optional) DNS name or address of the unicast destination. If omitted, the mtrace starts from the system at which the command is typed.
|
group-name | group-address
|
(Optional) DNS name or multicast address of the group to be traced. Default address is 224.2.0.1 (the group used for multicast backbone [MBONE] Audio). When address 0.0.0.0 is used, the software invokes a weak mtrace. A weak mtrace is one that follows the RPF path to the source, regardless of whether any router along the path has multicast routing table state.
|
Defaults
The command is disabled.
Command Modes
User EXEC
Privileged EXEC
Command History
Release
|
Modification
|
11.0
|
This command was introduced.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2SX
|
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
|
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.254
Type escape sequence to abort.
Mtrace from 172.16.0.0 to 172.16.0.10 via group 239.254.254.254
From source (?) to destination (?)
Querying full reverse path...
-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 ms
Table 10 describes the significant fields shown in the display.
Table 10 mtrace Field Descriptions
Field
|
Description
|
Mtrace from 172.16.0.0 to 172.16.0.10 via group 239.254.254.254
|
Name and address of source, destination, and group for which routes are being traced.
|
-3 172.16.0.5
|
Hops away from destination (-3) and address of intermediate router.
|
PIM thresh^ 0
|
Multicast protocol in use on this hop, and time-to-live (TTL) threshold.
|
893 ms
|
Time taken for trace to be forwarded between hops.
|
Related Commands
Command
|
Description
|
mstat
|
Displays IP multicast packet rate and loss information.
|
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
access-list
|
IP named or numbered access list that establishes the Test Receivers. Only these Test Receivers are subject to the other keywords and arguments specified in this command.
|
sender-list access-list
|
Specifies the sources that the Test Receiver should monitor. If the named or numbered access list matches any access list specified in the senders command, the associated packet-delay milliseconds keyword and argument of that senders command are used in this command. Otherwise, the packet-delay argument is required in this receivers command.
|
packet-delay
|
(Optional) Specifies the delay between test packets (in milliseconds). The range is from 50 to 10000. If the sender-list access list matches any access list specified in a senders command, the associated packet-delay milliseconds keyword and argument of that senders command are used in this command. Otherwise, the packet-delay argument is required in this receivers command.
|
window seconds
|
(Optional) Specifies the duration (in seconds) of a test period. This is a sliding window of time in which the packet count is collected, so that the loss percentage can be calculated. The range is from 1 to 10. The default is 5 seconds.
|
report-delay seconds
|
(Optional) Specifies the delay (in seconds) between status reports. The delay prevents multiple Test Receivers from sending status reports to the Manager at the same time for the same failure. This value is relevant only if there are multiple Test Receivers. The range is from 1 to 60. The default is 1 second.
|
loss percentage
|
(Optional) Specifies the threshold percentage of packet loss required before a status report is triggered. The range is from 0 to 100. The default is 0 percent, which means that a status report is sent for any packet loss. (This value is not applied to packet duplication; a fault report is sent for any duplicated packets.) Loss percentage calculation is explained in the "Usage Guidelines" section of this command.
|
no-join
|
(Optional) Specifies that the Test Receiver does not join the monitored group. The default is that the Test Receiver joins the monitored group.
|
monitor | poll
|
(Optional) Specifies whether the Test Receiver monitors the test group or polls for receiver statistics. The monitor keyword means the Test Receiver reports only if the test criteria are met. The poll keyword means the Test Receiver sends status reports regularly, whether test criteria are met or not. The default is the behavior set with the monitor keyword.
|
Command Default
No Test Receivers are configured for MRM tests.
Command Modes
MRM manager configuration (config-mrm-manager)
Command History
Release
|
Modification
|
12.0(5)S
|
This command was introduced.
|
12.0(5)T
|
This command was integrated into Cisco IOS Release 12.0(5)T.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2SX
|
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
|
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
The Cisco IOS CLI parser accepts the command entered without the required sender-list access-list keyword-argument pair. This keyword-argument pair, however, is not optional. For an MRM test to work, you must specify the sources that the Test Receiver should monitor using the sender-list keyword and access-list argument.
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:
manager Ethernet0/0 group 239.1.1.1
receivers 2 sender-list 1
access-list 1 permit 10.1.1.2
access-list 2 permit 10.1.4.2
Related Commands
Command
|
Description
|
senders
|
Establishes Test Senders for MRM.
|
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
vlan vlan-id
|
(Optional) Specifies the Layer 2 VLAN identification.
|
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
Release
|
Modification
|
12.2(33)SXH
|
This command was introduced.
|
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 multicast
This example shows how to disable router guard on an interface:
Router(config-if)# no router-guard ip multicast vlan 100
Related Commands
Command
|
Description
|
clear router-guard ip multicast statistics
|
Clears the router guard statistical information.
|
router-guard ip multicast switchports
|
Enables or disables the router guard on all switch ports.
|
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
Release
|
Modification
|
12.2(33)SXH
|
This command was introduced.
|
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:
•
Internet Group Management Protocol (IGMP) query messages
•
IPv4 Peripheral Interface Manager version 2 messages
•
IGMP PIM messages (PIMv1)
•
IGMP Distance Vector Multicast Routing Protocol (DVMRP) messages
•
Router-port Group Management Protocol (RGMP)messages
•
Cisco Group Multicast Protocol (CGMP)messages
Examples
This example shows how to enable the router guard on all switch ports:
Router(config)# router-guard ip multicast switchports
This example shows how to disable the router guard on all switch ports:
Router(config)# no router-guard ip multicast switchports
Related Commands
Command
|
Description
|
clear router-guard ip multicast statistics
|
Clears the router guard statistical information.
|
router-guard ip multicast
|
Enables or disables the router guard for switch ports that are connected to multicast routers.
|
show router-guard
|
Displays the router guard status and configuration information.
|
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
access-list
|
IP named or numbered access list that defines which Test Senders are involved in the test and which Test Senders these parameters apply to.
|
packet-delay milliseconds
|
(Optional) Specifies the delay between test packets (in milliseconds). The range is from 50 to 10000. The default is 200 milliseconds, which results in 5 packets per second.
|
rtp | udp
|
(Optional) Specifies the encapsulation of test packets, either Real-Time Transport Protocol (RTP)-encapsulated or User Datagram Protocol (UDP)-encapsulated. By default, test packets are RTP-encapsulated.
|
target-only
|
(Optional) Specifies that test packets are sent out on the targeted interface only (that is, the interface with the IP address that is specified in the Test Sender request target field). By default, test packets are sent out on all interfaces that are enabled with IP multicast.
|
all-multicasts
|
(Optional) Specifies that the test packets are sent out on all interfaces that are enabled with IP multicast. This is the default method for sending test packets.
|
all-test-senders
|
(Optional) Specifies that test packets are sent out on all interfaces that have test-sender mode enabled. By default, test packets are sent out on all interfaces that are enabled with IP multicast.
|
proxy-src
|
(Optional) Source IP address for which the Test Sender will proxy test packets. Enter an address if you want to test, for a specific source, whether the multicast distribution tree is working.
|
Command Default
No test senders are configured to be involved in MRM tests.
Command Modes
MRM manager configuration (config-mrm-manager)
Command History
Release
|
Modification
|
12.0(5)S
|
This command was introduced.
|
12.0(5)T
|
This command was integrated into Cisco IOS Release 12.0(5)T.
|
12.2(33)SRA
|
This command was integrated into Cisco IOS Release 12.2(33)SRA.
|
12.2SX
|
This command is supported in the Cisco IOS Release 12.2SX train. Support in a specific 12.2SX release of this train depends on your feature set, platform, and platform hardware.
|
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:
manager Ethernet0/0 group 239.1.1.1
receivers 2 sender-list 1
access-list 1 permit 10.1.1.2
access-list 2 permit 10.1.4.2
Related Commands
Command
|
Description
|
receivers
|
Establishes Test Receivers for MRM.
|