The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This chapter contains the following sections:
To delete the Internet Group Management Protocol (IGMP) group cache entries, use the clear ip igmp snooping groups Privileged EXEC mode command.
clear ip igmp snooping groups [dynamic | static]
dynamic—(Optional) Deletes dynamic group entries.
static—(Optional) Deletes static group entries.
Privileged EXEC mode
switchxxxxxx# clear ip igmp snooping groupsTo clear the IGMP Snooping statistics, use the clear ip igmp snooping statistics Privileged EXEC mode command.
clear ip igmp snooping statistics
N/A
Privileged EXEC mode
switchxxxxxx# clear ip igmp snooping statisticsTo control whether or not all hosts on a Layer 2 interface can join one or more IP multicast groups by applying an IGMP profile to the interface, use the ip igmp filter Interface Configuration mode command.
To remove an IGMP profile from the interface, use the no form of this command.
ip igmp filter profile-number
no ip igmp filter
profile-number—The IGMP profile number to be applied. (Range: 1 to 128)
No IGMP profiles are applied.
Interface Configuration mode
An IGMP profile can be applied to one or more interfaces, but one interface can have only one profile applied to it.
switchxxxxxx(config)# interface gi1
switchxxxxxx(config-if)# ip igmp filter 22To set the maximum number of IGMP groups that an interface can join or to configure the IGMP throttling action when the maximum number of entries in the forwarding table is reached, use the ip igmp max-groups Interface Configuration mode command.
To set the maximum number of IGMP groups back to the default (no maximum limit) or to return to the default throttling action (the report is dropped), use the no form of this command.
ip igmp max-groups number
no ip igmp max-groups
ip igmp max-groups action {deny | replace}
number—The maximum number of IGMP groups that an interface can join.
action deny—Drops the next IGMP join report when the maximum number of entries in the IGMP Snooping forwarding table is reached. This is the default action.
action replace—Replaces the existing group with the new group for which the IGMP report was received when the maximum number of entries in the IGMP Snooping forwarding table is reached.
Interface Configuration mode
You can use this command only on Layer 2 physical interfaces and on logical EtherChannel interfaces.
Follow these guidelines when configuring the IGMP throttling action:
If you configure the throttling action as deny and set the maximum group limitation, the entries that were previously in the forwarding table are not removed but are aged out. After these entries are aged out, when the maximum number of entries in the forwarding table is reached, the switch drops the next IGMP report received on the interface.
If you configure the throttling action as replace and set the maximum group limitation, the entries that were previously in the forwarding table are removed. When the maximum number of entries in the forwarding table is reached, the switch replaces a randomly selected multicast entry with the received IGMP report.
switchxxxxxx(config)# interface gi1
switchxxxxxx(config-if)# ip igmp max-groups 25
switchxxxxxx(config-if)# ip igmp max-groups action replaceTo create an IGMP profile and enter the IGMP Profile Configuration mode, use the ip igmp profile Global Configuration mode command. From this mode, you can specify the settings of the IGMP profile to be used for filtering IGMP membership reports from a switch port.
To delete an IGMP profile, use the no form of this command.
ip igmp profile profile-number
no ip igmp profile profile-number
profile-number —The IGMP profile number. (Range: 1 to 128)
No IGMP profiles are defined.
Global Configuration mode
switchxxxxxx(config)# ip igmp profile 20
switchxxxxxx(config-igmp-profile)#To enable IGMP Snooping on the switch, use the ip igmp snooping Global Configuration mode command.
To disable IGMP Snooping on the switch, use the no form of this command.
ip igmp snooping
no ip igmp snooping
N/A
IGMP Snooping is enabled by default.
Global Configuration mode
switchxxxxxx(config)# ip igmp snoopingTo configure the IGMP Snooping version, use the ip igmp snooping version Global Configuration mode command.
ip igmp snooping version {2 | 3}
version 2 —Specifies the IGMP version as IGMPv2.
version 3—Specifies the IGMP version as IGMPv3.
IGMPv2
Global Configuration mode
switchxxxxxx(config)# ip igmp snooping version 3To enable IGMP Snooping report suppression, use the ip igmp snooping report-suppression Global Configuration mode command.
To disable IGMP Snooping report suppression and forward all IGMP reports to multicast routers, use the no form of this command.
ip igmp snooping report-suppression
no ip igmp snooping report-suppression
N/A
IGMP Snooping report suppression is enabled by default.
Global Configuration mode
IGMP Snooping report suppression is supported only when the multicast query has IGMPv1 and IGMPv2 reports. This feature is not supported when the query includes IGMPv3 reports.
The switch uses IGMP Snooping report suppression to forward only one IGMP report per multicast router query to multicast devices. When IGMP router suppression is enabled, the switch sends the first IGMP report from all hosts for a group to all the multicast routers. The switch does not send the remaining IGMP reports for the group to the multicast routers. This feature prevents duplicate reports from being sent to the multicast devices.
If you disable IGMP report suppression by entering the no ip igmp snooping report-suppression command, all IGMP reports are forwarded to the multicast routers.
switchxxxxxx(config)# ip igmp snooping report-suppressionTo set the action when the switch receives an unknown multicast packet, use the ip igmp snooping unknown-multicast action Global Configuration mode command.
To revert to its default setting, use the no form of this command.
ip igmp snooping unknown-multicast action {drop | flood | router-port}
no ip igmp snooping unknown-multicast action
drop—Drops all unknown multicast packets.
flood—Floods all unknown multicast packets to ports in the same VLAN.
router-port—Sends all unknown multicast packets to the router port.
The default is flood.
Global Configuration mode
switchxxxxxx(config)# ip igmp snooping unknown-multicast action dropTo enable IGMP Snooping on specific VLANs, use the ip igmp snooping vlan Global Configuration mode command.
To disable IGMP Snooping on specific VLANs, use the no form of this command.
ip igmp snooping vlan VLAN-LIST
no ip igmp snooping vlan VLAN-LIST
VLAN-LIST—A VLAN ID or a list of VLAN IDs. (Range: 1 to 4094)
IGMP Snooping is disabled.
Global Configuration mode
IGMPv1, IGMPv2, and IGMPv3 are supported.
switchxxxxxx(config)# ip igmp snooping vlan 2To enable the IGMP Snooping immediate leave processing on a VLAN, use the ip igmp snooping vlan immediate-leave Global Configuration mode command.
To disable IGMP Snooping immediate leave processing, use the no form of this command.
ip igmp snooping vlan VLAN-LIST immediate-leave
no ip igmp snooping vlan VLAN-LIST immediate-leave
VLAN-LIST—A VLAN ID or a list of VLAN IDs. (Range: 1 to 4094)
IGMP Snooping immediate leave is disabled by default.
Global Configuration mode
You can execute the command before the VLAN is created.
switchxxxxxx(config)# ip igmp snooping vlan 1 immediate-leaveTo forbid a port from being defined as a multicast router port by static configuration or by automatic learning, use the ip igmp snooping vlan forbidden mrouter Global Configuration mode command.
To remove the configuration, use the no form of this command.
ip igmp snooping vlan VLAN-LIST forbidden mrouter interfaces interface-id
no ip igmp snooping vlan VLAN-LIST forbidden mrouter interfaces interface-id
VLAN-LIST—A VLAN ID or a list of VLAN IDs. (Range: 1 to 4094)
interfaces interface-id—Specifies an interface ID or a list of interface IDs. The interfaces can be one of these types: Ethernet port or port channel.
No ports are defined.
Global Configuration mode
A port that is a forbidden Mrouter port cannot be a multicast router port (for example, cannot be learned dynamically or assigned statically).
You can execute the command before the VLAN is created.
switchxxxxxx(config)# ip igmp snooping vlan 1 forbidden mrouter interfaces gi1To enable the IGMP Snooping forbidden forward-all port processing on a VLAN, use the ip igmp snooping vlan forbidden forward-all Global Configuration mode command.
To disable this feature, use the no form of this command.
ip igmp snooping vlan VLAN-LIST forbidden forward-all interfaces interface-id
no ip igmp snooping vlan VLAN-LIST forbidden forward-all interfaces interface-id
VLAN-LIST—A VLAN ID or a list of VLAN IDs. (Range: 1 to 4094)
interfaces interface-id—Specifies an interface ID or a list of interface IDs. The interfaces can be one of these types: Ethernet port or port channel.
No port is configured as a member of a multicast group.
Global Configuration mode
All registered multicast entries will always remove the forbidden forward-all.
switchxxxxxx(config)# ip igmp snooping vlan 1 forbidden forward-all interfaces fa11
switchxxxxxx(config)# ip igmp snooping vlan 1 forbidden forward-all interfaces gi1
switchxxxxxx(config)# ip igmp snooping vlan 1 forbidden forward-all interfaces po1To configure the last member query counter on a VLAN, use the ip igmp snooping vlan last-member-query-count Global Configuration mode command.
To revert to its default setting, use the no form of this command.
ip igmp snooping vlan VLAN-LIST last-member-query-count count
no ip igmp snooping vlan VLAN-LIST last-member-query-count
VLAN-LIST—A VLAN ID or a list of VLAN IDs. (Range: 1 to 4094)
count —The number of times that group-specific or group-source-specific queries are sent upon receipt of a message indicating a leave. (Range: 1 to 7)
2
Global Configuration mode
You can execute the command before the VLAN is created.
switchxxxxxx(config-if)# ip igmp snooping vlan 3 last-member-query-count 7To configure the last member query interval on a VLAN, use the ip igmp snooping vlan last-member-query-interval Global Configuration mode command.
To revert to its default setting, use the no form of this command.
ip igmp snooping vlan VLAN-LIST last-member-query-interval seconds
no ip igmp snooping vlan VLAN-LIST last-member-query-interval
VLAN-LIST—A VLAN ID or a list of VLAN IDs. (Range: 1 to 4094)
seconds—The interval in seconds at which IGMP group-specific host query messages are sent on the interface. (Range: 1 to 25)
1
Interface Configuration (VLAN) mode
You can execute the command before the VLAN is created.
switchxxxxxx(config)# ip igmp snooping vlan 3 last-member-query-interval 2To enable automatic learning of multicast router ports on a VLAN, use the ip igmp snooping vlan mrouter Global Configuration mode command.
To remove the configuration, use the no form of this command.
ip igmp snooping vlan VLAN-LIST mrouter learn pim-dvmrp
no ip igmp snooping vlan VLAN-LIST mrouter learn pim-dvmrp
VLAN-LIST—A VLAN ID or a list of VLAN IDs. (Range: 1 to 4094)
Learning pim-dvmrp is enabled by default.
Global Configuration mode
Multicast router ports are learned according to:
Queries received on the port
PIM/PIMv2 received on the port
DVMRP received on the port
MOSPF received on the port
You can execute the command before the VLAN is created.
switchxxxxxx(config)# ip igmp snooping vlan 1 mrouter learn pim-dvmrpTo enable the IGMP querier on specific VLANs, use the ip igmp snooping vlan querier Global Configuration mode command.
To disable the IGMP querier on specific VLANs, use the no form of this command.
ip igmp snooping vlan VLAN-LIST querier
no ip igmp snooping vlan VLAN-LIST querier
VLAN-LIST—A VLAN ID or a list of VLAN IDs. (Range: 1 to 4094)
Disabled
Global Configuration mode
When the IGMP Snooping querier is enabled, it starts after a quarter of operation query-interval with no IGMP traffic being detected from a multicast router.
switchxxxxxx(config)# ip igmp snooping vlan 1 querierTo configure the IGMP version for an IGMP querier on specific VLANs, use the ip igmp snooping vlan querier version Global Configuration mode command.
To revert to its default setting, use the no form of this command.
ip igmp snooping vlan VLAN-LIST querier version {2 | 3}
no ip igmp snooping vlan VLAN-LIST querier version
VLAN-LIST—A VLAN ID or a list of VLAN IDs. (Range: 1 to 4094)
querier version 2—The IGMP version is IGMPv2.
querier version 3—The IGMP version is IGMPv3.
The default IGMP version is IGMPv2.
Global Configuration mode
switchxxxxxx(config)# ip igmp snooping vlan 1 querier version 3To set the query interval on a VLAN, use the ip igmp snooping vlan query-interval Global Configuration mode command.
To revert to its default setting, use the no form of this command.
ip igmp snooping vlan VLAN-LIST query-interval seconds
no ip igmp snooping vlan VLAN-LIST query-interval
VLAN-LIST—A VLAN ID or a list of VLAN IDs. (Range: 1 to 4094)
seconds—The frequency in seconds at which IGMP query messages are sent on the interface. (Range: 30 to 18000)
The default IGMP query interval is 125 seconds.
Global Configuration mode
You can execute the command before the VLAN is created.
switchxxxxxx(config)# ip igmp snooping vlan 3 query-interval 50To configure the maximum query response time on a VLAN, use the ip igmp snooping vlan response-time Global Configuration mode command.
To revert to its default setting, use the no form of this command.
ip igmp snooping vlan VLAN-LIST response-time seconds
no ip igmp snooping vlan VLAN-LIST response-time
VLAN-LIST—A VLAN ID or a list of VLAN IDs. (Range: 1 to 4094)
seconds —Maximum response time in seconds advertised in IGMP queries. (Range: 5 to 20)
10
Global Configuration mode
You can execute the command before the VLAN is created.
switchxxxxxx(config)# ip igmp snooping vlan 3 response-time 20To set the IGMP robustness variable on a VLAN, use the ip igmp snooping vlan robustness-variable Global Configuration mode command.
To revert to its default setting, use the no form of this command.
ip igmp snooping vlan VLAN-LIST robustness-variable count
no ip igmp snooping vlan VLAN-LIST robustness-variable
VLAN-LIST—A VLAN ID or a list of VLAN IDs. (Range: 1 to 4094)
count—The number of expected packet loss on a link. (Range:1 to 7)
N/A
Global Configuration mode
switchxxxxxx(config)# interface vlan 1 robustness-variable 5To enable the IGMP Snooping static group processing on a VLAN, use the ip igmp snooping vlan static Global Configuration mode command.
To disable this feature, use the no form of this command.
ip igmp snooping vlan VLAN-LIST static IPv4-Addr interface interface-id
no ip igmp snooping vlan VLAN-LIST static IPv4-Addr interface interface-id
VLAN-LIST—A VLAN ID or a list of VLAN IDs. (Range: 1 to 4094)
IPv4-Addr—IPv4 multicast address.
interface interface-id—The interface ID. The interfaces can be one of these types: Ethernet port or port channel.
No port is configured as a member of a multicast group.
Global Configuration mode
You can execute the command before the VLAN is created.
You cannot register an entry without specifying an interface.
Using the no command without a port list removes the entry.
switchxxxxxx(config)# ip igmp snooping vlan 1 static 192.168.1.100 interface fa11
switchxxxxxx(config)# ip igmp snooping vlan 1 static 192.168.1.110 interface gi1
switchxxxxxx(config)# ip igmp snooping vlan 1 static 192.168.1.200 interface po1To register a Layer 2 port as a member of a static multicast group to the bridge table, use the ip igmp snooping vlan mrouter Global Configuration mode command.
To remove the ports as the members of a static Mrouter port, use the no form of this command.
ip igmp snooping vlan VLAN-LIST mrouter interfaces interface-id
no ip igmp snooping vlan VLAN-LIST mrouter interfaces interface-id
VLAN-LIST—A VLAN ID or a list of VLAN IDs. (Range: 1 to 4094)
interfaces interface-id—An interface ID or a list of interface IDs. The interfaces can be one of these types: Ethernet port or port channel.
No port is configured as a member of a static Mrouter port.
Global Configuration mode
You can execute the command before the VLAN is created.
You can register an entry without specifying an interface.
Using the no command without a port list removes the entry.
switchxxxxxx(config)# ip igmp snooping vlan 1 mrouter interfaces gi1To enable the IGMP Snooping forward-all static port processing on a VLAN, use the ip igmp snooping vlan forward-all Global Configuration mode command.
To disable this feature, use the no form of this command.
ip igmp snooping vlan VLAN-LIST forward-all interfaces interface-id
no ip igmp snooping vlan VLAN-LIST forward-all interfaces interface-id
VLAN-LIST—A VLAN ID or a list of VLAN IDs. (Range: 1 to 4094)
interfaces interface-id—Specifies an interface ID or a list of interface IDs. The interfaces can be one of these types: Ethernet port or port channel.
N/A
Global Configuration mode
You can execute the command before the VLAN is created.
You can register an entry without specifying an interface.
switchxxxxxx(config)# ip igmp snooping vlan 1 forward-all interfaces fa11
switchxxxxxx(config)# ip igmp snooping vlan 1 forward-all interfaces gi1
switchxxxxxx(config)# ip igmp snooping vlan 1 forward-all interfaces po1To create an IGMP profile, use the profile range IGMP-profile Configuration mode command.
profile range ip ip-range action {permit | deny}
ip ip-range—Specifies a range of IPv4 addresses. This can be a single IPv4 address or a range of addresses. When entering a range, enter the low IPv4 multicast address, a space, and the high IPv4 multicast address.
action permit—Permits the matching addresses.
action deny—Denies the matching addresses.
N/A
IGMP-profile Configuration mode
switchxxxxxx(config)# ip igmp profile 20
switchxxxxxx(config-igmp-profile)# profile range ip 225.0.0.0 225.0.0.255 action permitTo display IGMP profiles for all interfaces or a specific interface, use the show ip igmp filter Privileged EXEC mode command.
show ip igmp filter [interfaces interface-id]
interfaces interface-id —(Optional) Specifies an interface ID or a list of interface IDs.
Privileged EXEC mode
switchxxxxxx# show ip igmp filter
Port ID | Profile ID
---------+--------------
fa1 : 1
fa2 : 1
fa3 : 2
fa4 : 2
fa5 : None
fa6 : None
fa7 : None
fa8 : None
fa9 : None
fa10 : None
fa11 : None
fa12 : None
fa13 : None
fa14 : None
fa15 : None
fa16 : None
fa17 : None
fa18 : None
fa19 : None
fa20 : None
fa21 : None
fa22 : None
fa23 : None
fa24 : None
gi1 : None
gi2 : None
po1 : None
po2 : None
po3 : None
po4 : None
po5 : None
po6 : None
po7 : None
po8 : NoneTo display the maximum number of IGMP groups on a specific interface or all interfaces, use the show ip igmp max-group Privileged EXEC mode command.
show ip igmp max-group [interfaces interface-id ]
interfaces interface-id—(Optional) Specifies an interface ID or a list of interface IDs. The interfaces can be one of these types: Ethernet port or port channel.
Privileged EXEC mode
If no interface is specified, the information for all interfaces is displayed.
switchxxxxxx# show ip igmp max-group interfaces fa5
Port ID | Max Group
---------+--------------
fa5 : 512To display the action for a specific interface or for all interfaces when the number of IGMP groups exceeds the maximum group number, use the show ip igmp max-group action Privileged EXEC mode command.
show ip igmp max-group action [interfaces interface-id]
interfaces interface-id—(Optional) Specifies an interface ID or a list of interface IDs. The interfaces can be one of these types: Ethernet port or port channel.
Privileged EXEC mode
If no interface is specified, the information for all interfaces is displayed.
switchxxxxxx# show ip igmp max-group action interface fa5
Port ID | Max-groups Action
---------+---------------------
fa5 : replacyTo display information for all IGMP profiles or for a specific IGMP profile, use the show ip igmp profile Privileged EXEC mode command.
show ip igmp profile [profile-index]
profile-index—(Optional) IGMP profile index.
Privileged EXEC mode
switchxxxxxx# show ip igmp profile
IP igmp profile index: 1
IP igmp profile action: permit
Range low ip: 10.172.11.1
Range high ip: 10.172.11.20To display the IGMP Snooping status, use the show ip igmp snooping Privileged EXEC mode command.
show ip igmp snooping
N/A
Privileged EXEC mode
switchxxxxxx# show ip igmp snooping
IGMP Snooping Status
--------------------
Snooping : Enabled
Report Suppression : Enabled
Operation Version : v2
Forward Method : mac
Unknown Multicast Action : Flood
Packet Statistics
Total RX : 79
Valid RX : 42
Invalid RX : 37
Other RX : 0
Leave RX : 0
Report RX : 0
General Query RX : 0
Specail Group Query RX : 0
Specail Group & Source Query RX : 0
Leave TX : 0
Report TX : 0
General Query TX : 0
Special Group Query TX : 0
Special Group & Source Query TX : 0To display information for IGMP Snooping forward all, use the show ip igmp snooping forward-all Privileged EXEC mode command.
show ip igmp snooping forward-all [vlan VLAN_LIST]
vlan VLAN-LIST—(Optional) Specifies a VLAN ID or a list of VLANs. (Range: 1 to 4094)
Privileged EXEC mode
switchxxxxxx# show ip igmp snooping forward-all
IGMP Snooping VLAN : 1
IGMP Snooping static port : None
IGMP Snooping forbidden port : None
IGMP Snooping VLAN : 104
IGMP Snooping static port : None
IGMP Snooping forbidden port : NoneTo display multicast groups learned by IGMP Snooping, use the show ip igmp snooping groups Privileged EXEC mode command.
show ip igmp snooping groups [counters | dynamic | static]
counters—(Optional) Displays IPv4 group total entries.
dynamic—(Optional) Displays dynamic groups.
static—(Optional) Displays static groups.
Privileged EXEC mode
To display all multicast groups learned by IGMP Snooping, use the show ip igmp snooping groups command without parameters.
To display a needed subset of all multicast groups learned by IGMP Snooping, use the show ip igmp snooping groups command with parameters.
switchxxxxxx# show ip igmp snooping groups
VLAN | Group IP Address | Type | Life(Sec) | Port
-----+------------------+-------+-----------+------------------
1 | 238.0.0.0 | Static| -- | fa1-24,gi1-2,po1-8
Total Number of Entry = 1To display information on dynamically, static, or forbidden learned multicast router port for all VLANs or for a specific VLAN, use the show ip igmp snooping mrouter Privileged EXEC mode command.
show ip igmp snooping mrouter [dynamic | static | forbidden]
dynamic—(Optional) Displays dynamic routers.
forbidden—(Optional) Displays forbidden routers.
static—(Optional) Displays static routers.
Privileged EXEC mode
switchxxxxxx# show ip igmp snooping mrouter
Dynamic Mrouter Table
VID | Port | Expiry Time(Sec)
------+---------+------------------
Total Entry 0
Static Mrouter Table
VID | Port Mask
------+------------------------
Total Entry 0
Forbidden Mrouter Table
VID | Port Mask
------+------------------------
Total Entry 0To display information for the IGMP Snooping querier, use the show ip igmp snooping querier Privileged EXEC mode command.
show ip igmp snooping querier
N/A
Privileged EXEC mode
switchxxxxxx# show ip igmp snooping querier
VID | State | Status | Version | Querier IP
-------+-------------+-------------+------------+--------------------
1 | Disabled | Non-Querier | No | ------
104 | Disabled | Non-Querier | No | ------
Total Entry 2To display the IGMP Snooping configuration for specific VLANs, use the show ip igmp snooping vlan Privileged EXEC mode command.
show ip igmp snooping vlan [VLAN-LIST]
VLAN-LIST—(Optional) A VLAN ID or a range of VLAN IDs. (Range: 1 to 4094)
Privileged EXEC mode
switchxxxxxx# show ip igmp snooping vlan 1
IGMP Snooping is globally enabled
IGMP Snooping VLAN 1 admin : disabled
IGMP Snooping operation mode : disabled
IGMP Snooping robustness: admin 2 oper 2
IGMP Snooping query interval: admin 125 sec oper 125 sec
IGMP Snooping query max response : admin 10 sec oper 10 sec
IGMP Snooping last member query counter: admin 2 oper 2
IGMP Snooping last member query interval: admin 1 sec oper 1 sec
IGMP Snooping immediate leave: disabled
IGMP Snooping automatic learning of mrouter ports: enabled
Feedback