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

View

Any view

Default Level

1: Monitor level

Parameters

all-instance: Specifies all nstances.

vpn-instance vpn-instance-name: Specifies a VPN instance. A VPN instance name is a case sensitive string of up to 31 characters and must not contain any space.

group-address: Multicast group address, in the range of 224.0.1.0 to 239.255.255.255.

interface interface-type interface-number: Displays the IGMP multicast group information about a particular interface.

static: Displays the information of statically joined IGMP multicast groups.

verbose: Displays the detailed information of IGMP multicast groups.

Description

Use the display igmp group command to view IGMP multicast group information.

Note that:

l If neither all-instance nor vpn-instance is specified, this command will display the information on the public instance.

l If you do not specify group-address, this command will display the IGMP information of all the multicast groups.

l If you do not specify interface-type interface-number, this command will display the IGMP multicast group information on all the interfaces.

l If you do not specify the static keyword, this command will display the detailed information about the dynamically joined IGMP multicast groups.

Examples

# Display the information about dynamically joined IGMP multicast groups on all interfaces in the public instance.

<Sysname> display igmp group

Total 3 IGMP Group(s).

Interface group report information of VPN-Instance: public net

Vlan-interface1(20.20.20.20):

Total 3 IGMP Groups reported

Group Address Last Reporter Uptime Expires

225.1.1.1 20.20.20.20 00:02:04 00:01:15

225.1.1.3 20.20.20.20 00:02:04 00:01:15

225.1.1.2 20.20.20.20 00:02:04 00:01:17

# Display the detailed information of multicast group 225.1.1.1 in the public instance.

<Sysname> display igmp group 225.1.1.1 verbose

Interface group report information of VPN-Instance: public net

Vlan-interface1(10.10.1.20):

Total 1 IGMP Groups reported

Group: 225.1.1.1

Uptime: 00:00:34

Expires: 00:00:40

Last reporter: 10.10.1.10

Last-member-query-counter: 0

Last-member-query-timer-expiry: off

Version1-host-present-timer-expiry: off

Table 1-1 display igmp group command output description

Field	Description
Interface group report information of VPN-Instance: public net	IGMP multicast group information on a public network interface
Total 1 IGMP Groups reported	One IGMP multicast group was reported.
Group	Multicast group address
Uptime	Length of time since the multicast group was reported
Expires	Remaining time of the multicast group, where “off” means that the multicast group never times out
Last reporter	Address of the last host that reported its membership for this multicast group
Last-member-query-counter	Number of group-specific queries sent
Last-member-query-timer-expiry	Remaining time of the last member query timer, where “off” means that the timer never expires
Version1-host-present-timer-expiry	Remaining time of the IGMPv1 host present timer, where “off” means that the timer never expires

display igmp group port-info

Syntax

display igmp group port-info [ vlan vlan-id ] [ slot slot-number ] [ verbose ]

View

Any view

Default Level

1: Monitor level

Parameters

vlan-id: VLAN ID, in the range of 1 to 4094. If you do not specify a VLAN, this command will display the Layer 2 port information of IGMP multicast groups in all VLANs.

slot slot-number: Displays the Layer 2 port information about IGMP multicast groups on the specified card. If you do not specify a slot number, this command will display the Layer 2 port information about IGMP multicast groups on the SRPU.

verbose: Displays the detailed information about Layer 2 ports of IGMP multicast groups.

Description

Use the display igmp group port-info command to view Layer 2 port information of IGMP multicast groups.

Examples

# View detailed Layer 2 ports information of IGMP multicast groups.

<Sysname> display igmp group port-info verbose

Total 1 IP Group(s).

Total 1 IP Source(s).

Total 1 MAC Group(s).

Port flags: D-Dynamic port, S-Static port, C-Copy port

Subvlan flags: R-Real VLAN, C-Copy VLAN

Vlan(id):2.

Total 1 IP Group(s).

Total 1 IP Source(s).

Total 1 MAC Group(s).

Router port unit board: Mask(0x8 3)

Router port(s):total 1 port.

GE2/0/1 (D)

IP group(s):the following ip group(s) match to one mac group.

IP group address:224.1.1.1

(1.1.1.1, 224.1.1.1):

Attribute: Host Port

Host port unit board: Mask(0x8 3)

Host port(s):total 1 port.

GE2/0/2 (D)

MAC group(s):

MAC group address:0100-5e01-0101

Host port unit board: Mask(0x8 3)

Host port(s):total 1 port.

GE2/0/2

Table 1-2 display igmp group port-info command output description

