No relevant resource is found in the selected language.

This site uses cookies. By continuing to browse the site you are agreeing to our use of cookies. Read our privacy policy>Search

Reminder

To have a better experience, please upgrade your IE browser.

upgrade

S12700 V200R013C00 Command Reference

This document describes all the configuration commands of the device, including the command function, syntax, parameters, views, default level, usage guidelines, examples, and related commands.
Rate and give feedback:
Huawei uses machine translation combined with human proofreading to translate this document to different languages in order to help you better understand the content of this document. Note: Even the most advanced machine translation cannot match the quality of professional translators. Huawei shall not bear any responsibility for translation accuracy and it is recommended that you refer to the English document (a link for which has been provided).
Multicast Network Management Commands

Multicast Network Management Commands

Command Support

Commands provided in this section and all the parameters in the commands are supported by all switch models by default, unless otherwise specified. For details, see specific commands.

display multicast threshold-alarm

Function

The display multicast threshold-alarm command displays the alarm thresholds for multicast index resource usage.

Format

display multicast threshold-alarm

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can use this command to check the alarm thresholds for multicast index resource usage.

Example

# Display the alarm thresholds for multicast index resource usage.

<HUAWEI> display multicast threshold-alarm
Multicast table trap threshold value
Upperlimit value: 86%
Lowerlimit value: 78%
Table 8-151  Description of the display multicast threshold-alarm command output

Item

Description

Multicast table trap threshold value

Alarm thresholds for multicast index resource usage.

Upperlimit value

Upper threshold value.

This parameter is configured using the multicast threshold-alarm upper-limit upper-limit lower-limit lower-limit command.

Lowerlimit value

Lower threshold value.

This parameter is configured using the multicast threshold-alarm upper-limit upper-limit lower-limit lower-limit command.

display pim mib-control-message

Function

The display pim mib-control-message command displays PIM-related statistics and counts of various messages received the last time.

Format

display pim mib-control-message { counters | join-prune | assert | register }

Parameters

Parameter Description Value
counters Indicates related PIM counters. -
join-prune Indicates the number of invalid Join/Prune messages that are received at the last time. -
assert Indicates the number of Assert messages that are received or sent at the last time. -
register Indicates the number of invalid Register messages that are received at the last time. -

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The display pim mib-control-message counters command displays the number of neighbor loss events, the number of DR elections, the number of invalid Join/Prune messages, the number of invalid Register messages, the number of RP-mapping changes, and the number of received and sent Assert messages.

The display pim mib-control-message join-prune command displays the source address, group address, and RP address carried in the last received invalid Join/Prune message.

The display pim mib-control-message assert command displays the source address and group address carried in the last received or sent Assert message.

The display pim mib-control-message register command displays the source address, group address, and RP address carried in the last received invalid Register message.

Example

# Display the number of neighbor loss events, the number of times for DR election, the number of invalid Join/Prune messages, the number of invalid Register messages, the number of RP-Mapping, the number of received and sent Assert messages.

<HUAWEI> display pim mib-control-message counters
 pim mib-control-message counters                                               
 Neighbor-loss (times)        : 0                                               
 DR-Election(times)          : 0                                                
 Invalid-join-prune (times)   : 0                                               
 RP-Mapping (times)           : 0                                               
 Invalid-register (times)     : 0                                               
 Assert-received(times)      : 0                                                
 Assert-send(times)          : 0

# Display the invalid Join/Prune message that is received at the last time.

<HUAWEI> display pim mib-control-message join-prune
The last invalid join-prune message received information:
Group address  : 225.1.1.1
Source address : 0.0.0.0
RP address     : 10.0.5.5

# Display the Assert message that is sent or received at the last time. If the interface that receives or sends the Assert message is pulled out when this command is used, the prompt that "The last assert message was received or sent on lost interface" is displayed.

<HUAWEI> display pim mib-control-message assert
The last assert message received or sent on Vlanif100
Group address   : 226.3.3.3
Source address  : 10.0.5.55

# Display the invalid Register message that is received at the last time.

<HUAWEI> display pim mib-control-message register
The last invalid register message received information:
Group address  : 225.1.1.1
Source address : 10.0.5.100
RP address     : 10.0.3.1
Table 8-152  Description of the display pim mib-control-message command output

Item

Description

pim mib-control-message counters

Numbers of neighbor loss events, DR election events, invalid Join/Prune messages, invalid Register messages, RP-mapping changes, and received and sent Assert messages.

The last invalid join-prune message received information

Invalid Join/Prune message received the last time.

The last assert message received or sent on Vlanif100

Assert message sent or received the last time.

The last invalid register message received information

Invalid Register message received the last time.

Neighbor-loss(times)

Number of neighbor loss events.

DR-Election (times)

Number of DR election events.

Invalid-join-prune(times)

Number of invalid Join/Prune messages.

RP-Mapping(times)

Number of RP-Mapping changes.

Invalid-register(times)

Number of invalid Register messages.

Assert-received(times)

Number of received Assert messages.

Assert-send(times)

Number of sent Assert messages.

Group address

Multicast group address.

Source address

Multicast source address

RP address

IP address of the RP.

display pim mib-notification interval

Function

The display pim mib-notification interval command displays the interval for sending PIM notification messages.

Format

display pim mib-notification interval

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

After the interval for sending PIM notification messages is set or modified by using the pim mib-notification interval command, you can run the display pim mib-notification interval command to view the configured interval.

Example

# Display the interval for sending PIM notification messages.

<HUAWEI> display pim mib-notification interval
Neighbor-loss notification interval      : 0 s
Invalid-join-prune notification interval : 50 s
RP-mapping-change notification interval  : 100 s
Interface-election notification interval : 2000 s
Invalid-register notification interval   : 60000 s
New-neighbor notification interval       : 0 s 
Mrt-limit notification interval          : never
Table 8-153  Description of the display pim mib-notification interval command output

Item

Description

Neighbor-loss notification interval

Interval for sending the notification messages about the neighbor loss

Invalid-join-prune notification interval

Interval for sending the notification messages about invalid Join/Prune messages

RP-mapping-change notification interval

Interval for sending the notification messages about RP-mapping changes

Interface-election notification interval

Interval for sending the notification messages about interface election

Invalid-register notification interval

Interval for sending the notification messages about invalid Register messages

New-neighbor notification interval

Interval for sending trap messages about neighbor addition.

Mrt-limit notification interval

Interval for sending trap messages about the failure in joining multicast groups because the number of PIM entries reaches the upper limit.

display snmp-agent trap feature-name igmp all

Function

The display snmp-agent trap feature-name igmp all command displays whether the trap function is enabled for the IGMP module.

Format

display snmp-agent trap feature-name igmp all

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run the display snmp-agent trap feature-name igmp all command to view the status of all IGMP traps when you want to monitor the current status of IGMP protocol events but are not sure whether the IGMP trap function is enabled. You can use the snmp-agent trap enable feature-name igmp command to enable the trap function of IGMP.

Example

# Display whether the trap function is enabled for the IGMP module.

<HUAWEI> display snmp-agent trap feature-name igmp all
------------------------------------------------------------------------------
Feature name: IGMP      
Trap number : 18        
------------------------------------------------------------------------------
Trap name                       Default switch status   Current switch status 
IFLIMIT                         off                     on                    
IFLIMITCLR                      off                     on                    
INSLIMIT                        off                     on                    
GLBLIMIT                        off                     on                    
HWMGMDGMPGLOBALLIMITCLEAR       off                     on                    
HWMGMDGMPTOTALLIMITCLEAR        off                     on                    
JOINGRP                         off                     on                    
LEAVEGRP                        off                     on                    
hwMgmdTotalLimitThresholdExceed                                               
                                off                     on                    
hwMgmdTotalLimitThresholdExceedClear                                          
                                off                     on                    
hwMgmdHostStarGThresholdExceed  off                     on                    
hwMgmdHostStarGThresholdExceedClear                                           
                                off                     on                    
hwMgmdHostStarGExceed           off                     on                    
hwMgmdHostStarGExceedClear      off                     on                    
hwMgmdHostSGThresholdExceed     off                     on                    
hwMgmdHostSGThresholdExceedClear                                              
                                off                     on                    
hwMgmdHostSGExceed              off                     on                    
hwMgmdHostSGExceedClear         off                     on
Table 8-154  Description of the display snmp-agent trap feature-name igmp all command output

Item

Description

Feature name

Name of the module.

Trap number

Number of trap event types.

Trap name

