• Products
  • Get started
  • Documentation
  • Resources

Integrate with XMPP/Jabber

If you’re a customer who shifted your operations from Opsgenie to Jira Service Management, adding new instances of this integration isn’t possible in Jira Service Management. You can only edit the integrations that originally shifted from Opsgenie.

XMPP logo

What does Jira Service Management offer XMPP/Jabber users?

The Jira Service Management XMPP/Jabber integration plugin utilizes full capabilities of Jira Service Management and provides chat integration with XMPP/Jabber. The integration leverages Jira Service Management's xmpp-specific executable and OEC utility so that Jira Service Management alerts and alert actions go into XMPP/Jabber rooms.

Functionality of the integration

  • When an alert is created in Jira Service Management, information saying that an alert is created in Jira Service Management goes into your XMPP/Jabber room.

  • When users acknowledge an alert from their mobile devices using the Jira Service Management app, this info is sent to XMPP/Jabber rooms.

  • When users add comments to alerts in Jira Service Management, add note info is sent as well.

OEC subscribes to alert actions in Jira Service Management and reflects these actions on your XMPP/Jabber rooms so that you will be notified for Jira Service Management alerts.

Edit the XMPP/Jabber integration in Jira Service Management

To edit the XMPP/Jabber integration in Jira Service Management, complete the following steps:

  1. Go to your team’s operations page.

  2. On the left navigation panel, select Integrations.

  3. Search for your XMPP/Jabber integration.

  4. Edit the integration settings and rules as necessary.


The instructions in the following sections aren’t being updated regularly. If you have any questions, contact us.

Installation

The steps below describe how to integrate Jira Service Management and XMPP/Jabber using Jira Service Management XMPP/Jabber integration plugin. Note that slight alteration to these instructions may be necessary depending on the exact Linux distribution being used and XMPP/Jabber configuration.

Prerequisites

Packages provided support the following systems:

  • Red Hat based Linux distributions

  • Debian based Linux distributions

  • Windows

Download XMPP/Jabber Plugin

Download the latest version of OEC

To download the latest version of XMPP/Jabber package, please use readme file of oec-scripts repository.

For Red Hat Based Distributions

  • Run the following command : rpm -i opsgenie-xmpp-<your_version>.rpm

During upgrades, rpm package does not overwrite your existing configurations. It saves the new default configuration file as opsgenie-integration.conf.rpmnew. Find more information about rpm upgrade config file handling from here.

To update from version 201X-XX-XX to 2.X.X, add --force parameter.

For example: 

rpm -U --force opsgenie-integration-<your_version>.rpm

We suggest backing up configuration files before updating!

If while installing the rpm package you get an error saying that the package is obsoleted, you need to use "rpm -i opsgenie-xmpp-<your_version>.rpm --nodeps" instead.

If you get "is already installed" error, use "rpm -i opsgenie-xmpp-<your_version>.rpm --force" instead.

For Debian Based Distributions

  • Run the following command : dpkg -i opsgenie-xmpp-<your_version>.deb

For Windows

  1. Unzip Opsgenie integration zip file

  2. Install OEC by following steps in OEC installation page

Add XMPP/Jabber integration in Jira Service Management

This integration is only available with Standard and Enterprise plans in Opsgenie, and Premium and Enterprise plans in Jira Service Management.

Adding the integration from your team dashboard will make your team the owner of the integration. This means Opsgenie will assign the alerts received through this integration to your team only. Follow the rest of the steps in this section to set up the integration.

  1. Go to Settings > Integrations. Search for XMPP/Jabber and select Add.

  2. Copy the API Key.

  3. Select Save Integration.

Configure Opsgenie to XMPP/Jabber Integration

Use Opsgenie’s OEC and the XMPP script to send alert actions to XMPP/Jabber rooms. This enables deployment of your own scripts/ability to modify the ones provided and execute customized actions on XMPP.

To use the XMPP integration package, follow the steps in the sections below through the end.

The package that you downloaded also includes OEC utility and the script that is need to be run by OEC.

To be able to execute actions in XMPP, OEC gets the configuration parameters from the configuration file. The configuration file can be found under /home/opsgenie/oec/conf/config.json

In order to use this feature "Send Alert Actions To XMPP" checkbox should be enabled in Opsgenie XMPP/Jabber Integration.

Configuration Parameters

 

Location

apiKey

XMPP/Jabber integration API Key. Copy the API Key from XMPP/Jabber Integration page and paste it to apiKey field in conf file.

/home/opsgenie/oec/conf/config.json

hostUrl

Service name for the XMPP/Jabber server you are using. This hostUrl is used to create a connection with your XMPP/Jabber server.

/home/opsgenie/oec/conf/config.json

username

Username used during login to the XMPP/Jabber server.

/home/opsgenie/oec/conf/config.json

password

Password that used during login to the XMPP/Jabber server.

/home/opsgenie/oec/conf/config.json

room

Room name which alert actions are sent right into.

/home/opsgenie/oec/conf/config.json



Still need help?

The Atlassian Community is here for you.