Field	Description
IGMP snooping	IGMP snooping status: · Enabled. · Disabled.
Drop-unknown	Status of dropping unknown multicast data: · Enabled. · Disabled.
Version	IGMP snooping version.
Host-aging-time	Aging timer for the dynamic member port.
Router-aging-time	Aging timer for the dynamic router port.
Max-response-time	Maximum response time for IGMP general queries.
Last-member-query-interval	Interval for sending IGMP group-specific queries.
Report-aggregation	Status of IGMP report suppression: · Enabled. · Disabled.
Dot1p-priority	This field is not supported in the current software version. 802.1p priority for IGMP messages. If the priority is not configured, this field displays two hyphens (--).
Querier	Status of IGMP snooping querier: · Enabled. · Disabled.
Query-interval	Interval for sending IGMP general queries.
General-query source IP	Source IP address of IGMP general queries.
Special-query source IP	Source IP address of IGMP group-specific queries.
Report source IP	Source IP address of IGMP reports.
Leave source IP	Source IP address of IGMP leave messages.
Host-tracking	Status of host tracking: · Enabled. · Disabled.
Proxy	Status of IGMP snooping proxying: · Enabled. · Disabled.

display igmp-snooping group

Use display igmp-snooping group to display dynamic IGMP snooping group entries.

Syntax

In standalone mode:

display igmp-snooping group [ group-address | source-address ] * [ vlan vlan-id | vsi vsi-name ] [ verbose ] [ slot slot-number [ cpu cpu-number ] ]

In IRF mode:

display igmp-snooping group [ group-address | source-address ] * [ vlan vlan-id | vsi vsi-name ] [ verbose ] [ chassis chassis-number slot slot-number [ cpu cpu-number ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

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

source-address: Specifies a multicast source by its IP address. If you do not specify a multicast source, this command displays dynamic IGMP snooping group entries for all multicast sources.

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a VLAN, this command displays dynamic IGMP snooping group entries for all VLANs.

vsi vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VSI, this command displays dynamic IGMP snooping group entries for all VSIs.

verbose: Displays detailed information about dynamic IGMP snooping group entries. If you do not specify the keyword, this command displays brief information about dynamic IGMP snooping group entries.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays dynamic IGMP snooping group entries on the active MPU. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays dynamic IGMP snooping group entries on the global active MPU. (In IRF mode.)

cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.

Examples

# Display detailed information about dynamic IGMP snooping group entries for VLAN 2.

<Sysname> display igmp-snooping group vlan 2 verbose

Total 1 entries.

VLAN 2: Total 1 entries.

(0.0.0.0, 224.1.1.1)

Attribute: local port

FSM information: normal

Host slots (0 in total):

Host ports (1 in total):

XGE3/1/2 (00:03:23)

# Display detailed information about dynamic IGMP snooping group entries for VSI aaa.

<Sysname> display igmp-snooping group vsi aaa verbose

Total 1 entries.

VSI aaa: Total 1 entries.

(0.0.0.0, 224.1.1.1)

Attribute: global port

FSM information: normal

Host slots (0 in total):

Host ports (1 in total):

AC (VSI index 0 Link ID 1) (00:03:35)

VLAN pairs (1 in total):

Out VLAN 5 In VLAN 2 (00:03:35)

Table 2 Command output

Field	Description
Total 1 entries	Total number of dynamic IGMP snooping group entries.
VLAN 2: Total 1 entries	Total number of dynamic IGMP snooping group entries in VLAN 2.
VSI aaa: Total 1 entries	Total number of dynamic IGMP snooping group entries in VSI aaa.
(0.0.0.0, 224.1.1.1)	(S, G) entry, where 0.0.0.0 in the S position means all multicast sources.
Attribute	Entry attribute: · global port—The entry has a global port. · local port—The entry has a port that resides on the card for which the information is displayed. · slot—The entry has ports that reside on other cards, but not on the card for which the information is displayed.
FSM information	Finite state machine information of the entry: · delete—The entry attributes have been deleted. · dummy—The entry is a new temporary entry. · no info—No entry exists. · normal—The entry is a correct entry.
Host slots (0 in total)	(In standalone mode.) Slot numbers and total number of the cards that have member ports, except for the specified card or the MPU when no card is specified. (In IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have member ports, except for the specified card or the global active MPU when no card is specified.
Host ports (1 in total)	Member ports, and the total number of member ports.
(00:03:23)	Remaining aging time for the dynamic member port. For a global port (including Layer 2 aggregate interfaces, AC interfaces, N-PW interfaces, and U-PW interfaces), this field is always displayed. (In standalone mode.) For a non-global port, this field is displayed when one of the following conditions exists: · The port is on the specified card. · The port is on the MPU and no card is specified. (In IRF mode.) For a non-global port, this field is displayed when one of the following conditions exists: · The port is on the specified card. · The port is on the global active MPU and no card is specified.
AC (VSI index 0 Link ID 1)	AC interface, and its VSI index and link ID.
NPW (VSI index 0 Link ID 1)	N-PW interface, and its VSI index and link ID.
UPW (VSI index 0 Link ID 1)	U-PW interface, and its VSI index and link ID.
NPW (VXLAN ID 0 Link ID 0x5000001)	N-PW interface, and its VXLAN ID and link ID.
VLAN pairs (1 in total)	VLAN pairs and total number of the VLAN pairs.
Out VLAN 5 In VLAN 2	Outer VLAN ID and inner VLAN ID.

Related commands

reset igmp-snooping group

display igmp-snooping host-tracking

Use display igmp-snooping host-tracking to display host tracking information.

Syntax

In standalone mode:

display igmp-snooping host-tracking vlan vlan-id group group-address [ source source-address ] [ slot slot-number [ cpu cpu-number ] ]

In IRF mode:

display igmp-snooping host-tracking vlan vlan-id group group-address [ source source-address ] [ chassis chassis-number slot slot-number [ cpu cpu-number ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094.

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

source source-address: Specifies a multicast source by its IP address. If you do not specify a multicast source, this command displays host tracking information for all multicast sources.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays host tracking information on the active MPU. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays host tracking information on the global active MPU. (In IRF mode.)

cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.

Examples

# Display tracking information for hosts that have joined multicast group 224.1.1.1 in VLAN 2.

<Sysname> display igmp-snooping host-tracking vlan 2 group 224.1.1.1

VLAN 2

(0.0.0.0, 224.1.1.1)

Port: XGE3/1/1

Host Uptime Expires

1.1.1.1 00:02:20 00:00:40

2.2.2.2 00:02:21 00:00:39

Table 3 Command output

Field	Description
VLAN	VLAN ID.
(0.0.0.0, 224.1.1.1)	(S, G) entry, where 0.0.0.0 in the S position means any multicast sources.
Port	Member port.
Host	IP address of the host.
Uptime	Length of time elapsed since the host joined the multicast group.
Expires	Remaining timeout time for the host. The host timeout time is the same as the aging timer for the port. The timer is reset when the port receives an IGMP report from the host. This field displays timeout if the host times out.

Related commands

host-tracking (IGMP-snooping view)

igmp-snooping enable

igmp-snooping host-tracking

display igmp-snooping router-port

Use display igmp-snooping router-port to display dynamic router port information.

Syntax

In standalone mode:

display igmp-snooping router-port [ verbose | vlan vlan-id | vsi vsi-name [ verbose ] ] [ slot slot-number [ cpu cpu-number ] ]

In IRF mode:

display igmp-snooping router-port [ verbose | vlan vlan-id | vsi vsi-name [ verbose ] ] [ chassis chassis-number slot slot-number [ cpu cpu-number ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

verbose: Displays detailed information about dynamic router ports. If you do not specify the keyword, this command displays brief information about dynamic router ports.

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a VLAN, this command displays dynamic router port information for all VLANs.

vsi vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VSI, this command displays dynamic router port information for all VSIs.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays dynamic router port information on the active MPU. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays dynamic router port information on the global active MPU. (In IRF mode.)

cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.

Examples

# Display brief information about dynamic router ports for VLAN 2.

<Sysname> display igmp-snooping router-port vlan 2

VLAN 2:

Router slots (0 in total):

Router ports (2 in total):

XGE3/1/1 (00:01:30)

XGE3/1/2 (00:00:23)

# Display detailed information about dynamic router ports for VSI aaa.

<Sysname> display igmp-snooping router-port vsi aaa verbose

VSI aaa:

Router slots (0 in total):

Router ports (1 in total):

AC (VSI index 0 Link ID 1) (00:03:35)

VLAN pairs (1 in total):

Out VLAN 5 In VLAN 2 (00:03:35)

Table 4 Command output

Field	Description
VLAN 2	VLAN ID.
VSI aaa	VSI name.
Router slots (0 in total)	(In standalone mode.) Slot numbers and total number of the cards that have dynamic router ports, except for the specified card or the MPU when no card is specified. (In IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have dynamic router ports, except for the specified card or the global active MPU when no card is specified.
Router ports (2 in total)	Dynamic router ports and total number of dynamic router ports.
(00:01:30)	Remaining aging time for the dynamic router port. For a global port, this field is always displayed. (In standalone mode.) For a non-global port, this field is displayed when one of the following conditions exists: · The port is on the specified card. · The port is on the MPU and no card is specified. (In IRF mode.) For a non-global port, this field is displayed when one of the following conditions exists: · The port is on the specified card. · The port is on the global active MPU and no card is specified.
AC (VSI index 0 Link ID 1)	AC interface, and its VSI index and link ID.
NPW (VSI index 0 Link ID 1)	N-PW interface, and its VSI index and link ID.
UPW (VSI index 0 Link ID 1)	U-PW interface, and its VSI index and link ID.
VLAN pairs (1 in total)	VLAN pairs and total number of VLAN pairs.
Out VLAN 5 In VLAN 2	Outer VLAN ID and inner VLAN ID.

Related commands

reset igmp-snooping router-port

display igmp-snooping static-group

Use display igmp-snooping static-group to display static IGMP snooping group entries.

Syntax

In standalone mode:

display igmp-snooping static-group [ group-address | source-address ] * [ vlan vlan-id ] [ verbose ] [ slot slot-number [ cpu cpu-number ] ]

In IRF mode:

display igmp-snooping static-group [ group-address | source-address ] * [ vlan vlan-id ] [ verbose ] [ chassis chassis-number slot slot-number [ cpu cpu-number ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

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

source-address: Specifies a multicast source by its IP address. If you do not specify a multicast source, this command displays static IGMP snooping group entries for all multicast sources.

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a VLAN, this command displays static IGMP snooping group entries for all VLANs.

verbose: Displays detailed information about static IGMP snooping group entries. If you do not specify the keyword, this command displays brief information about static IGMP snooping group entries.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays static IGMP snooping group entries on the active MPU. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays static IGMP snooping group entries on the global active MPU. (In IRF mode.)

cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.

Examples

# Display detailed information about static IGMP snooping group entries for VLAN 2.

<Sysname> display igmp-snooping static-group vlan 2 verbose

Total 1 entries.

VLAN 2: Total 1 entries.

(0.0.0.0, 224.1.1.1)

Attribute: local port

FSM information: normal

Host slots (0 in total):

Host ports (1 in total):

XGE3/1/2

Table 5 Command output

Field	Description
Total 1 entries	Total number of static IGMP snooping group entries.
VLAN 2: Total 1 entries	Total number of static IGMP snooping group entries in VLAN 2.
(0.0.0.0, 224.1.1.1)	(S, G) entry, where 0.0.0.0 in the S position means all multicast sources.
Attribute	Entry attribute: · global port—The entry has a global port. · local port—The entry has a port that resides on the card for which the information is displayed. · slot—The entry has ports that reside on other cards, but not on the card for which the information is displayed.
FSM information	Finite state machine information of the entry: · delete—The entry attributes have been deleted. · dummy—The entry is a new temporary entry. · no info—No entry exists. · normal—The entry is a correct entry.
Host slots (0 in total)	(In standalone mode.) Slot numbers and total number of the cards that have member ports, except for the specified card or the MPU when no card is specified. (In IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have member ports, except for the specified card or the global active MPU when no card is specified.
Host ports (1 in total)	Member ports and total number of member ports.

display igmp-snooping static-router-port

Use display igmp-snooping static-router-port to display static router port information.

Syntax

In standalone mode:

display igmp-snooping static-router-port [ vlan vlan-id ] [ slot slot-number [ cpu cpu-number ] ]

In IRF mode:

display igmp-snooping static-router-port [ vlan vlan-id ] [ chassis chassis-number slot slot-number [ cpu cpu-number ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays static router port information on the active MPU. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays static router port information on the global active MPU. (In IRF mode.)

cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.

Examples

# Display static router port information for VLAN 2.

<Sysname> display igmp-snooping static-router-port vlan 2

VLAN 2:

Router slots (0 in total):

Router ports (2 in total):

XGE3/1/1

XGE3/1/2

Table 6 Command output

Field	Description
VLAN 2	VLAN ID.
Router slots (0 in total)	(In standalone mode.) Slot numbers and total number of the cards that have static router ports, except for the specified card or the MPU when no card is specified. (In IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have static router ports, except for the specified card or the global active MPU when no card is specified.
Router ports (2 in total)	Static router ports and total number of static router ports.

display igmp-snooping statistics

Use display igmp-snooping statistics to display statistics for the IGMP messages and PIMv2 hello messages learned through IGMP snooping.

Syntax

display igmp-snooping statistics

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display statistics for the IGMP messages and PIMv2 hello messages learned through IGMP snooping.

<Sysname> display igmp-snooping statistics

Received IGMP general queries: 0

Received IGMPv1 reports: 0

Received IGMPv2 reports: 19

Received IGMP leaves: 0

Received IGMPv2 specific queries: 0

Sent IGMPv2 specific queries: 0

Received IGMPv3 reports: 1

Received IGMPv3 reports with right and wrong records: 0

Received IGMPv3 specific queries: 0

Received IGMPv3 specific sg queries: 0

Sent IGMPv3 specific queries: 0

Sent IGMPv3 specific sg queries: 0

Received PIMv2 hello: 0

Received error IGMP messages: 19

Table 7 Command output

Field	Description
general queries	Number of IGMP general queries.
specific queries	Number of IGMP group-specific queries.
reports	Number of IGMP reports.
leaves	Number of IGMP leave messages.
reports with right and wrong records	Number of IGMP reports with correct and incorrect records.
specific sg queries	Number of IGMP group-and-source-specific queries.
PIMv2 hello	Number of PIMv2 hello messages.
error IGMP messages	Number of IGMP messages with errors.

Related commands

reset igmp-snooping statistics

display l2-multicast ip

Use display l2-multicast ip to display information about Layer 2 IP multicast groups.

Syntax

In standalone mode:

display l2-multicast ip [ group group-address | source source-address ] * [ vlan vlan-id | vsi vsi-name ] [ slot slot-number [ cpu cpu-number ] ]

In IRF mode:

display l2-multicast ip [ group group-address | source source-address ] * [ vlan vlan-id | vsi vsi-name ] [ chassis chassis-number slot slot-number [ cpu cpu-number ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

group group-address: Specifies a multicast group by its IP address. If you do not specify a multicast group, this command displays information about all Layer 2 IP multicast groups.

source source-address: Specifies a multicast source by its IP address. If you do not specify a multicast source, this command displays information about Layer 2 IP multicast groups for all multicast sources.

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a VLAN, this command displays information about Layer 2 IP multicast groups for all VLANs.

vsi vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VSI, this command displays information about Layer 2 IP multicast groups for all VSIs.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays information about Layer 2 IP multicast groups on the active MPU. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays information about Layer 2 IP multicast groups on the global active MPU. (In IRF mode.)

cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.

Examples

# Display information about Layer 2 IP multicast groups for VLAN 2.

<Sysname> display l2-multicast ip vlan 2

Total 1 entries.

VLAN 2: Total 1 IP entries.

(0.0.0.0, 224.1.1.1)

Attribute: static, success

Host slots (0 in total):

Host ports (1 in total):

XGE3/1/1 (S, SUC)

# Display information about Layer 2 IP multicast groups for VSI aaa.

<Sysname> display l2-multicast ip vsi aaa

Total 1 entries.

VSI aaa: Total 1 IP entries.

(0.0.0.0, 224.1.1.1)

Attribute: dynamic, success

Host slots (0 in total):

Host ports (1 in total):

AC (VSI index 0 Link ID 1) (D, SUC)

Table 8 Command output

Field	Description
Total 1 entries	Total number of Layer 2 IP multicast groups.
VLAN 2: Total 1 IP entries	Total number of Layer 2 IP multicast groups in VLAN 2.
VSI aaa: Total 1 IP entries	Total number of Layer 2 IP multicast groups in VSI aaa.
(0.0.0.0, 224.1.1.1)	(S, G) entry, where 0.0.0.0 in the S position means all multicast sources.
Attribute	Entry attribute: · dynamic—The entry is created by a dynamic protocol. · static—The entry is created by a static protocol. · pim—The entry is created by PIM. · kernel—The entry is obtained from the kernel. · success—Processing has succeeded. · fail—Processing has failed.
Host slots (0 in total)	(In standalone mode.) Slot numbers and total number of the cards that have member ports, except for the specified card or the MPU when no card is specified. (In IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have member ports, except for the specified card or the global active MPU when no card is specified.
Host ports (1 in total)	Member ports and total number of member ports.
(S, SUC)	Port attribute: · D—Dynamic port. · S—Static port. · P—PIM port. · K—Port obtained from the kernel. · R—Port learned from (, ) entries. · W—Port learned from (*, G) entries. · SUC—Processing has succeeded. · F—Processing has failed. · BC—In a VLAN, the port is a TRILL port that floods multicast data after the topology changes. In a VSI, the port is a multicast tunnel interface for a multicast-mode VXLAN.
AC (VSI index 0 Link ID 1)	AC interface, and its VSI index and link ID.
NPW (VSI index 0 Link ID 1)	N-PW interface, and its VSI index and link ID.
UPW (VSI index 0 Link ID 1)	U-PW interface, and its VSI index and link ID.
NPW (VXLAN ID 0 Link ID 0x5000001)	N-PW interface, and its VXLAN ID and link ID.

display l2-multicast ip forwarding

Use display l2-multicast ip forwarding to display Layer 2 multicast IP forwarding entries.

Syntax

In standalone mode:

display l2-multicast ip forwarding [ group group-address | source source-address ] * [ vlan vlan-id | vsi vsi-name ] [ slot slot-number [ cpu cpu-number ] ]

In IRF mode:

display l2-multicast ip forwarding [ group group-address | source source-address ] * [ vlan vlan-id | vsi vsi-name ] [ chassis chassis-number slot slot-number [ cpu cpu-number ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

group group-address: Specifies a multicast group by its IP address. If you do not specify a multicast group, this command displays Layer 2 multicast IP forwarding entries for all multicast groups.

source source-address: Specifies a multicast source by its IP address. If you do not specify a multicast source, this command displays Layer 2 multicast IP forwarding entries for all multicast sources.

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a VLAN, this command displays Layer 2 multicast IP forwarding entries for all VLANs.

vsi vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VSI, this command displays Layer 2 multicast IP forwarding entries for all VSIs.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays Layer 2 multicast IP forwarding entries on the active MPU. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays Layer 2 multicast IP forwarding entries on the global active MPU. (In IRF mode.)

cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.

Examples

# Display Layer 2 multicast IP forwarding entries for VLAN 2.

<Sysname> display l2-multicast ip forwarding vlan 2

Total 1 entries.

VLAN 2: Total 1 entries.

(0.0.0.0, 224.1.1.1)

Host slots (0 in total):

Host ports (3 in total):

Ten-GigabitEthernet3/1/1

Ten-GigabitEthernet3/1/2

Ten-GigabitEthernet3/1/3

# Display Layer 2 IP multicast group entries for VSI aaa.

<Sysname> display l2-multicast ip forwarding vsi aaa

Total 1 entries.

VSI aaa: Total 1 entries.

(0.0.0.0, 224.1.1.1)

Host slots (0 in total):

Host ports (1 in total):

AC (VSI index 0 Link ID 1)

Table 9 Command output

Field	Description
Total 1 entries	Total number of Layer 2 multicast IP forwarding entries.
VLAN 2: Total 1 entries	Total number of Layer 2 multicast IP forwarding entries in VLAN 2.
VSI aaa: Total 1 entries	Total number of Layer 2 multicast IP forwarding entries in VSI aaa.
(0.0.0.0, 224.1.1.1)	(S, G) entry, where 0.0.0.0 in the S position means all multicast sources.
Host slots (0 in total)	(In standalone mode.) Slot numbers and total number of the cards that have member ports, except for the specified card or the MPU when no card is specified. (In IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have member ports, except for the specified card or the global active MPU when no card is specified.
Host ports (3 in total)	Member ports and total number of member ports.
AC (VSI index 0 Link ID 1)	AC interface, and its VSI index and link ID.
NPW (VSI index 0 Link ID 1)	N-PW interface, and its VSI index and link ID.
UPW (VSI index 0 Link ID 1)	U-PW interface, and its VSI index and link ID.
NPW (VXLAN ID 0 Link ID 0x5000001)	N-PW interface, and its VXLAN ID and link ID.

display l2-multicast mac

Use display l2-multicast mac to display information about Layer 2 MAC multicast groups.

Syntax

In standalone mode:

display l2-multicast mac [ mac-address ] [ vlan vlan-id | vsi vsi-name ] [ slot slot-number [ cpu cpu-number ] ]

In IRF mode:

display l2-multicast mac [ mac-address ] [ vlan vlan-id | vsi vsi-name ] [ chassis chassis-number slot slot-number [ cpu cpu-number ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

mac-address: Specifies a MAC multicast group by its multicast MAC address. If you do not specify a MAC multicast group, this command displays information about all Layer 2 MAC multicast groups.

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a VLAN, this command displays information about Layer 2 MAC multicast groups for all VLANs.

vsi vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VSI, this command displays information about Layer 2 MAC multicast groups for all VSIs.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays information about Layer 2 MAC multicast groups on the active MPU. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays information about Layer 2 MAC multicast groups on the global active MPU. (In IRF mode.)

cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.

Examples

# Display information about Layer 2 MAC multicast groups for VLAN 2.

<Sysname> display l2-multicast mac vlan 2

Total 1 MAC entries.

VLAN 2: Total 1 MAC entries.

MAC group address: 0100-5e01-0101

Attribute: success

Host slots (0 in total):

Host ports (1 in total):

XGE3/1/1

# Display information about Layer 2 MAC multicast groups for VSI aaa.

<Sysname> display l2-multicast mac vsi aaa

Total 1 MAC entries.

VSI aaa: Total 1 MAC entries.

MAC group address: 0100-5e01-0101

Attribute: success

Host slots (0 in total):

Host ports (1 in total):

AC (VSI index 0 Link ID 1)

Table 10 Command output

Field	Description
Total 1 MAC entries	Total number of Layer 2 MAC multicast groups.
VLAN 2: Total 1 MAC entries	Total number of Layer 2 MAC multicast groups in VLAN 2.
VSI aaa: Total 1 MAC entries	Total number of Layer 2 MAC multicast groups in VSI aaa.
MAC group address	Address of the MAC multicast group.
Attribute	Entry attribute: · success—Processing has succeeded. · fail—Processing has failed.
Host slots (0 in total)	(In standalone mode.) Slot numbers and total number of the cards that have member ports, except for the specified card or the MPU when no card is specified. (In IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have member ports, except for the specified card or the global active MPU when no card is specified.
Host ports (1 in total)	Member ports and total number of member ports.
AC (VSI index 0 Link ID 1)	AC interface, and its VSI index and link ID.
NPW (VSI index 0 Link ID 1)	N-PW interface, and its VSI index and link ID.
UPW (VSI index 0 Link ID 1)	U-PW interface, and its VSI index and link ID.
NPW (VXLAN ID 0 Link ID 0x5000001)	N-PW interface, and its VXLAN ID and link ID.

display l2-multicast mac forwarding

Use display l2-multicast mac forwarding to display Layer 2 multicast MAC forwarding entries.

Syntax

In standalone mode:

display l2-multicast mac forwarding [ mac-address ] [ vlan vlan-id | vsi vsi-name ] [ slot slot-number [ cpu cpu-number ] ]

In IRF mode:

display l2-multicast mac forwarding [ mac-address ] [ vlan vlan-id | vsi vsi-name ] [ chassis chassis-number slot slot-number [ cpu cpu-number ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

mac-address: Specifies a MAC multicast group by its MAC address. If you do not specify a MAC multicast group, this command displays Layer 2 multicast MAC forwarding entries for all MAC multicast groups.

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a VLAN, this command displays Layer 2 multicast MAC forwarding entries for all VLANs.

vsi vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VSI, this command displays Layer 2 MAC forwarding entries for all VSIs.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays Layer 2 multicast MAC forwarding entries on the active MPU. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays Layer 2 multicast MAC group entries on the global active MPU. (In IRF mode.)

cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.

Examples

# Display Layer 2 multicast MAC forwarding entries for VLAN 2.

<Sysname> display l2-multicast mac forwarding vlan 2

Total 1 MAC entries.

VLAN 2: Total 1 MAC entries.

MAC group address: 0100-5e01-0101

Host slots (0 in total):

Host ports (3 in total):

Ten-GigabitEthernet3/1/1

Ten-GigabitEthernet3/1/2

Ten-GigabitEthernet3/1/3

# Display Layer 2 multicast MAC forwarding entries for VSI aaa.

<Sysname> display l2-multicast mac forwarding vsi aaa

Total 1 MAC entries.

VSI aaa: Total 1 MAC entries.

MAC group address: 0100-5e01-0101

Host slots (0 in total):

Host ports (1 in total):

AC (VSI index 0 Link ID 1)

Table 11 Command output

Field	Description
Total 1 MAC entries	Total number of Layer 2 multicast MAC forwarding entries.
VLAN 2: Total 1 MAC entries	Total number of Layer 2 multicast MAC forwarding entries in VLAN 2.
VSI aaa: Total 1 MAC entries	Total number of Layer 2 multicast MAC multicast group entries in VSI aaa.
MAC group address	Address of the MAC multicast group.
Host slots (0 in total)	(In standalone mode.) Slot numbers and total number of the cards that have member ports, except for the specified card or the MPU when no card is specified. (In IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have member ports, except for the specified card or the global active MPU when no card is specified.
Host ports (3 in total)	Member ports and total number of member ports.
AC (VSI index 0 Link ID 1)	AC interface, and its VSI index and link ID.
NPW (VSI index 0 Link ID 1)	N-PW interface, and its VSI index and link ID.
UPW (VSI index 0 Link ID 1)	U-PW interface, and its VSI index and link ID.
NPW (VXLAN ID 0 Link ID 0x5000001)	N-PW interface, and its VXLAN ID and link ID.

enable (IGMP-snooping view)

Use enable to enable IGMP snooping for VLANs.

Use undo enable to disable IGMP snooping for VLANs.

Syntax

enable vlan vlan-list

undo enable vlan vlan-list

Default

IGMP snooping is disabled for a VLAN.

Views

IGMP-snooping view

Predefined user roles

network-admin

Parameters

Usage guidelines

You must enable IGMP snooping globally before you enable IGMP snooping for VLANs.

You can enable IGMP snooping for the specified VLANs in IGMP-snooping view, for a VSI in VSI view, or for a VLAN in VLAN view. For a VLAN, the configuration in IGMP-snooping view has the same priority as the configuration in VLAN view, and the most recent configuration takes effect.

Examples

# Enable IGMP snooping globally, and enable IGMP snooping for VLAN 2 through VLAN 10.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] enable vlan 2 to 10

Related commands

igmp-snooping

igmp-snooping enable

entry-limit (IGMP-snooping view)

Use entry-limit to globally set the maximum number of IGMP snooping forwarding entries, including dynamic entries and static entries.

Use undo entry-limit to restore the default.

Syntax

entry-limit limit

undo entry-limit

Default

The maximum number of IGMP snooping forwarding entries is 4294967295.

Views

IGMP-snooping view

Predefined user roles

network-admin

Parameters

limit: Specifies the maximum number of IGMP snooping forwarding entries, in the range of 0 to 4294967295.

Examples

# Set the global maximum number of IGMP snooping forwarding entries to 512.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] entry-limit 512

fast-leave (IGMP-snooping view)

Use fast-leave to enable fast-leave processing globally.

Use undo fast-leave to disable fast-leave processing globally.

Syntax

fast-leave [ vlan vlan-list ]

undo fast-leave [ vlan vlan-list ]

Default

Fast-leave processing is disabled.

Views

IGMP-snooping view

Predefined user roles

network-admin

Parameters

vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The VLAN ID is in the range of 1 to 4094. If you do not specify a VLAN, this command takes effect on all VLANs and VSIs.

Usage guidelines

The fast-leave processing feature enables the device to immediately remove a port from the forwarding entry for a multicast group when the port receives a leave message.

You can enable fast-leave processing globally for all ports in IGMP-snooping view or for a port in interface view. For a port, the port-specific configuration takes priority over the global configuration.

Examples

# Globally enable fast-leave processing for VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] fast-leave vlan 2

Related commands

igmp-snooping fast-leave

group-policy (IGMP-snooping view)

Use group-policy to globally configure a multicast group policy to control the multicast groups that hosts can join.

Use undo group-policy to globally delete multicast group policies.

Syntax

group-policy ipv4-acl-number [ vlan vlan-list ]

undo group-policy [ vlan vlan-list ]

Default

No multicast group policies exist. Hosts can join any multicast groups.

Views

IGMP-snooping view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

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

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

You can configure a multicast group policy globally for all ports in IGMP-snooping view or for a port in interface view. For a port, the port-specific configuration takes priority over the global configuration.

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

· An ACL rule containing the vpn-instance vpn-instance option does not take effect.

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

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

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

¡ IGMPv1 and IGMPv2 reports.

¡ IGMPv3 IS_EX and IGMPv3 TO_EX reports that do not carry multicast source addresses.

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

You can configure different ACLs for all ports in different VLANs. If you configure multiple ACLs for all ports in the same VLAN, the most recent configuration takes effect.

Examples

# Configure a multicast group policy for VLAN 2 so that hosts in VLAN 2 can join only multicast group 225.1.1.1.

<Sysname> system-view

[Sysname] acl basic 2000

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

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

[Sysname] igmp-snooping

[Sysname-igmp-snooping] group-policy 2000 vlan 2

Related commands

igmp-snooping group-policy

host-aging-time (IGMP-snooping view)

Use host-aging-time to set the aging timer for dynamic member ports globally.

Use undo host-aging-time to restore the default.

Syntax

host-aging-time seconds

undo host-aging-time

Default

The aging timer for dynamic member ports is 260 seconds.

Views

IGMP-snooping view

Predefined user roles

network-admin

Parameters

seconds: Specifies an aging timer for dynamic member ports, in the range of 1 to 8097894 seconds.

Usage guidelines

You can set the timer globally for all VLANs and VSIs in IGMP-snooping view, for a VSI in VSI view, or for a VLAN in VLAN view. For a VSI, the VSI-specific configuration takes priority over the global configuration. For a VLAN, the VLAN-specific configuration takes priority over the global configuration.

To avoid mistakenly deleting multicast group members, set the aging timer for dynamic member ports to be greater than the value calculated by using the following formula:

[ IGMP general query interval ] + [ maximum response time for IGMP general queries ]

As a best practice, set the aging timer of dynamic member ports to the value calculated by using the following formula:

[ IGMP general query interval ] × 2 + [ maximum response time for IGMP general queries ]

Examples

# Set the global aging timer for dynamic member ports to 300 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] host-aging-time 300

Related commands

igmp-snooping host-aging-time

host-tracking (IGMP-snooping view)

Use host-tracking to enable host tracking globally.

Use undo host-tracking to disable host tracking globally.

Syntax

host-tracking

undo host-tracking

Default

Host tracking is disabled.

Views

IGMP-snooping view

Predefined user roles

network-admin

Usage guidelines

You can enable host tracking globally for all VLANs in IGMP-snooping view or for a VLAN in VLAN view. For a VLAN, the global configuration has the same priority as the VLAN-specific configuration.

Examples

# Enable host tracking globally.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] host-tracking

Related commands

display igmp-snooping host-tracking

igmp-snooping host-tracking

igmp-snooping

Use igmp-snooping to enable IGMP snooping globally and enter IGMP-snooping view.

Use undo igmp-snooping to disable IGMP snooping globally.

Syntax

igmp-snooping

undo igmp-snooping

Default

IGMP snooping is disabled globally.

Views

System view

Predefined user roles

network-admin

Examples

# Enable IGMP snooping globally, and enter IGMP-snooping view.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping]

Related commands

enable (IGMP-snooping view)

igmp-snooping enable

igmp-snooping drop-unknown

Use igmp-snooping drop-unknown to enable dropping unknown multicast data packets for a VLAN or VSI.

Use undo igmp-snooping drop-unknown to disable dropping unknown multicast data packets for a VLAN or VSI.

Syntax

igmp-snooping drop-unknown

undo igmp-snooping drop-unknown

Default

Dropping unknown multicast data packets is disabled. Unknown multicast data packets are flooded.

Views

VLAN view

VSI view

Predefined user roles

network-admin

Usage guidelines

You must enable IGMP snooping for a VLAN or VSI before you execute this command.

Examples

# In VLAN 2, enable IGMP snooping, and enable dropping unknown multicast data packets.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping drop-unknown

# In VSI aaa, enable IGMP snooping, and enable dropping unknown multicast data packets.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vsi aaa

[Sysname-vsi-aaa] igmp-snooping enable

[Sysname-vsi-aaa] igmp-snooping drop-unknown

Related commands

enable (IGMP-snooping view)

igmp-snooping enable

Use igmp-snooping enable to enable IGMP snooping for a VLAN or VSI.

Use undo igmp-snooping enable to disable IGMP snooping for a VLAN or VSI.

Syntax

igmp-snooping enable

undo igmp-snooping enable

Default

IGMP snooping is disabled for a VLAN or VSI.

Views

VLAN view

VSI view

Predefined user roles

network-admin

Usage guidelines

You must enable the IGMP snooping feature by using the igmp-snooping command before you enable IGMP snooping for a VLAN or VSI.

You can enable IGMP snooping for a VLAN by using this command in VLAN view or for multiple VLANs by using the enable command in IGMP-snooping view. The configuration in VLAN view has the same priority as the configuration in IGMP-snooping view, and the most recent configuration takes effect.

Examples

# Enable IGMP snooping globally, and enable IGMP snooping for VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

# Enable IGMP snooping globally, and enable IGMP snooping for VSI aaa.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vsi aaa

[Sysname-vsi-aaa] igmp-snooping enable

Related commands

enable (IGMP-snooping view)

igmp-snooping

igmp-snooping fast-leave

Use igmp-snooping fast-leave to enable fast-leave processing on a port.

Use undo igmp-snooping fast-leave to disable fast-leave processing on a port.

Syntax

igmp-snooping fast-leave [ vlan vlan-list ]

undo igmp-snooping fast-leave [ vlan vlan-list ]

Default

Fast-leave processing is disabled on a port.

Views

Layer 2 Ethernet interface view

Layer 2 aggregate interface view

Predefined user roles

network-admin

Parameters

Usage guidelines

The fast-leave processing feature enables the device to immediately remove a port from the forwarding entry for a multicast group when the port receives a leave message.

You can enable fast-leave processing for a port in interface view or globally for all ports in IGMP-snooping view. For a port, the port-specific configuration takes priority over the global configuration.

Examples

# Enable fast-leave processing for VLAN 2 on Ten-GigabitEthernet 3/1/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/1/1

[Sysname-Ten-GigabitEthernet3/1/1] igmp-snooping fast-leave vlan 2

Related commands

fast-leave (IGMP-snooping view)

igmp-snooping general-query source-ip

Use igmp-snooping general-query source-ip to configure the source IP address for IGMP general queries.

Use undo igmp-snooping general-query source-ip to restore the default.

Syntax

igmp-snooping general-query source-ip ip-address

undo igmp-snooping general-query source-ip

Default

In a VLAN, the source IP address of IGMP general queries is the IP address of the current VLAN interface. If the current VLAN interface does not have an IP address, the source IP address is 0.0.0.0.

In a VSI, the source IP address of IGMP general queries is the IP address of the gateway interface for the VSI. If the gateway interface does not have an interface, the source IP address is 0.0.0.0.

Views

VLAN view

VSI view

Predefined user roles

network-admin

Parameters

ip-address: Specifies the source IP address for IGMP general queries.

Usage guidelines

You must enable IGMP snooping for a VLAN or VSI before you execute this command.

Examples

# In VLAN 2, enable IGMP snooping, and specify 10.1.1.1 as the source IP address of IGMP general queries.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping general-query source-ip 10.1.1.1

# In VSI aaa, enable IGMP snooping, and specify 10.1.1.1 as the source IP address of IGMP general queries.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vsi aaa

[Sysname-vsi-aaa] igmp-snooping enable

[Sysname-vsi-aaa] igmp-snooping general-query source-ip 10.1.1.1

Related commands

enable (IGMP-snooping view)

igmp-snooping enable

igmp-snooping group-limit

Use igmp-snooping group-limit to set the maximum number of multicast groups that a port can join.

Use undo igmp-snooping group-limit to remove the limit on the maximum number of multicast groups that a port can join.

Syntax

igmp-snooping group-limit limit [ vlan vlan-list ]

undo igmp-snooping group-limit [ vlan vlan-list ]

Default

No limit is placed on the maximum number of multicast groups that a port can join.

Views

Layer 2 Ethernet interface view

Layer 2 aggregate interface view

Predefined user roles

network-admin

Parameters

limit: Specifies the maximum number of multicast groups that a port can join, in the range of 0 to 4294967295.

Usage guidelines

This command takes effect only on the multicast groups that a port joins dynamically.

Examples

# On Ten-GigabitEthernet 3/1/1, set the maximum number of multicast groups the port can join in VLAN 2 to 10.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/1/1

[Sysname-Ten-GigabitEthernet3/1/1] igmp-snooping group-limit 10 vlan 2

igmp-snooping group-policy

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

Use undo igmp-snooping group-policy to delete multicast group policies on a port.

Syntax

igmp-snooping group-policy ipv4-acl-number [ vlan vlan-list ]

undo igmp-snooping group-policy [ vlan vlan-list ]

Default

No multicast group polices exist on a port. Hosts attached to the port can join any multicast groups.

Views

Layer 2 Ethernet interface view

Layer 2 aggregate interface view

Predefined user roles

network-admin

Parameters

Usage guidelines

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

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

You can configure a multicast group policy for a port in interface view or globally for all ports in IGMP-snooping view. For a port, the port-specific configuration takes priority over the global configuration.

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

· An ACL rule containing the vpn-instance vpn-instance option does not take effect.

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

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

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

¡ IGMPv1 and IGMPv2 reports.

¡ IGMPv3 IS_EX and IGMPv3 TO_EX reports that do not carry multicast source addresses.

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

You can configure different ACLs on a port for different VLANs. If you configure multiple ACLs on a port for the same VLAN, the most recent configuration takes effect.

Examples

# On Ten-GigabitEthernet 3/1/1, configure a multicast group policy for VLAN 2 so that hosts in VLAN 2 can join only multicast group 225.1.1.1.

<Sysname> system-view

[Sysname] acl basic 2000

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

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

[Sysname] interface ten-gigabitethernet 3/1/1

[Sysname-Ten-GigabitEthernet3/1/1] igmp-snooping group-policy 2000 vlan 2

Related commands

group-policy (IGMP-snooping view)

igmp-snooping host-aging-time

Use igmp-snooping host-aging-time to set the aging timer for dynamic member ports in a VLAN or VSI.

Use undo igmp-snooping host-aging-time to restore the default.

Syntax

igmp-snooping host-aging-time seconds

undo igmp-snooping host-aging-time

Default

The aging timer for dynamic member ports is 260 seconds.

Views

VLAN view

VSI view

Predefined user roles

network-admin

Parameters

seconds: Specifies an aging timer for dynamic member ports, in the range of 1 to 8097894 seconds.

Usage guidelines

You must enable IGMP snooping for a VLAN or VSI before you execute this command.

You can set the timer for a VLAN in VLAN view, for a VSI in VSI view, or globally for all VLANs and VSIs in IGMP-snooping view. For a VLAN, the VLAN-specific configuration takes priority over the global configuration. For a VSI, the VSI-specific configuration takes priority over the global configuration.

To avoid mistakenly deleting multicast group members, set the aging timer for dynamic member ports to be greater than the value calculated by using the following formula:

[ IGMP general query interval ] + [ maximum response time for IGMP general queries ]

As a best practice, set the aging timer of dynamic member ports to the value calculated by using the following formula:

[ IGMP general query interval ] × 2 + [ maximum response time for IGMP general queries ]

Examples

# In VLAN 2, enable IGMP snooping, and set the aging timer for dynamic member ports to 300 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping host-aging-time 300

# In VSI aaa, enable IGMP snooping, and set the aging timer for dynamic member ports to 300 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vsi aaa

[Sysname-vsi-aaa] igmp-snooping enable

[Sysname-vsi-aaa] igmp-snooping host-aging-time 300

Related commands

enable (IGMP-snooping view)

host-aging-time (IGMP-snooping view)

igmp-snooping enable

igmp-snooping host-join

Use igmp-snooping host-join to configure a port as a simulated member host for a multicast group.

Use undo igmp-snooping host-join to remove the configuration of a simulated member host for a multicast group.

Syntax

igmp-snooping host-join group-address [ source-ip source-address ] vlan vlan-id

undo igmp-snooping host-join { group-address [ source-ip source-address ] vlan vlan-id | all }

Default

A port is not configured as a simulated member host for multicast groups.

Views

Layer 2 Ethernet interface view

Layer 2 aggregate interface view

Predefined user roles

network-admin

Parameters

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

source-ip source-address: Specifies a multicast source by its IP address. If you specify a multicast source, this command configures the port as a simulated member host for a multicast source and group. If you do not specify a multicast source, this command configures the port as a simulated member host for a multicast group. This option takes effect on IGMPv3 snooping devices.

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094.

all: Specifies all multicast groups.

Usage guidelines

The version of IGMP running on a simulated member host is the same as the version of IGMP snooping running on the port. The port ages out in the same way as a dynamic member port.

Examples

# Configure Ten-GigabitEthernet 3/1/1 as a simulated member host of the multicast source and group (1.1.1.1, 232.1.1.1) in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping version 3

[Sysname-vlan2] quit

[Sysname] interface ten-gigabitethernet 3/1/1

[Sysname-Ten-GigabitEthernet3/1/1] igmp-snooping host-join 232.1.1.1 source-ip 1.1.1.1 vlan 2

igmp-snooping host-tracking

Use igmp-snooping host-tracking to enable host tracking for a VLAN.

Use undo igmp-snooping host-tracking to disable host tracking for a VLAN.

Syntax

igmp-snooping host-tracking

undo igmp-snooping host-tracking

Default

Host tracking is disabled.

Views

VLAN view

Predefined user roles

network-admin

Usage guidelines

You must enable IGMP snooping for a VLAN before you execute this command for the VLAN.

You can enable host tracking for a VLAN in VLAN view or globally for all VLANs in IGMP-snooping view. For a VLAN, the VLAN-specific configuration has the same priority as the global configuration.

Examples

# In VLAN 2, enable IGMP snooping and then host tracking.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping host-tracking

Related commands

display igmp-snooping host-tracking

host-tracking (IGMP-snooping view)

igmp-snooping enable

igmp-snooping last-member-query-interval

Use igmp-snooping last-member-query-interval to set the IGMP last member query interval for a VLAN or VSI.

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

Syntax

igmp-snooping last-member-query-interval interval

undo igmp-snooping last-member-query-interval

Default

The IGMP last member query interval is 1 second.

Views

VLAN view

VSI view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

You must enable IGMP snooping for a VLAN or VSI before you execute this command.

You can set the interval for a VLAN in VLAN view, for a VSI in VSI view, or globally for all VLANs and VSIs in IGMP-snooping view. For a VLAN, the VLAN-specific configuration takes priority over the global configuration. For a VSI, the VSI-specific configuration takes priority over the global configuration.

Examples

# In VLAN 2, enable IGMP snooping, and set the IGMP last member query interval to 3 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

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

# In VSI aaa, enable IGMP snooping, and set the IGMP last member query interval to 3 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vsi aaa

[Sysname-vsi-aaa] igmp-snooping enable

[Sysname-vsi-aaa] igmp-snooping last-member-query-interval 3

Related commands

enable (IGMP-snooping view)

igmp-snooping enable

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

igmp-snooping leave source-ip

Use igmp-snooping leave source-ip to configure the source IP address for IGMP leave messages.

Use undo igmp-snooping leave source-ip to restore the default.

Syntax

igmp-snooping leave source-ip ip-address

undo igmp-snooping leave source-ip

Default

In a VLAN, the source IP address of IGMP leave messages is the IP address of the current VLAN interface. If the current VLAN interface does not have an IP address, the source IP address is 0.0.0.0.

In a VSI, the source IP address of IGMP leave messages is the IP address of the gateway interface for the VSI. If the gateway interface does not have an IP address, the source IP address is 0.0.0.0.

Views

VLAN view

VSI view

Predefined user roles

network-admin

Parameters

ip-address: Specifies the source IP address for IGMP leave messages.

Usage guidelines

You must enable IGMP snooping for a VLAN before you execute this command.

Examples

# In VLAN 2, enable IGMP snooping, and specify 10.1.1.1 as the source IP address of IGMP leave messages.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping leave source-ip 10.1.1.1

# In VSI aaa, enable IGMP snooping, and specify 10.1.1.1 as the source IP address of IGMP leave messages.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vsi aaa

[Sysname-vsi-aaa] igmp-snooping enable

[Sysname-vsi-aaa] igmp-snooping leave source-ip 10.1.1.1

Related commands

enable (IGMP-snooping view)

igmp-snooping enable

igmp-snooping max-response-time

Use igmp-snooping max-response-time to set the maximum response time for IGMP general queries in a VLAN or VSI.

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

Syntax

igmp-snooping max-response-time seconds

undo igmp-snooping max-response-time

Default

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

Views

VLAN view

VSI view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

You must enable IGMP snooping for a VLAN or VSI before you execute this command.

You can set the time for a VLAN in VLAN view, for a VSI in VSI view, or globally for all VLANs and VSIs in IGMP-snooping view. For a VLAN, the VLAN-specific configuration takes priority over the global configuration. For a VSI, the VSI-specific configuration takes priority over the global configuration.

To avoid mistakenly deleting multicast group members, set the maximum response time for IGMP general queries to be less than the IGMP general query interval.

Examples

# In VLAN 2, enable IGMP snooping, and set the maximum response time for IGMP general queries to 5 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping max-response-time 5

# In VSI aaa, enable IGMP snooping, and set the maximum response time for IGMP general queries to 5 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vsi aaa

[Sysname-vsi-aaa] igmp-snooping enable

[Sysname-vsi-aaa] igmp-snooping max-response-time 5

Related commands

enable (IGMP-snooping view)

igmp-snooping enable

igmp-snooping query-interval

max-response-time (IGMP-snooping view)

igmp-snooping overflow-replace

Use igmp-snooping overflow-replace to enable multicast group replacement on a port.

Use undo igmp-snooping overflow-replace to disable multicast group replacement on a port.

Syntax

igmp-snooping overflow-replace [ vlan vlan-list ]

undo igmp-snooping overflow-replace [ vlan vlan-list ]

Default

Multicast group replacement is disabled.

Views

Layer 2 Ethernet interface view

Layer 2 aggregate interface view

Predefined user roles

network-admin

Parameters

Usage guidelines

This command takes effect only on the multicast groups that a port joins dynamically.

You can enable multicast group replacement for a port in interface view or globally for all ports in IGMP-snooping view. For a port, the port-specific configuration takes priority over the global configuration.

Examples

# On Ten-GigabitEthernet 3/1/1, enable multicast group replacement for VLAN 2.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/1/1

[Sysname-Ten-GigabitEthernet3/1/1] igmp-snooping overflow-replace vlan 2

Related commands

overflow-replace (IGMP-snooping view)

igmp-snooping proxy enable

Use igmp-snooping proxy enable to enable IGMP snooping proxying for a VLAN.

Use undo igmp-snooping proxy enable to disable IGMP snooping proxying for a VLAN.

Syntax

igmp-snooping proxy enable

undo igmp-snooping proxy enable

Default

IGMP snooping proxying is disabled.

Views

VLAN view

Predefined user roles

network-admin

Usage guidelines

You must enable IGMP snooping for a VLAN before you execute this command.

This command does not take effect on a VLAN that is a sub-VLAN of a multicast VLAN.

Examples

# In VLAN 2, enable IGMP snooping and then IGMP snooping proxying.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping proxy enable

Related commands

enable (IGMP-snooping view)

igmp-snooping enable

subvlan (multicast-VLAN view)

igmp-snooping querier

Use igmp-snooping querier to enable the IGMP snooping querier.

Use undo igmp-snooping querier to disable the IGMP snooping querier.

Syntax

igmp-snooping querier

undo igmp-snooping querier

Default

The IGMP snooping querier is disabled.

Views

VLAN view

VSI view

Predefined user roles

network-admin

Usage guidelines

You must enable IGMP snooping for a VLAN or VSI before you execute this command.

For a sub-VLAN of a multicast VLAN, this command takes effect only after you remove the sub-VLAN from the multicast VLAN.

Examples

# In VLAN 2, enable IGMP snooping, and enable the IGMP snooping querier.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping querier

# In VSI aaa, enable IGMP snooping, and enable the IGMP snooping querier.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vsi aaa

[Sysname-vsi-aaa] igmp-snooping enable

[Sysname-vsi-aaa] igmp-snooping querier

Related commands

enable (IGMP-snooping view)

igmp-snooping enable

subvlan (multicast VLAN view)

igmp-snooping query-interval

Use igmp-snooping query-interval to set the IGMP general query interval for a VLAN or VSI.

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

Syntax

igmp-snooping query-interval interval

undo igmp-snooping query-interval

Default

The IGMP general query interval is 125 seconds.

Views

VLAN view

VSI view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

You must enable IGMP snooping for a VLAN or VSI before you execute this command.

To avoid mistakenly deleting multicast group members, set the IGMP general query interval to be greater than the maximum response time for IGMP general queries.

Examples

# In VLAN 2, enable IGMP snooping, and set the IGMP general query interval to 20 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping query-interval 20

# In VSI aaa, enable IGMP snooping, and set the IGMP general query interval to 20 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vsi aaa

[Sysname-vsi-aaa] igmp-snooping enable

[Sysname-vsi-aaa] igmp-snooping query-interval 20

Related commands

enable (IGMP-snooping view)

igmp-snooping enable

igmp-snooping max-response-time

igmp-snooping querier

max-response-time

igmp-snooping report source-ip

Use igmp-snooping report source-ip to configure the source IP address for IGMP reports.

Use undo igmp-snooping report source-ip to restore the default.

Syntax

igmp-snooping report source-ip ip-address

undo igmp-snooping report source-ip

Default

In a VLAN, the source IP address of IGMP reports is the IP address of the current VLAN interface. If the current VLAN interface does not have an IP address, the source IP address is 0.0.0.0.

In a VSI, the source IP address of IGMP reports is the IP address of the gateway interface for the VSI. If the gateway interface does not have an IP address, the source IP address is 0.0.0.0.

Views

VLAN view

VSI view

Predefined user roles

network-admin

Parameters

ip-address: Specifies the source IP address for IGMP reports.

Usage guidelines

You must enable IGMP snooping for a VLAN before you execute this command.

Examples

# In VLAN 2, enable IGMP snooping, and specify 10.1.1.1 as the source IP address of IGMP reports.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping report source-ip 10.1.1.1

# In VSI aaa, enable IGMP snooping, and specify 10.1.1.1 as the source IP address of IGMP reports.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vsi aaa

[Sysname-vsi-aaa] igmp-snooping enable

[Sysname-vsi-aaa] igmp-snooping report source-ip 10.1.1.1

Related commands

enable (IGMP-snooping view)

igmp-snooping enable

igmp-snooping router-aging-time

Use igmp-snooping router-aging-time to set the aging timer for dynamic router ports in a VLAN or VSI.

Use undo igmp-snooping router-aging-time to restore the default.

Syntax

igmp-snooping router-aging-time seconds

undo igmp-snooping router-aging-time

Default

The aging timer for dynamic router ports is 260 seconds.

Views

VLAN view

VSI view

Predefined user roles

network-admin

Parameters

seconds: Specifies an aging timer for dynamic router ports, in the range of 1 to 8097894 seconds.

Usage guidelines

You must enable IGMP snooping for a VLAN or VSI before you execute this command.

Examples

# In VLAN 2, enable IGMP snooping, and set the aging timer for dynamic router ports to 100 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping router-aging-time 100

# In VSI aaa, enable IGMP snooping, and set the aging timer for dynamic router ports to 100 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vsi aaa

[Sysname-vsi-aaa] igmp-snooping enable

[Sysname-vsi-aaa] igmp-snooping router-aging-time 100

Related commands

enable (IGMP-snooping view)

igmp-snooping enable

router-aging-time (IGMP-snooping view)

igmp-snooping router-port-deny

Use igmp-snooping router-port-deny to disable a port from becoming a dynamic router port.

Use undo igmp-snooping router-port-deny to allow a port to become a dynamic router port.

Syntax

igmp-snooping router-port-deny [ vlan vlan-list ]

undo igmp-snooping router-port-deny [ vlan vlan-list ]

Default

A port is allowed to become a dynamic router port.

Views

Layer 2 Ethernet interface view

Layer 2 aggregate interface view

Predefined user roles

network-admin

Parameters

vlan vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The VLAN ID is in the range of 1 to 4094. If you specify VLANs, this command takes effect only when the port belongs to the specified VLANs. If you do not specify a VLAN, this command takes effect on all VLANs to which the port belongs.

Examples

# Disable Ten-GigabitEthernet 3/1/1 from becoming a dynamic router port in VLAN 2.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/1/1

[Sysname-Ten-GigabitEthernet3/1/1] igmp-snooping router-port-deny vlan 2

igmp-snooping special-query source-ip

Use igmp-snooping special-query source-ip to configure the source IP address for IGMP group-specific queries.

Use undo igmp-snooping special-query source-ip to restore the default.

Syntax

igmp-snooping special-query source-ip ip-address

undo igmp-snooping special-query source-ip

Default

In a VLAN, the source IP address of IGMP group-specific queries is one of the following:

· The source address of IGMP group-specific queries if the IGMP snooping querier of the VLAN has received IGMP general queries.

· The IP address of the current VLAN interface if the IGMP snooping querier does not receive an IGMP general query.

· 0.0.0.0 if the IGMP snooping querier does not receive an IGMP general query and the current VLAN interface does not have an IP address.

In a VSI, the source IP address of IGMP group-specific queries is one of the following:

· The source IP address of IGMP general queries if the IGMP snooping querier of the VSI has received IGMP general queries.

· The IP address of the gateway interface for the VSI if the IGMP snooping querier does not receive an IGMP general query.

· 0.0.0.0 if the gateway interface for the VSI does not have an IP address.

Views

VLAN view

VSI view

Predefined user roles

network-admin

Parameters

ip-address: Specifies the source IP address for IGMP group-specific queries.

Usage guidelines

You must enable IGMP snooping for a VLAN or VSI before you execute this command.

Examples

# In VLAN 2, enable IGMP snooping, and specify 10.1.1.1 as the source IP address of IGMP group-specific queries.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping special-query source-ip 10.1.1.1

# In VSI aaa, enable IGMP snooping, and specify 10.1.1.1 as the source IP address of IGMP group-specific queries.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vsi aaa

[Sysname-vsi-aaa] igmp-snooping enable

[Sysname-vsi-aaa] igmp-snooping special-query source-ip 10.1.1.1

Related commands

enable (IGMP-snooping view)

igmp-snooping enable

igmp-snooping static-group

Use igmp-snooping static-group to configure a port as a static member port of a multicast group.

Use undo igmp-snooping static-group to remove the configuration of static member ports.

Syntax

igmp-snooping static-group group-address [ source-ip source-address ] vlan vlan-id

undo igmp-snooping static-group { group-address [ source-ip source-address ] vlan vlan-id | all }

Default

A port is not a static member port of a multicast group.

Views

Layer 2 Ethernet interface view

Layer 2 aggregate interface view

Predefined user roles

network-admin

Parameters

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

source-ip source-address: Specifies a multicast source by its IP address. If you specify a multicast source, this command configures the port as a static member port for a multicast source and group. If you do not specify a multicast source, this command configures the port as a static member port for a multicast group. This option takes effect on IGMPv3 snooping devices.

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094.

all: Specifies all multicast groups.

Examples

# Configure Ten-GigabitEthernet 3/1/1 as a static member port of the multicast source and group (1.1.1.1, 225.0.0.1) in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping version 3

[Sysname-vlan2] quit

[Sysname] interface Ten-GigabitEthernet 3/1/1

[Sysname-Ten-GigabitEthernet3/1/1] igmp-snooping static-group 225.0.0.1 source-ip 1.1.1.1 vlan 2

igmp-snooping static-router-port

Use igmp-snooping static-router-port to configure a port as a static router port.

Use undo igmp-snooping static-router-port to remove the configuration of static router ports.

Syntax

igmp-snooping static-router-port vlan vlan-id

undo igmp-snooping static-router-port { all | vlan vlan-id }

Default

A port is not a static router port.

Views

Layer 2 Ethernet interface view

Layer 2 aggregate interface view

Predefined user roles

network-admin

Parameters

all: Specifies all VLANs.

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094.

Examples

# Configure Ten-GigabitEthernet 3/1/1 as a static router port in VLAN 2.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 3/1/1

[Sysname-Ten-GigabitEthernet3/1/1] igmp-snooping static-router-port vlan 2

igmp-snooping version

Use igmp-snooping version to specify an IGMP snooping version for a VLAN or VSI.

Use undo igmp-snooping version to restore the default.

Syntax

igmp-snooping version version-number

undo igmp-snooping version

Default

The IGMP snooping version in a VLAN or VSI is 2.

Views

VLAN view

VSI view

Predefined user roles

network-admin

Parameters

version-number: Specifies an IGMP snooping version, 2 or 3.

Usage guidelines

You must enable IGMP snooping for a VLAN or VSI before you execute this command.

You can specify the version for a VLAN in VLAN view or for the specified VLANs in IGMP-snooping view. The VLAN-specific configuration has the same priority as the configuration in IGMP-snooping view, and the most recent configuration takes effect.

Examples

# In VLAN 2, enable IGMP snooping, and specify IGMP snooping version 3.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping version 3

# In VSI aaa, enable IGMP snooping, and specify IGMP snooping version 3.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vsi aaa

[Sysname-vsi-aaa] igmp-snooping enable

[Sysname-vsi-aaa] igmp-snooping version 3

Related commands

enable (IGMP-snooping view)

igmp-snooping enable

version (IGMP-snooping view)

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

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

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

Syntax

last-member-query-interval interval

undo last-member-query-interval

Default

The IGMP last member query interval is 1 second.

Views

IGMP-snooping view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

Examples

# Set the global IGMP last member query interval to 3 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

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

Related commands

igmp-snooping last-member-query-interval

max-response-time (IGMP-snooping view)

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

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

Syntax

max-response-time seconds

undo max-response-time

Default

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

Views

IGMP-snooping view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

To avoid mistakenly deleting multicast group members, set the maximum response time for IGMP general queries to be less than the IGMP general query interval.

Examples

# Set the global maximum response time for IGMP general queries to 5 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] max-response-time 5

Related commands

igmp-snooping max-response-time

igmp-snooping query-interval

overflow-replace (IGMP-snooping view)

Use overflow-replace to enable the multicast group replacement feature globally.

Use undo overflow-replace to disable the multicast group replacement feature globally.

Syntax

overflow-replace [ vlan vlan-list ]

undo overflow-replace [ vlan vlan-list ]

Default

The multicast group replacement feature is disabled.

Views

IGMP-snooping view

Predefined user roles

network-admin

Parameters

Usage guidelines

This command takes effect only on the multicast groups that a port joins dynamically.

You can enable the multicast group replacement feature globally for all ports in IGMP-snooping view or for a port in interface view. For a port, the port-specific configuration takes priority over the global configuration.

Examples

# Globally enable the multicast group replacement feature for VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] overflow-replace vlan 2

Related commands

igmp-snooping overflow-replace

report-aggregation (IGMP-snooping view)

Use report-aggregation to enable IGMP report suppression.

Use undo report-aggregation to disable IGMP report suppression.

Syntax

report-aggregation

undo report-aggregation

Default

IGMP report suppression is enabled.

Views

IGMP-snooping view

Predefined user roles

network-admin

Examples

# Disable IGMP report suppression.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] undo report-aggregation

reset igmp-snooping group

Use reset igmp-snooping group to clear dynamic IGMP snooping group entries.

Syntax

reset igmp-snooping group { group-address [ source-address ] | all } [ vlan vlan-id | vsi vsi-name ]

Views

User view

Predefined user roles

network-admin

Parameters

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

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

all: Specifies all multicast groups.

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a VLAN, this command clears dynamic IGMP snooping group entries for all VLANs.

vsi vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VSI, this command clears dynamic IGMP snooping group entries for all VSIs.

Examples

# Clear all dynamic IGMP snooping group entries.

<Sysname> reset igmp-snooping group all

Related commands

display igmp-snooping group

reset igmp-snooping router-port

Use reset igmp-snooping router-port to clear dynamic router port information.

Syntax

reset igmp-snooping router-port { all | vlan vlan-id | vsi vsi-name }

Views

User view

Predefined user roles

network-admin

Parameters

all: Specifies all dynamic router ports.

vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a VLAN, this command clears dynamic router port information for all VLANs.

vsi vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VSI, this command clears dynamic router port information for all VSIs.

Examples

# Clear dynamic router port information.

<Sysname> reset igmp-snooping router-port all

Related commands

display igmp-snooping router-port

reset igmp-snooping statistics

Use reset igmp-snooping statistics to clear statistics for IGMP messages and PIMv2 hello messages learned through IGMP snooping.

Syntax

reset igmp-snooping statistics

Views

User view

Predefined user roles

network-admin

Examples

# Clear the statistics for all IGMP messages and PIMv2 hello messages learned through IGMP snooping.

<Sysname> reset igmp-snooping statistics

Related commands

display igmp-snooping statistics

router-aging-time (IGMP-snooping view)

Use router-aging-time to set the aging timer for dynamic router ports globally.

Use undo router-aging-time to restore the default.

Syntax

router-aging-time seconds

undo router-aging-time

Default

The aging timer for dynamic router ports is 260 seconds.

Views

IGMP-snooping view

Predefined user roles

network-admin

Parameters

seconds: Specifies an aging timer for dynamic router ports, in the range of 1 to 8097894 seconds.

Usage guidelines

Examples

# Set the global aging timer for dynamic router ports to 100 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] router-aging-time 100

Related commands

igmp-snooping router-aging-time

snmp-agent trap enable igmp-snooping

Use snmp-agent trap enable igmp-snooping to enable SNMP notifications for IGMP snooping.

Use undo snmp-agent trap enable igmp-snooping to disable SNMP notifications for IGMP snooping.

Syntax

snmp-agent trap enable igmp-snooping [ global-entry-exceed ]

undo snmp-agent trap enable igmp-snooping [ global-entry-exceed ]

Default

SNMP notifications for IGMP snooping are enabled.

Views

System view

Predefined user roles

network-admin

Parameters

global-entry-exceed: Specifies notifications about the number of IGMP snooping forwarding entries (including dynamic entries and static entries) reaching the maximum number. If you do not specify this keyword, the command enables or disables all SNMP notifications for IGMP snooping.

Usage guidelines

The maximum number of IGMP snooping forwarding entries is configured by using the entry-limit command.

To report critical IGMP snooping events to an NMS, enable SNMP notifications for IGMP snooping. For IGMP snooping event notifications to be sent correctly, you must also configure SNMP on the device. For more information about SNMP configuration, see Network Management and Monitoring Configuration Guide.

Examples

# Disable all SNMP notifications for IGMP snooping.

<Sysname> system-view

[Sysname] undo snmp-agent trap enable igmp-snooping global-entry-exceed

version (IGMP-snooping view)

Use version to specify an IGMP snooping version for VLANs.

Use undo version to restore the default.

Syntax

version version-number vlan vlan-list

undo version vlan vlan-list

Default

The IGMP snooping version in a VLAN is 2.

Views

IGMP-snooping view

Predefined user roles

network-admin

Parameters

version-number: Specifies an IGMP snooping version, 2 or 3.

Usage guidelines

You must enable IGMP snooping for the specified VLANs before you execute this command.

You can specify the version for the specified VLANs in IGMP-snooping view, for a VSI in VSI view, or for a VLAN in VLAN view. For a VLAN, the configuration in IGMP-snooping view has the same priority as the configuration in VLAN view, and the most recent configuration takes effect.

Examples

# Enable IGMP snooping for VLAN 2 through VLAN 10, and specify IGMP snooping version 3 for these VLANs.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] enable vlan 2 to 10

[Sysname-igmp-snooping] version 3 vlan 2 to 10

Related commands

enable (IGMP-snooping view)

igmp-snooping enable

igmp-snooping version

08-IP Multicast Command Reference

IGMP snooping commands

display igmp-snooping host-tracking

igmp-snooping last-member-query-interval

igmp-snooping leave source-ip

igmp-snooping overflow-replace

overflow-replace (IGMP-snooping view)

snmp-agent trap enable igmp-snooping

Cloud & AI

InterConnect

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Resources

Partner Business Management

Company Information

News & Events

Contact Us