Trap event type. The following types of trap events are defined:
  • IFLIMIT: The number of IGMP entries on an interface reaches the limit.
  • IFLIMITCLR: The number of IGMP entries on an interface falls below the limit.
  • INSLIMIT: The number of IGMP entries in an instance reaches the limit.
  • GLBLIMIT: The total number of the entries in all instances reaches the limit.
  • HWMGMDGMPGLOBALLIMITCLEAR: The number of IGMP entries in a single instance falls below the limit.
  • HWMGMDGMPTOTALLIMITCLEAR: The number of IGMP entries in all instances falls below the limit.
  • JOINGRP: An IGMP Join message is received.
  • LEAVEGRP: An IGMP Leave message is received or the group timer expires.
  • hwMgmdTotalLimitThresholdExceed: The proportion of IGMP/MLD entries created to the maximum IGMP/MLD entries allowed reaches the upper alarm threshold.
  • hwMgmdTotalLimitThresholdExceedClear: a trap message indicating that the proportion of IGMP/MLD entries created to the maximum IGMP/MLD entries allowed falls below the lower alarm threshold.
  • hwMgmdHostStarGThresholdExceed: a trap message indicating that the total number of (*, G) entries of all instances reaches the specified upper alarm threshold.
  • hwMgmdHostStarGThresholdExceedClear: a trap message indicating that the total number of (*, G) entries of all instances falls below the specified lower alarm threshold.
  • hwMgmdHostStarGExceed: a trap message indicating that the total number of (*, G) entries of all instances exceeds the maximum number allowed on the user-side IGMP/MLD device.
  • hwMgmdHostStarGExceedClear: a trap message indicating that the total number of (*, G) entries of all instances falls below the maximum number allowed on the user-side IGMP/MLD device.
  • hwMgmdHostSGThresholdExceed: a trap message indicating that the total number of (S, G) entries of all instances reaches the specified upper alarm threshold.
  • hwMgmdHostSGThresholdExceedClear: a trap message indicating that the total number of (S, G) entries of all instances falls below the specified lower alarm threshold.
  • hwMgmdHostSGExceed: a trap message indicating that the total number of (S, G) entries of all instances exceeded the maximum number allowed on the user-side IGMP/MLD device.
  • hwMgmdHostSGExceedClear: a trap message indicating that the total number of (S, G) entries of all instances falls below the maximum number allowed on the user-side IGMP/MLD device.

Default switch status

Default status of a trap function:
  • on: indicates that the trap function is enabled by default.
  • off: indicates that the trap function is disabled by default.

Current switch status

Current status of a trap function:
  • on: indicates that the trap function is enabled.
  • off: indicates that the trap function is disabled.

display snmp-agent trap feature-name l2-multicast all

Function

The display snmp-agent trap feature-name l2-multicast all command displays all trap messages of the l2-multicast module.

Format

display snmp-agent trap feature-name l2-multicast all

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run the display snmp-agent trap feature-name l2-multicast all command to view the status of all Layer 2 multicast traps when you want to monitor the current status of Layer 2 multicast protocol events but are not sure whether the Layer 2 multicast trap function is enabled. You can use the snmp-agent trap enable feature-name l2–multicast command to enable the trap function of l2-multicast.

Example

# Display all trap messages of the L2-Multicast module.

<HUAWEI>display snmp-agent trap feature-name l2-multicast all
------------------------------------------------------------------------------
Feature name: l2-multicast
Trap number : 42
------------------------------------------------------------------------------
Trap name                       Default switch status    Current switch status

hwCfgRefreshFailAlarm           off                      off
hwMCastTableLoadAbnormalNotify  off                      off
hwMCastTableLoadAbnormalResume  off                      off
hwMCastVlanFailAlarm            off                      off
hwMCastVlanOkNotify             off                      off
hwMCastApsSwitchAlarm           off                      off
hwMCastApsIdleNotify            off                      off
hwL2mcCacGlobalCountExceed      off                      off
hwL2mcCacGlobalBandwidthExceed  off                      off
hwL2mcCacGlobalChannelCountExceed
                                off                      off
hwL2mcCacGlobalChannelBandwidthExceed
                                off                      off
hwL2mcCacVlanCountExceed        off                      off
hwL2mcCacVlanBandwidthExceed    off                      off
hwL2mcCacVlanChannelCountExceed
                                off                      off
hwL2mcCacVlanChannelBandwidthExceed
                                off                      off
hwL2mcCacVsiCountExceed         off                      off
hwL2mcCacVsiBandwidthExceed     off                      off
hwL2mcCacVsiChannelCountExceed  off                      off
hwL2mcCacVsiChannelBandwidthExceed
                                off                      off
hwL2mcCacPortCountExceed        off                      off
hwL2mcCacPortBandwidthExceed    off                      off
hwL2mcCacPortChannelCountExceed
                                off                      off
hwL2mcCacPortChannelBandwidthExceed
                                off                      off
hwL2mcCacPortVlanCountExceed    off                      off
hwL2mcCacPortVlanBandwidthExceed
                                off                      off
hwL2mcCacPortVlanChannelCountExceed
                                off                      off
hwL2mcCacPortVlanChannelBandwidthExceed
                                off                      off
hwL2mcCacSubIfCountExceed       off                      off
hwL2mcCacSubIfBandwidthExceed   off                      off
hwL2mcCacSubIfChannelCountExceed
                                off                      off
hwL2mcCacSubIfChannelBandwidthExceed
                                off                      off
hwL2mcCacLdpPwCountExceed       off                      off
hwL2mcCacLdpPwBandwidthExceed   off                      off
hwL2mcCacLdpPwChannelCountExceed
                                off                      off
hwL2mcCacLdpPwChannelBandwidthExceed
                                off                      off
hwL2mcCacBgpPwCountExceed       off                      off
hwL2mcCacBgpPwBandwidthExceed   off                      off
hwL2mcCacBgpPwChannelCountExceed
                                off                      off
hwL2mcCacBgpPwChannelBandwidthExceed
                                off                      off
hwL2mcCacVlanUnspecifiedChannelDeny
                                off                      off
hwL2mcCacVsiUnspecifiedChannelDeny
                                off                      off
hwL2mcCacGlobalUnspecifiedChannelDeny
                                off                      off
Table 8-155  Description of the display snmp-agent trap feature-name l2-multicast all command output

Item

Description

Feature name

Name of the module to which a trap message belongs.

Trap number

Number of trap messages.

Trap name

Name of a trap message of the L2-Multicast module:

  • hwCfgRefreshFailAlarm: indicates the trap sent by the device when entries fail to be refreshed.
  • hwMCastTableLoadAbnormalNotify: indicates the trap sent by the device when the number of configured entries exceeds the upper limit.
  • hwMCastTableLoadAbnormalResume: indicates the trap sent by the device when the number of configured entries falls below the upper limit.
  • hwMCastVlanFailAlarm: indicates the trap for the event that the VLAN becomes invalid.
  • hwMCastVlanOkNotify: indicates the trap sent by the device when the VLAN becomes valid again.
  • hwL2mcCacGlobalCountExceed: indicates the trap sent by the device when Layer 2 multicast CAC detects that the number of global multicast groups exceeds the upper limit.
  • hwL2mcCacGlobalChannelCountExceed: indicates the trap sent by the device when Layer 2 multicast CAC detects that the number of member multicast groups of the global channel exceeds the upper limit.
  • hwL2mcCacVlanCountExceed: indicates the trap sent by the device when Layer 2 multicast CAC detects that the number of multicast groups in a VLAN exceeds the upper limit.
  • hwL2mcCacVlanChannelCountExceed: indicates the trap sent by the device when Layer 2 multicast CAC detects that the number of member multicast groups of the channel in a VLAN exceeds the upper limit.
  • hwL2mcCacPortCountExceed: indicates the trap sent by the device when Layer 2 multicast CAC detects that the number of multicast groups off an interface exceeds the upper limit.
  • hwL2mcCacPortChannelCountExceed: indicates the trap sent by the device when Layer 2 multicast CAC detects that the number of member multicast groups of the channel off an interface exceeds the upper limit.
  • hwL2mcCacPortVlanCountExceed: indicates the trap sent by the device when Layer 2 multicast CAC detects that the number of multicast groups off an interface in a VLAN exceeds the upper limit.
  • hwL2mcCacPortVlanChannelCountExceed: indicates the trap sent by the device when Layer 2 multicast CAC detects that the number of member multicast groups of the channel off an interface in a VLAN exceeds the upper limit.
  • hwL2mcCacVlanUnspecifiedChannelDeny: indicates the trap sent by the device when a Report message for a multicast group not belonging to any channel is received after the channel is configured with the unspecified-channel deny command.
  • hwL2mcCacVsiChannelCountExceed: indicates the trap sent by the device when Layer 2 multicast CAC detects that the number of member multicast groups of the channel in a VSI exceeds the upper limit.
  • hwL2mcCacVsiCountExceed: indicates the trap sent by the device when Layer 2 multicast CAC detects that the number of multicast groups in a VSI exceeds the upper limit.
  • hwL2mcCacVsiUnspecifiedChannelDeny: indicates the trap sent by the device when a Report message for a multicast group not belonging to any channel is received after the channel is configured with the unspecified-channel deny command.
  • hwL2mcCacGlobalUnspecifiedChannelDeny: indicates the trap sent by the device when a Report message for a multicast group not belonging to any channel is received after the channel is configured with the unspecified-channel deny command.

Default switch status

Default status of the trap function:
  • on: indicates that the trap function is enabled.
  • off: indicates that the trap function is disabled.

Current switch status

Current status of the trap function:
  • on: indicates that the trap function is enabled.
  • off: indicates that the trap function is disabled.

