HP Operations Manager Smart Plug-In for Remedy Action Request System

For the Windows operating system

Release Notes

Software version: 4.06 / August, 2013

This document provides an overview of the changes made to the HP Operations Manager Smart Plug-In for Remedy Action Request System (Remedy SPI) for the 4.06 patch release. It contains important information not included in the manuals or in online help.

In This Version
Documentation Updates
Installation Notes
Enhancements and Fixes
Known Problems, Limitations, and Workarounds
Documentation Errata
Support
Legal Notices

In This Version

New in version 4.06

Documentation Updates

The first page of this release notes document contains the following identifying information:

To check for recent updates or to verify that you are using the most recent edition, visit the following URL:

http://support.openview.hp.com/selfsolve/manuals/

1.    In the Product list, click the product name.

2.    In the Version list, click the version number.

3.    In the OS list, click the OS type.

4.    In the document list, click the document title.

5.    To retrieve the document, click Open or Download.

NOTE: To view files in PDF format (*.pdf), Adobe Acrobat Reader must be installed on your system. To download Adobe Acrobat Reader, go to the following URL:

http://www.adobe.com/

Installation Notes

Software and Hardware Requirements

The Software and Hardware Requirements are listed in Administrator’s Reference guide for the Remedy SPI. The document file is included on the product's CD media as SPI-DVD for HPOM\Documentation\SPI Guides\Remedy_Config.pdf.

General Installation Notes

The Remedy SPI server needs the dynamic link libraries (DLLs) from the Action Request System server to run. These have to be copied to the HPOM management server before the Remedy SPI server can be started.  After the Remedy SPI has been installed, the Remedy SPI service is not started automatically. This is because the SPI configuration files have to be created and propagated accordingly and the ARS libraries have to be copied in place first.

If, after installing the SPI, the HPOM management server is rebooted before these steps have been completed, an error window is shown after the reboot, stating the inability of the service manager to locate the ARS libraries (because the Remedy SPI service is configured to start automatically on reboot). This error can be ignored until the SPI has been configured and the ARS libraries have been copied.

Upgrading from versions 4.00/4.03 to 4.06

Installing the patch that is appropriate for your HPOM management server performs the upgrade from Remedy SPI version 4.00/4.03 to 4.06. Stop the Remedy SPI on the HPOM management server, and then perform the patch installation according to the instructions that are contained in the patch documentation. The installation of the patch does not start the Remedy SPI server again; this has to be done manually.

Use the patch

·       REMSPIOMW8_00001 for HPOM 8

·       REMSPIOMW9_00001 for HPOM 9

Upgrading from versions older than 4.00/4.03 to 4.06

Remedy SPI versions older than 4.00/4.03 cannot be upgraded directly to 4.06. Instead, an upgrade to version 4.00 (HPOM 8) resp. 4.03 (HPOM 9) has to be performed first, and then this version may be upgraded to 4.06.

Upgrading from versions older than 4.00/4.03 to 4.00/4.03

If the Remedy SPI is to be upgraded from a prior version, then the following steps should be performed:

If, for any reason, the upgrade has not been performed in this sequence, but the new version was installed while the previous version was still in place, then the following should be noted:

There is no policy group called  “Auto-Deploy” located under these groups as with the previous version. Thus, the old policy groups called  “Auto-Deploy” should now be removed. This applies only if you upgrade from a version older than 02.90.

Installing version 4.00/4.03

The steps needed to install the Remedy SPI are contained in this section. For a detailed discussion of the configuration, please see the Administrator’s Reference guide for the Remedy SPI. The document file is included on the product's CD media as SPI-DVD for HPOM\Documentation\SPI Guides\Remedy_Config.pdf.

1.    Install the new version of the Remedy SPI using the full installation media (HP Operations Manager Smart Plug-Ins DVD: 2009 for 4.00 (HPOM 8), 2010.3 for 4.03 (HPOM 9)).

2.    Copy the following Action Request System server libraries into the directory %OvInstallDir%\bin\REMSPI. The ARS server libraries may be found on your original Action Request System Install CDs.

§  arapi71.dll

§  arrpc71.dll

§  arutl71.dll

3.    Create and update the Remedy SPI configuration file %OvShareDir%\conf\REMSPI\remspi.cfg according to the detailed description in the Administrator’s Reference guide for the Remedy SPI. You may use the file remspi.cfg.new in this directory as a starting point.

