IGMP Snooping Commands
ip igmp snooping Enables IGMP snooping globally or per VLAN. | ||
Syntax Description | N/A | |
Default | IGMP snooping is disabled globally and per VLAN | |
Configuration Mode | config | |
History | 3.1.1400 | |
Example |
| |
Related Commands | show ip igmp snooping | |
Notes | IGMP snooping has global admin state, and per VLAN admin state. Both states need to be enabled in order to enable the IGMP snooping on a specific VLAN. |
ip igmp snooping {last-member-query-interval <1-25> | proxy reporting mrouter-timeout <60-600> | port-purge-timeout <130-1225> | report-suppression-interval <1-25> | unregistered multicast {flood | forward-to-mrouter-ports} | version {2 | 3}} Configures global IGMP parameters. | ||
Syntax Description | last-member-query-interval <1-25> | Sets the time period (in seconds) with which the general queries are sent by the IGMP querier. After timeout expiration, the port is removed from the multicast group. |
proxy reporting | Enables proxy reporting | |
mrouter-timeout <60-600> | Sets the IGMP snooping MRouter port purge time-out after which the port gets deleted if no IGMP router control packets are received | |
port-purge-timeout <130-1225> | Sets the IGMP snooping port purge time interval after which the port gets deleted if no IGMP reports are received | |
report-suppression-interval <1-25> | Sets the IGMP snooping report-suppression time interval for which the IGMPv2 report messages for the same group will not get forwarded onto the MRouter ports | |
unregistered multicast | Sets the behavior of the snooping switch for unregistered multicast traffic
| |
version | Sets the default operating version to use for newly created IGMP snooping instances
Also available in “config vlan” configuration mode | |
Default | last-member-query-interval –1 second | |
Configuration Mode | config | |
History | 3.1.1400 | |
3.2.0500 | Added “unregistered multicast” parameter | |
3.6.1002 | Added “version parameter” | |
3.6.2100 | Changed default value for “version” parameter | |
3.7.1100 | Updated note | |
Example | switch (config) # ip igmp snooping report-suppression-interval 3 | |
Related Commands | ip igmp snooping (admin) | |
Notes | When both IGMP and IGMP snooping protocols handle a Leave message and have different values for “Last Member Query Time” timer configured, then there is traffic loss for a short period of time. |
ip igmp snooping fast-leave Enables fast leave processing on a specific interface. | ||
Syntax Description | N/A | |
Default | Enabled | |
Configuration Mode | config interface ethernet | |
History | 3.1.1400 | |
3.3.4500 | Added MPO configuration mode | |
Example | switch (config interface ethernet 1/1) # ip igmp snooping fast-leave | |
Related Commands | show ip igmp snooping interfaces | |
Notes |
ip igmp snooping mrouter interface <type> <number> Creates a static multicast router port on a specific VLAN, on a specific interface. | ||
Syntax Description | interface <type> <number> | Attaches the group to a specific interface |
Default | No static mrouters are configured | |
Configuration Mode | config vlan | |
History | 3.1.1400 | |
Example | switch (config vlan 1) # ip igmp snooping mrouter 1/1 | |
Related Commands | show ip igmp snooping mrouter | |
Notes | The multicast router port can be created only if IGMP snooping is enabled both globally and on the VLAN. |
ip igmp snooping static-group <IP address> interface <type> <number> [source <source-ip>] Creates a specified static multicast group for specified ports and from a specified source IP address. | ||
Syntax Description | IP address | Multicast IP address <224.x.x.x - 239.255.255.255> |
interface | Attach the group to a specific interface | |
type | Ethernet or port-channel | |
source | Source IP address. If omitted, a multicast group is created for all sources. | |
Default | No static groups are configured | |
Configuration Mode | config vlan | |
History | 3.1.1400 | |
3.6.2100 | Added “source” parameter | |
Example | switch (config vlan 1) # ip igmp snooping static-group 230.0.0.1 1/1 | |
Related Commands | show ip igmp snooping groups | |
Notes | If the deleted interface is the last port, it deletes the entire multicast group. |
ip igmp snooping querier Enables the IGMP Snooping Querier on a VLAN. | ||
Syntax Description | N/A | |
Default | Disable | |
Configuration Mode | config vlan | |
History | 3.3.4200 | |
Example | switch (config vlan 1)# ip igmp snooping querier | |
Related Commands | igmp snooping querier query-interval | |
Notes |
ip igmp snooping querier-guard Enables IGMP querier guard functionality on per L2 interface basis. | ||
Syntax Description | N/A | |
Default | Disabled | |
Configuration Mode | config interface ethernet config interface port-channel config interface mlag-port-channel | |
History | 3.8.2000 | |
Example | switch (config interface ethernet 1/1) # ip igmp snooping querier-guard | |
Related Commands | show ip igmp snooping querier-guard show ip igmp snooping interfaces | |
Notes | Doesn't affect layer 3 multicast router. |
ip igmp snooping querier address <ip_address> Configures the IGMP Snooping querier source IP address. | ||
Syntax Description | ip_address | The querier IP address |
Default | Disabled | |
Configuration Mode | config vlan | |
History | 3.4.2000 | |
Example | switch (config vlan 1) # ip igmp snooping querier address 1.1.1.2 | |
Related Commands | ip igmp snooping querier | |
Notes | Need to configure the querier IP address, otherwise the "0.0.0.0." address will be used. |
igmp snooping querier query-interval <time> Configures the query interval. | ||
Syntax Description | time | Time interval between queries (in seconds). |
Default | 125 seconds | |
Configuration Mode | config vlan | |
History | 3.3.4200 | |
3.7.1000 | Updated example | |
Example | switch (config vlan 1)# igmp snooping querier query-interval 100 | |
Related Commands | igmp snooping querier query-interval | |
Notes |
ip igmp snooping profile <profile_name> [seq <num>]{permit|deny} {group_address[/prefix_length]} [source_address[/prefix_length]] Defines an IGMP Snooping Filter Profile and rules of the IGMP Snooping Filter Profile. | ||
Syntax Description | profile_name | User specified profile name. |
seq <number> | Sequence number: 1-65534. | |
permit | Permits access for a matching condition. | |
deny | Denies access for a matching condition. | |
group_address[/prefix_length] | Group IP address or prefix. | |
source_address[/prefix_length] | Source IP address or prefix. | |
Default | Sequence value: 10 | |
Configuration Mode | config | |
History | 3.9.2100 | |
Example |
| |
Related Commands | show ip igmp snooping profile | |
Notes |
|
interface {ethernet <port>[-<port>] | port-channel <lag-id>[-<lag-id>] | mlag-port-channel <mlag-id>[-<mlag-id>]}ip igmp snooping filter profile <profile_name> [vlan <num>[-<range>]] no interface {ethernet <port>[-<port>] | port-channel <lag-id>[-<lag-id>] | mlag-port-channel <mlag-id>[-<mlag-id>]}ip igmp snooping filter profile <profile_name> [vlan <num>[-<range>]] Applies a defined IGMP snooping filter profile to an interface and corresponding VLANs. | ||
Syntax Description | port | Ethernet port |
lag-id | LAG ID | |
mlag-id | MLAG ID | |
profile_name | Specified name | |
vlan <num>[-<range>] | Specified VLAN or specified VLAN range | |
Default | N/A | |
Configuration Mode | config | |
History | 3.9.2100 | |
Example | switch (config)# interface ethernet 1/21 ip igmp snooping filter profile WEB-Profile vlan 1 | |
Related Commands | show ip igmp snooping profile | |
Notes |
|
interface {ethernet <port>[-<port>] | port-channel <lag-id>[-<lag-id>] | mlag-port-channel <mlag-id>[-<mlag-id>]} ip igmp snooping max-groups <value> vlan <num>[-<range>] ip igmp snooping max-groups <value> Applies maximum number of IGMP groups that can be joined on a specific interface or in a specific VLAN. | ||
Syntax Description | port | Ethernet port |
lag-id | LAG ID | |
mlag-id | MLAG ID | |
vlan <num>[-<range>] | Specified VLAN or specified VLAN range | |
max-groups <value> | Maximum number of IGMP groups | |
Default | N/A | |
Configuration Mode | config | |
History | 3.9.2100 | |
Example |
| |
Related Commands | show ip igmp snooping profile | |
Notes |
|
ip igmp version <2, 3> Sets IGMP version on interface. | ||
Syntax Description | version | Protocol IGMP version. Range: 2-3 |
Default | IGMP version 2 | |
Configuration Mode | config interface vlan | |
History | 3.3.5006 | |
3.8.1300 | Added the command to the user manual | |
Example | switch (config interface vlan 10) # ip igmp version 3 | |
Related Commands | ||
Notes |
clear ip igmp snooping counters [vlan <vlan-id>] Clears IGMP snooping counters. | ||
Syntax Description | vlan | Clears IGMP snooping counters per VLAN |
Default | N/A | |
Configuration Mode | config | |
History | 3.6.1002 | |
3.6.6000 | Updated command format | |
Example | switch (config) # clear ip igmp snooping counters vlan 2 | |
Related Commands | ||
Notes |
clear ip igmp snooping filter [interface {ethernet <port>[-<port>] | port-channel <lag-id>[-<lag-id>] | mlag-port-channel <mlag-id>[-<mlag-id>] } | vlan <num>] counters Clears the IGMP snooping filter counters for all interfaces or the specifically selected one(s). | ||
Syntax Description | port | Ethernet port |
lag-id | LAG ID | |
mlag-id | MLAG ID | |
vlan <num> | Specified VLAN | |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.9.2100 | |
Example |
| |
Related Commands | ||
Notes |
show ip igmp snooping Displays IGMP snooping information for all VLANs or a specific VLAN. | ||
Syntax Description | N/A | |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.1.1400 | |
3.6.1002 | Added default IGMP version to Example | |
3.6.6102 | Updated example | |
Example |
| |
Related Commands | ||
Notes |
show ip igmp snooping groups [vlan <vid> [group <group-ip>]] Displays per VLAN the list of multicast groups attached (static or dynamic allocated) per port. | ||
Syntax Description | vid | VLAN ID |
group | Multicast group IP address | |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.1.1400 | |
3.6.1002 | Updated example | |
3.6.2100 | Added “vlan” and “group” parameters and Updated example | |
3.6.6102 | Updated example output | |
Example | ||
switch (config) # show ip igmp snooping groups
| ||
Related Commands | ||
Notes |
show ip igmp snooping interfaces Displays IGMP snooping interface information. | ||
Syntax Description | N/A | |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.1.1400 | |
3.8.2000 | Updated example | |
3.9.2000 | Updated example | |
3.9.2100 | Updated example, adding support for IGMP snooping filtering | |
Example | switch (config) # show ip igmp snooping interfaces | |
Related Commands | ip igmp snooping querier-guard | |
Notes | The "profile_filter" and "max-groups" columns are just placeholders for the IGMP Snooping filter feature that will be introduces 3.9.2100 or later. |
show ip igmp snooping membership [vlan <vid> [group <group-ip>]] Displays information about host membership for multicast groups. | ||
Syntax Description | vlan | Displays IGMP snooping querier counters on specific VLAN |
group | Multicast group IP address | |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.6.2100 | |
Example | ||
switch (config) # show ip igmp snooping membership vlan 1 group 224.5.5.5
| ||
Related Commands | ||
Notes |
show ip igmp snooping mrouter Displays IGMP snooping multicast router information. | ||
Syntax Description | N/A | |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.1.1400 | |
Example | switch (config) # show ip igmp snooping mrouter | |
Related Commands | vlan <id> ip igmp snooping mrouter interface ethernet <id> | |
Notes |
show ip igmp snooping querier [vlan <num>] Displays running IGMP snooping querier configuration on the VLANs. | ||
Syntax Description | vlan <num> | Displays the IGMP snooping querier configuration running on the specified VLAN |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.3.4200 | |
3.6.2100 | Updated example | |
Example |
| |
Related Commands | vlan <id> ip igmp snooping querier | |
Notes |
show ip igmp snooping querier-guard [interface {ethernet <port> | port-channel <lag-id> | mlag-port-channel <mlag-id>}] Shows status of IGMP query-guard mode and statistics of the denied IGMP query packets. | ||
Syntax Description | port | Ethernet port |
lag-id | LAG ID | |
mlag-id | MLAG ID | |
Default | N/A | |
Configuration Mode | config | |
History | 3.8.2000 | |
Example |
| |
Related Commands | ip igmp snooping querier-guard interface <type> <id> ip igmp snooping querier-guard | |
Notes |
show ip igmp snooping querier counters [vlan <num> [group <group-id>]] Displays IGMP snooping querier counters. | ||
Syntax Description | vlan | Displays IGMP snooping querier counters on specific VLAN |
group | Multicast group IP address | |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.6.1002 | |
Example | switch (config) # show ip igmp snooping querier counters vlan 10 | |
Related Commands | ||
Notes |
show ip igmp snooping statistics Displays IGMP snooping statistical counters. | ||
Syntax Description | N/A | |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.1.1400 | |
3.6.1002 | Updated example | |
3.6.2100 | Updated example | |
Example | switch (config) # show ip igmp snooping statistics | |
Related Commands | ||
Notes |
show ip igmp snooping vlan {<vlan/vlan-range> | all} Displays IGMP configuration per VLAN or VLAN range. | ||
Syntax Description | vlan/vlan range | Displays IGMP VLAN configuration per specific VLAN or VLAN range |
all | Display IGMP VLAN configuration on all VLAN | |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.1.1400 | |
Example | switch (config) # show ip igmp vlan 1 | |
Related Commands | ||
Notes |
show ip igmp snooping profile <profile_name> Show content of the specified IGMP profile | ||
Syntax Description | profile_name | Specified profile name. |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.9.2100 | |
Example |
| |
Related Commands | ip igmp snooping profile | |
Notes |
show ip igmp snooping filter {interface {ethernet <port>[-<port>] | port-channel <lag-id>[-<lag-id>] | mlag-port-channel <mlag-id>[-<mlag-id>]} | vlan <num>[-<range>] } [detail[value]] | [statistics] Show statistics of the IGMP snooping filter. | ||
Syntax Description | port | Ethernet port |
lag-id | LAG ID | |
mlag-id | MLAG ID | |
vlan <num>[-<range>] | Specified VLAN or specified VLAN-range | |
detail | IGMP filter detail information | |
value | Specified number of Denied requested groups. | |
statistics | IGMP filter statistics | |
Default | N/A | |
Configuration Mode | Any command mode | |
History | 3.9.2100 | |
Example |
| |
Related Commands | ||
Notes |
REJECT IGMP report of (Source, Group) = (1st source, 239.1.12.33) from Host x.x.x.x due to max-groups limit. REJECT IGMP report of (Source, Group) = (source1, source2,... 239.1.12.33) from Host x.x.x.x due to profile (profile_name_xxx) filtering For profile filtering, it could be partial source address matching, i.e., some source addresses are filtered, while the group record remains not filtered. The related log is like the following format: “REJECT these source address list (src2, src4, ... ) out of IGMP report of Group (239.239.0.18), from Host x.x.x.x due to profile (profile_name_xxx) filtering”
|