display snmp-agent trap feature-name mcast all

Function

The display snmp-agent trap feature-name mcast all command displays the status of all traps on the MCAST module.

Format

display snmp-agent trap feature-name mcast all

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

After the trap function of a specified feature is enabled, you can run the display snmp-agent trap feature-name mcast all command to check the status of all traps of MCAST. You can use the snmp-agent trap enable feature-name mcast command to enable the trap function of MCAST.

Prerequisites

SNMP has been enabled. See snmp-agent for details on how to enable SNMP.

Example

# Display all the traps of the MCAST module.

<HUAWEI>display snmp-agent trap feature-name mcast all
------------------------------------------------------------------------------
Feature name: MCAST
Trap number : 4
------------------------------------------------------------------------------
Trap name                       Default switch status   Current switch status
hwBoardL2mcResLack              on                      on
hwBoardL2mcResLackResume        on                      on
hwBoardIpmcResLack              on                      on
hwBoardIpmcResLackResume        on                      on
Table 8-156  Description of the display snmp-agent trap feature-name mcast all command output

Item

Specification

Feature name

Name of the module that the trap belongs to.

Trap number

Number of traps.

Trap name

Name of a trap. Traps of the MCAST module include:

  • hwBoardL2mcResLack: Huawei proprietary trap that is sent when the L2MC index resources are insufficient.

  • hwBoardL2mcResLackResume: Huawei proprietary trap that is sent when the alarm on L2MC index resource insufficiency is cleared.

  • hwBoardIpmcResLack: Huawei proprietary trap that is sent when the IPMC index resources are insufficient.

  • hwBoardIpmcResLackResume: Huawei proprietary trap that is sent when the alarm on IPMC index resource insufficiency is cleared.

Default switch status

Default status of the trap function:
  • on: indicates that the trap function is enabled by default.

  • off: indicates that the trap function is disabled by default.

Current switch status

Status of the trap function:

  • on: indicates that the trap function is enabled.

  • off: indicates that the trap function is disabled.

display snmp-agent trap feature-name mld all

Function

The display snmp-agent trap feature-name mld all command displays whether the trap function is enabled for the MLD module.

Format

display snmp-agent trap feature-name mld all

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

You can run the display snmp-agent trap feature-name mld all command to view the status of all MLD traps when you want to monitor the current status of MLD protocol events but are not sure whether the MLD trap function is enabled. You can use the snmp-agent trap enable feature-name mld command to enable the trap function of MLD.

Example

# Display whether the trap function is enabled for the MLD module.

<HUAWEI> display snmp-agent trap feature-name mld all
------------------------------------------------------------------------------
Feature name: MLD
Trap number : 8
------------------------------------------------------------------------------
Trap name                       Default switch status   Current switch status
IFLIMIT                         off                     off
IFLIMITCLR                      off                     off
INSLIMIT                        off                     off
GLBLIMIT                        off                     off
HWMGMDGMPGLOBALLIMITCLEAR       off                     off
HWMGMDGMPTOTALLIMITCLEAR        off                     off
JOINGRP                         off                     off
LEAVEGRP                        off                     off
Table 8-157  Description of the display snmp-agent trap feature-name mld all command output

Item

Description

Feature name

Name of the module

Trap number

Number of trap messages of a specific type

Trap name

Types of trap messages:
  • IFLIMIT: a trap message indicating that the number of MLD entries on the interface reaches the limit value.
  • IFLIMITCLR: the number of MLD entries on an interface falls below the limit value.
  • INSLIMIT: a trap message indicating that the number of MLD entries in the instance reaches the limit value.
  • GLBLIMIT: a trap message indicating that the total number of MLD entries of all instances reaches the limit value.
  • HWMGMDGMPGLOBALLIMITCLEAR: a trap message indicates that the number of MLD entries in an instance has fallen below the limit.
  • HWMGMDGMPTOTALLIMITCLEAR: a trap message indicating that the total number of MLD entries in all instances has fallen below the limit.
  • JOINGRP: a trap message indicating that an MLD Join message is received

  • LEAVEGRP: a trap message indicating that an MLD Leave message is received or the group timer expires

Default switch status

Status of the default trap switch:
  • on: indicates that the trap function is enabled.
  • off: indicates that the trap function is disabled.

Current switch status

Status of the current trap switch:
  • on: indicates that the trap function is enabled.
  • off: indicates that the trap function is disabled.

display snmp-agent trap feature-name mrm all

Function

The display snmp-agent trap feature-name mrm all command displays whether the trap function is enabled for the MRM module.

Format

display snmp-agent trap feature-name mrm all

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run the display snmp-agent trap feature-name mrm all command to view the status of all MRM traps when you want to monitor the current status of MRM protocol events but are not sure whether the MRM trap function is enabled. You can use the snmp-agent trap enable feature-name mrm command to enable the trap function of MRM.

Example

# Display whether the trap function is enabled for the MRM module.

<HUAWEI> display snmp-agent trap feature-name mrm all
------------------------------------------------------------------------------  
Feature name: MRM                                                               
Trap number : 8                                                                 
------------------------------------------------------------------------------  
Trap name                       Default switch status   Current switch status   
CACGLBTOTAL                     off                     off                     
CACGLBCHN                       off                     off                     
CACOIFTOTAL                     off                     off                     
CACOIFCHN                       off                     off                     
hwIpMcastSGThresholdExceed      off                     off                     
hwIpMcastSGThresholdExceedClear                                                 
                                off                     off                     
hwIpMcastSGExceed               off                     off                     
hwIpMcastSGExceedClear          off                     off                     
Table 8-158  Description of the display snmp-agent trap feature-name mrm all command output

Item

Description

Feature name

Name of the module.

Trap number

Number of trap event types.

Trap name

Trap event type. The following types of trap events are defined:
  • CACGLBTOTAL: The number of PIM entries exceeds the global CAC limit.

  • CACGLBCHN: The number of PIM entries of a channel exceeds the CAC limit configured for the channel.

  • CACOIFTOTAL: The number of PIM entries with a specific interface as the outbound interface exceeds the global CAC limit configured on the interface.

  • CACOIFCHN: The number of PIM entries with the specific interface as the outbound interface exceeds the CAC limit configured for a channel on the interface.

  • hwIpMcastSGThresholdExceed: The proportion of (S, G) multicast forwarding entries created to the maximum (S, G) multicast forwarding entries allowed exceeds the upper alarm threshold.
  • hwIpMcastSGThresholdExceedClear: The proportion of (S, G) multicast forwarding entries created to the maximum (S, G) multicast forwarding entries allowed falls below the lower alarm threshold.
  • hwIpMcastSGExceed: The number of (S, G) multicast forwarding entries created exceeds the maximum number of (S, G) multicast forwarding entries allowed.
  • hwIpMcastSGExceedClear: The number of (S, G) multicast forwarding entries created falls below the maximum number of (S, G) multicast forwarding entries allowed.

Default switch status

Default status of a trap function:
  • on: indicates that the trap function is enabled by default.
  • off: indicates that the trap function is disabled by default.

Current switch status

Current status of a trap function:
  • on: indicates that the trap function is enabled.
  • off: indicates that the trap function is disabled.

display snmp-agent trap feature-name msdp all

Function

The display snmp-agent trap feature-name msdp all command displays the status of all MSDP traps.

Format

display snmp-agent trap feature-name msdp all

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run the display snmp-agent trap feature-name msdp all command to view the status of all MSDP traps when you want to monitor the current status of MSDP protocol events but are not sure whether the MSDP trap function is enabled. You can use the snmp-agent trap enable feature-name msdp command to enable the trap function of MSDP.

Example

# Display whether the trap function is enabled for the MSDP module.

<HUAWEI> display snmp-agent trap feature-name msdp all
------------------------------------------------------------------------------
Feature name: MSDP
Trap number : 2
------------------------------------------------------------------------------
Trap name                       Default switch status   Current switch status
establish                       off                     off
backward                        off                     off
Table 8-159  Description of the display snmp-agent trap feature-name msdp all command output

Item

Description

Feature name

Name of the module.

Trap number

Type number of a trap.

Trap name

Event type. The event types are as follows:
  • establish: indicates that an MSDP peer is established.

  • backward: indicates that an MSDP peer is removed.

Default switch status

Status of the default trap switch:
  • on: indicates that the trap function is enabled.
  • off: indicates that the trap function is disabled.

Current switch status

Status of the current trap switch:
  • on: indicates that the trap function is enabled.
  • off: indicates that the trap function is disabled.

display snmp-agent trap feature-name pim all

Function

The display snmp-agent trap feature-name pim all command displays the status of all PIM traps.

Format

display snmp-agent trap feature-name pim all

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run the display snmp-agent trap feature-name pim all command to view the status of all PIM traps when you want to monitor the current status of PIM protocol events but are not sure whether the PIM trap function is enabled. You can use the snmp-agent trap enable feature-name pim command to enable the trap function of PIM.

Example

# Display whether the trap function is enabled for the PIM module.

