This chapter describes the commands used to configure and monitor IPv4 multicast protocol on Cisco ASR 9000 Series Routers
.
The commands in this chapter apply to the Internet Group Management Protocol (IGMP), versions 1, 2, and 3.
For detailed information about multicast routing concepts, configuration tasks, and examples, refer to the Implementing Multicast Routing on Cisco IOS XR Software configuration module in Cisco ASR 9000 Series Aggregation Services Router
Multicast Configuration Guide.
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-groupaccess-list
noaccess-groupaccess-list
Syntax Description
access-list
Number or name of a standard IP access list. Range is 1 to 99.
Command Default
No default behavior or values
Command Modes
IGMP interface configuration
Command History
Release
Modification
Release 3.7.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
If this command is not specified in router Internet Group Management Protocol (IGMP) configuration mode, the interface accepts all multicast join requests by hosts.
Task ID
Task ID
Operations
multicast
read, write
Examples
In the following example, hosts serviced by GigabitEthernet interface 0/1/0/1 can join
only group 225.2.2.2:
(Optional) Specifies IPv4 addressing. IPv4 is the default for Internet Group
Management Protocol (IGMP) groups.
vrfvrf-name
(Optional) Specifies a VPN routing and forwarding (VRF) instance.
Command Default
No default behavior or values
Command Modes
EXEC
Command History
Release
Modification
Release 3.7.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
After IGMP statistics are cleared, statistics begin incrementing again.
Task ID
Task ID
Operations
multicast
execute
Examples
The following example shows sample output before and after clearing IGMP traffic
statistics:
RP/0/RSP0/CPU0:router# show igmp traffic
IGMP Traffic Counters
Elapsed time since counters cleared: 00:00:19
Received Sent
Valid IGMP Packets 0 12
Queries 0 3
Reports 0 9
Leaves 0 0
Mtrace packets 0 0
DVMRP packets 0 0
PIM packets 0 0
Errors:
Malformed Packets 0
Bad Checksums 0
Socket Errors 0
Bad Scope Errors 0
Auxiliary Data Len Errors 0
Subnet Errors 0
Packets dropped due to invalid socket 0
Packets which couldn't be accessed 0
Other packets drops 0
RP/0/RSP0/CPU0:router# clear igmp countersRP/0/RSP0/CPU0:router# show igmp traffic
IGMP Traffic Counters
Elapsed time since counters cleared: 00:00:12
Received Sent
Valid IGMP Packets 0 1
Queries 0 1
Reports 0 0
Leaves 0 0
Mtrace packets 0 0
DVMRP packets 0 0
PIM packets 0 0
Errors:
Malformed Packets 0
Bad Checksums 0
Socket Errors 0
Bad Scope Errors 0
Auxiliary Data Len Errors 0
Subnet Errors 0
Packets dropped due to invalid socket 0
Packets which couldn't be accessed 0
Other packets drops 0
(Optional) Specifies IPv4 addressing. IPv4 is the default for IGMP
groups.
vrfvrf-name
(Optional) Specifies a VPN routing and forwarding (VRF) instance.
ip-address
(Optional) IP hostname or group address.
type
(Optional) Interface type. For more information, use the question mark (?)
online help function.
interface-path-id
(Optional) Physical interface or virtual interface.
Note
Use the show interfaces command to see a list
of all interfaces currently configured on the router.
For more information about the syntax for the router, use the question mark
(?) online help function.
Command Default
If no group address is specified, all IGMP groups are cleared.
Command Modes
EXEC
Command History
Release
Modification
Release 3.7.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
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
interface-path-id arguments.
The following groups cannot be cleared:
224.0.0.2
224.0.0.13
224.0.0.22
224.0.0.40
Task ID
Task ID
Operations
multicast
execute
Examples
The following example uses the show igmp groups command to
display the IGMP Connected Group Membership, the clear igmp
group command to clear address 239.1.1.1, and the show igmp
groups command again to display the updated list.
RP/0/RSP0/CPU0:router# show igmp groups tenGigE 0/4/0/0
IGMP Connected Group Membership
Group Address Interface Uptime Expires Last Reporter
224.0.0.2 TenGigE0/4/0/0 3w6d never 10.114.8.44
224.0.0.5 TenGigE0/4/0/0 3w6d never 10.114.8.44
224.0.0.6 TenGigE0/4/0/0 3w6d never 10.114.8.44
224.0.0.13 TenGigE0/4/0/0 3w6d never 10.114.8.44
224.0.0.22 TenGigE0/4/0/0 3w6d never 10.114.8.44
RP/0/RSP0/CPU0:router# clear igmp groups tenGigE 0/4/0/0RP/0/RSP0/CPU0:router# show igmp groups tenGigE 0/4/0/0
IGMP Connected Group Membership
Group Address Interface Uptime Expires Last Reporter
224.0.0.2 TenGigE0/4/0/0 3w6d never 10.114.8.44
224.0.0.5 TenGigE0/4/0/0 3w6d never 10.114.8.44
224.0.0.6 TenGigE0/4/0/0 3w6d never 10.114.8.44
224.0.0.13 TenGigE0/4/0/0 3w6d never 10.114.8.44
224.0.0.22 TenGigE0/4/0/0 3w6d never 10.114.8.44
Displays the multicast groups that are directly connected to the router and that were learned through Internet Group Management Protocol (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.
clearigmp
[ ipv4vrfvrf-name | vrfvrf-name ]
reset
Syntax Description
ipv4
(Optional) Specifies IPv4 addressing. IPv4 is the default for IGMP
groups.
vrfvrf-name
(Optional) Specifies a VPN routing and forwarding (VRF) instance.
Command Default
No default behavior or values
Command Modes
EXEC
Command History
Release
Modification
Release 3.7.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
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
This command is reserved to force synchronization of IGMP and MRIB entries when
communication between the two components is malfunctioning.
Task ID
Task ID
Operations
multicast
execute
Examples
The following example shows how to clear the group memberships in MRIB:
Displays the multicast groups that are directly connected to the router
and that were learned through IGMP
show mrib route
Displays all route entries in the MRIB table.
explicit-tracking
To configure explicit host tracking under Internet Group Management Protocol (IGMP)
Version 3 , 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 ]
noexplicit-tracking
Syntax Description
access-list
(Optional) Access list that specifies the group range for host tracking.
disable
(Optional) Disables explicit host tracking on a specific interface. This
option is available only in interface configuration mode.
Command Default
If this command is not specified in IGMP configuration mode, then
explicit host tracking is disabled.
Command Modes
IGMP VRF configuration
IGMP interface configuration
Command History
Release
Modification
Release 3.7.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
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 explicit tracking for all
interfaces, use the no form of the command from IGMP configuration mode. To
disable the feature on specific interfaces, use the
explicit-tracking command in interface configuration mode
with the disable keyword, as shown in the following example.
Note
If you configure this command in IGMP VRF configuration mode,
parameters are inherited by all new and existing interfaces. However, you can
override these parameters on individual interfaces from IGMP interface
configuration mode.
Task ID
Task ID
Operations
multicast
read, write
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
GigabitEthernet interface:
Displays the multicast groups that are directly connected to the router and that were learned through Multicast Listener Discovery (MLD).
join-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-groupgroup-address [source-address]
nojoin-groupgroup-address [source-address]
Syntax Description
group-address
Address of the multicast group. This is a multicast IP address group in IPv4 format
IP address as defined in the
Domain Name System (DNS) hosts table or with the domain IPv4 host in the
format A.B.C.D.
source-address
(Optional) Source address of the multicast group to include in IPv4 prefixing
format
IP address as defined in the
Domain Name System (DNS) hosts table or with the domain IPv4 host in the
format A.B.C.D.
Command Default
No multicast group memberships are predefined. If not specified, include is the
default.
Command Modes
IGMP interface configuration
Command History
Release
Modification
Release 3.7.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
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 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
Joining a multicast group can result in a significant performance impact, because all
subscribed multicast packets are punted to the route processor.
Task ID
Task ID
Operations
multicast
read, write
Examples
In the following example, the router joins multicast group 225.2.2.2:
The join-group command can
have an include/exclude mode for IGMPv3 interfaces as shown in the following
example:
RP/0/RSP0/CPU0:router(config)#router igmp
RP/0/RSP0/CPU0:router(config-igmp)#int gigabitEthernet 0/5/0/1 RP/0/RSP0/CPU0:router(config-igmp-default-if)#join-group ?
A.B.C.D IP group address
RP/0/RSP0/CPU0:router(config-igmp-default-if)#join-group 225.0.0.0 ?
A.B.C.D Source address to include
exclude Exclude the only following source address include Include only the following source address <cr>
RP/0/RSP0/CPU0:router(config-igmp-default-if)#join-group 225.0.0.0 10.10.10.10 ?
<cr>
RP/0/RSP0/CPU0:router(config-igmp-default-if)#join-group 225.0.0.0 ?
A.B.C.D Source address to include
exclude Exclude the only following source address
include Include only the following source address <cr>
RP/0/RSP0/CPU0:router(config-igmp-default-if)#join-group 225.0.0.0
Related Commands
Command
Description
ping
Checks host reachability and network connectivity on IP networks. For
information, see
Cisco ASR 9000 Series
Aggregation Services Router IP Addresses and Services Command
Reference.
maximum groups
To configure the maximum number of groups used by Internet Group Management Protocol
(IGMP) 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.
maximumgroupsnumber
nomaximumgroups
Syntax Description
number
Maximum number of groups accepted by a router. Range is 1 to 75000.
Command Default
number: 50000
Command Modes
IGMP configuration
IGMP VRF configuration
Command History
Release
Modification
Release 3.7.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
When configuring this command within IGMP VRF configuration mode, you may either use the
default (unspecified) VRF or a specific VRF by specifying its name.
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 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.
Although Cisco IOS XR SoftwareRelease 3.9.0 supports 40,000 groups per interface, the ASR9000 router supports a maximum of 16,000
multicast routes per system.
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
Task ID
Operations
multicast
read, write
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/RSP0/CPU0:router# show igmp summary
IGMP summary
Robustness Value 2
No. of Group x Interfaces 61
Maximum number of Group x Interfaces 50000
Supported Interfaces : 18
Unsupported Interfaces : 2
Enabled Interfaces : 18
Disabled Interfaces : 2
Interface Grp No Max Grp No
MgmtEth0/RSP0/CPU0/0 0 25000
Loopback0 4 25000
Bundle-Ether24 3 25000
Bundle-Ether28 3 25000
Bundle-Ether28.1 3 25000
Bundle-Ether28.2 3 25000
Bundle-Ether28.3 3 25000
MgmtEth0/RP1/CPU0/0 0 25000
GigabitEthernet0/1/5/0 3 25000
GigabitEthernet0/1/5/1 5 25000
GigabitEthernet0/1/5/2 5 25000
GigabitEthernet0/1/0/1 5 25000
GigabitEthernet0/1/4/2 3 25000
GigabitEthernet0/6/5/1 3 25000
GigabitEthernet0/6/5/2 3 25000
GigabitEthernet0/6/5/7 3 25000
GigabitEthernet0/6/0/1 3 25000
GigabitEthernet0/6/4/4 3 25000
GigabitEthernet0/6/4/5 3 25000
GigabitEthernet0/6/4/6 3 25000
RP/0/RSP0/CPU0:router# configureRP/0/RSP0/CPU0:router(config)# router igmpRP/0/RSP0/CPU0:router(config-igmp)# maximum groups 65RP/0/RSP0/CPU0:router(config-igmp)# commitRP/0/RSP0/CPU0:router: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/RSP0/CPU0:router# show igmp summary
Robustness Value 2
No. of Group x Interfaces 61
Maximum number of Group x Interfaces 65
Supported Interfaces : 18
Unsupported Interfaces : 2
Enabled Interfaces : 18
Disabled Interfaces : 2
Interface Grp No Max Grp No
MgmtEth0/RSP0/CPU0/0 0 25000
Loopback0 4 25000
Bundle-Ether28 3 25000
Bundle-Ether28.1 3 25000
Bundle-Ether28.2 3 25000
Bundle-Ether28.3 3 25000
MgmtEth0/RP1/CPU0/0 0 25000
GigabitEthernet0/1/5/0 3 25000
GigabitEthernet0/1/5/1 5 25000
GigabitEthernet0/1/5/2 5 25000
GigabitEthernet0/6/5/1 3 25000
GigabitEthernet0/6/5/2 3 25000
GigabitEthernet0/6/5/7 3 25000
Displays group membership information for Multicast Listener Discovery (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.
maximumgroups-per-interfacenumber
nomaximumgroups-per-interface
Syntax Description
number
Maximum number of groups accepted by a router for each interface.
Range is 1 to 16000.
Command Default
number: 20000
Command Modes
IGMP configuration
IGMP VRF configuration
IGMP interface configuration
Command History
Release
Modification
Release 3.7.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
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
You cannot use the maximum groups-per-interface command to
configure the maximum number of groups for each interface below the number of
existing groups on an interface. For example, if the number of groups is 39, and you
set the maximum number of groups to 10, the configuration is rejected.
When you use the maximum groups-per-interface command for a
specific interface, it overrides the inheritance property of this command specified
under IGMP configuration
mode.
Task ID
Task ID
Operations
multicast
read, write
Examples
The following example shows how to display the maximum number of groups for each
interface. A configuration is committed to change the maximum number of groups for each
interface to 12. Before and after configuration, use the show igmp
summary command to confirm the configuration change:
RP/0/RSP0/CPU0:router# show igmp summary
IGMP summary
Robustness Value 2
No. of Group x Interfaces 61
Maximum number of Group x Interfaces 50000
Supported Interfaces : 18
Unsupported Interfaces : 2
Enabled Interfaces : 18
Disabled Interfaces : 2
Interface Grp No Max Grp No
MgmtEth0/RSP0/CPU0/0 0 25000
Loopback0 4 25000
Bundle-Ether28 3 25000
Bundle-Ether28.1 3 25000
Bundle-Ether28.2 3 25000
Bundle-Ether28.3 3 25000
MgmtEth0/RP1/CPU0/0 0 25000
GigabitEthernet0/1/5/0 3 25000
GigabitEthernet0/1/5/1 5 25000
GigabitEthernet0/1/5/2 5 25000
GigabitEthernet0/6/5/1 3 25000
GigabitEthernet0/6/5/2 3 25000
GigabitEthernet0/6/5/7 3 25000
RP/0/RSP0/CPU0:router# configureRP/0/RSP0/CPU0:router(config)# router igmpRP/0/RSP0/CPU0:router(config-igmp)# maximum groups-per-interface 5RP/0/RSP0/CPU0:router(config-igmp)# commitRP/0/RSP0/CPU0:router# show igmp summary
Robustness Value 2
No. of Group x Interfaces 61
Maximum number of Group x Interfaces 65
Supported Interfaces : 18
Unsupported Interfaces : 2
Enabled Interfaces : 18
Disabled Interfaces : 2
Interface Grp No Max Grp No
MgmtEth0/RSP0/CPU0/0 0 5
Loopback0 4 5
Bundle-Ether28 3 5
Bundle-Ether28.1 3 5
Bundle-Ether28.2 3 5
Bundle-Ether28.3 3 5
MgmtEth0/RP1/CPU0/0 0 5
GigabitEthernet0/1/5/0 3 5
GigabitEthernet0/1/5/1 5 5
GigabitEthernet0/1/5/2 5 5
GigabitEthernet0/6/5/1 3 5
GigabitEthernet0/6/5/2 3 5
GigabitEthernet0/6/5/7 3 5
The following example shows how to configure all
interfaces with 3000 maximum groups per interface except GigabitEthernet interface
0/4/0/0, which is set to 4000:
RP/0/RSP0/CPU0:router# configureRP/0/RSP0/CPU0:router(config)# router igmpRP/0/RSP0/CPU0:router(config-igmp)# maximum groups-per-interface 3000RP/0/RSP0/CPU0:router(config-igmp)# interface GigabitEthernet 0/4/0/0RP/0/RSP0/CPU0:router(config-igmp-default-if)# maximum groups-per-interface 4000
IGMP summary
Robustness Value 2
No. of Group x Interfaces 61
Maximum number of Group x Interfaces 50000
Supported Interfaces : 18
Unsupported Interfaces : 2
Enabled Interfaces : 18
Disabled Interfaces : 2
Interface Grp No Max Grp No
MgmtEth0/RP0/CPU0/0 0 25000
Loopback0 4 25000
Bundle-POS24 3 25000
Bundle-Ether28 3 25000
Bundle-Ether28.1 3 25000
Bundle-Ether28.2 3 25000
Bundle-Ether28.3 3 25000
MgmtEth0/RP1/CPU0/0 0 25000
GigabitEthernet0/1/5/0 3 25000
GigabitEthernet0/1/5/1 5 25000
GigabitEthernet0/1/5/2 5 25000
POS0/1/0/1 5 25000
POS0/1/4/2 3 25000
GigabitEthernet0/6/5/1 3 25000
GigabitEthernet0/6/5/2 3 25000
GigabitEthernet0/6/5/7 3 25000
POS0/6/0/1 3 25000
POS0/6/4/4 3 25000
POS0/6/4/5 3 25000
POS0/6/4/6 3 25000
RP/0/RSP0/CPU0:router# configureRP/0/RSP0/CPU0:router(config)# router igmpRP/0/RSP0/CPU0:router(config-igmp)# maximum groups-per-interface 5RP/0/RSP0/CPU0:router(config-igmp)# commitRP/0/RSP0/CPU0:router# show igmp summary
Robustness Value 2
No. of Group x Interfaces 61
Maximum number of Group x Interfaces 65
Supported Interfaces : 18
Unsupported Interfaces : 2
Enabled Interfaces : 18
Disabled Interfaces : 2
Interface Grp No Max Grp No
MgmtEth0/RP0/CPU0/0 0 5
Loopback0 4 5
Bundle-POS24 3 5
Bundle-Ether28 3 5
Bundle-Ether28.1 3 5
Bundle-Ether28.2 3 5
Bundle-Ether28.3 3 5
MgmtEth0/RP1/CPU0/0 0 5
GigabitEthernet0/1/5/0 3 5
GigabitEthernet0/1/5/1 5 5
GigabitEthernet0/1/5/2 5 5
POS0/1/0/1 5 5
POS0/1/4/2 3 5
GigabitEthernet0/6/5/1 3 5
GigabitEthernet0/6/5/2 3 5
GigabitEthernet0/6/5/7 3 5
POS0/6/0/1 3 5
POS0/6/4/4 3 5
POS0/6/4/5 3 5
POS0/6/4/6 3 5
RP/0/RSP0/CPU0:router# configureRP/0/RSP0/CPU0:router(config)# router igmpRP/0/RSP0/CPU0:router(config-igmp)# maximum groups-per-interface 3000RP/0/RSP0/CPU0:router(config-igmp)# interface POS 0/4/0/0RP/0/RSP0/CPU0:router(config-igmp-default-if)# maximum groups-per-interface 4000
Displays group membership information for Multicast Listener Discovery (MLD).
nsf lifetime (IGMP)
To configure the maximum time for the nonstop forwarding (NSF) timeout on the Internet
Group Management Protocol (IGMP) process, use the nsf
lifetime command in the appropriate configuration mode. To return to
the default behavior, use the no form of this command.
nsflifetimeseconds
nonsflifetime
Syntax Description
seconds
Maximum time for NSF mode. Range is 10 to 3600 seconds.
Command Default
seconds: 60
Command Modes
IGMP configuration
IGMP VRF configuration
Command History
Release
Modification
Release 3.7.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The IGMP NSF process is triggered by the restart of the IGMP process. While in IGMP NSF
mode, the Multicast Routing Information Base (MRIB) purges the routes installed by the
previous IGMP process when the IGMP NSF process times out.
The IGMP NSF lifetime is the period for IGMP to relearn all the host membership of the
attached network through membership queries and reports. During this NSF period, PIM
continues to maintain forwarding state for the local members while IGMP recovers their
membership reports.
Additionally, IGMP recovers the internal receiver state from Local Packet Transport
Services (LPTS) for IP group member applications (including the Session
Announcement Protocol (SAP) Listener) and updates the MRIB.
Task ID
Task ID
Operations
multicast
read, write
Examples
The following example shows how to set the IGMP NSF timeout value to 120 seconds:
Displays the state of NSF operation for the MFIB line cards.
query-interval
To configure the frequency at which the Cisco IOS XR Software sends Internet Group Management Protocol (IGMP) host-query messages, use the queryinterval command in the
appropriate configuration mode. To return to the default frequency, use the no
form of this command.
query-intervalseconds
noquery-interval
Syntax Description
seconds
Frequency used to send IGMP host-query messages. Range is 1 to 3600.
Command Default
If this command is not specified in interface configuration mode, the interface adopts
the query interval parameter specified in IGMP configuration mode.
If this command is not specified in IGMP configuration mode, the
query interval time is 60 seconds.
Command Modes
IGMP VRF configuration
IGMP interface configuration
Command History
Release
Modification
Release 3.7.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Multicast routers send host membership query messages (host-query messages) to discover
which multicast groups have members on the attached networks of the router. Hosts
respond with IGMP report
messages indicating that they want to receive multicast packets for specific groups
(that is, that the host wants to become a member of the group). Host-query messages are
addressed to the all-hosts multicast group, which has the address 224.0.0.1, and has an
IP time-to-live (TTL) value of 1.
The designated router for a LAN is the only router that sends IGMP host-query messages:
For IGMP Version 1 (only), the designated
router is elected according to the multicast routing protocol that runs on the LAN.
For IGMP Versions 2 and 3, , the
designated querier is the lowest IP-addressed multicast router on the subnet.
If the router hears no queries for the timeout period (controlled by the query-timeout command), it becomes the querier.
Note
Changing the value of the seconds argument may severely
impact network performance. A short query interval may increase the amount of traffic
on the attached network, and a long query interval may reduce the querier convergence
time.
Note
If you configure the query-interval command in IGMP configuration mode,
parameters are inherited by all new and existing interfaces. You can override these
parameters on individual interfaces from interface configuration mode.
Task ID
Task ID
Operations
multicast
read, write
Examples
This example shows how to change the frequency at which the designated router
sends IGMP host-query messages to 2 minutes:
Displays the multicast groups that are directly connected to the router
and that were learned through IGMP.
query-max-response-time
To configure the maximum response time advertised in Internet Group Management Protocol
(IGMP) queries, use the querymax-response-time command
in the appropriate configuration mode. To return to the default behavior, use the
no form of this command.
query-max-response-timeseconds
noquery-max-response-time
Syntax Description
seconds
Maximum response time, in seconds, advertised in IGMP queries. Range
is 1 to 12.
Command Default
If this command is not specified in interface configuration mode, the interface adopts
the maximum response time parameter specified in IGMP configuration mode.
If this command is not specified in IGMP configuration mode, the
maximum response time is 10 seconds.
Command Modes
IGMP VRF configuration
IGMP interface configuration
Command History
Release
Modification
Release 3.7.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The query-max-response-time command is not supported on IGMP
Version 1.
This command is used to control the maximum response time for hosts to answer an IGMP
query message.
Configuring a value less than 10 seconds enables the router to prune groups much faster,
but this action results in network burstiness because hosts are restricted to a shorter
response time period.
If you configure this command in IGMP configuration mode, parameters are inherited by all new and existing
interfaces. You can override these parameters on individual interfaces in interface
configuration mode.
Note
If the hosts do not read the maximum response time in the query message correctly,
group membership might be pruned inadvertently. Therefore, the hosts must know to
respond faster than 10 seconds (or the value you configure).
Task ID
Task ID
Operations
multicast
read, write
Examples
The following example shows how to configure a maximum response time of 8 seconds:
Displays the multicast groups that are directly connected to the router
and that were learned through IGMP.
query-timeout
To configure the timeout value before the router takes over as the querier for the
interface, use the query-timeout command in the appropriate
configuration mode. To return to the default behavior, use the no form of this
command.
query-timeoutseconds
noquery-timeout
Syntax Description
seconds
Number of seconds that the router waits after the previous querier has
stopped querying before it takes over as the querier. Range is 60 to
300.
Command Default
If this command is not specified in interface configuration mode, the interface adopts
the timeout value parameter specified in IGMP VRF configuration mode. If this command is
not specified in IGMP VRF configuration mode, the maximum response time is equal to
twice the query interval set by the query-interval
command.
Command Modes
IGMP VRF configuration
IGMP interface configuration
Command History
Release
Modification
Release 3.7.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The query timeout command is not supported on Internet Group
Management Protocol (IGMP) Version 1.
By default, the router waits twice the query interval specified by the
query-interval command, after which, if the router has
heard no queries, it becomes the querier. By default, the query interval is 60 seconds,
which means that the query timeout value defaults to
120 seconds.
If you configure a query timeout value less than twice the query interval, routers in
the network may determine a query timeout and take over the querier without good
reason.
Note
If you configure this command in IGMP configuration mode,
parameters are inherited by all new and existing interfaces. You can override these
parameters on individual interfaces in interface configuration mode.
Task ID
Task ID
Operations
multicast
read, write
Examples
The following example shows how to configure the router to wait 30 seconds from the time
it received the last query before it takes over as the querier for the interface:
Configures the frequency at which the Cisco IOS XR Software sends Internet Group Management Protocol (IGMP) host-query messages.
robustness-count
To set the robustness variable to tune for expected packet loss on a network, use the
robustness-count command in the appropriate
configuration mode. To return to the default setting, use the no form of this
command.
robustness-countcount
norobustness-count
Syntax Description
count
Value of the robustness count variable. Range is 2 to 10 packets.
Command Default
Default is 2 packets.
Command Modes
IGMP VRF configuration
IGMP interface configuration
Command History
Release
Modification
Release 3.7.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
IGMP is a soft-state protocol. State must be periodically refreshed or it times out. At
a robustness-count command setting, for example, of 4, a
network might lose three IGMP packets related to some specific state yet still maintain
the state. If, however, a network lost more than three IGMP packets in the sequence, the
state would time out. You might then consider changing the
robustness-count setting to maintain state.
Task ID
Task ID
Operations
multicast
read, write
Examples
The following example illustrates the use of the
robustness-count command:
To disable or enable Internet Group Management Protocol (IGMP) membership tracking, use the router command in the
appropriate configuration mode. To return to the default behavior, use the no
form of this command.
router
{ disable | enable }
norouter
{ disable | enable }
Syntax Description
disable
Turns off IGMP membership tracking.
enable
Turns on IGMP membership tracking.
Command Default
If this command is not specified in IGMP VRF configuration mode, router functionality is
enabled on all interfaces.
Command Modes
IGMP interface configuration
Command History
Release
Modification
Release 3.7.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The router command is used to enable and disable the IGMP router functionality on a
specific interface. For instance, IGMP stops queries from an interface when the router functionality is
disabled on that interface. Disabling IGMP router functionality does
not prevent local group membership from being announced through the group membership
report.
Note
This command is useful if you want to disable or enable IGMP interfaces that have
been previously enabled through the multicast-routing
command.
Task ID
Task ID
Operations
multicast
read, write
Examples
The following example shows how to enable IGMP membership tracking functionality on all
multicast enabled interfaces, except Packet-over-SONET/SDH (POS) interface 0/1/0/0:
Enables multicast routing and forwarding on all enabled interfaces of the
router and enters multicast routing configuration mode.
router igmp
To enter Internet Group Management Protocol (IGMP) configuration mode, use the
router igmp command in global configuration mode. To
return to the default behavior, use the no form of this command.
routerigmp
norouterigmp
Syntax Description
This command has no keywords or arguments.
Command Default
No default behavior or values
Command Default
Global configuration
Command History
Release
Modification
Release 3.7.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
From IGMP VRF configuration mode, you can configure the maximum response time advertised
in IGMP queries and modify the host query interval.
Note
The IGMP process is turned on when the router igmp command
or the multicast-routing command is initiated.
Task ID
Task ID
Operations
multicast
read, write
Examples
The following example shows how to enter IGMP configuration mode:
Disables IGMP membership tracking on all interfaces.
multicast routing
Enables multicast routing and forwarding on all enabled interfaces of the
router and enters multicast routing configuration mode.
show igmp groups
To display the multicast groups that are directly connected to the router and that were
learned through Internet Group Management Protocol (IGMP), use the show igmp
groups command in EXEC mode.
(Optional) Specifies a VPN routing and forwarding (VRF) instance.
group-address
(Optional) Address or name of the multicast group. An address is a multicast
IP address in four-part dotted-decimal notation. A name is as defined in the
Domain Name System (DNS) hosts table.
type
(Optional) Interface type. For more information, use the question mark (?)
online help function.
interface-path-id
(Optional) Either a physical interface or a virtual interface.
Note
Use the show interfaces command in EXEC mode to
see a list of all interfaces currently configured on the router.
For more information about the syntax for the router, use the question mark
(?) online help function.
not-active
(Optional) Displays group joins that are not processed.
summary
(Optional) Displays the total number of (* , G) and (S, G) states in
IGMP.
detail
(Optional) Displays detail information such as IGMP Version 3 source list,
host, and router mode.
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
If you omit all optional arguments, the show igmp groups
command displays (by group address and interface name) all the multicast memberships
that the directly connected networks have subscribed.
Task ID
Task ID
Operations
multicast
read
Examples
The following is sample output from the show igmp groups
command on a specific (tenGigE) interface:
RP/0/RSP0/CPU0:router# show igmp groups tenGigE 0/4/0/0
IGMP Connected Group Membership
Group Address Interface Uptime Expires Last Reporter
224.0.0.2 TenGigE0/4/0/0 3w6d never 10.114.8.44
224.0.0.5 TenGigE0/4/0/0 3w6d never 10.114.8.44
224.0.0.6 TenGigE0/4/0/0 3w6d never 10.114.8.44
224.0.0.13 TenGigE0/4/0/0 3w6d never 10.114.8.44
224.0.0.22 TenGigE0/4/0/0 3w6d never 10.114.8.44
This table
describes
the significant fields shown in the display.
Table 1 show igmp groups Field Descriptions
Field
Description
Group Address
Address of the multicast group.
Interface
Interface through which the group is reachable.
Uptime
How long (in hours, minutes, and seconds) this multicast group has been
known.
Expires
How long (in hours, minutes, and seconds) until the entry is removed from
the IGMP groups table.
Last Reporter
Last host to report being a member of the multicast group.
Displays Internet Group Management Protocol (IGMP) multicast-related information about an interface.
show igmp interface
To display Internet Group Management Protocol (IGMP) multicast-related information about
an interface, use the show igmp interface command in EXEC
mode.
(Optional) Specifies a VPN routing and forwarding (VRF) instance.
type
(Optional) Interface type. For more information, use the question mark (?)
online help function.
interface-path-id
(Optional) Either a physical interface or a virtual interface.
Note
Use the show interfaces command in EXEC mode to
see a list of all interfaces currently configured on the router.
For more information about the syntax for the router, use the question mark
(?) online help function.
state-on
(Optional) Displays all interfaces with IGMP enabled.
state-off
(Optional) Displays all interfaces with IGMP disabled.
Command Default
No default behavior or values
Command Modes
EXEC
Command History
Release
Modification
Release 3.7.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
If you omit the optional arguments, the show igmp interface
command displays information about all interfaces.
Task ID
Task ID
Operations
multicast
read
Examples
The following is sample output from the show igmp interface
command:
RP/0/RSP0/CPU0:router# show igmp interface
Loopback0 is up, line protocol is up
Internet address is 10.144.144.144/32
IGMP is enabled on interface
Current IGMP version is 3
IGMP query interval is 60 seconds
IGMP querier timeout is 125 seconds
IGMP max query response time is 10 seconds
Last member query response interval is 1 seconds
IGMP activity: 3 joins, 0 leaves
IGMP querying router is 10.144.144.144 (this system)
TenGigE0/4/0/0 is up, line protocol is up
Internet address is 10.114.8.44/24
IGMP is enabled on interface
Current IGMP version is 3
IGMP query interval is 60 seconds
IGMP querier timeout is 125 seconds
IGMP max query response time is 10 seconds
Last member query response interval is 1 seconds
IGMP activity: 9 joins, 4 leaves
IGMP querying router is 10.114.8.11
Bundle-Ether16.162 is up, line protocol is up
Internet address is 10.194.8.44/24
IGMP is disabled on interface
Bundle-Ether16.163 is up, line protocol is up
Internet address is 10.194.12.44/24
IGMP is disabled on interface
GigabitEthernet0/1/0/2 is up, line protocol is up
Internet address is 10.147.4.44/24
IGMP is enabled on interface
Current IGMP version is 3
IGMP query interval is 60 seconds
IGMP querier timeout is 125 seconds
IGMP max query response time is 10 seconds
Last member query response interval is 1 seconds
IGMP activity: 6 joins, 0 leaves
IGMP querying router is 10.147.4.44 (this system)
GigabitEthernet0/1/0/8 is up, line protocol is up
Internet address is 10.146.4.44/24
IGMP is enabled on interface
Current IGMP version is 3
IGMP query interval is 60 seconds
IGMP querier timeout is 125 seconds
IGMP max query response time is 10 seconds
Last member query response interval is 1 seconds
IGMP activity: 5 joins, 0 leaves
IGMP querying router is 10.146.4.44 (this system)
GigabitEthernet0/1/0/18 is up, line protocol is up
Internet address is 10.194.4.44/24
IGMP is enabled on interface
Current IGMP version is 3
IGMP query interval is 60 seconds
IGMP querier timeout is 125 seconds
IGMP max query response time is 10 seconds
Last member query response interval is 1 seconds
IGMP activity: 7 joins, 2 leaves
IGMP querying router is 10.194.4.19
GigabitEthernet0/1/0/23 is up, line protocol is up
Internet address is 10.114.4.44/24
IGMP is enabled on interface
Current IGMP version is 3
IGMP query interval is 60 seconds
IGMP querier timeout is 125 seconds
IGMP max query response time is 10 seconds
Last member query response interval is 1 seconds
IGMP activity: 9 joins, 4 leaves
IGMP querying router is 10.114.4.11
GigabitEthernet0/1/0/27 is up, line protocol is up
Internet address is 10.145.4.44/24
IGMP is enabled on interface
Current IGMP version is 3
IGMP query interval is 60 seconds
IGMP querier timeout is 125 seconds
IGMP max query response time is 10 seconds
Last member query response interval is 1 seconds
IGMP activity: 7 joins, 2 leaves
IGMP querying router is 10.145.4.44 (this system)
This table
describes the
significant fields shown in the display.
Table 2 show igmp interface Field Descriptions
Field
Description
Loopback0 is up, line protocol is up
Interface type, number, and status.
Internet address is
Internet address of the interface and subnet mask being applied to the
interface, as specified with the address
command.
IGMP is enabled on interface
Indicates whether IGMP router functionality has been enabled on the
interface.
Note
Multicast protocols do not run on Management Ethernet interfaces even
if they are enabled with the CLI.
IGMP query interval is 60 seconds
Interval at which the Cisco IOS XR software software sends Protocol Independent
Multicast (PIM) query messages, as specified with the
query-interval command.
IGMP querier timeout is...
Timeout that is set by nonquerier routers. When this timeout expires, the
nonquerier routers begin to send queries.
IGMP max query response time is...
Query response time, in seconds, that is used by administrators to tune
the burstiness of IGMP messages on the network. This is the maximum time
within which a response to the query is received.
Last member query response is...
Query response time in seconds since a host replied to a query that was
sent by the querier.
IGMP activity:
Total number of joins and total number of leaves received.
IGMP querying router is 239.122.41.51 (this system)
Indicates the elected querier on the link.
Related Commands
Command
Description
address
Sets a primary or secondary IP address for an interface.
To display the state of the nonstop forwarding (NSF) operation in Internet Group
Management Protocol (IGMP), use the show igmp nsf command in
EXEC mode.
showigmp
[ vrfvrf-name ]
nsf
Syntax Description
old-output
(Optional) Displays the old show output—available for backward
compatibility.
vrfvrf-name
(Optional) Specifies a VPN routing and forwarding (VRF) instance.
Command Default
No default behavior or values
Command Modes
EXEC
Command History
Release
Modification
Release 3.7.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The show igmp nsf command displays the current multicast NSF
state for IGMP. The NSF state that is displayed may be either normal or activated for
NSF. The activated state indicates that recovery is in progress due to an IGMP failure.
The total NSF timeout and time remaining are displayed until NSF expiration.
Task ID
Task ID
Operations
multicast
read
Examples
The following is sample output from the show igmp nsf
command:
RP/0/RSP0/CPU0:router# show igmp nsf IGMP_AFD
Non-Stop Forwarding Status: Multicast routing state: Normal
NSF Lifetime
: 00:01
:00
This table describes the
significant fields shown in the display.
Table 3 show igmp nsf Field Descriptions
Field
Description
Multicast routing state
Multicast NSF status of IGMP (Normal or Non-Stop Forwarding
Activated).
NSF Lifetime
Timeout for IGMP NSF. IGMP remains in the NSF state, recovering the IGMP
route state through IGMP reports for this period of time, before making
the transition back to the normal state and signaling the Multicast
Routing Information Base (MRIB).
NSF Time Remaining
If IGMP NSF state is activated, the time remaining until IGMP reverts to
Normal mode displays.
Related Commands
Command
Description
nsf (multicast)
Enables NSF capability for the multicast routing system.
Configures the NSF timeout value for the IGMP or MLD process.
Configures the NSF timeout value
for the IGMP process.
nsf lifetime (PIM)
Configures the NSF timeout value for the PIM process.
show mfib nsf
Displays the state of NSF operation for the MFIB line cards.
show mrib nsf
Displays the state of NSF operation in the MRIB.
show pim nsf
Displays the state of NSF operation for PIM.
show igmp summary
To display group membership information for Internet Group Management Protocol (IGMP),
use the show igmp summary command in EXEC mode.
showigmp
[ vrfvrf-name ]
summary
Syntax Description
old-output
(Optional) Displays the old show output—available for backward
compatibility.
vrfvrf-name
(Optional) Specifies a VPN routing and forwarding (VRF) instance.
Command Default
No default behavior or values
Command Modes
EXEC
Command History
Release
Modification
Release 3.7.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The show igmp summary command is used to display the total
group membership. The value for number of groups is the total number of group members on
all interfaces. The value for maximum number of groups is the total number of external
and local members possible for all interfaces. The maximum number of groups and the
default value for the maximum number of groups is 50000 members. The maximum number of
groups for each interface, and the default value for the maximum number of groups for
each interface, is 25000 members.
Task ID
Task ID
Operations
multicast
read
Examples
The following example shows the number of groups for each interface that are IGMP
members and the maximum number of groups that can become members on each interface:
RP/0/RSP0/CPU0:router# show igmp summary
IGMP summary
Robustness Value 2
No. of Group x Interfaces 61
Maximum number of Group x Interfaces 65
Supported Interfaces : 18
Unsupported Interfaces : 2
Enabled Interfaces : 18
Disabled Interfaces : 2
Interface Grp No Max Grp No
Bundle-Ether28.1 3 5
MgmtEth0/RSP0/CPU0/0 0
5
Loopback0 4
5
MgmtEth0/RP1/CPU0/0 0 5
Bundle-Ether28
3 5
Bundle-Ether28 3
5
Bundle-Ether28.1 3
5
Bundle-Ether28.2 3
5
Bundle-Ether28.3
3 5
MgmtEth0
/RP1
/CPU0
/0 0
5
GigabitEthernet0/1
/5/0
3 5
GigabitEthernet0/1
/5/1 5
5
GigabitEthernet0
/1
/5
/2 5
5
GigabitEthernet0
/6/5
/1
3 5
GigabitEthernet0
/6/5
/2
3 5
GigabitEthernet0
/6/5
/7
3 5
This table
describes the
significant fields shown in the display.
Table 4 show igmp summary Field Descriptions
Field
Description
No. of Group x Interfaces
Number of multicast groups that are joined through the interface.
Maximum number of Group x Interfaces
Maximum number of multicast groups that can be joined through the
interface.
Supported Interfaces
Interfaces through which the multicast groups are reachable.
(Optional) Specifies a VPN routing and forwarding (VRF) instance to be
queried.
vrf-name
(Optional) Specifies the name of the specific VRF instance.
group-address
(Optional) Specifies the address of the SSM group for which to obtain the
mapping state.
detail
(Optional) Displays detailed source information.
Command Default
No default behavior or values
Command Modes
EXEC
Command History
Release
Modification
Release 3.7.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
Task ID
Task ID
Operations
multicast
read
Examples
The following example illustrates the use of the show igmp ssm
map command:
RP/0/RSP0/CPU0:router# show igmp ssm map 232.1.1.1
232.1.1.1 is static with 1 source
show igmp traffic
To display all the Internet Group Management Protocol (IGMP) traffic-related counters,
use the show igmp traffic command in EXEC mode.
showigmp
[ vrfvrf-name ]
traffic
Syntax Description
vrfvrf-name
(Optional) Specifies a VPN routing and forwarding (VRF) instance.
Command Default
No default behavior or values
Command Modes
EXEC
Command History
Release
Modification
Release 3.7.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
The show igmp traffic command is used to display the state of
all counters for IGMP traffic. It gives information about the length of time the
counters have been active and the count of different types of IGMP packets received,
such as queries, leaves, and reports. Also, this command keeps a count of all the
erroneous IGMP packets received.
Task ID
Task ID
Operations
multicast
read
Examples
The following is sample output from the show igmp traffic
command:
RP/0/RSP0/CPU0:router# show igmp traffic
IGMP Traffic Counters
Elapsed time since counters cleared: 15:27:38
Received Sent
Valid IGMP Packet 2784 5576
Queries 0 2784
Reports 2784 2792
Leaves 0 0
Mtrace packets 0 0
DVMRP packets 0 0
PIM packets 0 0
Errors:
Malformed Packets 0
Bad Checksums 0
Socket Errors 0
Bad Scope Errors 0
Auxiliary Data Len Error 0
Subnet Errors 0
Packets dropped due to invalid socket 0
Packets which couldn’t be accessed 0
This table
describes the significant fields shown in the display for the show
igmptraffic command.
Table 5 show igmp traffic Field Descriptions
Field
Description
Valid IGMP
Packet
Total number of valid protocol packets sent and received. Valid packet
types include:
Queries
Membership reports
Leaves
Queries
Total number of query packets sent and received. IP Multicast routers
send queries to determine the multicast reception state of neighboring
interfaces.
Reports
Total number of membership report packets received. Membership reports
indicate either the current multicast reception state of a neighboring
interface or a change to that state.
Leaves
Total number of leaves received. A leave group packet indicates a neighboring
interface no longer has multicast reception state for a particular
group.
Mtrace packets
Total
number of Mtrace packets sent and received. Mtrace traces the route from
a receiver to a source using a particular multicast address.
DVMRP packets
Total
number of Distance Vector Multicast Routing Protocol (DVMRP) packets sent
and received. DVMRP is an Internet routing protocol that provides a
mechanism for connectionless datagram delivery to a group of hosts across
an internetwork. This protocol dynamically generates IP multicast
delivery trees using Reverse Path Multicasting. Packet type 0x13
indicates a DVMRP packet.
PIM packets
Total
number of sent and received Protocol Independent Multicast (PIM)
packets.
Malformed Packets
Total number of malformed packets received. A malformed packet is a
packet smaller than the smallest valid protocol packet.
Bad Checksums
Total number of packets received with a bad protocol header checksum.
Socket Errors
Total number of read and write failures on the protocol socket.
Bad Scope Errors
Total number of packets received with an invalid multicast scope.
Note
IGMP has no invalid scopes; this counter, therefore, never increments
in IGMP.
Auxiliary Data Len Errors
Total number of packets received with a non-zero auxilary data
length.
Subnet Errors
Total number of packets received that were not sourced on the same subnet
as the router. DVMRP and MTRACE packets received are not checked for this
error as they may be validly sourced from a different subnet.
Packets dropped due to invalid socket
Total number of packets dropped due to an invalid socket.
Packets which couldn’t be accessed
Total number of packets that could not be sent or received.
This might occur if:
Packet buffer does not form
a valid protocol packet.
IP header is not written to
the packet.
Outgoing packet interface
handle was not set.
Errors occurred calculating
the protocol checksum.
Other Packet Drops
Packets dropped for any other reason.
Related Commands
Command
Description
show pim traffic
Displays PIM traffic counter information.
ssm map static
To map group memberships from legacy hosts in Source-Specific Multicast (SSM) groups
accepted by an access control list (ACL) to a Protocol Independent Multicast (PIM)-SSM
source, use the ssm map static command in the appropriate
configuration mode. To revert to default behavior, use the no form of this
command.
ssmmapstaticsource-addressaccess-list
nossmmapstaticsource-addressaccess-list
Syntax Description
source-address
PIM-SSM source address to be used to create a static mapping.
access-list
ACL specifying the groups to be used to create a static mapping.
Command Default
Legacy host membership reports in the SSM group range are discarded.
Command Modes
IGMP VRF configuration
Command History
Release
Modification
Release 3.7.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
PIM-SSM requires the use of IGMPv3 (IPv4) to determine local
memberships. Under normal operating conditions, IGMP discards
older version
group membership reports for groups in the SSM group range. This means that a host with
a legacy group membership protocol is unable to receive data from a PIM-SSM source.
The ssm map static command maps an older group membership
report to a set of PIM-SSM sources. If the ACL associated with a configured source
accepts the SSM group, then that source is included in its set of sources for the SSM
group.
Task ID
Task ID
Operations
multicast
read, write
Examples
The following example shows PIM-SSM mapping in IGMP routing configuration mode:
To configure the router to be a statically configured member of the specified group on
the interface, or to statically forward for a multicast group onto the interface, use
the static-group command in the appropriate configuration
mode. To return to the default behavior, use the no form of this command.
IP address of the multicast group in IPv4 prefixing
format:
IP address as defined in the
Domain Name System (DNS) hosts table or with the domain IPv4 host in the
format A.B.C.D.
inc-maskmask
(Optional) Specifies a mask for the increment range. This is an IP address
expressed range in IPv4 format. This mask is used with the group address to generate subsequent
group addresses:
IP address as defined in the
Domain Name System (DNS) hosts table or with the domain IPv4 host in the
format A.B.C.D.
Note
This mask is used with the group address to generate subsequent group
addresses.
countcnt
(Optional) Specifies a number of group addresses to generate using the
increment mask. Range is 1 to 512.
source address
(Optional) Source address of the multicast group to include in IPv4 prefixing
format:
IP address as defined in the
Domain Name System (DNS) hosts table or with the domain IPv4 host in the
format A.B.C.D.
Command Default
A router is not a statically connected member of an IP multicast group.
Command Modes
IGMP interface configuration
Command History
Release
Modification
Release 3.7.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
When you configure the static-group command, packets to the
group are switched out the interface, provided that packets were received on the correct
Reverse Path Forwarding (RPF) interface.
The static-group command differs from the
join-group command. The
join-group command allows the router to join the multicast
group and draw traffic to an IP client process (that is, the route processor). If you
configure both the join-group and
static-group command for the same group address, the
join-group command takes precedence and the group
behaves like a locally joined group.
Note
The static-group command has no impact on system
performance. Configuring a static-group on a
loopback interface has no effect on the ASR 9000 Series Aggregation Services
Router.
Task ID
Task ID
Operations
multicast
read, write
Examples
In the following example, the router statically joins two multicast groups 225.2.2.2 and
225.2.2.4 for the specific source 1.1.1.1:
To configure an Internet Group Management Protocol (IGMP) version for the router, use the version command in the
appropriate configuration mode. To restore the default value, use the no form of
this command.
version
{ 1 | 2 | 3 }
noversion
Syntax Description
1
Specifies IGMP Version 1.
2
Specifies IGMP Version 2.
3
Specifies IGMP Version 3.
Command Default
If this command is not specified in interface configuration mode, the interface adopts
the IGMP version parameter
specified in IGMP VRF configuration mode.
If this command is not specified in IGMP configuration mode, IGMP
uses Version 3 .
Command Modes
IGMP configuration
IGMP VRF configuration
IGMP interface configuration
Command History
Release
Modification
Release 3.7.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
All routers on the subnet must be configured with the same version of IGMP. For example, a router
running Cisco IOS XR software does not automatically detect Version 1 systems and
switch to Version 1. Hosts can have any IGMP version and the router will
correctly detect their presence and query them appropriately.
The query-max-response-time and
query-timeout commands require IGMP Version 2 or 3.
Note
If you configure this command in IGMP configuration mode,
parameters are inherited by all new and existing interfaces. You can override these
parameters on individual interfaces from interface configuration mode.
Task ID
Task ID
Operations
multicast
read, write
Examples
The following example shows how to configure the router to use IGMP Version 3:
RP/0/RSP0/CPU0:router(config)# router igmpRP/0/RSP0/CPU0:router(config-igmp)# version 3
Configures the timeout value before the router takes over as the querier for the interface.
vrf (igmp)
To configure a virtual private network (VRF) instance, use the
vrf command in IGMP routing configuration mode.
To remove the VRF instance from the configuration file and restore the system to its
default condition, use the no form of this command.
vrfvrf-name
novrfvrf-name
Syntax Description
vrf-name
Name of the VRF instance.
Command Default
No default behavior or values.
Command Modes
IGMP configuration
Command History
Release
Modification
Release 3.7.2
This command was introduced.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.
When you use the vrf command from the IGMP routing
configuration mode to configure a VRF instance, you enter the IGMP VRF configuration
submode.
A VRF instance is a collection of VPN routing and forwarding tables maintained at the
provider edge (PE) router.
Task ID
Task ID
Operations
multicast
read, write
Examples
The following example shows how to configure a VRF instance in IGMP configuration
submode and to enter VRF configuration submode: