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

AR500, AR510, and AR530 V200R007 Commands Reference

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:

AR502G-L-D-H and AR502GR-L-D-H do not support this function.

display default-parameter igmp

Function

The display default-parameter igmp command displays default IGMP configurations.

Format

display default-parameter igmp

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

This command displays default IGMP parameter settings even if IGMP parameters have been modified. Therefore, you can use this command to check which parameters have been modified.

Example

# Display default IGMP configurations.

<Huawei> display default-parameter igmp
  IGMP View Default Configurations:
  ---------------------------------
  Lastmember-queryinterval: 1 s
  Max-response-time: 10 s
  Require-router-alert: disabled
  Robust-count: 2
  Send-router-alert: enabled
  Ssm-mapping: disabled
  Timer other-querier-present: 125 s
  Timer query: 60 s

  Interface View Default Configurations:
  --------------------------------------
  Group-policy: disabled
  Lastmember-queryinterval: 1 s
  Lastmember-query time: 2 s
  Max-response-time: 10 s
  Other-querier-present-timer-expiry: off
  Prompt-leave: disabled
  Require-router-alert: disabled
  Robust-count: 2
  Send-router-alert: enabled
  Ssm-mapping: disabled
  Startup-query-timer-expiry: off
  Static-group: disabled
  Timer other-querier-present: 125 s
  Timer query: 60 s
  Version: 2
  Ip-source-policy: disabled
Table 9-1  Description of the display default-parameter igmp command output

Item

Description

IGMP View Default Configurations

Default configurations in the IGMP view. The default configurations take effect globally.

Lastmember-queryinterval

Interval for sending IGMP Group-Specific Query messages. This parameter is configured using the lastmember-queryinterval (IGMP view) command in the IGMP view or the igmp lastmember-queryinterval command in the interface view.

Max-response-time

Maximum response time for IGMP Query messages. This parameter is configured using the max-response-time (IGMP view) command in the IGMP view or the igmp max-response-time command in the interface view.

Require-router-alert

Whether the device checks for the Router-Alert option in the received IGMP message. This parameter is configured using the require-router-alert (IGMP view) command in the IGMP view or the igmp require-router-alert command in the interface view.

Robust-count

Robustness variable of an IGMP querier. This parameter is configured using the robust-count (IGMP view) command in the IGMP view or the igmp robust-count command in the interface view.

Send-router-alert

Whether the IGMP messages sent from the device carry the Router-Alert option. This parameter is configured using the send-router-alert (IGMP view) command in the IGMP view or the igmp send-router-alert command.

Ssm-mapping

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

Timer other-querier-present

Length of the other querier present timer. This parameter is configured using the timer other-querier-present (IGMP view) command in the IGMP view or the igmp timer other-querier-present command in the interface view.

Timer query

Interval for sending IGMP General Query messages. This parameter is configured using the timer query (IGMP view) command in the IGMP view or the igmp timer query command in the interface view.

Interface View Default Configurations

Default configurations in the interface view. The configurations take effect only for IGMP-enabled interfaces.

Group-policy

Whether a multicast group filtering policy is configured. A multicast group filtering policy is configured using the igmp group-policy command.

Lastmember-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.

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.

Prompt-leave

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

Startup-query-timer-expiry

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 expressed in seconds and is 1/4 of the query interval (Timer query).

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

Static-group

Whether static multicast groups are configured. A static multicast group is configured using the igmp static-group command.

Version

IGMP version number. IGMP has three versions: IGMPv1, IGMPv2, and IGMPv3, which is configured using the igmp version 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.

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, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

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 GE0/0/1.

<Huawei> display igmp control-message counters interface gigabitethernet 0/0/1
Interface message counter information of VPN-Instance: public net
 GigabitEthernet0/0/1(192.168.2.1):
 Message Type                Sent        Valid       Invalid     Ignore
 ------------------------------------------------------------------
 General Query               280         0           0           0
 Group Query                 0           0           0           0
 Source Group Query          0           0           0           0
 ------------------------------------------------------------------
 IGMPV1V2
 Report ASM                  0           279         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 9-2  Description of the display igmp control-message counters interface gigabitethernet 0/0/1 command output

Item

Description

Interface message counter information of VPN-Instance: public net

VPN instance to which the interface belongs.