<HUAWEI> display snmp-agent trap feature-name pim all
------------------------------------------------------------------------------  
Feature name: PIM                                                               
Trap number : 16                                                                
------------------------------------------------------------------------------  
Trap name                       Default switch status   Current switch status   
neighbor-loss                   off                     on                      
invalid-register                off                     on                      
invalid-join-prune              off                     on                      
rp-mapping-change               off                     on                      
interface-election              off                     on                      
new-neighbor                    off                     on                      
mrt-limit                       off                     on                      
HWPIMMRTLIMITCLEAR              off                     on                      
hwPimStarGThresholdExceed       off                     on                      
hwPimSGThresholdExceed          off                     on                      
hwPimStarGExceed                off                     on                      
hwPimSGExceed                   off                     on                      
hwPimStarGThresholdExceedClear  off                     on                      
hwPimSGThresholdExceedClear     off                     on                      
hwPimStarGExceedClear           off                     on                      
hwPimSGExceedClear              off                     on 
Table 8-160  Description of the display snmp-agent trap feature-name pim all command output

Item

Description

Feature name

Name of the module.

Trap number

Number of trap event types.

Trap name

Trap event type. The following types of trap events are defined:
  • neighbor-loss: A neighbor is lost.
  • invalid-register: An invalid Register message is received.
  • invalid-join-prune: An invalid Join/Prune message is received.
  • rp-mapping-change: The RP-mapping changes.
  • interface-election: An interface is elected as the DR.
  • new-neighbor: A new neighbor appears.
  • mrt-limit: The number of PIM entries exceeds the limit for the multicast routing table (MRT).
  • HWPIMMRTLIMITCLEAR: The total number of PIM entries falls below the limit.
  • hwPimStarGThresholdExceed: The proportion of PIM (*, G) entries created to the maximum PIM (*, G) entries allowed exceeds the upper alarm threshold.
  • hwPimSGThresholdExceed: The proportion of PIM (S, G) entries created to the maximum PIM (S, G) entries allowed exceeds the upper alarm threshold.
  • hwPimStarGExceed: The number of PIM (*, G) entries created exceeds the maximum number of PIM (*, G) entries allowed.
  • hwPimSGExceed: The number of PIM (S, G) entries created exceeds the maximum number of PIM (S, G) entries allowed.
  • hwPimStarGThresholdExceedClear: The proportion of PIM (*, G) entries created to the maximum PIM (*, G) entries allowed falls below the lower alarm threshold.
  • hwPimSGThresholdExceedClear: The proportion of PIM (S, G) entries created to the maximum PIM (S, G) entries allowed falls below the lower alarm threshold.
  • hwPimStarGExceedClear: The number of PIM (*, G) entries created falls below the maximum number of PIM (*, G) entries allowed.
  • hwPimSGExceedClear: The number of PIM (S, G) entries created falls below the maximum number of PIM (S, G) entries allowed.

Default switch status

Default status of a trap function:
  • on: indicates that the trap function is enabled by default.
  • off: indicates that the trap function is disabled by default.

Current switch status

Current status of a trap function:
  • on: indicates that the trap function is enabled.
  • off: indicates that the trap function is disabled.

display snmp-agent trap feature-name pim-std all

Function

The display snmp-agent trap feature-name pim-std all command displays the status of all PIM-STD traps.

Format

display snmp-agent trap feature-name pim-std all

Parameters

None

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can run the display snmp-agent trap feature-name pim-std all command to view the status of all PIM-STD MIB traps when you want to monitor the current status of the public PIM protocol events but are not sure whether the PIM-STD MIB trap function is enabled. You can use the snmp-agent trap enable feature-name pim-std command to enable the trap function of PIM-STD.

Example

# View the status of all PIM-STD MIB traps.

<HUAWEI> display snmp-agent trap feature-name pim-std all
------------------------------------------------------------------------------
Feature name: pim-std
Trap number : 5
------------------------------------------------------------------------------
Trap name                       Default switch status   Current switch status
pimneighborloss                 off                        on
piminvalidregister              off                        on
piminvalidjoinprune             off                        on
pimrpmappingchange              off                        on
piminterfaceelection            off                        on
Table 8-161  Description of the display snmp-agent trap feature-name pim-std all command output

Item

Description

Feature name

Name of a feature.

Trap number

Number of trap message types.

Trap name

Types of trap messages:
  • pimneighborloss: A neighbor relationship is lost.
  • piminvalidregister: An invalid Register message is received.
  • piminvalidjoinprune: An invalid Join or Prune message is received.
  • pimrpmappingchange: RP-Mapping changes.
  • piminterfaceelection: The interface is elected as the DR.

Default switch status

Default status of the trap function:
  • on: The trap function is enabled.
  • off: The trap function is disabled.

Current switch status

Current status of the trap function:
  • on: The trap function is enabled.
  • off: The trap function is disabled.

igmp trap-interval limit

Function

The igmp trap-interval limit command configures the interval for sending trap messages on failures to join IGMP groups because the number of the IGMP entries exceeds the limit.

The undo igmp trap-interval limit command deletes the interval for sending trap messages on failures to join IGMP groups because the number of the IGMP entries exceeds the limit. When a group joining failure occurs, a trap message is sent immediately.

By default, a trap message is sent immediately when an IGMP group joining failure occurs because the number of the IGMP entries exceeds the limit.

Format

igmp trap-interval limit min-interval

undo igmp trap-interval limit

Parameters

Parameter Description Value
min-interval Specifies the interval for sending trap messages of the failure of IGMP joining because the number of the IGMP entries exceeds the limit. The value is an integer that ranges from 0 to 65535, in seconds. The default value is 0 seconds.

Views

Multicast MIB view

Default Level

2: Configuration level

Usage Guidelines

If the interval is set to 0, a trap message will be sent immediately when an IGMP group joining failure occurs because the number of the IGMP entries exceeds the limit; otherwise, the interval for sending such trap messages should be equal to or longer than the configured one.

Example

# Set the interval for sending trap messages on failures to join IGMP groups because the number of the IGMP entries exceeds the limit to 50 seconds.

<HUAWEI> system-view
[HUAWEI] multicast-mib
[HUAWEI-mcast-mib] igmp trap-interval limit 50

l2-multicast limit trap-interval

Function

The l2-multicast limit trap-interval command configures the interval for sending trap messages of Layer 2 multicast entry generation failures due to Layer 2 multicast CAC limit exceeding.

The undo l2-multicast limit trap-interval command deletes the configuration of the interval for sending trap messages.

By default, the switch sends a trap immediately after a Layer 2 multicast entry fails to be generated due to Layer 2 multicast CAC limit exceeding.

Format

l2-multicast limit trap-interval min-interval

undo l2-multicast limit trap-interval

Parameters

Parameter Description Value
trap-interval min-interval Indicates the interval for sending trap messages. The value ranges from 1 to 1200, in seconds.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

When the number of groups requested by users exceeds the upper limit configured on the switch, the switch does not create Layer 2 multicast entries for the excess requests. In this case, the switch can send trap messages to notify the network administrator. By default, the switch sends trap messages immediately after it fails to create Layer 2 multicast entries. If the switch fails to create Layer 2 multicast entries many times, it will send a large number of trap messages, which affects system performance.

This command sets the interval sending trap messages. After an interval is set, the switch will not send a trap message of Layer 2 multicast entry creation failure if the interval between the current time and the last trap message sending time is smaller than the configured value.

Example

# Set the interval for sending trap messages to 100.

<HUAWEI> system-view
[HUAWEI] l2-multicast limit trap-interval 100

mgmd total-number threshold-alarm

Function

The mgmd total-number threshold-alarm command sets the upper and lower alarm thresholds for IGMP/MLD entries.

The undo mgmd total-number threshold-alarm command restores the default alarm thresholds for IGMP/MLD entries.

By default, the upper and lower alarm thresholds are 80% and 75% respectively.

Format

mgmd total-number threshold-alarm upper-limit upper-limit-value lower-limit lower-limit-value

undo mgmd total-number threshold-alarm

Parameters

Parameter Description Value
upper-limit upper-limit-value Specifies the upper alarm threshold for IGMP/MLD entries, in percentage. The value is an integer ranging from 1 to 100.
lower-limit lower-limit-value Specifies the lower alarm threshold for IGMP/MLD entries, in percentage. The value is an integer ranging from 1 to 100. lower-limit-value must be smaller than upper-limit-value.

Views

Multicast MIB view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A device supports a limited number of IGMP/MLD entries. After the number of IGMP/MLD entries reaches the maximum value, no more IGMP/MLD entries can be created. As a result, some multicast traffic cannot be forwarded. To facilitate network operation and maintenance, configure the upper and lower alarm thresholds for IGMP/MLD entries. IGMP/MLD entry alarms and clear alarms quickly notify you of IGMP/MLD entry usage. The mgmd total-number threshold-alarm command allows you to flexibly adjust the alarm thresholds for IGMP/MLD entries based on service requirements. Note that:

  • If the proportion of existing IGMP/MLD entries to the maximum number reaches upper-limit-value, an IGMP/MLD entry alarm is reported for all VPN instances. This alarm is informational only and does not affect creation of new IGMP/MLD entries.
  • If the proportion of existing IGMP/MLD entries to the maximum number falls below lower-limit-value, an IGMP/MLD entry clear alarm is reported for all VPN instances.