Field	Description
Total 1 IP Group(s).	Total number of IP multicast groups
Total 1 IP Source(s).	Total number of IP multicast sources
Total 1 MAC Group(s).	Total number of MAC multicast groups
Port flags: D-Dynamic port, S-Static port, C-Copy port	Port flags: D for a dynamic port, S for a static port, and C for a port copied from a (*, G) entry to an (S, G) entry
Subvlan flags: R-Real VLAN, C-Copy VLAN	Sub-VLAN flags: R for a real egress sub-VLAN under the current entry, and C for a sub-VLAN copied from a (*, G) entry to an (S, G) entry
Router port(s)	Number of router ports
( 00:01:30 )	Remaining time of dynamic member port or router port aging timer. To get this time value of a non-aggregation port on a board other than the SRPU, you must specify the number of the slot where the corresponding board resides by using slot slot-number. This is not required for an aggregation port.
IP group address	Address of the IP multicast group
MAC group address	Address of the MAC multicast group
Attribute	Attribute of the IP multicast group
Host port(s)	Number of member ports

display igmp interface

Syntax

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

View

Any view

Default Level

1: Monitor level

Parameters

all-instance: Specifies all instances.

vpn-instance vpn-instance-name: Specifies a VPN instance. A VPN instance name is a case sensitive string of up to 31 characters and must not contain any space.

interface-type interface-number: Specifies an interface to display the IGMP configuration and operation information about. If no interface is specified, this command will display the related information of all IGMP-enabled interfaces.

verbose: Displays the detailed IGMP configuration and operation information.

Description

Use the display igmp interface command to view IGMP configuration and operation information of the specified interface or all IGMP-enabled interfaces.

Note that if neither all-instance nor vpn-instance is specified, this command will display the information on the public instance.

Examples

# View the IGMP configuration and operation information on VLAN-interface 1 in the public instance.

<Sysname> display igmp interface Vlan-interface 1 verbose

Vlan-interface1(10.10.1.20):

IGMP is enabled

Current IGMP version is 2

Value of query interval for IGMP(in seconds): 60

Value of other querier present interval for IGMP(in seconds): 125

Value of maximum query response time for IGMP(in seconds): 10

Value of last member query interval(in seconds): 1

Value of startup query interval(in seconds): 15

Value of startup query count: 2

General query timer expiry (hours:minutes:seconds): 00:00:54

Querier for IGMP: 10.10.1.20 (this router)

IGMP activity: 1 joins, 0 leaves

Multicast routing on this interface: enabled

Robustness: 2

Require-router-alert: disabled

Fast-leave: disabled

Ssm-mapping: disabled

Startup-query-timer-expiry: off

Other-querier-present-timer-expiry: off

Total 1 IGMP Group reported

Table 1-3 display igmp interface command output description

Field	Description
Vlan-interface1(10.10.1.20)	Interface name (IP address)
Current IGMP version	Version of IGMP currently running on the interface
Value of query interval for IGMP(in seconds)	IGMP query interval, in seconds
Value of other querier present interval for IGMP(in seconds)	Other querier present interval, in seconds
Value of maximum query response time for IGMP(in seconds)	Maximum response time for IGMP general queries, in seconds
Value of last member query interval(in seconds)	IGMP last member query interval, in seconds
Value of startup query interval(in seconds)	IGMP startup query interval, in seconds
Value of startup query count	Number of IGMP general queries the device sends on startup
General query timer expiry	Remaining time of the IGMP general query timer, where “off” means that the timer never expires
Querier for IGMP	IP address of the IGMP querier
IGMP activity	Statistics of IGMP activities (joins and leaves)
Robustness	Robustness variable of the IGMP querier
Require-router-alert	Dropping IGMP messages without Router-Alert (enabled/disabled)
Fast-leave	Fast leave processing status (enabled/disabled)
Ssm-mapping	IGMP SSM mapping status (enabled/disabled)
Startup-query-timer-expiry	Remaining time of the startup query timer, where “off” means that the timer never expires
Other-querier-present-timer-expiry	Remaining time of the other querier present timer, where “off” means that the timer never expires
Total 1 IGMP Group reported	Total number of reported groups on the interface

display igmp routing-table

Syntax

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

View

Any view

Default Level

1: Monitor level

Parameters

all-instance: Specifies all instances.

vpn-instance vpn-instance-name: Specifies a VPN instance. A VPN instance name is a case sensitive string of up to 31 characters and must not contain any space.

source-address: Multicast source address.

group-address: Multicast group address, in the range of 224.0.1.0 to 239.255.255.255.

mask: Subnet mask of the multicast group/source address, 255.255.255.255 by default.

