No relevant resource is found in the selected language.

This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. Read our privacy policy>Search

Reminder

To have a better experience, please upgrade your IE browser.

upgrade

Command Reference

CloudEngine 8800, 7800, 6800, and 5800 V200R002C50

This document describes all the configuration commands of the device, including the command function, syntax, parameters, views, default level, usage guidelines, examples, and related commands.
Rate and give feedback :
Huawei uses machine translation combined with human proofreading to translate this document to different languages in order to help you better understand the content of this document. Note: Even the most advanced machine translation cannot match the quality of professional translators. Huawei shall not bear any responsibility for translation accuracy and it is recommended that you refer to the English document (a link for which has been provided).
IGMP Configuration Commands

IGMP Configuration Commands

NOTE:

The CE6810LI does not support this feature.

display igmp control-message counters

Function

The display igmp control-message counters command displays statistics about IGMP control messages.

Format

display igmp [ vpn-instance vpn-instance-name | all-instance ] control-message counters [ interface interface-type interface-number ] [ message-type { query | report } ]

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Displays IGMP message statistics in a specified VPN instance.

The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.

all-instance Displays IGMP message statistics in all instances. -
interface interface-type interface-number Displays IGMP message statistics on a specified interface. If this parameter is not specified, the command displays IGMP message statistics on all interfaces. -
message-type Indicates the IGMP message type. If this parameter is not specified, the command displays statistics about all types of IGMP messages. -
query Displays statistics about Query messages received by the interface. Query messages are sent from a querier. -
report Displays statistics about Report messages received by the interface. Report messages are sent by hosts to join a multicast group. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can use this command to check the number of IGMP control messages sent and received on the device.

Example

# Display statistics about the IGMP messages sent and received by VLANIF100.

<HUAWEI> display igmp control-message counters interface vlanif 100
Interface control-message counters information of VPN instance: public net
 Vlanif100(192.168.2.1):
 Message Type                Sent        Valid       Invalid     Ignore
 ---------------------------------------------------------------------
 General Query                  2            0             0          0
 Group Query                    0            0             0          0
 Source Group Query             0            0             0          0
 --------------------------------------------------------------------- 
 IGMPV1V2 
 Report ASM                     0            0             0          0
 Report SSM                     0            0             0          0
 --------------------------------------------------------------------- 
 LEAVE ASM                      0            0             0          0
 LEAVE SSM                      0            0             0          0
 --------------------------------------------------------------------- 
 IGMPV3   
 ISIN Report                    0            0             0          0
 ISEX Report                    0            0             0          0
 TOIN Report                    0            0             0          0
 TOEX Report                    0            0             0          0
 ALLOW Report                   0            0             0          0
 BLOCK Report                   0            0             0          0
 Source Records Total           0            0             0          0
 --------------------------------------------------------------------- 
 Others                         -            -             0          0
 ---------------------------------------------------------------------  
Table 10-1  Description of the display igmp control-message counters interface vlanif 100 command output

Item

Description

Interface control-message counters information of VPN instance: public net

VPN instance to which the interface belongs.

Vlanif100(192.168.2.1)

Type, number, and IP address of the interface.

Message Type

Type of IGMP messages.

Sent

Number of IGMP messages sent from the interface.

Valid

Number of valid IGMP messages received by the interface.

Invalid

Number of wrong IGMP messages received by the interface.

Ignore

Number of received IGMP messages ignored by the interface.

General Query

Number of IGMP General Query messages.

Group Query

Number of IGMP Group-Specific Query messages.

Source Group Query

Number of IGMP Group-and-Source-Specific Query messages.

Report ASM

Number of IGMPv1 and IGMPv2 Report messages with multicast group addresses in the ASM group address range.

Report SSM

Number of IGMPv1 and IGMPv2 Report messages with multicast group addresses in the SSM group address range.

LEAVE ASM

Number of IGMP Leave messages with multicast group addresses in the ASM group address range.

LEAVE SSM

Number of IGMP Leave messages with multicast group addresses in the SSM group address range.

ISIN Report

Number of IGMPv3 IS_IN Report messages.

ISEX Report

Number of IGMPv3 IS_EX Report messages.

TOIN Report

Number of IGMPv3 TO_IN Report messages.

TOEX Report

Number of IGMPv3 TO_EX Report messages.

ALLOW Report

Number of IGMPv3 ALLOW Report messages.

BLOCK Report

Number of IGMPv3 BLOCK Report messages.

Source Records Total

Number of multicast sources carried in IGMPv3 messages.

Others

Number of invalid and ignored IGMP messages of unknown types.

display igmp group

Function

The display igmp group command displays information about IGMP groups that hosts have dynamically joined by sending IGMP Report messages.

Format

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

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Displays information about IGMP groups in a VPN instance.

The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.

all-instance Displays information about IGMP groups in all instances. -
group-address Displays information about the IGMP group with a specified group address. The value ranges from 224.0.1.0 to 239.255.255.255, in dotted decimal notation.
interface interface-type interface-number Displays information about the IGMP group on the specified interface. -
verbose Displays detailed information about IGMP groups. If the parameter is not specified, the command displays only the summary of IGMP groups. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can use this command to check information about multicast groups that have established memberships.

Example

# Display information about dynamic IGMP groups.

<HUAWEI> display igmp group
Interface group report information of VPN instance: public net
 Vlanif100(10.1.6.2):
  Total 1 IGMP Group reported
   Group Address   Last Reporter   Uptime      Expires
   225.1.1.2       10.1.6.10       00:02:04    00:01:17

# Display detailed information about IGMP groups.

<HUAWEI> display igmp group verbose
Interface group report information of VPN instance: public net
 Limited entry of this VPN instance: -
 Vlanif100(10.1.6.2):
  Total entry on this interface: 1
  Limited entry on this interface: -
  Total IGMP Group reported:  1
   Group: 225.1.1.2
     Uptime: 00:03:59
     Expires: off
     Last reporter: 10.1.6.10
     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:
       Source: 192.168.232.1
          Uptime: 00:51:07
          Expires: 00:02:05
          Last-member-query-counter: 0
          Last-member-query-timer-expiry: off
Table 10-2  Description of the display igmp group verbose command output

Item

Description

Interface group report information of VPN instance

VPN instance to which IGMP groups on an interface belong.

Limited entry of this VPN instance

Maximum number of IGMP entries that can be created for this instance.

Vlanif100(10.1.6.2)

Interface type and interface number (IP address).

Total entry on this interface

Total number of IGMP entries on the current interface.

Limited entry on this interface

Maximum number of IGMP entries that the current interface can create.

Total IGMP Group reported: 1

Number of IGMP groups that the current interface has dynamically joined.

Group

Address of a multicast group.

Uptime

Amount of time since a multicast group is created. The time format is as follows:
  • If the time is shorter than or equal to 24 hours, the format is hours:minutes:seconds.

  • If the time is longer than 24 hours but shorter than or equal to one week, the format is days:hours.

  • If the time is longer than one week, the format is weeks:days.

Expires

Time left before a group will be deleted from the IGMP group table. The time format is as follows:
  • If the time is shorter than or equal to 24 hours, the format is hours:minutes:seconds.

  • If the time is longer than 24 hours but shorter than or equal to one week, the format is days:hours.

  • If the time is longer than one week, the format is weeks:days.

"off" indicates that the group will never be aged out.

Last reporter

Last host that sends a Report message.

Last Member Query Counter

Number of times the querier will send Group-Specific Query messages after receiving a Leave message. The counter value decreases by 1 every time the querier sends a Group-Specific Query message. This parameter is configured using the igmp robust-count command.

The value 0 indicates that the querier does not send Group-Specific Query messages after receiving a Leave message.

Last Member Query Timer Expiry

Length of the last member query timer. The timer starts only when a Leave message is received from a group member. The timer value is configured using the igmp lastmember-queryinterval command.

The value off indicates that the last member query timer has not started.

Group mode

Multicast group record type. It is displayed only when the interface is running IGMPv3.

Version1 Host Present Timer Expiry

Timeout interval of IGMPv1 hosts. IGMPv1 does not define the Leave message; therefore, memberships of IGMPv1 hosts are aged using a timer. The device starts the timer when receiving a Report message from an IGMPv1 host. The timer value is calculated using the following formula:

IGMPv1 timeout interval = General group query interval x Robustness variable + Maximum response time for Query messages

The general group query interval is configured using the igmp timer query command. The robustness variable is configured using the igmp robust-count command. The maximum response time for Query messages is configured using the igmp max-response-time command.

The value off indicates that the device has not received any Report messages from IGMPv1 hosts.

Version2 Host Present Timer Expiry

Timeout interval of IGMPv2 hosts. It is displayed only when the interface is running IGMPv3.

The value off indicates that the device has not received any Report messages from IGMPv2 hosts.

Source list

List of multicast sources. It is displayed only when the interface is running IGMPv3 and has IGMPv3 receiver hosts attached.

Source

IP address of a multicast source.

Last-member-query-counter

Number of times the querier will send Group-and-Source-Specific Query message after receiving a Leave message.

The value 0 indicates that the querier does not send Group-and-Source-Specific Query message after receiving a Leave message.

Last-member-query-timer-expiry

Length of the last member query timer.

The value off indicates that the last member query timer has not started.

display igmp group ssm-mapping

Function

The display igmp group ssm-mapping command displays information about multicast group entries established with SSM mapping.

Format

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

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Displays group entries established with SSM mapping in a specified VPN instance.

The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.

all-instance Displays group entries established with SSM mapping in all instances. -
group-address Displays information about the specified multicast group entries established with SSM mapping. If this parameter is not specified, the command displays information about all multicast group entries established with SSM mapping. The value ranges from 224.0.1.0 to 239.255.255.255, in dotted decimal notation.
interface interface-type interface-number Displays information about multicast group entries established with SSM mapping on the specified interface. If this parameter is not specified, the command displays information about multicast group entries established with SSM mapping on all interfaces. -
verbose Displays detailed information about group membership established with SSM mapping. If the parameter is not specified, the command displays only the summary of group membership established with SSM mapping. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can use the display igmp group ssm-mapping command to view information about multicast group entries that are established with SSM mapping. SSM mapping entries are configured using the ssm-mapping command.

Example

# Display summary of all multicast group entries established with SSM mapping.

<HUAWEI> display igmp group ssm-mapping
IGMP SSM mapping interface group report information of VPN instance: public net
 Limited entry of this VPN instance: -
 Vlanif100(192.168.101.1):
  Total 1 IGMP SSM-Mapping Group reported
   Group Address   Last Reporter   Uptime      Expires
   232.0.0.1       192.168.101.2   00:00:02    00:02:08 

# Display detailed information about all multicast group entries established with SSM mapping.