GigabitEthernet0/0/1(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 explicit-tracking

Function

The display igmp explicit-tracking command displays explicit (S, G) entries of IGMPv3 hosts, that is, (S, G) entries that IGMPv3 hosts have joined in Include mode.

Format

display igmp [ vpn-instance vpn-instance-name | all-instance ] explicit-tracking [ interface interface-type interface-number [ host-address host-address | group group-address source source-address ] ]

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Displays information about IGMPv3 hosts that join a specified multicast source in INCLUDE mode in a specified VPN instance.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

all-instance Displays information about IGMPv3 hosts that join a specified multicast source in INCLUDE mode in all instances. -
interface interface-type interface-number Displays information about IGMPv3 hosts that join a specified multicast source in INCLUDE mode on a specified interface. -
host-address host-address Specifies the address of an IGMP host. The address is in dotted decimal notation.
group group-address Specifies the address of a multicast group. The value ranges from 224.0.1.0 to 239.255.255.255, in dotted decimal notation.
source source-address Specifies the address of a multicast source. The address is in dotted decimal notation.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

None

Example

# Display information about the IGMPv3 hosts that join the specific source/group in INCLUDE mode.

<Huawei> display igmp explicit-tracking
Explicit-tracking information of VPN-Instance: public net
 Total 1 host, 2 entries

 GigabitEthernet0/0/1(192.168.0.12)
  0001.Host: 192.168.0.28
        Uptime: 00:02:47
        Expires: 00:01:33
        (S, G) List:
          Group: 232.1.1.1
              Source: 10.12.12.12
                Uptime: 00:02:47
                Time since last refresh: 00:02:47
              Source: 10.13.13.13
                Uptime: 00:02:47
                Time since last refresh: 00:02:47
Table 9-3  Description of the display igmp explicit-tracking command output

Item

Description

Explicit-tracking information of VPN-Instance

VPN instance to which IGMP host information belongs.

Total 1 host, 2 entries

There is one IGMP host and two (S, G) entries.

GigabitEthernet0/0/1(192.168.0.12)

Type, number, and IP address of an interface.

Host

IGMP host address.

Uptime

Running time since an IGMP host joins a multicast 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.

Expires

Amount of time left before an IGMP host times out. After the IGMP host expires, it is deleted from the IGMP member host list. 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.

(S, G) List

List of multicast sources and groups an IGMP host has joined.

Group

Multicast group address.

Source

Multicast source address.

Time since last refresh

Amount of time since an IGMP host last joins 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.

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, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

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
 GigabitEthernet0/0/1(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: -
 GigabitEthernet0/0/1(10.1.6.2):
  Total entry on this interface: 1
  Limited entry on this interface: -
  Total 1 IGMP Group reported
   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 9-4  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.

GigabitEthernet0/0/1(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 1 IGMP Group reported

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.

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, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

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 entries established with SSM mapping. If the parameter is not specified, the command displays only the summary of group entries 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: -
 GigabitEthernet0/0/1(192.167.101.1):
  Total 1 IGMP SSM-Mapping Group reported
   Group Address   Last Reporter   Uptime      Expires
   232.0.0.1       192.167.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: -
 GigabitEthernet0/0/1(192.167.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.167.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
Table 9-5  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.

GigabitEthernet0/0/1(192.167.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.

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 ] static [ up | down ] [ verbose ]

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

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

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

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, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

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.
up | down Displays information about interfaces in Up or Down state. If this parameter is not specified, the command displays all interfaces in IGMP entries. -
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. -
interface-number Displays the number of interfaces in a static IGMP group. -
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. -
entry-number Displays the number of static IGMP groups on an interface. -

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
 Total 2 entries, Total 2 active entries
  Group Address   Source Address  Interface          State     Expires
  225.1.1.1       10.1.1.1        GE0/0/1            UP        never
  225.1.1.2       10.1.1.1        GE0/0/2            UP        never
Table 9-6  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.

Total 2 entries, Total 2 active entries

Number of static IGMP entries and active IGMP entries on the interface.

Group Address

Multicast group address.

Source Address

Multicast source address.

Interface

Interface type and number.

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
 Total 2 entries
  00001.(*, 225.1.1.1)
      Total List of 1 joined interface
      1.GigabitEthernet0/0/1
          State:             UP
          Reference Count:   1
          Multicast Boundary:NO
          Outgoing Interface:YES
  00002.(*, 225.1.1.2)
      Total List of 1 joined interface
      1.GigabitEthernet0/0/2
          State:             UP
          Reference Count:   1
          Multicast Boundary:NO
          Outgoing Interface:YES 
Table 9-7  Description of the display igmp group static verbose command output

Item

Description

Static join group information of VPN-Instance

VPN instance to which static IGMP groups belong.

Total 2 entries

Number of static IGMP entries on the interface.

00001.(*, 225.1.1.1)

(*, G) entry ID.

Total List of 1 joined interface

Downstream interface list of the (*, G) entry.

1.GigabitEthernet0/0/1

Interface type and interface number.

State

Status of an interface, which can be:
  • UP: The interface is operating normally.
  • DOWN: An error occurs on the physical link of the interface.

Reference Count

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

Multicast Boundary

Whether the multicast forwarding boundary is configured.

Outgoing Interface

Whether downstream interfaces exist.

# Display lists of Up interfaces in static IGMP entries.

<Huawei> display igmp group static up
Static join group information of VPN-Instance: public net
 Total 4 entries
  00001.(*,225.1.1.1)
      Total List of 2 joined interfaces
      Total Matched 2 interfaces
      1.GigabitEthernet0/0/1
      2.GigabitEthernet0/0/2
  00002.(*,225.1.1.2)
      Total List of 2 joined interfaces
      Total Matched 2 interfaces
      1.GigabitEthernet0/0/1
      2.GigabitEthernet0/0/2
Table 9-8  Description of the display igmp group static up command output

Item

Description

Total List of 2 joined interfaces

Number of interfaces in a static group.

Total Matched 2 interfaces

List of Up interfaces in a static group.

# Display information about IGMP groups statically configured on GE0/0/1.

<Huawei> display igmp group interface gigabitethernet 0/0/1 static
Static join group information of VPN-Instance: public net
 Total 2 entries
 Specified interface state:UP
 Total 2 entries matched
   Group Address   Source Address  Expires
   226.0.0.1       10.0.5.120      never
   226.0.0.2       0.0.0.0         never 
Table 9-9  Description of the display igmp group interface gigabitethernet 0/0/1 static command output

Item

Description

Static join group information of VPN-Instance

VPN instance to which static IGMP groups belong.

Total 2 entries

Number of static IGMP entries on the interface.

Specified interface state

Status of the specified interface.

Total 2 entries matched

Number of IGMP groups that meet the query conditions.

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, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

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 GE0/0/1.

<Huawei> display igmp interface gigabitethernet 0/0/1
Interface information of VPN-Instance: public net
 GigabitEthernet0/0/1(192.168.1.2):
   IGMP is enabled
   Current IGMP version is 2
   IGMP state: up
   IGMP group policy: none
   IGMP limit: -
   Value of query interval for IGMP (negotiated): -
   Value of query interval for IGMP (configured): 60 s
   Value of other querier timeout for IGMP: 0 s
   Value of 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
 GigabitEthernet0/0/1(192.168.1.2):
   IGMP is enabled
   Current IGMP version is 2
   IGMP state: up
   IGMP group policy: none
   IGMP limit: -
   Value of query interval for IGMP (negotiated): -
   Value of query interval for IGMP (configured): 60 s
   Value of other querier timeout for IGMP: 0 s
   Value of maximum query response time for IGMP: 10 s
   Value of last member query time: 2 s
   Value of last member query interval: 1 s
   Value of startup query interval: 15 s
   Value of 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 9-10  Description of the display igmp interface verbose command output

Item

Description

Interface information of VPN-Instance

VPN instance to which IGMP interface information belongs.

GigabitEthernet0/0/1(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.

IGMP limit

Maximum number of IGMP group memberships that the current interface can maintain. This parameter is configured using the igmp limit command.

Value of query interval for IGMP (negotiated)

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

Value of query interval for IGMP (configured)

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

Value of 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.

Value of 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.

Value of 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.

Value of 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.

Value of 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 is 1/4 of the query interval configured using the igmp timer query command. The startup query interval is not defined in IGMPv1.

Value of 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 industrial switch router 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 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, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

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 [ vpn-instance vpn-instance-name | all-instance ] invalid-packet command to view statistics about invalid IGMP messages received in a specified VPN instance or in all VPN instances.

  • 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 9-11  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           :  GigabitEthernet0/0/1
Time                :  2010-06-09 11:03:51 UTC-08:00
Message Length      :  24
Invalid Type        :  Invalid Multicast Group
0000: 16 3c 00 00 01 34 04 04
-----------------------------------------------------
Table 9-12  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.

0000: 16 3c 00 00 01 34 04 04

Contents of the invalid IGMP message.

display igmp proxy group

Function

The display igmp proxy group command displays information about IGMP proxy groups.

Format

display igmp proxy [ vpn-instance vpn-instance-name | all-instance ] group [ group-address ] [ verbose ]

Parameters

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

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

all-instance Displays information about IGMP proxy groups in all VPN instances. -
group-address Specifies a multicast group address. If you specify group-address in this command, the command displays information about a specified multicast group. The value ranges from 224.0.1.0 to 239.255.255.255, in dotted decimal notation.
verbose Displays detailed information about IGMP proxy groups. If you specify verbose in this command, the command displays status parameters of IGMP groups. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To check the status of an IGMP proxy group or find out the cause of a fault in an IGMP proxy group, run the display igmp proxy group command to view information about the IGMP proxy group.

Example

# Display information about IGMP proxy groups in a public network instance.
<Huawei> display igmp proxy group
Interface group report information of VPN-Instance: public net
    GigabitEthernet1/0/0(10.1.6.2):
     Total 2 IGMP proxy Groups 
      Group Address   Filter mode
      225.1.1.1       exclude             
      225.1.1.2       include
Table 9-13  Description of the display igmp proxy group command output

Item

Description

Interface group report information of VPN-Instance

VPN instance to which IGMP group information on an interface belongs.

GigabitEthernet1/0/0(10.1.6.2)

Interface number (IP address).

Total 2 IGMP proxy Groups

Total two IGMP proxy groups on an interface.

Group Address

Multicast group address.

Filter mode

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

# Display details of IGMP proxy groups in a public network instance.
<Huawei> display igmp proxy group verbose
Interface group report information of VPN-Instance: public net
       GigabitEthernet1/0/0(10.1.6.2): 
        Total 2 IGMP proxy Groups 
        Group: 225.1.1.1               
          Filter mode: exclude 
          Query Response Expiry: 00:00:02   
          Source list (total 1 source) 
             Source: 2.1.1.1
        Group: 225.1.1.2            
          Filter mode: include   
          Query Response Expiry: off   
          Source list (total 1 source) 
             Source: 2.1.1.2
Table 9-14  Description of the display igmp proxy group verbose command output

Item

Description

Query Response Expiry

Amount of time before the query response time expires.

Source list (total 1 source)

Source list (number of sources in the source list).

Source

Multicast source address.

Group

Multicast group address.

display igmp proxy interface

Function

The display igmp proxy interface command displays information about IGMP proxy interfaces.

Format

display igmp proxy [ vpn-instance vpn-instance-name | all-instance ] interface

NOTE:

Only V200R008C50 and later versions support interface-type interface-number.

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Displays information about IGMP proxy interfaces in a specific VPN instance. If neither vpn-instance nor all-instance is specified, the command displays only IGMP proxy interfaces in the public network instance.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

all-instance Displays information about IGMP proxy interfaces in all VPN instances. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To check the status of an IGMP proxy interface or find out the cause of a fault in an IGMP proxy interface, run the display igmp proxy interface command to view information about the IGMP proxy interface.

Example

# Display information about IGMP proxy interfaces in a public network instance.
<Huawei> display igmp proxy interface
Interface information of VPN-Instance: public net
 GigabitEthernet1/0/0(192.168.1.2):
   IGMP proxy is enabled
   Current IGMP proxy version (negotiated) is 3
   Current IGMP proxy version (configured) is 2
   IGMP proxy state: up
   Value of query interval for IGMP (negotiated): 60 s
   Value of query interval for IGMP (configured): 60 s
   Value of querier present timeout for IGMPv1: off
   Value of querier present timeout for IGMPv2: off
   Value of querier present timeout for IGMPv3: 124 s
   General query response expiry: off
   Querier for IGMP: 192.168.1.1
   Robustness (negotiated): 2
   Robustness (configured): 2
   Require-router-alert: disabled
   Send-router-alert: enabled
   Ip-source-policy: disabled
   Query Ip-source-policy: disabled
Table 9-15  Description of the display igmp proxy interface command output

Item

Description

Interface information of VPN-Instance

VPN instance to which IGMP proxy interface information belongs.

GigabitEthernet1/0/0(192.168.1.2)

Interface number (IP address).

IGMP proxy is enabled

IGMP proxy is enabled on the interface.

Current IGMP proxy version (negotiated) is 3

Negotiated IGMP version on the IGMP proxy interface is IGMPv3.

Current IGMP proxy version (configured) is 2

IGMPv2 is configured on the IGMP proxy interface.

IGMP proxy state

Status of the IGMP proxy interface, which can be Up or Down.

Value of query interval for IGMP (negotiated)

Query interval negotiated between the query interval configured on the IGMP proxy interface and the query interval carried in a Query message, in seconds. Only IGMPv3 Query messages carry this field. This field takes effect only in IGMPv3.

Value of query interval for IGMP (configured)

Interval at which the IGMP proxy interface sends IGMP Query messages, in seconds.

Value of querier present timeout for IGMPv1

Timeout period of an IGMPv1 querier.

Value of querier present timeout for IGMPv2

Timeout period of an IGMPv2 querier.

Value of querier present timeout for IGMPv3

Timeout period of an IGMPv3 querier.

General query response expiry

Timeout period of a general group query timer.

Querier for IGMP

Address of an IGMP querier. In IGMPv1, a querier is selected based on a multicast routing protocol; in IGMPv2 and IGMPv3, the industrial switch router with the lowest IP address acts as the querier on the shared network segment. If no querier exists, this field is displayed as "-".

Robustness (negotiated)

Robustness variable negotiated between the robustness variable configured on an IGMP proxy interface and the robustness variable carried in a Query message. This field takes effect only in IGMPv3.

Robustness (configured)

Robustness variable configured on the IGMP proxy interface.

Require-router-alert

Whether the device accepts only IGMP messages carrying the Router-Alert option.

Send-router-alert

Whether the device sends IGMP messages carrying the Router-Alert option.

Ip-source-policy

Whether to filter IGMP Report/Leave messages based on host addresses.

Query Ip-source-policy

Whether to filter IGMP Query messages based on source addresses.

display igmp proxy routing-table

Function

The display igmp proxy routing-table command displays information about an IGMP proxy routing table.

Format

display igmp proxy [ vpn-instance vpn-instance-name | all-instance ] routing-table [ group-address [ mask { group-mask-length | group-mask } ] | source-address [ mask { source-mask-length | source-mask } ] | outgoing-interface { include | exclude | match } { interface-type interface-number | none } | flags flag-value | fsm ] * [ outgoing-interface-number [ number ] ]

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Displays information about an IGMP proxy routing table in a specific VPN instance. If you specify neither vpn-instance nor all-instance in this command, the command displays only the IGMP proxy routing table in the public network instance.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

all-instance Displays information about IGMP proxy routing tables in all VPN instances. -
group-address Displays information about the routing entry of a specified group. The value ranges from 224.0.1.0 to 239.255.255.255, in dotted decimal notation.
mask Indicates the mask of a multicast group address or a source address. -
group-mask-length Specifies the mask length of a multicast group address. The value is an integer that ranges from 4 to 32.
group-mask Specifies the mask of a multicast group address. The value is in dotted decimal notation.
source-address Displays the routing entry for a multicast source. The value 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.
source-mask Specifies the mask of a multicast source address. The value is in dotted decimal notation.
outgoing-interface Displays the routing entries with a specific interface as the outbound interface. -
include Displays the routing entries of which the downstream interface list has a specific interface. -
exclude Displays the routing entries of which the downstream interface list does not have a specific interface. -
match Displays the routing entries of which the downstream interface list has only a specific interface. -
interface-type interface-number Specifies the type and number of an interface. -
none Displays the routing entries with an empty downstream interface list. -
flags flag-value Indicates an IGMP proxy routing entry with a specific type. flag-value specifies the flag of a routing entry. If you specify flags flag-value in this command, the command displays IGMP proxy routing entries with the flag. flag-value can be act, del, join, none, niif, sgjoin, wcjoin, upchg, or wc. For information about each value, see the flag-value field description in the display pim routing-table command output.
fsm Displays detailed information about a finite state machine (FSM). -
outgoing-interface-number Displays the number of downstream interfaces in an IGMP proxy routing entry. -
number Specifies the number of downstream interfaces in an entry to be queried. The value is an integer that ranges from 0 to 2048.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

If you need to know information about an IGMP proxy routing table, run the display igmp proxy routing-table command. You can specify different parameters in this command to view specific routing information. This command helps you find specific routes and locate faults.

Example

# Display details of an FSM in an IGMP proxy routing table in a public network instance.
<Huawei> display igmp proxy routing-table fsm
Routing table of VPN-Instance: public net
 Total 1 (*, G) entry; 1 (S, G) entry    
                                                
 (*, 225.1.1.1)
     Flag: WC, UpTime: 6d:10h
     Upstream interface: GigabitEthernet1/0/2
     Downstream interface(s) information:
     Total number of downstreams: 1
         1: GigabitEthernet1/0/1
             Protocol: igmp, UpTime: 17:27:13
             IGMP querier: 11.1.1.1(this router)
             IGMP state: EXCLUDE

     FSM information for non-downstream interfaces: None

 (33.3.3.100, 225.1.1.1)
     Flag: JOIN ACT, UpTime: 6d:17h
     Upstream interface: GigabitEthernet1/0/2
     Downstream interface(s) information:
     Total number of downstreams: 1
         1: GigabitEthernet1/0/1
             Protocol: igmp, UpTime: 17:27:13
             IGMP querier: 11.1.1.1(this router)
             IGMP state: NI

     FSM information for non-downstream interfaces: None
Table 9-16  Description of the display igmp proxy routing-table fsm command output

Item

Description

Routing table of VPN-Instance

VPN instance to which IGMP proxy routing information belongs.

Total 1 (*, G) entry; 1 (S, G) entry

Total number of (*, G) and (S, G) entries in the IGMP proxy routing table.

(*, 225.1.1.1)

(*, G) or (S, G) entry in the IGMP proxy routing table.

Flag

Flag of a (*, G) or an (S, G) entry in the IGMP proxy routing table.

UpTime

Amount of time since a (*, G) or an (S, G) entry is created.

Upstream interface

Upstream interface of a (*, G) or an (S, G) entry.

Downstream interface(s) information

Information about downstream interfaces.

Total number of downstreams

Total number of downstream interfaces.

GigabitEthernet1/0/1

Name of a downstream interface.

Protocol

Protocol of a downstream interface.

UpTime

Amount of time a downstream interface has been in Up state, expressed in hh:mm:ss format.

IGMP querier

Address of an IGMP querier

IGMP state

IGMP status on a downstream interface:

  • NI: indicates that an (S, G) entry inherits the downstream interfaces of a (*, G) entry.
  • BLOCK: indicates that the interface does not forward traffic based on an (S, G) entry.
  • INCLUDE: indicates that the interface needs to join the specified group and source.
  • EXCLUDE: indicates that the interface does not join the specified group and source.

FSM information for non-downstream interfaces

Interfaces that do not forward multicast data packets matching (*, G) or (S, G) entries.

display igmp routing-table

Function

The display igmp routing-table command displays the IGMP routing table.

Format

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

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Displays IGMP routing information in a specified VPN instance.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

all-instance Displays IGMP routing information in all instances. -
group-address Displays IGMP routing information of a specified multicast group. The address is in dotted decimal notation and ranges from 224.0.1.0 to 239.255.255.255.
mask Indicates the mask of a multicast group address or a multicast source address. -
group-mask Specifies the mask of a multicast group address. It is in dotted decimal notation.
group-mask-length Specifies the mask length of a multicast group address. It is an integer that ranges from 4 to 32.
source-address Displays IGMP routing information of a specified multicast source. It is in dotted decimal notation.
source-mask Specifies the mask of a multicast source address. It is in dotted decimal notation.
source-mask-length Specifies the mask length of a multicast source address. It is an integer that ranges from 0 to 32.
static Displays static IGMP routing entries. -
outgoing-interface-number Displays the number of the outbound interfaces in IGMP routing entries. -
number Specifies the number of outbound interfaces. If this parameter is specified, the command displays the specified number of outbound interfaces. The value is an integer that ranges from 1 to 2048.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The display igmp routing-table command provides IGMP routing information. You can specify different parameters to view specific IGMP routing information for problem location.

NOTE:

This command provides output information only when PIM is not enabled on the IGMP-capable interface.

Example

# Display the IGMP routing table.

<Huawei> display igmp routing-table
Routing table of VPN-Instance: public net                                      
 Total 2 entries                                                                
                                                                                
 00001. (10.10.10.10, 232.1.1.3)                                                
       List of 1 downstream interface in include mode                           
        GigabitEthernet0/0/1 (10.20.20.1),                                                  
                   Protocol: SSM-MAP                                            
                                                                                
 00002. (*, 225.1.1.1)                                                    
       List of 1 downstream interface                                           
        GigabitEthernet0/0/1 (10.20.20.1),                                                  
                   Protocol: IGMP                                               
Table 9-17  Description of the display igmp routing-table command output

Item

Description

Routing table of VPN-Instance: public net

VPN instance to which the IGMP routing table belongs.

Total 2 entries

Total number of IGMP routing entries.

00001. (10.10.10.10, 232.1.1.3)

Entry 00001. (S, G) indicates that data is transmitted from S to G. (*, G) indicates that data is transmitted from any source to G.

List of 1 downstream interface in include mode

Downstream interface list in include mode.

GigabitEthernet0/0/1 (10.20.20.1)

Interface type and interface number (IP address).

Protocol

Protocol type, including:
  • SSM-MAP: Entries are generated using SSM mapping.
  • IGMP: Entries are generated using IGMP.
  • STATIC: Entries are generated by configuring static IGMP groups.

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, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

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 2 entries    2 entries matched

 00001. (10.1.0.2, 225.1.1.0/24)

 00002. (10.1.0.2, 239.255.255.0/24)

 Total 2 entries matched
Table 9-18  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 2 entries 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/24)

00002. (10.1.0.2, 239.255.255.0/24)

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 GE0/0/1.

<Huawei> display igmp ssm-mapping interface gigabitethernet 0/0/1
IGMP SSM-Mapping is enabled
Table 9-19  Description of the display igmp ssm-mapping interface gigabitethernet 0/0/1 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, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

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

  • If PIM and IGMP need to be enabled on the same interface, enable PIM, and then IGMP.
  • If IGMP parameters are configured on an interface, the parameter settings take effect only after IGMP is enabled.

Example

# Enable IGMP on GE0/0/1 connected to a user network segment.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] igmp enable

igmp global limit

Function

The igmp global limit command sets the maximum number of IGMP entries that can be created on the industrial switch router.

The undo igmp global limit command deletes the configured maximum number of IGMP entries.

By default, the maximum number of IGMP entries that can be created on the industrial switch router varies according to device models:

  • AR503GW-LM7, AR503GW-LM7, AR509G-L-D-H, AR509GW-L-D-H, AR510 series: 3000
  • AR502G-L-D-H, AR502GR-L-D-H, AR530 series: 256

Format

igmp global limit number

undo igmp global limit

Parameters

Parameter Description Value
number Specifies the maximum number of IGMP entries that can be created on the industrial switch router.

The value is an integer that ranges from:

  • AR503GW-LM7, AR503GW-LM7, AR509G-L-D-H, AR509GW-L-D-H, AR510 series: 1 to 3000
  • AR502G-L-D-H, AR502GR-L-D-H, AR530 series: 1 to 256

Views

System view

Default Level

2: Configuration level

Usage Guidelines

When the number of IGMP entries reaches the limit, the system does not create any IGMP entries. To enable the industrial switch router to create new IGMP entries, useless entries or increase the limit. Alternatively, you can configure static IGMP entries.

The number of IGMP entries is counted as follows:
  • Each (*, G) entry is counted as one entry.

  • Each (S, G) entry is counted as one entry.

  • Each (*, G) entry established with SSM mapping is counted as one entry.

Example

# Set the maximum number of IGMP entries that can be created on the industrial switch router to 126.

<Huawei> system-view
[Huawei] igmp global limit 126

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 named ACL.
NOTE:
acl-name acl-name can only be the name of a named advanced ACL.

The value is a string of 1 to 32 case-sensitive characters without spaces. The value must start with a letter (a to z or A to Z, 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 industrial switch router 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 industrial switch router, the industrial switch router 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 GE0/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-acl-basic-2005] rule permit source 225.1.1.1 0
[Huawei-acl-basic-2005] quit
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] 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 GE0/0/1 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-acl-adv-myacl] rule permit ip destination 225.1.0.0 0.0.255.255
[Huawei-acl-adv-myacl] quit
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] igmp group-policy acl-name myacl

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 industrial switch router 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 an ACL.
NOTE:
acl-name acl-name can only be the name of a named advanced ACL.

The value is a string of 1 to 32 case-sensitive characters without spaces. The value must start with a letter (a to z or A to Z, 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. To improve security, 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 industrial switch router to check the source address in the IP header of each received Report/Leave message. The industrial switch router 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 industrial switch router 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 industrial switch router 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 GE0/0/1.
<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] igmp ip-source-policy
# Configure GE0/0/1 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-acl-basic-2001] rule permit source 10.10.1.1 0
[Huawei-acl-basic-2001] quit
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] igmp ip-source-policy 2001

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 and 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 is globally valid in the instance, whereas the configuration in the interface view is valid only for the current interface. The system prefers the configuration in the interface view. The configuration in the IGMP view is used only when the configuration in the interface view is incomplete.