mask-length: Subnet mask length of the multicast group/source address. For a multicast source address, this argument has an effective value range of 0 to 32; for a multicast group address, this argument has an effective value range of 4 to 32. The system default is 32 in both cases.

Description

Use the display igmp routing-table command to view the IGMP routing table information.

Note that if neither all-instance nor vpn-instance is specified, this command will display the information on the public instance.

Examples

# View IGMP routing table information in the public instance.

<Sysname> display igmp routing-table

Routing table of VPN-Instance: public net

Total 2 entries

00001. (*, 225.1.1.1)

List of 1 downstream interface

Vlan-interface1 (20.1.1.1),

Protocol: STATIC

00002. (*, 239.255.255.250)

List of 1 downstream interface

Vlan-interface2 (40.20.20.20),

Protocol: IGMP

Table 1-4 display igmp routing-table command output description

Field	Description
Routing table of VPN-Instance: public net	Public network IGMP routing table
00001	Sequence number of this (*, G) entry
(*, 225.1.1.1)	A (*, G) entry of the IGMP routing table
List of 1 downstream interface	Downstream interface list, namely the interfaces to which multicast data for this group will be forwarded
Protocol	Protocol type

display igmp ssm-mapping

Syntax

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

View

Any view

Default Level

1: Monitor level

Parameters

all-instance: Specifies all instances.

vpn-instance vpn-instance-name: Specifies a VPN instance. A VPN instance name is a case sensitive string of up to 31 characters and must not contain any space.

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

Description

Use the display igmp ssm-mapping command to view the configured IGMP SSM mappings for the specified multicast group.

Note that if neither all-instance nor vpn-instance is specified, this command will display the information on the public instance.

Related commands: ssm-mapping.

Examples

# View the IGMP SSM mappings for multicast group 232.1.1.1 in the public instance.

<Sysname> display igmp ssm-mapping 232.1.1.1

VPN-Instance: public net

Group: 232.1.1.1

Source list:

1.2.3.4

5.5.5.5

10.1.1.1

100.1.1.10

Table 1-5 display igmp ssm-mapping command output description

Field	Description
VPN-Instance: public net	Public instance
Group	Multicast group address
Source list	List of multicast source addresses

display igmp ssm-mapping group

Syntax

display igmp [ all-instance | vpn-instance vpn-instance-name ] ssm-mapping group [ group-address | interface interface-type interface-number ] [ verbose ]

View

Any view

Default Level

1: Monitor level

Parameters

all-instance: Specifies all instances.

vpn-instance vpn-instance-name: Specifies a VPN instance. A VPN instance name is a case sensitive string of up to 31 characters and must not contain any space.

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

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

verbose: Displays the detailed multicast group information created based on the configured IGMP SSM mappings.

Description

Use the display igmp ssm-mapping group command to view the multicast group information created based on the configured IGMP SSM mappings.

Note that:

l If neither all-instance nor vpn-instance is specified, this command will display the information on the public instance.

l If you do not specify a multicast group, this command will display the information of all multicast groups created based on the configured IGMP SSM mappings.

l If you do not specify an interface, this command will display the multicast group information created based on the configured IGMP SSM mappings on all the interfaces.

Examples

# View the detailed information of multicast group 232.1.1.1 created based on the configured IGMP SSM mappings in the public instance.

<Sysname> display igmp ssm-mapping group 232.1.1.1 verbose

Interface group report information of VPN-Instance: public net

Vlan-interface1 (10.10.10.10):

Total 1 IGMP SSM-mapping Group reported

Group: 232.1.1.1

Uptime: 00:00:31

Expires: off

Last reporter: 1.1.1.1

Version1-host-present-timer-expiry: off

Source list(Total 1 source):

Source: 1.1.1.1

Uptime: 00:00:31

Expires: 00:01:39

Last-member-query-counter: 0

Last-member-query-timer-expiry: off

Table 1-6 display igmp ssm-mapping group command output description

Field	Description
Interface group report information of VPN-Instance: public net	Multicast group information created based on IGMP SSM mappings on a public network interface
Total 1 IGMP SSM-mapping Group reported	One IGMP SSM mapping multicast group was reported.
Group	Multicast group address
Uptime	Length of time since the multicast group was reported
Expires	Remaining time of the multicast group, where “off” means that the multicast group never times out
Last reporter	Address of the last host that reported its membership for this multicast group
Version1-host-present-timer-expiry	Remaining time of the IGMPv1 host present timer, where “off” means that the timer never expires
Source list(Total 1 source)	Multicast source list (one multicast source)
Source	Multicast source address
Last-member-query-counter	Number of group-specific queries sent
Last-member-query-timer-expiry	Remaining time of the last member query timer, where “off” means that the timer never expires