<HUAWEI> display igmp group ssm-mapping verbose
Interface group report information of VPN instance: public net
 Limited entry of this VPN instance: -
 Vlanif100(192.168.101.1):
  Total entry on this interface: 1
  Limited entries on this interface: -
  Total 1 IGMP SSM-Mapping Group reported
   Group: 232.0.0.1
   Uptime: 00:00:15
   Expires: 00:01:55
     Last reporter: 192.168.101.2
     Last Member Query Counter: 0
     Last Member Query Timer Expiry: off
     Group mode: exclude
     Version1 Host Present Timer Expiry: off
     Version2 Host Present Timer Expiry: 00:01:55
     Source list:
       Source Address      Uptime
       10.1.1.1            00:00:37 
Table 10-3  Description of the display igmp group ssm-mapping verbose command output

Item

Description

Interface group report information of VPN instance

VPN instance to which IGMP SSM mapping information belongs.

Limited entry of this VPN instance

Maximum number of entries that can be generated in the VPN instance.

Vlanif100(192.168.101.1)

Interface type and interface number (IP address).

Total entry on this interface

Total number of entries generated on the interface.

Limited entries on this interface

Maximum number of entries that can be generated on the interface.

Total 1 IGMP SSM-Mapping Group reported

Number of IGMP Report messages with SSM group addresses received on the interface.

Group

Group address.

Uptime

Amount of time since the last Report message is received.

Expires

Timeout period of a group. The time format is as follows:
  • If the time is shorter than or equal to 24 hours, the format is hours:minutes:seconds.

  • If the time is longer than 24 hours but shorter than or equal to one week, the format is days:hours.

  • If the time is longer than one week, the format is weeks:days.

Last reporter

Last host that sends a Report message.

Last Member Query Counter

Number of times Group-Specific Query messages are sent.

Last Member Query Timer Expiry

Length of the last member query timer.

Group mode

Filter mode of a group, which can be include or exclude.

Version1 Host Present Timer Expiry

Timeout period of IGMPv1 hosts.

The value off indicates that the device has not received any Report messages from IGMPv1 hosts.

Version2 Host Present Timer Expiry

Timeout period of IGMPv2 hosts.

The value off indicates that the device has not received any Report messages from IGMPv2 hosts.

Source list

List of multicast sources.

Source Address

IP address of a multicast source.

Related Topics

display igmp group static

Function

The display igmp group static command displays information about static IGMP entries.

Format

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

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Displays information about static IGMP entries in a specified VPN instance.

The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.

all-instance Displays information about static IGMP entries in all instances. -
group-address Displays information about static IGMP entries of a specified group. If this parameter is not specified, the command displays static IGMP entries of all groups. The address is in dotted decimal notation and ranges from 224.0.1.0 to 239.255.255.255.
interface interface-type interface-number Displays information about the static IGMP groups on a specified interface. interface-type interface-number specifies the type and number of an interface. -
verbose Displays detailed interface list in a static IGMP group. If the parameter is not specified, the command displays only summary of static IGMP entries. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

This command displays information about static IGMP entries configured using the igmp static-group command.

Example

# Display information about all static IGMP entries.

<HUAWEI> display igmp group static
Static join group information of VPN instance: public net                                                                           
 Vlanif6:                                                                                                                           
  Total entries: 2                                                                                                                   
   Group Address   Source Address  Expires                                                                                          
   229.2.2.1       0.0.0.0         never                                                                                            
   229.2.2.5       0.0.0.0         never                                                                                            
Table 10-4  Description of the display igmp group static command output

Item

Description

Static join group information of VPN instance

VPN instance to which static IGMP groups belong.

Vlanif6

Interface type and interface number.

Total entries

Number of static IGMP entries.

Group Address

Multicast group address.

Source Address

Multicast source address.

Expires

Scheduled time when a group will be deleted from the IGMP group table. never indicates that the group never ages.

# Display detailed information about static IGMP entries.

<HUAWEI> display igmp group static verbose
Static join group information of VPN-Instance: public net                                                                           
 Vlanif6:                                                                                                                           
  Total 2 entries                                                                                                                   
   Group Address   Source Address  Reference num  Multicast Boundary                                                                
   229.2.2.1       0.0.0.0         1              NO                                                                                
   229.2.2.5       0.0.0.0         1              NO                                                                                
Table 10-5  Description of the display igmp group static verbose output

Item

Description

Static join group information of VPN-Instance

VPN instance to which static IGMP entries belong.

Vlanif6

Interface type and interface number.

Total 2 entries

Number of static IGMP entries on the interface.

Group Address

Multicast group address.

Source Address

Multicast source address.

Reference num

Number of the IGMP entry on the current interface is referenced.

Multicast Boundary

Whether the multicast forwarding boundary is configured.

# Display information about IGMP groups statically configured on VLANIF100.

<HUAWEI> display igmp group interface vlanif 100 static
Static join group information of VPN instance: public net
 Vlanif100:
  Total entries: 2 
   Group Address   Source Address  Expires
   226.0.0.1       10.0.5.120      never
   226.0.0.2       0.0.0.0         never 
Table 10-6  Description of the display igmp group interface vlanif 100 static command output

Item

Description

Static join group information of VPN instance

VPN instance to which static IGMP groups belong.

Vlanif100

Interface type and interface number.

Total entries

Number of static IGMP entries on the interface.

Group Address

Multicast group address.

Source Address

Multicast source address.

Expires

Scheduled time when a group will be deleted from the IGMP group table. never indicates that the group never ages.

Related Topics

display igmp interface

Function

The display igmp interface command displays information about IGMP interfaces.

Format

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

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Displays information about IGMP interfaces in a VPN instance.

The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.

all-instance Displays information about IGMP interfaces in all instances. -
interface-type interface-number Displays information about a specified IGMP interface. If this parameter is not specified, the command displays information about all IGMP interfaces. -
up Displays information about the IGMP interfaces with the IP protocol in Up state and the IGMP protocol in Active state. -
down Displays information about the IGMP interfaces with the IP protocol in Down state and the IGMP protocol in Inactive state. -
verbose Displays detailed information about IGMP interfaces. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

To check the IGMP configuration and running information on an interface, run the display igmp interface command. This command displays IGMP information only when IGMP is enabled on interfaces of the device.

Example

# Display the IGMP configuration and running information on VLANIF100.

<HUAWEI> display igmp interface vlanif 100
Interface information of VPN instance: public net
 Vlanif100(192.168.1.2):
   IGMP is enabled
   Current IGMP version is 2
   IGMP state: up
   IGMP group policy: none
   IGMP limit: -
   Query interval for IGMP (negotiated): -
   Query interval for IGMP (configured): 60 s
   Other querier timeout for IGMP: 0 s
   Maximum query response time for IGMP: 10 s
   Querier for IGMP: 192.168.1.2 (this router)
  Total 1 IGMP Group reported  

# Display IGMP parameters on all interfaces.

<HUAWEI> display igmp interface verbose
Interface information of VPN instance: public net
 Vlanif100(192.168.1.2):
   IGMP is enabled
   Current IGMP version is 2
   IGMP state: up
   IGMP group policy: none
   IGMP limit: -
   Query interval for IGMP (negotiated): -
   Query interval for IGMP (configured): 60 s
   Other querier timeout for IGMP: 0 s
   Maximum query response time for IGMP: 10 s
   Last member query time: 2 s
   Last member query interval: 1 s
   Startup query interval: 15 s
   Startup query count: 2
   General query timer expiry (hours:minutes:seconds): 00:00:44
   Querier for IGMP: 192.168.1.2 (this router)
   IGMP activity: 1 joins, 0 leaves
   Robustness (negotiated): -
   Robustness (configured): 2
   Require Router Alert: disabled
   Send Router Alert: enabled
   Ip-source-policy: disabled
   Query Ip-source-policy: disabled
   Prompt Leave: disabled
   SSM-Mapping: enabled
   Startup query timer expiry: off
   Other querier present timer expiry: off
  Total 1 IGMP Group reported  
Table 10-7  Description of the display igmp interface verbose command output

Item

Description

Interface information of VPN instance

VPN instance to which IGMP interface information belongs.

Vlanif100(192.168.1.2)

Interface type and interface number (IP address).

IGMP is enabled

IGMP has been enabled on an interface. IGMP can be enabled on an interface using the igmp enable command.

Current IGMP version is 2

IGMP version running on an interface. IGMP has three versions: IGMPv1, IGMPv2, and IGMPv3. This parameter is configured using the igmp version command.

IGMP state

Status of an IGMP interface, which can be up or down.

IGMP group policy

Number of the ACL used in an IGMP group policy, which is used to control the number of groups that an interface can join. The ACL is specified by using the igmp group-policy command.

The value none indicates that no ACL is applied to the interface.

Query interval for IGMP (negotiated)

Interval negotiated by non-queriers for sending Query messages. The negotiated value is only supported by IGMPv3.

Query interval for IGMP (configured)

Configured interval for sending IGMP Query messages. This parameter is configured using the igmp timer query command.

Other querier timeout for IGMP

Length of the other querier present timer. This parameter is configured using the igmp timer other-querier-present command. The value is 0 on the interface that functions as the querier.

Maximum query response time for IGMP

Maximum response time carried by an IGMP Query message. This parameter is configured using the igmp max-response-time command.

Last member query time

Last member query time, calculated using the following formula:

Last member query time = Last member query interval x Robustness variable

The last member query time is not defined in IGMPv1.

Last member query interval

Interval for sending Group-Specific Query messages. The value is configured using the igmp lastmember-queryinterval command. This interval is not defined in IGMPv1.

Startup query interval

Startup query interval of the querier. The interface sends Query messages at this interval when it starts to function as a querier. The value is 1/4 of the query interval configured using the igmp timer query command. The startup query interval is not defined in IGMPv1.

Startup query count

Number of query messages the querier interface sends at startup. The value is configured using the igmp robust-count command. The startup query count is not defined in IGMPv1.

General query timer expiry (hours:minutes:seconds)

Timeout interval of a general query timer.

Querier for IGMP

IGMP querier. In IGMPv1, the querier is selected based on the multicast routing protocol. In IGMPv2, the multicast switch with the smallest IP address functions as the querier on the shared network segment.

IGMP activity: 1 joins, 0 leaves

Active group memberships on an interface.
  • joins: indicates the number of IGMP groups that the interface has joined. When the interface joins a new group, the value increases by 1. When the interface leaves a group, the value remains unchanged.

  • leaves: indicates the number of groups that the interface has left. When the interface leaves a group, the value increases by 1.

Robustness (negotiated)

Robustness variable negotiated by non-queriers. The negotiated value is only supported by IGMPv3.

Robustness (configured)

Robustness variable configured on an interface. This parameter is configured using the igmp robust-count command.

Require Router Alert

Whether the local device discards IGMP packets that do not contain the Router-Alert option in IP packet headers. This function is configured using the igmp require-router-alert command.

Send Router Alert

