multicast limit pim sm

Function

The multicast limit pim sm command configures a limit on the number of PIM-SM entries and alarm thresholds for them.

The undo multicast limit pim sm command restores the default configuration.

By default, no limit is configured on the number of PIM-SM entries and no alarm thresholds are configured.

Format

multicast limit pim sm { star-group-number | source-group-number } limit-count [ threshold-alarm upper-limit upper-limit-value lower-limit lower-limit-value ]

undo multicast limit pim sm { star-group-number | source-group-number }

Parameters

Parameter	Description	Value
star-group-number	Configures the specified limit to take effect for (*, G) entries.	-
source-group-number	Configures the specified limit to take effect for (S, G) entries.	-
limit-count	Specifies a limit on the number of PIM-SM entries.	The value is an integer ranging from 1 to 16384.
threshold-alarm	Indicates alarm thresholds.	-
upper-limit upper-limit-value	Sets an alarm trigger threshold, in percentage. An alarm is generated when the percentage ratio of created PIM-SM entries to limit-count reaches upper-limit-value.	The value is an integer ranging from 1 to 100. The default value is 80.
lower-limit lower-limit-value	Sets an alarm clear threshold, in percentage. An alarm is cleared when the percentage ratio of created PIM-SM entries to limit-count falls below lower-limit-value. lower-limit-value must be less than upper-limit-value.	The value is an integer ranging from 1 to 100. The default value is 70.

Views

VPN instance view

Default Level

2: Configuration level

Task Name and Operations

Task Name	Operations
mcast-base	write

Usage Guidelines

Usage Scenario

To configure a proper limit on the number of PIM-SM entries, run the multicast limit pim sm command. This prevents multicast services from being affected by an improper limit on the number of PIM-SM entries.

Prerequisites

The multicast routing-enable command has been run.

Configuration Impact

If the number of PIM-SM entries reaches a configured limit, new entries fail to be created and the alarm PIM_1.3.6.1.4.1.2011.5.25.149.4.0.32 hwPimVrfTypeSGExceed is triggered.

If upper-limit-value is specified and the number of PIM-SM entries reaches the configured alarm trigger threshold, the alarm PIM_1.3.6.1.4.1.2011.5.25.149.4.0.30 hwPimVrfTypeSGThresholdExceed is triggered.

NOTE:

Statically created (*, G) and (S, G) entries are not affected by a limit on the number of PIM-SM entries. The limit takes effect only on dynamic entries. Changing the limit on the number of PIM-SM entries to a small value does not take effect for the route entries that have exceeded the limit.

Example

# Set a limit on the number of PIM (S, G) entries in the IPv4 address family of a VPN instance named abc to 1000.

<HUAWEI> system-view
[~HUAWEI] ip vpn-instance abc
[*HUAWEI-vpn-instance-abc] ipv4-family
[*HUAWEI-vpn-instance-abc-af-ipv4] route-distinguisher 1:1
[*HUAWEI-vpn-instance-abc-af-ipv4] multicast routing-enable
[*HUAWEI-vpn-instance-abc-af-ipv4] quit
[*HUAWEI-vpn-instance-abc] multicast limit pim sm source-group-number 1000

# Set a limit on the number of PIM (*, G) entries, alarm trigger threshold, and alarm clear threshold to 2000, 80%, and 70% in the IPv4 address family of a VPN instance named abc, respectively.

<HUAWEI> system-view
[~HUAWEI] ip vpn-instance abc
[*HUAWEI-vpn-instance-abc] ipv4-family
[*HUAWEI-vpn-instance-abc-af-ipv4] route-distinguisher  1:1
[*HUAWEI-vpn-instance-abc-af-ipv4] multicast routing-enable
[*HUAWEI-vpn-instance-abc-af-ipv4] quit
[*HUAWEI-vpn-instance-abc] multicast limit pim sm star-group-number 2000 threshold-alarm upper-limit 80 lower-limit 70