The igmp static-group command configures an interface to statically join multicast groups.
The undo igmp static-group command deletes the multicast groups that an interface statically joins.
By default, an interface does not join any multicast group statically.
igmp static-group StaticGrp [ inc-step-mask { IncStepGrpMask | IncStepGrpMaskLen } number TotalNum ] [ source SourceAddr ] dot1q vid lowVidValue [ to highVidValue ]
igmp static-group StaticGrp [ inc-step-mask { IncStepGrpMask | IncStepGrpMaskLen } number TotalNum ] [ source SourceAddr ] qinq pe-vid peVidValue ce-vid lowCeValue [ to highCeValue ]
undo igmp static-group all
undo igmp static-group StaticGrp [ inc-step-mask { IncStepGrpMask | IncStepGrpMaskLen } number TotalNum ] [ source SourceAddr ] { qinq pe-vid peVidValue ce-vid lowCeValue [ to highCeValue ] | dot1q vid lowVidValue [ to highVidValue ] }
| Parameter | Description | Value |
|---|---|---|
| StaticGrp |
Specifies a group address. |
- |
| inc-step-mask |
Indicates the step mask of a group address in batch configuration mode. |
- |
| IncStepGrpMask |
Specifies the step mask of a group address in batch configuration mode. |
The value ranges from 0.0.0.1 to 15.255.254.255, in dotted decimal notation. |
| IncStepGrpMaskLen |
Specifies the length of the step mask in batch configuration mode. |
The value is an integer that ranges from 5 to 32. |
| number TotalNum |
Specifies the number of group addresses in batch configuration mode. |
The value is an integer ranging from 2 to 512. |
| source SourceAddr |
Specifies a multicast source address. |
The address is in dotted decimal notation. |
| dot1q |
Statically adds a sub-interface for dot1q VLAN tag termination to a multicast group. |
- |
| vid |
Indicates the VLAN ID. |
- |
| lowVidValue |
Specifies the lower limit of the VLAN tag. |
The value is a decimal integer ranging from 1 to 4094. |
| to |
Specifies the upper limit of the inner VLAN tag. |
- |
| highVidValue |
Specifies the upper limit of the 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. |
| qinq |
Statically adds a sub-interface for QinQ VLAN tag termination to a multicast group. |
- |
| pe-vid peVidValue |
Specifies the outer VLAN ID. |
The value is an integer that ranges from 1 to 4094. |
| ce-vid lowCeValue |
Specifies the lower limit of the inner VLAN tag. |
The value is a decimal integer that ranges from 1 to 4094. |
| highCeValue |
Specifies the upper limit of the inner VLAN tag. |
The value is an integer that ranges from 1 to 4094. The value cannot be smaller than the lower limit lowCeValue. By default, the value of lowCeValue is the same as that of lowCeValue. |
| all |
Indicates all multicast groups that an interface statically joins. |
- |
Usage Scenario
If users want to receive multicast data for a group for a long time, the igmp static-group command can be used to configure the interface connected to user hosts to statically join groups. This allows the interface to rapidly respond to users' requests, thus reducing the channel switching time.
If users want to receive multicast data sent by a specific multicast source for a long time, source source-address can be set to specify a multicast source SourceAddr. The igmp static-group command is run on the interface connected to user hosts. The interface can statically join a single or multiple multicast groups at one time, including source-specific multicast groups. If hosts need to join one or several multicast groups stably and permanently through the sub-interface for QinQ VLAN tag termination or the sub-interface for dot1q VLAN tag termination, you can run the igmp static-group command to statically add the sub-interface for QinQ VLAN tag termination or the sub-interface for dot1q VLAN tag termination to the multicast group(s).Prerequisites
The multicast routing function has been enabled using the multicast routing-enable command in the public network instance view or VPN instance view.
Configuration Impact
After the igmp static-group command is run on the interface connected to user hosts, the entries corresponding to IGMP groups that the interface statically joins never time out. The router considers that this interface is always connected to group members, and continues to forward qualified multicast packets to the network segment where the interface resides.
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 overrides the previous one if only the value of TotalNum is changed but the values of StaticGrp and IncStepGrpMask | IncStepGrpMaskLen remain unchanged. To add an interface to multiple multicast groups in batches, run the igmp static-group StaticGrp inc-step-mask number TotalNum command. A IncStepGrpMaskLen value is converted to a IncStepGrpMask value using the following formula: IncStepGrpMask = 1<<(32-IncStepGrpMaskLen). The << symbol represents the left-shift operator, using which the binary format of an integer is shifted left for a specified number of digits. Extra binary digits out of the left boundary are discarded, and 0s are added at the right boundary. For example, 1<<0 represents 0.0.0.1, 1<<1 represents 0.0.0.2, and 1<<3 represents 0.0.0.4. If IncStepGrpMaskLen is used to configure the step mask of group addresses in batch configuration mode and the display current-configuration command is used to view related configurations, the step mask of group addresses is always displayed in group-mask format. After you run the igmp static-group command and specify 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 overrides the previous one if only the value of group-number is changed but the values of StaticGrp and IncStepGrpMask | IncStepGrpMaskLen and the values of tag parameters remain unchanged. If the values of tag parameters have been changed, the device considers that the later command is different from the first one and the new configuration does not overwrite the previous configuration. Note the following when you statically add a sub-interface for QinQ VLAN tag termination or a sub-interface for dot1q VLAN tag termination to multicast groups:Follow-up Procedure
If a user host no longer wants to receive multicast data for a group that the user host statically joins, delete the static group configuration.
Precautions
If an interface belongs to an NDR (Non-Designated Router) or Assert Loser device, the interface is not used as an outbound interface of PIM routing entries, so the multicast traffic cannot be statically directed to targets by running the igmp static-group command.
You are allowed to configure overlapped multicast group addresses in different batch configurations of multicast groups. After an interface is configured to statically join multicast groups in batches, do not delete any command related to static group configuration before the system completes the batch static group configuration.<HUAWEI> system-view [~HUAWEI] multicast routing-enable [*HUAWEI] interface GigabitEthernet 0/1/8.10 [*HUAWEI-GigabitEthernet0/1/8.10] encapsulation qinq-termination [*HUAWEI-GigabitEthernet0/1/8.10] qinq termination pe-vid 1 ce-vid 1 to 2 [*HUAWEI-GigabitEthernet0/1/8.10] igmp static-group 225.0.0.1 inc-step-mask 0.0.0.1 number 17 qinq pe-vid 1 ce-vid 1 to 2