Whether the local device sends IGMP packets with the Router-Alert option. This function is configured using the igmp send-router-alert disable command.

Ip-source-policy

Whether to filter IGMP Report/Leave messages based on host addresses. This function is configured using the igmp ip-source-policy command.

Query Ip-source-policy

Whether to filter IGMP Query messages based on source addresses. This function is configured using the igmp query ip-source-policy command.

Prompt Leave

Whether fast leave is enabled. The fast leave function is configured using the igmp prompt-leave command.

SSM-Mapping

Whether SSM mapping is enabled. SSM mapping is enabled using the igmp ssm-mapping enable command.

Startup query timer expiry

Interval at which the interface sends Query messages when it starts to function as a querier. The value is 1/4 of Timer query.

The value off indicates that the interface has not started to send Query messages. The startup query timer is enabled only when the interface starts as a querier.

Other querier present timer expiry

Status of the other querier present timer. The value off indicates that the interface considers itself as a querier and that no other queriers exist.

Total 1 IGMP Group reported

Indicates the number of IGMP groups that the interface dynamically joins.

display igmp invalid-packet

Function

The display igmp invalid-packet command displays statistics and details about invalid IGMP packets received by a device.

Format

display igmp [ vpn-instance vpn-instance-name | all-instance ] invalid-packet [ interface interface-type interface-number | message-type { leave | query | report } ] *

display igmp invalid-packet [ packet-number ] verbose

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Displays statistics about invalid IGMP messages received in a specified VPN instance.

The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.

all-instance Displays statistics about invalid IGMP messages received in all VPN instances. -
interface interface-type interface-number Displays statistics about invalid IGMP messages received on a specified interface. If this parameter is not specified, the command displays statistics about IGMP messages received on all interfaces. -
message-type Displays statistics about invalid IGMP messages of a specific type. -
leave Displays statistics about invalid Leave messages. -
query Displays statistics about invalid Query messages. -
report Displays statistics about invalid Report messages. -
packet-number Displays details about a specified number of invalid, recently received IGMP messages. The value is an integer that ranges from 1 to 100. By default, details about all invalid, currently stored IGMP messages are displayed.
verbose Displays details about invalid IGMP messages. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run the display igmp invalid-packet command to view statistics and details about invalid IGMP messages for fault location and rectification.

If IGMP entries fail to be generated on a multicast network, you can run the display igmp invalid-packet command to check whether devices have received invalid IGMP messages. If the command output contains statistics about invalid IGMP messages, run the display igmp invalid-packet [ packet-number ] verbose command to view details about invalid IGMP messages to locate faults.

You can run the following commands to view information about specific invalid IGMP messages:

  • Run the display igmp invalid-packet interface interface-type interface-number command to view statistics about invalid IGMP messages received by a specified interface.

  • Run the display igmp invalid-packet packet-number verbose command to view details about invalid, recently received IGMP messages. Currently, details about a maximum of 100 invalid IGMP messages can be displayed.

Example

# Display statistics about invalid IGMP messages received by the device.

<HUAWEI> display igmp invalid-packet

           Statistics of invalid packets for public net:
--------------------------------------------------------------------
IGMP Query invalid packet:
Unwanted Source List    : 1000        Zero Max Resp Code      : 0
Fault Length            : 1000        Invalid Multicast Group : 0
Bad Checksum            : 0

IGMP Report invalid packet:
Fault Length            : 0           Invalid Multicast Group : 0
Invalid Multicast Source: 0           Bad Checksum            : 0
Illegal Report Type     : 0

IGMP Leave invalid packet:
Invalid Multicast Group : 0           Bad Checksum            : 0
--------------------------------------------------------------------  
Table 10-8  Description of the display igmp invalid-packet command output

Item

Description

Statistics of invalid packets for public net

Statistics of invalid IGMP messages in public network.

IGMP Query invalid packet

Number of invalid IGMP Query messages.

Unwanted Source List

Number of messages with unwanted source lists.

Zero Max Resp Code

Number of messages whose Max Resp Code field is 0.

Fault Length

Number of messages with invalid lengths.

Invalid Multicast Group

Number of messages with invalid group addresses.

Bad Checksum

Number of messages with checksum errors.

IGMP Report invalid packet

Number of invalid IGMP Report messages.

Invalid Multicast Source

Number of messages with invalid multicast source addresses.

Illegal Report Type

Number of IGMP Report messages of invalid types.

IGMP Leave invalid packet

Number of invalid IGMP Leave messages.

# Display details of one invalid recently received IGMP message.

<HUAWEI> display igmp invalid-packet 1 verbose
       Detailed information of invalid packets
-----------------------------------------------------
Packet information (Index 6):
-----------------------------------------------------
Interface           :  Vlanif100
Time                :  2010-06-09 11:03:51 UTC-08:00
Message Length      :  24
Invalid Type        :  Invalid Multicast Group
Source Address      :  10.0.3.3
0000: 16 3c 00 00 01 34 04 04
-----------------------------------------------------
Table 10-9  Description of the display igmp invalid-packet 1 verbose command output

Item

Description

Detailed information of invalid packets

Details about the invalid IGMP message.

Packet information (Index 6)

Sequence number of the invalid IGMP message, which is numbered in the opposite order in which the message is received.

Interface

Interface receiving invalid IGMP messages.

Time

Time when the invalid IGMP message is received, in any of the following formats:
  • YYYY-MM-DD HH:MM:SS

  • YYYY-MM-DD HH:MM:SS UTC±HH:MM DST

  • YYYY-MM-DD HH:MM:SS UTC±HH:MM

  • YYYY-MM-DD HH:MM:SS DST

UTC±HH:MM indicates that a time zone is configured using the clock timezone command; DST indicates that the daylight saving time is configured using clock daylight-saving-time command.

Message Length

Length of the invalid IGMP message.

Invalid Type

Type of the invalid IGMP message.

Source Address

Source address of the invalid IGMP message.

0000: 16 3c 00 00 01 34 04 04

Contents of the invalid IGMP message.

display igmp ssm-mapping

Function

The display igmp ssm-mapping command displays configuration of IGMP SSM mapping.

Format

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

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Displays SSM mapping entries in a specified VPN instance.

The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.

all-instance Displays SSM mapping entries in all instances. -
group [ group-address ] Displays the SSM mapping entries of a specified group. If group-address is not specified, the command displays SSM mapping entries of all groups. The value ranges from 224.0.1.0 to 239.255.255.255, in dotted decimal notation.
interface [ interface-type interface-number ] Displays whether SSM mapping is enabled on a specified interface. If interface-type interface-number is not specified, the command displays all the interfaces that are in Up state and have SSM mapping enabled. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

This command displays mapping between multicast groups and multicast sources configured using the ssm-mapping command. You can also use this command to check the SSM mapping configuration on an interface. To enable SSM mapping on an interface, run the igmp ssm-mapping enable command in the interface view.

Example

# Display SSM mapping entries of all the multicast sources and multicast groups.

<HUAWEI> display igmp ssm-mapping group 
IGMP SSM-Mapping conversion table of VPN instance: public net
 Total entries: 2    (2 entries matched)

 00001: (10.1.0.2, 225.1.1.0)

 00002: (10.1.0.2, 239.255.255.0)

 Total 2 entries matched
Table 10-10  Description of the display igmp ssm-mapping group command output

Item

Description

IGMP SSM-Mapping conversion table of VPN instance

VPN instance to which the IGMP SSM mapping table belongs.

Total entries: 2 (2 entries matched)

Total number of SSM mapping entries and total number of entries matching the query conditions.

00001: (10.1.0.2, 225.1.1.0)

00002: (10.1.0.2, 239.255.255.0)

Number of an (S, G) entry.

Total 2 entries matched

Number of SSM mapping entries matching the query conditions.

# Display whether IGMP SSM mapping is enabled on VLANIF100.

<HUAWEI> display igmp ssm-mapping interface vlanif 100
 IGMP SSM-Mapping is enabled
Table 10-11  Description of the display igmp ssm-mapping interface vlanif 100 command output

Item

Description

IGMP SSM-Mapping is enabled

SSM mapping is enabled on the interface.

igmp

Function

The igmp command displays the IGMP view.

The undo igmp command deletes all configurations in the IGMP view.

Format

igmp [ vpn-instance vpn-instance-name ]

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

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Specifies the name of a VPN instance.

The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Global IGMP parameters must be configured in the IGMP view.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Example

# Enter the IGMP view of the public network instance.

<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] igmp
[*HUAWEI-igmp]
# Enter the IGMP view of VPN instance mvpn.
<HUAWEI> system-view
[~HUAWEI] ip vpn-instance mvpn
[*HUAWEI-vpn-instance-mvpn] ipv4-family
[*HUAWEI-vpn-instance-mvpn-af-ipv4] route-distinguisher 22:1
[*HUAWEI-vpn-instance-mvpn-af-ipv4] quit
[*HUAWEI-vpn-instance-mvpn] multicast routing-enable
[*HUAWEI-vpn-instance-mvpn] quit
[*HUAWEI] igmp vpn-instance mvpn
[*HUAWEI-igmp-mvpn]

igmp enable

Function

The igmp enable command enables IGMP on an interface.

The undo igmp enable command disables IGMP on an interface.

By default, IGMP is disabled on an interface.

Format

igmp enable

undo igmp enable

Parameters

None

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On a shared network segment, user hosts and Layer 3 multicast devices directly connected to the user network segment must run IGMP. A multicast device can process IGMP messages sent from user hosts only after IGMP is enabled on the interfaces connected to user network segments.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

  • An interface of the CE8800, CE7800, CE6800, and CE5800 series switches must run both PIM-SM and IGMP to forward multicast data packets.
  • If IGMP parameters are configured on an interface, the parameter settings take effect only after IGMP is enabled.
  • In the scenario when both Layer 2 and Layer 3 multicast are enabled, that is, when Layer 2 multicast is configured in a VLAN and Layer 3 multicast is configured on the corresponding VLANIF interface, the following functions must be configured simultaneously to ensure normal on-demand forwarding of multicast traffic:
    • IGMP snooping must be enabled in a VLAN.
    • PIM (PIM-SM or Bidir-PIM) and IGMP must be enabled on the corresponding VLANIF interface.

Example

# Enable IGMP on VLANIF100 connected to a user network segment.

<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] pim sm
[*HUAWEI-Vlanif100] igmp enable
# Enable IGMP on 10GE1/0/1 connected to a user network segment.
<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] undo portswitch
[*HUAWEI-10GE1/0/1] pim sm
[*HUAWEI-10GE1/0/1] igmp enable

igmp group-policy

Function

The igmp group-policy command configures an IGMP group policy on an interface to limit the range of multicast groups that the hosts can join.

The undo igmp group-policy command deletes the IGMP group policy.

By default, no IGMP group policy is configured on an interface, and the hosts can join any multicast groups.

Format

