Jira Trouble Ticket Plugin

From OpenNMS
Jump to: navigation, search
⚠
This page is obsolete. Please see Jira Trouble Ticket Plugin instead.

The JIRA trouble ticket plugin in OpenNMS 1.11+ uses the JIRA REST interface instead of the deprecated WSDL-based web service. You must use JIRA version 5.0 or higher for compatibility with the REST-based trouble ticket plugin. This documentation needs to be updated to reflect this change. Please see official documentation for the JIRA Plugin.

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: From opennms-tools/jira-troubleticketer run ../../compile.pl package
  • 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
  • In the same file, 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/rpc/soap/jirasoapservice-v2
jira.username=username
jira.password=password
jira.project=project
jira.type=1

Restart OpenNMS and the Webapp