mgmd host threshold-alarm
Function
The mgmd host threshold-alarm command configures the upper and lower alarm thresholds for the multicast entry usage of all instances on a user-side IGMP/MLD device.
The undo mgmd host threshold-alarm command restores the default upper and lower alarm thresholds.
By default, the upper and lower alarm thresholds are 80% and 75%, respectively.
Format
mgmd host { star-group-number | source-group-number } threshold-alarm upper-limit upper-limit-value lower-limit lower-limit-value
undo mgmd host { star-group-number | source-group-number } threshold-alarm
Parameters
| Parameter | Description | Value |
|---|---|---|
| star-group-number | Enables you to configure the upper and lower alarm thresholds for the (*, G) entry usage of all instances. | - |
| source-group-number | Enables you to configure the upper and lower alarm thresholds for the (S, G) entry usage of all instances. | - |
| upper-limit upper-limit-value | Configures an upper alarm threshold for the multicast entry usage of all instances, in percentage. | The value is an integer ranging from 1 to 100. |
| lower-limit lower-limit-value | Configures a lower alarm threshold for the multicast entry usage of all instances, 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 user-side IGMP/MLD device has an upper limit for the number of multicast entries. When this upper limit is reached, the device cannot create new entries, so it will reject new multicast service requests. To resolve this issue and improve device maintenance, run the mgmd host threshold-alarm command to configure the upper and lower alarm thresholds for the multicast entry usage on a user-side IGMP/MLD device, enabling you to learn the multicast entry usage status. After the mgmd host threshold-alarm command is executed:
- When the value of upper-limit-value is reached, the device triggers a multicast entry usage alarm. Such an alarm is a notification only, and the device can still create new multicast entries before the multicast entry usage reaches 100%.
- When the multicast entry usage falls below the value specified by lower-limit-value, the device triggers a clear alarm for the multicast entry usage alarm.
Prerequisites
The mgmd host threshold-alarm command works with the snmp-agent trap enable feature-name igmp trap-name { hwmgmdhoststargthresholdexceed | hwmgmdhoststargthresholdexceedclear | hwmgmdhostsgthresholdexceed | hwmgmdhostsgthresholdexceedclear } command. The former configures the upper and lower alarm thresholds, while the latter enables or disables the function to report alarms.
Precautions
If the mgmd host threshold-alarm command is run more than once, the latest configuration overrides the previous one.
Example
# Configure the upper and lower alarm thresholds for the (*, G) entry usage of all instances.
<HUAWEI> system-view [HUAWEI] multicast-mib [HUAWEI-mcast-mib] mgmd host star-group-number threshold-alarm upper-limit 88 lower-limit 77
# Configure the upper and lower alarm thresholds for the (S, G) entry usage of all instances.
<HUAWEI> system-view [HUAWEI] multicast-mib [HUAWEI-mcast-mib] mgmd host source-group-number threshold-alarm upper-limit 88 lower-limit 77