igmp group-policy { acl-number | acl-name acl-name } [ 1 | 2 | 3 ]

undo igmp group-policy

Parameters

Parameter Description Value
acl-number Specifies the number of a basic ACL or an advanced ACL. The ACL defines a multicast group range. The number of a basic ACL is an integer that ranges from 2000 to 2999. The number of an advanced ACL ranges from 3000 to 3999.
acl-name acl-name Specifies the name of a basic ACL or an advanced ACL.

The value is a string of 1 to 32 case-sensitive characters except spaces. The value must start with a letter (case-sensitive).

1 Sets the range of multicast groups that IGMPv1 hosts can join. -
2 Sets the range of multicast groups that IGMPv2 hosts can join. -
3 Sets the range of multicast groups that IGMPv3 hosts can join. -

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

To control the multicast groups that hosts on the network attached to an interface can join, specify an ACL in the igmp group-policy command as a filter to specify the range of multicast groups served by the interface. This configuration improves security of the IGMP application. You can also use this command to prevent the switch from receiving Join messages for specified groups.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

  • Before running the igmp group-policy command, run the acl command to configure the ACL that you want to apply to the group policy to limit the range of multicast groups that hosts connected to the interface can join.
    • In the basic ACL view, set source in the rule command to the range of multicast groups that an interface can join.

    • In the advanced ACL view, set source in the rule command to the source address that is allowed to send multicast data to the specified multicast groups, and set destination to the range of multicast groups that an interface can join.

  • After the igmp group-policy command is executed on an interface:
    • The interface filters the received Report messages based on the ACL and maintains memberships only for the multicast groups permitted by the ACL.

    • The interface discards the Report messages that are denied by the ACL. If the entries of the multicast groups denied by the ACL exist on the switch, the switch deletes these entries when the aging time of the entries expires.

    • If the IGMP version is not specified, the specified ACL applies to IGMPv1, IGMPv2, and IGMPv3 hosts.

Example

# Create ACL 2005, and configure a rule that allows hosts to receive data of multicast group 225.1.1.1. Configure an IGMP group policy on VLANIF100 and reference ACL 2005 to allow hosts connected to the interface to join only multicast group 225.1.1.1.

<HUAWEI> system-view
[~HUAWEI] acl number 2005
[*HUAWEI-acl4-basic-2005] rule permit source 225.1.1.1 0
[*HUAWEI-acl4-basic-2005] quit
[*HUAWEI] multicast routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] igmp group-policy 2005

# Create an ACL named myacl, and configure a rule that allows hosts to receive data of multicast groups in the range of 225.1.0.0/16. Configure an IGMP group policy on VLANIF100 and reference the ACL to allow hosts connected to the interface to join only the specified multicast groups.

<HUAWEI> system-view
[~HUAWEI] acl name myacl
[*HUAWEI-acl4-advance-myacl] rule permit ip destination 225.1.0.0 0.0.255.255
[*HUAWEI-acl4-advance-myacl] quit
[*HUAWEI] multicast routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] igmp group-policy acl-name myacl
# Create ACL 2005, and configure a rule that allows hosts to receive data of multicast group 225.1.1.1. Configure an IGMP group policy on 10GE1/0/1 and reference ACL 2005 to allow hosts connected to the interface to join only multicast group 225.1.1.1.
<HUAWEI> system-view
[~HUAWEI] acl number 2005
[*HUAWEI-acl4-basic-2005] rule permit source 225.1.1.1 0
[*HUAWEI-acl4-basic-2005] quit
[*HUAWEI] multicast routing-enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] undo portswitch
[*HUAWEI-10GE1/0/1] igmp group-policy 2005

igmp ip-source-policy

Function

The igmp ip-source-policy command enables filtering of IGMP Report/Leave messages based on source addresses.

The undo igmp ip-source-policy command disables filtering of IGMP Report/Leave messages based on source addresses.

By default, the switch does not filter IGMP Report/Leave messages based on source addresses.

Format

igmp ip-source-policy [ basic-acl-number | acl-name acl-name ]

undo igmp ip-source-policy

Parameters

Parameter Description Value
basic-acl-number Specifies the number of a basic ACL, which defines the range of source addresses. The value is an integer that ranges from 2000 to 2999.
acl-name acl-name Specifies the name of a basic ACL.

The value is a string of 1 to 32 case-sensitive characters except spaces. The value must start with a letter (case-sensitive).

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

IGMP runs on member hosts and their directly connected multicast devices. A multicast device processes all received Report/Leave messages. For security purposes, you can configure the multicast device to filter Report/Leave messages received on an interface.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

IGMP Report/Leave messages are encapsulated in IP packets. The igmp ip-source-policy command configures the switch to check the source address in the IP header of each received Report/Leave message. The switch filters Report/Leave messages based on the following rules (if ACL rules are not configured):

  • If the source IP address of a Report/Leave message is 0.0.0.0 or on the same network segment as the IP address of the inbound interface, the switch processes the Report/Leave message.
  • If the source IP address of a Report/Leave message is on a different network segment than the IP address of the inbound interface, the switch discards the Report/Leave message.

If you have specified an ACL rule, the interface filters out the IGMP Report/Leave messages whose source addresses do not match the ACL rule.

Example

# Enable filtering of IGMP Report/Leave messages based on source addresses on VLANIF100.
<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] igmp ip-source-policy
# Configure VLANIF100 to accept the IGMP Report/Leave messages with the source address 10.10.1.1.
<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] acl number 2001
[*HUAWEI-acl4-basic-2001] rule permit source 10.10.1.1 0
[*HUAWEI-acl4-basic-2001] quit
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] igmp ip-source-policy 2001
# Enable filtering of IGMP Report/Leave messages based on source addresses on 10GE1/0/1.
<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] undo portswitch
[*HUAWEI-10GE1/0/1] igmp ip-source-policy

igmp lastmember-queryinterval

Function

The igmp lastmember-queryinterval command configures interval at which an IGMP querier interface sends IGMP Group-Specific Query messages or IGMP Group-and-Source-Specific Query messages after receiving IGMP Leave messages from hosts.

The undo igmp lastmember-queryinterval command restores the default value.

By default, the interval at which an IGMP querier interface sends IGMP Group-Specific Query messages or IGMP Group-and-Source-Specific Query messages is 1s.

Format

igmp lastmember-queryinterval interval

undo igmp lastmember-queryinterval

Parameters

Parameter Description Value
interval Specifies the interval at which an IGMP querier sends IGMP Group-Specific Query messages or IGMP Group-and-Source-Specific Query messages. The value is an integer that ranges from 1 to 5, in seconds.

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When a querier receives a Leave message for a group, the querier periodically sends IGMP Group-Specific Query messages or IGMP Group-and-Source-Specific Query messages to check for other members in the group. The igmp lastmember-queryinterval command sets the interval at which the querier sends Last Member Query messages. The querier stops forwarding multicast data to the group if it receives no Report message from the group within the period specified by interval x robust-value. Here, robust-value is the robustness variable configured using the igmp robust-count or robust-count command.

If the querier receives Report messages from the group within the specified period, the querier continues maintaining memberships of the group. Otherwise, the querier considers that the last member has left the group and no longer maintains memberships of the group.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

  • The igmp lastmember-queryinterval command is valid only when the IGMP querier runs IGMPv2 or IGMPv3.
  • The igmp lastmember-queryinterval command has the same function as the lastmember-queryinterval command used in the IGMP view. The configuration in the IGMP view takes effect for all interfaces, whereas the configuration in the interface view takes effect only for the specified interface. The configuration in the interface view takes precedence over the configuration in the IGMP view. The configuration in the IGMP view is used only when no configuration is performed in the interface view.

Example

# Set the interval for sending IGMP Group-Specific Query messages or IGMP Group-and-Source-Specific Query messages to 3 seconds on VLANIF100.

<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] igmp lastmember-queryinterval 3
# Set the interval for sending IGMP Group-Specific Query messages or IGMP Group-and-Source-Specific Query messages to 3 seconds on 10GE1/0/1.
<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] undo portswitch
[*HUAWEI-10GE1/0/1] igmp lastmember-queryinterval 3

igmp max-response-time

Function

The igmp max-response-time command sets the maximum response time for IGMP General Query messages on an interface.

The undo igmp max-response-time command restores the default maximum response time for General IGMP Query messages.

By default, the maximum response time for IGMP General Query messages is 10s on an interface.

Format

igmp max-response-time interval

undo igmp max-response-time

Parameters

Parameter Description Value
interval Specifies the maximum response time for IGMP General Query messages. The value is an integer that ranges from 1 to 25, in seconds.

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If hosts send IGMP Report messages immediately after they receive IGMP General Query messages, the querier on a shared network segment may receive a large number of Report messages sent from many hosts at the same time. The network may be congested when this situation occurs.

To avoid such situations, IGMPv2 and IGMPv3 messages specify the maximum response time for IGMP General Query messages. When a host running IGMPv2 or IGMPv3 receives an IGMP General Query message, it starts a timer for the group it wants to join. The timer length is a random value between 0 and the maximum response time. When the timer times out, the host sends a Report message.

The maximum response time specifies the deadline for the host to send a Report message. An appropriate maximum response time allows hosts to respond to Query messages quickly and prevents hosts from sending Report messages at the same time.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

  • This command is valid only for IGMPv2 and IGMPv3.
  • A shorter response time allows a multicast device to obtain multicast group member information more quickly, but consumes more bandwidth and system resources.
  • The igmp max-response-time command has the same function as the max-response-time command used in the IGMP view. The configuration in the IGMP view takes effect for all interfaces, whereas the configuration in the interface view takes effect only for the specified interface. The configuration in the interface view takes precedence over the configuration in the IGMP view. The configuration in the IGMP view is used only when no configuration is performed in the interface view.

Example

# Set the maximum response time for IGMP General Query messages to 8 seconds on VLANIF100.

<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] igmp max-response-time 8
# Set the maximum response time for IGMP General Query messages to 8 seconds on 10GE1/0/1.
<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] undo portswitch
[*HUAWEI-10GE1/0/1] igmp max-response-time 8

igmp on-demand

Function

The igmp on-demand command enables the IGMP on-demand function. This function enables a querier to maintain group memberships according to requirements of group members, without sending Query messages. After IGMP on-demand is enabled on an interface, dynamic IGMP entries on the interface will never age out.

The undo igmp on-demand command restores the default configuration.

By default, a querier does not maintain group memberships according to requirements of group members, and dynamic entries are aged out when the aging time expires.

Format

igmp on-demand

undo igmp on-demand

Parameters

None

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a standard IGMP working process, a querier sends General Query messages periodically and collects multicast membership information based on received Report and Leave messages. Multicast members respond to every Query message they receive. After IGMP on-demand is configured on the querier, the querier does not send Query messages, reducing IGMP packets exchanged between the querier and member hosts.

