Login
- Table of Contents
-
- 07-IP Multicast Command Reference
- 00-Preface
- 01-IGMP snooping commands
- 02-PIM snooping commands
- 03-Multicast VLAN commands
- 04-Multicast routing and forwarding commands
- 05-IGMP commands
- 06-PIM commands
- 07-MSDP commands
- 08-Multicast VPN commands
- 09-MLD snooping commands
- 10-IPv6 PIM snooping commands
- 11-IPv6 multicast VLAN commands
- 12-IPv6 multicast routing and forwarding commands
- 13-MLD commands
- 14-IPv6 PIM commands
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 05-IGMP commands | 135.52 KB |
igmp last-member-query-interval
igmp other-querier-present-interval
last-member-query-count (IGMP view)
last-member-query-interval (IGMP view)
other-querier-present-interval (IGMP view)
startup-query-count (IGMP view)
startup-query-interval (IGMP view)
IGMP commands
display igmp group
Use display igmp group to display information about IGMP multicast groups (the multicast groups that receiver hosts have dynamically 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 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: Displays information about the multicast groups that interfaces have joined statically. If you do not specify this keyword, this command displays information about IGMP multicast groups.
verbose: Displays detailed information.
Examples
# Display information about IGMP multicast groups that hosts have dynamically joined on the public network.
<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
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 the interface joins dynamically. |
|
Group address |
Multicast group address. |
|
Last reporter |
Address of the last receiver 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 225.1.1.1 that hosts have dynamically joined on the public network.
<Sysname> display igmp group 225.1.1.1 verbose
Vlan-interface100(100.1.1.1):
IGMP groups reported in total: 1
Group: 225.1.1.1
Uptime: 00:00:14
Expires: Off
Last reporter: 0.0.0.0
Last-member-query-counter: 0
Last-member-query-timer-expiry: Off
Group mode: Include
Version1-host-present-timer-expiry: Off
Version2-host-present-timer-expiry: Off
Source list (sources in total: 1):
Source: 1.1.1.1
Uptime: 00:00:14
Expires: 00:04:05
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 the interface joins dynamically. |
|
Group |
Multicast group address. |
|
Uptime |
Length of time since the multicast group was reported. |
|
Expires |
Remaining time for the multicast group. This field displays Off if the timer is disabled. |
|
Last reporter |
Address of the last receiver 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. |
|
Group mode |
Multicast source filtering mode: · Include—Include mode. · Exclude—Exclude mode. |
|
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 switch 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 switch runs IGMPv3. |
|
Source list (sources in total) |
List of multicast sources and total number of multicast sources. This field is displayed only when the switch runs IGMPv3. |
|
Source |
Multicast source address. This field is displayed only when the switch runs IGMPv3. |
|
Uptime |
Length of time since the multicast source was reported. This field is displayed only when the switch runs IGMPv3. |
|
Remaining time for the multicast source when the switch runs IGMPv3. This field displays Off if the timer is disabled. This field is displayed only when the switch runs IGMPv3. |
|
|
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 switch runs IGMPv3. |
|
|
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 switch runs IGMPv3. |
# Display information about IGMP multicast groups that hosts have statically joined on the public network.
<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
Table 3 Command output
|
Field |
Description |
|
Total number of the multicast groups that interfaces have joined statically. |
|
|
Multicast group address. |
|
|
Multicast source address. |
|
|
Interface name. |
|
|
Remaining time for the multicast group. This field always displays Never because the multicast group never expires. |
reset igmp group
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 ] [ 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 interfaces.
host: Displays information about interfaces enabled with the IGMP host feature. If you do not specify this keyword, this 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.
verbose: Displays detailed IGMP information for interfaces.
Examples
# Display detailed IGMP information for VLAN-interface 100 on the public network.
<Sysname> display igmp interface vlan-interface 100 verbose
Vlan-interface100(100.1.1.1):
IGMP is enabled.
IGMP version: 3
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:31
Querier for IGMP: 100.1.1.1 (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
IGMP groups reported in total: 1
<Sysname> display igmp interface host verbose
Vlan-interface100(100.1.1.1):
IGMP host is enabled.
IGMP version: 3
Multicast routing on this interface: Enabled
Require-router-alert: Disabled
Version1-querier-present-timer-expiry (hh:mm:ss): Off
Version2-querier-present-timer-expiry (hh:mm:ss): Off
Table 4 Command output
|
Field |
Description |
|
Interface and its IP address. |
|
|
Query interval for IGMP |
IGMP general query interval, in seconds. |
|
Other querier present time for 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. |
|
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 IGMP querier is elected. This field is 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. |
|
|
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. |
|
Robustness |
Robustness variable of the IGMP querier. |
|
Require-router-alert |
Whether the feature of dropping IGMP messages without Router-Alert is enabled. |
|
Fast-leave |
Whether the fast-leave processing feature is enabled. |
|
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 lifetime for the other querier present timer. This field displays Off if the timer is disabled. |
|
IGMP groups reported in total |
Total number of multicast groups that the interface joined dynamically. This field is not displayed if the interface does not join multicast groups. |
|
IGMP host is enabled |
The IGMP host feature is enabled. |
|
Remaining lifetime for the IGMPv1 querier present timer. This field displays Off if the timer is disabled. |
|
|
Remaining lifetime for the IGMPv2 querier present timer. This field displays Off if the timer is disabled. |
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
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 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 5 Command output
|
Field |
Description |
|
Group |
Multicast group address. |
|
Source list |
List of multicast source addresses. |
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
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] igmp
[Sysname-igmp]
# Enter IGMP view for VPN instance mvpn.
[Sysname] igmp vpn-instance mvpn
[Sysname-igmp-mvpn]
igmp enable
Use igmp enable to enable IGMP on an interface.
Use undo igmp enable to disable IGMP on an interface.
Syntax
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 for the public network or the VPN instance to which the interface belongs.
Other IGMP configurations on the interface take effect only when IGMP is enabled on the interface.
Examples
# Enable IP multicast routing, and enable IGMP on VLAN-interface 100 on the public network.
<Sysname> system-view
[Sysname] multicast routing
[Sysname-mrib] quit
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] igmp enable
multicast routing
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 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 IGMP leave messages.
Views
Interface view
Predefined user roles
network-admin
mdc-admin
Parameters
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 send leave notifications to the upstream routers without sending group-specific or group-and-source-specific queries after receiving leave messages.
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 VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] igmp fast-leave
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 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
acl-number: Specifies an IPv4 basic or advanced ACL by its number in the range of 2000 to 3999. Receiver hosts can join only the multicast groups that the ACL permits. If the ACL does not exist or the ACL does not contain valid rules, receiver hosts cannot join 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 messages to control the multicast groups that the hosts can join.
This command does not take effect on a static member interface, because the static member interface does not send IGMP messages.
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:
¡ IGMPv1 and IGMPv2 reports.
¡ 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 VLAN-interface 100 so that hosts attached to the interface can join only multicast group 225.1.1.1.
<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 100
[Sysname-Vlan-interface100] igmp group-policy 2005
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 VLAN-interface 100.
<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 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 VLAN-interface 100.
<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 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
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 VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] igmp max-response-time 25
Related 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 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 VLAN-interface 100.
<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 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
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 VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] igmp query-interval 60
Related 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
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 VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] igmp robust-count 5
Related 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
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 VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] igmp startup-query-count 5
Related commands
startup-query-count (IGMP view)
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 VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] igmp startup-query-interval 100
Related commands
startup-query-interval (IGMP view)
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 ]
undo igmp static-group { all | group-address [ source source-address ] }
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 address in the range of 224.0.1.0 to 239.255.255.255.
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.
all: Specifies all multicast groups that the interface has statically joined.
Usage guidelines
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 entries cannot be established.
Examples
# Configure VLAN-interface 100 as a static group member of multicast group 224.1.1.1.
<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 the multicast source and group (192.168.1.1, 232.1.1.1).
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] igmp static-group 232.1.1.1 source 192.168.1.1
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 VLAN-interface 100.
<Sysname> system-view
[Sysname] interface vlan-interface 100
[Sysname-Vlan-interface100] igmp version 1
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
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
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
igmp last-member-query-interval
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
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
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
query-interval (IGMP view)
Use query-interval to set the IGMP general query interval globally.
Use undo query-interval to restore the default.
Syntax
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
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 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 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.
<Sysname> reset igmp group all
# Clear all dynamic IGMP multicast group entries for VLAN-interface 100 on the public network.
<Sysname> reset igmp group interface vlan-interface 100 all
# Clear the dynamic IGMP group entry of the group 225.0.0.1 for VLAN-interface 100 on the public network.
<Sysname> reset igmp group interface vlan-interface 100 225.0.0.1
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
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
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 acl-number
undo ssm-mapping { source-address | all }
Default
IGMP SSM mappings are not configured.
Views
IGMP view
Predefined user roles
network-admin
mdc-admin
Parameters
source-address: Specifies a multicast source by its IP address.
acl-number: Specifies a basic ACL number in the range of 2000 to 2999. In IGMP SSM mappings, the specified multicast source is associated with multicast groups that the ACL permits. The multicast source is not associated with any multicast groups if the ACL does not exist or does not have valid rules.
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.
[Sysname] acl basic 2001
[Sysname-acl-basic-2001] rule permit source 232.1.1.1 0.0.0.255
[Sysname-acl-basic-2001] quit
[Sysname] igmp
[Sysname-igmp] ssm-mapping 125.1.1.1 2001
Related 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
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
startup-query-interval (IGMP view)
Use startup-query-interval to set the global IGMP startup query interval globally.
Use undo startup-query-interval to restore the default.
Syntax
startup-query-interval 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
