C H A P T E R 2

IGMP

IGMP is a protocol used by IP hosts to inform adjacent routers about multicast group membership. The SEFOS implementation of IGMP conforms to RFC 3376 for IGMP v3 router functionality and supports the MIBs defined in the Internet Draft `draft-ietfmagma-rfc2933-update-00.txt`.

The deployment of the IGMP router can be within a routing domain that uses any MRP. IGMP informs MRPs about group membership messages and leave messages.

##

2.1 IGMP Commands

The list of CLI commands for the configuration of IGMP is as follows:

- set ip igmp

- ip igmp immediate-leave

- ip igmp version

- ip igmp query-interval

- ip igmp query-max-response-time

- ip igmp robustness

- ip igmp last-member-query-interval

- ip igmp static-group

- no ip igmp

- debug ip igmp

- show ip igmp global-config

- show ip igmp interface

- show ip igmp groups

- show ip igmp sources

- show ip igmp statistics

### 2.1.1 `set ip igmp`

Enables or disables IGMP globally or on a particular interface.

    set ip igmp {enable | disable}

Syntax Description | enable - Enables IGMP. disable - Disables IGMP.
Mode | Global Configuration and Interface Configuration Note - Interface Configuration mode is applicable only in VLAN Interface.
Defaults | Disabled.
Example | SEFOS(config)# interface vlan 2 SEFOS(config-if)# set ip igmp enable

#### Related Commands

- ip igmp proxy-service / ip igmp proxy service - Enables IGMP Proxy service in the system

### 2.1.2 `ip igmp immediate-leave`

Enables immediate leave processing on the interface and the `no` form of the command disables immediate-leave processing.

    ip igmp immediate-leave

    no ip igmp immediate-leave

Mode | Interface Configuration Applicable only in VLAN Interface.
Defaults | Disabled.
Example | SEFOS(config-if)# ip igmp immediate-leave

#### Related Commands

- show ip igmp interface - Displays the interface configuration of IGMP

### 2.1.3 `ip igmp version`

Sets the IGMP version on the interface. The `no` form of the command sets the default IGMP version on the interface.

    ip igmp version {1 | 2 | 3}

    no ip igmp version

Syntax Description | 1 | 2 | 3 - IGMP versions.
Mode | Interface Configuration Applicable only in VLAN Interface.
Defaults | 2
Example | SEFOS(config-if)# ip igmp version 1

#### Related Commands

- show ip igmp interface - Displays the interface configuration of IGMP

### 2.1.4 `ip igmp query-interval`

Sets the IGMP query interval for the interface and the `no` form of the command sets query-interval to the default value.

    ip igmp query-interval seconds_1-65535

    no ip igmp query-interval

Mode | Interface Configuration Applicable only in VLAN Interface.
Defaults | 125
Example | SEFOS(config-if)# ip igmp query-interval 30

#### Related Commands

- show ip igmp interface - Displays the interface configuration of IGMP

### 2.1.5 `ip igmp query-max-response-time`

Sets the IGMP max query response value for the interface. The no form of the command sets the max query response to the default value.

    ip igmp query-max-response-time seconds_1-255

    no ip igmp query-max-response-time

Mode | Interface Configuration Applicable only in VLAN Interface.
Defaults | 100
Example | SEFOS(config-if)# ip igmp query-max-response-time 20

#### Related Commands

- show ip igmp interface - Displays the interface configuration of IGMP

### 2.1.6 `ip igmp robustness`

Sets the IGMP robustness value for the interface. The `no` form of the command sets the robustness value to default value.

    ip igmp robustness 1-255

    no ip igmp robustness

Mode | Interface Configuration Applicable only in VLAN Interface.
Defaults | 2
Example | SEFOS(config-if)# ip igmp robustness 100

#### Related Commands

- show ip igmp interface - Displays the interface configuration of IGMP

### 2.1.7 `ip igmp last-member-query-interval`

Sets the IGMP last member query interval for the interface. The `no` form of the command sets the last member query interval to the default value.

    ip igmp last-member-query-interval 1-255

    no ip igmp last-member-query-interval

Mode | Interface Configuration Applicable only in VLAN Interface.
Defaults | 10
Example | SEFOS(config-if)# ip igmp last-member-query-interval 100
Notes | The igmp on this interface must be set to version 2 or 3. For example: `SEFOS(config-if)#` ip igmp version 1 `SEFOS(config-if)#` ip igmp last-member-query-interval 100 `% CLI Command Failed` `SEFOS(config-if)#` ip igmp version 2 `SEFOS(config-if)#` ip igmp last-member-query-interval 10 `SEFOS(config-if)#` ip igmp version 3 `SEFOS(config-if)#` ip igmp last-member-query-interval 100

#### Related Commands

- show ip igmp interface - Displays the interface configuration of IGMP

### 2.1.8 `ip igmp static-group`

Adds the static group membership on the interface. The `no` form of the command deletes the static group membership on the interface.

    ip igmp static-group group-address [source source-address]

    no ip igmp static-group group-address [source source-address]

Syntax Description | group-address - Group IP address source-address - Source IP address
Mode | Interface Configuration Applicable only in VLAN Interface.
Example | SEFOS(config-if)# ip igmp static-group 224.1.2.3 source 12.0.0.1
Notes | The `igmp version` on this interface must be set to 3 for configuring static group along with source information.

#### Related Commands

- show ip igmp groups show ip igmp sources - Displays the IGMP groups information

- show ip igmp sources - Displays the IGMP sources information

- show ip igmp interface - Displays the interface configuration of IGMP