The IGMP on-demand function enables a querier to maintain multicast memberships based on requirements of members. The querier does not send Query messages to collect member information, reducing the number of IGMP messages exchanged between the querier and hosts.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

  • IGMP on-demand applies only to IGMPv2 and IGMPv3.
  • The querier does not process dynamic IGMP entries that have been generated before IGMP on-demand is enabled on it.
  • After the igmp on-demand command is executed on an interface (IGMP querier):
    • The interface does not send IGMP Query messages

    • IGMP group entries are generated after the interface receives IGMP Report messages. The entries will never age out.

    • When the interface receives an IGMP Leave message, it deletes the corresponding IGMP entry.

Example

# Enable the IGMP on-demand function on VLANIF100.

<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] igmp on-demand
# Enable the IGMP on-demand function on 10GE1/0/1.
<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] undo portswitch
[*HUAWEI-10GE1/0/1] igmp on-demand

igmp prompt-leave

Function

The igmp prompt-leave command enables the fast leave function on an interface. This function enables an IGMP querier to delete IGMP entries immediately after receiving Leave messages from group members, without sending Group-Specific Query messages.

The undo igmp prompt-leave command disables fast leave on an interface.

By default, an IGMP querier sends a Group-Specific Query message after receiving a Leave message for a specific multicast group.

Format

igmp prompt-leave [ group-policy { acl-number | acl-name acl-name } ]

undo igmp prompt-leave

Parameters

Parameter Description Value
group-policy
Specifies an IGMP group policy. If this parameter is specified, the fast leave function takes effect only for multicast groups specified in the policy. When specifying this parameter, ensure that the referenced ACL has been configured. The device filters Leave messages on the interface based on the ACL.
  • If a host leaves a multicast group in the range permitted by the ACL, the device immediately deletes the multicast group entry without sending a Group-Specific Query message.
  • If a host leaves a multicast group out of the range permitted by the ACL, the device sends a Group-Specific Query message.

If this parameter is not specified, the fast leave function takes effect for all multicast groups.

-
acl-number Specifies the number of a basic ACL or an advanced ACL. This ACL defines a range of multicast groups. The number of a basic ACL is an integer that ranges from 2000 to 2999. The number of an advanced ACL ranges from 3000 to 3999.
acl-name acl-name Specifies the name of a basic ACL or an advanced ACL.

The value is a string of 1 to 32 case-sensitive characters except spaces. The value must start with a letter (case-sensitive).

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In some scenarios, a querier interface connects to only one receiver host. If the host frequently switches between multiple multicast groups, you can configure the fast leave function on the interface so that the interface can quickly respond to Leave messages sent from the host. After the fast leave function is configured, the querier does not send a Group-Specific Query message after receiving a Leave message. Instead, the querier directly notifies the upstream multicast device that the host has left the multicast group. The fast leave function reduces delay in response to Leave messages and saves network bandwidth.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

  • IGMP fast leave applies only to IGMPv2 and IGMPv3.
  • When an interface has more than one receiver connected, enabling the fast leave function interrupts multicast traffic of the other receivers in the multicast group. It is recommended that you enable this function only on interfaces with one receiver.
  • When configuring an ACL to specify the range of multicast groups, pay attention to the following points:
    • When you run the rule command in the view of a basic ACL, set source to the address range of multicast groups that hosts can fast leave.

    • When you run the rule command in the view of an advanced ACL, set source to the multicast source address and destination to the range of multicast groups that hosts can fast leave.

Example

# Create ACL 2005 and configure a rule that allows hosts to fast leave multicast groups in the range of 225.1.0.0/16. Configure fast leave on VLANIF100.

<HUAWEI> system-view
[~HUAWEI] acl number 2005
[*HUAWEI-acl4-basic-2005] rule permit source 225.1.0.0 0.0.255.255
[*HUAWEI-acl4-basic-2005] quit
[*HUAWEI] multicast routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] igmp prompt-leave group-policy 2005

# Create an ACL named myacl and configure a rule that allows hosts to fast leave multicast groups in the range of 225.1.0.0/16. Configure fast leave on VLANIF100.

<HUAWEI> system-view
[~HUAWEI] acl name myacl
[*HUAWEI-acl4-advance-myacl] rule permit ip destination 225.1.0.0 0.0.255.255
[*HUAWEI-acl4-advance-myacl] quit
[*HUAWEI] multicast routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] igmp prompt-leave group-policy acl-name myacl
# Create ACL 2005 and configure a rule that allows hosts to fast leave multicast groups in the range of 225.1.0.0/16. Configure fast leave on 10GE1/0/1.
<HUAWEI> system-view
[~HUAWEI] acl number 2005
[*HUAWEI-acl4-basic-2005] rule permit source 225.1.0.0 0.0.255.255
[*HUAWEI-acl4-basic-2005] quit
[*HUAWEI] multicast routing-enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] undo portswitch
[*HUAWEI-10GE1/0/1] igmp prompt-leave group-policy 2005

igmp query ip-source-policy

Function

The igmp query ip-source-policy command configures IGMP Query message filtering based on source addresses.

The undo igmp query ip-source-policy command restores the default configuration.

By default, no source address-based IGMP Query message filtering is configured.

Format

igmp query ip-source-policy { basic-acl-number | acl-name acl-name }

undo igmp query ip-source-policy

Parameters

Parameter Description Value
basic-acl-number Specifies the number of a basic ACL, which defines the range of source addresses. The value is an integer that ranges from 2000 to 2999.
acl-name acl-name Specifies the name of a basic ACL.

The value is a string of 1 to 32 case-sensitive characters except spaces. The value must start with a letter (case-sensitive).

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If an attacker sends forged IGMP Query messages with an IP addresses smaller than the querier IP address, the querier will be replaced by the attacker. As a result, the real querier cannot response to Report messages from group members and bandwidth is wasted. Source address-based IGMP Query message filtering can protect the querier from such attacks. After this function is configured on a device, the device accepts only the IGMP Query messages with source addresses permitted by the specified ACL. This function controls querier election.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

  • IGMP Query messages are encapsulated into IP messages. This command is used to filter IGMP Query messages based on the source addresses in IP headers.

  • This command configures a policy to filter IGMP Query messages based on source addresses. The ACL referenced in the policy defines the source addresses allowed. The device accepts only the IGMP Query messages with source addresses in the allowed range.

Example

# Configure VLANIF100 to accept only the IGMP Query messages with the source address 10.10.1.1.
<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] acl number 2001
[*HUAWEI-acl4-basic-2001] rule permit source 10.10.1.1 0
[*HUAWEI-acl4-basic-2001] quit
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] igmp query ip-source-policy 2001
# Configure 10GE1/0/1 to accept only the IGMP Query messages with the source address 10.10.1.1.
<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] acl number 2001
[*HUAWEI-acl4-basic-2001] rule permit source 10.10.1.1 0
[*HUAWEI-acl4-basic-2001] quit
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] undo portswitch
[*HUAWEI-10GE1/0/1] igmp query ip-source-policy 2001

igmp require-router-alert

Function

The igmp require-router-alert command configures an interface to discard IGMP messages without the Router-Alert Option.

The undo igmp require-router-alert command disables an interface from checking for the Router-Alert Option in IGMP messages.

By default, the device does not check for the Router-Alert Option in IGMP messages and processes all the IGMP messages received on an interface.

Format

igmp require-router-alert

undo igmp require-router-alert

Parameters

None

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, a network device sends a packet to the corresponding protocol module for processing only when the destination address of the packet is a local interface address. Destination addresses of IGMP packets are multicast addresses but not interface addresses of multicast devices. Therefore, multicast devices do not send IGMP packets to the IGMP module, and the IGMP module cannot maintain group memberships.

The Router-Alert option in the IP header of an IGMP message solves this problem. If an IGMP message contains the Router-Alert option, the device sends the message to the routing protocol module.

You can configure the device to accept only IGMP messages with the Router-Alert option to improve IGMP security.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

This command has the same function as the require-router-alert command used in the IGMP view. The configuration in the IGMP view takes effect for all interfaces, whereas the configuration in the interface view takes effect only for the specified interface. The configuration in the interface view takes precedence over the configuration in the IGMP view. The configuration in the IGMP view is used only when no configuration is performed in the interface view.

Example

# Configure VLANIF100 to discard IGMP messages without the Router-Alert option.

<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] igmp require-router-alert
# Configure 10GE1/0/1 to discard IGMP messages without the Router-Alert option.
<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] undo portswitch
[*HUAWEI-10GE1/0/1] igmp require-router-alert

igmp robust-count

Function

The igmp robust-count command sets an IGMP querier robustness variable on an interface.

The undo igmp robust-count command restores the default IGMP querier robustness variable on an interface.

By default, the IGMP querier robustness variable is 2.

Format

igmp robust-count robust-value

undo igmp robust-count

Parameters

Parameter Description Value
robust-value Specifies the IGMP querier robustness variable. The value is an integer that ranges from 2 to 5.

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The IGMP querier robustness variable specifies the retransmission count of IGMP packets to minimize impact of packet loss on the network.

On a shared network segment, a querier maintains IGMP-attached group memberships. The robustness variable affects the timeout interval of group memberships. The timeout interval of group memberships is calculated using the formula:

Timeout interval of group memberships = Interval for sending IGMP General Query messages x Robustness variable + Maximum response time

The robustness variable determines the following values:

  • Number of times the querier sends General Query messages when the querier starts

    When a querier starts, it sends General Query messages certain times specified by the robustness variable to query the multicast groups that have members on the shared network segment. The message sending interval during this process is 1/4 of the query interval configured using the igmp timer query or timer query command.

  • Number of times the querier sends IGMPv2 Group-Specific Query messages or IGMPv3 Source-and-Group-Specific Query messages when the querier receives a Leave message

    When receiving an IGMP Leave message of a multicast group, the querier sends Group-Specific Query messages certain times specified by the robustness variable to check whether the group has members. When the querier receives a Report message indicating that source-group mapping changes, the querier sends Source-and-Group-Specific Query messages certain times specified by the robustness variable. The interval for sending Group-Specific Query messages and Source-and-Group-Specific Query messages can be set using the igmp lastmember-queryinterval or lastmember-queryinterval command.

A larger robustness variable makes an IGMP querier more robust, but increases the timeout interval of group memberships.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

The igmp robust-count command has the same function as the robust-count command used in the IGMP view. The configuration in the IGMP view takes effect for all interfaces, whereas the configuration in the interface view takes effect only for the specified interface. The configuration in the interface view takes precedence over the configuration in the IGMP view. The configuration in the IGMP view is used only when no configuration is performed in the interface view.

Example

# Set the querier robustness variable on VLANIF100 to 3.

<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] igmp robust-count 3
# Set the querier robustness variable on 10GE1/0/1 to 3.
<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] undo portswitch
[*HUAWEI-10GE1/0/1] igmp robust-count 3