Example

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

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] igmp lastmember-queryinterval 3

igmp limit

Function

The igmp limit command sets the maximum number of IGMP group memberships allowed on an interface.

The undo igmp limit command restores the maximum number of IGMP group memberships allowed on an interface to the default value.

By default, the maximum of IGMP entries that can be created on an interface is specified by number.

Format

igmp limit number [ except { acl-number | acl-name acl-name } ]

undo igmp limit

Parameters

Parameter Description Value
number Specifies the maximum number of IGMP entries allowed on an interface.

The value is an integer that ranges from

  • AR503GW-LM7, AR503GW-LM7, AR509G-L-D-H, AR509GW-L-D-H, AR510 series: 1 to 1000
  • AR502G-L-D-H, AR502GR-L-D-H, AR530 series: 1 to 64
except Specifies the range of multicast groups whose IGMP entries are not limited by the IGMP limit. -
acl-number Specifies a basic ACL or an advanced ACL. The value is an integer. The basic ACL number ranges from 2000 to 2999. A basic ACL filters group addresses only. The advanced ACL number ranges from 3000 to 3999. An advanced ACL filters (S, G) entries as well as group addresses.
acl-name acl-name Specifies the name of a named ACL.
NOTE:
acl-name acl-name can only be the name of a named advanced ACL.

