IGMP and IGMP Snooping
IGMP Snooping
IGMP snooping is a Layer 2 switch process that extracts lists of hosts receiving multicast group traffic by monitoring IGMP network packets. The switch uses these lists to avoid flooding hosts with extraneous multicast traffic by sending group packets only to group members. Besides preventing local hosts from receiving traffic for groups they did not join, snooping prunes multicast traffic from links that do not contain IGMP clients.
When snooping is enabled, a switch examines IGMP packets sent between hosts connected to network switches and multicast routers (mrouters). When a switch finds an IGMP report from a multicast group recipient, it adds the recipient's port to the group multicast list. When the switch receives an IGMP leave, it removes the recipient's port from the list. Groups are removed upon the group timer expiry. When the switch finds an IGMP query packet or PIM hello packet from a multicast router, it adds the router's port to the port list for all multicast groups.
Snooping Querier
Snooping requires an IGMP querier in the network to create multicast group tables. An IGMP snooping querier performs the multicast router (mrouter) role when the network does not have a router. When the snooping querier is enabled on a VLAN, the switch periodically broadcasts IGMP queries and listens for IGMP Reports that indicate host group memberships.
Networks that contain multiple snooping queriers elect one as the querier, based on IP address. When IGMP snooping querier is enabled on a VLAN, the switch performs as a querier only when it is elected or it is the only snooping querier on the network.
L2 Report Flooding
L2 report flooding is an IGMP snooping feature that forwards membership report messages to specified ports. Relying on a single switch to maintain and send report messages can degrade performance. L2 report flooding addresses this by facilitating report message forwarding through any network port. This allows switches to bypass the querier when forwarding multicast traffic to its interested ports.
IGMP Snooping Proxy
IGMP snooping proxy is an enhancement over IGMP snooping. When snooping proxy is enabled, the switch starts sending proxy queries periodically to the downstream hosts and collects the IGMP reports and updates the local state. Later, when the switch receives an IGMP query from an upstream router, the switch immediately responds with a report based on its local state.
When IGMP snooping proxy is disabled, the IGMP queries in VLAN, and the reports from hosts are flooded. Enabling IGMP snooping proxy prevents a sudden burst in IGMP report traffic in response to every query. It also reduces the number of reports that the IGMP Querier needs to process in the VLAN. However, it introduces a latency in the propagation of the IGMP state through the VLAN.
IGMP Host Proxy Description
The figure displays a typical IGMP host-proxy implementation. The customer network connects to the sender network through the edge switch's Ethernet 1 interface, which is configured as an IGMP host proxy. PIM is enabled within the sender and customer networks but not on the connection between the networks.
The IGMP proxy agent sends unsolicited IGMP joins when a (S,G) or (*,G) entry arrives in the multicast routing table (mroute table). Subsequently, IGMP reports are sent when queries or group-specific queries arrive on the host proxy interface. When the customer network is void of active listeners, the connection eventually expires and the senders stop transmitting to the network.
- PIM Multicast Border Router (MBR) must be enabled on the interface.
- IP IGMP and IP multicast must be enabled.
- The switch must be an RP or in each host's RP path.
- Fast-drop entries are required when there are no interested listeners for the group.
IGMP host proxy is configurable to filter for specific multicast groups and sources.
Supported Features
For a list of the IGMP features that each Arista switch platform supports, refer to the supported features table here: https://www.arista.com/en/support/product-documentation/supported-features.
IGMP Protocols
IGMP
- IGMP version 1 is defined in RFC 1112. Hosts can join multicast groups without a method to leave a group. Routers use a timeout-based process to determine when hosts lose interest in a group.
- IGMP version 2 is defined in RFC 2236. Version 2 adds leave messages that hosts use to terminate group membership.
- IGMP version 3 is defined in RFC 4604. Version 3 allows hosts to specify IP addresses within a group from where they receive traffic. Traffic from all other group addresses is blocked from the host.
With respect to each of its attached networks, a multicast router is either a querier or non-querier. Each physical network contains only one querier. A network with more than one multicast router designates the router with the lowest IP address as its querier.
Queriers solicit group membership information by periodically sending General Query messages. Queriers also receive unsolicited messages from hosts joining or leaving a multicast group. When a querier receives a message from a host, it updates its membership list for the group referenced in the message and the network where the message originated.
Queriers forward multicasts from remote sources only to networks as specified by its membership list. If a querier does not receive a report from a network host for a specific group, it removes the corresponding entry from the table and discontinues forwarding multicasts for that group on the network. Queriers also send group-specific queries after receiving a leave request from a host to determine if the network still contains active multicast group members. If it does not receive a membership report during the period defined by the last member query response interval, the querier removes the group-network entry from the membership list.
When a host receives a General Query, it responds with Membership Report messages for each of its multicast groups within the interval specified by the Max Response Time field in the query. IGMP suppresses multiple messages from different hosts on a network for the same group. Hosts send unsolicited Membership reports to join a multicast group and send leave messages to exit a group.
Configuring IGMP
This section describes the following configuration tasks:
Enabling IGMP
Enabling PIM also enables IGMP on that interface. When the switch fills the multicast routing table, it only adds interfaces when the interface receives join messages from downstream devices or when the interface is directly connected to a member of the IGMP group.
By default, PIM and IGMP are disabled on an interface. Use the pim ipv4 sparse-mode or pim ipv4 bidirectional command to enable PIM and IGMP on the configuration mode interface.
Example
switch(config)# interface vlan 8
switch(config-if-Vl8)# pim ipv4 sparse-mode
switch(config-if-Vl8)#In the unlikely event that the IGMP agent needs to run on an interface without PIM being enabled, use the ip igmp command.
Example
switch(config)# interface vlan 8
switch(config-if-Vl8)# ip igmp
switch(config-if-Vl8)#Configuring IGMP Settings
An interface that runs IGMP uses default protocol settings unless otherwise configured. The switch provides commands that alter startup query, last member query, and normal query settings.
IGMP Version
The switch supports IGMP versions 1 through 3. The ip igmp version command configures the IGMP version on the configuration mode interface. Version 3 is the default IGMP version.
Example
switch(config)# interface vlan 4
switch(config-if-Vl4)# ip igmp version 3
switch(config-if-Vl4)#Startup Query
Membership queries are sent at an increased frequency immediately after an interface starts up to quickly establish the group state. Query count and query interval commands adjust the period between membership queries for a specified number of messages.
The ip igmp startup-query-interval command specifies the interval between membership queries that an interface sends immediately after it starts up. The ip igmp startup-query-count command specifies the number of queries that the switches sends from the interface at the startup interval rate.
- ExampleThese commands define a startup interval of 15 seconds for the first 10 membership queries sent from interface vlan 12.
switch(config)# interface vlan 12 switch(config-if-Vl12)# ip igmp startup-query-interval 150 switch(config-if-Vl12)# ip igmp startup-query-count 10 switch(config-if-Vl12)#
Membership Queries
The router with the lowest IP address on a subnet sends membership queries as the IGMP querier. When a membership query is received from a source with a lower IP address, the router resets its query response timer. Upon timer expiry, the router begins sending membership queries. If the router subsequently receives a membership query originating from a lower IP address, it stops sending membership queries and resets the query response timer.
The ip igmp query-interval command configures the frequency at which the active interface, as an IGMP querier, sends membership query messages.
The igmp query-max-response-time command configures the time that a host has to respond to a membership query.
Example
switch(config)# interface vlan 15
switch(config-if-Vl15)# ip igmp query-interval 75
switch(config-if-Vl15)# igmp query-max-response-time 450
switch(config-if-Vl15)#Last Member Query
When the querier receives an IGMP leave message, it verifies the group has no remaining hosts by sending a set of group-specific queries at a specified interval. If the querier does not receive a response to the queries, it removes the group state and discontinues multicast transmissions.
The ip igmp last-member-query-count (LMQC) command specifies the number of query messages the router sends in response to a group-specific or group-source-specific leave message.
The ip igmp last-member-query-interval command configures the transmission interval for sending group-specific or group-source-specific query messages to the active interface.
Example
switch(config)# interface vlan 15
switch(config-if-Vl15)# ip igmp last-member-query-interval 250
switch(config-if-Vl15)# ip igmp last-member-query-count 3
switch(config-if-Vl15)#Static Groups
The ip igmp static-group command configures the configuration mode interface as a static member of the multicast group at the specified address. The router forwards multicast group packets through the interface without otherwise appearing or acting as a group member. No interface is a static member of a multicast group by default.
Example
switch(config)# interface vlan 15
switch(config-if-Vl15)# pim ipv4 dr-priority 5000
switch(config-if-Vl15)# ip igmp static-group 231.1.1.45 10.1.1.1
switch(config-if-Vl15)#Configuring IGMP Snooping
Enabling Snooping
- Global settings control the availability of IGMP snooping on the switch. Snooping is globally enabled by default.
- Per-VLAN settings control IGMP on individual VLANs. If snooping is enabled on the VLAN, it follows the global snooping state.
The ip igmp snooping command controls the global snooping setting. The ip igmp snooping vlan command configures snooping on individual VLANs.
- This command globally enables snooping on the
switch.
switch(config)# ip igmp snooping switch(config)# - This command disables snooping on VLANs 2,
3, and
4.
switch(config)# no ip igmp snooping vlan 2-4 switch(config)#
Configuring Snooping Parameters
Specifying a Static Multicast Router Connection
The ip igmp snooping vlan multicast-router command statically configures a port that connects to a multicast router to join all multicast groups. The port to the router must be in the specified VLAN range.
Snooping may not always be able to locate the IGMP querier. This command is for IGMP queriers that are known to connect through the network to a port on the switch.
Example
switch(config)# ip igmp snooping vlan 2 mrouter interface ethernet 3
switch(config)#Adding a Port to a Multicast Group
The ip igmp snooping vlan member command adds an a port to a multicast group. The IP address must be an unreserved IPv4 multicast address. The interface to the port must be in the specified VLAN range.
Example
switch(config)# ip igmp snooping vlan 7 member 237.2.1.4 interface ethernet 3
switch(config)#Robustness Variable
The robustness variable specifies the number of unacknowledged snooping queries that a switch sends before removing the recipient from the group list.
The ip igmp snooping robustness-variable command configures the robustness variable for all snooping packets sent from the switch. The default value is 2.
Example
switch(config)# ip igmp snooping robustness-variable 3
switch(config)#Configuring Interface Startup Initial Query Times
The ip igmp snooping interface-restart-query command configures the interface startup initial query times in milliseconds. If nothing is configured, a default value of 2000 milliseconds is used. Issuing the command replaces any values already configured. Multiple values may be input in a single command; this makes the mechanism more resilient in the case of dropped packets.
- This command configures interfaces to send IGMP queries at
1000, 2000, and
4000 milliseconds (i.e.,
1 second, 2
seconds, and 4 seconds) after an interface restart
or spanning tree
change.
switch(config)# ip igmp snooping interface-restart-query 1000 2000 4000 switch(config)# - This command configures interfaces to send a single IGMP query of
5000 milliseconds
(5 seconds) after an interface restart or
spanning tree
change.
switch(config)# ip igmp snooping interface-restart-query 5000 switch(config)#
Snooping Querier
The IGMP snooping querier supports snooping by sending Layer 2 membership queries to hosts attached to the switch. Note that if IGMP snooping is enabled, QoS will not apply to IGMP packets.
Enabling the Snooping Querier
Enabling the snooping querier on an interface requires the explicit configuration of a global querier address or a local querier address for the interface. See Configuring Snooping Querier Parameters.
- The global setting controls the querier on VLANs for which there is no snooping querier command.
- VLAN querier settings take precedence over the global querier setting.
The ip igmp snooping querier command controls the global querier setting. When enabled globally, the querier is controlled on individual VLANs through the ip igmp snooping vlan querier command.
- ip igmp snooping vlan querier enables the querier on specified VLANs.
- no ip igmp snooping vlan querier disables the querier on specified VLANs.
Example
- These commands globally enables the snooping querier on the switch, explicitly
disables snooping on VLANs 1-4, and explicitly enables
snooping on VLANs
5-8.
switch(config)# ip igmp snooping querier switch(config)# no ip igmp snooping vlan 1-4 querier switch(config)# ip igmp snooping vlan 5-8 querier switch(config)# - This command removes the querier setting for VLANs
3-6:
switch(config)# default ip igmp snooping vlan 3-6 querier switch(config)#
Globally Set the Snooping Querier Version
The ip igmp snooping querier version command configures the IGMP snooping querier version. Version 2 is the default IGMP snooping version.
Example
switch(config)# ip igmp snooping querier version 2
switch(config)#The ip igmp snooping vlan querier version command configures IGMP globally on the VLAN. Version 2 is the default IGMP snooping version.
Example
switch(config)# ip igmp snooping vlan 5 querier version 2
switch(config)#Configuring Snooping Querier Parameters
Querier Address
- The global address is used by VLANs for which there is no querier address command.
- VLAN querier address settings take precedence over the global querier address.
The snooping querier address specifies the source IP address for IGMP snooping query packets that the switch transmits. The source address is also used to elect a snooping querier when the subnet contains multiple snooping queriers.
The default global querier address is not defined. When the configuration includes a snooping querier, a querier address must be defined globally or for each interface that enables a querier.
The ip igmp snooping querier address command sets the global querier source IP address for the switch. VLANs use the global address unless overwritten with the ip igmp snooping vlan querier address command. The default global address is not defined.
The ip igmp snooping vlan querier address command sets the source IP address for query packets transmitted from the specified VLAN. This command overrides the ip igmp snooping querier address for the specified VLAN.
-
This command sets the source IP address for query packets that the switch transmits to 10.1.1.41.
switch(config)# ip igmp snooping querier address 10.1.1.41 switch(config)# -
This command sets the source IP address for query packets that vlan 2 transmits to 10.14.1.1.
switch(config)# ip igmp snooping vlan 2 querier address 10.14.1.1 switch(config)#
Membership Query Interval
The query interval is the period (seconds), between IGMP Membership Query message transmissions. The interval ranges from 5 to 3600 seconds.
The ip igmp snooping querier query-interval command specifies the global query interval for packets the switch sends as a snooper querier. The default global setting is 125 seconds.
The ip igmp snooping vlan querier query-interval command specifies the query interval for packets sent from the snooping querier to the specified VLAN, overriding the global setting. VLANs that do not specify a query interval use the global setting.
-
This command sets a query interval of 150 seconds for queries transmitted from VLANs for which a query interval is not configured.
switch(config)# ip igmp snooping querier query-interval 150 switch(config)# -
This command sets the query interval of 240 seconds for queries transmitted from vlan 2.
switch(config)# ip igmp snooping vlan 2 querier query-interval 240 switch(config)#
Membership Query Response Interval
- The global value is used by VLANs for which there is no Max Response Time command.
- VLAN values take precedence over the global value for the specified VLAN.
The ip igmp snooping querier max-response-time command specifies the global Max Response Time value used in snooping query packets transmitted from the switch. Values range from 1 to 25 seconds with a default of 10 seconds. VLANs use the global setting unless overwritten with the ip igmp snooping vlan querier max-response-time command.
The ip igmp snooping vlan querier max-response-time command configures the Max Response Time field contents for packets transmitted from the specified VLAN, overriding the global setting.
- This command sets the maximum response time of
15 seconds for queries transmitted from
VLANs for which a maximum response time is not
configured.
switch(config)# ip igmp snooping querier max-response-time 15 switch(config)# - This command sets a maximum response time of
5 seconds for queries that
vlan 2
transmits.
switch(config)# ip igmp snooping vlan 2 querier max-response-time 5 switch(config)#
Last Member Query
When the querier receives an IGMP leave message, it verifies the group has no remaining hosts by sending a set of group-specific queries at a specified interval. If the querier does not receive a response to the queries, it removes the group state and discontinues multicast transmissions.
- The global value is used by VLANs for which there is no last-member-query-interval defined.
- VLAN values take precedence over the global value for the specified VLAN.
The ip igmp snooping querier last-member-query-interval command specifies the global last-member-query-interval used in snooping query packets transmitted from the switch. This value is used for VLANs that do not have a value specified. Values range from 1 to 25 seconds with a global default of one second.
The ip igmp snooping vlan querier last-member-query-interval command configures the last-member-query-interval field contents for packets transmitted from the specified VLAN, overriding the global setting.
Example
switch(config)# ip igmp snooping querier last-member-query-interval 5
switch(config)# ip igmp snooping vlan 10 querier last-member-query-interval 12
switch(config)#Interface Restart Query Spoofing
When the port status (link status or spanning tree status) changes, an IGMP general query is spoofed based on the information of the last known IGMP querier. This facilitates faster network convergence time.
By default, interfaces wait 2000 milliseconds before sending the spoofed IGMP query. To configure the delay before the spoofed query is sent, use the ip igmp snooping interface-restart-query command. This setting is applied to all ports.
Example
switch(config)# ip igmp snooping interface-restart-query 100 200 300IGMP Snooping L2 Report Flooding
L2 report flooding is an IGMP snooping feature that forwards membership report messages to specified ports. Report flooding is disabled by default and must be enabled globally before it can be enabled on individual interfaces.
The list of ports that can forward membership report messages must be explicitly configured. Commands are available to define lists of ports that are valid for all VLANs and port lists that are valid for specified VLAN ranges. Ports can forward membership reports only if they are configured to handle VLAN traffic, regardless of any report flooding configuration settings.
Enabling L2 Report Flooding
- ip igmp snooping report-flooding enables report flooding globally.
- ip igmp snooping vlan report-flooding enables report flooding on a specified VLAN range.
Example
switch(config)# ip igmp snooping report-flooding
switch(config)# ip igmp snooping vlan 201-205 report-flooding
switch(config)#Configuring Forwarding Ports
- ip igmp snooping report-flooding switch-port configures ports globally.
- ip igmp snooping vlan report-flooding switch-port configures ports for a specified VLAN range.
Example
switch(config)# ip igmp snooping report-flooding switch-port ethernet 5-9
switch(config)# ip igmp snooping vlan 201-205 report-flooding switch-port ethernet
12-15
switch(config)#IGMP Snooping Filters
- Permit filters define the multicast groups the interface can join.
- Deny filters define the multicast groups the interface cannot join.
Profiles are created in IGMP-profile configuration mode, then applied to an interface in interface configuration mode.
The ip igmp profile command places the switch in IGMP profile configuration mode. The permit / deny and range commands specify the profile's filter type and address range. A profile may contain multiple range statements to define a discontiguous address range.
Example
switch(config)#ip igmp profile list_1
switch(config-igmp-profile-list_1)#permit
switch(config-igmp-profile-list_1)#range 231.22.24.0 231.22.24.127
switch(config-igmp-profile-list_1)#exit
switch(config)#The ip igmp snooping filter command applies an IGMP profile to the configuration mode interface.
Example
switch(config)#interface ethernet 7
switch(config-if-Et7)#ip igmp snooping filter list_1
switch(config-if-Et7)#Verifying IGMP Snooping
- show ip igmp snooping
- show ip igmp snooping counters
- show igmp snooping querier
- show igmp snooping querier counters
- show igmp snooping querier membership
IGMP Snooping Status
The show ip igmp snooping command displays the switch’s IGMP snooping configuration.
Example
switch>show ip igmp snooping
Global IGMP Snooping configuration:
-------------------------------------------
IGMP snooping : Enabled
Robustness variable : 2
Vlan 1 :
----------
IGMP snooping : Enabled
Multicast router learning mode : pim-dvmrp
Vlan 20 :
----------
IGMP snooping : Enabled
Multicast router learning mode : pim-dvmrp
Vlan 2028 :
switch>IGMP Snooping Counters
The show ip igmp snooping counters command displays the number of IGMP messages sent and received through each switch port. The display table sorts the messages by type.
Example
switch>show ip igmp snooping counters
Input | Output
Port Queries Reports Leaves Others Errors|Queries Reports Leaves Others
------------------------------------------------------------------------------
Cpu 15249 106599 4 269502 0 30242 102812 972 3625
Et1 0 0 0 0 0 0 0 0 0
Et2 0 6 1 26 0 5415 0 0 731
Et3 0 10905 222 1037 0 15246 0 0 1448
Et4 0 44475 21 288 0 15247 0 0 2199
Et5 0 355 0 39 0 15211 0 0 2446
Et6 0 475 13 0 0 15247 0 0 2487
Et7 0 0 0 151 0 15247 0 0 2336
Et8 0 578 6 75 0 2859 0 0 931
Et9 0 0 0 27 0 15247 0 0 2460
Et10 0 12523 345 54 0 15247 0 0 2433
Et11 0 0 0 0 0 0 0 0 0
Et12 0 4509 41 22 0 15247 0 0 2465
Et13 0 392 29 119 0 15247 0 0 2368
Et14 0 88 3 6 0 15247 0 0 2481
Et15 0 16779 556 72 0 15117 0 0 66
Et16 0 2484 13 66 0 15247 0 0 2421
Et17 0 0 0 0 0 0 0 0 0
Et18 0 20 6 160 0 3688 0 0 803
Et19 0 4110 17 0 0 15247 0 0 2487
Et20 0 0 0 0 0 0 0 0 0
Et21 0 0 0 0 0 0 0 0 0
Et22 0 0 0 52 0 15247 0 0 2435
Et23 0 5439 181 138 0 15247 0 0 2349
Et24 0 2251 21 4 0 15247 0 0 2483
Po1 45360 540670 8853 464900 0 15249 224751 618 2576
Po2 0 101399 58 17 0 15120 0 0 1121
Switch 0 0 0 0 0 0 0 0 0IGMP Snooping Querier
The show igmp snooping querier command displays snooping querier configuration and status information. Command provides options to only include specific VLANs.
Example
switch>show igmp snooping querier
Vlan IP Address Version Port
----------------------------------------
1 172.17.0.37 v2 Po1
20 172.17.20.1 v2 Po1
26 172.17.26.1 v2 Cpu
2028 172.17.255.29 v2 Po1
switch>IGMP Snooping Querier Counters
The show igmp snooping querier counters command displays the counters from the querier, as learned through Internet Group Management Protocol (IGMP).
Example
switch>show igmp snooping querier counters
-----------------------------------------------------------------------
Vlan: 1 IP Addr: 100.0.0.1 Op State: Querier Version: v3
v1 General Queries Sent :0
v1 Queries Received :0
v1 Reports Received :0
v2 General Queries Sent :1
v2 Queries Received :0
v2 Reports Received :25
v2 Leaves Received :0
v3 General Queries Sent :655
v3 GSQ Queries Sent :0
v3 GSSQ Queries Sent :8
v3 Queries Received :654
v3 Reports Received :2385
Error Packets :0
Other Packets :0
switch>IGMP Snooping Querier Membership
The show igmp snooping querier membership command displays the membership from the querier, as learned through Internet Group Management Protocol (IGMP).
Example
switch>show igmp snooping querier membership
-------------------------------------------------------------------------
Vlan: 1 Elected: 100.0.0.1 QQI: 125 QRV: 2 QRI: 10 GMI: 260
Groups Mode Ver Num of Sources
-------------------------------------------------------------------------
10.0.0.2 EX v3 0 []
10.0.0.3 IN v3 2 [ 3.3.3.3, 3.3.3.4 ]
10.0.0.4 EX v3 0 []
10.0.0.13 EX v3 0 []
10.0.0.22 EX v3 0 []
10.0.0.1 IN v3 3 [ 5.6.7.9, 5.6.7.8, ... ]
switch>Configuring IGMP Snooping Proxy
Use the ip igmp snooping proxy command to enable IGMP snooping proxy globally. Enabling IGMP snooping proxy enables it for all VLANs where IGMP snooping is enabled. IGMP snooping proxy is globally disabled by default.
Use the ip igmp snooping proxy command to enable IGMP snooping proxy globally. Use the no ip igmp snooping vlan proxy command to disable IGMP snooping proxy on specified VLANs.
-
This command globally enables IGMP snooping proxy on the switch.
switch(config)# ip igmp snooping proxy switch(config)# - This command disables IGMP snooping proxy on vlan
2, vlan 3,
and vlan
4.
switch(config)# no ip igmp snooping proxy vlan 2-4 proxy switch(config)#
Configuring Snooping Proxy Querier
To configure the IGMP snooping proxy querier use the existing ip igmp snooping querier commands. For more information on these commands, refer to IGMP and IGMP Snooping Commands.
switch(config)#ip igmp snooping proxy
switch(config)#no ip igmp snooping vlan 100-110 proxy
switch(config)#ip igmp snooping querier query-interval 15
switch(config)#ip igmp snooping querier max-response-time 5
switch(config)#ip igmp snooping querier version 3
switch(config)#ip igmp snooping querier
switch(config)#IGMP Host Proxy
Interfaces on the switch can be configured to serve as IGMP host proxies. An IGMP host proxy exchanges IGMP reports (joins/leaves) between networks whose connection does not support PIM along network boundaries.
IGMP Host Proxy Description
The figure displays a typical IGMP host-proxy implementation. The customer network connects to the sender network through the edge switch's Ethernet 1 interface, which is configured as an IGMP host proxy. PIM is enabled within the sender and customer networks but not on the connection between the networks.
The IGMP proxy agent sends unsolicited IGMP joins when a (S,G) or (*,G) entry arrives in the multicast routing table (mroute table). Subsequently, IGMP reports are sent when queries or group-specific queries arrive on the host proxy interface. When the customer network is void of active listeners, the connection eventually expires and the senders stop transmitting to the network.
- PIM Multicast Border Router (MBR) must be enabled on the interface.
- IP IGMP and IP multicast must be enabled.
- The switch must be an RP or in each host's RP path.
- Fast-drop entries are required when there are no interested listeners for the group.
IGMP host proxy is configurable to filter for specific multicast groups and sources.
IGMP Host Proxy Configuration
Enabling IGMP Host Proxy
Enable PIM MBR on the interface using the pim ipv4 border-router command. The IGMP host proxy service is then configured on the interface using the ip igmp host-proxy command. When the host proxy is configured, it sends reports for (S,G) entries in the multicast routing (mroute) table if these are the only routes there; if there are any (*,G) entries, it sends reports only for these. To send reports for a specific group even when there is no (*, G) entry in the mroute table for that group, include the group address in the ip igmp host-proxy command. Multiple ip igmp host-proxy statements are required to specify multiple groups. The interval between IGMP reports is configured by ip igmp host-proxy report-interval.
Host Proxy IGMP Version and Source Filtering
IGMP host proxies can be configured with IGMP versions 1, 2, or 3, and uses version 3 by default. When the host-proxy IGMP version is set to 3, the proxy can explicitly include or exclude source addresses. Otherwise, include/exclude configuration for source addresses is ignored. The IGMP version of unsolicited reports is specified with the ip igmp host-proxy version command. Reports that are triggered by IGMP queries, however, are sent in the same IGMP version as the received query. (An interface may also have a different IGMP version configured on it for other purposes using the ip igmp version command.)
Using ACLs
IGMP host proxy can also be enabled for the addresses defined by an ACL; if one or more groups are configured in addition to ACLs, the groups are processed first. Implicit deny in the ACL is ignored, but if the ACL includes an explicit deny rule, then the interface sends joins only to groups configured directly on the interface or included in a permit ACL. Deny rules take precedence over permit rules. If a group is configured with no filters and a host-proxy is configured with an ACL with rules having filters for the group, or configured with groups and source filters, then the filters are applied to the group.
Disabling Host Proxy or Removing an Individual Group or Source
The no igmp host-proxy command can be entered with group or source parameters to remove the specified group or source from the list. Entering the no igmp host-proxy command without specifying group or source disables the forwarding of all IGMP reports on the interface.
- These commands enable IGMP host proxy on interface ethernet
17 for all multicast group
addresses.
switch(config)# interface ethernet 17 switch(config-if-Et17)# pim ipv4 border-router switch(config-if-Et17)# ip igmp host-proxy switch(config-if-Et17)# - These commands enable IGMP host proxy on interface ethernet
18 for the multicast group at
231.10.10.1. The list of
source addresses is not
restricted.
switch(config)# interface ethernet 18 switch(config-if-Et18)# pim ipv4 border-router switch(config-if-Et18)# ip igmp host-proxy 231.10.10.1 switch(config-if-Et18)# - These commands enable IGMP host proxy on interface ethernet
19 for the multicast group at
231.10.10.2. The list of
source addresses only excludes
10.4.4.1 and
10.4.5.2.
switch(config)# interface ethernet 19 switch(config-if-Et19)# pim ipv4 border-router switch(config-if-Et19)# ip igmp host-proxy 231.10.10.2 exclude 10.4.4.1 switch(config-if-Et19)# ip igmp host-proxy 231.10.10.2 exclude 10.4.5.2 switch(config-if-Et19)# - These commands enable IGMP host proxy on interface ethernet
16 for the multicast group at
231.10.10.3. The list of
source address for this group only includes
10.5.5.1 and
10.5.5.2.
switch(config)# interface ethernet 16 switch(config-if-Et16)# pim ipv4 border-router switch(config-if-Et16)# ip igmp host-proxy 231.10.10.3 include 10.5.5.1 switch(config-if-Et16)# ip igmp host-proxy 231.10.10.3 include 10.5.5.2 switch(config-if-Et16)# - These commands configure an IGMP host proxy interval of
5 seconds on
interface port-channel
100.
switch(config)# interface port-channel 100 switch(config-if-Po100)# ip igmp host-proxy report-interval 5 switch(config-if-Po100)# - These commands enable IGMP host proxy on interface ethernet
17 for the group address(es)
specified in ACL
acl1.
switch(config)# interface ethernet 17 switch(config-if-Et17)# pim ipv4 border-router switch(config-if-Et17)# ip igmp host-proxy access-list acl1 switch(config-if-Et17)#
IGMP and IGMP Snooping Commands
IGMP Configuration Commands (Interface Configuration Mode)
IGMP Clear Commands
IGMP Display Commands
IGMP Snooping Configuration Commands (Global Configuration Mode)
- ip igmp
- ip igmp profile
- ip igmp snooping
- ip igmp snooping interface-restart-query
- ip igmp snooping proxy
- ip igmp snooping querier
- ip igmp snooping querier address
- ip igmp snooping querier last-member-query-count
- ip igmp snooping querier last-member-query-interval
- ip igmp snooping querier max-response-time
- ip igmp snooping querier query-interval
- ip igmp snooping querier startup-query-count
- ip igmp snooping querier startup-query-interval
- ip igmp snooping querier version
- ip igmp snooping report-flooding
- ip igmp snooping report-flooding switch-port
- ip igmp snooping restart query-interval
- ip igmp snooping robustness-variable
- ip igmp snooping vlan
- ip igmp snooping vlan fast-leave
- ip igmp snooping vlan max-groups
- ip igmp snooping vlan member
- ip igmp snooping vlan multicast-router
- ip igmp snooping vlan proxy
- ip igmp snooping vlan querier
- ip igmp snooping vlan querier address
- ip igmp snooping vlan querier last-member-query-count
- ip igmp snooping vlan querier last-member-query-interval
- ip igmp snooping vlan querier max-response-time
- ip igmp snooping vlan querier query-interval
- ip igmp snooping vlan querier startup-query-count
- ip igmp snooping vlan querier startup-query-interval
- ip igmp snooping vlan querier version
- ip igmp snooping vlan report-flooding
- ip igmp snooping vlan report-flooding switch-port
IGMP Configuration Commands (Interface Configuration Mode)
IGMP Snooping Clear Commands
IGMP Snooping Display Commands
- show igmp snooping querier
- show igmp snooping querier counters
- show igmp snooping querier membership
- show ip igmp profile
- show ip igmp snooping
- show ip igmp snooping counters
- show ip igmp snooping counters ethdev-pams
- show ip igmp snooping groups
- show ip igmp snooping groups count
- show ip igmp snooping mrouter
- show ip igmp snooping report-flooding
IGMP Profile Configuration Mode Commands
IGMP Host Proxy Commands
clear ip igmp group
The clear ip igmp group command deletes IGMP cache entries as follows:
- clear ip igmp group all entries from the IGMP cache.
- clear ip igmp group gp_addr all entries for a specified multicast group.
- clear ip igmp group interface int_id all entries that include a specified interface.
- clear ip igmp group gp_addr interface int_id all entries for a specified interface in a specified group.
Command Mode
Privileged EXEC
Command Syntax
clear ip igmp group [ gp_addr][ interface INT_ID]
- gp_addr multicast group IP address (dotted decimal notation).
- INT_ID interface name. Options include:
- ethernet e_num Ethernet interface specified by e_num.
- loopback l_num Loopback interface specified by l_num.
- management m_num Management interface specified by m_num.
- port-channel p_num Port-channel interface specified by p_num.
- vlan v_num VLAN interface specified by v_num.
- VXLAN vx_num VXLAN interface specified by vx_num.
- This command deletes all IGMP cache entries for the multicast group
231.23.23.14.
switch# clear ip igmp group 231.23.23.14 switch# - This command deletes IGMP cache entries for interface ethernet
16 in multicast group
226.45.10.45.
switch# clear ip igmp group 226.45.10.45 interface ethernet 16 switch#
clear ip igmp snooping counters
The clear ip igmp snooping counters command resets the snooping message counters for the specified interface. The snooping counters for all interfaces are reset if the command does not include an interface name.
The show ip igmp snooping counters command displays the counter contents. See the show ip igmp snooping counters command description for a list of available snooping counters.
Command Mode
Privileged EXEC
Command Syntax
clear ip igmp snooping counters [INT_NAME]
Parameters
- ethernet e_num Ethernet interface specified by e_num.
- port-channel p_num Port-channel interface specified by p_num.
- switch virtual interface to an L2 querier.
Example
switch(config)# clear ip igmp snooping counters ethernet 15
switch(config)#clear ip igmp statistics
The clear ip igmp statistics command resets IGMP transmission statistic counters for the specified interface.
Command Mode
Privileged EXEC
Command Syntax
clear ip igmp statistics [INTF_ID]
Parameters
- no parameter all interfaces.
- interface ethernet e_num Ethernet interface specified by e_num.
- interface loopback l_num Loopback interface specified by l_num.
- interface management m_num Management interface specified by m_num.
- interface port-channel p_num Port-channel interface specified by p_num.
- interface vlan v_num VLAN interface specified by v_num.
- interface xlan vx_num VXLAN interface specified by vx_num.
Example
switch# clear ip igmp statistics interface ethernet 1
switch#igmp query-max-response-time
The igmp query-max-response-time command configures the query-max-response-time variable for the configuration mode interface. This variable is used to set the Max Response Time field in outbound Membership Query messages. Max Response Time specifies the maximum period a recipient can wait before responding with a Membership Report.
The router with the lowest IP address on a subnet sends membership queries as the IGMP querier. When a membership query is received from a source with a lower IP address, the router resets its query response timer. Upon timer expiry, the router begins sending membership queries. If the router subsequently receives a membership query originating from a lower IP address, it stops sending membership queries and resets the query response timer.
The no igmp query-max-response-time and default igmp query-max-response-time commands restore the default query-max-response-time of 10 seconds for the configuration mode interface by removing the corresponding igmp query max-response-time command from running-config.
Command Mode
Interface-Ethernet Configuration
Interface-Port-Channel Configuration
Interface-VLAN Configuration
Command Syntax
igmp query-max-response-time period
no igmp query-max-response-time
default igmp query-max-response-time
Parameters
period maximum response time (deciseconds). Values range from 1 to 31744 (52 minutes, 54 seconds). Default is 100 (10 seconds).
Example
switch(config)# interface vlan 4
switch(config-if-Vl4)# igmp query-max-response-time 180
switch(config-if-Vl4)#ip igmp
The ip igmp command enables IGMP on a routed interface or on SVI (VLAN interface) without enabling PIM.
The no ip igmp command removes the corresponding ip igmp command from running-config.
Command Mode
Interface Configuration
Command Syntax
ip igmp
no ip igmp
Example
switch(config)# interface ethernet 5/2
switch(config-if-Et5/2)# ip igmp
switch(config-if-Et5/2)#ip igmp host-proxy
The ip igmp host-proxy command enables the IGMP host proxy service on the configuration mode interface. The IGMP host proxy performs IGMP joins and leaves between networks that are directly connected by an exchange that does not support PIM on the network boundary.
The IGMP host proxy sends unsolicited IGMP join reports when an (S,G) or (*,G) entry arrives in the multicast routing (mroute) table. Reports are subsequently sent upon the arrival of queries on the interface. The interval between IGMP reports is configured through ip igmp host-proxy report-interval.
The ip igmp host-proxy command can also specify a group address; this ensures that reports are generated for the specified group even if there is no (*,G) entry in the mroute table for that group. Multiple ip igmp host-proxy statements are required to specify multiple groups.
When the host proxy IGMP version is set to 3 using the ip igmp host-proxy version command, the ip igmp host-proxy command can also include or exclude source addresses. These options are ignored when the interface runs host proxy IGMP version 1 or 2. Note that the IGMP version set using the ip igmp version command does not affect host proxy behavior.
An ACL can also be used in place of a group address by using the access-list option. If one or more groups are configured in addition to ACLs, the groups are processed first. Implicit deny in the ACL is ignored, but if the ACL includes an explicit deny rule, then the interface sends joins only to groups configured directly on the interface or included in a permit ACL. Deny rules take precedence over permit rules. If a group is configured with no filters and a host-proxy is configured with an ACL with rules having filters for the group, or configured with groups and source filters, then the filters are applied to the group.
The no ip igmp host-proxy and default ip igmp host-proxy commands remove the corresponding ip igmp host-proxy command from running-config. When these commands do not include a group address, all ip igmp host-proxy statements are deleted. When inclusion or exclusion parameters are not specified, all statements with the specified group address are deleted.
Command Mode
Interface-Ethernet Configuration
Interface-Port-Channel Configuration
Interface-VLAN Configuration
Command Syntax
ip igmp host-proxy [GROUP_ADDRESS [SOURCE_ADDRESS]]|[access-list acl]
no ip igmp host-proxy [GROUP_ADDRESS [SOURCE_ADDRESS]]
default ip igmp host-proxy [GROUP_ADDRESS [SOURCE_ADDRESS]]
- GROUP_ADDRESS IPv4 address of group address for
which host proxy sends reports.
- no parameter only groups for which there is a (*,G) entry in the mroute table.
- ipv4_address IP address of multicast group (dotted decimal notation). This ensures that reports are generated for this group even if it does not have a (*,G) entry in the mroute table.
- SOURCE_ADDRESS IP address of a host that
originates multicast data packets.
- no parameter Proxy sends report for all received or configured groups regardless of source address.
- exclude ipv4_address Proxy does not send reports for specified source address.
- include ipv4_address Proxy always sends reports for specified source address.
Commands that list at least one parameter must specify a group address. Parameters may be listed in any order. When a command specifies include and exclude parameters, the exclude parameter is ignored.
- access-list acl specifies an access control list (ACL); a join is sent for all groups and/or sources obtained by processing the rules from all configured ACLs.
- version version specifies the IGMP version on IGMP host-proxy interface. The value ranges from 1 to 3. Default value is 3.
Guidelines
- ip igmp host-proxy: IGMP host proxy is enabled for all multicast groups and their source addresses. When enabled for all group addresses, the source address list cannot be restricted.
- ip igmp host-proxy group_ipv4: IGMP host proxy is enabled for a specified multicast group. The list of source addresses for this group is not restricted. Enabling host proxy for another group address requires another ip igmp host-proxy command.
- ip igmp host-proxy group_ipv4 exclude source_ipv4: IGMP host proxy is enabled for the specified multicast group. Sources for this group include all addresses not in an exclude statement. Multiple source addresses for the group are excluded by multiple statements.
- ip igmp host-proxy group_ipv4 include source_ipv4: IGMP host proxy is enabled for the specified group address for only the specified source address. Additional statements are required to include other source addresses for the group. The presence of one include parameter invalidates all exclude statements for the specified multicast group.
- ip igmp host-proxy access-list acl: IGMP host proxy is enabled for the addresses defined by the specified ACL. If one or more groups are configured in addition to ACLs, the groups are processed first. If the ACL has a deny all rule for a group, then this filter takes precedence over configurations with include /exclude keywords or permit/deny rules for that group. If a group is configured with no filters and a host-proxy is configured with an ACL with rules having filters for the group, or configured with groups and source filters, then the filters are applied to the group.
- These commands enable IGMP host proxy on interface ethernet
17 for all multicast group addresses.
switch(config)# interface ethernet 17 switch(config-if-Et17)# pim ipv4 border-router switch(config-if-Et17)# ip igmp host-proxy switch(config-if-Et17)# - These commands enable IGMP host proxy on interface ethernet
17 for the multicast group at
231.10.10.1. The list of source addresses
is not
restricted.
switch(config)# interface ethernet 17 switch(config-if-Et17)# pim ipv4 border-router switch(config-if-Et17)# ip igmp host-proxy 231.10.10.1 switch(config-if-Et17)# - These commands enable IGMP host proxy on interface ethernet
17 for the multicast group at
231.10.10.2. The list of source addresses
only excludes 10.4.4.1 and
10.4.5.2.
switch(config)# interface ethernet 17 switch(config-if-Et17)# pim ipv4 border-router switch(config-if-Et17)# ip igmp host-proxy 231.10.10.2 exclude 10.4.4.1 switch(config-if-Et17)# ip igmp host-proxy 231.10.10.2 exclude 10.4.5.2 switch(config-if-Et17)# - These commands enable IGMP host proxy on interface ethernet
17 for the multicast group at
231.10.10.3. The list of source address
for this group only includes 10.5.5.1 and
10.5.5.2.
switch(config)# interface ethernet 17 switch(config-if-Et17)# pim ipv4 border-router switch(config-if-Et17)# ip igmp host-proxy 231.10.10.3 include 10.5.5.1 switch(config-if-Et17)# ip igmp host-proxy 231.10.10.3 include 10.5.5.2 switch(config-if-Et17)# - These commands enable IGMP host proxy on interface ethernet
17 for the group address(es) specified in ACL
acl1.
switch(config)# interface ethernet 17 switch(config-if-Et17)# pim ipv4 border-router switch(config-if-Et17)# ip igmp host-proxy access-list acl1 switch(config-if-Et17)#
ip igmp host-proxy report-interval
The ip igmp host-proxy report-interval command configures the period between unsolicited join reports that the switch sends as an IGMP host proxy from the configuration mode interface to a sender network after a (S,G) or (*,G) entry arrives in the multicast route (mroute) table. When the interface receives a query in response, this interval is set to the ip igmp last-member-query-interval. This command also enables the host proxy on the configuration mode interface if it was not previously enabled.
The no ip igmp host-proxy report-interval and default ip igmp host-proxy report-interval commands reset the query interval to the default value of one second by removing the corresponding ip igmp host-proxy report-interval command from running-config. The no ip igmp host-proxy and default ip igmp host-proxy commands also remove the corresponding report-interval command.
Command Mode
Interface-Ethernet Configuration
Interface-Port-Channel Configuration
Interface-VLAN Configuration
Command Syntax
ip igmp host-proxy report-interval period
no ip igmp host-proxy report-interval
default ip igmp host-proxy report-interval
Parameters
period transmission interval (seconds) between consecutive reports. Value range: 1 (one second) to 31744 (8 hours, 49 minutes, 4 seconds). Default is 1 (one second).
Example
switch(config)# interface port-channel 100
switch(config-if-Po100)# ip igmp host-proxy report-interval 5
switch(config-if-Po100)#ip igmp host-proxy version
The ip igmp host-proxy version command configures the version number to be used in unsolicited reports when the interface is serving as an IGMP host proxy. To configure the IGMP version used by the interface for other purposes, use the ip igmp version command instead.
The no ip igmp host-proxy version and default ip igmp host-proxy version commands reset the version to the default value of 3.
Command Mode
Interface-Ethernet Configuration
Interface-Port-Channel Configuration
Interface-VLAN Configuration
Command Syntax
ip igmp host-proxy version version_number
no ip igmp host-proxy version
default ip igmp host-proxy version
Parameters
version_number values range from 1 to 3. The default value is 3.
Example
switch(config)# interface port-channel 100
switch(config-if-Po100)# ip igmp host-proxy version 2
switch(config-if-Po100)#ip igmp last-member-query-count
The ip igmp last-member-query-count command specifies the number of query messages the switch sends in response to a group-specific or group-source-specific leave message.
After receiving a message from a host leaving a group, the switch sends query messages at intervals specified by ip igmp last-member-query-interval. If the switch does not receive a response to the queries after sending the number of messages specified by this parameter, it stops forwarding messages to the host.
Setting the Last Member Query Count (LMQC) to 1 causes the loss of a single packet to stop traffic forwarding. While the switch can start forwarding traffic again after receiving a response to the next general query, the host may not receive that query for a period defined by ip igmp query-interval.
The no ip igmp last-member-query-count and default ip igmp last-member-query-count commands reset the LMQC to the default value by removing the corresponding ip igmp last-member-query-count command from running-config.
Command Mode
Interface-Ethernet Configuration
Interface-Port-Channel Configuration
Interface-VLAN Configuration
Command Syntax
ip igmp last-member-query-count number
no ip igmp last-member-query-count
default ip igmp last-member-query-count
Parameters
number query message quantity. Values range from 0 to 3. Default is 2.
Example
switch(config)# interface vlan 4
switch(config-if-Vl4)# ip igmp last-member-query-count 3
switch(config-if-Vl4)#ip igmp last-member-query-interval
The ip igmp last-member-query-interval command configures the switch's transmission interval for sending group-specific or group-source-specific query messages from the configuration mode interface.
When a switch receives a message from a host that is leaving a group it sends query messages at intervals set by this command. The ip igmp startup-query-count specifies the number of messages that are sent before the switch stops forwarding packets to the host.
If the switch does not receive a response after this period, it stops forwarding traffic to the host on behalf of the group, source, or channel.
The no ip igmp last-member-query-interval and default ip igmp last-member-query-interval commands reset the query interval to the default value of one second by removing the ip igmp last-member-query-interval command from running-config.
Command Mode
Interface-Ethernet Configuration
Interface-Port-Channel Configuration
Interface-VLAN Configuration
Command Syntax
ip igmp last-member-query-interval period
no ip igmp last-member-query-interval
default ip igmp last-member-query-interval
Parameter
period transmission interval (deciseconds) between consecutive group-specific query messages. Value range: 10 (one second) to 317440 (8 hours, 49 minutes, 4 seconds). Default is 10 (one second).Example
switch(config)# interface vlan 4
switch(config-if-Vl4)# ip igmp last-member-query-interval 60
switch(config-if-Vl4)#ip igmp profile
The ip igmp profile command places the switch in the IGMP-profile configuration mode to configure an IGMP profile. IGMP profiles control the multicast groups that an interface can join.
Profiles consist of the filter type and an address range:
- Permit filters define the multicast groups the interface can join.
- Deny filters define the multicast groups the interface cannot join.
Profiles are deny filters by default.
- In permit filters, permitted groups are specified by the address range.
- In deny filters, all groups are permitted except those specified by the address range.
- IGMPv2: Report is forwarded to mrouters for permitted groups and dropped for disallowed groups.
- IGMPv3: There may be multiple group records in a report.
- No groups are allowed: The report is dropped.
- All groups are allowed: The report is forwarded to mrouter ports as normal.
- Some groups are allowed: A revised report is forwarded to mrouter ports.
The revised report includes records for the allowed group addresses with the same source MAC and IP addresses.
The no ip igmp profile and default ip igmp profile commands delete the specified IGMP profile from running-config.
The IGMP-profile configuration mode is not a group change mode; running-config is changed immediately upon entering commands. Exiting IGMP-profile configuration mode does not affect the configuration. The exit command returns the switch to global configuration mode.
Command Mode
Global Configuration
Command Syntax
ip igmp profile profile_name
no ip igmp profile profile_name
default igmp profile profile_name
Parameters
profile_name name of the IGMP profile.
Related Commands
ip igmp snooping filter applies an IGMP snooping filter to a configuration mode interface.
Example
switch(config)# ip igmp profile list_1
switch(config-igmp-profile-list_1)# permit
switch(config-igmp-profile-list_1)#ip igmp query-interval
The ip igmp query-interval command configures the frequency at which the configuration mode interface, as an IGMP querier, sends host-query messages.
An IGMP querier sends host-query messages to discover the multicast groups that have members on networks attached to the interface. The switch implements a default query interval of 125 seconds.
The no ip igmp query-interval and default ip igmp query-interval commands reset the IGMP query interval to the default value of 125 seconds by removing the ip igmp query-interval command from running-config.
Command Mode
Interface-Ethernet Configuration
Interface-Port-Channel Configuration
Interface-VLAN Configuration
Command Syntax
ip igmp query-interval period
no ip igmp query-interval
default ip igmp query-interval
Parameter
period interval (seconds) between IGMP query messages. Values range from 1 to 3175 (52 minutes, 55 seconds). Default is 125.
Example
switch(config)# interface vlan 4
switch(config-if-Vl4)# ip igmp query-interval 150
switch(config-if-Vl4)#ip igmp router-alert
The ip igmp router-alert command configures the switch disposition of inbound IGMP packets to the configuration mode interface based on the presence of the router-alert option in the IP header. By default, the port accepts all IGMP packets that arrive on the local subnet and rejects all other packets that arrive without the router-alert option.
- mandatory: packets are accepted only when router-alert is present.
- optional: packets are accepted regardless of router-alert presence.
- optional connected: packets are accepted from the same subnet; other packets require router-alert.
The no ip igmp router-alert and default ip igmp router-alert commands reset the default setting of optional connected on the configuration mode interface by removing the corresponding ip igmp router-alert command from running-config.
Command Mode
Interface-Ethernet Configuration
Interface-Port-Channel Configuration
Interface-VLAN Configuration
Command Syntax
ip igmp router-alert DISPOSITION
no ip igmp router-alert
default ip igmp router-alert
Parameters
- mandatory Rejects packets if router-alert is not present.
- optional Accepts packets regardless of router-alert presence.
- optional connected Accepts packets from same subnet. Other packets require router-alert.
Example
switch(config)# interface ethernet 8
switch(config-if-Et8)# ip igmp router-alert mandatory
switch(config-if-Et8)#ip igmp snooping
The ip igmp snooping command enables snooping globally. By default, global snooping is enabled.
When global snooping is enabled, ip igmp snooping vlan enables or disables snooping on individual VLANs. When global snooping is disabled, snooping cannot be enabled on individual VLANs.
QoS cannot be used for IGMP packets when IGMP snooping is enabled.
The no ip igmp snooping command disables global snooping. The default ip igmp snooping command restores the global snooping default setting of enabled by removing the ip igmp snooping command from running-config.
Command Mode
Global Configuration
Command Syntax
ip igmp snooping
no ip igmp snooping
default ip igmp snooping
Example
switch(config)# ip igmp snooping
switch(config)#ip igmp snooping filter
- Filter type: Specifies accessibility to the listed address range:
- Permit filters define the multicast groups the interface can join.
- Deny filters define the multicast groups the interface cannot join.
- Address range: Specifies a list of addresses and ranges.
- In permit filters, the permitted groups are specified by the address range.
- In deny filters, all groups are permitted except those specified by the address range.
An interface without a snooping profile assignment may join any multicast group.
Snooping profiles are configured in IGMP-profile configuration mode (ip igmp profile).
The no ip igmp snooping filter and default ip igmp snooping filter commands restore the default setting of allowing an interface to join any multicast group by deleting the corresponding ip igmp snooping filter command from running-config.
Command Mode
Interface-Ethernet Configuration
Interface-Port-Channel Configuration
Command Syntax
ip igmp snooping filter profile_name
no ip igmp snooping filter [profile_name]
default ip igmp snooping filter [profile_name]
Parameters
profile_name name of profile assigned to interface.
Example
switch(config)# interface ethernet 7
switch(config-if-Et7)# ip igmp snooping filter list_1
switch(config-if-Et7)#ip igmp snooping interface-restart-query
The ip igmp snooping interface-restart-query command configures the interface startup initial query time used for IGMP query spoofing. When an interface restarts or there is a change to the spanning tree, the interface will send general IGMP queries after this interval. The query is based on the information of the last known IGMP querier, and serves to facilitate faster network convergence times.
Multiple values can be configured with a single command; issuing the command again replaces any previously configured value(s).
The no ip igmp snooping interface-restart-query and default ip igmp snooping interface-restart-query commands restore the default setting of 2000 milliseconds by deleting the corresponding ip igmp snooping interface-restart-query command from running-config.
Command Mode
General Configuration
Command Syntax
ip igmp snooping interface-restart-query query_time
no ip igmp snooping interface-restart-query
default ip igmp snooping interface-restart-query
Parameters
query_time interval (in milliseconds) after an interface restart or spanning tree change at which the interface will send general IGMP queries. Values range from 100 to 50000 milliseconds; default is 2000.
Example
switch(config)# ip igmp snooping interface-restart-query 100 200 300
switch(config)#ip igmp snooping proxy
The ip igmp snooping proxy command enables snooping proxy globally. By default, IGMP snooping proxy is disabled globally.
When the snooping proxy is enabled globally, it enables IGMP snooping proxy on an individual VLANs and when the IGMP snooping proxy is globally disabled the snooping proxy is disabled on individual VLANs.
The no ip igmp snooping proxy and default ip igmp snooping proxy commands disable snooping proxy globally and on individual VLANs by removing the ip igmp snooping proxy command from running-config.
Command Mode
Global Configuration
Command Syntax
ip igmp snooping proxy
no ip igmp snooping proxydefault ip igmp snooping proxy
- This command globally enables snooping proxy on the
switch.
switch(config)# ip igmp snooping proxy switch(config)# - This command explicitly disables IGMP snooping proxy on vlan
20.
switch(config)# no ip igmp snooping vlan 20 proxy switch(config)#
ip igmp snooping querier
The ip igmp snooping querier command enables the snooping querier globally, which controls the querier for VLANs that are not configured with a snooping querier command. The ip igmp snooping vlan querier command controls the querier on individual VLANs.
The IGMP snooping querier supports snooping by sending Layer 2 membership queries to hosts attached to the switch. The snooping querier is functional on VLANs where hosts receive IP multicast traffic without access to a network IP multicast router. A snooping querier avoids flooding multicast packets in the VLAN by querying for hosts and routers.
- Snooping is enabled.
- The corresponding SVI (VLAN interface) is active.
- The VLAN querier IP address or the global querier IP address is configured.
The no ip igmp snooping querier and default ip igmp snooping querier commands disable the snooping querier globally by removing the ip igmp snooping querier statement from running-config. The snooping querier is globally disabled by default.
Command Mode
Global Configuration
Command Syntax
ip igmp snooping querier
no ip igmp snooping querier
default ip igmp snooping querier
- Enabling a querier after it was disabled is equivalent to establishing a new querier.
- Changing the querier IP address is equivalent to establishing a new querier.
Example
switch(config)# ip igmp snooping querier
switch(config)#ip igmp snooping querier address
The ip igmp snooping querier address command sets the global querier source IP address, which specifies the source address for packets transmitted from VLANs for which a querier address (ip igmp snooping vlan querier address) is not configured. To use a snooping querier, an address must be explicitly configured globally or for the VLAN.
The switch does not define a default global querier address.
The no ip igmp snooping querier address and default ip igmp snooping querier address commands remove the global querier address command from running-config.
Command Mode
Global Configuration
Command Syntax
ip igmp snooping querier address ipv4_address
no ip igmp snooping querier address
default ip igmp snooping querier address
Parameter
ipv4_address source IPv4 address.
Example
switch(config)# ip igmp snooping querier address 10.1.1.41
switch(config)#ip igmp snooping querier last-member-query-count
The ip igmp snooping querier last-member-query-count command configures the global igmp snooping querier last member query count (LMQC) value. LMQC specifies the number of query messages the switch sends in response to group-specific or group-source-specific leave messages it receives from a host; the transmission frequency is specified by igmp snooping querier last member query count. The switch stops forwarding messages to the host if it does not receive a response to these query messages.
Setting LMQC to 1 causes the loss of one packet to stop traffic forwarding. While the switch can start forwarding traffic again after receiving a response to the next general query, the host may not receive that query for a period defined by ip igmp snooping querier query-interval.
VLANs use the global value when they are not assigned a value (ip igmp snooping vlan querier last-member-query-count). VLAN commands take precedence over the global value. The default global value is specified by the robustness variable (ip igmp snooping robustness-variable).
The no igmp snooping querier last-member-query-count and default igmp snooping querier last-member-query-count commands reset the LMQC to the default value by removing the corresponding ip igmp snooping querier last-member-query-count command from running-config.
Command Mode
Global Configuration
Command Syntax
ip igmp snooping querier last-member-query-count number
no ip igmp snooping querier last-member-query-count
default ip igmp snooping querier last-member-query-count
Parameter
number query message quantity. Value ranges from 1 to 3. Default is set by robustness-variable.
Example
switch(config)# ip igmp snooping querier last-member-query-count 3
switch(config)# show igmp snooping querier status
Global IGMP Querier status
-------------------------------------------------------
admin state : Disabled
source IP address : 0.0.0.0
query-interval (sec) : 125.0
max-response-time (sec) : 10.0
querier timeout (sec) : 255.0
last-member-query-interval (sec) : 1.0
last-member-query-count : 3
startup-query-interval (sec) : 31.25 (query-interval/4)
startup-query-count : 2 (robustness)
Vlan Admin IP Query Response Querier Operational Ver
State Interval Time Timeout State
-----------------------------------------------------------------------
1 Disabled 0.0.0.0 125.0 10.0 255.0 Non-Querier v2
100 Disabled 0.0.0.0 125.0 10.0 255.0 Non-Querier v2
101 Disabled 0.0.0.0 125.0 10.0 255.0 Non-Querier v2
switch(config)#ip igmp snooping querier last-member-query-interval
The ip igmp snooping querier last-member-query-interval command sets the global IGMP snooping last member query interval. The default interval is 1 second.
A multicast host sends an IGMP leave report when it leaves a group. To determine if the host was the last group member, the leave message recipient sends an IGMP query. The last-member-query-interval determines when the group record is deleted if no subsequent reports are received.
VLANs not assigned a last-member-query-interval value (ip igmp snooping vlan querier last-member-query-interval) use the global value. VLAN commands take precedence over the global value.
The no ip igmp snooping querier last-member-query-interval and default ip igmp snooping querier last-member-query-interval commands reset the last-member-query-interval value the default interval of one second by removing the ip igmp snooping querier last-member-query-interval statement from running-config.
Command Mode
Global Configuration
Command Syntax
ip igmp snooping querier last-member-query-interval period
no ip igmp snooping querier last-member-query-interval
default ip igmp snooping querier last-member-query-interval
Parameter
period last member query interval (seconds). Value ranges from 1 to 25. Default is 1 second.
Related Commands
ip igmp snooping vlan querier last-member-query-interval assign a last member query interval value to the specified VLANs.
Example
switch(config)# ip igmp snooping querier last-member-query-interval 5
switch(config)#ip igmp snooping querier max-response-time
The ip igmp snooping querier max-response-time command specifies the global max-response-time value. The switch uses max-response-time to set the Max Response Time field in outbound Membership Query messages. Max Response Time specifies the maximum period a recipient can wait before responding with a Membership Report.
VLANs not assigned a max-response-time value (ip igmp snooping vlan querier max-response-time) use the global value. VLAN commands take precedence over the global value.
Values range from 1 to 25 seconds. The default global value is 10 seconds.
The no ip igmp snooping querier max-response-time and default ip igmp snooping querier max-response-time commands restore the global max-response-time default value by removing the ip igmp snooping querier max-response-time statement from running-config.
Command Mode
Global Configuration
Command Syntax
ip igmp snooping querier max-response-time resp_sec
no ip igmp snooping querier max-response-time
default ip igmp snooping querier max-response-time
Parameters
resp_sec max-response-time value (seconds). Values range from 1 to 25. Default (global) is 10.
Example
switch(config)# ip igmp snooping querier max-response-time 15
switch(config)#ip igmp snooping querier query-interval
The ip igmp snooping querier query-interval command sets the global query interval. This command also sets the query-interval of IGMP Snooping when using IGMP version 2. Values range from 5 to 3600 seconds. The default global value is 125 seconds. The query interval is the period between IGMP Membership Query messages sent from the querier. The global value specifies the query interval for VLANs with no query-interval command.
VLANs not assigned a query interval value (ip igmp snooping vlan querier query-interval) use the global value. VLAN commands take precedence over the global value.
The no ip igmp snooping querier query-interval and default ip igmp snooping querier query-interval commands reset the global query-interval value to 125 seconds by removing the ip igmp snooping querier query-interval statement from running-config.
Command Mode
Global Configuration
Command Syntax
ip igmp snooping querier query-interval query_sec
no ip igmp snooping querier query-interval
default ip igmp snooping querier query-interval
Parameter
query_sec query interval (seconds). Values range from 5 to 3600. Default (global) is 125.
Example
switch(config)# ip igmp snooping querier query-interval 150
switch(config)#ip igmp snooping querier startup-query-count
The ip igmp snooping querier startup-query-count command configures the global startup query count value. The startup query count specifies the number of query messages that the querier sends on a VLAN during the startup query interval ( ip igmp snooping querier startup-query-interval).
When snooping is enabled, the group state is more quickly established by sending query messages at a higher frequency. The startup-query-interval and startup-query-count parameters define the startup period by defining the number of queries to be sent and transmission frequency for these messages.
VLANs use the global startup query count value when they are not assigned a value (ip igmp snooping vlan querier startup-query-count). VLAN commands take precedence over the global value. The default global value is specified by the robustness variable (ip igmp snooping robustness-variable).
The no ip igmp snooping querier startup-query-count and default ip igmp snooping querier startup-query-count commands restore the default startup-query-count value by removing the corresponding ip igmp snooping querier startup-query-count command from running-config.
Command Mode
Global Configuration
Command Syntax
ip igmp snooping querier startup-query-count number
no ip igmp snooping querier startup-query-count
default ip igmp snooping querier startup-query-count
Parameter
number global startup query count. Value ranges from 1 to 3.
Example
switch(config)# ip igmp snooping querier startup-query-count 2
switch(config)# show igmp snooping querier status
Global IGMP Querier status
-------------------------------------------------------
admin state : Disabled
source IP address : 0.0.0.0
query-interval (sec) : 125.0
max-response-time (sec) : 10.0
querier timeout (sec) : 255.0
last-member-query-interval (sec) : 1.0
last-member-query-count : 2 (robustness)
startup-query-interval (sec) : 31.25 (query-interval/4)
startup-query-count : 2
Vlan Admin IP Query Response Querier Operational Ver
State Interval Time Timeout State
-----------------------------------------------------------------------
1 Disabled 0.0.0.0 125.0 10.0 255.0 Non-Querier v2
100 Disabled 0.0.0.0 125.0 10.0 255.0 Non-Querier v2
101 Disabled 0.0.0.0 125.0 10.0 255.0 Non-Querier v2
switch(config)#ip igmp snooping querier startup-query-interval
The ip igmp snooping querier startup-query-interval command configures the global startup query interval value. The startup query interval specifies the period between query messages that the querier sends upon startup.
When snooping is enabled, the group state is more quickly established by sending query messages at a higher frequency. The startup-query-interval and startup-query-count parameters define the startup period by defining the number of queries to be sent and transmission frequency for these messages.
VLANs use the global startup query interval value when they are not assigned a value (ip igmp snooping vlan querier startup-query-interval). VLAN commands take precedence over the global value. The default global value equals the query interval divded by four. (ip igmp snooping querier query-interval).
The no ip igmp snooping querier startup-query-interval and default ip igmp snooping querier startup-query-interval commands restore the default method of specifying the startup query interval by removing the corresponding ip igmp snooping querier startup-query-interval command from running-config.
Command Mode
Global Configuration
Command Syntax
ip igmp snooping querier startup-query-interval period
no ip igmp snooping querier startup-query-count
default ip igmp snooping querier startup-query-count
Parameter
period startup query interval (seconds). Value ranges from 1 to 3600 (1 hour).
Example
switch(config)# ip igmp snooping querier startup-query-interval 40
switch(config)# show igmp snooping querier status
Global IGMP Querier status
-------------------------------------------------------
admin state : Enabled
source IP address : 0.0.0.0
query-interval (sec) : 125.0
max-response-time (sec) : 10.0
querier timeout (sec) : 255.0
last-member-query-interval (sec) : 1.0
last-member-query-count : 2 (robustness)
startup-query-interval (sec) : 40.0
startup-query-count : 2
Vlan Admin IP Query Response Querier Operational Ver
State Interval Time Timeout State
-----------------------------------------------------------------------
1 Enabled 0.0.0.0 125.0 10.0 255.0 Non-Querier v3
100 Enabled 0.0.0.0 125.0 10.0 255.0 Non-Querier v3
101 Enabled 0.0.0.0 125.0 10.0 255.0 Non-Querier v3
switch(config)#ip igmp snooping querier version
The ip igmp snooping querier version command configures the Internet Group Management Protocol (IGMP) snooping querier version on the configuration mode interfaces. Version 3 is the default IGMP version.
IGMP is enabled by the pim ipv4 sparse-mode or pim ipv4 bidirectional command. The ig igmp snooping querier version command does not affect the IGMP enabled status.
The no ip igmp snooping querier version and default ip igmp snooping querier version commands restore the configuration mode to IGMP version 3 by removing the ip igmp snooping querier version statement from running-config.
Command Mode
Global Configuration
Command Syntax
ip igmp snooping querier version version_number
no ip igmp snooping querier startup-query-count
default ip igmp snooping querier startup-query-count
Parameter
version_number IGMP version number. Value ranges from 1 to 3. Default value is 3.
- This command configures IGMP snooping querier version
2.
switch(config)# ip igmp snooping querier version 2 switch(config)#
switch(config)# no ip igmp snooping querier version
switch(config)#ip igmp snooping report-flooding
The ip igmp snooping report-flooding command globally enables L2 report flooding on the switch. When report flooding is globally enabled, the ip igmp snooping vlan report-flooding configures a VLAN range to forward membership report messages to specified ports. When report flooding is not globally enabled, L2 report flooding cannot be enabled on individual VLANs.
L2 report flooding is an IGMP snooping feature that forwards membership report messages to specified ports. Relying on a single switch to maintain and send report messages can result in performance issues. L2 report flooding addresses this by facilitating report message transmissions through any network port. This allows switches to bypass the querier when forwarding multicast traffic to its interested ports.
The no ip igmp snooping report-flooding and default ip igmp snooping report-flooding commands disable global L2 report flooding by removing ip igmp report flooding from running-config. L2 report flooding is disabled by default.
Command Mode
Global Configuration
Command Syntax
ip igmp snooping report-flooding
no ip igmp snooping report-flooding
default ip igmp snooping report-flooding
Related Command
ip igmp snooping vlan report-flooding enables L2 report flooding on a specified VLAN range.
Example
switch(config)# ip igmp snooping report-flooding
switch(config)#ip igmp snooping report-flooding switch-port
The ip igmp snooping report-flooding switch-port command specifies Ethernet ports or port channels that can forward IGMP membership report messages for all VLANs where L2 report flooding is enabled. Ports that are connected to multicast routers or queriers continue to forward traffic as previously specified and are not affected by L2 report flooding commands.
L2 report flooding is an IGMP snooping feature that forwards membership report messages to specified ports. The ip igmp snooping vlan report-flooding switch-port command configures a list of forwarding ports for a specified VLAN range.
The no ip igmp snooping report-flooding switch-port and default ip igmp snooping report-flooding switch-port commands remove the specified ports from the global report flooding port list by deleting the corresponding ip igmp snooping report-flooding switch-port command from running-config.
Command Mode
Global Configuration
Command Syntax
ip igmp snooping report-flooding switch-port INTERFACE
no ip igmp snooping report-flooding switch-port INTERFACE
default ip igmp snooping report-flooding switch-port INTERFACE
Parameters
- ethernet e_rangewhere e_range is the number, range, or list of ethernet ports.
- port-channel p_range where p_range is the number, range, or list of channel ports.
- ip igmp snooping report-flooding globally enables L2 report flooding.
- ip igmp snooping vlan report-flooding switch-port specifies a port list for a VLAN range.
Example
switch(config)# ip igmp snooping report-flooding switch-port ethernet 7-9
switch(config)#ip igmp snooping restart query-interval
The ip igmp snooping restart query-interval command sets the query interval for all VLANs during an IGMP snooping restart. By default, the query interval during an IGMP snooping restart is a VLAN configured query interval divided by five. This accelerates the transmission of robustness queries to establish the IGMP snooping state more quickly. However, some large scale configurations may not be able to process all of the queries at this query interval rate. The restart query interval, when configured, is valid for all VLANs.
The no ip igmp snooping resrtart query-interval and default ip igmp snooping restart query-interval commands removes the global restart query interval by deleting the ip igmp snooping restart query-interval statement from running-config.
Command Mode
Global Configuration
Command Syntax
ip igmp snooping restart query-interval query_sec
no ip igmp snooping restart query-interval
default ip igmp snooping restart query-interval
Parameter
query_sec query interval (seconds). Values range from 2 to 400. Default (global) is 125.
Example
switch(config)# ip igmp snooping restart query-interval 35
switch(config)#ip igmp snooping robustness-variable
The ip igmp snooping robustness-variable command configures the robustness variable for snooping packets sent from any VLAN.
The robustness variable specifies the number of unacknowledged snooping queries that a switch sends before removing the recipient from the group list.
The no ip igmp snooping robustness-variable and default ip igmp snooping robustness-variable commands reset the robustness variable to 2 by removing the ip igmp snooping robustness-variable command from running-config.
Command Mode
Global Configuration
Command Syntax
ip igmp snooping robustness-variable robust_value
no ip igmp snooping robustness-variable
default ip igmp snooping robustness-variable
Parameter
robust_value robustness variable. Values range from 1 to 3. Default is 2.
Example
switch(config)# ip igmp snooping robustness-variable 3
switch(config)#ip igmp snooping vlan
The ip igmp snooping vlan command enables snooping on the specified VLANs if snooping is globally enabled. IGMP snooping is globally enabled by default. The ip igmp snooping command enables snooping globally.
Note that if IGMP snooping is enabled, QoS will not apply to IGMP packets.
The no ip igmp snooping vlan command disables snooping on the specified VLANs.
The default ip igmp snooping vlan command returns the snooping setting for the specified VLANs to enabled by removing the corresponding ip igmp snooping vlan command from running-config.
Command Mode
Global Configuration
Command Syntax
ip igmp snooping vlan v_range
no ip igmp snooping vlan v_range
default ip igmp snooping vlan v_range
Parameter
v_range VLANs upon which snooping is enabled. Formats include a number, a number range, or a comma-delimited list of numbers and ranges. Numbers range from 1 to 4094.
Example
switch(config)# no ip igmp snooping vlan 2-4
switch(config)#ip igmp snooping vlan fast-leave
The ip igmp snooping vlan fast-leave command enables fast-leave processing on specified VLANs. When fast-leave processing is enabled, the removal of a VLAN interface's multicast group entry from the IGMP table is not preceded by an IGMP group-specific query to the interface. The switch removes an interface from the forwarding table when it detects an IGMP leave message on the interface. IGMP fast-leave processing is enabled on all VLANs by default.
The no ip igmp snooping vlan fast-leave command disables fast-leave processing on the specified VLANs. The default ip igmp snooping vlan fast-leave command restores fast-leave processing on the specified VLANs by removing the corresponding no ip igmp snooping vlan fast-leave statement from running-config.
Command Mode
Global Configuration
Command Syntax
ip igmp snooping vlan v_range fast-leave
no ip igmp snooping vlan v_range fast-leave
default ip igmp snooping vlan v_range fast-leave
Parameter
v_range VLAN IDs. Formats include a number, number range, or comma-delimited list of numbers and ranges. Numbers range from 1 to 4094.
Example
switch(config)# ip igmp snooping vlan 10 fast-leave
switch(config)#ip igmp snooping vlan max-groups
The ip igmp snooping vlan max-groups command configures the quantity of multicast groups that the specified VLAN forwarding table can contain. After the limit is reached, attempts to join new groups are ignored. There is no default limit.
The no ip igmp snooping vlan max-groups and default ip igmp snooping vlan max-groups removes the maximum group limit by deleting the ip igmp snooping vlan max-groups statement from running-config.
Command Mode
Global Configuration
Command Syntax
ip igmp snooping vlan v_range max-groups quantity
no ip igmp snooping vlan v_range max-groups
default ip igmp snooping vlan v_rangemax-groups
- v_range VLAN IDs. Formats include a number, number range, or comma-delimited list of numbers and ranges. Numbers range from 1 to 4094.
- quantity maximum number of groups that can access the VLAN. Value ranges from 0 to 65534.
- This command limits the number of multicast groups that hosts on
vlan 6 can simultaneously access to
25.
switch(config)# ip igmp snooping vlan 6 max-groups 25 switch(config)# - This command allows each VLAN between 8 and
15 to receive multicast packets from
30
groups.
switch(config)# ip igmp snooping vlan 8-15 max-groups 30 switch(config)# - This command removes the maximum group restriction from all VLAN interfaces
between 1 and
50.
switch(config)# no ip igmp snooping vlan 1-50 max-groups switch(config)#
ip igmp snooping vlan member
The ip igmp snooping vlan member command adds ports as static members to a multicast group. The ports must be in the specified VLAN range.
The no ip igmp snooping vlan member and default ip igmp snooping vlan member commands remove the specified ports from the multicast group by deleting the corresponding ip igmp snooping member statements from running-config.
Command Mode
Global Configuration
Command Syntax
ip igmp snooping vlan v_num member ipv4_addr interface STATIC_INT
no ip igmp snooping vlan v_num member ipv4_addr interface STATIC_INT
default ip igmp snooping vlan v_num member ipv4_addr interface STATIC_INT
- v_num VLAN number. Value ranges from 1 to 4094.
- ipv4_addr multicast group IPv4 address.
- STATIC_INT interface the command configures as the
static group member. Options include:
- ethernet e_range, where e_range is the number, range, or list of Ethernet ports.
- port-channel p_range, where p_range is the number, range, or list of channel ports.
Example
switch(config)# ip igmp snooping vlan 7 member 237.2.1.4 interface ethernet 3
switch(config)#ip igmp snooping vlan multicast-router
The ip igmp snooping vlan multicast-router command adds a multicast router as a static port to the specified VLANs. The router port must be in the specified VLAN range.
Snooping may not always be able to locate the IGMP querier. This command should specify IGMP queriers that are known to connect to the network through a port on the switch.
The no ip igmp snooping vlan multicast-router and default ip igmp snooping vlan multicast-router commands remove the specified static port configuration by deleting the corresponding ip igmp snooping vlan multicast-router command from running-config.
Command Mode
Global Configuration
Command Syntax
ip igmp snooping vlan v_range multicast-router interface STATIC_INT
no ip igmp snooping vlan v_range multicast-router interface STATIC_INT
default ip igmp snooping vlan v_range multicast-router interface STATIC_INT
- v_range VLAN IDs. Formats include a number, number range, or comma-delimited list of numbers and ranges. Numbers range from 1 to 4094.
- STATIC_INT interface the command configures as a
static port. Selection options include:
- ethernet e_range where e_range is the number, range, or list of ethernet ports.
- port-channel p_range where p_range is the number, range, or list of channel ports.
- The STATIC_INT interface must route traffic through a VLAN specified within v_range.
Example
switch(config)# ip igmp snooping vlan 2 multicast-router interface ethernet 3
switch(config)#ip igmp snooping vlan proxy
The ip igmp snooping vlan proxy command enables snooping proxy on individual VLAN. To enable or disable IGMP snooping vlan proxy globally, use the ip igmp snooping proxy command.
The no and default form of ip igmp snooping vlan proxy command disables snooping proxy globally and on individual VLANs by removing the ip igmp snooping vlan proxy command from the running-config.
Command Mode
Global Configuration
Command Syntax
ip igmp snooping vlan [ID | range]proxy
no ip igmp snooping vlan [ID | range] proxy
default ip igmp snooping vlan [ID | range] proxy
- ID specifies a individual VLAN ID. Numbers range from 1 to 4094.
- range specifies the range of VLAN IDs. Numbers range from 1 to 4094.
- This command globally enables IGMP snooping proxy on the switch and on all
VLANs where IGMP snooping is
enabled.
switch(config)# ip igmp snooping proxy switch(config)# - This command enables IGMP snooping proxy on vlan
20.
switch(config)# ip igmp snooping vlan 20 proxy switch(config)# - This command disables IGMP snooping proxy on vlan
20.
switch(config)# no ip igmp snooping vlan 20 proxy switch(config)#
ip igmp snooping vlan querier
- ip igmp snooping vlan querier enables the querier on specified VLANs.
- no ip igmp snooping vlan querier disables the querier on specified VLANs.
VLAN querier commands take precedence over the global querier setting. The ip igmp snooping querier controls the querier for VLANs with no snooping querier command.
The IGMP snooping querier supports snooping by sending Layer 2 membership queries to hosts attached to the switch. The snooping querier is functional on VLANs where hosts receive IP multicast traffic without access to a network IP multicast router. A snooping querier avoids flooding multicast packets in the VLAN by querying for hosts and routers.
- Snooping is enabled.
- The corresponding SVI (VLAN interface) is active.
- The VLAN querier IP address or the global querier IP address is configured.
The default ip igmp snooping vlan querier command restores the usage of the global setting for the specified VLAN by removing the corresponding ip igmp snooping vlan querier or no ip igmp snooping vlan querier command from running-config.
Command Mode
Global Configuration
Command Syntax
ip igmp snooping vlan v_range querier
no ip igmp snooping vlan v_range querier
default ip igmp snooping vlan v_range querier
Parameters
v_range VLAN IDs. Formats include a number, a number range, or a comma-delimited list of numbers and ranges. Numbers range from 1 to 4094.
- These commands globally enable the snooping querier on the switch,
explicitly disable snooping on VLANs 1-3, and
explicitly enable snooping on VLANs
4-6.
switch(config)# ip igmp snooping querier switch(config)# no ip igmp snooping vlan 1-3 querier switch(config)# ip igmp snooping vlan 4-6 querierAfter running these commands, the running-config file contains these lines, which indicate that the snooping querier is enabled on VLANs 4-6.
switch(config)# show running-config <-------OUTPUT OMITTED FROM EXAMPLE--------> no ip igmp snooping vlan 1 querier no ip igmp snooping vlan 2 querier no ip igmp snooping vlan 3 querier ip igmp snooping vlan 4 querier ip igmp snooping vlan 5 querier ip igmp snooping vlan 6 querier ip igmp snooping querier <-------OUTPUT OMITTED FROM EXAMPLE--------> - This command removes the querier setting for VLANs
2-5:
switch(config)# default ip igmp snooping vlan 2-5 querierWhen executed after the previous commands, the snooping querier is disabled explicitly on VLANs 1-2, enabled implicitly on VLANs 3-6, and enabled explicitly on VLANs 7-8, as shown by running-config:
<-------OUTPUT OMITTED FROM EXAMPLE--------> no ip igmp snooping vlan 1 querier ip igmp snooping vlan 6 querier ip igmp snooping querier <-------OUTPUT OMITTED FROM EXAMPLE--------> - This command sets the global snooping querier to disabled by removing the
global querier setting from
running-config:
switch(config)# no ip igmp snooping querier switch(config)#When executed after the previous commands, the snooping querier is disabled explicitly on VLANs 1-2, disabled implicitly on VLANs 3-6 and enabled explicitly on VLANs 7-8, as shown by running-config.<-------OUTPUT OMITTED FROM EXAMPLE--------> no ip igmp snooping vlan 1 querier ip igmp snooping vlan 6 querier <-------OUTPUT OMITTED FROM EXAMPLE-------->
ip igmp snooping vlan querier address
The ip igmp snooping vlan querier address command sets the source address for query packets sent from specified VLANs. VLANs not assigned an address use the global address (ip igmp snooping querier address). VLAN querier address commands take precedence over the global address.
To use a snooping querier, an address must be explicitly configured globally or for the querier VLAN.
The no ip igmp vlan snooping querier address and default ip igmp snooping vlan querier address commands reset the specified VLAN to use the global address by removing the corresponding ip igmp snooping vlan querier address command from running-config.
Command Mode
Global Configuration
Command Syntax
ip igmp snooping vlan v_range querier address ipv4_address
no ip igmp snooping vlan v_range querier address
default ip igmp snooping vlan v_range querier address
- v_range VLAN IDs. Formats include a number, number range, or comma-delimited list of numbers and ranges. Numbers range from 1 to 4094.
- ipv4_address source IPv4 address.
Example
switch(config)# ip igmp snooping vlan 2 querier address 10.14.1.1
switch(config)#ip igmp snooping vlan querier last-member-query-count
The ip igmp snooping vlan querier last-member-query-count command specifies an IGMP snooping querier last-member-query-count (LMQC) value for the specified VLANs. LMQC specifies the number of query messages the switch sends in response to group-specific or group-source-specific leave messages it receives from a host; the transmission frequency is specified by IGMP snooping querier last member query interval. The switch stops forwarding messages to the host if it does not receive a response to these query messages.
VLANs not assigned an LMQC value use the global value (ip igmp snooping querier last-member-query-count). VLAN commands take precedence over the global command.
Setting the last member query count (LMQC) to 1 causes the loss of a single packet to stop traffic forwarding. While the switch can start forwarding traffic again after receiving a response to the next general query, the host may not receive that query for a period defined by ip igmp snooping querier query-interval l.
The no igmp snooping vlan querier last-member-query-count and default igmp snooping vlan querier last-member-query-count commands reset the specified VLAN to use the global LMQC by removing the corresponding ip igmp snooping vlan querier last-member-query-count command from running-config.
Command Mode
Global Configuration
Command Syntax
ip igmp snooping vlan v_range querier last-member-query-count number
no ip igmp snooping vlan v_range querier address
default ip igmp snooping vlan v_range querier address
- v_range VLAN IDs. Formats include a number, number range, or comma-delimited list of numbers and ranges. Numbers range from 1 to 4094.
- number query message quantity. Value ranges from 1 to 3.
Example
switch(config)# ip igmp snooping vlan 3 querier last-member-query-count 1
switch(config)#ip igmp snooping vlan querier last-member-query-interval
The ip igmp snooping vlan querier last-member-query-interval command configures last-member-query-interval for packets sent from the specified VLANs. VLANs not assigned a value use the global setting (ip igmp snooping querier last-member-query-interval). VLAN commands take precedence over the global value. The global default is one second.
A multicast host sends an IGMP leave report when it leaves a group. To determine if the host was the last group member, the leave message recipient sends an IGMP query. The last-member-query-interval determines when the group record is deleted if no subsequent reports are received.
The no ip igmp snooping vlan querier last-member-query-interval and default ip igmp snooping vlan querier last-member-query-interval commands reset the specified VLAN to use the global last-member-query-interval by removing the corresponding ip igmp snooping vlan querier last-member-query-interval command from running-config.
Command Mode
Global Configuration
Command Syntax
ip igmp snooping vlan v_range querier last-member-query-interval period
no ip igmp snooping vlan v_range querier last-member-query-interval
default ip igmp snooping vlan v_range querier last-member-query-interval
- v_range VLAN IDs. Formats include a number, number range, or comma-delimited list of numbers and ranges. Numbers range from 1 to 4094.
- period last member query interval (seconds). Value ranges from 1 to 25.
Example
switch(config)# ip igmp snooping vlan 10 querier last-member-query-interval 12
switch(config)#ip igmp snooping vlan querier max-response-time
The ip igmp snooping vlan querier max-response-time command configures max-response-time for packets sent from the specified VLANs. VLANs not assigned a value use the global setting (ip igmp snooping querier max-response-time). VLAN commands take precedence over the global value. The global default is 10 seconds.
Switches use max-response-time to set the Max Response Time field in outbound Membership Query messages. Max Response Time specifies the maximum period a recipient can wait before responding with a Membership Report.
The no ip igmp snooping vlan querier max-response-time and default ip igmp snooping vlan querier max-response-time commands reset the specified VLAN to use the global max-response-time by removing the corresponding ip igmp snooping vlan querier max-response-time command from running-config.
Command Mode
Global Configuration
Command Syntax
ip igmp snooping vlan v_range querier max-response-time resp_sec
no ip igmp snooping vlan v_range querier max-response-time
default ip igmp snooping vlan v_range querier max-response-time
- v_range VLAN ID. Formats include a number, number range, or comma-delimited list of numbers and ranges. Numbers range from 1 to 4094.
- resp_sec max-response-time value (seconds). Values range from 1 to 25.
Example
switch(config)# ip igmp snooping vlan 2 querier max-response-time 5
switch(config)#ip igmp snooping vlan querier query-interval
The ip igmp snooping vlan querier query-interval command sets the query interval for the specified VLAN. VLANs not assigned a value use the global value (ip igmp snooping querier query-interval). VLAN commands have precedence over the global value. The query interval is the period between IGMP Membership Query messages sent from the querier.
The no ip igmp snooping vlan querier query-interval and default ip igmp snooping vlan querier query-interval commands reset the specified VLAN to use the global value by removing the corresponding ip igmp snooping vlan querier query-interval command from running-config.
Command Mode
Global Configuration
Command Syntax
ip igmp snooping vlan v_range querier query-interval query_sec
no ip igmp snooping vlan v_range querier query-interval
default ip igmp snooping vlan v_range querier query-interval
Parameters- v_range VLAN IDs. Formats include a number, number range, or comma-delimited list of numbers and ranges. Numbers range from 1 to 4094.
- query_sec query interval (seconds). Values range from 5 to 3600. Default (global) is 125.
Example
switch(config)# ip igmp snooping vlan 10 querier query-interval 240
switch(config)#ip igmp snooping vlan querier startup-query-count
The ip igmp snooping vlan querier startup-query-count command specifies the startup query count value for the specified VLANs. The startup query count specifies the number of query messages that the querier sends on a VLAN during the startup query interval (ip igmp snooping vlan querier startup-query-interval).
When an interface starts running IGMP, it can establish the group state more quickly by sending query messages at a higher frequency. The startup-query-interval and startup-query-count parameters define the startup period and the query message transmission frequency during that period.
VLANs not assigned a startup query count value use the global value (ip igmp snooping querier startup-query-count). VLAN commands take precedence over the global command.
The no ip igmp snooping vlan querier startup-query-count and default ip igmp snooping vlan querier startup-query-count commands restore the default condition of using the global startup query count value by removing the corresponding ip igmp snooping vlan querier startup-query-count command from running-config.
Command Mode
Global Configuration
Command Syntax
ip igmp snooping vlan v_range querier startup-query-count number
no ip igmp snooping vlan v_range querier startup-query-count
default ip igmp snooping vlan v_range querier startup-query-count
- v_range VLAN IDs. Formats include a number, number range, or comma-delimited list of numbers and ranges. Numbers range from 1 to 4094.
- number startup query count. Value ranges from 1 to 3.
Example
switch(config)# ip igmp snooping vlan 100 querier startup-query-count 3
switch(config)#ip igmp snooping vlan querier startup-query-interval
The ip igmp snooping vlan querier startup-query-interval command specifies the startup query interval value for the specified VLANs. The startup query interval specifies the period between query messages that the querier sends upon startup.
When snooping is enabled, the group state is more quickly established by sending query messages at a higher frequency. The startup-query-interval and startup-query-count parameters define the startup period by defining the number of queries to be sent and transmission frequency for these messages.
VLANs not assigned a startup query interval value use the global value (ip igmp snooping querier startup-query-count). VLAN commands take precedence over the global command.
The no ip igmp snooping vlan querier startup-query-interval and default ip igmp snooping vlan querier startup-query-interval commands restore the default condition of using the global startup query interval value by removing the corresponding ip igmp snooping vlan querier startup-query-interval command from running-config.
Command Mode
Global Configuration
Command Syntax
ip igmp snooping vlan v_range querier startup-query-interval period
no ip igmp snooping vlan v_range querier startup-query-interval
default ip igmp snooping vlan v_range querier startup-query-interval
- v_range VLAN IDs. Formats include a number, number range, or comma-delimited list of numbers and ranges. Numbers range from 1 to 4094.
- period startup query interval (seconds). Value ranges from 1 to 3600 (1 hour). Default is 31.
Example
switch(config)# ip igmp snooping vlan 100 querier startup-query-interval 60
switch(config)#ip igmp snooping vlan querier version
The ip igmp snooping vlan querier version command configures the Internet Group Management Protocol (IGMP) snooping querier function on the VLAN. Version 3 is the default IGMP snooping version.
IGMP is enabled by the pim ipv4 sparse-mode or pim ipv4 bidirectional command. The ig igmp snooping vlan querier version command does not affect the IGMP enabled status.
The no ip igmp snooping vlan querier version and default ip igmp snooping vlan querier version commands restore the configuration mode interface to IGMP snooping VLAN querier version 3 by removing the ip igmp snooping vlan querier version statement from running-config.
Command Mode
Global Configuration
Command Syntax
ip igmp snooping vlan v_range querier version version_number
no ip igmp snooping vlan v_range querier version
default ip igmp snooping vlan v_range querier version
- v_range VLAN ID. Formats include a number, number range, or comma-delimited list of numbers and ranges. Numbers range from 1 to 4094.
- version_number IGMP version number. Value ranges from 1 to 3. Default value is 3.
- The example sets the querier to version 2 on
vlan
5.
switch(config)# ip igmp snooping vlan 5 querier version 2 switch(config)# - This command restores IGMP snooping querier version
3 to vlan
5.
switch(config)# no ip igmp snooping vlan 5 querier version switch(config)#
ip igmp snooping vlan report-flooding
The ip igmp snooping vlan report-flooding command enables L2 report flooding on the specified VLANs if report flooding is globally enabled. When L2 report flooding is not globally enabled, this command has no effect. The ip igmp snooping report-flooding command globally enables L2 report flooding.
L2 report flooding is an IGMP snooping feature that forwards membership report messages to specified ports. Relying on a single switch to maintain and send report messages can degrade performance. L2 report flooding addresses this by facilitating report message forwarding through any network port. This allows switches to bypass the querier when forwarding multicast traffic to its interested ports.
- ip igmp snooping vlan report-flooding switch-port for a VLAN range.
- ip igmp snooping report-flooding switch-port for all VLANs where report flooding is enabled.
The no ip igmp snooping vlan report-flooding and default ip igmp snooping vlan report-flooding commands disable L2 report flooding for the specified VLAN by removing the corresponding ip igmp snooping vlan report-flooding statement from running-config.
Command Mode
Global Configuration
Command Syntax
ip igmp snooping vlan v_range report-flooding
no ip igmp snooping vlan v_range report-flooding
default ip igmp snooping vlan v_range report-flooding
Parameters
v_range VLAN IDs Formats include a number, number range, or comma-delimited list of numbers and ranges. Numbers range from 1 to 4094.
Related Commands
ip igmp snooping report-flooding globally enables L2 report flooding.
Example
switch(config)# ip igmp snooping report-flooding
switch(config)# ip igmp snooping vlan 201-205 report-flooding
switch(config)#ip igmp snooping vlan report-flooding switch-port
The ip igmp snooping vlan report-flooding switch-port command configures Ethernet ports or port channels to forward IGMP membership report messages for a specified VLAN range where L2 report flooding is enabled. Ports that are connected to multicast routers or queriers continue to forward traffic as previously specified and are not affected by L2 report flooding commands.
L2 report flooding is an IGMP snooping feature that forwards membership report messages to specified ports. The ip igmp snooping report-flooding switch-port command configures a list of forwarding ports for all VLANs where L2 report flooding is enabled.
The no ip igmp snooping vlan report-flooding switch-port and default ip igmp snooping vlan report-flooding switch-port commands remove the listed ports from the specified report flooding port list by deleting the corresponding ip igmp snooping vlan report-flooding switch-port statements from running-config.
Command Mode
Global Configuration
Command Syntax
ip igmp snooping vlan v_range report-flooding switch-port INTERFACE
no ip igmp snooping vlan v_range report-flooding switch-port INTERFACE
default ip igmp snooping vlan v_rangereport-flooding switch-port INTERFACE
- v_range VLAN IDs. Formats include a number, number range, or comma-delimited list of numbers and ranges. Numbers range from 1 to 4094.
- INTERFACE Membership report message forwarding is
enabled on these ports:
- ethernet e_range where e_range is the number, range, or list of ethernet ports.
- port-channel p_range where p_range is the number, range, or list of channel ports.
- ip igmp snooping report-flooding globally enables L2 report flooding.
- ip igmp snooping vlan report-flooding switch-port specifies a port list for a VLAN range.
- ip igmp snooping report-flooding switch-port specifies a port list for all VLANs.
Example
switch(config)# ip igmp snooping report-flooding
switch(config)# ip igmp snooping vlan 201-205 report-flooding
switch(config)# ip igmp snooping vlan 201-205 report-flooding switch-port ethernet 8-10
switch(config)#ip igmp startup-query-count
The ip igmp startup-query-count command specifies the number of query messages that an interface sends during the startup interval defined by ip igmp startup-query-interval.
When an interface starts running IGMP, it can establish the group state more quickly by sending query messages at a higher frequency. The startup-query-interval and startup-query-count parameters define the startup period and the query message transmission frequency during that period.
The no ip igmp startup-query-count and default ip igmp startup-query-count commands restore the default startup-query-count value of 2 for the configuration mode interface by removing the corresponding ip igmp startup-query-count command from running-config.
Command Mode
Interface-Ethernet Configuration
Interface-Port-Channel Configuration
Interface-VLAN Configuration
Command Syntax
ip igmp startup-query-count number
no ip igmp startup-query-count
default ip igmp startup-query-count
Parameter
number quantity of queries. Values range from 1 to 65535. Default is 2.
Example
switch(config)# interface vlan 4
switch(config-if-Vl4)# ip igmp startup-query-count 10
switch(config-if-Vl4)#ip igmp startup-query-interval
The ip igmp startup-query-interval command specifies the configuration mode interface IGMP startup period, during which query messages are sent at an accelerated rate.
When an interface starts running IGMP, it can establish the group state quicker by sending query messages at a higher frequency. The startup-query-interval and startup-query-count parameters define the startup period and the query message transmission frequency during that period.
The no ip igmp startup-query-interval and default ip igmp startup-query-interval commands restore the configuration mode interface default IGMP startup-query-interval of 31 seconds by removing the corresponding ip igmp startup-query-interval command from running-config.
Command Mode
Interface-Ethernet Configuration
Interface-Port-Channel Configuration
Interface-VLAN Configuration
Command Syntax
ip igmp startup-query-interval period
no ip igmp startup-query-interval
default ip igmp startup-query-interval
Parameter
period startup query interval, in deciseconds. Value ranges from 10 (one second) to 317440 (8 hours, 49 minutes, 4 seconds). Default is 31 seconds.
Example
switch(config)# interface vlan 4
switch(config-if-Vl4)# ip igmp startup-query-interval 600
switch(config-if-Vl4)#ip igmp static-group
The ip igmp static-group command configures the configuration mode interface as a static member of a specified multicast group. This allows the router to forward multicast group packets through the interface without otherwise appearing or acting as a group member. By default, static group memberships are not configured on any interfaces.
If the command includes a source address, only multicast group messages received from the specified host address are fast-switched. Otherwise, all multicast messages of the specified group are fast-switched.
The no ip igmp static-group and default ip igmp static-group commands remove the configuration mode interface group membership by removing the corresponding ip igmp static-group command from running-config.
Command Mode
Interface-Ethernet Configuration
Interface-Port-Channel Configuration
Interface-VLAN Configuration
Command Syntax
ip igmp static-group group_address [SOURCE_ADDRESS]
no ip igmp static-group group_address [SOURCE_ADDRESS]
default ip igmp static-group group_address [SOURCE_ADDRESS]
- group_address IPv4 address of multicast group for which the interface fast-switches packets.
- SOURCE_ADDRESS IP address of host that originates
multicast data packets.
- no parameter all multicast messages of the specified group are fast-switched.
- ipv4_address source IP address (dotted decimal notation).
- ip igmp static-group acl configures the configuration mode interface as a static member of the multicast groups specified by an IP Access Control List (ACL).
- ip igmp static-group
range configures the configuration mode interface as a
static member of multicast groups specified by an address range.
One ip igmp static-group range command is equivalent to multiple ip igmp static-group commands.
Example
switch(config)# interface vlan 15
switch(config-if-Vl15)# pim ipv4 dr-priority 5000
switch(config-if-Vl15)# ip igmp static-group 231.1.1.45 10.1.1.1
switch(config-if-Vl15)#ip igmp static-group acl
The ip igmp static-group acl command configures the configuration mode interface as a static member of the multicast groups specified by an IP Access Control List (ACL). This command is a variant of the ip igmp static-group command that uses ACL rules to specify a set of source-multicast group address pairs instead of specifying a single pair. Multiple static-group ACLs can be assigned to an interface. Static groups can be assigned manually and through ACLs simultaneously.
- permit <protocol><source><destination>, where
- <protocol> has no effect on the static group.
- <source> address of host originating multicast data packets. Must be a host address.
- <destination> multicast group IP address or subnet. Must be a valid multicast.
An ACL can contain multiple rules. An ACL can be applied to an interface only when all of its rules comply to the specified restrictions. The show ip igmp static-groups acl displays the source-multicast group pairs that the specified list configures and lists issues with illegal rules.
The no ip igmp static-group acl and default ip igmp static-group acl commands remove the specified static group ACL command from running-config.
Command Mode
Interface-Ethernet Configuration
Interface-Port-Channel Configuration
Interface-VLAN Configuration
Command Syntax
ip igmp static-group acl list_name
no ip igmp static-group acl
default ip igmp static-group acl
Parameters
list_name ACL that specifies multicast group addresses for which interface fast-switches packets.
Example
switch(config)# interface vlan 4
switch(config-if-Vl4)# ip igmp static-group acl LIST_1
switch(config-if-Vl4)#ip igmp static-group range
The ip igmp static-group range command configures the configuration mode interface as a static member of multicast groups specified by an address range. This allows the router to forward multicast group packets through the interface without otherwise appearing or acting as a group member. By default, no static group memberships are configured on interfaces.
This command is a variant of the ip igmp static-group command that allows the assignment of a subnet range of source addresses or a subnet range of multicast groups. A single ip igmp static-group range command is the equivalent of multiple ip igmp static-group commands, each of which can only assign a single multigroup-source pair to an interface. Running-config converts the range command to the equivalent list of ip igmp static-group commands.
If the command includes a source address range, only multicast group messages received from the range are fast-switched. Otherwise, all multicast messages of the specified group are fast-switched.
The no ip igmp static-group range and default ip igmp static-group range commands remove the specified range of static group statements from running-config. The no ip igmp static-group and default ip igmp static-group commands can remove an individual static-group command that was initially added to running-config by an ip igmp static-group range command.
Command Mode
Interface-Ethernet Configuration
Interface-Port-Channel Configuration
Interface-VLAN Configuration
Command Syntax
ip igmp static-group range GROUP_ADDR[SOURCE_ADDR]
no ip igmp static-group range GROUP_ADDR[SOURCE_ADDR]
default ip igmp static-group range GROUP_ADDR[SOURCE_ADDR]
- GROUP_ADDR address of multicast group for which the
interface fast-switches packets.
- gp_ipv4_addr multicast group IPv4 address.
- gp_ipv4_subnet IPv4 subnet address of multicast groups (CIDR or address-mask).
- SOURCE_ADDR IP address of a host range that
originates multicast data packets.
- no parameter all multicast messages of the specified range are fast-switched.
- source sr_ipv4_address source IPv4 address (dotted decimal notation).
- source
sr_ ipv4_subnet IPv4 subnet address of
source hosts (CIDR or address- mask).Note: A command cannot specify a subnet address for both multicast group and source.
- This command configures interface vlan 4 as a
static member of the multicast group range
241.1.4.1/24 for data packets that
originate at
10.1.1.1.
switch(config)# interface vlan 4 switch(config-if-Vl4)# ip igmp static-group range 239.1.4.1/24 source 10.1.1.1 switch(config-if-Vl4)# - This command attempts to configure interface vlan
4 as a static member of the multicast group range
241.1.4.1/24 for data packets that
originate at the 10.1.1.1/29 subnet. Because the
range and source cannot both be subnets, this command generates an error
message.
switch(config-if-Vl4)# ip igmp static-group range 239.1.1.1/29 source 16.1.1.1/29 % Error: cannot specify source range with group range switch(config-if-Vl4)#
ip igmp version
The ip igmp version command configures the Internet Group Management Protocol (IGMP) version on the configuration mode interface. Version 3 is the default IGMP version.
IGMP is enabled by the pim ipv4 sparse-mode or pim ipv4 bidirectional command. The ig igmp version command does not affect the IGMP enabled status.
The no ip igmp version and default ip igmp version commands restore the configuration mode interface to IGMP version 3 by removing the ip igmp version statement from running-config.
Command Mode
Interface-Ethernet Configuration
Interface-Port-Channel Configuration
Interface-VLAN Configuration
Command Syntax
ip igmp version version_number
no ip igmp version
default ip igmp version
Parameters
version_number IGMP version number. Value ranges from 1 to 3.
Example
switch(config)# interface vlan 4
switch(config-if-Vl4)# ip igmp version 3
switch(config-if-Vl4)#permit / deny
The permit command configures the configuration mode IGMP profile as a permit list. Applying a permit list to an interface restricts that interface from joining any multicast group not included in the list.
IGMP profiles are deny lists by default. When applied to an interface, a deny list allows the interface to join any multicast group that is not included in the list.
The deny command restores the IGMP list to its default type by removing the corresponding permit statement from running-config.
The range command adds and removes address ranges from the configuration mode profile.
Command Mode
IGMP-profile Configuration
Command Syntax
permit
deny
Related Commands
ip igmp profile places the switch in igmp-profile configuration mode.
Example
switch(config)# ip igmp profile list_1
switch(config-igmp-profile-list_1)# permit
switch(config-igmp-profile-list_1)#range
The range command specifies an address range for the configuration mode IGMP profile. A permit range specifies the groups that an interface is permitted to join. A deny range specifies the groups that an interface is not permitted to join. The permit / deny command specifies the range type.
A profile may contain multiple range statements to define a discontiguous address range.
The no range and default range commands remove the specified address range from a previous specified list.
Command Mode
igmp-profile Configuration
Command Syntax
range init_address [UPPER_RANGE]
no range init_address [UPPER_RANGE]
default range init_address [UPPER_RANGE]
- init_address IP address of lower boundary of the address range (dotted decimal notation).
- UPPER_RANGE sets the upper boundary of the address
range. Options include:
- no parameter upper boundary is equal to lower boundary: range consists of one address.
- range_address IP address of upper
boundary.
All addresses must be multicast addresses (10.0.0.0 to 239.255.255.255).
Related Commands
ip igmp profile places the switch in the igmp-profile configuration mode.
Example
switch(config)# ip igmp profile list_1
switch(config-igmp-profile-list_1)# permit
switch(config-igmp-profile-list_1)# 232.1.1.0 232.1.1.255
switch(config-igmp-profile-list_1)# 233.1.1.10
switch(config-igmp-profile-list_1)# ip igmp profileshow igmp snooping querier
The show igmp snooping querier command displays snooping querier configuration and status information. Command provides options to only include specific VLANs.
Command Mode
EXEC
Command Syntax
show igmp snooping querier [STATUS][VLAN_ID][DATA]
- STATUS specifies the type of information displayed.
Options include:
- no parameter querier IP address, port, and IGMP version.
- status querier configuration parameters.
- VLAN_ID specifies VLANs for which command displays
information. Options include:
- no parameter all VLANs.
- vlan v_num specified VLAN.
- DATA specifies the type of information displayed.
Options include:
- no parameter displays VLAN number and port-list for each group.
- detail displays port-specific data for each group; includes transmission times and expiration.
- This command displays the querier IP address, version, and port servicing
each VLAN.
switch> show igmp snooping querier Vlan IP Address Version Port ---------------------------------------- 1 172.17.0.37 v2 Po1 20 172.17.20.1 v2 Po1 26 172.17.26.1 v2 Cpu 2028 172.17.255.29 v2 Po1 switch> - This command displays the querier configuration parameters for each
VLAN.
switch> show igmp snooping querier status Global IGMP Querier status ------------------------------------ admin state : Enabled source IP address : 0.0.0.0 query-interval (sec) : 125.0 max-response-time (sec) : 10.0 querier timeout (sec) : 130.0 Vlan Admin IP Query Response Querier Operational State Interval Time Timeout State ------------------------------------------------------------------- 1 Enabled 0.0.0.0 125.0 10.0 130.0 Non-Querier 4 Enabled 0.0.0.0 125.0 10.0 130.0 Non-Querier 20 Enabled 0.0.0.0 125.0 10.0 130.0 Non-Querier 22 Enabled 0.0.0.0 125.0 10.0 130.0 Non-Querier 28 Enabled 0.0.0.0 125.0 10.0 130.0 Non-Querier
show igmp snooping querier counters
The show igmp snooping querier counters command displays the counters from the querier, as learned through Internet Group Management Protocol (IGMP).
Command Mode
EXEC
Command Syntax
show igmp snooping querier counters [VLAN_ID]
Parameters
- no parameter displays information for all VLANs.
- vlan v_num displays information for specified VLAN.
Example
switch> show igmp snooping querier counters
-----------------------------------------------------------------------
Vlan: 1 IP Addr: 100.0.0.1 Op State: Querier Version: v3
v1 General Queries Sent :0
v1 Queries Received :0
v1 Reports Received :0
v2 General Queries Sent :1
v2 Queries Received :0
v2 Reports Received :25
v2 Leaves Received :0
v3 General Queries Sent :655
v3 GSQ Queries Sent :0
v3 GSSQ Queries Sent :8
v3 Queries Received :654
v3 Reports Received :2385
Error Packets :0
Other Packets :0
switch>show igmp snooping querier membership
The show igmp snooping querier membership command displays the membership from the querier, as learned through Internet Group Management Protocol (IGMP).
Command Mode
EXEC
Command Syntax
show igmp snooping querier membership [VLAN_ID [GROUP_LIST]]
- VLAN_ID specifies VLANs for which command displays
information. Options include:
- no parameter displays information for all VLANs.
- vlan v_num displays information for specified VLAN.
- GROUP_LIST list of groups for which the command
displays information. Options include:
- no parameter all multicast groups within specified VLAN.
- group ipv4_addr single multicast group address (dotted decimal notation).
Example
switch> show igmp snooping querier membership
-------------------------------------------------------------------------
Vlan: 1 Elected: 10.0.0.1 QQI: 125 QRV: 2 QRI: 10 GMI: 260
Groups Mode Ver Num of Sources
-------------------------------------------------------------------------
10.0.0.2 EX v3 0 []
10.0.0.3 IN v3 2 [ 3.3.3.3, 3.3.3.4 ]
10.0.0.4 EX v3 0 []
10.0.0.13 EX v3 0 []
10.0.0.22 EX v3 0 []
10.0.0.1 IN v3 3 [ 5.6.7.9, 5.6.7.8, ... ]
switch>show ip igmp groups
- show ip igmp groups all multicast groups.
- show ip igmp groups group_addr listed multicast group.
- show ip igmp groups interface int_name all multicast groups on specified interfaces
- show ip igmp groups group_addr interface int_name listed multicast group on specified interface.
Command Mode
EXEC
Command Syntax
show ip igmp groups GROUP_LIST [DATA]
- GROUP_LIST list of groups for which the command
displays information. Options include:
- no parameter all multicast groups.
- group_addr single multicast group address (dotted decimal notation).
- interface ethernet e_num all multicast groups on specified Ethernet interface.
- interface loopback l_num all multicast groups on specified Loopback interface.
- interface management m_num all multicast groups on specified Management interface.
- interface port-channel p_num all multicast groups on specified Port-Channel Interface.
- interface vlan v_num all multicast groups on specified VLAN interface.
- interface VXLAN vx_num all multicast groups on specified VXLAN interface.
- DATA specifies the type of information displayed.
Options include:
- no parameter provides uptime, expiration, and address of reporter.
- detail also include group mode and group source list.
Example
switch> show ip igmp groups
NOTE: static-group information not shown below. Use the
'show ip igmp static-groups' command.
IGMP Connected Group Membership
Group Address Interface Uptime Expires Last Reporter
10.12.1.1 Vlan162 11d01h 00:02:57 172.17.2.110
10.12.1.2 Vlan162 11d01h 00:02:57 172.17.2.110
10.12.1.3 Vlan162 11d01h 00:02:57 172.17.2.110
10.12.1.4 Vlan162 11d01h 00:02:57 172.17.2.110
10.12.1.5 Vlan162 11d01h 00:02:57 172.17.2.110
switch>show ip igmp groups count
The show ip igmp groups count command displays the number of multicast groups that are joined across the specified interfaces.
Command Mode
EXEC
Command Syntax
show ip igmp groups [GROUP_LIST] count
- INTERF Specifies the interface for which the command
displays information. Options include:
- no parameter all IGMP interfaces.
- interface ethernet e_num Ethernet interface.
- interface loopback l_num Loopback interface.
- interface management m_num Management interface.
- interface port-channel p_num Port-Channel Interface.
- interface vlan v_num VLAN interface.
- interface VXLAN vx_num VXLAN interface.
- This command displays the number of multicast groups joined across all
interfaces.
switch> show ip igmp groups count Number of total groups joined across all IGMP interfaces: 5 switch> - This command displays the number of multicast groups joined on
interface ethernet
3/4.
switch> show ip igmp groups interface ethernet 3/4 count Number of groups joined on Ethernet3/4: 2 switch>
show ip igmp host-proxy config-sanity
The show ip igmp host-proxy config-sanity command displays diagnostic information about an IGMP host proxy configuration.
Command Mode
EXEC
Command Syntax
show ip igmp host-proxy config-sanity
Example
switch> show ip igmp host-proxy config-sanity
Below are hints of potential IGMP Host-Proxy misconfigurations
IGMP host-proxy configured on interface Test3:
Access-lists having "deny ip any any" rule:
acl1
acl2
Groups with overlapping permit and deny configurations:
192.168.1.1/32
192.168.2.2/32
192.168.4.4/32
Groups with source filters configured with IGMP Host-Proxy set to version 2 :
192.168.2.2/32
192.168.3.0/24
192.168.3.3/32
192.168.8.8/32
switch>show ip igmp host-proxy interface
The show ip igmp host-proxy interface command displays per-interface IGMP host-proxy configuration information, including the IGMP groups joined on the interface. Command filters allow the list to display only data for a specified interface and to include packet counter statistics in the display.
Command Mode
EXEC
Command Syntax
show ip igmp host-proxy interface [interface] [detail]
-
interface optional parameter to limit the display to a single interface. Omitting the parameter displays host-proxy configuration information for all interfaces on which IGMP host-proxy is configured. Options include:
- ethernet e_num Ethernet interface specified by e_num.
- port-channel p_num port-channel Interface specified by p_num.
- vlan v_num VLAN interface specified by v_num.
- detail use this optional keyword to include packet counter statistics in the display.
- This command displays host-proxy information for all switch interfaces on
which IGMP host-proxy is
configured.
switch> show ip igmp host-proxy interface IGMP host-proxy configured on: Test2 IGMP host-proxy version: 3 Unsolicited-report interval: 1.0 Device name: Test2 Interface Group Address IncludeSrc ExcludeSrc Test2 172.16.89.0 Test2 172.16.0.0 20.0.0.0 Test2 172.16.0.0 10.0.0.0 Test2 192.168.110.0 20.0.0.0 - This command displays host-proxy information for all switch interfaces on
which IGMP host-proxy is configured, plus host-proxy
statistics.
switch> show ip igmp host-proxy interface detail IGMP host-proxy configured on: Test2 IGMP host-proxy version: 3 Unsolicited-report interval: 1.0 Device name: Test2 Interface Group Address IncludeSrc ExcludeSrc Test2 172.16.89.0 Test2 172.16.0.0 20.0.0.0 Test2 172.16.0.0 10.0.0.0 Test2 192.168.110.0 20.0.0.0 IGMP host-proxy statistics: IGMP v1 Queries received: 0 IGMP v2 General-Queries received: 0 IGMP v2 Group-Queries received: 0 IGMP v3 General-Queries received: 0 IGMP v3 Group-Queries received: 0 IGMP v3 Group-Source Queries received: 0 IGMP v1 Reports sent: 0 IGMP v2 Reports sent: 0 IGMP v3 Reports sent: 1
show ip igmp interface
The show ip igmp interface command displays multicast information about the specified interface.
Command Mode
EXEC
Command Syntax
show ip igmp interface [INT_NAME]
Parameters
- no parameter Displays information for all interfaces.
- ethernet e_num Ethernet interface specified by e_num.
- loopback l_num Loopback interface specified by l_num.
- management m_num Management interface specified by m_num.
- port-channel p_num Port-Channel Interface specified by p_num.
- vlan p_num VLAN interface specified by p_num.
- VXLAN vx_num VXLAN interface specified by vx_num.
Example
switch> show ip igmp interface vlan 26
Vlan26 is up
Interface address: 172.17.26.1/23
IGMP on this interface: enabled
Multicast routing on this interface: enabled
Multicast TTL threshold: 1
Current IGMP router version: 2
IGMP query interval: 125 seconds
IGMP max query response time: 100 deciseconds
Last member query response interval: 10 deciseconds
Last member query response count: 2
IGMP querier: 172.17.26.1
Robustness: 2
Require router alert: enabled
Startup query interval: 312 deciseconds
Startup query count: 2
General query timer expiry: 00:00:22
Multicast groups joined:
239.255.255.250
switch>show ip igmp profile
The show ip igmp profile command displays the contents of the specified IGMP profile. IGMP snooping filters use an IGMP profile to control the multicast groups that an interface can join.
Command Mode
EXEC
Command Syntax
show ip igmp profile [PROFILES]
Parameters
- no parameter displays all IGMP profiles.
- profile_name displays specified profile.
Example
switch> show ip igmp profile
IGMP Profile list_1
permit
range 229.1.24.0 229.1.25.255
IGMP Profile list_2
deny
range 234.1.1.0 234.1.255.255
switch>show ip igmp snooping
The show ip igmp snooping command displays the switch IGMP snooping configuration.
Command Mode
EXEC
Command Syntax
show ip igmp snooping [VLAN_ID]
Parameters
- no parameter displays information for all VLANs.
- vlan v_num displays information for specified VLAN.
Example
switch> show ip igmp snooping
Global IGMP Snooping configuration:
-------------------------------------------
IGMP snooping : Enabled
Robustness variable : 2
Vlan 1 :
----------
IGMP snooping : Enabled
Multicast router learning mode : pim-dvmrp
Vlan 20 :
----------
IGMP snooping : Enabled
Multicast router learning mode : pim-dvmrp
Vlan 26 :
----------
IGMP snooping : Enabled
Multicast router learning mode : pim-dvmrp
Vlan 2028 :
----------
IGMP snooping : Enabled
Multicast router learning mode : pim-dvmrp
switch>show ip igmp snooping counters
The show ip igmp snooping counters command displays the number of IGMP messages sent and received through each switch port. The display table sorts the messages by type.
Command Mode
EXEC
Command Syntax
show ip igmp snooping counters [DATA_TYPE][DATA_LEVEL]
- DATA_TYPE Information displayed by the command.
Options include:
- no parameter displays transmission counters.
- errors displays error counters.
- DATA_LEVEL specifies the type of information
displayed. Options include:
- no parameter number of packets on physical ports.
- detail number of packets on physical ports.
Example
switch> show ip igmp snooping counters
Input | Output
Port Queries Reports Leaves Others Errors|Queries Reports Leaves Others
------------------------------------------------------------------------------
Cpu 15249 106599 4 269502 0 30242 102812 972 3625
Et1 0 0 0 0 0 0 0 0 0
Et2 0 6 1 26 0 5415 0 0 731
Et3 0 10905 222 1037 0 15246 0 0 1448
Et4 0 44475 21 288 0 15247 0 0 2199
Et5 0 355 0 39 0 15211 0 0 2446
Et6 0 475 13 0 0 15247 0 0 2487
Et7 0 0 0 151 0 15247 0 0 2336
Et8 0 578 6 75 0 2859 0 0 931
Et9 0 0 0 27 0 15247 0 0 2460
Et10 0 12523 345 54 0 15247 0 0 2433
Et11 0 0 0 0 0 0 0 0 0
Et12 0 4509 41 22 0 15247 0 0 2465
Et13 0 392 29 119 0 15247 0 0 2368
Et14 0 88 3 6 0 15247 0 0 2481
Et15 0 16779 556 72 0 15117 0 0 66
Et16 0 2484 13 66 0 15247 0 0 2421
Et17 0 0 0 0 0 0 0 0 0
Et18 0 20 6 160 0 3688 0 0 803
Et19 0 4110 17 0 0 15247 0 0 2487
Et20 0 0 0 0 0 0 0 0 0
Et21 0 0 0 0 0 0 0 0 0
Et22 0 0 0 52 0 15247 0 0 2435
Et23 0 5439 181 138 0 15247 0 0 2349
Et24 0 2251 21 4 0 15247 0 0 2483
Po1 45360 540670 8853 464900 0 15249 224751 618 2576
Po2 0 101399 58 17 0 15120 0 0 1121
Switch 0 0 0 0 0 0 0 0 0show ip igmp snooping counters ethdev-pams
The show ip igmp snooping counters command displays the number of dropped IGMP packets messages sent and received through each switch port at the kernel level. The display table sorts the messages by type.
Command Mode
EXEC
Command Syntax
show ip igmp snooping counters ethdev-pams
Example
switch> show ip igmp snooping counters ethdev-pams
IntfName rxErrors txErrors txDrops
et9 1 0 0
et18 1 0 0
mlag9 1 0 0
mlag8 1 0 0
et17 1 0 0
po1 1 0 0
po2 1 0 0
et15 1 0 0
et6 1 0 0
mlag10 1 0 0
et16 1 0 0
mlag7 1 0 0
et11 1 0 0
mlag5 1 0 0
mlag4 1 0 0
cpu 1 0 0
et13 1 0 0
switch>show ip igmp snooping groups
The show ip igmp snooping groups command displays IGMP snooping statistics. Available information includes the physical ports that send and receive information, the time when multicast data was originally and most recently heard on the ports, and the version number of the IGMP messages. Command provides options that restrict the output to specific VLANs, ports, and groups.
Command Mode
EXEC
Command Syntax
show ip igmp snooping groups proxy [VLAN_ID][PORT_INT][GROUPS][DATA local]
- VLAN_ID specifies VLAN for which command displays
information. Options include:
- no parameter displays information for all VLANs.
- vlan v_num displays information for VLAN v_num (1 to 4094).
- PORT_INT specifies physical ports for which command
displays information. Options include:
- no parameter displays information for all physical ports.
- interface ethernet e_range, where e_range is the number, range, or list of Ethernet ports.
- interface port-channel p_range, where p_range is the number, range, or list of channel ports.
- GROUPS specifies the multicast groups. Options
include:
- no parameter all multicast groups on all specified ports.
- mgroup_address multicast group specified by IPv4 address (dotted decimal notation).
- dynamic multicast groups learned through IGMP.
- user multicast groups manually added.
- DATA specifies the type of information displayed.
Options include:
- no parameter VLAN number and port-list for each group.
- detail port-specific information for each group, including transmission times and expiration.
- proxy displays IGMP snooping proxy information.
- local displays the overlay with locally attached receivers.
- This command displays the port lists for all multicast
groups.
switch> show ip igmp snooping groups Vlan Group Type Version Port-List ------------------------------------------------------------------------ - 1 239.255.255.250 - - Po1, Po2 26 239.255.255.250 - - Cpu, Et3, Et4, Et10, Et23, Et27 switch> - This command displays detailed port information of all multicast
groups.
switch> show ip igmp snooping groups detail Vlan Group IP First Last Expire Ver Filter Port Heard Heard Mode ------------------------------------------------------------------------------- - 1 239.255.255.250 172.17.3.73 2536:15 0:47 3:33 v2 0 Po2 1 239.255.255.250 172.17.0.37 31532:48 0:18 1:27 - - Po1 26 239.255.255.250 172.17.26.189 5:07 0:52 3:28 v2 0 Et3 26 239.255.255.250 172.17.26.182 17:34 3:02 1:18 v2 0 Et3 26 239.255.255.250 172.17.26.245 1046:47 0:57 3:23 v2 0 Et4 26 239.255.255.250 172.17.26.184 27:41 0:53 3:27 v2 0 Et10 26 239.255.255.250 172.17.26.161 9:16 0:56 3:24 v2 0 Et23 26 239.255.255.250 172.17.26.62 90:24 0:50 3:30 v2 0 Et27 26 239.255.255.250 172.17.26.1 31532:52 0:04 1:41 - - Cpu switch> - This command displays the port lists for all dynamic multicast
groups.
switch> show ip igmp snooping groups dynamic Vlan Group Type Version Port-List ---------------------------------------------------------------------- - 1 239.255.255.250 - - Po1, Po2 26 239.255.255.250 - - Cpu, Et3, Et4, Et10, Et23, Et27, Et34 switch> - This command displays the detailed port information for all dynamic
multicast
groups.
switch> show ip igmp snooping groups dynamic detail Vlan Group IP First Last Expire Ver Filter Port Heard Heard Mode ------------------------------------------------------------------------------- - 1 239.255.255.250 172.17.3.73 2539:16 1:37 2:43 v2 0 Po2 1 239.255.255.250 172.17.0.37 31535:49 0:19 1:26 - - Po1 26 239.255.255.250 172.17.26.189 8:08 3:53 0:27 v2 0 Et3 26 239.255.255.250 172.17.26.182 20:35 1:49 2:31 v2 0 Et3 26 239.255.255.250 172.17.26.245 1049:48 1:46 2:34 v2 0 Et4 26 239.255.255.250 172.17.26.184 30:42 1:44 2:36 v2 0 Et10 26 239.255.255.250 172.17.26.161 12:17 3:57 0:23 v2 0 Et23 26 239.255.255.250 172.17.26.143 1:53 1:53 2:27 v2 0 Et23 26 239.255.255.250 172.17.26.62 93:25 1:48 2:32 v2 0 Et27 26 239.255.255.250 172.17.26.164 0:32 0:31 3:49 v2 0 Et34 26 239.255.255.250 172.17.26.1 31535:53 0:05 1:40 - - Cpu switch> - This command displays the port lists for all static (user configured)
multicast
groups.
switch> show ip igmp snooping groups user Vlan Group Type Version Port-List ------------------------------------------------------------------------ - 1 239.255.255.250 - - Po1, Po2 26 239.255.255.250 - - Cpu, Et3, Et4, Et10, Et23, Et27, Et34 switch> - This command displays detailed port information for all user configured
(static) multicast
groups.
switch> show ip igmp snooping groups user detail Vlan Group IP First Last Expire Ver Filter Port Heard Heard Mode ------------------------------------------------------------------------------- - 1 239.255.255.250 172.17.3.73 2539:50 0:06 4:14 v2 0 Po2 1 239.255.255.250 172.17.0.37 31536:23 0:23 1:22 - - Po1 26 239.255.255.250 172.17.26.182 21:09 0:21 3:59 v2 0 Et3 26 239.255.255.250 172.17.26.245 1050:22 0:17 4:03 v2 0 Et4 26 239.255.255.250 172.17.26.184 31:16 0:17 4:03 v2 0 Et10 26 239.255.255.250 172.17.26.161 12:51 0:17 4:03 v2 0 Et23 26 239.255.255.250 172.17.26.143 2:27 2:27 1:53 v2 0 Et23 26 239.255.255.250 172.17.26.62 93:59 0:22 3:58 v2 0 Et27 26 239.255.255.250 172.17.26.164 1:06 0:21 3:59 v2 0 Et34 26 239.255.255.250 172.17.26.1 31536:27 0:09 1:36 - - Cpu switch> - This command displays detailed port information for multicast group
239.255.255.253 on vlan
10.
switch> show ip igmp snooping groups vlan 10 239.255.255.253 detail Vlan Group IP First Last Expire Ver Filter Port Heard Heard Mode ------------------------------------------------------------------------------- - 10 239.255.255.253 10.255.255.246 7177:16 0:08 2:07 v2 0 Po7 10 239.255.255.253 10.255.255.247 7177:20 0:03 2:12 v2 0 Po7 10 239.255.255.253 10.255.255.248 7177:16 0:06 2:09 v2 0 Po7 10 239.255.255.253 10.255.255.254 7177:56 0:07 1:38 - - Cpu switch> - This command displays the groups that is present in IGMP report when a query
is received on any of the ports listed under
port-list.
switch> show ip igmp snooping groups proxy Vlan Group Type Port-List ------------------------------------------------- 10 225.0.0.1 Proxy Cpu, Et4, Et6 10 225.2.2.2 Proxy Cpu, Et3, Et4 10 225.3.3.3 Proxy Cpu, Et3, Et4, Et6 - This command displays all the information that is present in the IGMP report
if a general IGMP query was received on
Ethernet4.
switch> show ip igmp snooping groups proxy interface Ethernet4 detail Vlan Interface Group Source/Filter Mode --------------------------------------------------------- 10 Ethernet4 225.0.0.1 Include 150.227.112.250 190.171.60.6 10 Ethernet4 225.2.2.2 Exclude 10 Ethernet4 225.3.3.3 Exclude 150.227.112.250 - This command displays groups in the overlay with locally attached
receivers.
switch> show ip igmp snooping groups local IGMP Snooping Group Membership EX : Filter mode Exclude IN : Filter mode Include IR : Ingress Replication VLAN Group Members ---- --------------- ------------------------- 10 227.1.1.1 Et1 10 * Cpu 20 228.1.1.1 Et2 20 * Cpu 30 227.1.1.1 Et3 30 * Cpu 40 228.1.1.1 Et4 40 * Cpu Vlan Interface Group Source/Filter Mode ------------------------------------------------------------- 10 Ethernet4 225.0.0.1 Include 150.227.112.250 190.171.60.6 10 Ethernet4 225.2.2.2 Exclude 10 Ethernet4 225.3.3.3 Exclude 150.227.112.250 - This command displays groups in the overlay with remote receivers, which are
learned via SMET and Join-Synch
routes.
switch> show ip igmp snooping groups evpn IGMP Snooping Group Membership EX : Filter mode Exclude IN : Filter mode Include IR : Ingress Replication VLAN Group Members ---- --------------- ---------------- 4093 227.1.1.1 PIM-Tunnel 4094 228.1.1.1 PIM-TunnelNote: Tthe port PIM-Tunnel indicates that packets destined to these groups is encapsulated in a multicast header and sent over the underlay network.
show ip igmp snooping groups count
The show ip igmp snooping groups count command displays the number of multicast groups on the switch. Command provides options to only include specific VLANs and ports.
Command Mode
EXEC
Command Syntax
show ip igmp snooping groups [VLAN_ID][PORT_INT] count [DATA]
- VLAN_ID specifies VLAN for which command displays
information. Options include:
- no parameter all VLANs.
- vlan v_num specified VLAN.
- PORT_INT specifies physical ports for which command
displays information. Options include:
- no parameter all physical ports.
- interface ethernet e_range specified Ethernet ports.
- interface port-channel
p_range specified port channels.
Valid e_range and p_range formats include number, number range, or comma-delimited list of numbers and ranges.
- DATA specifies the type of information displayed.
Options include:
- no parameter number of multicast group on specified VLAN and ports.
- detail number of multicast group on specified VLAN and ports.
Example
switch> show ip igmp snooping groups count
Total number of multicast groups: 2
switch>show ip igmp snooping mrouter
The show ip igmp snooping mrouter command displays the status of dynamic and static multicast router ports. Command provides options to include only specific VLANs.
Command Mode
EXEC
Command Syntax
show ip igmp snooping mrouter [VLAN_ID][DATA]
- VLAN_ID specifies VLAN for which command displays
information. Options include:
- no parameter all VLANs.
- vlan v_num specified VLAN.
- DATA specifies the type of information displayed.
Options include:
- no parameter displays VLAN number and port-list for each group.
- detail displays port-specific data for each group; includes transmission times and expiration.
- This command displays port information of each multicast router on all
VLANs.
switch> show ip igmp snooping mrouter Vlan Interface-ports ---------------------------------------- 1 Po1(dynamic) 20 Po1(dynamic) 26 Cpu(dynamic) 2028 Cpu(dynamic), Po1(dynamic) switch> - This command displays multicast router information for each
port.
switch> show ip igmp snooping mrouter detail Vlan Intf Address FirstHeard LastHeard Expires Type --------------------------------------------------------------------------- 1 Po1 172.17.0.37 31549:12 0:12 1:33 pim 20 Po1 172.17.20.1 7066:51 0:19 1:26 pim 26 Cpu 172.17.26.1 31549:16 0:28 1:17 pim 2028 Po1 172.17.255.29 31549:10 0:18 1:27 pim 2028 Cpu 172.17.255.30 31549:14 0:28 1:17 pim switch>
show ip igmp snooping report-flooding
The show ip igmp snooping report-flooding command displays IGMP snooping L2 report flooding configuration and status information. Command provides options to only include specific VLANs.
Command Mode
EXEC
Command Syntax
show ip igmp snooping report-flooding [VLAN_ID][DATA]
- VLAN_ID specifies VLANs for which command displays
information. Options include:
- no parameter all VLANs.
- vlan v_num specified VLAN.
- DATA specifies the type of information displayed.
Options include:
- no parameter displays VLAN number and port-list for each group.
- detail displays port-specific data for each group; includes transmission times and expiration.
show ip igmp static-groups
The show ip igmp static-groups command displays information about all configured IGMP multicast static groups. IGMP multicast static groups are assigned with the ip igmp static-group command.
Command Mode
EXEC
Command Syntax
show ip igmp static-groups [INFO_LEVEL][interface INT_NAME]
- INFO_LEVEL specifies the type of information
displayed. Options include:
- no parameter VLAN number and port-list for each group.
- detail port-specific information for each group, including transmission times and expiration.
- INT_NAME Interface type and number. Values
include:
- no parameter static groups on all interfaces.
- ethernet e_num Ethernet interface specified by e_num.
- loopback l_num Loopback interface specified by l_num.
- management m_num Management interface specified by m_num.
- port-channel p_num Port-Channel Interface specified by p_num.
- vlan v_num VLAN interface specified by v_num.
- VXLAN vx_num VXLAN interface specified by vx_num.
- This command displays information about all multicast static
groups.
switch> show ip igmp static-groups Interface Vlan281: Manually configured groups: Interface Port-Channel999: Manually configured groups: switch> - This command displays information about the multicast static groups on
interface vlan
21.
switch> show ip igmp static-groups interface vlan 21 Interface Vlan281: Manually configured groups: switch>
show ip igmp static-groups acl
The show ip igmp static-groups acl command displays information about the IGMP multicast static groups that are configured by the specified Access Control List (ACL). The command also displays problems with an ACL that prevent its assignment to an interface.
Command Mode
EXEC
Command Syntax
show ip igmp static-groups acl
- The following show ip igmp static-group
acl command example references these
ACLs:
ip access-list 1 10 permit igmp host 10.1.1.1 10.1.1.0/29 20 permit igmp host 10.1.1.2 10.1.1.0/29 ! ip access-list 2 10 permit igmp 10.1.1.0/29 host 10.1.1.1 ! ip access-list 3 10 deny igmp host 10.1.1.1 255.1.1.0/29 ! ip access-list 4 10 permit igmp host 10.1.1.1 10.1.1.0/29 20 permit igmp 10.1.1.0/29 host 10.1.1.1 - This command displays static group configuration data
about the various
ACLs.
switch> show ip igmp static-group acl 1 acl 1 ( 10.1.1.1, 10.1.1.0/29 ) ( 10.1.1.2, 10.1.1.0/29 ) Interfaces using this ACL for static groups: Ethernet12 switch>show ip igmp static-group acl 2 acl 2 Seq no 30: source address must be a single host or *, not a range Interfaces using this ACL for static groups: Ethernet8 switch>show ip igmp static-group acl 3 acl 4 Seq no 10: action must be 'permit' Interfaces using this ACL for static groups: none switch>show ip igmp static-group acl 4 acl 5 ( 10.1.1.1, 10.1.1.0/29 ) Seq no 20: source address must be a single host or *, not a range Interfaces using this ACL for static groups: none switch>
show ip igmp static-groups group
The show ip igmp static-groups group command displays information about all specified IGMP multicast static groups. IGMP multicast static groups are assigned with the ip igmp static-group command.
Command Mode
EXEC
Command Syntax
show ip igmp static-groups group [GROUP_LIST]
Parameters
- no parameter all multicast groups.
- group_address single multicast group address (dotted decimal notation).
Related Commands
show ip igmp statistics
The show ip igmp statistics command displays IGMP transmission statistics for the specified interface.
Command Mode
EXEC
Command Syntax
show ip igmp statistics [INTERFACE_ID]
Parameters
- no parameter all interfaces.
- interface ethernet e_num Ethernet interface specified by e_num.
- interface loopback l_num Loopback interface specified byl_num.
- interface management m_num Management interface specified by m_num.
- interface port-channel p_num Port-Channel Interface specified by p_num.
- interface vlan v_num VLAN interface specified by v_num.
- interface VXLAN vx_num VXLAN interface specified byvx_num.
Example
switch> show ip igmp statistics interface ethernet 1
IGMP counters for Ethernet1:
V1 queries sent: 0
V2 queries sent: 0
V3 queries sent: 3
Total general queries sent: 3
V3 group specific queries sent: 0
V3 group-source specific queries sent: 0
V1 queries received: 0
V2 queries received: 0
V3 queries received: 0
V1 reports received: 0
V2 reports received: 0
V3 reports received: 14
V2 leaves received: 0
Error Packets received: 0
Other Packets received: 0
switch>