igmp static-group

Function

The igmp static-group command configures an interface to statically join a multicast group.

The undo igmp static-group command deletes a multicast group that an interface statically joins.

By default, an interface does not statically join any multicast group.

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 the address of a multicast group. In batch configuration mode, it specifies the initial multicast group address.	The address is in dotted decimal notation, ranging from 224.0.1.0 to 239.255.255.255.
inc-step-mask	Specifies the incremental mask of static group address in batch configuration mode.	-
group-mask	Specifies the step mask of a group address in batch configuration mode. The step mask is the distance between two multicast group addresses.	The value is expressed in wildcard-mask mode and dotted decimal notation, ranging from 0.0.0.1 to 15.255.255.255.
group-mask-length	Specifies the length of the step mask of a group address in batch configuration mode.	The value is a decimal integer that ranges from 4 to 32.
number group-number	Specifies the number of group addresses in batch configuration mode.	The value is a decimal integer that ranges from 2 to 512.
source source-address	Specifies a multicast source. The source-address specifies the address of the multicast source.	The address of the multicast source is in dotted decimal notation.
all	Indicates all the multicast groups that the interface statically joins.	-

Views

Interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

The command is used to configure a single multicast group or source/group on an interface. It can also be used to configure multiple multicast groups or source/groups in batches.

After the igmp static-group command is used, the FW considers that the interface always has member hosts, and it continues to forward corresponding multicast packets to the network segment where the interface resides.

Prerequisites

You must run the multicast routing-enable command to enable the multicast function before using the command.

Precautions

Note the following when you statically add a interface to multicast groups:

When you configure multiple multicast groups in batches, the IP addresses of multicast groups may be overlapped. Such a situation is allowed.
After batch static multicast groups are configured on an interface, you cannot perform the deletion operation before the system completes the batch join processing.
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.
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 GE 1/0/0 on the router to statically join a multicast group.

<sysname> system-view
[sysname] multicast routing-enable
[sysname] interface GigabitEthernet 0/0/0
[sysname-GigabitEthernet0/0/0] igmp static-group 224.1.1.1

# Configure GE 1/0/0 on the router to forward the packets for the group 232.1.1.1, with the multicast source of 192.168.11.1.

<sysname> system-view
[sysname] multicast routing-enable
[sysname] interface GigabitEthernet 0/0/0
[sysname-GigabitEthernet0/0/0] igmp static-group 232.1.1.1 source 192.168.11.1

# Configure GE 1/0/0 to statically join multicast groups in batches, with the start group address of 225.1.1.1, the incremental mask length of 32, and the number of group addresses of 2.

<sysname> system-view
[sysname] multicast routing-enable
[sysname] interface GigabitEthernet 0/0/0
[sysname-GigabitEthernet0/0/0] igmp static-group 225.1.1.1 inc-step-mask 32 number 2

# Configure GE 1/0/0 to statically join multicast groups in batches, with the start group address of 232.1.1.1, the source address of 192.168.11.1, the incremental mask length of 32, and the number of group addresses of 2.

<sysname> system-view
[sysname] multicast routing-enable
[sysname] interface GigabitEthernet 0/0/0
[sysname-GigabitEthernet0/0/0] igmp static-group 232.1.1.1 inc-step-mask 32 number 2 source 192.168.11.1