Installing and Uninstalling the Adapter

Overview

This chapter explains how to install, upgrade, and uninstall Adapter for AS/400. The instructions use the Installer and the 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, AS/400 products, and webMethods products supported by the adapter, see the IBM webMethods Adapters System Requirements.

Adapter for AS/400 has no hardware requirements beyond those of its host Integration Server.

The Integration Server Home Directory

Beginning with Integration Server 9.6, you can create and run multiple Integration Server instances under a single installation directory. Each Integration Server instance has a home directory under Integration Server_directory\instances\instance_name that contains the packages, configuration files, log files, and updates for the instance.

For more information about running multiple Integration Server instances, see the IBM webMethods Integration Server Administrator’s Guide for your release.

If you are using Integration Server 9.5 and lower, the Integration Server home directory is Integration Server_directory. For example, on Integration Server 9.5 the adapter package is installed in the Integration Server_directory\packages directory.

This guide uses the packages_directory as the home directory in Integration Server classpaths. For Integration Server 9.6 and above, the packages_directory is Integration Server_directory\instances\instance_name\packages directory. For Integration Server 9.5 and lower, the packages_directory is Integration Server_directory\packages directory.

Installing the adapter

About this task

Important: IBM webMethods Adapter for AS/400 is not supported in a clustered Integration Server environment.

To install the adapter:

Procedure

  1. Download Installer.
  2. If you are installing the adapter on an existing Integration Server, shut down the Integration Server.
  3. Start the Installer wizard.
  4. Choose the webMethods release that includes the Integration Server on which to install the adapter.
  5. Specify the installation directory as follows:
    • If you are installing on an existing Integration Server, specify the webMethods 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.
  6. In the product selection list, select Adapters > webMethods Adapter 6.0 SP1 for AS 400.

    If you are using Integration Server 9.6 and above, you can choose to install the package in the default instance. In this case, Installer installs the adapter in both locations, Integration Server_directory\packages and the default instance packages directory located in Integration Server_directory\instances\instance_name\packages.

  7. After installation is complete, close Installer.

    Integration Server loads the WmAS400 package, but it will not be enabled until you deploy the IBM ToolBox for Java files on Integration Server.

  8. To deploy the IBM ToolBox for Java files:
    1. Go to the IBM ToolBox for Java installation directory.
    2. Copy the jt400.jar and util400.jar files to the Integration Server_directory\instances\instance_name\packages\WmAS400\code\jars directory.
  9. Start the host Integration Server.
    Note: IBM recommends that you install the latest fix to include updates from previous fixes for this adapter

Uninstalling the Adapter

About this task

To uninstall IBM webMethods Adapter for AS/400:

Procedure

  1. Shut down the Integration Server that hosts the Adapter for AS/400.
  2. Start Uninstaller, selecting the webMethods installation directory that contains the host Integration Server. In the product selection list, select Adapters > webMethods Adapter 6.0 SP1 for AS 400.
  3. Restart the host Integration Server.
  4. Uninstaller removes all Adapter for AS/400 6.0.1 related files that were installed into the Integration Server_directory\packages\WmAS400 directory. 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 WmAS400 directory.