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 [ inc-step-mask { group-mask | group-mask-length } number group-number ] [ source source-address ] { qinq pe-vid pe-vid ce-vid low-ce-vid [ to high-ce-vid ] | dot1q vid low-pe-vid [ to high-pe-vid ] } (S5720-EI, S5720-HI, S5730-HI, S5731-H, S5731-S, S5731S-H, S5731S-S, S5732-H, S6720-EI, S6720-HI, S6720S-EI, S6730-H, S6730S-H, S6730-S, and S6730S-S)

undo igmp static-group group-address [ inc-step-mask { group-mask | group-mask-length } number group-number ] [ source source-address ] { qinq pe-vid pe-vid ce-vid low-ce-vid [ to high-ce-vid ] | dot1q vid low-pe-vid [ to high-pe-vid ] } (S5720-EI, S5720-HI, S5730-HI, S5731-H, S5731-S, S5731S-H, S5731S-S, S5732-H, S6720-EI, S6720-HI, S6720S-EI, S6730-H, S6730S-H, S6730-S, and S6730S-S)

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. If the specified static group address is an SSM group address, you must specify a multicast source address for the group.	The address is in dotted decimal notation.
all	Indicates all multicast groups that an interface statically joins.	-
qinq	Statically adds a sub-interface for QinQ Virtual Local Area Network (VLAN) tag termination to a multicast group.	-
pe-vid pe-vid	Specifies the ID of the outer VLAN tag.	The value is a decimal integer that ranges from 1 to 4094.
ce-vid	Indicates the ID of the inner VLAN tag.	-
low-ce-vid	Specifies the lower limit of the CE-VLAN ID (inner VLAN tag).	The value is a decimal integer that ranges from 1 to 4094.
to	Indicates a value range.	-
high-ce-vid	Specifies the upper limit of the CE-VLAN ID (inner VLAN tag).	The value is a decimal integer that ranges from 1 to 4094. The value of high-ce-vid cannot be smaller than that of low-ce-vid. By default, the values of high-ce-vid and low-ce-vid are the same.
dot1q	Statically adds a sub-interface for dot1q VLAN tag termination to a multicast group.	-
vid	Indicates the VLAN ID.	-
low-pe-vid	Specifies the lower limit of PE-VLAN ID (outer VLAN tag).	The value is a decimal integer that ranges from 1 to 4094.
high-pe-vid	Specifies the upper limit of PE-VLAN ID (outer VLAN tag).	The value is a decimal integer that ranges from 1 to 4094. The value of high-pe-vid cannot be smaller than that of low-pe-vid. By default, the values of high-pe-vid and low-pe-vid are the same.

Views

GE interface view, XGE interface view, MultiGE interface view, 25GE interface view, 40GE interface view, 100GE interface view, Eth-Trunk interface view, GE sub-interface view, XGE sub-interface view, MultiGE sub-interface view, 25GE sub-interface view, 40GE sub-interface view, 100GE sub-interface view, Eth-Trunk sub-interface view, VLANIF interface view, loopback interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The following are two scenarios in which you can configure static multicast groups on user-side interfaces of the switch:

There are long-term group members on a shared network segment, and the switch needs to forward multicast data to these group members quickly and steadily.
A network segment has no group member or hosts on the network segment cannot send Report messages, but multicast data needs to be sent to this network segment.

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

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

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command.

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 switch considers that this interface is always connected to group members, and keeps forwarding multicast packets of the specified multicast groups to the network segment of the interface.
After you run the igmp static-group command without specifying the qinq or dot1q keyword to configure batch multicast static groups for the first time and when you run this command again, the new configuration overwrites the previous one if only the value of group-number is changed but the values of group-address and group-mask | group-mask-length are the same.

After you run the igmp static-group command with specifying the qinq or dot1q keyword to configure batch multicast static groups for the first time and when you run this command again, the new configuration overwrites the previous one if only the value of group-number is changed but the values of group-address and group-mask | group-mask-length and the values of tag parameters the same. If the values of tag parameters are different, the device considers that the later command is different from the first one and the new configuration does not overwrite the previous configuration.
You can specify the qinq keyword for only the sub-interface for QinQ VLAN tag termination and dot1q keyword for only the sub-interface for dot1q VLAN tag termination. The static group with tag parameters can be configured only on the sub-interface for QinQ VLAN tag termination or the sub-interface for dot1q VLAN tag termination.
When the interface is configured with multiple VLAN tags, you must specify the qinq or dot1q keyword. The multicast source address cannot be specified in such a case. That is, source address and the qinq or dot1q keyword cannot be specified at the same time.
The specified range of VLAN IDs must be consistent with that specified in the dot1q termination vid command or the qinq termination pe-vid ce-vid command. If they are inconsistent, only the intersected tag values take effect.
When the interface that connects a multicast device to the user network segment joins a multicast group in both dynamic and static modes, the interface preferentially joins the multicast group in static mode if a conflict occurs.
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.
Do not statically add an interface to multicast groups if the interface is in the PIM NDR or assert loser state, because such an interface will not be added to the PIM outbound interface list.

Example

# Configure static multicast group 224.1.1.1 on VLANIF100.

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

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

<HUAWEI> system-view
[HUAWEI] multicast routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] igmp static-group 232.1.1.1 source 192.168.11.1

# Configure 10 static multicast groups on VLANIF100 in a batch. Set the start multicast group address to 225.1.1.1 and the step mask length to 32.

<HUAWEI> system-view
[HUAWEI] multicast routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] igmp static-group 225.1.1.1 inc-step-mask 32 number 10

# Configure 10 source-group bindings on VLANIF100 in a batch. Set the start multicast group address to 232.1.1.1, the source address to 192.168.11.1, and the step mask length to 32.

<HUAWEI> system-view
[HUAWEI] multicast routing-enable
[HUAWEI] interface vlanif 100
[HUAWEI-Vlanif100] igmp static-group 232.1.1.1 inc-step-mask 32 number 10 source 192.168.11.1

# Configure static multicast group 224.1.1.1 on GE0/0/1.

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

# Configure the sub-interface for QinQ VLAN tag termination GE 0/0/1.1 to statically join multicast groups in batches, with the start group address of 225.0.0.0, the incremental mask length of 32, and the number of group addresses of 2. The outer VLAN tag is 1 and the inner VLAN tag ranges from 1 to 3.

<HUAWEI> system-view
[HUAWEI] multicast routing-enable
[HUAWEI] vcmp role silent
[HUAWEI] interface gigabitethernet0/0/1
[HUAWEI-GigabitEthernet0/0/1] port link-type hybrid
[HUAWEI-GigabitEthernet0/0/1] quit
[HUAWEI] interface gigabitethernet0/0/1.1
[HUAWEI-GigabitEthernet0/0/1.1] igmp static-group 225.0.0.0 inc-step-mask 32 number 2 qinq pe-vid 1 ce-vid 1 to 3