### 2.1.9 `no ip igmp`

Deletes the IGMP capable interface.

    no ip igmp

Mode | Interface Configuration Applicable only in VLAN Interface.
Example | SEFOS(config-if)# no ip igmp
Notes | At least one of the interface configuration commands must have been executed to create the IGMP interface. If not, the following error message is displayed: `% Interface Entry not found` For example: `SEFOS(config)#` int vlan 3 `SEFOS(config-if)#` no ip igmp `% Interface Entry not found` `SEFOS(config-if)#`

#### Related Commands

- show ip igmp interface - Displays the interface configuration of IGMP

### 2.1.10 `debug ip igmp`

Enables the IGMP trace. The `no` form of the command disables the IGMP trace.

    debug ip igmp {[i/o] [grp] [qry] [tmr] [mgmt] | [all]}

    no debug ip igmp {[i/o] [grp] [qry] [tmr] [mgmt] | [all]}

Syntax Description | i/o - Input/output messages. grp - Group related messages. qry - Query related messages. tmr - Timer related messages. mgmt - Management configuration messages. all - All traces.
Mode | Privileged EXEC
Defaults | Disabled.
Example | SEFOS# debug ip igmp all

### 2.1.11 `show ip igmp global-config`

Displays the global configuration of IGMP.

    show ip igmp global-config

Mode | Privileged EXEC
Example | SEFOS# show ip igmp global-config IGMP is globally enabled

#### Related Commands

- set ip igmp - Enables or disables IGMP

- ip igmp proxy-service / ip igmp proxy service - Enables IGMP Proxy service in the system

### 2.1.12 `show ip igmp interface`

Displays the interface configuration of IGMP.

    show ip igmp interface [{Vlan vlan-id | interface-type interface-id}]

Syntax Description | Vlan - VLAN identifier. interface-type - Interface type. interface-id - Interface identifier.
Mode | Privileged EXEC
Example | SEFOS# show ip igmp interface vlan1, line protocol is up Internet Address is 10.0.0.1/8 IGMP is enabled on interface Current IGMP router version is 2 IGMP query interval is 125 seconds Last member query response interval is 10 seconds IGMP max query response time is 100 seconds Robustness value is 2 IGMP querying router is 10.0.0.1 (this system) Fast leave is disabled on this interface
| No multicast groups joined vlan2, line protocol is up Internet Address is 20.0.0.1/8 IGMP is enabled on interface Current IGMP router version is 2 IGMP query interval is 125 seconds Last member query response interval is 10 seconds IGMP max query response time is 100 seconds Robustness value is 2 IGMP querying router is 20.0.0.1 (this system) Fast leave is disabled on this interface No multicast groups joined

#### Related Commands

- set ip igmp - Enables or disables IGMP

- ip igmp immediate-leave - Enables immediate leave processing on the interface

- ip igmp version - Sets the IGMP version on the interface

- ip igmp query-interval - Sets the IGMP query interval for the interface

- ip igmp query-max-response-time - Sets the IGMP max query response value for the interface

- ip igmp robustness - Sets the IGMP robustness value for the interface

- ip igmp last-member-query-interval - Sets the IGMP last member query interval for the interface

- no ip igmp - Deletes the IGMP capable interface

### 2.1.13 `show ip igmp groups`

Displays the IGMP groups information.

    show ip igmp groups

Mode | Privileged EXEC
Example | SEFOS# show ip igmp groups I - Include Mode, E - Exclude Mode S - Static Mbr, D - Dynamic Mbr GroupAddress Flg Iface UpTime ExpiryTime LastReporter ------------ ---------- ------ ----------- ------------- 224.5.5.5 S vlan2 [0d 00:00:22.28] [0d 00:00:00.00] 20.0.0.1 226.7.7.7 IS vlan3 [0d 00:00:04.59] [0d 00:00:00.00] 30.0.0.1

#### Related Commands

- ip igmp static-group - Adds the static group membership on the interface

### 2.1.14 `show ip igmp sources`

Displays the IGMP source information.

    show ip igmp sources

Mode | Privileged EXEC
Example | SEFOS# show ip igmp sources I - Include Mode, E - Exclude Mode S - Static Mbr, D - Dynamic Mbr F - Forward List, N - Non-Forward List GroupAddress Iface SrcAddress Flg ExpiryTime LastReporter ------------ ----- ---------- --- ---------- ------------ 226.7.7.7 vlan3 12.0.0.1 ISF [0d 00:00:00.00] 30.0.0.1

#### Related Commands

- ip igmp static-group - Adds the static group membership on the interface

### 2.1.15 `show ip igmp statistics`

Displays the IGMP statistics information.

    show ip igmp statistics [{Vlan vlan-id | interface-type interface-id}]

Mode | Privileged EXEC
Example | SEFOS# show ip igmp statistics IGMP Statistics for vlan1 Number of General queries received 1 Number of Group Specific queries received 0 Number of Group and Source Specific queries received 0 Number of v1/v2 reports received 0 Number of v3 reports received 8 Number of v2 leaves received 0 Number of General queries transmitted 1 Number of Group Specific queries transmitted 1 Number of Group and Source Specific queries transmitted 2 IGMP Statistics for vlan3 Number of General queries received 0 Number of Group Specific queries received 0 Number of Group and Source Specific queries received 0 Number of v1/v2 reports received 0 Number of v3 reports received 6 Number of v2 leaves received 0 Number of General queries transmitted 1 Number of Group Specific queries transmitted 0 Number of Group and Source Specific queries transmitted 0

Copyright © 2012, Oracle and/or its affiliates. All rights reserved.