igmp

Syntax

igmp [ vpn-instance vpn-instance-name ]

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

View

System view

Default Level

2: System level

Parameters

vpn-instance vpn-instance-name: Specifies a VPN instance. A VPN instance name is a case sensitive string of up to 31 characters and must not contain any space.

Description

Use the igmp command to enter public instance IGMP view or VPN instance IGMP view .

Use the undo igmp command to remove configurations performed in public instance IGMP view or VPN instance IGMP view.

Note that:

l If you do not specify vpn-instance, this configuration will take effect only on the public instance.

l IP multicast must be enabled in the corresponding instance before this command can take effect

Related commands: igmp enable; multicast routing-enable in Multicast Routing and Forwarding Commands in the IP Multicast Volume.

Examples

# Enable IP multicast routing in the public instance and enter public instance IGMP view.

<Sysname> system-view

[Sysname] multicast routing-enable

[Sysname] igmp

[Sysname-igmp]

# Enable IP multicast routing in VPN instance mvpn and enter IGMP view for VPN instance mvpn.

<Sysname> system-view

[Sysname] ip vpn-instance mvpn

[Sysname-vpn-instance-mvpn] route-distinguisher 100:1

[Sysname-vpn-instance-mvpn] multicast routing-enable

[Sysname-vpn-instance-mvpn] quit

[Sysname] igmp vpn-instance mvpn

[Sysname-igmp-mvpn]

igmp enable

Syntax

igmp enable

undo igmp enable

View

Interface view

Default Level

2: System level

Parameters

None

Description

Use the igmp enable command to enable IGMP on the current interface.

Use the undo igmp enable command to disable IGMP on the current interface.

By default, IGMP is disabled on all interfaces.

Note that:

l IP multicast must be enabled in the corresponding instance before this command can take effect.

l IGMP must be enabled on an interface before any other IGMP feature configured on the interface can take effect.

Related commands: igmp; multicast routing-table in Multicast Routing and Forwarding Commands in the IP Multicast Volume.

Examples

# Enable IP multicast routing, and then enable IGMP on VLAN-interface 100.

<Sysname> system-view

[Sysname] multicast routing-enable

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp enable

igmp group-policy

Syntax

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

undo igmp group-policy

View

Interface view

Default Level

2: System level

Parameters

acl-number: Basic or advanced ACL number, in the range of 2000 to 3999. The source address or address range specified in the advanced ACL rule is used to match the multicast source address(es) specified in IGMPv3 reports, rather than the source address in the IP packets. The system assumes that an IGMPv1 or IGMPv2 report or an IGMPv3 IS_EX and TO_EX report that does not carry a multicast source address carries a multicast source address of 0.0.0.0..

version-number: IGMP version, in the range of 1 to 3. If you do not specify an IGMP version, the configured group filter will apply to IGMP reports of all versions.

Description

Use the igmp group-policy command to configure a multicast group filter on the current interface to control joins to specific multicast groups.

Use the undo igmp group-policy command to remove the configured multicast group filter.

By default, no multicast group filter is configured, namely a host can join any valid multicast group.

Examples

# Configure an ACL rule so that hosts on the subnet attached to VLAN-interface 1 can join multicast group 225.1.1.1 only.

<Sysname> system-view

[Sysname] acl number 2005

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

[Sysname-acl-basic-2005] quit

[Sysname] interface Vlan-interface 1

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

igmp last-member-query-interval

Syntax

igmp last-member-query-interval interval

undo igmp last-member-query-interval

View

Interface view

Default Level

2: System level

Parameters

interval: IGMP last member query interval in seconds, with an effective range of 1 to 5.

Description

Use the igmp last-member-query-interval command to configure the last member query interval, namely the length of time the device waits between sending IGMP group-specific queries, on the current interface.

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

By default, the IGMP last member query interval is 1 second.

Related commands: last-member-query-interval, igmp robust-count, display igmp interface.

Examples

# Set the IGMP last member query interval to 3 seconds on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

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

igmp max-response-time

Syntax

igmp max-response-time interval

undo igmp max-response-time

View

Interface view

Default Level

2: System level

Parameters

interval: Maximum response time in seconds for IGMP general queries, with an effective range of 1 to 25.

Description

Use the igmp max-response-time command to configure the maximum response time for IGMP general queries on the current interface.

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

By default, the maximum response time for IGMP general queries is 10 seconds.

Related commands: max-response-time, igmp timer other-querier-present, display igmp interface.

Examples

# Set the maximum response time for IGMP general queries to 8 seconds on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

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

igmp require-router-alert

Syntax

igmp require-router-alert