The value is a string of 1 to 32 case-sensitive characters without spaces. The value must start with a letter (a to z or A to Z, case sensitive).

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

When the number of IGMP entries reaches the limit, the system does not create any IGMP entries. To allow the industrial switch router to create more IGMP entries, delete useless entries or increase the limit. Alternatively, you can configure static IGMP entries.

The number of IGMP entries is counted as follows:
  • Each (*, G) entry is counted as one entry.

  • Each (S, G) entry is counted as one entry.

  • Each (*, G) entry for SSM mapping is counted as one entry.

Prerequisites

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

Precautions

If except is not specified in the command, the configured IGMP limit restricts the maximum number of all dynamic IGMP (*, G) or (S, G) entries. Before setting except, configure the associated ACL. The interface then uses the ACL to filter the received IGMP Report messages. The number of entries corresponding to the multicast groups that match the ACL is not limited.

The igmp limit command must be used with ACL configuration commands. When configuring ACL rules, note that:
  • In the basic ACL view, specify the source parameter in the rule command to set the range of multicast groups whose IGMP entries are not limited.
  • In the advanced ACL view, specify the source parameter in the rule command to set the range of sources that send multicast data to the multicast groups. Specify the destination parameter to set the range of multicast groups whose IGMP entries are not limited.

Example