4.    Create and update the Remedy SPI configuration file %OvShareDir%\conf\REMSPI\rules according to the detailed description in the Administrator’s Reference guide for the Remedy SPI. You may use the file rules.PR in this directory as a starting point.

5.    Deploy the REMSPI and the SHS Data Collector instrumentation to the managed nodes that will be put in to the SPI for Remedy ARS node groups in the HPOM console in the next step. For Windows nodes, add the Microsoft Windows instrumentation.

6.    Copy the ARS server and the HPOM management server icons into the appropriate node group in the HPOM console.

7.    Configure the ARS form and ARS filters on the ARS server according to the instructions in Administrator’s Reference guide for the Remedy SPI to enable the communication from ARS to HPOM.

8.    Start the Remedy SPI service using the HPOM tool Remedy SPI Admin \ Start SPI Server or use the command net start “HP OV SPI for Remedy service” in a command window on the HPOM management server.

Enhancements and Fixes

  • QCCR1A108657

Remedy SPI log files need to be self-maintained

  • QCCR1A108659

Utilize Remedy Plugin instead of a run-process itoupdate to update messages in OMU

  • QCCR1A109244

Enhancement Request for ownership in Remedy SPI

  • QCCR1A125158

remspisrv aborts on unexpected input

  • QCCR1A126644

$NODE_IP$ shows the IP addresses in reverse

  • QCCR1A150701
  • QCCR1A131338

OML Remedy SPI support Remedy v8, Remedy SPI needs to Support ARS 7.7

  • QCCR1A148624

remspisrv should check for supported AR field types upfront and not during operation

  • QCCR1A133361

Use of an Administrator account different than opc_adm

  • QCCR1A128419

Remedy SPI can't start when OMU server has PAM enabled

  • QCCR1A116791

Customer requests to dynamically change the Remedy spi ARS user

  • QCCR1A144367

Implement ATTACH_TO_EXISTING keyword

  • QCCR1A152796

Add info for Load Balancer configuration

  • QCCR1A151412

Setting CMA sometimes fails: 'Access denied' - Update documentation

  • QCCR1A145681

Wrong doc for defining actions to different targets

  • QCCR1A130555

Incomplete mapping of MCE codes to text

  • QCCR1A130553

remspisrv aborts in submit while searching conditions

  • QCCR1A128520

Remedy SPI can't resolve ARS hostname anymore

  • QCCR1A150514

Wrong keyword ARRPCPORT in comment of rules file

  • QCCR1A128418

Remote DB with Oracle client 11.2: Cannot connect to database – Add info to RemSPI documentation

Known Problems, Limitations, and Workarounds

Tools

 

PROBLEM:

The tool remspi_qutil does not lock the SPI queues. If executed while the SPI server is running this may lead to inconsistencies in the queue files.

 

SOLUTION:

Use this tool only if the SPI server is not running. If you experience problems due to inconsistencies in the queues, stop the server, delete all files in the queue directories (%OvDataDir%\tmp\remspi\queue.*)and restart the server.

 

 

 

Configuration

 

PROBLEM:

Do not use multiple ON_SUBMIT sections for a TARGET in the rules file. Although syntactically correct, the SPI will only use the statements found in the last ON_SUBMIT section of the TARGET.

 

SOLUTION:

It’s always possible to define all needed ON_SUBMIT statements in one section per TARGET in the rules file. All ON_SUBMIT statements will be executed in a predefined sequence which is not related to the appearance of the statements in the rules file.

 

 

 

Operation

 

PROBLEM:

Internal SPI messages (i.e. Application = "Remedy SPI") are not submitted either automatically or manually nor is the SPI server informed about their update.

 

SOLUTION:

This is not an error of the SPI, but intended behavior to prevent loops.

 

 

 

Installation / Activation

 

PROBLEM:

If the managed nodes (HPOM server, AR server) are assigned to the Remedy SPI node groups before the instrumentation is deployed, error messages regarding scripts and executables which are not found may appear.

 

SOLUTION:

Deploy the instrumentation for Microsoft Windows and REMSPI before you assign the managed nodes to the Remedy SPI node groups.

 

 

 

 

PROBLEM:

If the AR server does not run or if the SPI configurations file rules contains errors or is not updated at all, the Remedy SPI service “HP OV SPI for Remedy service” will not start.

 

SOLUTION:

