Installation

Install the plugin by deploying the KAR file and enabling the Karaf feature. Optionally, enable the ticketer plugin if you plan to create ServiceNow incidents from OpenNMS alarms.

Deploy via KAR file

Copy the provided KAR file to the OpenNMS deploy directory. The following example assumes OpenNMS is installed in /opt/opennms:

cp path/to/opennms-plugin-servicenow.kar /opt/opennms/deploy/

Install the feature

Install the feature manually in the Karaf shell without restarting OpenNMS:

ssh -p 8101 admin@localhost
admin@opennms()> feature:install opennms-plugin-servicenow

To ensure the feature persists across restarts, add it to featuresBoot.d:

echo "opennms-plugin-servicenow wait-for-kar=opennms-plugin-servicenow" > ${OPENNMS_HOME}/etc/featuresBoot.d/plugin-servicenow.boot

Enable the ticketer plugin

If you plan to create ServiceNow incidents from OpenNMS alarms, enable the ticketer plugin:

  1. Create the properties file:

    echo "opennms.ticketer.plugin = org.opennms.netmgt.ticketd.OSGiBasedTicketerPlugin" >> ${OPENNMS_HOME}/etc/opennms.properties.d/osgi-ticketer.properties
echo "opennms.alarmTroubleTicketEnabled = true" >> ${OPENNMS_HOME}/etc/opennms.properties.d/osgi-ticketer.properties

  2. Restart OpenNMS:

    $OPENNMS_HOME/bin/opennms -vt restart