To globally enable the Internet Group Management Protocol (IGMP) querier function in Layer 2 networks, use the ip igmp snooping querier global configuration command. Use the command with keywords to enable and configure the IGMP querier feature on a VLAN interface.
To return to the default settings, use the no form of this command.
ip igmp snooping [ vlan vlan-id] querier [ address ip-address | max-response-time response-time | query-interval interval-count | tcn query { count count | interval interval} | timer expiry expiry-time | version version]
no ip igmp snooping [ vlan vlan-id] querier [ address | max-response-time | query-interval | tcn query { count | interval} | timer expiry | version]
Syntax Description
vlan
vlan-id
|
(Optional) Enables IGMP snooping and the IGMP querier function on the specified VLAN. Ranges are 1—1001 and 1006—4094.
|
address
ip-address
|
(Optional) Specifies a source IP address. If you do not specify an IP address, the querier tries to use the global IP address
configured for the IGMP querier.
|
max-response-time
response-time
|
(Optional) Sets the maximum time to wait for an IGMP querier report. The range is 1—25 seconds.
|
query-interval
interval-count
|
(Optional) Sets the interval between IGMP queriers. The range is 1—18000 seconds.
|
tcn query
|
(Optional) Sets parameters related to Topology Change Notifications (TCNs).
|
count
count
|
Sets the number of TCN queries to be executed during the TCN interval time. The range is 1—10.
|
interval
interval
|
Sets the TCN query interval time. The range is 1—255.
|
timer expiry expiry-time
|
(Optional) Sets the length of time until the IGMP querier expires. The range is 60—300 seconds.
|
version
version
|
(Optional) Selects the IGMP version number that the querier feature uses. Select either 1 or 2.
|
Command Default
The IGMP snooping querier feature is globally disabled on the device.
When enabled, the IGMP snooping querier disables itself if it detects IGMP traffic from a multicast router.
Command Modes
Global configuration
Command History
Release
|
Modification
|
Cisco IOS XE 3.3SE
|
This command was introduced.
|
Usage Guidelines
Use this command to enable IGMP snooping to detect the IGMP version and IP address of a device that sends IGMP query messages,
which is also called a querier.
By default, the IGMP snooping querier is configured to detect devices that use IGMP Version 2 (IGMPv2), but does not detect
clients that are using IGMP Version 1 (IGMPv1). You can manually configure the max-response-time value when devices use IGMPv2. You cannot configure the max-response-time when devices use IGMPv1. (The value cannot be configured,
and is set to zero).
Non-RFC-compliant devices running IGMPv1 might reject IGMP general query messages that have a non-zero value as the max-response-time value. If you want the devices to accept the IGMP general query messages, configure the IGMP snooping querier to run IGMPv1.
VLAN IDs 1002―1005 are reserved for Token Ring and FDDI VLANs, and cannot be used in IGMP snooping.
Examples
The following example shows how to globally enable the IGMP snooping querier feature:
Device(config)# ip igmp snooping querier
The following example shows how to set the IGMP snooping querier maximum response time to 25 seconds:
Device(config)# ip igmp snooping querier max-response-time 25
The following example shows how to set the IGMP snooping querier interval time to 60 seconds:
Device(config)# ip igmp snooping querier query-interval 60
The following example shows how to set the IGMP snooping querier TCN query count to 25:
Device(config)# ip igmp snooping querier tcn count 25
The following example shows how to set the IGMP snooping querier timeout value to 60 seconds:
Device(config)# ip igmp snooping querier timer expiry 60
The following example shows how to set the IGMP snooping querier feature to Version 2:
Device(config)# ip igmp snooping querier version 2
You can verify your settings by entering the show ip igmp snooping privileged EXEC command.