undo igmp require-router-alert

View

Interface view

Default Level

2: System level

Parameters

None

Description

Use the igmp require-router-alert command to configure the interface to discard IGMP messages that do not carry the Router-Alert option.

Use the undo igmp require-router-alert command to restore the default configuration.

By default, the device does not check the Router-Alert option, namely it passes all the IGMP messages it receives to the upper layer protocol for processing.

Related commands: require-router-alert, igmp send-router-alert.

Examples

# Configure VLAN-interface 100 to discard IGMP messages that do not carry the Router-Alert option.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp require-router-alert

igmp robust-count

Syntax

igmp robust-count robust-value

undo igmp robust-count

View

Interface view

Default Level

2: System level

Parameters

robust-value: IGMP querier robustness variable, with an effective range of 2 to 5. The IGMP robustness variable determines the default number of general queries the IGMP querier sends on startup and the number of IGMP group-specific queries the IGMP querier sends upon receiving an IGMP leave message.

Description

Use the igmp robust-count command to configure the IGMP querier robustness variable on the current interface.

Use the undo igmp robust-count command to restore the system default.

By default, the IGMP querier robustness variable is 2.

Related commands: robust-count, igmp timer query, igmp last-member-query-interval, igmp timer other-querier-present, display igmp interface.

Examples

# Set the IGMP querier robustness variable to 3 on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

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

igmp send-router-alert

Syntax

igmp send-router-alert

undo igmp send-router-alert

View

Interface view

Default Level

2: System level

Parameters

None

Description

Use the igmp send-router-alert command on the current interface to enable insertion of the Router-Alert option in IGMP messages to be sent.

Use the undo igmp send-router-alert command on the current interface to disable insertion of the Router-Alert option in IGMP messages to be sent.

By default, IGMP messages are sent with the Router-Alert option.

Related commands: send-router-alert, igmp require-router-alert.

Examples

# Disable insertion of the Router-Alert option into IGMP messages that leave VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] undo igmp send-router-alert

igmp ssm-mapping enable

Syntax

igmp ssm-mapping enable

undo igmp ssm-mapping enable

View

Interface view

Default Level

2: System level

Parameters

None

Description

Use the igmp ssm-mapping enable command to enable the IGMP SSM mapping feature on the current interface.

Use the undo igmp ssm-mapping enable command to disable the IGMP SSM mapping feature on the current interface.

By default, the IGMP SSM mapping feature is disabled on all interfaces.

Examples

# Enable the IGMP SSM mapping feature on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp ssm-mapping enable

igmp startup-query-count

Syntax

igmp startup-query-count value

undo igmp startup-query-count

View

Interface view

Default Level

2: System level

Parameters

value: Startup query count, namely, the number of queries the IGMP querier sends on startup, with an effective range of 2 to 5.

Description

Use the igmp startup-query-count command to configure the startup query count on the current interface.

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

By default, the startup query count is set to the IGMP querier robustness variable.

By default, the IGMP querier robustness variable is 2, so the startup query count is also 2.

Related commands: startup-query-count, igmp robust-count.

Examples

# Set the startup query count to 3 on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

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

igmp startup-query-interval

Syntax

igmp startup-query-interval interval

undo igmp startup-query-interval

View

Interface view

Default Level

2: System level

Parameters

interval: Startup query interval in seconds, namely, the interval between general queries the IGMP querier sends on startup, with an effective range of 1 to 18000.

Description

Use the igmp startup-query-interval command to configure the startup query interval on the current interface.

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

By default, the startup query interval is 1/4 of the IGMP query interval.

By default, the IGMP query interval is 60 seconds, so the startup query interval = 60 / 4 = 15 (seconds).

Related commands: startup-query-interval, igmp timer query.

Examples

# Set the startup query interval to 5 seconds on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

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

igmp static-group

Syntax

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

undo igmp static-group { all | group-address [ source source-address ] }

View

Interface view

Default Level

2: System level

Parameters

all: Specifies to remove all static multicast groups that the current interface has joined.

group-address: Multicast group address, in the range of 224.0.1.0 to 239.255.255.255.

source-address: Multicast source address.

Description

Use the igmp static-group command to configure the current interface to be a statically connected member of the specified multicast group or multicast source and group.

Use the undo igmp static-group command to restore the system default.

By default, an interface is not a static member of any multicast group or multicast source and group.

If the specified multicast address is in the SSM multicast address range, you must specify a multicast source address at the same time; otherwise IGMP routing table entries cannot be established. There is no such a restriction if the specified multicast group address is not in the SSM multicast address range.

Examples

# Configure VLAN-interface 1 to be a statically connected member of multicast group 224.1.1.1.