Prerequisites

This command only configures the alarm thresholds for IGMP/MLD entries. To enable the configured alarm thresholds to take effect, run the snmp-agent trap enable feature-name igmp trap-name { hwmgmdtotallimitthresholdexceed | hwmgmdtotallimitthresholdexceedclear } command twice to enable the device to report IGMP/MLD entry alarms and clear alarms.

Precautions

If the mgmd total-number threshold-alarm command is executed multiple times, only the latest configuration takes effect.

Example

# Configure the upper and lower alarm thresholds for IGMP/MLD entries.

<HUAWEI> system-view
[HUAWEI] multicast-mib
[HUAWEI-mcast-mib] mgmd total-number threshold-alarm upper-limit 88 lower-limit 77

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.

Views

Multicast MIB view

Default Level

2: Configuration level

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

multicast forwarding-table source-group-number threshold-alarm

Function

The multicast forwarding-table source-group-number threshold-alarm command configures the upper and lower alarm thresholds for multicast forwarding entries.

The undo multicast forwarding-table source-group-number threshold-alarm command restores the default alarm thresholds for multicast forwarding entries.

By default, the upper and lower alarm thresholds are 80% and 75% respectively.

Format

multicast forwarding-table source-group-number threshold-alarm upper-limit upper-limit-value lower-limit lower-limit-value

undo multicast forwarding-table source-group-number threshold-alarm

Parameters

Parameter Description Value
upper-limit upper-limit-value Specifies the upper alarm threshold for multicast forwarding entries, in percentage. The value is an integer ranging from 1 to 100.
lower-limit lower-limit-value Specifies the lower alarm threshold for multicast forwarding entries, in percentage. The value is an integer ranging from 1 to 100. lower-limit-value must be smaller than upper-limit-value.

Views

Multicast MIB view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A device supports a limited number of multicast forwarding entries. After the number of multicast forwarding entries reaches the maximum value, no more multicast forwarding 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 multicast forwarding entries. Multicast forwarding entry alarms and clear alarms quickly notify you of IGMP/MLD entry usage. The multicast forwarding-table source-group-number threshold-alarm command allows you to flexibly adjust the alarm thresholds for multicast forwarding entries based on service requirements. Note that:

  • If the proportion of existing multicast forwarding entries to the maximum number reaches upper-limit-value, a multicast forwarding entry alarm is reported. This alarm is informational only and does not affect creation of new multicast forwarding entries.
  • If the proportion of existing multicast forwarding entries to the maximum number falls below lower-limit-value, a multicast forwarding entry clear alarm is reported.

Prerequisites

This command only configures the alarm thresholds for multicast forwarding entries. To enable the configured alarm thresholds to take effect, run the snmp-agent trap enable feature-name mrm trap-name { hwipmcastsgthresholdexceed | hwipmcastsgthresholdexceedclear } command twice to enable the device to report multicast forwarding entry alarms and clear alarms.

Precautions

If the multicast forwarding-table source-group-number threshold-alarm command is executed multiple times, only the latest configuration takes effect.

Example

# Configure the upper and lower alarm thresholds for multicast forwarding entries.

<HUAWEI> system-view
[HUAWEI] multicast-mib
[HUAWEI-mcast-mib] multicast forwarding-table source-group-number threshold-alarm upper-limit 88 lower-limit 77

multicast mib-notification join-leave frequency

Function

The multicast mib-notification join-leave frequency command sets the maximum number of trap messages sent by the system per second when IGMP/MLD joining or leaving events occur.

The undo multicast mib-notification join-leave frequency command restores the default number of trap messages sent by the system per second when IGMP/MLD joining or leaving events occur.

By default, the system does not send any trap message when IGMP/MLD joining or leaving events occur.

Format

multicast mib-notification join-leave frequency count

undo multicast mib-notification join-leave frequency

Parameters

Parameter Description Value
count Specifies the maximum number of trap messages sent by the system per second when IGMP/MLD joining or leaving events occur. The value is an integer that ranges from 0 to 240. The unit is in packets per second. The default value is 0.

Views

Multicast MIB view

Default Level

2: Configuration level

Usage Guidelines

If network administrators need to know which receivers join or leave multicast groups in real time, run this command. The switch will send trap messages after receivers join or leave multicast groups.

Example

# Set the maximum number of trap messages sent by the system per second to 30 when IGMP/MLD joining or leaving events occur.

<HUAWEI> system-view
[HUAWEI] multicast-mib
[HUAWEI-mcast-mib] multicast mib-notification join-leave frequency 30

multicast-mib

Function

The multicast-mib command enables the multicast MIB and displays the multicast MIB view.

The undo multicast-mib command deletes all configurations in the multicast MIB view.

By default, the multicast MIB is not enabled.

Format

multicast-mib

undo multicast-mib

Parameters

None

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Run the undo multicast-mib command to delete all configurations in the multicast MIB view.

When using the undo multicast-mib command, you need to enter Y or N to confirm the action. This command will clear global multicast MIB configurations. So, use this command with caution.

Example

# Enable multicast MIB and enter the multicast MIB view.

<HUAWEI> system-view
[HUAWEI] multicast-mib
[HUAWEI-mcast-mib]

multicast threshold-alarm

Function

The multicast threshold-alarm command configures alarm threshold for multicast index resource usage.

The undo multicast threshold-alarm command restores the default alarm threshold.

By default, the alarm is generated when multicast index resource usage reaches 85%, and generated again when multicast index resource usage falls below 75%.

Format

multicast threshold-alarm upper-limit upper-limit lower-limit lower-limit

undo multicast threshold-alarm

Parameters

Parameter Description Value
upper-limit upper-limit Indicates the upper threshold for multicast index resource usage. The value is an integer that ranges from 2 to 100, in percentage.
lower-limit lower-limit Indicates the lower threshold for multicast index resource usage. The value is an integer that ranges from (upper-limit - 10) to (upper-limit - 1), in percentage.

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Multicast packets are forwarded based on multicast forwarding entries no matter whether the Layer 2 or Layer 3 multicast mode is used. Multicast forwarding entries occupy independent index resources on the switch. A high index resource usage indicates that the switch has forwarded too many multicast packets and there is a heavy load on it. If the resources for multicast forwarding entries are used up, multicast packets cannot be forwarded.

After the alarm threshold is set, the switch sends a trap when index resource usage reaches the threshold. You can monitor multicast index resource usage. When index resource usage reaches the upper threshold, the alarm 1.3.6.1.4.1.2011.5.25.227.2.1.8, 1.3.6.1.4.1.2011.5.25.227.2.1.10, or 1.3.6.1.4.1.2011.5.25.227.2.1.62 is generated, indicating that the index resources will be used up. When index resource usage falls below the lower threshold, the alarm 1.3.6.1.4.1.2011.5.25.227.2.1.9, 1.3.6.1.4.1.2011.5.25.227.2.1.11, or 1.3.6.1.4.1.2011.5.25.227.2.1.63 is generated, indicating that index resource usage is restored to an acceptable range.

Example

Set the upper threshold to 80% and lower threshold to 70%.

<HUAWEI> system-view
[HUAWEI] multicast threshold-alarm upper-limit 80 lower-limit 70

multicast trap-interval cac

Function

The multicast trap-interval cac command configures the interval for sending trap messages of the IGMP/PIM joining failure due to the limit of the Layer 3 multicast CAC policy.

The undo multicast trap-interval cac command deletes the limit to the interval for sending trap messages. When a Joining failure event occurs, a trap message is sent immediately.

By default, the interval for sending trap messages of the IGMP/PIM joining failure due to the limit of the multicast CAC policy is not limited.

Format

multicast trap-interval cac min-interval

undo multicast trap-interval cac

Parameters

Parameter Description Value
min-interval Specifies the interval for sending trap messages of the IGMP/PIM joining failure due to the limit of the multicast CAC policy. The value is an integer that ranges from 0 to 65535, in seconds. The default value is 0 seconds.

Views

Multicast MIB view

Default Level

2: Configuration level

Usage Guidelines

If the interval for sending trap messages is set to 0, a trap message will be sent immediately when a group joining failure occurs.

Example

# Set the interval for sending trap messages of the IGMP/PIM joining failure due to the limit of the multicast CAC policy to 50 seconds.

<HUAWEI> system-view
[HUAWEI] multicast-mib
[HUAWEI-multicast-mib] multicast trap-interval cac 50

pim mib-notification interval

Function

The pim mib-notification interval command sets the interval for sending trap messages about various PIM events.

The undo pim mib-notification interval command restores the default interval for sending trap messages about various PIM events.

By default, an alarm is generated only when a neighbor loss event or a neighbor addition event occurs. No alarm is generated when the other events occur.

Format

pim mib-notification interval { interface-election-dr election-value | invalid-join-prune jp-value | invalid-register register-value | neighbor-loss loss-value | new-neighbor new-value | rp-mapping-change change-value | mrt-limit mrt-value }