igmp send-router-alert disable

Function

The igmp send-router-alert disable command disables an interface from sending IGMP messages containing the Router-Alert option in IP headers.

The undo igmp send-router-alert disable command configures an interface to send IGMP messages containing the Router-Alert option in IP headers.

By default, the IP headers of IGMP messages sent by an interface contain the Router-Alert option.

Format

igmp send-router-alert disable

undo igmp send-router-alert disable

Parameters

None

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, the switch sends IGMP messages that contain the Router-Alert option in IP headers. If the switch needs to communicate with a device that does not support the Router-Alert option, run the igmp send-router-alert disable command to configure the switch to send IGMP messages without the Router-Alert option. The igmp send-router-alert disable command is usually used together with the undo igmp require-router-alert command.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

The igmp send-router-alert disable command has the same function as the send-router-alert disable command used in the IGMP view. The configuration in the IGMP view takes effect for all interfaces, whereas the configuration in the interface view takes effect only for the specified interface. The configuration in the interface view takes precedence over the configuration in the IGMP view. The configuration in the IGMP view is used only when no configuration is performed in the interface view.

Example

# Configure VLANIF100 to send IGMP messages without the Router-Alert option.

<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] igmp send-router-alert disable
# Configure 10GE1/0/1 to send IGMP messages without the Router-Alert option.
<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] undo portswitch
[*HUAWEI-10GE1/0/1] igmp send-router-alert disable

igmp ssm-mapping enable

Function

The igmp ssm-mapping enable command enables SSM mapping on an interface.

The undo igmp ssm-mapping enable command disables SSM mapping on an interface.

By default, SSM mapping is disabled on an interface.

Format

igmp ssm-mapping enable

undo igmp ssm-mapping enable

Parameters

None

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The SSM model allows only IGMPv3 hosts to specify the multicast sources which they want to receive data from. However, some hosts can only run IGMPv1 or IGMPv2. To enable these hosts to use the SSM service, configure IGMP SSM mapping on the switch. IGMP SSM mapping is implemented based on static SSM mapping entries on the switch. The switch converts (*, G) information in IGMPv1 and IGMPv2 Report messages to (S, G) information according to static SSM mapping entries to provide the SSM service for IGMPv1 and IGMPv2 hosts.

The igmp ssm-mapping enable command enables SSM mapping on an interface. The mappings between multicast source addresses and group addresses take effect only when SSM mapping is enabled on an interface. SSM mappings are configured using the ssm-mapping command.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Example

# Enable SSM mapping on VLANIF100.

<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] igmp ssm-mapping enable
# Enable SSM mapping on 10GE1/0/1.
<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] undo portswitch
[*HUAWEI-10GE1/0/1] igmp ssm-mapping enable

igmp static-group

Function

The igmp static-group command configures a static multicast group on an interface.

The undo igmp static-group command deletes a static multicast group from an interface.

By default, no static multicast group is configured on an interface.

Format

# Command syntax in the Layer 3 sub-interface view:

igmp static-group group-address [ inc-step-mask { group-mask | group-mask-length } number group-number ] [ source source-address ] dot1q vid vid

undo igmp static-group { all | group-address [ inc-step-mask { group-mask | group-mask-length } number group-number ] [ source source-address ] dot1q vid vid }

# Command syntax in other interface views:

igmp static-group group-address [ inc-step-mask { group-mask | group-mask-length } number group-number ] [ source source-address ]

undo igmp static-group { all | group-address [ inc-step-mask { group-mask | group-mask-length } number group-number ] [ source source-address ] }

Parameters

Parameter Description Value
group-address Specifies a multicast group address. In batch configuration mode, this parameter specifies the start address of the multicast group range. The value ranges from 224.0.1.0 to 239.255.255.255, in dotted decimal notation.
inc-step-mask Specifies the increment step mask for group addresses in batch configuration mode. -
group-mask Specifies the step mask of a group address in batch configuration mode, that is, the gap between two consecutive group addresses. The value is a wildcard mask format that ranges from 0.0.0.1 to 15.255.255.255, in dotted decimal notation.
group-mask-length Specifies the step mask length in batch configuration mode.

The value is an integer that ranges from 5 to 32.

If group-mask-length is used to configure the increment step mask and the display current-configuration command is used to display related configurations, the step mask of group addresses is displayed in group-mask format. A group-mask-length value is converted to a group-mask value using the following formula: group-mask = 1<<(32 - group-mask-length). The << symbol represents the left-shift operator, using which the binary format of an integer is shifted left for a specified number of digits. Extra binary digits out of the left boundary are discarded, and 0s are added at the right boundary. For example, 1<<0 represents 0.0.0.1, 1<<1 represents 0.0.0.2, and 1<<2 represents 0.0.0.4.

number group-number Specifies the number of group addresses in batch configuration mode. The value is an integer that ranges from 2 to 512.
source source-address Specifies a multicast source address. The address is in dotted decimal notation.
dot1q Statically binds a Dot1q termination Layer 3 sub-interface to a multicast group. -
vid vid Specifies the VLAN ID of the Dot1q termination Layer 3 sub-interface. The value is an integer ranging from 1 to 4090. This VLAN ID must be the same as the VLAN ID configured on the dot1q Layer 3 sub-interface using the dot1q termination vid command.
all Indicates all multicast groups that an interface statically joins. -

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

You can configure static multicast groups on user-side interfaces of the switch in some scenarios, for example:

  • There are long-term group members on a shared network segment, and the switch needs to forward multicast data to these group members quickly and steadily.

  • A network segment has no group member or hosts on the network segment cannot send Report messages, but multicast data needs to be sent to this network segment.

After a static multicast group is configured on an interface, the switch considers that the multicast group always has members on the network segment of the interface. Therefore, the switch always forwards multicast data of the multicast group.

The igmp static-group command is used on an interface connected to user hosts. The command can configure a single group or source-group binding on an interface at a time or configure multiple groups or source-group bindings in a batch.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Follow-up Procedure

If a user host no longer needs to receive multicast data of a static group, delete the static group configuration.

Precautions

  • The static multicast groups configured on an interface take effect only after PIM-SM is enabled on the interface using the pim sm command.
  • If an interface belongs to an NDR (Non-Designated Router) or Assert Loser device, the interface is not used as an outbound interface of PIM routing entries, so the multicast traffic can not be statically directed to targets by running the igmp static-group command.
  • The IGMP entries of static groups configured on an interface never time out. The switch considers that this interface is always connected to group members, and keeps forwarding multicast packets of the specified multicast groups to the network segment of the interface.
  • If you perform a second batch configuration by changing only group-number in the command and retaining the values of group-address and group-mask | group-mask-length configured in the first batch configuration, the second batch configuration overrides the first one.
  • You can configure overlapping multicast group addresses in different batch configurations. When you configure multiple static multicast groups in a batch on an interface, do not delete any static group configuration before the system completes the batch static group configuration.

Example

# Configure static multicast group 224.1.1.1 on VLANIF100.

<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] pim sm
[*HUAWEI-Vlanif100] igmp static-group 224.1.1.1

# Configure the switch to forward multicast packets from multicast source 192.168.11.1 to multicast group 232.1.1.1 through VLANIF100.

<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] pim sm
[*HUAWEI-Vlanif100] igmp static-group 232.1.1.1 source 192.168.11.1
# Configure 10 static multicast groups on VLANIF100 in a batch. Set the start multicast group address to 225.1.1.1 and the step mask length to 32.
<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] pim sm
[*HUAWEI-Vlanif100] igmp static-group 225.1.1.1 inc-step-mask 32 number 10
# Configure 10 source-group bindings on VLANIF100 in a batch. Set the start multicast group address to 232.1.1.1, the source address to 192.168.11.1, and the step mask length to 32.
<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] pim sm
[*HUAWEI-Vlanif100] igmp static-group 232.1.1.1 inc-step-mask 32 number 10 source 192.168.11.1
# Configure static multicast group 224.1.1.1 on 10GE1/0/1.
<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] undo portswitch
[*HUAWEI-10GE1/0/1] pim sm
[*HUAWEI-10GE1/0/1] igmp static-group 224.1.1.1
# Configure static multicast group 224.1.1.1 on 10GE1/0/1.1.
<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] undo portswitch
[*HUAWEI-10GE1/0/1] quit
[*HUAWEI] interface 10ge 1/0/1.1
[*HUAWEI-10GE1/0/1.1] dot1q termination vid 100
[*HUAWEI-10GE1/0/1.1] pim sm
[*HUAWEI-10GE1/0/1.1] igmp static-group 224.1.1.1 dot1q vid 100

igmp timer other-querier-present

Function

The igmp timer other-querier-present command sets the other querier present timer on an interface.

The undo igmp timer other-querier-present command restores the default value of the other querier present timer on an interface.

The formula used to calculate the other querier present timer value is:

Other querier present timer = Robustness variable x Interval for sending IGMP General Query messages + 1/2 x Maximum response time for IGMP query messages

If the default values of the robustness variable, the interval for sending IGMP General Query messages, and the maximum response time for IGMP query messages are used, the other querier present timer value is 125s.

Format

igmp timer other-querier-present interval

undo igmp timer other-querier-present

Parameters

Parameter Description Value
interval Specifies the other querier present timer. The value is an integer that ranges from 60 to 300, in seconds.

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When a user network segment connects to multiple Layer 3 multicast devices, only one Layer 3 multicast device is elected as the IGMP querier to send Query messages to hosts on the network segment. If the querier fails to send Query messages, group memberships cannot be created or maintained. Non-queriers running IGMPv2 or IGMPv3 start the other querier present timer after they fail in the querier election. If the non-queriers do not receive Query messages from the querier before the timer times out, they consider the querier failed and start a new querier election.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

  • The igmp timer other-querier-present command applies only to IGMPv2 and IGMPv3.
  • The igmp timer other-querier-present command has the same function as the timer other-querier-present command used in the IGMP view. The configuration in the IGMP view takes effect for all interfaces, whereas the configuration in the interface view takes effect only for the specified interface. The configuration in the interface view takes precedence over the configuration in the IGMP view. The configuration in the IGMP view is used only when no configuration is performed in the interface view.

If the other querier present timer value is shorter than the interval for sending IGMP General Query messages, the querier election is triggered frequently.

Example

# On VLANIF100, set the other querier present timer to 200 seconds.

<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] igmp timer other-querier-present 200
# On 10GE1/0/1, set the other querier present timer to 200 seconds.
<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] undo portswitch
[*HUAWEI-10GE1/0/1] igmp timer other-querier-present 200

igmp timer query

Function

The igmp timer query command sets the interval at which an interface sends IGMP General Query messages.

The undo igmp timer query command restores the default interval at which an interface sends IGMP General Query messages.

By default, an interface sends IGMP General Query messages at an interval of 60s.

Format

igmp timer query interval

