Overview of migrating adapters to an InterChange Server environment

When you install Adapter Framework 2.6 in a WebSphere environment with an InterChange Server 4.3 or InterChange Server 4.2.2 integration broker, you can migrate adapters released with framework 2.4 to the new framework.

Note:
If you want to migrate adapters released with a 2.3.x adapter framework, see Upgrading pre-2.4 adapters.

Steps for migrating adapters to an InterChange Server environment

This section describes tasks you must complete when you are migrating adapters to Adapter Framework 2.6 configured with an ICS 4.3 or 4.2.2 integration broker. You can migrate adapters released with the 2.4 framework only.

Before you begin If you have not already done so, install the latest version of the 2.4.x framework adapter that you want to migrate. For further information, see Upgrading pre-2.4 adapters.

  1. Backup all existing files for the adapter you want to migrate.
  2. Copy the adapter configuration template file or files to the ICS directory structure containing Connector Configurator:
    1. Locate the connector configuration template file (<adapter_name> ConnectorTemplate) in the directory of the adapter you want to migrate. This file contains the template for the connector definition and is used by Connector Configurator. If necessary, consult the "Installed file structure" section in the adapter guide to locate this file.
    2. Copy the <adapter_name>ConnectorTemplate to the ICS directory where Connector Configurator resides. The default location is as follows:
      • InterChange Server 4.3 ProductDir/IBM/WebSphereICS/bin/Data/app
      • InterChange Server 4.2.2 ProductDir/IBM/WebSphereICS/bin/Data/app

    If your ICS broker was installed to a different location, simply search on ConnDesgner.exe -- the Connector Configurator executable. Copy the template file to the Data/app directory in this location.

  3. Update the start script for the adapter and, if applicable, the ODA, so that they can run with Adapter Framework 2.6. Replacement scripts are available for download from TechNotes. For links to TechNotes for adapters, see Linking to TechNotes.
  4. Configure the adapter for use in your WebSphere environment.

Copyright IBM Corp. 1997, 2004