set protocols igmp-snooping interface max-groups

The set protocols igmp-snooping interface max-groups command configures the maximum number of static/dynamic multicast groups that a specific interface can join.

The delete protocols igmp-snooping interface max-groups command sets the maximum number of static/dynamic multicast groups on a specific interface to the default value of 256.

Command Syntax

set protocols igmp-snooping interface <interface-name> max-groups <int>

Parameters

Parameter	Description
interface <interface-name>	Specifies the physical interface name. The value is a string.
max-groups <int>	Specifies the maximum number of static/dynamic multicast groups on a specific interface. The value is an integer. Range: 1 to 256. Default: 256.

Usage Guidelines

By configuring this command, users can control the maximum number of static/dynamic multicast groups on a specific interface. If the number of Layer 2 multicast entries on the interface already exceeds the configured limit, the number of Layer 2 multicast entries on the interface does not change and the interface cannot learn new Layer 2 multicast entries.

The Layer 2 multicast table can be viewed by using the command run show igmp-snooping groups.

If the multicast groups number of an interface has already reached the configured max number of multicast groups, the system will report an error under the following two conditions:

The system prints a warning message in the syslog when receiving IGMP packets with new multicast groups, prompting that the number of multicast groups on the interface exceeding the configured max number of multicast groups. For example,

Nov 11 2022 09:48:13 PICOS  local0.warning : [IGMPSNOOPING]The number of groups (6) reaches to the configured maximum number (6) on interface te-1/1/23
Nov 11 2022 09:48:14 PICOS  local0.warning : [IGMPSNOOPING]The number of groups (8) reaches to the configured maximum number (8) on interface te-1/1/24

Users cannot configure anymore new static multicast groups when the number of multicast groups on an interface has already reached the configured max number of multicast groups. Commit fails with an error message "Already reach max multicast mac entries count : value of max-groups". For example,

admin@PICOS# set protocols igmp-snooping vlan-id 100 static group 224.1.2.2 interface te-1/1/23
admin@PICOS# commit
Already reach max multicast mac entries count : 256
Commit failed.

Example

Configure the maximum number of static/dynamic multicast groups on interface te-1/1/24.

admin@PICOS# set protocols igmp-snooping interface te-1/1/24 max-groups 8 
admin@PICOS# commit