# Set the maximum number of IGMP entries that can be created on the GE0/0/1 to 60.
<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] igmp limit 60
# Create a named ACL myacl, and configure a rule that allows hosts to receive messages sent from multicast source 10.1.1.1 to multicast group 232.0.0.0/16. Set the maximum number of IGMP entries that can be created on the GE0/0/1 to 60, and exclude multicast group 232.0.0.0/16 whose IGMP entries do not need to be limited.
<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] acl name myacl
[Huawei-acl-adv-myacl] rule permit ip source 10.1.1.1 0 destination 232.0.0.0 0.0.255.255
[Huawei-acl-adv-myacl] quit
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] igmp limit 60 except acl-name myacl

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, except for the function range. The configuration in the IGMP view is globally valid, whereas the configuration in the interface view is valid only for the current interface. The system prefers the configuration in the interface view. The configuration in the IGMP view is used only when the configuration in the interface view is not done.

Example

# Set the maximum response time for IGMP General Query messages to 8 seconds on GE0/0/1.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/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.
  • If dynamic IGMP entries have been generated on the querier, run the reset igmp group command to clear these dynamic IGMP entries before running the igmp on-demand command.
  • 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 GE0/0/1.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/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 named ACL.
NOTE:
acl-name acl-name can only be the name of a named advanced ACL.

The value is a string of 1 to 32 case-sensitive characters without spaces. The value must start with a letter (a to z or A to Z, 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 GE1/0/0 so that the entry of group 225.1.0.0/16 will be delete immediately after the interface receives an IGMP Leave message for the group GE0/0/1.

<Huawei> system-view
[Huawei] acl number 2005
[Huawei-acl-basic-2005] rule permit source 225.1.0.0 0.0.255.255
[Huawei-acl-basic-2005] quit
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] 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 GE1/0/0 so that the entry of group 225.1.0.0/16 will be delete immediately after the interface receives an IGMP Leave message for the group GE0/0/1.

<Huawei> system-view
[Huawei] acl name myacl
[Huawei-acl-adv-myacl] rule permit ip destination 225.1.0.0 0.0.255.255
[Huawei-acl-adv-myacl] quit
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] igmp prompt-leave group-policy acl-name myacl

igmp proxy

Function

The igmp proxy command enables IGMP proxy on an interface.

The undo igmp proxy command disables IGMP proxy on an interface.

By default, IGMP proxy is disabled on an interface.

Format

igmp proxy [ track nqa admin-name test-name ]

undo igmp proxy

Parameters

