Enabling SNMP trap notifications and in-context application launches for HP NNM 9.x

This topic describes how to enable HP Network Node Manager (NNM) version 9.x to receive SNMP notifications and launch TrueSight Network Automation reports and remediation requests.

To enable SNMP trap notifications

  1. According to your HP NNM server OS:
    • (Linux) Log in as root.
    • (Microsoft Windows) Log in as Administrator.
  2. Load the MIB to enable HP NNM to translate OID numbers into names when displaying traps received from Network AutomationTrueSight Network Automation.

    Locate the EmprisaNetworksV2C.mib file in the BCAN_HOME\public\bmc\bca-networks\mib directory.
  3. Copy the EmprisaNetworksV2C.mib file to a temp directory on the HP NNM server.

  4. Run the following commands:{{code language="none"}}


    {{/code}}    nnmloadmib.ovpl -u USERNAME -p PASSWORD -load /tmp/EmprisaNetworksV2C.mib

    nnmincidentcfg.ovpl -u USERNAME -p PASSWORD -loadTraps EMPRISANETWORKSV2C-MIB

     

    Note

    Replace USERNAME and PASSWORD with the credentials of an HP NNM user with at least an administrator role.

  5. Log in to NNMi.
  6. Go to Configuration > Incidents > SNMP Trap Configurations.

  7. Find the TrueSight Network Automation-related traps.

    Tip

     These traps are named starting with enaNotify.

  8. Select the trap of interest and click Open.

  9. Change the Message Format to:

    BNA $3, Device: $4, BNA URL $5

     

    This makes the displayed message include more of the trap's details (instead of just showing the trap's name). This is just a suggested format and can be customized. Here are suggestions for the other trap names. You might also change the Severity, Category, and Family to better aid in handling and filtering a large volume of traps.

     

    SNMP Trap Name

    Message Format

    enaNotifyActionLow

    BNA $3, Device: $4, BNA URL $5

    enaNotifyActionMedium

    BNA $3, Device: $4, BNA URL $5

    enaNotifyActionHigh

    BNA $3, Device: $4, BNA URL $5

    enaNotifyDiscrepancyFound

    BNA $3, Device: $4, BNA URL $5

    enaNotifyAllDiscrepanciesCleared

    BNA $3, Device: $4, BNA URL $5

    enaNotifyCompliancyViolationFound

    BNA $3, Device: $4, Violation: $6, BNA URL $5

    enaNotifyAllCompliancyViolationsCleared

    BNA $3, Device: $4, BNA URL $5

To configure in-context application launches

You may create NNM map menu options that execute URLs that take you directly to Network Automation reports and jobs. What follows are just suggestions. You may customize these to have as many or few as you want. See Launching-reports-and-jobs-from-third-party-applications for the specific URLs that can be launched.

This example shows a launch action into a Compliance Summary Report. The table after the example has other suggested URLs you can copy and paste from.

  1. Log in to HP NNMi.
  2. Go to Configuration > User Interface > Menu Items.
  3. Click New.
  4. Fill in values similar to the ones shown in the following figure:

    NNM9_MenuItem.PNG
  5. In the Menu Item Contexts panel, click New. For the Menu Item Action, select New Launch Action. Fill in values similar to the ones shown in the following figure, then click Save and Close:

    NNM9-MenuLaunchAction.PNG
  6. Fill in values in the Menu Item Action similar to the ones shown in the following figure, then click Save and Close:

    NNM9-MenuContext.PNG
  7. Click Save and Close for the menu item.

The full URL looks like:

https://<bna-server>/bca-networks/externalurl/external.do?target=complianceSummaryReport&showSuccessful=yes&spanType=device&spanName=${name}

Substitute <bna-server> with the actual IP address or host name of your Network Automation server.

Note

${name} substitutes the actual device name into the URL string. This name must match exactly with the value in the Name field of the Failed to execute the [excerpt-include] macro. Cause: [Error number 2 in 0: No wiki with id [confluencePage:page] could be found]. Click on this message for details.
device record. This will be the case if you import from NNM into Network Automation. 

The following table shows some suggested URL actions:

Menu Label

Full URL

Compliance Summary Report

https://<bna-server>:<bna-port>/bca-networks/externalurl/external.do?target=complianceSummaryReport&showSuccessful=yes&spanType=device&spanName=${name}

Change Summary Report

https://<bna-server>:<bna-port>/bca-networks/externalurl/external.do?target=changeSummaryReport&timePeriodType=last7Days&showEvents=yes&spanType=device&spanName=${name}

Device Inventory Report

https://<bna-server>:<bna-port>/bca-networks/externalurl/external.do?target=deviceInventoryReport&selectedFields=iosEntities&spanType=device&spanName=${name}

OS Image History Report

https://<bna-server>:<bna-port>/bca-networks/externalurl/external.do?target=osImageHistoryReport&timePeriodType=thisYear&spanType=device&spanName=${name}

Running vs Startup

https://<bna-server>:<bna-port>/bca-networks/externalurl/external.do?target=discDetailsReport&showRT=no&showST=no&showOS=no&deviceName=${name}

Deploy To Active Job

https://<bna-server>:<bna-port>/bca-networks/externalurl/external.do?target=deploytoactive&spanType=device&spanName=${name}

Commit Job

https://<bna-server>:<bna-port>/bca-networks/externalurl/external.do?target=commit&spanType=device&spanName=${name}

Snapshot Job

https://<bna-server>:<bna-port>/bca-networks/externalurl/external.do?target=snapshot&spanType=device&spanName=${name}

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*