<Sysname> system-view

[Sysname] interface Vlan-interface1

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

# Configure VLAN-interface 1 to be a statically connected member of multicast source and group (192.168.1.1, 232.1.1.1).

<Sysname> system-view

[Sysname] interface Vlan-interface1

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

igmp timer other-querier-present

Syntax

igmp timer other-querier-present interval

undo igmp timer other-querier-present

View

Interface view

Default Level

2: System level

Parameters

interval: IGMP other querier present interval in seconds, in the range of 60 to 300.

Description

Use the igmp timer other-querier-present command to configure the IGMP other querier present interval on the current interface.

Use the undo igmp timer other-querier-present command to restore the system default.

By default, the IGMP other querier present interval is [ IGMP query interval ] times [ IGMP querier robustness variable ] plus [ maximum response time for IGMP general queries ] divided by two.

By default, the three parameters in the above-mentioned formula are 60 (seconds), 2 and 10 (seconds) respectively, so the IGMP other querier present interval = 60 × 2 + 10 / 2 = 125 (seconds).

Related commands: timer other-querier-present, igmp timer query, igmp robust-count, igmp max-response-time, display igmp interface.

Examples

# Set the IGMP other querier present interval to 200 seconds on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp timer other-querier-present 200

igmp timer query

Syntax

igmp timer query interval

undo igmp timer query

View

Interface view

Default Level

2: System level

Parameters

interval: IGMP query interval in seconds, namely the interval between IGMP general queries, with an effective range of 1 to 18,000.

Description

Use the igmp timer query command to configure the IGMP query interval on the current interface.

Use the undo igmp timer query command to restore the system default.

By default, the IGMP query interval is 60 seconds.

Related commands: timer query, igmp timer other-querier-present, display igmp interface.

Examples

# Set the IGMP query interval to 125 seconds on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp timer query 125

igmp version

Syntax

igmp version version-number

undo igmp version

View

Interface view

Default Level

2: System level

Parameters

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

Description

Use the igmp version command to configure the IGMP version on the current interface.

Use the undo igmp version command to restore the default IGMP version.

The default IGMP version is version 2.

Related commands: version.

Examples

# Set the IGMP version to IGMPv1 on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp version 1

last-member-query-interval (IGMP view)

Syntax

last-member-query-interval interval

undo last-member-query-interval

View

Public instance IGMP view, VPN instance IGMP view

Default Level

2: System level

Parameters

interval: Last-member query interval in seconds, with an effective range of 1 to 5.

Description

Use the last-member-query-interval command to configure the global IGMP last-member query interval.

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

By default, the IGMP last-member query interval is 1 second.

Related commands: igmp last-member-query-interval, robust-count, display igmp interface.

Examples

# Set the global IGMP last-member interval to 3 seconds in the public instance.

<Sysname> system-view

[Sysname] igmp

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

max-response-time (IGMP view)

Syntax

max-response-time interval

undo max-response-time

View

Public instance IGMP view, VPN instance IGMP view

Default Level

2: System level

Parameters

interval: Maximum response time for IGMP general queries in seconds, with an effective range of 1 to 25.

Description

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

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

By default, the maximum response time for IGMP general queries is 10 seconds.

Related commands: igmp max-response-time, timer other-querier-present, display igmp interface.

Examples

# Set the maximum response time for IGMP general queries to 8 seconds globally in the public instance.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] max-response-time 8

require-router-alert (IGMP view)

Syntax

require-router-alert

undo require-router-alert

View

Public instance IGMP view, VPN instance IGMP view

Default Level

2: System level

Parameters

None

Description

Use the require-router-alert command to configure globally the router to discard IGMP messages that do not carry the Router-Alert option.

Use the undo require-router-alert command to restore the system default.

By default, the device does not check the Router-Alert option, namely it handles all the IGMP messages it received to the upper layer protocol for processing.

Related commands: igmp require-router-alert, send-router-alert.

Examples

# Globally configure the router to discard IGMP messages that do not carry the Router-Alert option in the public instance.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] require-router-alert

reset igmp group

Syntax

reset igmp [ all-instance | 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 } ] ] } }

View

User view

Default Level

2: System level

Parameters

all-instance: Specifies all instances.

vpn-instance vpn-instance-name: Specifies a VPN instance. A VPN instance name is a case sensitive string of up to 31 characters and must not contain any space

all: The first all specifies to clear IGMP multicast group information on all interfaces, while the second all specifies to clear the information of all IGMP multicast groups.

interface interface-type interface-number: Clears IGMP multicast information on the specified interface.

group-address: Multicast group address, in the range of 224.0.0.0 to 239.255.255.255.

source-address: Multicast source address.

mask: Subnet mask of the multicast group/source address, 255.255.255.255 by default.

mask-length: Subnet mask length of the multicast group/source address. For a multicast group address, this argument has an effective value range of 4 to 32; for a multicast source address, this argument has an effective value range of 0 to 32. The system default is 32 in both cases.

Description

Use the reset igmp group command to clear IGMP multicast group information.

Note that:

l If neither all-instance nor vpn-instance is specified, this command will display the information on the public instance

l This command cannot clear IGMP multicast group information of static joins.

Related commands: display igmp group.

Examples

# Clear all IGMP multicast group information on all interfaces.

<Sysname> reset igmp group all

# Clear all IGMP multicast group information on VLAN-interface 100.

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

# Clear IGMP multicast group information about multicast group 225.0.0.1 on VLAN-interface 100.

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

reset igmp group port-info

Syntax

reset igmp group port-info { all | group-address } [ vlan vlan-id ]

View

User view

Default Level

2: System level

Parameters

all: Clears Layer 2 port information of all the IGMP multicast groups.

group-address: Clears Layer 2 port information of the specified IGMP multicast group. The effective range of group-address is 224.0.1.0 to 239.255.255.255.

vlan-id: Clears Layer 2 port information of IGMP multicast groups in the specified VLAN. The effective range of vlan-id is 1 to 4094.

Description

Use the reset igmp group port-info command to clear Layer 2 port information of IGMP multicast groups.

Note that:

l Layer 2 ports for IGMP multicast groups include member ports and router ports.

l This command cannot clear Layer 2 port information about IGMP multicast groups of static joins.

Related commands: display igmp group port-info.

Examples

# Clear Layer 2 port information of all IGMP multicast groups in all VLANs.

<Sysname> reset igmp group port-info all

# Clear Layer 2 port information of all IGMP multicast groups in VLAN 100.

<Sysname> reset igmp group port-info all vlan 100

# Clear Layer 2 port information about multicast group 225.0.0.1 in VLAN 100.

<Sysname> reset igmp group port-info 225.0.0.1 vlan 100

reset igmp ssm-mapping group

Syntax

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

View

User view

Default Level

2: System level

Parameters

all-instance: Specifies all instances.

vpn-instance vpn-instance-name: Specifies a VPN instance. A VPN instance name is a case sensitive string of up to 31 characters and must not contain any space.

all: The first all specifies to clear multicast group information created based on the configured IGMP SSM mappings on all interfaces, while the second all specifies to clear all multicast group information created based on the configured IGMP SSM mappings.

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 by its IP address.

mask: Subnet mask of the multicast group/source address, 255.255.255.255 by default.

Description

Use the reset igmp ssm-mapping group command to clear multicast group information created based on the configured IGMP SSM mappings.

Note that if neither all-instance nor vpn-instance is specified, this command will clear the information on the public instance.

Related commands: display igmp ssm-mapping group.

Examples

# Clear all multicast group information created based on the configured IGMP SSM mappings on all interfaces in the public instance.

<Sysname> reset igmp ssm-mapping group all

robust-count (IGMP view)

Syntax

robust-count robust-value

undo robust-count

View

Public instance IGMP view, VPN instance IGMP view

Default Level

2: System level

Parameters

Description

Use the robust-count command to configure the IGMP querier robustness variable globally.

Use the undo robust-count command to restore the system default.

By default, the IGMP querier robustness variable is 2.

Related commands: igmp robust-count, timer query, last-member-query-interval, timer other-querier-present, display igmp interface.

Examples

# Set the IGMP querier robustness variable to 3 globally in the public instance.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] robust-count 3

send-router-alert (IGMP view)

Syntax

send-router-alert

undo send-router-alert

View

Public instance IGMP view, VPN instance IGMP view

Default Level

2: System level

Parameters

None

Description

Use the send-router-alert command to globally enable insertion of the Router-Alert option into IGMP messages to be sent.

Use the undo send-router-alert command to globally disable insertion of the Router-Alert option into IGMP messages to be sent.

By default, an IGMP message carries the Router-Alert option.

Related commands: igmp send-router-alert, require-router-alert.

Examples

# Globally disable the insertion of the Router-Alert option in IGMP messages to be sent in the public instance.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] undo send-router-alert

ssm-mapping (IGMP view)

Syntax

ssm-mapping group-address { mask | mask-length } source-address

undo ssm-mapping { group-address { mask | mask-length } source-address | all }

View

Public instance IGMP view, VPN instance IGMP view

Default Level

2: System level

Parameters

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

mask: Subnet mask of the multicast group address.