undo pim mib-notification interval { all | interface-election-dr | invalid-join-prune | invalid-register | neighbor-loss | new-neighbor | rp-mapping-change | mrt-limit }

Parameters

Parameter Description Value
interface-election-dr election-value Specifies the minimum interval for sending trap messages about DR election. The value is an integer that ranges from 0 to 65535, in seconds. The default value is 65535 seconds.
invalid-join-prune jp-value Specifies the minimum interval for sending trap messages about invalid Join/Prune messages. The value is an integer that ranges from 10 to 65535, in seconds. The default value is 65535 seconds.
invalid-register register-value Specifies the minimum interval for sending trap messages about invalid Register messages. The value is an integer that ranges from 10 to 65535, in seconds. The default value is 65535 seconds.
neighbor-loss loss-value Specifies the minimum interval for sending trap messages about neighbor loss. The value is an integer that ranges from 0 to 65535, in seconds. The default value is 0 seconds.
new-neighbor new-value Specifies the minimum interval for sending trap messages about neighbor addition. The value is an integer that ranges from 0 to 65535, in seconds. The default value is 0 seconds.
rp-mapping-change change-value Specifies the minimum interval for sending trap messages about the RP-mapping change. The value is an integer that ranges from 0 to 65535, in seconds. The default value is 65535 seconds.
mrt-limit mrt-value Specifies the minimum interval for sending trap messages about the failure in joining multicast groups because the number of PIM entries reaches the upper limit. The value is an integer that ranges from 10 to 65535, in seconds. By default, the value is 65535 seconds.
all Restore the default interval for PIM to send all trap messages. -

Views

Multicast MIB view

Default Level

2: Configuration level

Usage Guidelines

The pim mib-notification interval command sets the interval for sending trap messages. When an event occurs but the period from when the last trap message was sent to the current time is shorter than the configured interval, the system does not send any trap message.

  • If the default interval is 0, a trap message is sent immediately after an event occurs.

  • If the default interval is 65535, no trap message is sent after an event occurs. In this case, run this command to adjust the interval to a smaller value so that a trap message can be sent after an event occurs.

Example

# Set the interval for PIM to send trap messages about invalid Join/Prune messages.

<HUAWEI> system-view
[HUAWEI] multicast-mib
[HUAWEI-mcast-mib] pim mib-notification interval invalid-join-prune 50

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

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.

Views

Multicast MIB view

Default Level

2: Configuration level

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

snmp-agent trap enable feature-name igmp

Function

The snmp-agent trap enable feature-name igmp command enables the trap function for the IGMP module.

The undo snmp-agent trap enable feature-name igmp command disables the trap function for the IGMP module.

By default, the trap function for IGMP events is disabled.

Format

snmp-agent trap enable feature-name igmp [ trap-name { glblimit | iflimit | iflimitclr | inslimit | joingrp | leavegrp | hwmgmdgmptotallimitclear | hwmgmdgmpgloballimitclear | hwmgmdtotallimitthresholdexceed | hwmgmdtotallimitthresholdexceedclear | hwmgmdhoststargthresholdexceed | hwmgmdhoststargthresholdexceedclear | hwmgmdhoststargexceed | hwmgmdhoststargexceedclear | hwmgmdhostsgthresholdexceed | hwmgmdhostsgthresholdexceedclear | hwmgmdhostsgexceed | hwmgmdhostsgexceedclear } ]

undo snmp-agent trap enable feature-name igmp [ trap-name { glblimit | iflimit | iflimitclr | inslimit | joingrp | leavegrp | hwmgmdgmptotallimitclear | hwmgmdgmpgloballimitclear | hwmgmdtotallimitthresholdexceed | hwmgmdtotallimitthresholdexceedclear | hwmgmdhoststargthresholdexceed | hwmgmdhoststargthresholdexceedclear | hwmgmdhoststargexceed | hwmgmdhoststargexceedclear | hwmgmdhostsgthresholdexceed | hwmgmdhostsgthresholdexceedclear | hwmgmdhostsgexceed | hwmgmdhostsgexceedclear } ]

Parameters

Parameter Description Value
trap-name Enables the trap for a specified type of IGMP event. -
glblimit Enables the trap for the event indicating that the total number of the IGMP entries of all instances reaches the limit. -
iflimit Enables the trap for the event indicating that the number of IGMP entries on an interface reaches the limit. -
iflimitclr Enables the trap for the event indicating that the number of IGMP entries on an interface falls below the limit. -
inslimit Enables the trap for the event indicating that the number of IGMP entries in an instance reaches the limit. -
joingrp Enables the trap for the event indicating that an IGMP Join message is received. -
leavegrp Enables the trap for the event indicating that an IGMP Leave message is received or the group timer expires. -
hwmgmdgmptotallimitclear Enables the trap for the event indicating that the number of IGMP entries in all instances falls below the upper threshold. -
hwmgmdgmpgloballimitclear Enables the trap for the event indicating that the number of IGMP entries a single instance falls below the upper threshold. -
hwmgmdtotallimitthresholdexceed Enables the trap for the event indicating that the proportion of IGMP/MLD entries created to the maximum IGMP/MLD entries allowed reaches the upper alarm threshold. -
hwmgmdtotallimitthresholdexceedclear Enables the trap for the event indicating that the proportion of IGMP/MLD entries created to the maximum IGMP/MLD entries allowed falls below the lower alarm threshold. -
hwmgmdhoststargthresholdexceed Generates an alarm when the (*, G) entry usage of all instances reaches the specified upper alarm threshold on the user-side IGMP/MLD device. -
hwmgmdhoststargthresholdexceedclear Generates a clear alarm when the (*, G) entry usage of all instances falls below the specified lower alarm threshold on the user-side IGMP/MLD device. -
hwmgmdhoststargexceed Generates an alarm when the number of (*, G) entries of all instances exceeds the maximum number allowed on the user-side IGMP/MLD device. -
hwmgmdhoststargexceedclear Generates a clear alarm when the number of (*, G) entries of all instances falls below the maximum number allowed on the user-side IGMP/MLD device. -
hwmgmdhostsgthresholdexceed Generates an alarm when the (S, G) entry usage of all instances reaches the specified upper alarm threshold on the user-side IGMP/MLD device. -
hwmgmdhostsgthresholdexceedclear Generates a clear alarm when the (S, G) entry usage of all instances falls below the specified lower alarm threshold on the user-side IGMP/MLD device. -
hwmgmdhostsgexceed Generates an alarm when the number of (S, G) entries of all instances exceeds the maximum number allowed on the user-side IGMP/MLD device. -
hwmgmdhostsgexceedclear Generates a clear alarm when the number of (S, G) entries of all instances falls below the maximum number allowed on the user-side IGMP/MLD device. -

Views

System view

Default Level

2: Configuration level

Usage Guidelines

To enable the trap function for a specific type of event, specify trap-name. To enable the trap function for multiple types of events, run this command multiple times.

Example

# Enable the trap for the event indicating that an IGMP Join message is received.

<HUAWEI> system-view
[HUAWEI] snmp-agent trap enable feature-name igmp trap-name joingrp

# Disable the trap for the event indicating that an IGMP Join message is received.

<HUAWEI> system-view
[HUAWEI] undo snmp-agent trap enable feature-name igmp trap-name joingrp

snmp-agent trap enable feature-name l2-multicast

Function

The snmp-agent trap enable feature-name l2-multicast command enables the trap function for the Layer 2 multicast module.

The undo snmp-agent trap enable feature-name l2-multicast command disables the trap function for the Layer 2 multicast module.

By default, the trap function is disabled for the Layer 2 multicast module.

Format

snmp-agent trap enable feature-name l2-multicast [ trap-name { hwcfgrefreshfailalarm | hwl2mccacglobalchannelcountexceed | hwl2mccacglobalcountexceed | hwl2mccacglobalunspecifiedchanneldeny | hwl2mccacportchannelcountexceed | hwl2mccacportcountexceed | hwl2mccacportvlanchannelcountexceed | hwl2mccacportvlancountexceed | hwl2mccacvlanchannelcountexceed | hwl2mccacvlancountexceed | hwl2mccacvlanunspecifiedchanneldeny | hwl2mccacvsichannelcountexceed | hwl2mccacvsicountexceed | hwl2mccacvsiunspecifiedchanneldeny | hwmcasttableloadabnormalnotify | hwmcasttableloadabnormalresume | hwmcastvlanfailalarm | hwmcastvlanoknotify } ]

undo snmp-agent trap enable feature-name l2-multicast [ trap-name { hwcfgrefreshfailalarm | hwl2mccacglobalchannelcountexceed | hwl2mccacglobalcountexceed | hwl2mccacglobalunspecifiedchanneldeny | hwl2mccacportchannelcountexceed | hwl2mccacportcountexceed | hwl2mccacportvlanchannelcountexceed | hwl2mccacportvlancountexceed | hwl2mccacvlanchannelcountexceed | hwl2mccacvlancountexceed | hwl2mccacvlanunspecifiedchanneldeny | hwl2mccacvsichannelcountexceed | hwl2mccacvsicountexceed | hwl2mccacvsiunspecifiedchanneldeny | hwmcasttableloadabnormalnotify | hwmcasttableloadabnormalresume | hwmcastvlanfailalarm | hwmcastvlanoknotify } ]

