pim threshold-alarm
Function
The pim threshold-alarm command configures the upper and lower alarm thresholds for PIM entries.
The undo pim threshold-alarm command restores the default alarm thresholds for PIM entries.
By default, the upper and lower alarm thresholds are 80% and 75% respectively.
Format
pim { star-group-number | source-group-number } threshold-alarm upper-limit upper-limit-value lower-limit lower-limit-value
undo pim { star-group-number | source-group-number } threshold-alarm
Only the S5720-EI, S5720-HI, S5720I-SI, S5720-LI, S5735-L, S5735S-L, S5735S-L-M, S5720S-LI, S5720S-SI, S5720-SI, S5735-S, S5735S-S, S5735-S-I, S5730-HI, S5730S-EI, S5730-SI, S5731-H, S5731-S, S5731S-H, S5731S-S, S5732-H, S6720-EI, S6720-HI, S6720-LI, S6720S-EI, S6720S-LI, S6720S-SI, S6720-SI, S6730-H, S6730S-H, S6730-S, and S6730S-S support this command.
Parameters
| Parameter | Description | Value |
|---|---|---|
| star-group-number | Sets the alarm thresholds for PIM (*, G) entries. | - |
| source-group-number | Sets the alarm thresholds for PIM (S, G) entries. | - |
| upper-limit upper-limit-value | Specifies the upper alarm threshold value for PIM entries, in percentage. | The value is an integer ranging from 1 to 100. |
| lower-limit lower-limit-value | Specifies the lower alarm threshold value for PIM entries, in percentage. | The value is an integer ranging from 1 to 100. lower-limit-value must be smaller than upper-limit-value. |
Usage Guidelines
Usage Scenario
A device supports a limited number of PIM entries. After the number of PIM entries reaches the maximum value, no more PIM entries can be created. As a result, some multicast traffic cannot be forwarded. To facilitate network operations and maintenance, configure the upper and lower alarm thresholds for PIM entries. PIM entry alarms and clear alarms quickly notify you of PIM entry usage. The pim threshold-alarm command allows you to adjust the alarm thresholds for PIM entries based on service requirements. Note that:
- If the proportion of existing PIM entries to the maximum number reaches upper-limit-value, a PIM entry alarm is reported. This alarm is informational only and does not affect creation of new PIM entries.
- If the proportion of existing PIM entries to the maximum number falls below lower-limit-value, a PIM entry clear alarm is reported.
Prerequisites
This command only configures the alarm thresholds for PIM entries. To enable the configured alarm thresholds to take effect, run the snmp-agent trap enable feature-name pim trap-name { hwpimsgthresholdexceed | hwpimsgthresholdexceedclear | hwpimstargthresholdexceed | hwpimstargthresholdexceedclear } command twice to enable the device to report PIM entry alarms and clear alarms.
Precautions
If the pim threshold-alarm command is executed multiple times, only the latest configuration takes effect.
Example
# Configure the upper and lower alarm thresholds for PIM (*, G) entries.
<HUAWEI> system-view [HUAWEI] multicast-mib [HUAWEI-mcast-mib] pim star-group-number threshold-alarm upper-limit 88 lower-limit 77
# Configure the upper and lower alarm thresholds for PIM (S, G) entries.
<HUAWEI> system-view [HUAWEI] multicast-mib [HUAWEI-mcast-mib] pim source-group-number threshold-alarm upper-limit 88 lower-limit 77