Layer 2 IGMP Snooping Multicast Commands
This chapter describes commands for Internet Group Management Protocol (IGMP) multicast snooping.
clear igmp snooping
Use this command to clear IGMP snooping groups and interface.
Command Syntax
clear igmp snooping group *
clear igmp snooping group A.B.C.D (IFNAME|)
clear igmp snooping interface IFNAME
Parameters
*
Displays all groups
IFNAME
The name of the VLAN interface
A.B.C.D
Multicast group Address
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 6.2.0.
Examples
#clear igmp snooping group *
igmp snooping
Use this command to enable IGMP Snooping. When this command is given in the Configure mode, IGMP snooping is enabled at switch level on all the vlans in switch. When this command is given at the VLAN interface level, IGMP Snooping is enabled for that VLAN.
Note: IGMP Snooping can be only enabled/disabled on VLAN interfaces.
Use the no parameter with this command to globally disable IGMP Snooping, or for the specified interface.
Command Syntax
igmp snooping (disable|enable)
no igmp snooping
Parameter
None
Default
IGMP Snooping is enabled.
Command Mode
Interface mode for VLAN interface
Configuration mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#igmp snooping
(config)#interface vlan1.1
(config-if)#igmp snooping enable
igmp snooping fast-leave
Use this command to enable IGMP Snooping fast-leave processing. Fast-leave processing is analogous to immediate-leave processing; the IGMP group-membership is removed as soon as an IGMP leave group message is received without sending out a group-specific query.
Use the no parameter with this command to disable fast-leave processing.
Command Syntax
igmp snooping fast-leave
no igmp snooping fast-leave
Parameters
None
Default
IGMP Snooping fast-leave processing is disabled.
Command Mode
Interface mode for VLAN interface
Applicability
This command was introduced before OcNOS version 1.3.
Example
This example shows how to enable fast-leave processing on a VLAN.
#configure terminal
(config)#interface vlan1.1
(config-if)#igmp snooping fast-leave
igmp snooping mrouter
Use this command to statically configure the specified VLAN constituent interface as a multicast router interface for IGMP Snooping in that VLAN.
Use the no parameter with this command to remove the static configuration of the interface as a multicast router interface.
Command Syntax
igmp snooping mrouter interface IFNAME
no igmp snooping mrouter interface IFNAME
Parameter
IFNAME
Specify the name of the interface.
Default
IGMP Snooping mrouter processing is disabled.
Command Mode
Interface mode for VLAN interface.
Applicability
This command was introduced before OcNOS version 1.3.
Example
This example shows interface fe8 statically configured to be a multicast router interface.
#configure terminal
(config)#interface vlan1.1
(config-if)#igmp snooping mrouter interface fe8
igmp snooping querier
Use this command to enable IGMP snooping querier functionality on a VLAN when IGMP is not enabled on the particular VLAN. When enabled, the IGMP Snooping querier sends out periodic IGMP queries for all interfaces on that VLAN.
The IGMP Snooping querier uses the 0.0.0.0 source IP address, because it only masquerades as a proxy IGMP querier for faster network convergence. It does not start, or automatically cease, the IGMP Querier operation if it detects query message(s) from a multicast router. It restarts as the IGMP Snooping querier if no queries are seen within the other querier interval.
Use the no parameter with this command to disable IGMP querier configuration.
Command Syntax
igmp snooping querier
no igmp snooping querier
Default
By default, Querier is disabled
Parameters
None
Command Mode
Interface mode for VLAN interface.
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#interface vlan1.1
(config-if)#igmp snooping querier
igmp snooping report-suppression
Use this command to enable report suppression for IGMP version 1, 2 and 3 reports.
Use the no parameter with this command to disable report suppression.
Command Syntax
igmp snooping report-suppression (disable|enable)
no igmp snooping report-suppression
Default
By default, report suppression is enabled on x86.
Parameters
None
Command Mode
Interface mode for VLAN interface.
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#interface vlan1.1
(config-if)#igmp snooping report-suppression enable
igmp snooping static-group
Use this command to statically configure group membership entries on an interface
Use the no parameter with this command to disable report suppression.
Command Syntax
igmp snooping static-group A.B.C.D interface IFNAME
no igmp snooping static-group A.B.C.D interface IFNAME
igmp snooping static-group A.B.C.D source A.B.C.D interface IFNAME
no igmp snooping static-group A.B.C.D source A.B.C.D interface IFNAME
Parameters
IFNAME
Specify the name of the interface.
A.B.C.D
Specify the IP address
In case of static-group, Multicast Address to be Joined.
In case of source, Source Address to be Joined.
Command Mode
Interface mode for VLAN interface.
Applicability
This command was introduced before OcNOS version 1.3.
Example
#conf t
(config)#interface vlan1.1
(config-if)#igmp snooping static-group 230.0.0.1 interface xe2
(config-if)#igmp snooping static-group 230.0.0.1 source 10.10.10.10 interface xe1
(config-if)#exit
(config)#exit
show igmp snooping interface
Use this command to know querier, fast-leave, report-suppression is enabled/disabled on that particular interface.
Command Syntax
show igmp snooping interface IFNAME
Parameters
IFNAME
Specify the name of the interface.
Command Mode
Exec and Privileged Exec mode
Default
By default, report suppression is disabled on Qumran devices.
Applicability
This command was introduced before OcNOS version 1.3.
Example
The following command displays the multicast router interfaces.
#show igmp snooping interface
Global IGMP Snooping information
IGMP Snooping Enabled
IGMPv1/v2 Report suppression Enabled
IGMPv3 Report suppression Enabled
IGMP Snooping information for vlan1.1
IGMP Snooping enabled
Snooping Querier none
IGMP Snooping other querier timeout is 255 seconds
Group Membership interval is 260 seconds
IGMPv2 fast-leave is disabled
IGMPv1/v2 Report suppression disabled
IGMPv3 Report suppression disabled
Router port detection using IGMP Queries
Number of router-ports: 0
Number of Groups: 0
Number of v1-reports: 0
Number of v2-reports: 0
Number of v2-leaves: 0
Number of v3-reports: 0
Active Ports:
xe5/1
IGMP Snooping information for vlan1.2
IGMP Snooping enabled
Snooping Querier enabled, address 0.0.0.0, Version 3
Querier interval: 125 seconds
Querier Last member query interval: 1000 milliseconds
IGMP Snooping information for vlan1.2
IGMP Snooping enabled
Snooping Querier enabled, address 0.0.0.0, Version 3
Querier interval: 125 seconds
Querier Last member query interval: 1000 milliseconds
IGMP Snooping maximum query response time is 10 seconds
IGMP Snooping Startup query interval is 31 seconds
Querier robustness: 2
IGMP Snooping other querier timeout is 255 seconds
Group Membership interval is 260 seconds
IGMPv2 fast-leave is disabled
IGMPv1/v2 Report suppression disabled
IGMPv3 Report suppression disabled
Router port detection using IGMP Queries
Number of router-ports: 0
Number of Groups: 0
Number of v1-reports: 0
Number of v2-reports: 0
Number of v2-leaves: 0
Number of v3-reports: 0
Active Ports:
xe5/1
show igmp snooping groups
Use this command to display the multicast groups learnt through snooping or statically configured.
Command Syntax
show igmp snooping groups
show igmp snooping groups details
show igmp snooping groups A.B.C.D
show igmp snooping groups A.B.C.D detail
show igmp snooping groups IFNAME
show igmp snooping groups IFNAME A.B.C.D
show igmp snooping groups IFNAME A.B.C.D detail
show igmp snooping groups IFNAME detail
Parameters
A.B.C.D
Specify multicast group address.
IFNAME
Specify the name of the interface.
detail
IGMPv3 source information.
Command Mode
Exec and Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#show igmp snooping groups
IGMP Snooping Group Membership
Group source list: (R - Remote, S - Static)
Vlan Group/Source Address Interface Flags Uptime Expires Last Reporter Version
200 230.0.0.1 xe1 S 00:02:07 static 0.0.0.0 V3
#show igmp snooping groups detail
IGMP Snooping Group Membership Details
Flags: (R - Remote, S - Static)
Interface: xe1
Group: 230.0.0.1
Flags: S
Uptime: 00:02:08
Group mode: Exclude (Static)
Last reporter: 0.0.0.0
Source list is empty
#show igmp snooping groups 230.0.0.1
IGMP Snooping Group Membership
Group source list: (R - Remote, S - Static)
Vlan Group/Source Address Interface Flags Uptime Expires Last Reporter Version
200 230.0.0.1 xe1 S 00:02:35 static 0.0.0.0 V3
#show igmp snooping groups 230.0.0.1 detail
IGMP Snooping Group Membership Details
Flags: (R - Remote, S - Static)
Interface: xe1
Group: 230.0.0.1
Flags: S
Uptime: 00:02:37
Group mode: Exclude (Static)
Last reporter: 0.0.0.0
Source list is empty
#show igmp snooping groups vlan1.200
IGMP Snooping Group Membership
Group source list: (R - Remote, S - Static)
Vlan Group/Source Address Interface Flags Uptime Expires Last Reporter Version
200 230.0.0.1 xe1 S 00:02:47 static 0.0.0.0 V3
#show igmp snooping groups vlan1.200 detail
IGMP Snooping Group Membership Details
Flags: (R - Remote, S - Static)
Interface: xe1
Group: 230.0.0.1
Flags: S
Uptime: 00:02:50
Group mode: Exclude (Static)
Last reporter: 0.0.0.0
Source list is empty
Table 2-8: Show igmp snooping groups
Entries | Description |
|---|
Interface | The interface (port) on the multicast router that is marked as taking place in the multicast. |
Group | The multicast group identified by an IPv4 address. |
Flags | S - Member is statically configured, R - Member is learned from the network. |
Uptime | How long the member has been a part of the group. |
Group mode | As stated. |
Last reporter | In IGMPv3, a host can send a membership report that includes a list of source addresses. When the host sends a membership report in INCLUDE mode, the host is interested in group multicast traffic only from those sources in the source address list. If host sends a membership report in EXCLUDE mode, the host is interested in group multicast traffic from any source except the sources in the source address list. A host can also send an EXCLUDE report in which the source-list parameter is empty, which is known as an EXCLUDE NULL report. An EXCLUDE NULL report indicates that the host wants to join the multicast group and receive packets from all sources. |
Vlan | VLAN number ID. |
Group/Source Address | Multicast group and source addresses. |
Interface | The interface (port) on the multicast router that is marked as taking place in the multicast. |
Flags | S - Member is statically configured, R - Member is learned from the network. |
Uptime | How long the member has been a part of the group. |
Expires | Either by a timeout (IGMPv1) or by checking whether the member is still a part of the multicast (IGMPv2 or v3). Can also be statically configured. |
Last Reporter | Indicates that the host wants to join a particular multicast group. |
Version | IGMP version (v1, v2, or v3). |
show igmp snooping mrouter
Use this command to display the multicast router interfaces, both configured and learned, in a VLAN.
Command Syntax
show igmp snooping mrouter IFNAME
Parameters
IFNAME
Specify the name of the interface.
Command Mode
Exec and Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
The following command displays the multicast router interfaces in VLAN 1.1.
#show igmp snooping mrouter vlan1.1
VLAN Interface IP-address Expires
1 xe1(static)
show igmp snooping statistics
Use this command to display IGMP Snooping statistics data.
Command Syntax
show igmp snooping statistics interface IFNAME
Parameters
IFNAME
Specify the name of the interface.
Command Mode
Exec and Privileged Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#show igmp snooping statistics interface vlan1.1
IGMP Snooping statistics for vlan1.1
Group Count : 1
IGMPv1 reports received : 0
IGMPv2 reports received : 0
IGMPv2 leaves received : 0
IGMPv3 reports received : 0
IGMPv1 query warnings : 0
IGMPv2 query warnings : 0
IGMPv3 query warnings : 0