IGMP commands -- display igmp group

Use display igmp group to display information about IGMP multicast groups (multicast groups that hosts have joined through IGMP).

Syntax

display igmp [ vpn-instance vpn-instance-name ] group [ group-address | interface interface-type interface-number ] [ static | verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays information about IGMP multicast groups on the public network.

group-address: Specifies a multicast group by its IP address in the range of 224.0.1.0 to 239.255.255.255. If you do not specify a multicast group, this command displays information about all IGMP multicast groups.

interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays information about IGMP multicast groups for all interfaces.

static: Specifies IGMP multicast groups that hosts have joined statically. If you do not specify this keyword, the command displays information about IGMP multicast groups that hosts have joined dynamically.

verbose: Displays detailed information.

Examples

# Display information about IGMP multicast groups that hosts have dynamically joined on the public network. (Applicable to routers.)

<Sysname> display igmp group

IGMP groups in total: 3

GigabitEthernet1/0/1(10.10.1.20):

IGMP groups reported in total: 3

Group address Last reporter Uptime Expires

225.1.1.1 10.10.1.10 00:02:04 00:01:15

225.1.1.2 10.10.1.10 00:02:04 00:01:15

225.1.1.3 10.10.1.10 00:02:04 00:01:15

# Display information about IGMP multicast groups that hosts have dynamically joined on the public network. (Applicable to switches.)

<Sysname> display igmp group

IGMP groups in total: 3

Vlan-interface1(10.10.1.20):

IGMP groups reported in total: 3

Group address Last reporter Uptime Expires

225.1.1.1 10.10.1.10 00:02:04 00:01:15

225.1.1.2 10.10.1.10 00:02:04 00:01:15

225.1.1.3 10.10.1.10 00:02:04 00:01:15

Table 1 Command output

Field | Description
IGMP groups in total | Total number of IGMP multicast groups.
IGMP groups reported in total | Total number of IGMP multicast groups that hosts attached to the interface have joined dynamically.
Group address | Multicast group address.
Last reporter | Address of the last host that reported its membership to the multicast group.
Uptime | Length of time since the multicast group was reported.
Expire | Remaining lifetime for the multicast group. This field displays Off if the timer is disabled.

# Display detailed information about IGMP multicast group 232.1.1.1 that hosts have dynamically joined on the public network. In this example, the router is configured with IGMP SSM mappings. (Applicable to routers.)

<Sysname> display igmp group 232.1.1.1 verbose

GigabitEthernet1/0/1(10.10.1.20):

IGMP groups reported in total: 3

Group: 232.1.1.1

Uptime: 00:00:34

Exclude expires: 00:04:16

Mapping expires: 00:02:16

Last reporter: 10.10.1.10

Last-member-query-counter: 0

Last-member-query-timer-expiry: Off

Mapping last-member-query-counter: 0

Mapping last-member-query-timer-expiry: Off

Group mode: Exclude

Version1-host-present-timer-expiry: Off

Version2-host-present-timer-expiry: 00:02:11

Mapping version1-host-present-timer-expiry: Off

Source list (sources in total: 1):

Source: 10.1.1.1

Uptime: 00:00:03

V3 expires: 00:04:16

Mapping expires: 00:02:16

Last-member-query-counter: 0

Last-member-query-timer-expiry: Off

# Display detailed information about IGMP multicast group 232.1.1.1 that hosts have dynamically joined on the public network. In this example, the switch is configured with IGMP SSM mappings. (Applicable to switches.)

<Sysname> display igmp group 232.1.1.1 verbose

Vlan-interface1(10.10.1.20):

IGMP groups reported in total: 3

Group: 232.1.1.1

Uptime: 00:00:34

Exclude expires: 00:04:16

Mapping expires: 00:02:16

Last reporter: 10.10.1.10

Last-member-query-counter: 0

Last-member-query-timer-expiry: Off

Mapping last-member-query-counter: 0

Mapping last-member-query-timer-expiry: Off

Group mode: Exclude

Version1-host-present-timer-expiry: Off

Version2-host-present-timer-expiry: 00:02:11

Mapping version1-host-present-timer-expiry: Off

Source list (sources in total: 1):

Source: 10.1.1.1

Uptime: 00:00:03

V3 expires: 00:04:16

Mapping expires: 00:02:16

Last-member-query-counter: 0

Last-member-query-timer-expiry: Off

Table 2 Command output

Field | Description
IGMP groups reported in total | Total number of IGMP multicast groups that hosts attached to the interface have joined dynamically.
Group | Multicast group address.
Uptime | Length of time since the multicast group was reported.
Exclude expires | Remaining lifetime for the multicast group in Exclude mode. This field displays Off if the timer is disabled.
Mapping expires | Remaining time for the multicast group specified in IGMP SSM mappings. This field is displayed only when the device is configured with IGMP SSM mappings.
Last reporter | Address of the last host that reported its membership to this multicast group.
Last-member-query-counter | Number of IGMP group-specific queries or IGMP source-and-group-specific queries sent for the multicast group.
Last-member-query-timer-expiry | Remaining time for the last member query timer for the multicast group. This field displays Off if the timer is disabled.
Mapping last-member-query-counter | Number of IGMP group-specific queries or IGMP source-and-group-specific queries sent for the multicast group specified in IGMP SSM mappings. This field is displayed only when the device is configured with IGMP SSM mappings.
Mapping last-member-query-timer-expiry | Remaining time for the last member query timer of the multicast group specified in IGMP SSM mappings. This field displays Off if the timer is disabled. This field is displayed only when the device is configured with IGMP SSM mappings.
Group mode | Multicast source filtering mode: · Include—Include mode. · Exclude—Exclude mode. For a device that runs IGMPv1 or IGMPv2: · If IGMP SSM mappings are not configured, this field displays Exclude. · If IGMP SSM mappings are configured, this field displays Include or Exclude depending on the SSM mappings and the multicast groups that the host joins.
Version1-host-present-timer-expiry | Remaining time for the IGMPv1 host present timer. This field displays Off if the timer is disabled. This field is displayed only when the device runs IGMPv2 or IGMPv3.
Version2-host-present-timer-expiry | Remaining time for the IGMPv2 host present timer. This field displays Off if the timer is disabled. This field is displayed only when the device runs IGMPv3.
Mapping version1-host-present-timer-expiry | Remaining time for the IGMPv1 host present timer when the device is configured with IGMP SSM mappings. This field displays Off if the timer is disabled. This field is displayed only when the device is configured with IGMP SSM mappings.
Source list (sources in total) | List of multicast sources and total number of multicast sources. This field is displayed only when the device runs IGMPv3 or when the device is configured with IGMP SSM mappings.
Source | Multicast source address. This field is displayed only when the device runs IGMPv3 or when the device is configured with IGMP SSM mappings.
Uptime | Length of time since the multicast source was reported. This field is displayed only when the device runs IGMPv3 or when the device is configured with IGMP SSM mappings.
V3 expires | Remaining time for the multicast source when the device runs IGMPv3. This field displays Off if the timer is disabled and displays three hyphens (---) if the multicast source is specified in IGMP SSM mappings. This field is displayed only when the device runs IGMPv3 or when the device is configured with IGMP SSM mappings.
Mapping expires | Remaining time for the multicast source specified in IGMP SSM mappings. This field is displayed only when the device is configured with IGMP SSM mappings.
Last-member-query-counter | Number of IGMP group-specific queries or IGMP group-and-source-specific queries sent for the multicast source and group. This field is displayed only when the device runs IGMPv3 or is configured with IGMP SSM mappings.
Last-member-query-timer-expiry | Remaining time for the last member query timer for the multicast source and group. This field displays Off if the timer is disabled. This field is displayed only when the device runs IGMPv3 or is configured with IGMP SSM mappings.

# Display information about IGMP multicast groups that hosts have statically joined on the public network. (Applicable to routers.)

<Sysname> display igmp group static

Entries in total: 2

Group address Source address Interface Expires

225.1.1.1 0.0.0.0 GE1/0/1 Never

225.2.2.2 1.1.1.1 GE1/0/1 Never

# Display information about IGMP multicast groups that hosts have statically joined on the public network. (Applicable to switches.)

<Sysname> display igmp group static

Entries in total: 2

Group address Source address Interface Expires

225.1.1.1 0.0.0.0 Vlan1 Never

225.2.2.2 1.1.1.1 Vlan1 Never

Table 3 Command output

Field | Description
Entries in total | Total number of the multicast groups that hosts have joined statically.
Group address | Multicast group address.
Source address | Multicast source address.
Interface | Interface name.
Expires | Remaining lifetime for the multicast group. This field always displays Never because the multicast group never expires.

Related commands

reset igmp group

IGMP commands -- display igmp interface

Use display igmp interface to display IGMP information for interfaces.

Syntax

display igmp [ vpn-instance vpn-instance-name ] interface [ interface-type interface-number ] [ host | proxy ] [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays IGMP information for interfaces on the public network.

interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays IGMP information for all IGMP-enabled interfaces.

host: Displays information about the interfaces enabled with the IGMP host feature. If you do not specify this keyword, the command displays IGMP information for interfaces enabled with IGMP and those enabled with the IGMP host feature. For more information about the IGMP host feature, see VXLAN Configuration Guide.

proxy: Displays the IGMP proxy interface information. If you do not specify this keyword, the command displays IGMP information about all interfaces.

verbose: Displays detailed IGMP information.

Examples

# Display detailed IGMP information for GigabitEthernet 1/0/1 (non-proxy interface) on the public network. (Applicable to routers.)

<Sysname> display igmp interface gigabitethernet 1/0/1 verbose

GigabitEthernet1/0/1(10.10.1.20):

IGMP is enabled.

IGMP version: 2

Query interval for IGMP: 125s

Other querier present time for IGMP: 255s

Maximum query response time for IGMP: 10s

Last member query interval: 1s

Last member query count: 2

Startup query interval: 31s

Startup query count: 2

General query timer expiry (hh:mm:ss): 00:00:54

Querier for IGMP: 10.10.1.20 (This router)

IGMP activity: 1 join(s), 0 leave(s)

Multicast routing on this interface: Enabled

Robustness: 2

Require-router-alert: Disabled

Fast-leave: Disabled

Startup-query: Off

Other-querier-present-timer-expiry (hh:mm:ss): Off

Authorization: Disabled

Join-by-session: Disabled

User-VLAN-aggregation: Disabled

IGMP groups reported in total: 1

# Display detailed IGMP information for all IGMP proxy interfaces on the public network. (Applicable to routers.)

<Sysname> display igmp interface proxy verbose

GigabitEthernet1/0/2(20.10.1.20):

IGMP proxy is enabled.

IGMP version: 2

Multicast routing on this interface: Enabled

Require-router-alert: Disabled

Version1-querier-present-timer-expiry (hh:mm:ss): Off

# Display detailed IGMP information for all interfaces enabled with the IGMP host feature on the public network. (Applicable to routers.)

<Sysname> display igmp interface host verbose

GigabitEthernet1/0/3(30.10.1.20):

IGMP host is enabled.

IGMP version: 2

Multicast routing on this interface: Enabled

Require-router-alert: Disabled

Version1-querier-present-timer-expiry (hh:mm:ss): Off

# Display detailed IGMP information for VLAN-interface 1 (non-proxy interface) on the public network. (Applicable to switches.)

<Sysname> display igmp interface vlan-interface 1 verbose

Vlan-interface1(10.10.1.20):

IGMP is enabled.

IGMP version: 2

Query interval for IGMP: 125s

Other querier present time for IGMP: 255s

Maximum query response time for IGMP: 10s

Last member query interval: 1s

Last member query count: 2

Startup query interval: 31s

Startup query count: 2

General query timer expiry (hh:mm:ss): 00:00:54

Querier for IGMP: 10.10.1.20 (This router)

IGMP activity: 1 join(s), 0 leave(s)

Multicast routing on this interface: Enabled

Robustness: 2

Require-router-alert: Disabled

Fast-leave: Disabled

Startup-query: Off

Other-querier-present-timer-expiry (hh:mm:ss): Off

Authorization: Disabled

Join-by-session: Disabled

User-VLAN-aggregation: Disabled

IGMP groups reported in total: 1

# Display detailed IGMP information for all IGMP proxy interfaces on the public network. (Applicable to switches.)

<Sysname> display igmp interface proxy verbose

Vlan-interface2(20.10.1.20):

IGMP proxy is enabled.

IGMP version: 2

Multicast routing on this interface: Enabled

Require-router-alert: Disabled

Version1-querier-present-timer-expiry (hh:mm:ss): Off

# Display detailed IGMP information for all interfaces enabled with the IGMP host feature on the public network. (Applicable to switches.)

<Sysname> display igmp interface host verbose

Vlan-interface3(30.10.1.20):

IGMP host is enabled.

IGMP version: 2

Multicast routing on this interface: Enabled

Require-router-alert: Disabled

Version1-querier-present-timer-expiry (hh:mm:ss): Off

Table 4 Command output

Field | Description
GigabitEthernet1/0/1(10.10.1.20) | Interface and its IP address. (Applicable to routers.)
Vlan-interface1(10.10.1.20) | Interface and its IP address. (Applicable to switches.)
IGMP is enabled | IGMP is enabled on the interface.
IGMP version | Version of IGMP that the interface runs.
Query interval for IGMP | IGMP general query interval, in seconds.
Other querier present time for IGMP | IGMP other querier present interval, in seconds.
Maximum query response time for IGMP | Maximum response time for IGMP general queries, in seconds.
Last member query interval | Interval for sending IGMP group-specific queries or IGMP group-and-source-specific queries, in seconds.
Last member query count | Number of IGMP group-specific queries or IGMP group-and-source-specific queries sent for the multicast group.
Startup query interval | Interval for sending IGMP general queries on startup, in seconds.
Startup query count | Number of IGMP general queries that the device sends on startup.
General query timer expiry | Remaining time for the IGMP general query timer. This field displays Off if the timer is disabled.
Querier for IGMP | IP address of the IGMP querier. This field is not displayed when the device runs IGMPv1 and the device is not the IGMP querier. NOTE: In IGMPv1, the PIM DR acts as the IGMP querier. You can use the display pim interface command to display PIM information.
No querier elected | No IGMP querier election is performed. This field is displayed when the device runs IGMPv1 and is not the IGMP querier. NOTE: In IGMPv1, the PIM DR acts as the IGMP querier. You can use the display pim interface command to display PIM information.
IGMP activity: 1 join(s), 0 leave(s) | Statistics of IGMP activities: · join(s)—Total number of multicast groups that this interface has joined. · leave(s)—Total number of multicast groups that this interface has left.
Multicast routing on this interface | Whether IP multicast routing is enabled: Enabled or Disabled.
Robustness | Robustness variable of the IGMP querier.
Require-router-alert | Whether the feature of dropping IGMP messages without Router-Alert is enabled: Enabled or Disabled,
Fast-leave | Whether the fast-leave processing feature is enabled: Enabled or Disabled.
Startup-query | Whether the IGMP querier sends IGMP general queries at the startup query interval on startup: · On—The IGMP querier performs the above action. · Off—The IGMP querier does not perform the above action.
Other-querier-present-timer-expiry | Remaining time for the other querier present timer. This field displays Off if the timer is disabled.
Authorization | ‌ Whether the multicast access control feature is enabled: Enabled or Disabled.
Join-by-session | ‌ Whether the per-session multicast forwarding feature is enabled: Enabled or Disabled.
User-VLAN-aggregation | ‌ Whether the multicast packet VLAN tagging feature is enabled: Enabled or Disabled.
IGMP groups reported in total | Total number of multicast groups that the interface has joined dynamically. This field is not displayed if the interface does not join multicast groups.
IGMP proxy is enabled | IGMP proxying is enabled on the interface.
IGMP host is enabled | The IGMP host feature is enabled on the interface.
Version1-querier-present-timer-expiry | Remaining time for the IGMPv1 querier present timer. This field displays Off if the timer is disabled.

IGMP commands -- display igmp proxy group

Use display igmp proxy group to display information about multicast groups maintained by the IGMP proxy.

Syntax

display igmp [ vpn-instance vpn-instance-name ] proxy group [ group-address | interface interface-type interface-number ] [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays information about multicast groups maintained by the IGMP proxy on the public network.

group-address: Specifies a multicast group by its IP address in the range of 224.0.1.0 to 239.255.255.255. If you do not specify a multicast group, this command displays information about all multicast groups maintained by the IGMP proxy.

interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays information about multicast groups maintained by the IGMP proxy for all interfaces.

verbose: Displays detailed information.

Examples

# Display information about multicast groups maintained by the IGMP proxy on the public network. (Applicable to routers.)

<Sysname> display igmp proxy group

IGMP proxy group records in total: 2

GigabitEthernet1/0/1(1.1.1.20):

IGMP proxy group records in total: 2

Group address Member state Expires

225.1.1.1 Delay 00:00:02

225.1.1.2 Idle Off

# Display detailed information about multicast group 225.1.1.1 maintained by the IGMP proxy on the public network. (Applicable to routers.)

<Sysname> display igmp proxy group 225.1.1.1 verbose

GigabitEthernet1/0/1(1.1.1.20):

IGMP proxy group records in total: 2

Group: 225.1.1.1

Group mode: Include

Member state: Delay

Expires: 00:00:02

Source list (sources in total: 1):

1.1.1.1

# Display information about multicast groups maintained by the IGMP proxy on the public network. (Applicable to switches.)

<Sysname> display igmp proxy group

IGMP proxy group records in total: 2

Vlan-interface1(1.1.1.20):

IGMP proxy group records in total: 2

Group address Member state Expires

225.1.1.1 Delay 00:00:02

225.1.1.2 Idle Off

# Display detailed information about multicast group 225.1.1.1 maintained by the IGMP proxy on the public network. (Applicable to switches.)

<Sysname> display igmp proxy group 225.1.1.1 verbose

Vlan-interface1(1.1.1.20):

IGMP proxy group records in total: 2

Group: 225.1.1.1

Group mode: Include

Member state: Delay

Expires: 00:00:02

Source list (sources in total: 1):

1.1.1.1

Table 5 Command output

Field | Description
IGMP groups records in total | Total number of multicast groups maintained by the IGMP proxy.
GigabitEthernet1/0/1(1.1.1.20) | IGMP proxy interface and its IP address. (Applicable to routers.)
Vlan-interface1(1.1.1.20) | IGMP proxy interface and its IP address. (Applicable to switches.)
Pending proxy group | Pending multicast groups maintained by the IGMP proxy.
Group address/Group | Multicast group address.
Member state | Member host states: · Delay—The member host has joined a group and started a delay timer. · Idle—The member host has joined a group, but didn't start a delay timer.
Expires | Remaining delay time for the member host to send a responding report. This field displays Off if the timer is disabled.
Group mode | Multicast source filtering mode: Include or Exclude.
Source list | Multicast source list for the multicast group maintained by the IGMP proxy.
sources in total | Total number of multicast sources.

IGMP commands -- display igmp proxy routing-table

Use display igmp proxy routing-table to display multicast routing entries maintained by the IGMP proxy.

Syntax

display igmp [ vpn-instance vpn-instance-name ] proxy routing-table [ source-address [ mask { mask-length | mask } ] | group-address [ mask { mask-length | mask } ] ] * [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays multicast routing entries maintained by the IGMP proxy on the public network.

source-address: Specifies a multicast source by its IP address. If you do not specify a multicast source, this command displays multicast routing entries for all multicast sources maintained by the IGMP proxy.

group-address: Specifies a multicast group address by its IP address in the range of 224.0.1.0 to 239.255.255.255. If you do not specify a multicast group, this command displays multicast routing entries for all multicast groups maintained by the IGMP proxy.

mask-length: Specifies a mask length of the multicast group address or multicast source address. For a multicast source address, the value range for this argument is 0 to 32. For a multicast group address, the value range for this argument is 4 to 32. The default value is 32 in both cases.

mask: Specifies a mask of the multicast group address or multicast source address. The default value is 255.255.255.255.

verbose: Displays detailed information about multicast routing entries maintained by the IGMP proxy.

Examples

# Display multicast routing entries maintained by the IGMP proxy on the public network. (Applicable to routers.)

<Sysname> display igmp proxy routing-table

Total 1 (*, G) entries, 2 (S, G) entries.

(172.168.0.12, 227.0.0.1)

Upstream interface: GigabitEthernet1/0/1

Downstream interfaces (1 in total):

1: GigabitEthernet1/0/2

Protocol: IGMP

(*, 225.1.1.1)

Upstream interface: GigabitEthernet1/0/1

Downstream interfaces (1 in total):

1: GigabitEthernet1/0/2

Protocol: STATIC

(2.2.2.2, 225.1.1.1)

Upstream interface: GigabitEthernet1/0/1

Downstream interfaces (2 in total):

1: LoopBack1

Protocol: STATIC

2: GigabitEthernet1/0/2

Protocol: PROXY

# Display detailed information about multicast routing entries maintained by the IGMP proxy on the public network. (Applicable to routers.)

<Sysname> display igmp proxy routing-table verbose

Total 1 (*, G) entries, 2 (S, G) entries.

(172.168.0.12, 227.0.0.1)

Upstream interface: GigabitEthernet1/0/1

Downstream interfaces (1 in total):

1: GigabitEthernet1/0/2

Protocol: IGMP

Querier state: Querier

Join/Prune state:Join

Non-downstream interfaces: None

(*, 225.1.1.1)

Upstream interface: GigabitEthernet1/0/1

Downstream interfaces (1 in total):

1: GigabitEthernet1/0/2

Protocol: STATIC

Querier state: Querier

Join/Prune state:Join

Non-downstream interfaces (1 in total):

1: GigabitEthernet1/0/2

Protocol: IGMP

Querier state: Non-querier

Join/Prune state:Join

(2.2.2.2, 225.1.1.1)

Upstream interface: GigabitEthernet1/0/1

Downstream interfaces (2 in total):

1: LoopBack1

Protocol: STATIC

Querier state: Querier

Join/Prune state: Join

2: GigabitEthernet1/0/2

Protocol: PROXY

Querier state: Querier

Join/Prune state: Join

Non-downstream interfaces: None

# Display multicast routing entries maintained by the IGMP proxy on the public network. (Applicable to switches.)

<Sysname> display igmp proxy routing-table

Total 1 (*, G) entries, 2 (S, G) entries.

(172.168.0.12, 227.0.0.1)

Upstream interface: Vlan-interface1

Downstream interfaces (1 in total):

1: Vlan-interface2

Protocol: IGMP

(*, 225.1.1.1)

Upstream interface: Vlan-interface1

Downstream interfaces (1 in total):

1: Vlan-interface2

Protocol: STATIC

(2.2.2.2, 225.1.1.1)

Upstream interface: Vlan-interface1

Downstream interfaces (2 in total):

1: LoopBack1

Protocol: STATIC

2: Vlan-interface2

Protocol: PROXY

# Display detailed information about multicast routing entries maintained by the IGMP proxy on the public network. (Applicable to switches.)

<Sysname> display igmp proxy routing-table verbose

Total 1 (*, G) entries, 2 (S, G) entries.

(172.168.0.12, 227.0.0.1)

Upstream interface: Vlan-interface1

Downstream interfaces (1 in total):

1: Vlan-interface2

Protocol: IGMP

Querier state: Querier

Join/Prune state:Join

Non-downstream interfaces: None

(*, 225.1.1.1)

Upstream interface: Vlan-interface1

Downstream interfaces (1 in total):

1: Vlan-interface2

Protocol: STATIC

Querier state: Querier

Join/Prune state:Join

Non-downstream interfaces (1 in total):

1: Vlan-interface3

Protocol: IGMP

Querier state: Non-querier

Join/Prune state:Join

(2.2.2.2, 225.1.1.1)

Upstream interface: Vlan-interface1

Downstream interfaces (2 in total):

1: LoopBack1

Protocol: STATIC

Querier state: Querier

Join/Prune state: Join

2: Vlan-interface2

Protocol: PROXY

Querier state: Querier

Join/Prune state: Join

Non-downstream interfaces: None

Table 6 Command output

Field | Description
Total 1 (*, G) entries, 2 (S, G) entries | Total number of (*, G) entries, and the total number of (S, G) entries.
(172.168.0.12, 227.0.0.1) | (S, G) entry.
Upstream interface | Incoming interface of the (S, G) entry.
Downstream interfaces (1 in total) | Outgoing interfaces of the (S, G) entry, and the total number of outgoing interfaces.
Non-downstream interfaces (1 in total) | Non-outgoing interfaces of the (S, G) entry, and the total number of non-outgoing interfaces.
1: GigabitEthernet1/0/2 | Index of an interface, and the interface. (Applicable to routers.)
1: Vlan-interface2 | Index of an interface, and the interface. (Applicable to switches.)
Protocol | Protocol type: · IGMP—Dynamic IGMP. · PROXY—IGMP proxy. · STATIC—Static IGMP.
Querier state | Querier state: · Querier. · Non-querier.
Join/Prune state | Joined or pruned state of the interface: · NI—Default state. · Join—Joined state. · Prune—Pruned state.

IGMP commands -- display igmp ssm-mapping

Use display igmp ssm-mapping to display IGMP SSM mappings.

Syntax

display igmp [ vpn-instance vpn-instance-name ] ssm-mapping group-address

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays information about the IGMP SSM mappings on the public network.

group-address: Specifies a multicast group by its IP address in the range of 224.0.1.0 to 239.255.255.255.

Examples

# Display IGMP SSM mappings for multicast group 232.1.1.1 on the public network.

<Sysname> display igmp ssm-mapping 232.1.1.1

Group: 232.1.1.1

Source list:

1.2.3.4

5.5.5.5

10.1.1.1

100.1.1.10

Table 7 Command output

Field | Description
Group | Multicast group address.
Source list | List of multicast source addresses.

IGMP commands -- display igmp user-authorization

Use display igmp user-authorization to display information about authorized IGMP users.

Syntax

display igmp user-authorization [ interface interface-type interface-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

interface-type interface-number: Specifies an interface by its interface type and number. If you do not specify an interface, this command displays information about authorized IGMP users on all interfaces.

Examples

# Display information about all authorized IGMP users.

<Sysname> display igmp user-authorization

Authorized users in total: 3

User name: user1@isp1

Access type: PPP

Interface: Virtual-Access0

Access interface: Virtual-Access0

Maximum programs for order: 4

User profile: profile1

Authorized programs list:

225.0.0.1

User name: user2

Access type: IPoE

Interface: Multicast-UA0

Access interface: GigabitEthernet1/0/1.1

VLAN ID: 100

Second VLAN ID: 10

Maximum programs for order: 4

User profile: profile1

Authorized programs list:

225.0.0.1

225.0.0.2

225.0.0.3

User name: user3

Access type: Portal

Interface: Multicast-UA1

Access interface: GigabitEthernet1/0/2

Maximum programs for order: 4

User profile: profile1

Authorized programs list:

225.0.0.1

225.0.0.2

Table 8 Command output

Field | Description
Authorized users in total | Total number of access users.
Access type | Access type: IPoE, Portal, or PPP.
Interface | User interface.
Access interface | Interface through which the user accesses the BRAS.
VLAN ID | Outer VLAN ID for the user.
Second VLAN ID | Inner VLAN ID for the user.
Maximum programs for order | Maximum number of the multicast groups that the user can join.
User profile | User profile name of the authorized user. The user can join multicast groups permitted by the IGMP user access control policy in the user profile. To configure an IGMP user access control policy, use the igmp access-policy command.
Authorized programs list | List of the multicast groups that the user is authorized to join.

IGMP commands -- igmp

Use igmp to enter IGMP view.

Use undo igmp to delete the configurations in IGMP view.

Syntax

igmp [ vpn-instance vpn-instance-name ]

undo igmp [ vpn-instance vpn-instance-name ]

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command applies to the public network.

Examples

# Enter IGMP view for the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp]

# Enter IGMP view for the VPN instance mvpn.

<Sysname> system-view

[Sysname] igmp vpn-instance mvpn

[Sysname-igmp-mvpn]

IGMP commands -- igmp access-policy

Use igmp access-policy to configure an IGMP user access policy.

Use undo igmp access-policy to delete an IGMP user access policy.

Syntax

igmp access-policy ipv4-acl-number

undo igmp access-policy ipv4-acl-number

Default

No IGMP user access policies exist. IGMP users are not authorized to join any multicast groups.

Views

User profile view

Predefined user roles

network-admin

mdc-admin

Parameters

ipv4-acl-number: Specifies an IPv4 basic or advanced ACL number, in the range of 2000 to 3999. IGMP users can join only multicast groups that the ACL permits. If the ACL does not exist or does not have valid rules, IGMP users cannot join multicast groups.

Usage guidelines

You can configure multiple IGMP user access policies by using this command multiple times. An IGMP report is permitted if it matches one of the access policies.

When you configure a rule in the IPv4 ACL, follow these restrictions and guidelines:

· For the rule to take effect, do not specify the vpn-instance vpn-instance option.

· In a basic ACL, the source source-address source-wildcard option specifies a multicast group address.

· In an advanced ACL, the source source-address source-wildcard option specifies a multicast source address. The destination dest-address dest-wildcard option specifies a multicast group address.

To match the following IGMP reports, set the source source-address source-wildcard option to 0.0.0.0:

?span style='font:7.0pt "Times New Roman"'> IGMPv1 and IGMPv2 reports.

?span style='font:7.0pt "Times New Roman"'> IGMPv3 IS_EX and IGMPv3 TO_EX reports that do not carry multicast source addresses.

· Among the other optional parameters, only the fragment keyword and the time-range time-range-name option take effect.

If you execute this command multiple times, the most recent configuration takes effect.

Examples

# Configure an access policy in user profile abc to authorize IGMP users to join multicast group 225.1.1.2.

<Sysname> system-view

[Sysname] acl basic 2000

[Sysname-acl-ipv4-basic-2000] rule permit source 225.1.1.2 0

[Sysname-acl-ipv4-basic-2000] quit

[Sysname] user-profile abc

[Sysname-user-profile-abc] igmp access-policy 2000

IGMP commands -- igmp authorization-enable

Use igmp authorization-enable to enable the multicast access control feature.

Use undo igmp authorization-enable to disable the multicast access control feature.

Syntax

igmp authorization-enable

undo igmp authorization-enable

Default

The multicast access control feature is disabled.

Views

Layer 3 Ethernet interface/subinterface view

Layer 3 aggregate interface/subinterface view

VT interface view

Predefined user roles

network-admin

mdc-admin

Examples

# Enable the multicast access control feature on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp authorization-enable

IGMP commands -- igmp enable

Use igmp enable to enable IGMP on an interface.

Use undo igmp enable to disable IGMP on an interface.

Syntax

igmp enable

undo igmp enable

Default

IGMP is disabled on an interface.

Views

Interface view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

This command takes effect only when IP multicast routing is enabled on the public network or for the VPN instance to which the interface belongs.

Other IGMP configurations on the interface take effects only when IGMP is enabled on the interface.

Examples

# Enable IP multicast routing on the public network, and enable IGMP on GigabitEthernet 1/0/1. (Applicable to routers.)

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib] quit

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp enable

# Enable IP multicast routing on the public network, and enable IGMP on VLAN-interface 100. (Applicable to switches.)

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib] quit

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp enable

Related commands

multicast routing

IGMP commands -- igmp fast-leave

Use igmp fast-leave to enable fast-leave processing on an interface.

Use undo igmp fast-leave to disable fast-leave processing on an interface.

Syntax

igmp fast-leave [ group-policy ipv4-acl-number ]

undo igmp fast-leave

Default

Fast-leave processing is disabled. The IGMP querier sends IGMP group-specific or group-and-source-specific queries after receiving a leave message.

Views

Interface view

Predefined user roles

network-admin

mdc-admin

Parameters

ipv4-acl-number: Specifies an IPv4 basic ACL by its number in the range of 2000 to 2999. If you specify an ACL, the fast-leave processing feature takes effect only on the multicast groups that the ACL permits. The feature takes effect on all multicast groups when one of the following conditions exists:

· You do not specify an ACL.

· The specified ACL does not exist.

· The specified ACL does not have valid rules.

Usage guidelines

The fast-leave processing feature enables an IGMP querier to suppress IGMP group-specific or group-and-source-specific queries upon receiving IGMP leave messages permitted by the ACL.

When you configure a rule in the IPv4 basic ACL, follow these restrictions and guidelines:

· For the rule to take effect, do not specify the vpn-instance vpn-instance option.

· The source source-address source-wildcard option specifies a multicast group address.

· Among the other optional parameters, only the fragment keyword and the time-range time-range-name option take effect.

Examples

# Enable fast-leave processing on GigabitEthernet 1/0/1. (Applicable to routers.)

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp fast-leave

# Enable fast-leave processing on VLAN-interface 100. (Applicable to switches.)

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp fast-leave

IGMP commands -- igmp group-policy

Use igmp group-policy to configure a multicast group policy on an interface to control the multicast groups that hosts attached to the interface can join.

Use undo igmp group-policy to delete the multicast group policy on an interface.

Syntax

igmp group-policy ipv4-acl-number [ version-number ]

undo igmp group-policy

Default

No multicast group policy exists on an interface. Hosts attached to the interface can join any multicast groups.

Views

Interface view

Predefined user roles

network-admin

mdc-admin

Parameters

ipv4-acl-number: Specifies an IPv4 basic or advanced ACL by its number in the range of 2000 to 3999. Hosts can join only the multicast groups that the ACL permits. If the ACL does not exist or does not have valid rules, hosts cannot join any multicast groups.

version-number: Specifies an IGMP version in the range of 1 to 3. By default, this command takes effect on IGMP reports of all versions.

Usage guidelines

A multicast group policy filters IGMP reports to control the multicast groups that the hosts can join.

This command does not take effect on static member interfaces because static member interfaces do not send IGMP reports.

When you configure a rule in the IPv4 ACL, follow these restrictions and guidelines:

· For the rule to take effect, do not specify the vpn-instance vpn-instance option.

· In a basic ACL, the source source-address source-wildcard option specifies a multicast group address.

· In an advanced ACL, the source source-address source-wildcard option specifies a multicast source address. The destination dest-address dest-wildcard option specifies a multicast group address.

To match the following IGMP reports, set the source source-address source-wildcard option to 0.0.0.0:

?span style='font:7.0pt "Times New Roman"'> IGMPv1 and IGMPv2 reports.

?span style='font:7.0pt "Times New Roman"'> IGMPv3 IS_EX and IGMPv3 TO_EX reports that do not carry multicast source addresses.

· Among the other optional parameters, only the fragment keyword and the time-range time-range-name option take effect.

If you execute this command multiple times, the most recent configuration takes effect.

Examples

# Configure a multicast group policy on GigabitEthernet 1/0/1 so that hosts attached to the interface can join only multicast group 225.1.1.1. (Applicable to routers.)

<Sysname> system-view

[Sysname] acl basic 2005

[Sysname-acl-ipv4-basic-2005] rule permit source 225.1.1.1 0

[Sysname-acl-ipv4-basic-2005] quit

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp group-policy 2005

# Configure a multicast group policy on VLAN-interface 100 so that hosts attached to the interface can join only multicast group 225.1.1.1. (Applicable to switches.)

<Sysname> system-view

[Sysname] acl basic 2005

[Sysname-acl-ipv4-basic-2005] rule permit source 225.1.1.1 0

[Sysname-acl-ipv4-basic-2005] quit

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp group-policy 2005

IGMP commands -- igmp join-by-session

Use igmp join-by-session to enable per-session multicast forwarding.

Use undo igmp join-by-session to restore the default.

Syntax

igmp join-by-session

undo igmp join-by-session

Default

Multicast data is forwarded on a per-interface basis.

Views

Layer 3 Ethernet interface/subinterface view

Layer 3 aggregate interface/subinterface view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

This feature enables an interface to send a separate copy of multicast data to each user attached to the interface.

The igmp join-by-session and igmp user-vlan-aggregation dot1q commands are mutually exclusive. You cannot configure them on the same device.

Examples

# Enable per-session multicast forwarding on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp join-by-session

IGMP commands -- igmp last-member-query-count

Use igmp last-member-query-count to set the IGMP last member query count on an interface.

Use undo igmp last-member-query-count to restore the default.

Syntax

igmp last-member-query-count count

undo igmp last-member-query-count

Default

The IGMP last member query count equals the IGMP querier's robustness variable.

Views

Interface view

Predefined user roles

network-admin

mdc-admin

Parameters

count: Specifies an IGMP last member query count in the range of 1 to 255.

Usage guidelines

You can set the IGMP last member query count for an interface in interface view or globally for all interfaces in IGMP view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

# Set the IGMP last member query count to 6 on GigabitEthernet 1/0/1. (Applicable to routers.)

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp last-member-query-count 6

# Set the IGMP last member query count to 6 on VLAN-interface 100. (Applicable to switches.)

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp last-member-query-count 6

Related commands

last-member-query-count (IGMP view)

IGMP commands -- igmp last-member-query-interval

Use igmp last-member-query-interval to set the IGMP last member query interval on an interface.

Use undo igmp last-member-query-interval to restore the default.

Syntax

igmp last-member-query-interval interval

undo igmp last-member-query-interval

Default

The IGMP last member query interval is 1 second.

Views

Interface view

Predefined user roles

network-admin

mdc-admin

Parameters

interval: Specifies an IGMP last member query interval in the range of 1 to 25 seconds.

Usage guidelines

You can set the IGMP last member query interval for an interface in interface view or globally for all interfaces in IGMP view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

# Set the IGMP last member query interval to 6 seconds on GigabitEthernet 1/0/1. (Applicable to routers.)

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp last-member-query-interval 6

# Set the IGMP last member query interval to 6 seconds on VLAN-interface 100. (Applicable to switches.)

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp last-member-query-interval 6

Related commands

last-member-query-interval (IGMP view)

IGMP commands -- igmp max-response-time

Use igmp max-response-time to set the maximum response time for IGMP general queries on an interface.

Use undo igmp max-response-time to restore the default.

Syntax

igmp max-response-time time

undo igmp max-response-time

Default

The maximum response time for IGMP general queries is 10 seconds.

Views

Interface view

Predefined user roles

network-admin

mdc-admin

Parameters

time: Specifies the maximum response time for IGMP general queries, in the range of 1 to 3174 seconds.

Usage guidelines

You can set the maximum response time for an interface in interface view or globally for all interfaces in IGMP view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

# Set the maximum response time for IGMP general queries to 25 seconds on GigabitEthernet 1/0/1. (Applicable to routers.)

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp max-response-time 25

# Set the maximum response time for IGMP general queries to 25 seconds on VLAN-interface 100. (Applicable to switches.)

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp max-response-time 25

Related commands

max-response-time (IGMP view)

IGMP commands -- igmp non-stop-routing

Use igmp non-stop-routing to enable IGMP NSR.

Use undo igmp non-stop-routing to disable IGMP NSR.

Syntax

igmp non-stop-routing

undo igmp non-stop-routing

Default

IGMP NSR is disabled.

Views

System view

Predefined user roles

network-admin

mdc-admin

Examples

# Enable IGMP NSR.

<Sysname> system-view

[Sysname] igmp non-stop-routing

IGMP commands -- igmp other-querier-present-interval

Use igmp other-querier-present-interval to set the IGMP other querier present timer on an interface.

Use undo igmp other-querier-present-interval to restore the default.

Syntax

igmp other-querier-present-interval interval

undo igmp other-querier-present-interval

Default

The IGMP other querier present timer is calculated by using the following formula:

[ IGMP general query interval ] ?[ IGMP querier's robustness variable ] + [ maximum response time for IGMP general queries ] / 2.

Views

Interface view

Predefined user roles

network-admin

mdc-admin

Parameters

interval: Specifies an IGMP other querier present timer in the range of 1 to 31744 seconds.

Usage guidelines

You can set the IGMP other querier present timer for an interface in interface view or globally for all interfaces in IGMP view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

# Set the IGMP other querier present timer to 125 seconds on GigabitEthernet 1/0/1. (Applicable to routers.)

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp other-querier-present-interval 125

# Set the IGMP other querier present timer to 125 seconds on VLAN-interface 100. (Applicable to switches.)

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp other-querier-present-interval 125

Related commands

other-querier-present-interval (IGMP view)

IGMP commands -- igmp proxy enable

Use igmp proxy enable to enable IGMP proxying on an interface.

Use to undo igmp proxy enable to disable IGMP proxying on an interface.

Syntax

igmp proxy enable

undo igmp proxy enable

Default

IGMP proxying is disabled on an interface.

Views

Interface view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

This command takes effect only when IP multicast routing is enabled on the public network or for the VPN instance to which the interface belongs.

Examples

# Enable IP multicast routing on the public network, and enable IGMP proxying on GigabitEthernet 1/0/1. (Applicable to routers.)

<Sysname> system-view

[Sysname] multicast routing-enable

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp proxy enable

# Enable IP multicast routing on the public network, and enable IGMP proxying on VLAN-interface 100. (Applicable to switches.)

<Sysname> system-view

[Sysname] multicast routing-enable

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp proxy enable

Related commands

multicast routing

IGMP commands -- igmp proxy forwarding

Use igmp proxy forwarding to enable multicast forwarding on a non-querier interface.

Use undo igmp proxy forwarding to disable multicast forwarding on a non-querier interface.

Syntax

igmp proxy forwarding

undo igmp proxy forwarding

Default

Multicast forwarding is disabled for a non-querier interface.

Views

Interface view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

Typically, only IGMP queriers can forward multicast traffic but non-queriers cannot. This mechanism prevents multicast data from being repeatedly forwarded. If a router interface on the IGMP proxy failed the querier election, enable multicast forwarding on the interface to forward multicast data to attached receivers.

Examples

# Enable multicast forwarding on GigabitEthernet 1/0/1. (GigabitEthernet 1/0/1 is a non-querier interface on the IGMP proxy device.) (Applicable to routers.)

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp proxy forwarding

# Enable multicast forwarding on VLAN-interface 100. (VLAN-interface 100 is a non-querier interface on the IGMP proxy device.) (Applicable to switches.)

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp proxy forwarding

IGMP commands -- igmp query-interval

Use igmp query-interval to set the IGMP general query interval on an interface.

Use undo igmp query-interval to restore the default.

Syntax

igmp query-interval interval

undo igmp query-interval

Default

The IGMP general query interval is 125 seconds.

Views

Interface view

Predefined user roles

network-admin

mdc-admin

Parameters

interval: Specifies an IGMP general query interval in the range of 1 to 31744 seconds.

Usage guidelines

You can set the IGMP general query interval for an interface in interface view or globally for all interfaces in IGMP view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

# Set the IGMP general query interval to 60 seconds on GigabitEthernet 1/0/1. (Applicable to routers.)

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp query-interval 60

# Set the IGMP general query interval to 60 seconds on VLAN-interface 100. (Applicable to switches.)

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp query-interval 60

Related commands

query-interval (IGMP view)

IGMP commands -- igmp robust-count

Use igmp robust-count to set the IGMP querier's robustness variable on an interface.

Use undo igmp robust-count to restore the default.

Syntax

igmp robust-count count

undo igmp robust-count

Default

The IGMP querier's robustness variable is 2.

Views

Interface view

Predefined user roles

network-admin

mdc-admin

Parameters

count: Specifies an IGMP querier's robustness variable in the range of 1 to 255.

Usage guidelines

The IGMP querier's robustness variable defines the number of times to retransmit queries if packet loss occurs. A higher robustness variable makes the IGMP querier more robust, but it increases timeout time for multicast groups.

You can set the IGMP querier's robustness variable for an interface in interface view or globally for all interfaces in IGMP view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

# Set the IGMP querier's robustness variable to 5 on GigabitEthernet 1/0/1. (Applicable to routers.)

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp robust-count 5

# Set the IGMP querier's robustness variable to 5 on VLAN-interface 100. (Applicable to switches.)

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp robust-count 5

Related commands

robust-count (IGMP view)

IGMP commands -- igmp startup-query-count

Use igmp startup-query-count to set the IGMP startup query count on an interface.

Use undo igmp startup-query-count to restore the default.

Syntax

igmp startup-query-count count

undo igmp startup-query-count

Default

The IGMP startup query count equals the IGMP querier's robustness variable.

Views

Interface view

Predefined user roles

network-admin

mdc-admin

Parameters

count: Specifies an IGMP startup query count in the range of 1 to 255.

Usage guidelines

You can set the IGMP startup query count for an interface in interface view or globally for all interfaces in IGMP view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

# Set the IGMP startup query count to 5 on GigabitEthernet 1/0/1. (Applicable to routers.)

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp startup-query-count 5

# Set the IGMP startup query count to 5 on VLAN-interface 100. (Applicable to switches.)

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp startup-query-count 5

Related commands

startup-query-count (IGMP view)

IGMP commands -- igmp startup-query-interval

Use igmp startup-query-interval to set the IGMP startup query interval on an interface.

Use undo igmp startup-query-interval to restore the default.

Syntax

igmp startup-query-interval interval

undo igmp startup-query-interval

Default

The IGMP startup query interval equals one quarter of the IGMP general query interval.

Views

Interface view

Predefined user roles

network-admin

mdc-admin

Parameters

interval: Specifies an IGMP startup query interval in the range of 1 to 31744 seconds.

Usage guidelines

You can set the IGMP startup query interval for an interface in interface view or globally for all interfaces in IGMP view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

# Set the IGMP startup query interval to 100 seconds on GigabitEthernet 1/0/1. (Applicable to routers.)

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp startup-query-interval 100

# Set the IGMP startup query interval to 100 seconds on VLAN-interface 100. (Applicable to switches.)

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp startup-query-interval 100

Related commands

startup-query-interval (IGMP view)

IGMP commands -- igmp static-group

Use igmp static-group to configure an interface as a static group member of a multicast group.

Use undo igmp static-group to restore the default.

Syntax

igmp static-group group-address [ source source-address ] [ dot1q vid vlan-list | dot1q vid vlan-id second-dot1q vlan-list ]

undo igmp static-group { all | group-address [ source source-address ] [ dot1q vid vlan-list | dot1q vid vlan-id second-dot1q vlan-list ] }

Default

An interface is not a static group member of multicast groups.

Views

Interface view

Predefined user roles

network-admin

mdc-admin

Parameters

group-address: Specifies a multicast group by its IP address in the range of 224.0.1.0 to 239.255.255.255.

source source-address: Specifies a multicast source by its IP address. If you do not specify a multicast source, this command configures an interface as a static member of the multicast groups with all multicast source addresses.

dot1q vid vlan-list: Specifies a space-separated list of up to 10 outer VLAN ID items. Each item specifies an outer VLAN ID or a range of outer VLAN IDs in the form of start-vlan-id to end-vlan-id. The value range for VLAN IDs is 1 to 4094. If you specify this option, the command configures an interface as a single-VLAN-tagged static member interface for a multicast group. This option is supported in Layer 3 Ethernet subinterface view and Layer 3 aggregate subinterface view.

dot1q vid vlan-id second-dot1q vlan-list: Specifies the outer and inner VLAN IDs. The vlan-id argument specifies the outer VLAN ID in the range of 1 to 4094. The vlan-list argument specifies a space-separated list of up to 10 inner VLAN ID items. Each item specifies an inner VLAN ID or a range of inner VLAN IDs in the form of start-vlan-id to end-vlan-id. The value range for VLAN IDs is 1 to 4094. If you specify this option, the command configures an interface as a double-VLAN-tagged static member interface for a multicast group. This option is supported in Layer 3 Ethernet subinterface view and Layer 3 aggregate subinterface view.

all: Specifies all multicast groups that the interface has statically joined.

Usage guidelines

For multicast routing entries to be created, you must specify a multicast source if the specified multicast group is in the SSM group range.

For the same multicast group, the non-VLAN-based, single-VLAN-based, or double-VLAN-based static member interface configurations are mutually exclusive.

When you configure a subinterface as a non-VLAN-based static member interface, do not configure the igmp join-by-session or igmp user-vlan-aggregation dot1q command on this subinterface. If you configure either of the commands on the subinterface, static multicast forwarding entries cannot be created.

When you configure a subinterface as a VLAN-based static member interface, you must also configure the igmp join-by-session or igmp user-vlan-aggregation dot1q command on this subinterface. A static multicast forwarding entry can be created under either of the following conditions:

· When the igmp join-by-session command is configured, users that belong to the specified VLANs logs in.

· When the user-vlan-aggregation dot1q command is configured, the specified VLAN IDs are the same as or are included in the VLAN IDs specified in the igmp static-group command.

Examples

# Configure GigabitEthernet 1/0/1 as a static group member of multicast group 224.1.1.1. (Applicable to routers.)

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp static-group 224.1.1.1

# Configure GigabitEthernet 1/0/1 as a static group member of multicast source and group (192.168.1.1, 232.1.1.1). (Applicable to routers.)

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp static-group 232.1.1.1 source 192.168.1.1

# Enable per-session multicast forwarding on GigabitEthernet 1/0/1.1. Configure the subinterface as a static group member of multicast group 224.1.1.1 for users with outer VLAN ID 10 and inner VLAN IDs in the range of 10 to 20. (Applicable to routers.)

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1.1

[Sysname-GigabitEthernet1/0/1.1] igmp join-by-session

[Sysname-GigabitEthernet1/0/1.1] igmp static-group 224.1.1.1 dot1q vid 10 second-dot1q 10 to 20

# Configure VLAN-interface 100 as a static group member of multicast group 224.1.1.1. (Applicable to switches.)

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp static-group 224.1.1.1

# Configure VLAN-interface 100 as a static group member of multicast source and group (192.168.1.1, 232.1.1.1). (Applicable to switches.)

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp static-group 232.1.1.1 source 192.168.1.1

IGMP commands -- igmp user-vlan-aggregation dot1q

Use igmp user-vlan-aggregation dot1q to configure VLAN tagging on multicast packets.

Use undo igmp user-vlan-aggregation dot1q to restore the default.

Syntax

igmp user-vlan-aggregation dot1q vid vlan-id [ second-dot1q vlan-id ]

undo igmp user-vlan-aggregation dot1q

Default

The multicast packets are not tagged.

Views

Layer 3 Ethernet subinterface view

Layer 3 aggregate subinterface view

Predefined user roles

network-admin

mdc-admin

Parameters

vid vlan-id: Specifies an outer VLAN ID in the range of 1 to 4094.

second-dot1q vlan-id: Specifies an inner VLAN ID in the range of 1 to 4094.

Usage guidelines

The igmp join-by-session and igmp user-vlan-aggregation dot1q commands are mutually exclusive. You cannot configure them on the same device.

Examples

# Configure the multicast packets to be tagged with outer VLAN ID 10 and inner VLAN ID 20 on GigabitEthernet 1/0/1.1.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1.1

[Sysname-GigabitEthernet1/0/1.1] igmp user-vlan-aggregation dot1q vid 10 second-dot1q 20

IGMP commands -- igmp version

Use igmp version to specify an IGMP version on an interface.

Use undo igmp version to restore the default.

Syntax

igmp version version-number

undo igmp version

Default

The IGMP version on an interface is 2.

Views

Interface view

Predefined user roles

network-admin

mdc-admin

Parameters

version-number: Specifies an IGMP version in the range of 1 to 3.

Examples

# Specify IGMP version 1 on GigabitEthernet 1/0/1. (Applicable to routers.)

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp version 1

# Specify IGMP version 1 on VLAN-interface 100. (Applicable to switches.)

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp version 1

IGMP commands -- last-member-query-count (IGMP view)

Use last-member-query-count to set the IGMP last member query count globally.

Use undo last-member-query-count to restore the default.

Syntax

last-member-query-count count

undo last-member-query-count

Default

The IGMP last member query count equals the IGMP querier's robustness variable.

Views

IGMP view

Predefined user roles

network-admin

mdc-admin

Parameters

count: Specifies an IGMP last member query count in the range of 1 to 255.

Usage guidelines

You can set the IGMP last member query count globally for all interfaces in IGMP view or for an interface in interface view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

# Set the global IGMP last member query count to 6 on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] last-member-query-count 6

Related commands

igmp last-member-query-count

IGMP commands -- last-member-query-interval (IGMP view)

Use last-member-query-interval to set the IGMP last member query interval globally.

Use undo last-member-query-interval to restore the default.

Syntax

last-member-query-interval interval

undo last-member-query-interval

Default

The IGMP last member query interval is 1 second.

Views

IGMP view

Predefined user roles

network-admin

mdc-admin

Parameters

interval: Specifies an IGMP last member query interval in the range of 1 to 25 seconds.

Usage guidelines

You can set the IGMP last member query interval globally for all interfaces in IGMP view or for an interface in interface view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

# Set the global IGMP last member query interval to 6 seconds on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] last-member-query-interval 6

Related commands

igmp last-member-query-interval

IGMP commands -- max-response-time (IGMP view)

Use max-response-time to set the maximum response time for IGMP general queries globally.

Use undo max-response-time to restore the default.

Syntax

max-response-time time

undo max-response-time

Default

The maximum response time for IGMP general queries is 10 seconds.

Views

IGMP view

Predefined user roles

network-admin

mdc-admin

Parameters

time: Specifies the maximum response time for IGMP general queries in the range of 1 to 3174 seconds.

Usage guidelines

You can set the maximum response time globally for all interfaces in IGMP view or for an interface in interface view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

#Set the global maximum response time for IGMP general queries to 25 seconds on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] max-response-time 25

Related commands

igmp max-response-time

IGMP commands -- other-querier-present-interval (IGMP view)

Use other-querier-present-interval to set the IGMP other querier present timer globally.

Use undo other-querier-present-interval to restore the default.

Syntax

other-querier-present-interval interval

undo other-querier-present-interval

Default

The IGMP other querier present timer is calculated by using the following formula:

[ IGMP general query interval ] ?[ IGMP querier's robustness variable ] + [ maximum response time for IGMP general queries ] / 2.

Views

IGMP view

Predefined user roles

network-admin

mdc-admin

Parameters

interval: Specifies an IGMP other querier present timer in the range of 1 to 31744 seconds.

Usage guidelines

You can set the IGMP other querier present timer globally for all interfaces in IGMP view or for an interface in interface view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

# Set the global IGMP other querier present timer to 125 seconds on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] other-querier-present-interval 125

Related commands

igmp other-querier-present-interval

IGMP commands -- proxy multipath (IGMP view)

Use proxy multipath to enable load splitting on an IGMP proxy device.

Use undo proxy multipath to disable load splitting on an IGMP proxy device.

Syntax

proxy multipath

undo proxy multipath

Default

The load splitting feature is disabled on the IGMP proxy device.

Views

IGMP view

Predefined user roles

network-admin

mdc-admin

Usage guidelines

Use this feature when the IGMP proxy device has multiple proxy interfaces. All proxy interfaces on the IGMP proxy device share multicast traffic on a per-group basis. If you do not enable this feature, only the proxy interface with the highest IP address forwards multicast data.

Examples

# Enable load splitting on the IGMP proxy device on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] proxy multipath

IGMP commands -- query-interval (IGMP view)

Use query-interval to set the IGMP general query interval globally.

Use undo query-interval to restore the default.

Syntax

query-interval interval

undo query-interval

Default

The IGMP general query interval is 125 seconds.

Views

IGMP view

Predefined user roles

network-admin

mdc-admin

Parameters

interval: Specifies an IGMP general query interval in the range of 1 to 31744 seconds.

Usage guidelines

You can set the IGMP general query interval globally for all interfaces in IGMP view or for an interface in interface view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

# Set the global IGMP general query interval to 60 seconds on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] query-interval 60

Related commands

igmp query-interval

IGMP commands -- reset igmp group

Use reset igmp group to clear dynamic IGMP multicast group entries.

Syntax

reset igmp [ vpn-instance vpn-instance-name ] group { all | interface interface-type interface-number { all | group-address [ mask { mask | mask-length } ] [ source-address [ mask { mask | mask-length } ] ] } }

Views

User view

Predefined user roles

network-admin

mdc-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command clears dynamic IGMP multicast group entries on the public network.

all: Specifies all interfaces (the first all), or all IGMP multicast groups (the second all).

interface-type interface-number: Specifies an interface by its type and number.

group-address: Specifies a multicast group by its IP address in the range of 224.0.0.0 to 239.255.255.255.

source-address: Specifies a multicast source address. If you do not specify a multicast source, this command clears dynamic IGMP multicast group entries for all multicast source addresses.

mask: Specifies an address mask. The default is 255.255.255.255.

mask-length: Specifies an address mask length. The default is 32. For a multicast group address, the value range for this argument is 4 to 32. For a multicast source address, the value range for this argument is 0 to 32.

Usage guidelines

This command might interrupt the multicast information transmission.

Examples

# Clear dynamic IGMP multicast group entries for all interfaces on the public network. (Applicable to routers.)

<Sysname> reset igmp group all

# Clear all dynamic IGMP multicast group entries for GigabitEthernet 1/0/1 on the public network. (Applicable to routers.)

<Sysname> reset igmp group interface gigabitethernet 1/0/1 all

# Clear the dynamic IGMP multicast group entry of group 225.0.0.1 for GigabitEthernet 1/0/1 on the public network. (Applicable to routers.)

<Sysname> reset igmp group interface gigabitethernet 1/0/1 225.0.0.1

# Clear dynamic IGMP multicast group entries for all interfaces on the public network. (Applicable to switches.)

<Sysname> reset igmp group all

# Clear all dynamic IGMP multicast group entries for VLAN-interface 100 on the public network. (Applicable to switches.)

<Sysname> reset igmp group interface vlan-interface 100 all

# Clear the dynamic IGMP multicast group entry of group 225.0.0.1 for VLAN-interface 100 on the public network. (Applicable to switches.)

<Sysname> reset igmp group interface vlan-interface 100 225.0.0.1

Related commands

display igmp group

IGMP commands -- robust-count (IGMP view)

Use robust-count to set the IGMP querier's robustness variable globally.

Use undo robust-count to restore the default.

Syntax

robust-count count

undo robust-count

Default

The IGMP querier's robustness variable is 2.

Views

IGMP view

Predefined user roles

network-admin

mdc-admin

Parameters

count: Specifies an IGMP querier's robustness variable in the range of 1 to 255.

Usage guidelines

The IGMP querier's robustness variable defines the number of times to retransmit queries if packet loss occurs. A higher robustness variable makes the IGMP querier more robust, but it increases the timeout time for multicast groups.

You can set the IGMP querier's robustness variable globally for all interfaces in IGMP view or for an interface in interface view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

# Set the global IGMP querier's robustness variable to 5 on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] robust-count 5

Related commands

igmp robust-count

IGMP commands -- ssm-mapping (IGMP view)

Use ssm-mapping to configure an IGMP SSM mapping.

Use undo ssm-mapping to delete IGMP SSM mappings.

Syntax

ssm-mapping source-address ipv4-acl-number

undo ssm-mapping { source-address | all }

Default

No IGMP SSM mappings exist.

Views

IGMP view

Predefined user roles

network-admin

mdc-admin

Parameters

source-address: Specifies a multicast source by its IP address.

ipv4-acl-number: Specifies a basic ACL number in the range of 2000 to 2999. Multicast groups in IGMP reports permitted by the ACL are associated with the IPv6 multicast source. If the ACL does not exist or does not have valid rules, no multicast groups are associated with the IPv6 multicast source.

all: Specifies all IGMP SSM mappings.

Usage guidelines

When you configure a rule in the IPv4 basic ACL, follow these restrictions and guidelines:

· For the rule to take effect, do not specify the vpn-instance vpn-instance option.

· The source source-address source-wildcard option specifies a multicast group address.

· Among the other optional parameters, only the fragment keyword and the time-range time-range-name option take effect.

Examples

# Configure an IGMP SSM mapping with multicast source 125.1.1.1 and multicast group range 232.1.1.0/24 on the public network.

<Sysname> system-view

[Sysname] acl basic 2001

[Sysname-acl-ipv4-basic-2001] rule permit source 232.1.1.1 0.0.0.255

[Sysname-acl-ipv4-basic-2001] quit

[Sysname] igmp

[Sysname-igmp] ssm-mapping 125.1.1.1 2001

Related commands

display igmp ssm-mapping

IGMP commands -- startup-query-count (IGMP view)

Use startup-query-count to set the IGMP startup query count globally.

Use undo startup-query-count to restore the default.

Syntax

startup-query-count count

undo startup-query-count

Default

The IGMP startup query count equals the IGMP querier's robustness variable.

Views

IGMP view

Predefined user roles

network-admin

mdc-admin

Parameters

count: Specifies an IGMP startup query count in the range of 1 to 255.

Usage guidelines

You can set the IGMP startup query count globally for all interfaces in IGMP view or for an interface in interface view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

# Set the global IGMP startup query count to 5 on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] startup-query-count 5

Related commands

igmp startup-query-count

IGMP commands -- startup-query-interval (IGMP view)

Use startup-query-interval to set the IGMP startup query interval globally.

Use undo startup-query-interval to restore the default.

Syntax

startup-query-interval interval

undo startup-query-interval

Default

The IGMP startup query interval equals one quarter of the IGMP general query interval.

Views

IGMP view

Predefined user roles

network-admin

mdc-admin

Parameters

interval: Specifies an IGMP startup query interval in the range of 1 to 31744 seconds.

Usage guidelines

You can set the IGMP startup query interval globally for all interfaces in IGMP view or for an interface in interface view. For an interface, the interface-specific configuration takes priority over the global configuration.

Examples

# Set the global IGMP startup query interval to 100 seconds on the public network.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] startup-query-interval 100

Related commands

igmp startup-query-interval