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

AR500, AR510, and AR530 V200R007 Commands 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

display pim mib-control-message

Function

The display pim mib-control-message counters command displays 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 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 invalid Join/Prune message that is received at the last time.

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 invalid Register message that is received at 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

None

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 changes, 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 GigabitEthernet0/0/1
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 9-112  Description of the display pim mib-control-message command output

Item

Description

pim mib-control-message counters

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 changes, and the number of received and sent Assert messages.

The last invalid join-prune message received information

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

The last assert message received or sent on GigabitEthernet0/0/1

Display the Assert message that is sent or received at the last time

The last invalid register message received information

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

Neighbor-loss(times)

The number of neighbor loss events

DR-Election (times)

The number of times for DR election

Invalid-join-prune(times)

The number of invalid Join/Prune messages

RP-Mapping(times)

The number of RP-mapping changes

Invalid-register(times)

The number of invalid Register messages

Assert-received(times)

The number of received Assert messages

Assert-send(times)

The number of sent Assert messages

Group address

Multicast group address

Source address

Multicast source address

RP address

RP address

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 9-113  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.

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                     off
IFLIMITCLR                      off                     off
INSLIMIT                        off                     off
GLBLIMIT                        off                     off
HWMGMDGMPGLOBALLIMITCLEAR       off                     off
HWMGMDGMPTOTALLIMITCLEAR        off                     off
JOINGRP                         off                     off
LEAVEGRP                        off                     off

hwMgmdTotalLimitThresholdExceed
                                off                     off
hwMgmdTotalLimitThresholdExceedClear
                                off                     off
hwMgmdHostStarGThresholdExceed  off                     off
hwMgmdHostStarGThresholdExceedClear
                                off                     off
hwMgmdHostStarGExceed           off                     off
hwMgmdHostStarGExceedClear      off                     off
hwMgmdHostSGThresholdExceed     off                     off
hwMgmdHostSGThresholdExceedClear
                                off                     off
hwMgmdHostSGExceed              off                     off
hwMgmdHostSGExceedClear         off                     off
Table 9-114  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: a trap message indicating that the proportion of global IGMP/MLD entries created to the maximum global IGMP/MLD entries allowed reaches the upper alarm threshold.
  • hwMgmdTotalLimitThresholdExceedClear: a trap message indicating that the proportion of global IGMP/MLD entries created to the maximum global 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 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.

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 9-115  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 falled below the limit.
  • JOINGRP: a trap message indicating that a MLD Join message is received

  • LEAVEGRP: a trap message indicating that a 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 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

Usage Scenario

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.

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 9-116  Description of the display snmp-agent trap feature-name msdp all command output

Item

Description

Feature name

Indicates the name of the module.

Trap number

Indicates the type number of a trap.

Trap name

Indicates the 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.

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 9-117  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

Usage Scenario

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.

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 9-118  Description of the display snmp-agent trap feature-name pim-std all command output

Item

Description

Feature name

Feature name

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 of the failure of IGMP joining because the number of the IGMP entries exceeds the limit.

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

By default, the interval for sending trap messages of the failure of IGMP joining because the number of the IGMP entries exceeds the limit is not limited

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

When the interval is configured to 0 by using the igmp trap-interval limit command, the interval for IGMP to send trap messages of the failure of IGMP joining because the number of the IGMP entries exceeds the limit is not limited; otherwise, the interval for sending trap messages of the failure of IGMP joining because the number of the IGMP entries exceeds the limit should be equal to or longer than the configured one.

Example

# Set the interval for sending trap messages of the failure of IGMP joining 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

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

None

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.

In 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]

pim mib-notification interval

Function

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

The undo pim mib-notification interval command restores the default interval for PIM to send various trap messages.

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.
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.
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.
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, if the period since the last time for sending the trap message is shorter than the configured interval, the system does not send any trap message.

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

  • If the default interval is 65535, it indicates that no trap message is sent after an event occurs. Then 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

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 Generates an alarm when the proportion of global IGMP/MLD entries created to the maximum global IGMP/MLD entries allowed reaches the upper alarm threshold. -
hwmgmdtotallimitthresholdexceedclear Generates a clear alarm when the proportion of global IGMP/MLD entries created to the maximum global 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

3: Management 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 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 limit value. -
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 all instances falls below the upper threshold. -
hwmgmdgmpgloballimitclear Generates an alarm when the number of MLD entries in a single instance falls below the upper threshold. -

Views

System view

Default Level

3: Management 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 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

3: Management 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

3: Management 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

3: Management 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

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.

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 : 4                                                                 
------------------------------------------------------------------------------  
Trap name                       Default switch status   Current switch status   
hwIpMcastSGThresholdExceed      off                     off                     
hwIpMcastSGThresholdExceedClear                                                 
                                off                     off                     
hwIpMcastSGExceed               off                     off                     
hwIpMcastSGExceedClear          off                     off                     
Table 9-119  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.

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 help you learn IGMP/MLD entry usage in a timely manner. 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 facilitate 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 run:

  • 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 one configures the upper and lower alarm thresholds, while the latter one 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 operation and maintenance, configure the upper and lower alarm thresholds for multicast forwarding entries. Multicast forwarding entry alarms and clear alarms help you learn IGMP/MLD entry usage in a timely manner. 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

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 operation and maintenance, configure the upper and lower alarm thresholds for PIM entries. PIM entry alarms and clear alarms help you learn PIM entry usage in a timely manner. The pim threshold-alarm command allows you to flexibly 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 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 { hwipmcastsgexceed | hwipmcastsgexceedclear | hwipmcastsgthresholdexceed | hwipmcastsgthresholdexceedclear } ]

undo snmp-agent trap enable feature-name mrm [ trap-name { hwipmcastsgexceed | hwipmcastsgexceedclear | hwipmcastsgthresholdexceed | hwipmcastsgthresholdexceedclear } ]

Parameters

Parameter Description Value
trap-name Enables the trap for a specified type of MRM event. -
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

3: Management 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

# 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.

<Huawei> system-view
[Huawei] snmp-agent trap enable feature-name mrm trap-name hwipmcastsgexceed

# Disable 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.

<Huawei> system-view
[Huawei] undo snmp-agent trap enable feature-name mrm trap-name hwipmcastsgexceed
Translation
Download
Updated: 2019-05-29

Document ID: EDOC1000097293

Views: 91498

Downloads: 124

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