Installing IBM webMethods Adapter for Remedy

Overview

This chapter explains how to install, upgrade, and uninstall IBM webMethods Adapter for Remedy 7.1. The instructions use the IBM webMethods Installer and the IBM webMethods Uninstaller wizards. For complete information about the wizards or other installation methods, or to install other webMethods products, see the Installing IBM webMethods Products On Premises for your release.

Requirements

For a list of the operating systems, AR System products, and webMethods products supported by Adapter for Remedy 7.1, see the IBM webMethods Adapters System Requirements.

Adapter for Remedy 7.1 has no hardware requirements beyond those of its host Integration Server.

Installing the Adapter

About this task

If you are using Adapter for Remedy 6.0, see Upgrading from Adapter for Remedy 6.0.

Note: If you are installing the adapter in a clustered environment, you must install it on each Integration Server in the cluster, and each installation must be identical. For more information about working with the adapter in a clustered environment, see Adapter Package Management.

To install Adapter for Remedy 7.1 :

Procedure

  1. If you are installing the adapter on an existing Integration Server, shut down the Integration Server.
  2. Download IBM webMethods Installer .
  3. Start the Installer wizard.
  4. Choose the webMethods release that includes the Integration Server on which to install the adapter. For example, if you want to install the adapter on Integration Server 8.0, choose the 8.x release.
  5. Specify the installation directory as follows:
    • If you are installing on an existing Integration Server, specify the IBM installation directory that contains the host Integration Server.
    • If you are installing both the host Integration Server and the adapter, specify the installation directory to use.

      The Installer will install the adapter in the Integration Server_directory\packages directory.

  6. In the product selection list, select Adapters > webMethods Remedy Adapter 7.1 . You can also choose to install documentation.
  7. After installation is complete, deploy the AR System library files on the host Integration Server as follows:
    Note: Deploy the library files for the operating system on which Integration Server is installed; for example, if the Integration Server is installed on a Solaris system, deploy the library files for Solaris.
    • Copy the relevant AR System jar files to the Integration Server_directory\packages\WmRemedyAdapter\code\jars directory. For a list of the AR System jar files for each AR System version and the exact source location of the jar files, see the IBM webMethods Adapters System Requirements.
    • For AR System 7.1 along with the relevant AR System jar files (see the previous bullet), copy the required native libraries to the Integration Server_directory\lib directory. For information about the native libraries, see the Remedy AR System API Reference Guide for AR System 7.1.

      For more information about the Java API requirements and C API package contents of the BMC Remedy AR System 7.1 or later, see the respective Remedy AR System API Reference Guide for each version.

  8. Start the host Integration Server.

Upgrading from Adapter for Remedy 6.0

About this task

Adapter for Remedy 7.1 is compatible with Adapter for Remedy 6.0. You can use Adapter for Remedy 7.1 to run or edit the services generated using Adapter for Remedy 6.0.

Upgrading from Adapter for Remedy 6.0

About this task

Important: Before running the Adapter for Remedy migrate_60_To_71 service, you must enable the adapter connection associated with the service in the target package.

To upgrade from Adapter for Remedy 6.0 to Adapter for Remedy 7.1

Procedure

  1. Back up your existing Adapter for Remedy 6.0 installation and all custom packages.
  2. Uninstall Adapter for Remedy 6.0 as described in IBM webMethods Adapter for Remedy Installation Guide 6.0.
  3. Delete the dlls and the lib files of Adapter for Remedy 6.0. Uninstalling the adapter does not delete those files.
  4. Install Adapter for Remedy 7.1 as described in Installing the Adapter.
  5. To migrate services created with version 6.0 of Adapter for Remedy to version 7.1:
    1. Enable the adapter connections associated with the target package.
    2. Run the wm.adapter.wmremedy.util:migrate_60_To_71 service located in the WmRemedyAdapter package. For information about the service, see wm.adapter.wmremedy.util:migrate_60_To_71.

      You can run this service using either Designer. After running the migrate_60_To_71 service, the templates of the adapter services created with Adapter for Remedy 6.0 will be updated to the Adapter for Remedy 7.1 templates.

Uninstalling the Adapter

About this task

To uninstall Adapter for Remedy 7.1

Procedure

  1. Shut down the host Integration Server. You do not need to shut down any other webMethods products or applications that are running on your machine.
  2. Start IBM webMethods Uninstaller, selecting the IBM installation directory that contains the host Integration Server. In the product selection list, select Adapters > webMethods Remedy Adapter 7.1 . You can also choose to uninstall documentation.
  3. Restart the host Integration Server.
  4. Uninstaller removes all Adapter for Remedy 7.1-related files that were installed. However, Uninstaller does not delete files created after you installed the adapter (for example, user-created or configuration files), nor does it delete the adapter directory structure. You can go to the Integration Server_directory\packages directory and delete the WmRemedyAdapter directory.