Make sure the SPI configurations file rules is properly edited and the AR servers specified in this file are up and running when you start the Remedy SPI service.

 

 

 

 

PROBLEM:

If the Remedy SPI server does not start and aborts with the error message “arapi71.dll not found”, then the AR API libraries need to be copied to a directory in the %PATH% of the SPI server on the HPOM management server.

 

SOLUTION:

Copy the AR API libraries to the directory %OvInstallDir%\bin\remspi on the HPOM management server.

The files which need to be copied are:

  • arapi71.dll
  • arrpc71.dll
  • arutl71.dll

 

 

Note that the version numbers in the file names do not indicate that the Remedy SPI is able to connect only to AR 7.1.

 

 

PROBLEM:

If the Remedy SPI service “HP OV SPI for Remedy service” does not start, look at the error log file that is written for each start and stop of the Remedy SPI service. In addition, look at the log file of the Remedy SPI server.

 

SOLUTION:

The Remedy SPI service creates its own log directory. This directory is %OvDataDir%\log\remspi. The log file is then remspi_service.log

The log file for the Remedy SPI server is %OvDataDir%\log\remspi\remspi.log.

 

 

 

 

PROBLEM:

If the Remedy SPI service “HP OV SPI for Remedy service” is not created during installation of the SPI; or is not deleted during removal of the SPI, look at the error log file that is written for each of these actions.

 

SOLUTION:

The Remedy SPI service installation tool creates an its log directory. This directory is %OvDataDir%\log\remspi. The log file is then remspi_sc.log.

If there should be any need to install or remove the Remedy SPI manually, the Remedy SPI service installation tool has to be called with a full pathname.

To install the Remedy SPI service, use
%OvInstallDir%\bin\remspi\remspi_sc –i %OvDataDir%\log\remspi.

To remove the Remedy SPI service, use
%OvInstallDir%\bin\remspi\remspi_sc –d %OvDataDir%\log\remspi.

 

 

 

 

PROBLEM:

If it’s not possible to modify an HPOM message as a result of a modified AR ticket or in an ON_xxx statement, it may be that the user account with which the Remedy SPI service is started does not have sufficient rights or there is no password configured for the admin user in remspi.cfg.

 

SOLUTION:

The user account with which the Remedy SPI service is started (look at the Windows service control panel) should then be changed to a user account with sufficient rights to access the HPOM messages.

In addition, make sure that a password is configured for the admin user in file remspi.cfg (keyword is REMSPI_ITO_ADMIN_PASSWD). The value of the password is meaningless; it just needs to be specified. Use the tool remspipasswd to encrypt an arbitrary value and use it in remspi.cfg.

 

 

 

 

PROBLEM:

If the SPI is removed from the HPOM management server, the configuration directory %OvShareDir%\conf\remspi is completely removed, too.

 

SOLUTION:

The configuration files rules and remspi.cfg should be copied to a safe place when they are needed at a later time prior to removal of the SPI.

 

 

 

Documentation Errata

None.

Support

Please visit the HP support web site at:

http://support.openview.hp.com/

This web site provides contact information and details about the products, services, and support that HP offers.

HP online software support provides customer self-solve capabilities. It provides a fast and efficient way to access interactive technical support tools needed to manage your business. As a valued support customer, you can benefit by being able to:

§  Search for knowledge documents of interest

§  Submit and track progress on support cases

§  Submit enhancement requests online

§  Download software patches

§  Manage a support contract

§  Look up HP support contacts

§  Review information about available services

§  Enter discussions with other software customers

§  Research and register for software training

NOTE: Most of the support areas require that you register as an HP Passport user and sign in. Many also require an active support contract. To find more information about support access levels, go to the following URL:

http://support.openview.hp.com/access_level.jsp

To register for an HP Passport ID, go to the following URL:

https://ovrd.external.hp.com/rd/register;jsessionid=C98D8B79ACC32E8714D436513D14C35D?target=HTTPS%3a%2f%2fovrd.external.hp.com%2fhpp%2fhpp2rd%3fdest_url=http%3a%2f%2fsupport.openview.hp.com%2f%26hpappid=ovrd

Legal Notices

©Copyright 2013  Hewlett-Packard Development Company, L.P.

Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.

The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.

For information about third-party license agreements, see the spi-thirdparty-license-agreements directory in the product installation directory.

The information contained herein is subject to change without notice.