Parameters

Parameter Description Value
trap-name Indicates the trap of Layer 2 multicast event of specified type. -
hwcfgrefreshfailalarm Enables the switch to send the trap when entries fail to be refreshed. -
hwl2mccacglobalchannelcountexceed Enables the switch to send the trap when Layer 2 multicast CAC detects that the number of member multicast groups of the global channel exceeds the upper limit. -
hwl2mccacglobalcountexceed Enables the switch to send the trap when Layer 2 multicast CAC detects that the number of global multicast groups exceeds the upper limit. -
hwl2mccacglobalunspecifiedchanneldeny Enables the switch to send the trap when a Report message for a multicast group not belonging to any channel is received after the channel is configured with the unspecified-channel deny command. -
hwl2mccacportchannelcountexceed Enables the switch to send the trap when Layer 2 multicast CAC detects that the number of member multicast groups of the channel on an interface exceeds the upper limit. -
hwl2mccacportcountexceed Enables the switch to send the trap when Layer 2 multicast CAC detects that the number of multicast groups on an interface exceeds the upper limit. -
hwl2mccacportvlanchannelcountexceed Enables the switch to send the trap when Layer 2 multicast CAC detects that the number of member multicast groups of the channel on an interface in a VLAN exceeds the upper limit. -
hwl2mccacportvlancountexceed Enables the switch to send the trap when Layer 2 multicast CAC detects that the number of multicast groups on an interface in a VLAN exceeds the upper limit. -
hwl2mccacvlanchannelcountexceed Enables the switch to send the trap when Layer 2 multicast CAC detects that the number of member multicast groups of the channel in a VLAN exceeds the upper limit. -
hwl2mccacvlancountexceed Enables the switch to send the trap when Layer 2 multicast CAC detects that the number of multicast groups in a VLAN exceeds the upper limit. -
hwl2mccacvlanunspecifiedchanneldeny Enables the switch to send the trap when a Report message for a multicast group not belonging to any channel is received after the channel is configured with the unspecified-channel deny command. -
hwl2mccacvsichannelcountexceed Enables the switch to send the trap when Layer 2 multicast CAC detects that the number of member multicast groups of the channel in a VSI exceeds the upper limit. -
hwl2mccacvsicountexceed Enables the switch to send the trap when Layer 2 multicast CAC detects that the number of multicast groups in a VSI exceeds the upper limit. -
hwl2mccacvsiunspecifiedchanneldeny Enables the switch to send the trap when a Report message for a multicast group not belonging to any channel is received after the channel is configured with the unspecified-channel deny command. -
hwmcasttableloadabnormalnotify Enables the switch to send the trap when the number of configured entries exceeds the upper limit. -
hwmcasttableloadabnormalresume Enables the switch to send the trap when the number of configured entries falls below the upper limit. -
hwmcastvlanfailalarm Enables the trap for the event that the VLAN becomes invalid. -
hwmcastvlanoknotify Enables the switch to send the trap when the VLAN becomes valid again. -

Views

System view

Default Level

2: Configuration level

Usage Guidelines

The Layer 2 multicast module is not configured with the function of excess traps.

If you do not specify trap-name, all traps of the L2 Multicast module will be enabled.

Example

# Enables trap of the hwl2mccacportcountexceed.

<HUAWEI> system-view
[HUAWEI] snmp-agent trap enable feature-name l2-multicast hwl2mccacportcountexceed

snmp-agent trap enable feature-name mcast

Function

The snmp-agent trap enable feature-name mcast command enables the trap function for the MCAST module.

The undo snmp-agent trap enable feature-name mcast command disables the trap function for the MCAST module.

By default, the trap function is enabled for the MCAST module.

Format

snmp-agent trap enable feature-name mcast [ trap-name { hwboardipmcreslack | hwboardipmcreslackresume | hwboardl2mcreslack | hwboardl2mcreslackresume } ]

undo snmp-agent trap enable feature-name mcast [ trap-name { hwboardipmcreslack | hwboardipmcreslackresume | hwboardl2mcreslack | hwboardl2mcreslackresume } ]

Parameters

Parameter

Description

Value

trap-name

Enables or disables the trap function for the specified event.

-

hwboardipmcreslack

Enables the Huawei proprietary trap that will be sent when the IPMC index resources are insufficient.

-

hwboardipmcreslackresume

Enables the Huawei proprietary trap that will be sent when the alarm on IPMC index resource insufficiency is cleared.

-

hwboardl2mcreslack

Enables the Huawei proprietary trap that will be sent when the L2MC index resources are insufficient.

-

hwboardl2mcreslackresume

L2MC the Huawei proprietary trap that will be sent when the alarm on L2MC index resource insufficiency is cleared.

-

Views

System view

Default Level

2: Configuration level

Usage Guidelines

When the trap function is enabled, the switch generates traps and uses SNMP to send traps to the NMS. When the trap function is not enabled, the switch does not generate traps and the SNMP module does not send traps to the NMS.

You can specify trap-name to enable the trap function for one or more events.

Example

# Enable the switch to send a Huawei proprietary trap when the L2MC index resources are insufficient.

<HUAWEI> system-view
[HUAWEI] snmp-agent trap enable feature-name mcast trap-name hwboardl2mcreslack

snmp-agent trap enable feature-name mld

Function

The snmp-agent trap enable feature-name mld command enables the trap function for the MLD module.

The undo snmp-agent trap enable feature-name mld command disables the trap function for the MLD module.

By default, the trap function for MLD events is disabled.

Format

snmp-agent trap enable feature-name mld [ trap-name { glblimit | iflimit | iflimitclr | inslimit | joingrp | leavegrp | hwmgmdgmptotallimitclear | hwmgmdgmpgloballimitclear } ]

undo snmp-agent trap enable feature-name mld [ trap-name { glblimit | iflimit | iflimitclr | inslimit | joingrp | leavegrp | hwmgmdgmptotallimitclear | hwmgmdgmpgloballimitclear } ]

Parameters

Parameter Description Value
trap-name Enables the trap of MLD events of specified types. -
glblimit Enables the trap that the total number of the MLD entries of all instances reaches the limit value. -
iflimit Enables the trap that the number of MLD entries on an interface reaches the limit value. -
iflimitclr Enables the trap that the number of MLD entries on an interface falls below the upper threshold -
inslimit Enables the trap that the number of MLD entries in an instance reaches the limit value. -
joingrp Enables the trap of the event that an MLD Join message is received. -
leavegrp Enables the trap of the event that an MLD Leave message is received or the group timer expires. -
hwmgmdgmptotallimitclear Generates an alarm when the number of MLD entries in a single instance falls below the upper threshold. -
hwmgmdgmpgloballimitclear Generates an alarm when the number of MLD entries in all instances falls below the upper threshold. -

Views

System view

Default Level

2: Configuration level

Usage Guidelines

To enable the trap function of one or more types of trap messages, specify trap-name.

Example

# Enable the trap of the event that an MLD Join message is received.

<HUAWEI> system-view
[HUAWEI] snmp-agent trap enable feature-name mld trap-name joingrp

# Disable the trap of the event that an MLD Join message is received.

<HUAWEI> system-view
[HUAWEI] undo snmp-agent trap enable feature-name mld trap-name joingrp

snmp-agent trap enable feature-name mrm

Function

The snmp-agent trap enable feature-name mrm command enables the trap function for the Multicast Routing Management (MRM) module.

The undo snmp-agent trap enable feature-name mrm command disables the trap function for the MRM module.

By default, the trap function for MRM events is disabled.

Format

snmp-agent trap enable feature-name mrm [ trap-name { cacglbchn | cacglbtotal | cacoifchn | cacoiftotal | hwipmcastsgexceed | hwipmcastsgexceedclear | hwipmcastsgthresholdexceed | hwipmcastsgthresholdexceedclear } ]

undo snmp-agent trap enable feature-name mrm [ cacglbchn | cacglbtotal | cacoifchn | cacoiftotal | hwipmcastsgexceed | hwipmcastsgexceedclear | hwipmcastsgthresholdexceed | hwipmcastsgthresholdexceedclear } ]

Parameters

