-
Cisco IOS XR Multicast Command Reference, Release 3.4
-
Preface
-
Multicast IPv4 and IPv6 Commands on Cisco IOS XR Software
-
Multicast Source Discovery Protocol Commands on Cisco IOS XR Software
-
Multicast Routing and Forwarding Commands on Cisco IOS XR Software
-
Multicast PIM Commands on Cisco IOS XR Software
-
Multicast Tool and Utility Commands on Cisco IOS XR Software
-
Index
-
Feedback
Table Of Contents
Multicast Tool and Utility Commands on Cisco IOS XR Software
Multicast Tool and Utility Commands on Cisco IOS XR Software
This chapter describes the commands used to troubleshoot multicast routing sessions on Cisco IOS XR software.
For detailed information about multicast routing concepts, configuration tasks, and examples, refer to Implementing Multicast Routing on Cisco IOS XR Software.
mrinfo
To query neighboring multicast routers peering with the local router, use the mrinfo command in EXEC mode.
mrinfo [ipv4] [host-address] [source-address]
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.
The mrinfo command determines which neighboring multicast routers are peering with a multicast router.
You can query a multicast router with 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.)
Task ID
Examples
The following is sample output from the mrinfo command. The first line shows the multicast configuration with version number and flags PMA. The flags mean that the configuration is prune capable, mtrace capable, and SNMP capable. For each neighbor of the queried multicast router, the IP address of the queried router is displayed, followed by the IP address of the neighbor. The metric (cost of connect) and the threshold (multicast time to live) are displayed. Other information is available, such as whether this router is
•
running the PIM protocol
•
•
RP/0/RP0/CPU0:router# mrinfo 192.168.50.1192.168.50.1 [version 0.37.0] [flags: PMA]:172.16.1.1 -> 172.16.1.1 [1/0/pim/querier/leaf]172.16.2.2 -> 172.16.2.2 [1/0/pim/querier/leaf]192.168.50.1 -> 192.168.50.1 [1/0/pim/querier]192.168.50.1 -> 192.168.50.101 [1/0/pim/querier]192.168.40.101 -> 192.168.40.1 [1/0/pim]192.168.40.101 -> 192.168.40.101 [1/0/pim]mtrace
To trace the path from a source to a destination branch for a multicast distribution tree, use the mtrace command in EXEC mode.
mtrace [ipv4] [source] [destination] [group] [ttl]
Syntax Description
Defaults
By default, this feature is disabled.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.
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 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.
Task ID
Examples
The following is sample output from the mtrace command:
RP/0/RP0/CPU0:router# mtrace 172.16.1.0 172.16.1.10 239.254.254.254Type escape sequence to abort.Mtrace from 172.16.1.0 to 172.16.1.10 via group 239.254.254.254From source (?) to destination (?)Querying full reverse path...0 172.16.1.10-1 172.17.20.101 PIM Reached RP/Core [172.16.1.0/24]-2 172.18.10.1 PIM [172.16.1.0/32]-3 172.16.1.0 PIM [172.16.1.0/32]sap cache-timeout
To limit how long a Session Announcement Protocol (SAP) cache entry stays active in the cache, use the sap cache-timeout command in global configuration mode. To return to the default behavior, use the no form of this command.
sap cache-timeout minutes
no sap cache-timeout
Syntax Description
Defaults
minutes: 1440 minutes (24 hours)
Command Modes
Global configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.
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.
Task ID
Examples
The following example configures the SAP cache entry timeout at 10 minutes:
RP/0/RP0/CPU0:router(config)# sap cache-timeout 10sap listen
To configure the Session Announcement Protocol (SAP) designated router (SDR) listener on a group address, use the sap listen command in global configuration mode. To return to the default behavior, use the no form of this command.
sap listen [ip-address | name]
no sap listen
Syntax Description
Defaults
When no group address is configured, the SDR listener is configured on the global SAP announcement group (224.2.127.254).
Command Modes
Global configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.
This command configures an SDR listener that listens to SAP announcements on the configured group address. The group IP address can be any group in the range from 224.2.128.0 to 224.2.255.255.
Task ID
Examples
The following example configures an SDR listener for group on IP address 224.2.127.254:
RP/0/RP0/CPU0:router(config)# sap listen 224.2.127.254Related Commands
show sap
To display the Session Announcement Protocol (SAP) sessions learned on the configured multicast groups, use the show sap command in EXEC mode.
show sap [ipv4] [group-address | session-name | detail]
Syntax Description
Defaults
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS-XR Software module of the Cisco IOS-XR System Security Configuration Guide.
This command displays the sessions learned on the configured multicast groups. The detail keyword displays verbose session information.
Use the sap listen command to configure the SDR listener on a group IP address.
Task ID
Examples
The following is sample output from the show sap command. Information is summarized and shows one entry.
RP/0/RP0/CPU0:router# show sapSap Session Table SummaryCisco Systems, IncSrc: 192.168.30.101, Dst: 224.2.127.254, Last Heard: 00:00:23 Total Entries : 1Table 44 describes the significant fields shown in the display.
The following is sample output from the show sap command with the detail keyword specified for the SAP session, Cisco Systems, Inc.
RP/0/RP0/CPU0:router# show sap detailSap Session TableSession Name: Cisco Systems, IncDescription: IPTV Streaming VideoGroup: 225.225.225.1 TTL: 2Announcement source: 192.30.30.101, Destination: 224.2.127.254Created by: - 0050c200aabb 9 IN IP4 10.10.176.50Session Permanent Attribute: packetsize:4416Attribute: packetformat:RAWAttribute: mux:m1sAttribute: keywds:Attribute: author:Cisco Systems, IncAttribute: copyright:Cisco Systems, IncMedia : video, Transport Protocol : udp, Port : 444Total Entries : 1Table 45 describes the significant fields shown in the display.
Related Commands