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 ] }
Parameters
| Parameter | Description | Value |
|---|---|---|
| group-address | Specifies a multicast group address. In batch configuration mode, this parameter specifies the start address of the multicast group range. | The value ranges from 224.0.1.0 to 239.255.255.255, in dotted decimal notation. |
| inc-step-mask | Sets the step mask of group addresses in batch configuration mode. | - |
| group-mask | Specifies the step mask of a group address in batch configuration mode, that is, the gap between two consecutive group addresses. | The value is a wildcard mask format that ranges from 0.0.0.1 to 15.255.255.255, in dotted decimal notation. |
| group-mask-length | Specifies the step mask length in batch configuration mode. | The value is an integer that ranges from 4 to 32. If group-mask-length is used to configure the step mask and the display current-configuration command is used to display related configurations, the step mask of group addresses is displayed in group-mask format. |
| number group-number | Specifies the number of group addresses in batch configuration mode. | The value is an integer that ranges from 2 to 512. |
| source source-address | Specifies a multicast source address. | The address is in dotted decimal notation. |
| all | Indicates all multicast groups that an interface statically joins. | - |
Usage Guidelines
Usage Scenario
You can configure static multicast groups on user-side interfaces of the wireless access controller in some scenarios, for example:
There are long-term group members on a shared network segment, and the wireless access controller 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 wireless access controller considers that the multicast group always has members on the network segment of the interface. Therefore, the wireless access controller always forwards multicast data of the multicast group.
The igmp static-group command is used on an interface connected to user hosts. The command can configure a single group or source-group binding on an interface at a time or configure multiple groups or source-group bindings in a batch.
Prerequisites
Multicast routing has been enabled using the multicast routing-enable command.
Configuration Impact
After you run the igmp static-group command on an interface connected to user hosts, the entries matching the IGMP groups that the interface statically joins never time out. The wireless access controller considers that this interface is always connected to group members, and keeps forwarding multicast packets of the specified multicast groups to the network segment where the interface resides.
If you have specified multiple multicast groups in a batch configuration, and only change the group-number value in a second batch configuration, the new batch configuration overwrites the previous ones.
Follow-up Procedure
If a user host no longer needs to receive multicast data of a static group, delete the static group configuration.
Precautions
You can configure overlapping multicast group addresses in different batch configurations.
When you configure multiple static multicast groups in a batch on an interface, do not delete any static group configuration before the system completes the batch static group configuration.
Example
# Configure static multicast group 224.1.1.1 on VLANIF100.
<AC6605> system-view [AC6605] multicast routing-enable [AC6605] interface vlanif 100 [AC6605-Vlanif100] igmp static-group 224.1.1.1
# Configure the wireless access controller to forward multicast packets from multicast source 192.168.11.1 to multicast group 232.1.1.1 through VLANIF100.
<AC6605> system-view [AC6605] multicast routing-enable [AC6605] interface vlanif 100 [AC6605-Vlanif100] igmp static-group 232.1.1.1 source 192.168.11.1
<AC6605> system-view [AC6605] multicast routing-enable [AC6605] interface vlanif 100 [AC6605-Vlanif100] igmp static-group 225.1.1.1 inc-step-mask 32 number 10
<AC6605> system-view [AC6605] multicast routing-enable [AC6605] interface vlanif 100 [AC6605-Vlanif100] igmp static-group 232.1.1.1 inc-step-mask 32 number 10 source 192.168.11.1