undo igmp timer query

Parameters

Parameter Description Value
interval Specifies the interval at which an interface sends IGMP General Query messages. The value is an integer that ranges from 1 to 18000, in seconds.

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

An IGMP querier sends IGMP General Query messages at an interval to check whether a local network segment has group members. This interval is the general query interval. You can set the general query interval based on situations on your network. The general query interval affects the following processes:

  • When a querier starts, it sends General Query messages certain times specified by the robustness variable to query the multicast groups that have members on the shared network segment. The message sending interval during this process is 1/4 of the general query interval. The robustness variable can be set using the igmp robust-count command or the robust-count command.

  • After the startup process is complete, the querier sends General Query messages at intervals to maintain the group memberships on the interface.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

  • The default general query interval is 60 seconds, which is different than the default value 125 seconds defined by RFC documents. A Huawei querier and a non-Huawei querier must send IGMP general query messages at the same interval.

  • The querier is more sensitive when it sends General Query messages at a shorter interval. However, more bandwidth and resources are consumed in this case.
  • The function of the igmp timer query command is the same as that of the timer query command used in the IGMP view. The configuration in the IGMP view takes effect for all interfaces, whereas the configuration in the interface view takes effect only for the specified interface. The configuration in the interface view takes precedence over the configuration in the IGMP view. The configuration in the IGMP view is used only when no configuration is performed in the interface view.

Example

# Set the interval at which VLANIF100 sends General Query messages to 50 seconds.

<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] igmp timer query 50
# Set the interval at which 10GE1/0/1 sends General Query messages to 50 seconds.
<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] undo portswitch
[*HUAWEI-10GE1/0/1] igmp timer query 50

igmp version

Function

The igmp version command specifies an IGMP version on an interface.

The undo igmp version command restores the default IGMP version on an interface.

By default, an interface runs IGMPv2.

Format

igmp version version

undo igmp version

Parameters

Parameter Description Value
version Specifies the IGMP version running on the interface. The value is integer that ranges from 1 to 3.

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The switch can identify IGMP messages of a version earlier than its own IGMP version but cannot identify IGMP messages of a later version. To ensure normal IGMP operation, ensure that the switch runs the same IGMP version as member hosts or a later IGMP version.

If multiple switches exist on a shared network segment, configure the same IGMP version on all switch interfaces connected to hosts. Otherwise, errors may occur in IGMP operation because interfaces running different IGMP versions send packets with different formats.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Example

# Configure IGMPv1 on VLANIF100.

<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] interface vlanif 100
[*HUAWEI-Vlanif100] igmp version 1
# Configure IGMPv1 on 10GE1/0/1.
<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] interface 10ge 1/0/1
[*HUAWEI-10GE1/0/1] undo portswitch
[*HUAWEI-10GE1/0/1] igmp version 1

lastmember-queryinterval (IGMP)

Function

The lastmember-queryinterval command configures interval at which an IGMP querier sends IGMP Group-Specific Query messages or IGMP Group-and-Source-Specific Query messages after receiving IGMP Leave messages from hosts.

The undo lastmember-queryinterval command restores the default value.

By default, the interval at which an IGMP querier sends IGMP Group-Specific Query messages or IGMP Group-and-Source-Specific Query messages is 1 second.

Format

lastmember-queryinterval interval

undo lastmember-queryinterval

Parameters

Parameter Description Value
interval Specifies the interval for sending IGMP Group-Specific Query messages or IGMP Group-and-Source-Specific Query messages. The value is an integer that ranges from 1 to 5, in seconds.

Views

IGMP view of public network instance or IGMP view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When the querier receives a Leave message that a host sends to leave a multicast group, the querier periodically sends IGMP Group-Specific Query messages or IGMP Group-and-Source-Specific Query messages to check for other members in the multicast group. The lastmember-queryinterval command sets the interval at which the querier sends Last Member Query messages. The querier stops forwarding multicast data to the group if it receives no Report message from the group within the period specified by interval x robust-value. Here, robust-value is the robustness variable configured using the igmp robust-count or robust-count command.

If the querier does not receive any Report message within the specified period, it considers that the last member has left the group and no longer maintains the membership of this group.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

  • The igmp lastmember-queryinterval command is valid only when the IGMP querier runs IGMPv2 or IGMPv3.
  • This command has the same function as the igmp lastmember-queryinterval command used in the interface view. The configuration in the IGMP view is globally valid, whereas the configuration in the interface view takes effect only for the specified interface. The configuration in the interface view takes precedence over the configuration in the IGMP view. The configuration in the IGMP view is used only when no configuration is performed in the interface view.

Example

# In the IGMP view, set the interval for sending IGMP Group-Specific Query messages or IGMP Group-and-Source-Specific Query messages to 3 seconds.

<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] igmp
[*HUAWEI-igmp] lastmember-queryinterval 3

max-response-time (IGMP)

Function

The max-response-time command sets a global maximum response time for IGMP General Query messages.

The undo max-response-time command restores the global maximum response time for IGMP General Query messages to the default value.

By default, the global maximum response time for IGMP General Query messages is 10 seconds.

Format

max-response-time interval

undo max-response-time

Parameters

Parameter Description Value
interval Specifies the maximum response time for IGMP General Query messages. The value is an integer that ranges from 1 to 25, in seconds.

Views

IGMP view of public network instance or IGMP view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If hosts send IGMP Report messages immediately after they receive IGMP General Query messages, the querier on a shared network segment may receive a large number of Report messages sent from many hosts at the same time. The network may be congested when this situation occurs.

To avoid such situations, IGMPv2 and IGMPv3 messages specify the maximum response time for IGMP General Query messages. When a host running IGMPv2 or IGMPv3 receives an IGMP General Query message, it starts a timer for the group it wants to join. The timer length is a random value between 0 and the maximum response time. When the timer times out, the host sends a Report message.

The maximum response time specifies the deadline for the host to send a Report message. An appropriate maximum response time allows hosts to respond to Query messages quickly and prevents hosts from sending Report messages at the same time.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

  • This command applies only to IGMPv2 and IGMPv3.
  • A smaller response time allows the switch to learn multicast memberships more quickly but occupies more bandwidth and system resources.
  • This command has the same function as the igmp max-response-time command used in the interface view. The configuration in the IGMP view is globally valid, whereas the configuration in the interface view takes effect only for the specified interface. The configuration in the interface view takes precedence over the configuration in the IGMP view. The configuration in the IGMP view is used only when no configuration is performed in the interface view.

Example

# In the IGMP view, set the maximum response time for IGMP General Query messages to 8 seconds.

<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] igmp
[*HUAWEI-igmp] max-response-time 8

require-router-alert (IGMP)

Function

The require-router-alert command configures the switch to discard IGMP messages without the Router-Alert option.

The undo require-router-alert command disables the switch from checking for the Router-Alert option in IGMP messages.

By default, the switch does not check whether the received IGMP messages contain the Router-Alert option in IP headers, and it accepts all the received IGMP messages.

Format

require-router-alert

undo require-router-alert

Parameters

None

Views

IGMP view of public network instance or IGMP view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, a network device sends a packet to the corresponding protocol module for processing only when the destination address of the packet is a local interface address. Destination addresses of IGMP packets are multicast addresses but not interface addresses of multicast devices. Therefore, multicast devices do not send IGMP packets to the IGMP module, and the IGMP module cannot maintain group memberships.

The Router-Alert option in IP packet headers solves this problem. This option indicates that a packet needs to be sent to the protocol module.

You can configure the switch to accept only IGMP messages with the Router-Alert option. This configuration improves security of the IGMP service.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

This command has the same function as the igmp require-router-alert command used in the interface view. The configuration in the IGMP view is globally valid, whereas the configuration in the interface view takes effect only for the specified interface. The configuration in the interface view takes precedence over the configuration in the IGMP view. The configuration in the IGMP view is used only when no configuration is performed in the interface view.

Example

# In the IGMP view, configure the switch to discard IGMP messages without the Router-Alert option.

<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] igmp
[*HUAWEI-igmp] require-router-alert

reset igmp control-message counters

Function

The reset igmp control-message counters command clears statistics about IGMP messages.

Format

reset igmp [ vpn-instance vpn-instance-name | all-instance ] control-message counters [ interface interface-type interface-number ] [ message-type { query | report } ]

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Clears IGMP message statistics in a specified VPN instance.

The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.

all-instance Clears IGMP message statistics in all instances. -
interface interface-type interface-number Clears IGMP message statistics on a specified interface. If this parameter is not specified, the command clears IGMP statistics on all interfaces. -
message-type Clears statistics about IGMP messages of a specified type. If this parameter is not specified, the command clears statistics about all IGMP messages. -
query Clears statistics about Query messages received by an interface. -
report Clears statistics about Report messages received by an interface. -

Views

User view

Default Level

3: Management level

Usage Guidelines

IGMP still operates normally after IGMP message statistics are deleted.

Example

# Clear statistics about IGMP messages on all interfaces.

<HUAWEI> reset igmp control-message counters

# Clear statistics about IGMP messages on VLANIF100.

<HUAWEI> reset igmp control-message counters interface vlanif 100

reset igmp group

Function

The reset igmp group command deletes dynamic IGMP entries on interfaces.

Format

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

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Deletes dynamic IGMP entries in a specified VPN instance.

The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.

all-instance Deletes dynamic IGMP entries in all instances. -
all The first all deletes dynamic IGMP entries on all interfaces. The second all deletes all dynamic IGMP entries on a specified interface. -
interface interface-type interface-number Deletes dynamic IGMP entries on a specified interface. -
group-address Deletes dynamic IGMP entries of a specified group. The value ranges from 224.0.1.0 to 239.255.255.255, in dotted decimal notation.
mask Sets the mask of a multicast source address or group address. -
group-mask Specifies the mask of a multicast group address. The mask is in dotted decimal notation.
group-mask-length Specifies the mask length of a multicast group address. The value is an integer that ranges from 4 to 32.
source-address Specifies a multicast source address. The address is in dotted decimal notation.
source-mask Specifies the mask of a multicast source address. The mask is in dotted decimal notation.
source-mask-length Specifies the mask length of a multicast source address. The value is an integer that ranges from 0 to 32.

Views

User view

Default Level

3: Management level

Usage Guidelines

This command does not delete static group memberships configured on interfaces.

After IGMP entries on an interface are deleted, the interface can join the involved groups again.

After IGMP group memberships are cleared, group members may fail to receive multicast data. Therefore, confirm your operation before clearing IGMP group information.

Example

# Delete dynamic IGMP entries on all interfaces.

<HUAWEI> reset igmp group all

# Delete all dynamic IGMP entries on VLANIF100.

<HUAWEI> reset igmp group interface vlanif 100 all

# Delete the IGMP entries of group 225.0.0.1 on VLANIF100.

<HUAWEI> reset igmp group interface vlanif 100 225.0.0.1

