HP BSM Operations Manager i (OMi)

With the xMatters and HP OMi integration, the appropriate technician can be notified directly via voice, email, push notification or pager. Information about the failure is presented to the recipient so decisions can be made in real-time.

Once a response is submitted using the recipient’s device, xMatterswill update the HP OMi event in real-time. The benefit is that this process is immediate – significantly faster than the time required for staff to notice the failures or malfunctions, determine who is on call, and manually notify the right person. In addition, the ability to take simple actions on the event from any device gives the event resolver a quick way to deal with many issues and communicate to other team members the current state of the event.

During the process, every notification, response, and action is logged in xMatters. In addition, xMattersautomatically annotates the original event with status information.

The xMattersproduct features a self-service web user interface to allow accurate assignment of responsible personnel for each job. xMatters also includes a Subscription panel that allows both managed and self-subscription to HP OMi events.

This integration does not support the Bulk Transfer feature in HP OMi; each event must be sent to the Integration Agentseparately. Attempting to use bulk transfer or similar options may result in the Integration Agent receiving only a partial message, and will cause the integration to time out.

The instructions cover the following topics:

Before you begin

Before you get started configuring the integration download the workflow. This integration also requires the Integration Agent.

Download the workflow

The .zip file contains all of the components required by xMatters and HP OMi. Download the workflow .zip file to a location on your local machine, and extract the contents.

You may also notice that there is another .zip file within the extracted integration archive. This is the workflow itself, which contains pre-configured forms, properties, and messages specifically designed for HP OMi. Do NOT extract the contents of the workflow .zip file! You'll be able to import it directly into xMatters.

Configure xMatters

The first step in configuring this integration is to set up the components on the xMatters side:

  • Set up an integration user that HP OMi will use to authenticate with xMatters.
  • Create a web service user for the Integration Agent.
  • Import the workflow.
  • Gather the URLs and IDs you need to complete the configuration in HP OMi and the Integration Agent.

Configure the xMattersIntegration Agent

Now that you've configured xMatters, it's time to configure the Integration Agent. This involves installing and configuring the integration files, setting up the password files, and enabling deduplication to suppress duplicate alerts.

To configure the Integration Agent for the HP OMi integration, you must copy the integration components into the Integration Agent; this process is similar to patching the application, where instead of copying files and folders one by one,you copy the contents of a single folder directly into the Integration Agent folder (<IAHOME>). The folder structure is identical to the existing Integration Agentinstallation, so copying the folder's contents automatically installs the required files to their appropriate locations. Copying these files will not overwrite any existing integrations. If you have more than one Integration Agentproviding the "hpomi-3-0" service, repeat the following steps for each one. If you are not certain of the settings required in this section, consult your HP OMi administrator

The installation instructions below assume you already have a working xMatters Integration Agent If this is a new installation and you have not yet deployed the Integration Agent, download, deploy, and configure the Integration Agent before continuing.

The following instructions use <IAHOME> to refer to the installation folder of the Integration Agenton your system. Change this to the path on your system as needed. If you have already installed an existing integration, ensure that you backup the deduplicator-filter.xml file (if one exists) in the <IAHOME>\conf folder before you install this integration.

Configure HP OMi

To configure HP OMi to integrate with xMatters, you need to:

  • Create a connected server.
  • Create an event forwarding rule

And that's it! Your integration should be ready to go.

How to use the integration

When the integration is configured, HP OMi automatically sends information about any alarms it detects to xMatters via the Integration Agent. Try out triggering and responding to a notification to check that everything is working as you expect.

Trigger a notification

To test the incident notification portion of the integration, create a new alarm in HP OMi that targets a user with a device that you can access (so you can respond to the notification when it arrives). You can use the packaged sendEvent.bat script to inject a test event into HP OMi.

On Windows, this script is located at: C:\HPBSM\opr\support

For information on how to use the sendEvent.bat script, refer to the HP OMi documentation.

Respond to a notification

On a device with the xMatters mobile app, you can respond to the message simply by tapping Respond, and then selecting one of the response choices.

Other devices use similar methods: in an email notification, you would click a link in the message body; for an SMS, you would send an SMS reply containing a response option (or even a single digit).

For a voice notification, you would press a button on your phone to indicate your choice. If the message included a conference bridge request, the message is read aloud via the text-to-speech feature, and you would be prompted to join the conference. For example:

This is a manual conference bridge notification from HP OMi regarding INC0000054.
Message: The SAP system is throwing database errors.
Press 1 to join the conference, press 2 to ignore and stop notifying.

After you respond to the notification, you can see how the integration automatically updates the HP OMi event information with the response details:

Download Resources

Download the workflow