Parameter Description Value
track nqa admin-name test-name Specifies the administrator name and test name of an NQA test instance. The value of either admin-name or test-name is a string of 1 to 32 case-insensitive characters, spaces not supported.
NOTE:
When double quotation marks are used around the string, spaces are allowed in the string.

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In a simple tree topology, multicast industrial switch routers directly connected to user network segments do not need to run any complicated multicast routing protocol (such as PIM). However, the upstream access devices have to manage many users because the multicast industrial switch routers transparently transmit all IGMP messages from hosts. To reduce loads on the upstream device, configure IGMP proxy on the multicast industrial switch routers. The multicast industrial switch routers then collect and summarize Report/Leave messages received from downstream hosts before sending them to the upstream device. The multicast industrial switch routers also maintain group memberships and forward multicast packets based on the group memberships. The upstream device considers the multicast industrial switch routers as hosts.

IGMP proxy lacks a fault detection mechanism to trigger link switchover quickly. Therefore, multicast services may be interrupted for a long time when a link failure occurs. You can solve this problem by associating IGMP proxy with a network quality analysis (NQA) test instance. If you specify track nqa admin-name test-name in the command, IGMP proxy will be associated with the specified NQA test instance for end-to-end link status monitoring. When the NQA test instance detects a link failure on the primary IGMP proxy interface, the device configured with the IGMP proxy backup function can switch multicast traffic to the backup link to minimize the communication interruption time.

Prerequisites

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

Precautions

A public network or VPN instance supports only one IGMP proxy interface

IGMP proxy conflicts with the following features:

  • PIM: If the pim sm or pim dm command has been configured on an interface, the igmp proxy command cannot be used on the interface. If the igmp proxy command is configured first, the pim sm or pim dm command cannot be used on the interface.
  • IGMP: If the igmp enable command has been configured on an interface, the igmp proxy command cannot be used on the interface. If the igmp proxy command is configured first, the igmp enable command cannot be used on the interface.
  • Static group: After a static group is configured on an interface, the igmp proxy command cannot be used on the interface. If the igmp proxy command has been configured, no static group can be configured on the interface.

Example

# Enable IGMP proxy on GE 1/0/0 in the public network instance.
<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] igmp proxy
# Enable IGMP proxy on GE0/0/1, and associate GE0/0/1 with an NQA test instance named user test.
<Huawei> system-view
[Huawei] nqa test-instance user test
[Huawei-nqa-user-test] test-type icmp
[Huawei-nqa-user-test] destination-address ipv4 1.1.1.1
[Huawei-nqa-user-test] quit
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] igmp proxy track nqa user test

igmp proxy backup

Function

The igmp proxy backup command configures a backup IGMP proxy interface.

The undo igmp proxy backup command cancels the configuration.

By default, IGMP proxy backup is disabled on an interface.

Format

igmp proxy backup

undo igmp proxy backup

Parameters

None

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Generally, the IGMP proxy function becomes unavailable if the upstream interface with IGMP proxy configured fails. To enhance reliability of the IGMP service, configure a backup IGMP proxy interface after configuring IGMP proxy on the upstream interface. If the upstream interface fails, the backup interface takes over the IGMP proxy service to resume multicast services.

Prerequisites

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

Precautions

An instance allows only one IGMP proxy interface and one backup IGMP proxy interface. Only one backup IGMP proxy interface can be configured on a device.

IGMP proxy conflicts with the following features:

  • PIM: If the pim sm or pim dm command has been configured on an interface, the igmp proxy backup command cannot be used on the interface. If the igmp proxy backup command is configured first, the pim sm or pim dm command cannot be used on the interface.
  • IGMP: If the igmp enable command has been configured on an interface, the igmp proxy backup command cannot be used on the interface. If the igmp proxy backup command is configured first, the igmp enable command cannot be used on the interface.
  • Static group: After a static group is configured on an interface, the igmp proxy backup command cannot be used on the interface. If the igmp proxy backup command has been configured, no static group can be configured on the interface.

Example

# Configure GE1/0/0 as a backup IGMP proxy interface in the public network instance.
<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] igmp proxy backup

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 an ACL.
NOTE:
acl-name acl-name can only be the name of a named advanced ACL.

The value is a string of 1 to 32 case-sensitive characters without spaces. The value must start with a letter (a to z or A to Z, 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 GE0/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-acl-basic-2001] rule permit source 10.10.1.1 0
[Huawei-acl-basic-2001] quit
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/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, except for the function range. The configuration in the IGMP view is globally valid in the instance, whereas the configuration in the interface view is valid only for the current interface. The system prefers the configuration in the interface view. The configuration in the IGMP view is used only when the configuration in the interface view is not done.

Example

# Configure GE0/0/1 to discard IGMP messages without the Router-Alert option.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/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 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, except for the function range. The configuration in the IGMP view is globally valid in the instance, whereas the configuration in the interface view is valid only for the current interface. The system prefers the configuration in the interface view. The configuration in the IGMP view is used only when the configuration in the interface view is not done.

Example

# Set the querier robustness variable on GE0/0/1 to 3.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] igmp robust-count 3

igmp send-router-alert

Function

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

The undo igmp send-router-alert command disables an interface from sending 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

undo igmp send-router-alert

Parameters

None

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

By default, the industrial switch router sends IGMP messages that contain the Router-Alert option in IP headers. If the industrial switch router needs to communicate with a device that does not support the Router-Alert option, run the undo igmp send-router-alert command to configure the industrial switch router to send IGMP messages without the Router-Alert option. The igmp send-router-alert command is usually used together with the 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 command has the same function as the send-router-alert command, except for the function range. The configuration in the IGMP view is globally valid in the instance, whereas the configuration in the interface view is valid only for the current interface. The system prefers the configuration in the interface view. The configuration in the IGMP view is used only when the configuration in the interface view is not done.

Example

# Configure GE0/0/1 to send IGMP messages without the Router-Alert option.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] undo igmp send-router-alert

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 industrial switch router. IGMP SSM mapping is implemented based on static SSM mapping entries on the industrial switch router. The industrial switch router 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 GE0/0/1.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/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

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 ] }

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

undo igmp static-group group-address [ source source-address ] mping-echo

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 Sets the step mask of 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 4 to 32. If group-mask-length is used to configure the 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.
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.
all Indicates all multicast groups that an interface statically joins. -
mping-echo Configures the device to respond to multicast ping packets received on the interface. -

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

  • There are long-term group members on a shared network segment, and the industrial switch router 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 industrial switch router considers that the multicast group always has members on the network segment of the interface. Therefore, the industrial switch router 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.

If mping-echo is specified in the igmp static-group command, the interface can not only send and receive multicast data packets but also respond to received multicast ping packets. This keyword enables the device to implement the multicast ping function without the need of a user host that can parse and respond to multicast ping packets. This makes fault location more flexible and convenient.

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 IGMP entries of static groups configured on an interface never time out. The industrial switch router 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 GE0/0/1.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] igmp static-group 224.1.1.1