Parameter Description Value
trap-name Enables the trap for a specified type of MRM event. -
cacglbchn Enables the trap for the event indicating that a PIM entry fails to be created for a channel because the number of PIM entries of the channel exceeds the channel-based CAC limit. -
cacglbtotal Enables the trap for the event indicating that a PIM entry fails to be added because the number of PIM entries of all instances exceeds the total CAC limit for all instances. -
cacoifchn Enables the trap for the event indicating that the number of PIM entries with a specific interface as the outbound interface exceeds the channel-based CAC limit configured on the interface. -
cacoiftotal Enables the trap for the event indicating that the number of PIM entries with a specified interface as the outbound interface exceeds the total CAC limit configured on the interface. -
hwipmcastsgexceed Enables the trap for the event indicating that the number of (S, G) multicast forwarding entries created exceeds the maximum number of (S, G) multicast forwarding entries allowed. -
hwipmcastsgexceedclear Enables the trap for the event indicating that the number of (S, G) multicast forwarding entries created falls below the maximum number of (S, G) multicast forwarding entries allowed. -
hwipmcastsgthresholdexceed Enables the trap for the event indicating that the proportion of (S, G) multicast forwarding entries created to the maximum (S, G) multicast forwarding entries allowed exceeds the upper alarm threshold. -
hwipmcastsgthresholdexceedclear Enables the trap for the event indicating that the proportion of (S, G) multicast forwarding entries created to the maximum (S, G) multicast forwarding entries allowed falls below the lower alarm threshold. -

Views

System view

Default Level

2: Configuration level

Usage Guidelines

To enable the trap function for a specific type of event, specify trap-name. To enable the trap function for multiple types of events, run this command multiple times.

Example

# Enable the trap for the event indicating that the number of PIM entries of a channel exceeds the channel-based CAC limit.

<HUAWEI> system-view
[HUAWEI] snmp-agent trap enable feature-name mrm trap-name cacglbchn

# Disable the trap for the event indicating that the number of PIM entries of a channel exceeds the channel-based CAC limit.

<HUAWEI> system-view
[HUAWEI] undo snmp-agent trap enable feature-name mrm trap-name cacglbchn

snmp-agent trap enable feature-name msdp

Function

The snmp-agent trap enable feature-name msdp command enables the traps function for the MSDP module.

The undo snmp-agent trap enable feature-name msdp command disables the traps function for the MSDP module.

By default, the trap function for MSDP events is disabled.

Format

snmp-agent trap enable feature-name msdp [ trap-name { establish | backward } ]

undo snmp-agent trap enable feature-name msdp [ trap-name { establish | backward } ]

Parameters

Parameter Description Value
trap-name Enables the traps of MSDP events of specified types. -
establish Enables the trap of the setup of the MSDP peer relationship. -
backward Enables the trap of the deletion of the MSDP peer relationship. -

Views

System view

Default Level

2: Configuration level

Usage Guidelines

To enable the traps of one or more events, you can specify trap-name.

Example

# Enable the trap of the setup of the MSDP peer relationship in the system view.

<HUAWEI> system-view
[HUAWEI] snmp-agent trap enable feature-name msdp trap-name establish

# Disable the trap of the setup of the MSDP peer relationship in the system view.

<HUAWEI> system-view
[HUAWEI] undo snmp-agent trap enable feature-name msdp trap-name establish

snmp-agent trap enable feature-name pim

Function

The snmp-agent trap enable feature-name pim command enables the trap function for PIM events.

The undo snmp-agent trap enable feature-name pim command disables the trap function for PIM events.

By default, the trap function for PIM events is disabled.

Format

snmp-agent trap enable feature-name pim [ trap-name { neighbor-loss | invalid-join-prune | rp-mapping-change | interface-election | invalid-register | new-neighbor | mrt-limit | hwpimmrtlimitclear | hwpimsgexceed | hwpimsgexceedclear | hwpimsgthresholdexceed | hwpimsgthresholdexceedclear | hwpimstargexceed | hwpimstargexceedclear | hwpimstargthresholdexceed | hwpimstargthresholdexceedclear } ]

undo snmp-agent trap enable feature-name pim [ trap-name { neighbor-loss | invalid-join-prune | rp-mapping-change | interface-election | invalid-register | new-neighbor | mrt-limit | hwpimmrtlimitclear | hwpimsgexceed | hwpimsgexceedclear | hwpimsgthresholdexceed | hwpimsgthresholdexceedclear | hwpimstargexceed | hwpimstargexceedclear | hwpimstargthresholdexceed | hwpimstargthresholdexceedclear } ]

Parameters

Parameter Description Value
trap-name Enables the trap for a specified type of PIM event. -
neighbor-loss Enables the trap for the PIM neighbor loss event. -
invalid-join-prune Enables the trap for the event indicating that an invalid Join/Prune message is received. -
rp-mapping-change Enables the trap for the PIM RP-mapping change event. -
interface-election Enables the trap for the event indicating that a PIM interface is elected as the DR. -
invalid-register Enables the trap for the event indicating that an invalid Register message is received. -
new-neighbor Enables the trap for the event indicating that a new PIM neighbor appears. -
mrt-limit Enables the trap for the event indicating that the number of PIM entries exceeds the limit. -
hwpimmrtlimitclear Enables the trap for the event indicating that the total number of PIM entries falls below the limit. -
hwpimsgexceed Enables the trap for the event indicating that the number of PIM (S, G) entries created exceeds the maximum number of PIM (S, G) entries allowed. -
hwpimsgexceedclear Enables the trap for the event indicating that the number of PIM (S, G) entries created falls below the maximum number of PIM (S, G) entries allowed. -
hwpimsgthresholdexceed Enables the trap for the event indicating that the proportion of PIM (S, G) entries created to the maximum PIM (S, G) entries allowed exceeds the upper alarm threshold. -
hwpimsgthresholdexceedclear Enables the trap for the event indicating that the proportion of PIM (S, G) entries created to the maximum PIM (S, G) entries allowed falls below the lower alarm threshold. -
hwpimstargexceed Enables the trap for the event indicating that the number of PIM (*, G) entries created exceeds the maximum number of PIM (*, G) entries allowed. -
hwpimstargexceedclear Enables the trap for the event indicating that the number of PIM (*, G) entries created falls below the maximum number of PIM (*, G) entries allowed. -
hwpimstargthresholdexceed Enables the trap for the event indicating that the proportion of PIM (*, G) entries created to the maximum PIM (*, G) entries allowed exceeds the upper alarm threshold. -
hwpimstargthresholdexceedclear Enables the trap for the event indicating that the proportion of PIM (*, G) entries created to the maximum PIM (*, G) entries allowed falls below the lower alarm threshold. -

Views

System view

Default Level

2: Configuration level

Usage Guidelines

To enable the trap function for a specific type of event, specify trap-name. To enable the trap function for multiple types of events, run this command multiple times.

Example

# Enable the trap for the PIM neighbor loss event in the system view.

<HUAWEI> system-view
[HUAWEI] snmp-agent trap enable feature-name pim trap-name neighbor-loss

# Disable the trap for the PIM neighbor loss event in the system view.

<HUAWEI> system-view
[HUAWEI] undo snmp-agent trap enable feature-name pim trap-name neighbor-loss

snmp-agent trap enable feature-name pim-std

Function

The snmp-agent trap enable feature-name pim-std command enables PIM-STD traps.

The undo snmp-agent trap enable feature-name pim-std command disables related PIM-STD traps.

By default, the trap function for PIM-STD MIB events is disabled.

Format

snmp-agent trap enable feature-name pim-std [ trap-name { pimneighborloss | piminvalidregister | piminvalidjoinprune | pimrpmappingchange | piminterfaceelection } ]

undo snmp-agent trap enable feature-name pim-std [ trap-name { pimneighborloss | piminvalidregister | piminvalidjoinprune | pimrpmappingchange | piminterfaceelection } ]

Parameters

Parameter Description Value
trap-name Enables the trap function for specific events. -
pimneighborloss Enables the trap function for the PIM-STD MIB events of neighbor loss. -
piminvalidregister Enables the trap function for the PIM-STD MIB events of invalid Register messages. -
piminvalidjoinprune Enables the trap function for the PIM-STD MIB events of invalid Join/Prune messages. -
pimrpmappingchange Enables the trap function for the PIM-STD MIB events of RP-Mapping change. -
piminterfaceelection Enables the trap function for the PIM-STD MIB events of interface election. -

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

At present, the defined public PIM-STD MIB traps events include neighbor loss, invalid Join/Prune messages, RP-mapping change, interface election, and invalid Register messages. You can run the snmp-agent trap enable feature-name pim-std command to enable the trap function for PIM-STD MIB events when you need to monitor the current status of PIM protocol events.

Precautions

When using the snmp-agent trap enable feature-name pim-std, note the following points:

  • Run the snmp-agent trap enable feature-name pim-std command directly to enable the trap function for all PIM-STD MIB events.

  • Specify trap-name to enable the trap function for a specified type of PIM-STD MIB events.

Example

# Enable the trap function for the PIM-STD MIB events of neighbor loss.

<HUAWEI> system-view
[HUAWEI] snmp-agent trap enable feature-name pim-std trap-name pimneighborloss

# Enable the trap function for all PIM-STD MIB events.

<HUAWEI> system-view
[HUAWEI] snmp-agent trap enable feature-name pim-std

# Disable the trap function for the PIM-STD MIB events of neighbor loss.

<HUAWEI> system-view
[HUAWEI] undo snmp-agent trap enable feature-name pim-std trap-name pimneighborloss
Translation
Download
Updated: 2019-04-09

Document ID: EDOC1100065659

Views: 127943

Downloads: 88

Average rating:
This Document Applies to these Products
Related Version
Related Documents
Share
Previous Next