Migration task roadmap

This section describes migration tasks at a high level. It also includes a table describing the Adapter Framework 2.6 environments you can migrate to. The table provides links and references to step-by-step procedures.

Before you begin, Is there a 2.6 framework version of the adapter you wish to migrate? If so, install it and skip the migration procedure. Here are the WebSphere Business Integration adapters released with the 2.6 framework:

If the adapter you want to migrate is on this list, install it after you install the 2.6 framework. For further information, including directions on installation sequence, see the Installing WebSphere Business Integration Adapters, V.2.6 guide.

Note:
If the adapter framework version of the adapter you want to migrate is 2.3.x, you must first upgrade the adapter to the latest version released with framework 2.4.x. Then you can migrate the adapter to the 2.6 framework.

The high-level tasks involved in migrating adapters from previous releases to Adapter Framework 2.6 are as follows:

  1. Identify adapters you want to migrate Note the version of each adapter, and the version of the adapter framework. You may need both versions to determine whether you have the latest release of the adapter running on the 2.4.x framework.
    For example, Adapter for HTTP 1.1 is the latest version of the adapter running on Adapter Framework 2.4.x.


    To determine the adapter and Adapter Framework versions, you can do either of the following:

  2. Install Adapter Framework 2.6 See the Installing WebSphere Business Integration Adapters, V.2.6 guide for specific procedures that reflect your environment requirements. After installing, note the following:
  3. Migrate adapters Follow the links in Table 1 to see if and how you can migrate adapters to the new framework. Migrating adapters involves swapping modified adapter and ODA start scripts. These scripts are supplied in adapter-specific TechNotes. For further information, see Upgrading pre-2.4 adapters.

Table 1 describes the migration procedures that apply to a variety of WebSphere Business Integration environments. Each row of the table ends with pointers to step-by-step instructions for completing the procedure.

Note:
For a summary of installation requirements and for step-by-step installation instructions for the adapter framework, see Installing WebSphere Business Integration Adapters, V.2.6.


Table 1. Migrating adapters to WebSphere Business Integration Adapter Framework 2.6 task roadmap

Existing WebSphere Business Integration adapter environment Associated migration procedure(s) For more information (see...)
New installation: no WebSphere Business Integration Adapter Framework or adapter artifacts No migration required See the Installing WebSphere Business Integration Adapters, V.2.6 guide
Adapter Framework 2.4.x and InterChange Server 4.3 1. Install Adapter Framework 2.6 on a separate machine or uninstall earlier adapter framework; then install Adapter Framework 2.6 and most recent available version of adapters.
2. Migrate adapters.
1. See the Installing WebSphere Business Integration Adapters, V.2.6 guide
2. See Migrating adapters to Adapter Framework 2.6.
Adapter Framework 2.4.x and InterChange Server 4.2.2 1. Install Adapter Framework 2.6 on a separate machine or uninstall earlier adapter framework; then install Adapter Framework 2.6 and most recent available version of adapters.
Note: If you are running Adapter Framework 2.6 with InterChange Server 4.2.2, certain InterChange Server 4.3 features in Adapter Framework 2.6 are unavailable.
2. Migrate adapters.
1. See the Installing WebSphere Business Integration Adapters, V.2.6 guide
2. See Migrating adapters to Adapter Framework 2.6.
Adapter Framework 2.4.x with WBI MB or WAS 1. Install Adapter Framework 2.6 on a separate machine or uninstall earlier adapter framework; then install Adapter Framework 2.6 and most recent available version of adapters.
2. Migrate adapters.
1. See the Installing WebSphere Business Integration Adapters, V.2.6 guide
2. See Migrating adapters to Adapter Framework 2.6.
Adapter Framework 2.3.x or earlier 1. Uninstall earlier adapter framework; then install Adapter Framework 2.6 and most recent available version of adapter(s).
2. Migrate adapters as needed (if most recent adapter version runs with Adapter Framework 2.4.x, you must migrate).
1. See Installation Guide for WebSphere Business Integration Adapters and Upgrading pre-2.4 adapters.
2. See Migrating adapters to Adapter Framework 2.6.

Copyright IBM Corp. 1997, 2004