# Configure the industrial switch router to forward multicast packets from multicast source 192.168.11.1 to multicast group 232.1.1.1 through GE0/0/1.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] igmp static-group 232.1.1.1 source 192.168.11.1
# Configure 10 static multicast groups on GE0/0/1 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 gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] igmp static-group 225.1.1.1 inc-step-mask 32 number 10
# Configure 10 source-group bindings on GE0/0/1 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 gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] igmp static-group 232.1.1.1 inc-step-mask 32 number 10 source 192.168.11.1
# Configure static group 224.1.1.1 on GE0/0/1 connected to a user host network segment and enable the interface to respond to received multicast ping packets.
<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/0/1] igmp static-group 224.1.1.1 mping-echo

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-presentcommand, except for the function range. The configuration in the IGMP view is globally valid in the instance, whereas the configuration in the interface view is valid only for the current interface. The system prefers the configuration in the interface 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

# On GE0/0/1, set the other querier present timer to 200 seconds.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/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 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, except for the function range. The configuration in the IGMP view is globally valid in the instance, whereas the configuration in the interface view is valid only for the current interface. The system prefers the configuration in the interface view. The configuration in the IGMP view is used only when the configuration in the interface view is not done.

Example

# Set the interval at which GE0/0/1 sends General Query messages to 50 seconds.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/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 industrial switch router 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 industrial switch router runs the same IGMP version as member hosts or a later IGMP version.

If multiple industrial switch routers exist on a shared network segment, configure the same IGMP version on all industrial switch router 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 GE0/0/1.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] interface gigabitethernet 0/0/1
[Huawei-GigabitEthernet0/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 the public network instance, IGMP view of a 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, except for the function range. The configuration in the IGMP view is globally valid in the instance, whereas the configuration in the interface view is valid only for the current interface. The system prefers the configuration in the interface view. The configuration in the IGMP view is used only when the configuration in the interface view is not done.

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

# In VPN instance mvpn, 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 vpn-instance mvpn
[Huawei-igmp-mvpn] lastmember-queryinterval 3

limit (IGMP)

Function

The limit command sets the maximum number of IGMP entries that can be created for an instance.

The undo limit command restores the maximum number of IGMP entries that can be created for an instance to the default value.

By default, the maximum number of IGMP entries that can be created for an instance varies according to device models:

  • AR503GW-LM7, AR503GW-LM7, AR509G-L-D-H, AR509GW-L-D-H, AR510 series: 3000
  • AR502G-L-D-H, AR502GR-L-D-H, AR530 series: 256

Format

limit number

undo limit

Parameters

Parameter Description Value
number Specifies the maximum number of IGMP entries that can be created for an instance.

The value is an integer that ranges from:

  • AR503GW-LM7, AR503GW-LM7, AR509G-L-D-H, AR509GW-L-D-H, AR510 series: 1 to 3000
  • AR502G-L-D-H, AR502GR-L-D-H, AR530 series: 1 to 256

Views

IGMP view of the public network instance, IGMP view of a VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

This command sets the maximum number of IGMP entries for an instance.

When the number of IGMP entries reaches the limit, the system does not create any IGMP entries. To enable the industrial switch router to create more IGMP entries, delete useless entries or increase the limit. Alternatively, create static IGMP entries.

The number of IGMP entries is counted as follows:

  • Each (*, G) entry is counted as one entry.

  • Each (S, G) entry is counted as one entry.

  • Each (*, G) entry established with SSM mapping is counted as one entry.

Prerequisites

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

Example

# Set the maximum number of IGMP entries that can be created in the public network instance to 126.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] igmp
[Huawei-igmp] limit 126

# Set the maximum number of IGMP entries that can be created in VPN instance mvpn to 126.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] igmp vpn-instance mvpn
[Huawei-igmp-mvpn] limit 126

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 the public network instance, IGMP view of a 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 industrial switch router 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

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

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] igmp vpn-instance mvpn
[Huawei-igmp-mvpn] max-response-time 8

proxy source-lifetime

Function

The proxy source-lifetime command sets the timeout period for an (S, G) entry that an IGMP proxy-capable industrial switch router generates.

The undo proxy source-lifetime command restores the default configuration.

By default, the timeout period of an (S, G) entry that an IGMP proxy-capable industrial switch router generates is 210 seconds.

Format

proxy source-lifetime interval

undo proxy source-lifetime

Parameters

Parameter Description Value
interval Specifies the timeout period of an (S, G) entry. The value is an integer that ranges from 60 to 65535, in seconds. The default value is recommended for general use.

Views

IGMP view of the public network instance, IGMP view of a VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

An IGMP proxy-capable industrial switch router starts timer for each (S, G) entry and records the time when a multicast source S sends multicast packets. The proxy source-lifetime command sets the timeout period for (S, G) entries on an IGMP proxy-capable industrial switch router. An IGMP proxy interface starts a timer when receiving the first multicast packet from a multicast source and resets the timer every time it receives a multicast packet from the multicast source. If the interface does not receive any multicast packet from the multicast source within the timeout period, it considers the (S, G) entry invalid.

Prerequisites

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

Example

# In the public network instance, Set the timeout period for (S, G) entries to 200s.
<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] igmp
[Huawei-igmp] proxy source-lifetime 200
# In VPN instance mvpn, set the timeout period for (S, G) entries to 200s.
<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] igmp vpn-instance mvpn
[Huawei-igmp-mvpn] proxy source-lifetime 200

proxy source-policy

Function

The proxy source-policy command configures an IGMP proxy-capable router to filter received multicast data packets based on source addresses or source and group addresses.

The undo proxy source-policy command restores the default configuration.

By default, an IGMP proxy-capable router does not filter received multicast data packets.

Format

proxy source-policy { acl-number | acl-name acl-name }

undo proxy source-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 in the range 2000 to 2999. The number of an advanced ACL is an integer in the range 3000 to 3999.
acl-name acl-name Specifies the name of a named ACL.
NOTE:
acl-name acl-name can only be the name of a named advanced ACL.

The value is a string of 1 to 32 case-sensitive characters without spaces. The value must start with a letter (a to z or A to Z, case sensitive).

Views

IGMP view of the public network instance, IGMP view of a VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If an IGMP proxy-capable router needs to restrict multicast data packets sent from some multicast sources, run the proxy source-policy command configure the device to filter multicast data packets based on source addresses or source and group addresses. This command can also be used to filter the multicast data encapsulated in Register messages.

Prerequisites

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

Precautions

The proxy source-policy command takes effect on a device only when IGMP proxy is enabled on the device.

To reference a numbered ACL to a proxy source policy, run the proxy source-policy and acl commands together.
  • In the basic ACL view, specify the source parameter in the rule command to set a multicast group range.

  • In the advanced ACL view, specify source in the rule command to set a source address range and specify destination to set a group address range.

Named ACLs are classified into basic and advanced ACLs. The configuration rules of a named ACL are the same as that of a numbered ACL.

Example

# In the public network instance, configure an IGMP proxy-capable router to accept the multicast data packets from multicast source 10.10.1.2 and to discard the multicast data packets from the multicast source 10.10.1.1.
<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] acl number 2001
[Huawei-acl-basic-2001] rule permit source 10.10.1.2 0
[Huawei-acl-basic-2001] rule deny source 10.10.1.1 0
[Huawei-acl-basic-2001] quit
[Huawei] igmp
[Huawei-igmp] proxy source-policy 2001

