-
Cisco IOS XR Multicast Command Reference, Release 3.6
-
Preface
-
Multicast IPv4 and IPv6 Commands on Cisco IOS XR Software
-
Multicast Routing and Forwarding Commands on Cisco IOS XR Software
-
Multicast Source Discovery Protocol 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
-
Table Of Contents
Multicast IPv4 and IPv6 Commands on Cisco IOS XR Software
interface all router disable (IGMP/MLD)
Multicast IPv4 and IPv6 Commands on Cisco IOS XR Software
This chapter describes the commands used to configure and monitor IPv4 and IPv6 protocol using Cisco IOS XR software.
The commands in this chapter apply to these protocols:
•
Internet Group Management Protocol (IGMP) (Versions 1, 2, and 3)
•
Note
IGMP Version 1 does not have a complementary MLD version.For detailed information about multicast routing concepts, configuration tasks, and examples, refer to the Implementing Multicast Routing on Cisco IOS XR Software configuration module.
access-group (IGMP)
To set limits on an interface for multicast-group join requests by hosts, use the access-group command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.
access-group access-list
no access-group access-list
Syntax Description
Defaults
If this command is not specified in interface configuration mode, the interface adopts the global access group specified in router Internet Group Management Protocol (IGMP) or Multicast Listener Discovery (MLD) configuration mode.
If this command is not specified in router IGMP or MLD configuration mode, the interface accepts all multicast join requests by hosts.
Command Modes
Router IGMP interface configuration (IPv4)
Router MLD interface configuration (IPv6)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.
Task ID
Examples
In the following example, hosts serviced by Packet-over-SONET/SDH (POS) interface 0/1/0/1 can join only group 225.2.2.2:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# ipv4 access-list mygroup permit 225.2.2.2 0.0.0.0RP/0/RP0/CPU0:router(config)# router igmpRP/0/RP0/CPU0:router(config-igmp)# interface pos 0/1/0/1RP/0/RP0/CPU0:router(config-igmp-default-if)# access-group mygroupIn the following example, an access group is configured for IPv6:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# ipv6 access-list mld-aclRP/0/RP0/CPU0:router(config-ipv6-acl)# 10 permit ipv6 any host ff3e::8000:1bb8RP/0/RP0/CPU0:router(config-ipv6-acl)# exitRP/0/RP0/CPU0:router(config)# router mldRP/0/RP0/CPU0:router(config-mld)# access-group mld-aclclear igmp counters
To clear IGMP traffic statistics, use the clear igmp counters command in EXEC mode.
clear igmp [ipv4 vrf vrf-name | vrf vrf-name] counters
Syntax Description
ipv4
(Optional) Specifies IPv4 addressing. IPv4 is the default for Internet Group Management Protocol (IGMP) groups.
vrf vrf-name
(Optional) Specifies a VPN routing and forwarding (VRF) instance.
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.
After IGMP statistics are cleared, statistics begin incrementing again.
Task ID
Examples
The following example shows sample output before and after clearing IGMP traffic statistics:
RP/0/RP0/CPU0:router# show igmp trafficIGMP Traffic CountersElapsed time since counters cleared: 00:00:19Received SentValid IGMP Packets 0 12Queries 0 3Reports 0 9Leaves 0 0Mtrace packets 0 0DVMRP packets 0 0PIM packets 0 0Errors:Malformed Packets 0Bad Checksums 0Socket Errors 0Bad Scope Errors 0Auxiliary Data Len Errors 0Subnet Errors 0Packets dropped due to invalid socket 0Packets which couldn't be accessed 0Other packets drops 0RP/0/RP0/CPU0:router# clear igmp countersRP/0/RP0/CPU0:router# show igmp trafficIGMP Traffic CountersElapsed time since counters cleared: 00:00:12Received SentValid IGMP Packets 0 1Queries 0 1Reports 0 0Leaves 0 0Mtrace packets 0 0DVMRP packets 0 0PIM packets 0 0Errors:Malformed Packets 0Bad Checksums 0Socket Errors 0Bad Scope Errors 0Auxiliary Data Len Errors 0Subnet Errors 0Packets dropped due to invalid socket 0Packets which couldn't be accessed 0Other packets drops 0Related Commands
clear igmp group
To clear Internet Group Management Protocol (IGMP) groups on one or all interfaces, use the clear igmp group command in EXEC mode.
clear igmp [ipv4 vrf vrf-name | vrf vrf-name] group [ip-address | type instance]
Syntax Description
Defaults
If no group address is specified, all IGMP groups are cleared.
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.
To clear all IGMP groups, use the clear igmp group command without using an argument. To clear a particular group, use the ip-address or type instance arguments.
The following groups cannot be cleared:
•
•
•
•
Task ID
Examples
The following example uses the show igmp group command to display the IGMP Connected Group Membership, the clear igmp group command to clear address 239.1.1.1, and the show igmp group command again to display the updated list.
RP/0/RP0/CPU0:router# show igmp group pos 0/4/0/0IGMP Connected Group MembershipGroup Address Interface Uptime Expires Last Reporter224.0.0.2 POS0/4/0/0 2w2d never 40.40.1.1224.0.0.13 POS0/4/0/0 2w2d never 40.40.1.1224.0.0.22 POS0/4/0/0 2w2d never 40.40.1.1239.1.1.1 POS0/4/0/0 00:00:02 00:02:07 40.40.1.22RP/0/RP0/CPU0:router# clear igmp group pos 0/4/0/0RP/0/RP0/CPU0:router# show igmp group pos 0/4/0/0IGMP Connected Group MembershipGroup Address Interface Uptime Expires Last Reporter224.0.0.2 POS0/4/0/0 2w2d never 40.40.1.1224.0.0.13 POS0/4/0/0 2w2d never 40.40.1.1224.0.0.22 POS0/4/0/0 2w2d never 40.40.1.1Related Commands
Displays the multicast groups that are directly connected to the router and that were learned through IGMP.
clear igmp reset
To clear all Internet Group Management Protocol (IGMP) membership entries and reset connection in the Multicast Routing Information Base (MRIB), use the clear igmp reset command in EXEC mode.
clear igmp [ipv4 vrf vrf-name | vrf vrf-name] reset
Syntax Description
ipv4
(Optional) Specifies IPv4 addressing. IPv4 is the default for IGMP groups.
vrf vrf-name
(Optional) Specifies a VPN routing and forwarding (VRF) instance.
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.
Every IGMP group membership that IGMP learns is downloaded to the MRIB database.
The clear igmp reset command is used to clear all information from the IGMP topology table and reset the MRIB connection.
Note
Task ID
Examples
The following example shows how to clear the group memberships in MRIB:
RP/0/RP0/CPU0:router# clear igmp resetRelated Commands
Displays the multicast groups that are directly connected to the router and that were learned through IGMP.
Displays all route entries in the MRIB table.
clear mld counters
To clear Multicast Listener Discovery (MLD) traffic statistics, use the clear mld counters command in EXEC mode.
clear mld [ipv6 vrf vrf-name | vrf vrf-name] counters
Syntax Description
ipv6
(Optional) Specifies IPv6 addressing. IPv6 is the default for MLD groups.
vrf vrf-name
(Optional) Specifies a VPN routing and forwarding (VRF) instance.
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.
After MLD statistics are cleared, statistics begin incrementing once again.
Task ID
Examples
The following example shows how to clear MLD traffic statistics:
RP/0/RP0/CPU0:router# clear mld counters
Note
Related Commands
clear mld group
To clear Multicast Listener Discovery (MLD) groups on one or all interfaces, use the clear mld group command in EXEC mode.
clear mld [ipv6 vrf vrf-name | vrf vrf-name] group [type instance]
Syntax Description
Defaults
If no group address is specified, all MLD groups are cleared.
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 clear mld group command is used to clear user-specified MLD membership or all MLD membership learned from external hosts. Use the type and number arguments to clear specific MLD membership, or if no interface arguments are specified, clear MLD membership from all interfaces. This command does not clear local static group members.
Task ID
Examples
The following example shows how to clear MLD groups for Packet-over-SONET/SDH (POS) interface 0/4/0/0:
RP/0/RP0/CPU0:router# clear mld group pos 0/4/0/0
Note
Related Commands
Displays the multicast groups that are directly connected to the router and that were learned through MLD.
clear mld reset
To clear all Multicast Listener Discovery (MLD) membership entries and reset connection in the Multicast Routing Information Base (MRIB), use the clear mld reset command in EXEC mode.
clear mld [ipv6 vrf vrf-name | vrf vrf-name] reset
Syntax Description
ipv6
(Optional) Specifies IPv6 addressing. IPv6 is the default for MLD groups.
vrf vrf-name
(Optional) Specifies a VPN routing and forwarding (VRF) instance.
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.
Every MLD group membership that MLD learns is downloaded to the MRIB database.
The clear mld reset command is used to clear all information from the MLD topology table and reset the MRIB connection.
Note
Task ID
Examples
The following example shows how to clear the group memberships in MRIB:
RP/0/RP0/CPU0:router# clear mld resetRelated Commands
Displays the multicast groups that are directly connected to the router and that were learned through MLD.
Displays all route entries in the MRIB table.
explicit-tracking
To configure Internet Group Management Protocol (IGMP) Version 3 (under IPv4) and Multicast Listener Discovery (MLD) Version 2 (under IPv6) explicit host tracking, use the explicit-tracking command in the appropriate configuration mode. To disable explicit host tracking, use the no form of this command.
explicit-tracking [access-list | disable]
no explicit-tracking
Syntax Description
Defaults
If this command is not specified in interface configuration mode, the interface adopts the explicit tracking parameter specified in router IGMP or MLD configuration mode.
If this command is not specified in router IGMP or MLD configuration mode, then explicit host tracking is disabled.Command Modes
Router IGMP configuration (IPv4)
Router IGMP interface configuration (IPv4)
Router MLD configuration (IPv6)
Router MLD interface configuration (IPv6)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.
Note
By default, IGMP supports Version 3, unless a Version 2 or Version 1 IGMP host message is detected in the network. For backward compatibility, IGMP downgrades to run at the IGMP version level that is installed.
This feature allows the router to achieve minimal leave latencies when hosts leave a multicast group or channel. To monitor IGMP membership of hosts, use the show igmp groups command in EXEC mode.
In router configuration mode, the explicit-tracking command enables explicit host tracking for all interfaces. To disable the feature on specific interfaces, use the explicit-tracking command in interface configuration mode with the disable keyword.
Note
Task ID
Examples
The following example shows how to enable explicit host tracking for the access list named router1 on all interfaces and how to disable explicit host tracking for a specific POS interface:
RP/0/RP0/CPU0:router(config)# router igmpRP/0/RP0/CPU0:router(config-igmp)# explicit-tracking router1RP/0/RP0/CPU0:router(config-igmp)# interface pos 0/1/0/0RP/0/RP0/CPU0:router(config-igmp-default-if)# explicit-tracking disableRelated Commands
interface all router disable (IGMP/MLD)
To disable Internet Group Management Protocol (IGMP) or Multicast Listener Discovery (MLD) membership tracking on all interfaces, use the interface all router disable command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.
interface all router disable
no interface all router disable
Syntax Description
This command has no arguments or keywords.
Defaults
Enabled (on all enabled interfaces)
Command Modes
Router IGMP configuration (IPv4)
Router MLD configuration (IPv6)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.
Task ID
Examples
The following example shows how to disable IGMP membership tracking for all interfaces:
RP/0/RP0/CPU0:router(config)# router igmpRP/0/RP0/CPU0:router(config-igmp)# interface all router disablejoin-group
To have the router join a multicast group, use the join-group command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.
join-group group-address [source-address]
no join-group group-address [source-address]
Syntax Description
group-address
Address of the multicast group. This is a multicast IP address in either IPv4 or IPv6 format.
source-address
(Optional) Source address of the multicast group to include.
Defaults
No multicast group memberships are predefined.
If not specified, include is the default.Command Modes
Router IGMP interface configuration (IPv4)
Router MLD interface configuration (IPv6)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 join-group command permits the IP packets that are addressed to the group address to pass to the IP client process in the Cisco IOS XR software.
If all the multicast-capable routers that you administer are members of a multicast group, pinging that group causes all routers to respond. This command can be a useful administrative and debugging tool.
Another reason to have a router join a multicast group is when other hosts on the network are prevented from correctly answering IGMP or MLD queries. When the router joins the multicast group, upstream devices learn multicast routing table information for that group and keep the paths for that group active.
Caution
Task ID
Examples
In the following example, the router joins multicast group 225.2.2.2:
RP/0/RP0/CPU0:router(config)# router igmpRP/0/RP0/CPU0:router(config-igmp)# interface pos 0/1/0/0RP/0/RP0/CPU0:router(config-igmp-default-if)# join-group 225.2.2.2Related Commands
ping
Checks host reachability and network connectivity on IP networks. For information, see Cisco IOS XR IP Addresses and Services Command Reference.
maximum groups
To configure the maximum number of groups used by Internet Group Management Protocol (IGMP) or Multicast Listener Discovery (MLD) and accepted by a router, use the maximum groups command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.
maximum groups number
no maximum groups
Syntax Description
Defaults
number: 50000
Command Modes
Router IGMP configuration (IPv4)
Router MLD configuration (IPv6)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 maximum combined number of groups on all interfaces can be 75000. After the maximum groups value is met, all additional memberships learned are ignored. The maximum number includes external and local membership.
The following groups obtain local membership on each interface when multicast is enabled and are added into the group totals for each interface: 224.0.0.13 (for Protocol Independent Multicast [PIM]), 224.0.0.22 and 224.0.0.2 (for IGMP).
You cannot use the maximum groups command to configure the maximum number of groups below the number of existing groups. For instance, if the number of groups is 39, and you set the maximum number of groups to 10, the configuration is rejected.
Furthermore, you can use the maximum groups per-interface command to configure the maximum number of groups for each interface accepted by a router.
Task ID
Examples
The following example shows how to display the number of groups (39) and the maximum number of groups configured (50000). Through use of the maximum groups command, a configuration is committed to change the maximum number of groups to 40. Before and after configuration, the show igmp summary command is used to confirm the configuration change:
RP/0/RP0/CPU0:router# show igmp summaryIGMP summaryRobustness Value 2No. of Group x Interfaces 61Maximum number of Group x Interfaces 50000Supported Interfaces : 18Unsupported Interfaces : 2Enabled Interfaces : 18Disabled Interfaces : 2Interface Grp No Max Grp NoMgmtEth0/RP0/CPU0/0 0 25000Loopback0 4 25000Bundle-POS24 3 25000Bundle-Ether28 3 25000Bundle-Ether28.1 3 25000Bundle-Ether28.2 3 25000Bundle-Ether28.3 3 25000MgmtEth0/RP1/CPU0/0 0 25000GigabitEthernet0/1/5/0 3 25000GigabitEthernet0/1/5/1 5 25000GigabitEthernet0/1/5/2 5 25000POS0/1/0/1 5 25000POS0/1/4/2 3 25000GigabitEthernet0/6/5/1 3 25000GigabitEthernet0/6/5/2 3 25000GigabitEthernet0/6/5/7 3 25000POS0/6/0/1 3 25000POS0/6/4/4 3 25000POS0/6/4/5 3 25000POS0/6/4/6 3 25000RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# router igmpRP/0/RP0/CPU0:router(config-igmp)# maximum groups 10RP/0/RP0/CPU0:router(config-igmp)# commit% Failed to commit one or more configuration items during an atomic operation, no changes have been made. Please use 'show configuration failed' to view the errorsRP/0/RP0/CPU0:router# show configuration failed[!! CONFIGURATION FAILED DUE TO SEMANTIC ERRORSrouter igmpmaximum groups 10!!% Invalid argument: The desired new maximum for the number of groups 10 must be equal or larger than the present number of groups, which is 61RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# router igmpRP/0/RP0/CPU0:router(config-igmp)# maximum groups 65RP/0/RP0/CPU0:router(config-igmp)# commitRP/0/RP0/CPU0:May 13 12:26:59.108 : config[65704]: %LIBTARCFG-6-COMMIT : Configuration committed by user 'cisco'. Use 'show commit changes 1000000025' to view the changes.RP/0/RP0/CPU0:router# show igmp summaryRobustness Value 2No. of Group x Interfaces 61Maximum number of Group x Interfaces 65Supported Interfaces : 18Unsupported Interfaces : 2Enabled Interfaces : 18Disabled Interfaces : 2Interface Grp No Max Grp NoMgmtEth0/RP0/CPU0/0 0 25000Loopback0 4 25000Bundle-POS24 3 25000Bundle-Ether28 3 25000Bundle-Ether28.1 3 25000Bundle-Ether28.2 3 25000Bundle-Ether28.3 3 25000MgmtEth0/RP1/CPU0/0 0 25000GigabitEthernet0/1/5/0 3 25000GigabitEthernet0/1/5/1 5 25000GigabitEthernet0/1/5/2 5 25000POS0/1/0/1 5 25000POS0/1/4/2 3 25000GigabitEthernet0/6/5/1 3 25000GigabitEthernet0/6/5/2 3 25000GigabitEthernet0/6/5/7 3 25000POS0/6/0/1 3 25000POS0/6/4/4 3 25000POS0/6/4/5 3 25000POS0/6/4/6 3 25000Related Commands
Configures the maximum number of groups for each interface accepted by a router.
Displays group membership information for IGMP.
Displays group membership information for MLD.
maximum groups-per-interface
To configure the maximum number of groups for each interface accepted by a router, use the maximum groups-per-interface command in the appropriate configuration mode. To return to the default behavior, use the no form of this command.
maximum groups-per-interface number
no maximum groups-per-interface
Syntax Description
Defaults
number: 20000
Command Modes
Router IGMP configuration (IPv4)
Router IGMP interface configuration (IPv4)
Router MLD configuration (IPv6)
Router MLD interface configuration (IPv6)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 following groups obtain local membership on each interface when multicast is enabled and are added into the group totals for each interface: 224.0.0.13 (for Protocol Independent Multicast [PIM]), 224.0.0.22 and 224.0.0.2 (for Internet Group Management Protocol [IGMP]). The number of groups for each interface reflects both external and local group membership.
Note
When you use the maximum groups-per-interface command for a specific interface, it overrides the inheritance property of this command specified under router IGMP or MLD configuration mode.
Task ID
