Published On: August 6ᵗʰ, 2019 02:05

Cisco Enterprise Network Compute System Switch Command Reference

IGMP Snooping Commands

ip igmp snooping enable (Global)

To enable Internet Group Management Protocol (IGMP) snooping, use the ip igmp snooping enable command in switch configuration mode. To return to the default, use the no form of this command.

ip igmp snooping enable

no ip igmp snooping enable

Syntax Description

This command does not have any arguments

Command Default

Disabled

Command Modes

Switch configuration (config-switch)

Command History

Release Modification
3.5.1

This command was introduced.

Examples

The following example enables IGMP snooping:

nfvis(config-switch)# ip igmp snooping enable
nfvis(config-switch)# commit
nfvis(config-switch)# end

ip igmp snooping querier enable

To enable IGMP Snooping querier globally, use the ip igmp snooping querier enable command in switch configuration mode. To disable the IGMP Snooping querier globally, use the no form of this command.

ip igmp snooping querier enable

no ip igmp snooping querier enable

Syntax Description

This command has no arguments.

Command Default

Enabled

Command Modes

Switch configuration (config-switch)

Command History

Release Modification
3.5.1

This command was introduced.

Usage Guidelines

To run the IGMP Snooping querier on a VLAN, you have to enable it globally and on the VLAN.

Examples

The following example disables the IGMP Snooping querier globally:

nfvis(config-switch)# no ip igmp snooping querier enable 
nfvis(config-switch)# commit 
nfvis(config-switch)# end

ip igmp snooping vlan enable

To enable IGMP snooping on a specific VLAN, use the ip igmp snooping vlan enable command in switch configuration mode. To return to the default, use the no form of this command.

ip igmp snooping VLAN vlan-id enable

no ip igmp snooping VLAN vlan-id enable

Syntax Description

vlan-id

Specifies the VLAN.

Command Default

Disabled

Command Modes

Switch configuration (config-switch)

Command History

Release Modification
3.5.1

This command was introduced.

Usage Guidelines

IGMP snooping can be enabled only on static VLANs.

IGMPv1, IGMPv2, and IGMPv3 snooping are supported.

To activate IGMP snooping, bridge multicast filtering must be enabled using the bridge multicast filtering command.

Examples

The following example enables IGMP snooping on VLAN 2:

nfvis(config-switch)# ip igmp snooping vlan 2 enable
nfvis(config-switch)# commit
nfvis(config-switch)# end

ip igmp snooping vlan forbidden mrouter

To forbid a Gigabit Ethernet or port channel port from being defined as a Multicast router port by static configuration or by automatic learning, use the ip igmp snooping vlan forbidden mrouter command in switch configuration mode. To return to the default, use the no form of this command.

ip igmp snooping vlan vlan-id forbidden mrouter interface { gigabitEthernet | port-channel} interface-id

no ip igmp snooping vlan vlan-id forbidden mrouter interface

Syntax Description

vlan vlan-id

Specifies the VLAN ID.
interface

Specifies the interface type.

gigabitEthernet

Specifies Gigabit Ethernet as the interface type.

port-channel

Specifies port channel as the interface type.
interface-id

Specifies the interface ID.

Command Default

No ports are defined.

Command Modes

Switch configuration mode (config-switch)

Command History

Release Modification
3.6.1 The port-channel parameter was added.
3.5.1 This command was introduced.

Usage Guidelines

A port that is defined as a Multicast router port receives all IGMP packets (reports and queries) as well as all multicast data.

You can execute the command before the VLAN is created.

Examples

nfvis(config-switch)# ip igmp snooping vlan 2 forbidden mrouter interface gigabitEthernet 1/1

nfvis(config-switch)# commit
nfvis(config-switch)# end

ip igmp snooping vlan immediate-leave

To enable the IGMP Snooping Immediate-Leave processing on a VLAN, use the ip igmp snooping vlan immediate-leave command in switch configuration mode. To return to the default, use the no form of this command.

ip igmp snooping VLAN vlan-id immediate-leave

no ip igmp snooping VLAN vlan-id immediate-leave

Syntax Description

vlan-id

Specifies the VLAN ID.

Command Default

Disabled

Command Modes

Switch configuration (config-switch)

Command History

Release Modification
3.5.1

This command was introduced.

Usage Guidelines

You can run this command before creating the VLAN.

Examples

The following example enables IGMP snooping immediate-leave feature on VLAN 2.

nfvis(config-switch)# ip igmp snooping vlan 2 immediate-leave 
nfvis(config-switch)# commit
nfvis(config-switch)# end

ip igmp snooping vlan querier address

To define the source IP address that the IGMP snooping querier uses, use the ip igmp snooping vlan querier address command in switch configuration mode. To return to the default, use the no form of this command.

ip igmp snooping VLAN vlan-id querier address ip-address

no ip igmp snooping VLAN vlan-id querier address ip-address

Syntax Description

vlan-id

Specifies the VLAN.
ip-address

Define the source IP address.

Command Default

If an IP address is configured for the VLAN, it is used as the source address of the IGMP snooping querier. If there are multiple IP addresses, the minimum IP address defined on the VLAN is used.

Command Modes

Switch configuration (config-switch)

Command History

Release Modification
3.5.1

This command was introduced.

Usage Guidelines

If an IP address is not configured by this command, and no IP address is configured for the querier’s VLAN, the querier is disabled.

Examples

nfvis(config-switch)# ip igmp snooping vlan 1 querier address 192.0.2.1
nfvis(config-switch)# commit
nfvis(config-switch)# end

ip igmp snooping vlan querier version

To configure the IGMP version of an IGMP Snooping querier on a specific VLAN, use the ip igmp snooping vlan querier version command in interface switch configuration mode. To return to the default, use the no form of this command.

ip igmp snooping VLAN vlan-id querier version { 2 | 3}

no ip igmp snooping VLAN vlan-id querier version { 2 | 3}

Syntax Description

vlan-id

Specifies the VLAN.
version 2

Specifies that the IGMP version would be IGMPv2.
version 3

Specifies that the IGMP version would be IGMPv3.

Command Default

IGMPv2.

Command Modes

Interface switch configuration (config-switch-if)

Command History

Release Modification
3.5.1

This command was introduced.

Examples

The following example sets the version of the IGMP Snooping Querier VLAN 1 to 3:

nfvis(config-switch)# ip igmp snooping vlan 1 querier version 3

ip igmp snooping vlan querier enable

To enable the IGMP Snooping querier on a specific VLAN, use the ip igmp snooping vlan querier enable command in switch configuration mode. To disable the IGMP Snooping querier on the VLAN interface, use the no form of this command.

ip igmp snooping VLAN vlan-id querier enable

no ip igmp snooping VLAN vlan-id querier

Syntax Description

vlan-id

Specifies the VLAN ID.

Command Default

Disabled

Command Modes

Switch configuration (config-switch)

Command History

Release Modification
3.5.1

This command was introduced.

Usage Guidelines

The IGMP Snooping querier can be enabled on a VLAN only if IGMP Snooping is enabled for that VLAN.

Examples

The following example enables the IGMP Snooping querier on VLAN 1:

nfvis(config-switch)# ip igmp snooping vlan 1 querier enable
nfvis(config-switch)# commit
nfvis(config-switch)# end