Network Node Manager i (NNMi): Clarification on the AutoTrim Incidents functionality

  • KM00442666
  • 31-May-2013
  • 24-Aug-2013

Summary

There is often a need to reduce the number of incidents in NNMi's incidents database. The AutoTrim Incidents feature automates this process. Enabling the feature involves editing an NNMi system properties file named "nms-jboss.properties". However, the Deployment Guide and the comments in the "nms-jboss.properties" file contradict each other on the values of the parameters configurable in the "nms-jboss.properties" file.

Question

Page 370 of the 9.1x NNMi Deployment Reference, (page 402 for 9.2), says:
"I
f you want to trim 30 000 traps after traps in NNMi database exceed 60 000, then you set:-
com.hp.nnm.events.snmpTrapAutoTrimStartPercentage=60
and
com.hp.nnm.events.snmpTrapAutoTrimPercentageToDelete=50     //which means 50% of 60 000 (snmpTrapAutoTrimStartPercentage), which equals 30 000

However, if you read the "nms-jboss.properties" file, for the parameter snmpTrapAutoTrimStartPercentage it says:-

# The following property determines when to start the auto-trim process. This
# is specified as a percentage of com.hp.nnm.events.snmpTrapMaxStoreLimit.          //where we know snmpTrapMaxStoreLimit=100000

com.hp.nnm.events.snmpTrapAutoTrimStartPercentage=60

However, about snmpTrapAutoTrimPercentageToDelete  it says:-
# The following property determines how many traps to trim when auto-trim
# determines it is time to start the auto-trim process. This is
# specified as a percentage of com.hp.nnm.events.snmpTrapMaxStoreLimit.

com.hp.nnm.events.snmpTrapAutoTrimPercentageToDelete=50

As explained, both snmpTrapAutoTrimStartPercentage and  snmpTrapAutoTrimPercentageToDelete are specified as percentages of snmpTrapMaxStoreLimit.

If both snmpTrapAutoTrimStartPercentage and  snmpTrapAutoTrimPercentageToDelete are specified as percentages of snmpTrapMaxStoreLimit, then to trim 30 000 incidents, when number of incidents cross 60 000, the parameter values values shoudl be:-
snmpTrapAutoTrimStartPercentage = 60
and
snmpTrapAutoTrimPercentageToDelete = 30    //not 50, because 30% of 100000 (snmpTrapMaxStoreLimit) is 30 000

So which one is correct?

Answer

The comments mentioned in the "nms-jboss.properties" file are incorrect.
The parameter snmpTrapAutoTrimPercentageToDelete is a percentage of snmpTrapAutoTrimStartPercentage, not snmpTrapMaxStoreLimit.
This is a documentation defect recorded at:-
http://support.microfocus.com/kb/kmdoc.php?id=FID/DOCUMENTUM_QCCR1B115501