Jira Trouble Ticket Plugin

From OpenNMS

!!Note, this plugin is a first release!!

Contents 1 Design Notes 2 Compiling the Jira Ticketer 3 Configuring the Jira Ticketer 4 Restart OpenNMS and the Webapp 5 Version History/Availability

Design Notes

The Jira Ticketer plugin is designed around Jira's SOAP service. This allows the plugin to work with comments and workflows. Thus you need to setup the WSDL for your instance of Jira; they all differ.

Compiling the Jira Ticketer

• Grab the WSDL of your Jira instance it can be found at: http://myjirahost/rpc/soap/jirasoapservice-v2?wsdl
• Put this file in opennms-tools/jira-troubleticketer/src/main/wsdl/jirasoapservice-v2.wsdl
• Build the plugin: ../../build.sh package assembly:attached
• You will have a plugin with the necessary dependencies in the target directory, copy it to $OPENNMS_HOME/lib

Configuring the Jira Ticketer

• Edit the $OPENNMS_HOME/etc/opennms.properties file and change this:

opennms.ticketer.plugin=org.opennms.netmgt.ticketd.NullTicketerPlugin

to this:

opennms.ticketer.plugin=org.opennms.netmgt.ticketer.jira.JiraTicketerPlugin

• (Default: Jetty) Edit the $OPENNMS_HOME/jetty-webapps/opennms/WEB_INF/configuration.properties OR
• (Tomcat) Edit the $OPENNMS_HOME/webapps/opennms/WEB_INF/configuration.properties file and change this:

#opennms.alarmTroubleTicketEnabled = false
#opennms.alarmTroubleTicketLinkTemplate = <a href="http://localhost:8080/centric/TroubleTickets.do?command=Details&id=${id}">${id}</a>

to this:

opennms.alarmTroubleTicketEnabled = true
opennms.alarmTroubleTicketLinkTemplate = <a href="https://myjirahost/browse/${id}">${id}</a>

• Edit the $OPENNMS_HOME/etc/jira.properties file and provide this

jira.host=http://myjirahost/
jira.username=username
jira.password=password
jira.project=project
jira.type=1

Restart OpenNMS and the Webapp

Version History/Availability

• This feature was added in version 1.3.7