# In the public network instance, configure an IGMP proxy-capable router to accept the multicast data packets sent from multicast source 10.10.1.2 to multicast group 232.1.0.0.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] acl name myacl
[Huawei-acl-adv-myacl] rule permit ip source 10.10.1.2 0 destination 232.1.0.0 0.0.255.255
[Huawei-acl-adv-myacl] quit
[Huawei] igmp
[Huawei-igmp] proxy source-policy acl-name myacl
# In VPN instance mvpn, configure an IGMP proxy-capable router to accept the multicast data packets from multicast source 10.10.1.2 and discard the multicast data packets from multicast source 10.10.1.1.
<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] acl number 2001
[Huawei-acl-basic-2001] rule permit source 10.10.1.2 0
[Huawei-acl-basic-2001] rule deny source 10.10.1.1 0
[Huawei-acl-basic-2001] quit
[Huawei] igmp vpn-instance mvpn
[Huawei-igmp-mvpn] proxy source-policy 2001
Related Topics

proxy ssm-policy

Function

The proxy ssm-policy command configures an SSM group address range for IGMP proxy.

The undo proxy ssm-policy command restores the default configuration.

The default SSM group address range for IGMP proxy is 232.0.0.0/8.

Format

proxy ssm-policy { basic-acl-number | acl-name acl-name }

undo proxy ssm-policy

Parameters

Parameter Description Value
basic-acl-number Specifies the number of a basic ACL. This ACL defines a range of multicast groups. The sequence number is an integer that ranges from 2000 to 2999.
acl-name acl-name Specifies the name of a named ACL.
NOTE:
acl-name acl-name can only be the name of a named advanced ACL.

The value is a string of 1 to 32 case-sensitive characters without spaces. The value must start with a letter (a to z or A to Z, case sensitive).

Views

IGMP view of the public network instance, IGMP view of a VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The default SSM group address range is 232.0.0.0 to 232.255.255.255. Generally, an IGMP proxy device provides the SSM service for hosts only when it receives Report messages with group address in this range. Sometimes, the SSM group address range must be narrowed to ensure security of a multicast network, and sometimes, the SSM group address range needs to be expanded because the default SSM group addresses are insufficient. In these cases, configure an SSM group address range on IGMP proxy devices. Ensure that all the multicast devices on the network are configured with the same SSM group address range.

Prerequisites

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

Precautions

The SSM model can be used in the following situations:

  • Multicast group addresses are in an SSM address range, IGMPv3 is running on the user network segment, and multicast source addresses are specified in Report messages.
  • Multicast group addresses are in an SSM address range, IGMPv1 or IGMPv2 is running on the user network segment, and SSM mapping is configured.

The proxy ssm-policy command works with the acl command. If a basic ACL is configured, you can specify source in the rule command to configure an SSM address range.

Example

# In the public network instance, set the SSM group address range for IGMP proxy to 232.1.0.0/16.
<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] acl number 2000
[Huawei-acl-basic-2000] rule permit source 232.1.0.0 0.0.255.255
[Huawei-acl-basic-2000] quit
[Huawei] igmp
[Huawei-igmp] proxy ssm-policy 2000
# In VPN instance mvpn, set the SSM group address range for IGMP proxy to 232.1.0.0/16.
<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] acl number 2000
[Huawei-acl-basic-2000] rule permit source 232.1.0.0 0.0.255.255
[Huawei-acl-basic-2000] quit
[Huawei] igmp vpn-instance mvpn
[Huawei-igmp-mvpn] proxy ssm-policy 2000

require-router-alert (IGMP)

Function

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

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

By default, the industrial switch router 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 the public network instance, IGMP view of a 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 industrial switch router 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 industrial switch router to discard IGMP messages without the Router-Alert option.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] igmp
[Huawei-igmp] require-router-alert

# In VPN instance mvpn, configure the industrial switch router to discard IGMP messages without the Router-Alert option.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] igmp vpn-instance mvpn
[Huawei-igmp-mvpn] 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, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

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 GE0/0/1.

<Huawei> reset igmp control-message counters interface gigabitethernet 0/0/1

reset igmp explicit-tracking

Function

The reset igmp explicit-tracking command deletes information about the hosts with dynamic group memberships established through IGMP on an interface.

Format

reset igmp [ vpn-instance vpn-instance-name | all-instance ] explicit-tracking { all | interface interface-type interface-number [ host host-address [ group group-address [ source source-address ] ] ] }

Parameters

Parameter Description Value
vpn-instance vpn-instance-name Deletes information about the hosts with IGMP-attached group memberships on interfaces in a specified VPN instance.

The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

all-instance Deletes information about the hosts with IGMP-attached group memberships on interfaces in all instances. -
all Deletes information about all the hosts. -
interface interface-type interface-number Deletes information about the hosts with IGMP-attached group memberships on a specified interface. If this parameter is not specified, the command deletes information about the hosts with IGMP-attached group memberships on all interfaces. -
host host-address Specifies the IP address of a host. The address is in dotted decimal notation.
group group-address Specifies the address of a multicast group. The address is in dotted decimal notation and ranges from 224.0.1.0 to 239.255.255.255.
source source-address Specifies the address of a multicast source. The address is in dotted decimal notation.

Views

User view

Default Level

3: Management level

Usage Guidelines

You can use this command to delete information about the hosts with dynamic group memberships established through IGMP on interfaces.

Example

# Delete information about IGMP host 192.168.0.12 in group 232.1.1.1 on GE1/0/0.
<Huawei> reset igmp explicit-tracking interface gigabitethernet 1/0/0 host 192.168.0.12 group 232.1.1.1

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, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

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 GE0/0/1.

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

# Delete the IGMP entries of group 225.0.0.1 on GE0/0/1.

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

# Delete IGMP entries of groups 225.1.1.0 to 225.1.1.255 on GE0/0/1.

<Huawei> reset igmp group interface gigabitethernet 0/0/1 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, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

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 the public network instance, IGMP view of a 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

# In VPN instance mvpn, set the robustness variable of an IGMP querier to 3.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] igmp vpn-instance mvpn
[Huawei-igmp-mvpn] robust-count 3

send-router-alert (IGMP)

Function

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

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

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

Format

send-router-alert

undo send-router-alert

Parameters

None

Views

IGMP view of the public network instance, IGMP view of a VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

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

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] igmp
[Huawei-igmp] undo send-router-alert

# In VPN instance mvpn, configure the industrial switch router to send IGMP messages without the Router-Alert option.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] igmp vpn-instance mvpn
[Huawei-igmp-mvpn] undo send-router-alert

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 the public network instance, IGMP view of a 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

# In VPN instance mvpn, 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 vpn-instance mvpn
[Huawei-igmp-mvpn] 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 the public network instance, IGMP view of a 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

# In VPN instance mvpn, set the other querier present timer to 200 seconds.

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] igmp vpn-instance mvpn
[Huawei-igmp-mvpn] 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 the public network instance, IGMP view of a 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 querier is more sensitive when it sends General Query messages at a shorter interval. However, more bandwidth and industrial switch router 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 public network instance, 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

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

<Huawei> system-view
[Huawei] multicast routing-enable
[Huawei] igmp vpn-instance mvpn
[Huawei-igmp-mvpn] timer query 125
Translation
Download
Updated: 2019-05-29

Document ID: EDOC1000097293

Views: 49114

Downloads: 102

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