mask-length: Subnet mask length of the multicast group address, in the range of 4 to 32.

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

all: Removes all IGMP SSM mappings.

Description

Use the ssm-mapping command to configure an IGMP SSM mapping.

Use the undo ssm-mapping command to remove one or all IGMP SSM mappings.

By default, no IGMP SSM mappings are configured.

Related commands: igmp ssm-mapping enable, display igmp ssm-mapping.

Examples

# Configure an IGMP SSM mapping in the public instance for multicast groups in the range of 225.1.1.0/24 and multicast source 125.1.1.1.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] ssm-mapping 225.1.1.0 24 125.1.1.1

startup-query-count (IGMP view)

Syntax

startup-query-count value

undo startup-query-count

View

Public instance IGMP view, VPN instance IGMP view

Default Level

2: System level

Parameters

value: Startup query count, namely, the number of queries the IGMP querier sends on startup, with an effective range of 2 to 5.

Description

Use the startup-query-count command to configure the startup query count globally.

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

By default, the startup query count is set to the IGMP querier robustness variable.

By default, the IGMP querier robustness variable is 2, so the startup query count is also 2.

Related commands: igmp startup-query-count, robust-count.

Examples

# Set the startup query count to 3 globally in the public instance.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] startup-query-count 3

startup-query-interval (IGMP view)

Syntax

startup-query-interval interval

undo startup-query-interval

View

Public instance IGMP view, VPN instance IGMP view

Default Level

2: System level

Parameters

interval: Startup query interval in seconds, namely, the interval between general queries the IGMP querier sends on startup, with an effective range of 1 to 18000.

Description

Use the startup-query-interval command to configure the startup query interval globally.

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

By default, the startup query interval is 1/4 of the “IGMP query interval”.

By default, the IGMP query interval is 60 seconds, so the startup query interval = 60 / 4 = 15 (seconds).

Related commands: igmp-startup-query-interval, timer query.

Examples

# Set the startup query interval to 5 seconds globally in the public instance.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] startup-query-interval 5

timer other-querier-present (IGMP view)

Syntax

timer other-querier-present interval

undo timer other-querier-present

View

Public instance IGMP view, VPN instance IGMP view

Default Level

2: System level

Parameters

interval: IGMP other querier present interval, in the range of 60 to 300.

Description

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

Use the undo timer other-querier-present command to restore the system default.

By default, the IGMP other querier present interval is [ IGMP query interval ] times [ IGMP querier robustness variable ] plus [ maximum response time for IGMP general queries ] divided by two.

By default, the three parameters in the above-mentioned formula are 60 (seconds), 2 (times) and 10 (seconds) respectively, so the IGMP other querier present interval = 60 × 2 + 10 / 2 = 125 (seconds).

Related commands: igmp timer other-querier-present, timer query, robust-count, max-response-time, display igmp interface.

Examples

# Set the IGMP other querier present interval to 200 seconds globally in the public instance.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] timer other-querier-present 200

timer query (IGMP view)

Syntax

timer query interval

undo timer query

View

Public instance IGMP view, VPN instance IGMP view

Default Level

2: System level

Parameters

interval: IGMP query interval in seconds, namely interval between IGMP general queries, with an effective range of 1 to 18,000.

Description

Use the timer query command to configure the IGMP query interval globally.

Use the undo timer query command to restore the default setting.

By default, IGMP query interval is 60 seconds.

Related commands: igmp timer query, timer other-querier-present, display igmp interface.

Examples

# Set the IGMP query interval to 125 seconds globally in the public instance.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] timer query 125

version (IGMP view)

Syntax

version version-number

undo version

View

Public instance IGMP view, VPN instance IGMP view

Default Level

2: System level

Parameters

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

Description

Use the version command to configure the IGMP version globally.

Use the undo version command to restore the system default.

The default IGMP version is version 2.

Related commands: igmp version.

Examples

# Set the global IGMP version to IGMPv1 in the public instance.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] version 1

04-IP Multicast Volume

display igmp interface

display igmp ssm-mapping

igmp

igmp group-policy

igmp last-member-query-interval

igmp max-response-time

igmp require-router-alert

igmp robust-count

igmp ssm-mapping enable

igmp timer other-querier-present

igmp timer query

igmp version

last-member-query-interval (IGMP view)

max-response-time (IGMP view)

require-router-alert (IGMP view)

reset igmp ssm-mapping group

send-router-alert (IGMP view)

ssm-mapping (IGMP view)

timer query (IGMP view)

version (IGMP view)

Cloud & AI

InterConnect

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Resources

Partner Business Management

Company Information

News & Events

Contact Us