# Delete IGMP entries of groups 225.1.1.0 to 225.1.1.255 on VLANIF100.

<HUAWEI> reset igmp group interface vlanif 100 225.1.1.0 mask 255.255.255.0
Related Topics

reset igmp group ssm-mapping

Function

The reset igmp group ssm-mapping command deletes group memberships established with SSM mapping.

Format

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

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Deletes group memberships established with SSM mapping in a specified VPN instance.

The value is a string of 1 to 31 case-sensitive characters except spaces. When double quotation marks are used to include the string, spaces are allowed in the string. The value _public_ is reserved and cannot be used as the VPN instance name.

all-instance Deletes group memberships established with SSM mapping in all instances. -
all

First all: deletes group memberships established with SSM mapping on all interfaces.

Second all: deletes all group membership established with SSM mapping on the specified interface.

-
interface interface-type interface-number Deletes group memberships established with SSM mapping on a specified interface. -
group-address Deletes the group membership established with SSM mapping for a specified group. The address is in dotted decimal notation and ranges from 224.0.1.0 to 239.255.255.255.
mask Sets the mask of a multicast group address. -
group-mask Specifies the mask of a multicast group address. The mask is in dotted decimal notation.
group-mask-length Specifies the mask length of a multicast group address. The value is an integer that ranges from 4 to 32.

Views

User view

Default Level

3: Management level

Usage Guidelines

You can use this command to delete group memberships established with SSM mapping.

After IGMP group memberships are cleared, group members may fail to receive multicast data. Therefore, confirm your operation before clearing IGMP group information.

Example

# Delete group memberships established with SSM mapping on all the interfaces.

<HUAWEI> reset igmp group ssm-mapping all

robust-count (IGMP)

Function

The robust-count command sets a global robustness variable for an IGMP querier.

The undo robust-count command restores the default robustness variable.

By default, the robustness variable of an IGMP querier is 2.

Format

robust-count robust-value

undo robust-count

Parameters

Parameter Description Value
robust-value Specifies the robustness variable of an IGMP querier. The value is an integer that ranges from 2 to 5.

Views

IGMP view of public network instance or IGMP view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The IGMP querier robustness variable specifies the retransmission count of IGMP packets to minimize impact of packet loss on the network.

On a shared network, a querier maintains IGMP-attached group memberships on an interface. The robustness variable determines the timeout interval of group memberships. The timeout interval of group memberships is calculated using the following formula:

Timeout interval of group memberships = Interval for sending IGMP General Query messages x Robustness variable + Maximum response time

The robustness variable determines the following values:

  • Number of times the queries sends General Query messages at startup

    When the querier starts, it sends General Query messages certain times specified by the robustness variable to query members of multicast groups. The interval for sending General Query messages during this process is 1/4 of the interval configured using the igmp timer query or timer query command.

  • In IGMPv2 and IGMPv3, the robustness variable determines the number of times the querier sends Group-Specific Query or Source-and-Group-Specific Query messages.

    When receiving an IGMP Leave message of a multicast group, the querier sends Group-Specific Query messages certain times specified by the robustness variable to check whether the group has members. When the querier receives a Report message indicating that source-group mapping changes, the querier sends Source-and-Group-Specific Query messages certain times specified by the robustness variable. The interval for sending Group-Specific Query messages and Source-and-Group-Specific Query messages can be set using the igmp lastmember-queryinterval or lastmember-queryinterval command.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

  • A larger robustness variable makes an IGMP querier more robust, but increases the timeout interval of group memberships.
  • This command has the same function as the igmp robust-count command used in the interface view. The configuration in the IGMP view is globally valid, whereas the configuration in the interface view is valid only for the current interface. The configuration in the interface view takes precedence over the configuration in the IGMP view. The configuration in the IGMP view is used only when no configuration is performed in the interface view.

Example

# In the IGMP view, set the robustness variable of an IGMP querier to 3.

<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] igmp
[*HUAWEI-igmp] robust-count 3

send-router-alert disable (IGMP)

Function

The send-router-alert disable command configures the switch to send IGMP messages without the Router-Alert option.

The undo send-router-alert disable command configures the switch to send IGMP messages with the Router-Alert option in IP headers.

By default, IGMP messages sent by the switch contain the Router-Alert option.

Format

send-router-alert disable

undo send-router-alert disable

Parameters

None

Views

IGMP view of public network instance or IGMP view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, IGMP messages sent by the switch contain the Router-Alert option in their IP headers. If the switch needs to communicate with a device that does not support the Router-Alert option, run the send-router-alert disable command to configure the switch to send IGMP messages without the Router-Alert option. The send-router-alert disable command is usually used together with the undo require-router-alert command.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

This command has the same function as the igmp send-router-alert disable command used in the interface view. The configuration in the IGMP view is globally valid, whereas the configuration in the interface view takes effect only for the specified interface. The configuration in the interface view takes precedence over the configuration in the IGMP view. The configuration in the IGMP view is used only when no configuration is performed in the interface view.

Example

# In the IGMP view, configure the switch to send IGMP messages without the Router-Alert option.

<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] igmp
[*HUAWEI-igmp] send-router-alert disable

ssm-mapping (IGMP)

Function

The ssm-mapping command configures an SSM mapping rule to map a multicast source to a group address.

The undo ssm-mapping command deletes an SSM mapping rule.

By default, no SSM mapping rule is configured.

Format

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

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

Parameters

Parameter Description Value
group-address Specifies a multicast group address. The value ranges from 224.0.1.0 to 239.255.255.255, in dotted decimal notation.
group-mask Specifies the mask of a multicast group address. The mask is in dotted decimal notation.
group-mask-length Specifies the mask length of a multicast group address. The value is an integer that ranges from 4 to 32.
source-address Specifies a multicast source address. The address is in dotted decimal notation.
static all Deletes all the configured static SSM mapping entries. -

Views

IGMP view of public network instance or IGMP view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Hosts that support only IGMPv1 and IGMPv2 cannot join SSM groups. To enable multicast devices to provide the SSM service for these hosts, configure SSM mapping on the multicast devices. An SSM mapping entry maps a multicast source to a multicast group. After SSM mapping entries are configured on a multicast device, the device can convert (*, G) information in Report messages of IGMPv1 and IGMPv2 to (S, G) information.

The default range of SSM group addresses is 232.0.0.0 to 232.255.255.255. You can use the ssm-policy command to change the address range. All multicast groups out of this range are ASM groups.

The configured SSM mapping entries take effect only after the igmp ssm-mapping enable command is run on the interface.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

  • You can run this command several times to configure multiple static SSM mapping entries.
  • To delete an SSM mapping entry, run the undo ssm-mapping group-address { group-mask | group-mask-length } source-address command. The undo ssm-mapping static all command deletes all the SSM mapping entries. Do not use this command unless necessary.

Example

# In the public network instance, configure an SSM mapping entry to map multicast source address 10.8.8.8 to group address 225.5.5.5/32.

<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] igmp
[*HUAWEI-igmp] ssm-mapping 225.5.5.5 32 10.8.8.8

timer other-querier-present (IGMP)

Function

The timer other-querier-present command sets the other querier present timer.

The undo timer other-querier-present command restores the default value of the other querier present timer.

The formula used to calculate the other querier present timer value is:

Other querier present timer = Robustness variable x Interval for sending IGMP General Query messages + 1/2 x Maximum response time for IGMP query messages

If the robustness variable, the interval for sending IGMP General Query messages, and the maximum response time for IGMP Query messages all use default values, the other querier present timer value is 125 seconds.

Format

timer other-querier-present interval

undo timer other-querier-present

Parameters

Parameter Description Value
interval Specifies the other querier present timer value. The value is an integer that ranges from 60 to 300, in seconds.

Views

IGMP view of public network instance or IGMP view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When a user network segment connects to multiple Layer 3 multicast devices, only one Layer 3 multicast device is elected as the IGMP querier to send Query messages to hosts on the network segment. If the querier fails to send Query messages, group memberships cannot be created or maintained. Non-queriers running IGMPv2 or IGMPv3 start the other querier present timer after they fail in the querier election. If the non-queriers do not receive Query messages from the querier before the timer times out, they consider the querier failed and start a new querier election.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

  • This command applies only to IGMPv2 and IGMPv3.
  • This command has the same function as the igmp timer other-querier-present command used in the interface view. The configuration in the IGMP view is globally valid, whereas the configuration in the interface view takes effect only for the specified interface. The configuration in the interface view takes precedence over the configuration in the IGMP view. The configuration in the IGMP view is used only when the configuration in the interface view is not done.

If the other querier present timer value is shorter than the interval for sending IGMP General Query messages, the querier election is triggered frequently.

Example

# In the IGMP view, set the other querier present timer to 200 seconds.

<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] igmp
[*HUAWEI-igmp] timer other-querier-present 200

timer query (IGMP)

Function

The timer query command sets a global interval for sending IGMP General Query messages.

The undo timer query command restores the default interval for sending IGMP General Query messages.

By default, the interval for sending IGMP General Query messages is 60 seconds.

Format

timer query interval

undo timer query

Parameters

Parameter Description Value
interval Specifies the interval for sending IGMP General Query messages The value is an integer that ranges from 1 to 18000, in seconds.

Views

IGMP view of public network instance or IGMP view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

An IGMP querier sends IGMP General Query messages at an interval to check whether a local network segment has group members. This interval is the general query interval. You can set the general query interval based on situations on your network. The general query interval affects the following processes:

  • When the querier starts, it sends General Query messages certain times specified by the robustness variable to query members of multicast groups. The message sending interval during this process is 1/4 of the interval for sending General Query messages. The robustness variable is configured using the igmp robust-count or robust-count command.

  • After the startup process is complete, the querier sends General Query messages at intervals to maintain the group memberships on the interface.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

  • The default general query interval is 60 seconds, which is different than the default value 125 seconds defined by RFC documents. A Huawei querier and a non-Huawei querier must send IGMP general query messages at the same interval.

  • The querier is more sensitive when it sends General Query messages at a shorter interval. However, more bandwidth and switch resources are consumed in this case.
  • This command has the same function as the igmp timer query command used in the interface view. The configuration in the IGMP view is globally valid, whereas the configuration in the interface view takes effect only for the specified interface. The configuration in the interface view takes precedence over the configuration in the IGMP view. The configuration in the IGMP view is used only when no configuration is performed in the interface view.

Example

# In the IGMP view, set the global interval for sending IGMP General Query messages to 125 seconds.

<HUAWEI> system-view
[~HUAWEI] multicast routing-enable
[*HUAWEI] igmp
[*HUAWEI-igmp] timer query 125
Translation
Download
Updated: 2019-03-21

Document ID: EDOC1000166501

Views: 52011

Downloads: 339

Average rating:
This Document Applies to these Products
Related Documents
Related Version
Share
Previous Next