configure pim ssm range

configure pim {ipv4 | ipv6} ssm range [default | policy policy-name]

Description

Configures the range of multicast addresses for PIM SSM.

Syntax Description

ipv4 Specifies the IPv4 address family.
ipv6 Specifies the IPv6 address family.
default Specifies the default address range. 232.0.0.0/8 for IPv4 or FF3x::/96 for IPv6.
policy-name Specifies a policy that defines the SSM address range.

Default

By default, no SSM range is configured. Using this command with the default keyword sets the range to 232.0.0.0/8. To reset the switch to the initial state, use the unconfigure pim ssm range command.

Usage Guidelines

Initially, no range is configured for SSM. After a range is configured, you can remove the range with the unconfigure pim ssm range command. If you wish to change the PIM SSM range, you must first unconfigure the existing range, and then configure the new range.

SSM requires that hosts use IGMPv3 messages to register to receive multicast group packets. When a range is configured for SSM, any IGMPv2 messages for an address in the range are ignored. Also, any IGMPv3 Exclude messages are ignored.

Note

Note

If a PIM-SSM range is configured, IGMPv2 messages and IGMPv3 exclude messages within the PIM-SSM range are ignored on all IP interfaces, whether or not PIM-SSM is configured on the interfaces.

To specify a range different from the default PIM SSM range, create a policy file. The match statement of the policy file contains the group addresses to be treated as PIM SSM addresses. For example, to specify the PIM SSM address range as 232.0.0.0/8 and 233.0.0.0/8, use the following policy file:

Entry extreme1 {
	if match any {
		nlri  232.0.0.0/8 ;
		nlri  233.0.0.0/8 ;
	}
	then {
		permit ;
	}
}

Example

The following example sets the PIM SSM range to 232.0.0.0/8 and 233.0.0.0/8, if the policy file ssmrange.pol contains the policy example used above:

configure pim ssm range policy ssmrange

History

This command was first available in ExtremeXOS 11.4.

Platform Availability

This command is available on platforms that support the appropriate license. For complete information about software licensing, including how to obtain and upgrade your license and which licenses support the PIM feature, see the ExtremeXOS and Switch Engine 31.7 Feature License Requirements document.