Installation roadmap

There are a variety of installation scenarios. They depend on the configuration of your environment and the kind and location of the integration broker. The high level installation tasks are as follows:

  1. Determine your WebSphere Business Integration adapter environment:
  2. Install Adapter Framework 2.6, data handlers, adapters, or Adapter Development Kit Follow the links in Table 1 for specific procedures that reflect your configuration and environment requirements.
  3. Migrate adapters Follow the links in Table 1 to see how you can migrate adapters to the new framework. Migrating adapters involves modifying adapter and ODA start scripts. For further information, see the Migrating Adapters to Adapter Framework, Version 2.6 guide.

Table 1 summarizes the installation scenarios that apply to a variety of WebSphere Business Integration environments. Each row of the table ends with a pointer to documentation that contains step-by-step instructions for completing the procedure.


Table 1. Installing WebSphere Business Integration Adapter Framework 2.6: task roadmap

WebSphere Business Integration adapter configuration Associated installation procedure(s) (see...) For more information (see...)
New installation: no WebSphere Business Integration Adapter Framework or adapter artifacts Note: If you install ICS 4.3 as your integration broker, you must install Adapter Framework 2.6 to a separate directory -- the Adapters Installer will prompt you to do so. See Installation process
Adapter Framework 2.4 and ICS 4.3 broker 1. Uninstall Adapter Framework 2.4 or install data handlers, Adapter Framework 2.6, adapters, and optionally ADK on a separate machine.
2. Optionally migrate adapters
1. See Installation process


2.See the Migrating Adapters to Adapter Framework, Version 2.6 guide

Adapter Framework 2.4 and ICS 4.2.2 broker 1. Uninstall Adapter Framework 2.4 or install data handlers, Adapter Framework 2.6, adapters, and optionally ADK to separate machine
Note: If you are running Adapter Framework 2.6 with ICS 4.2.2, certain ICS 4.3 features in Adapter Framework 2.6 are unavailable.
2. Optionally migrate adapters
1. See Installation process


2. See the Migrating Adapters to Adapter Framework, Version 2.6 guide

Adapter Framework 2.4 and WBI MB or WAS broker 1. Uninstall Adapter Framework 2.4 or install data handlers, Adapter Framework 2.6, adapters, and optionally ADK to separate machine
2. Optionally migrate adapters
1. See Installation process


2. See the Migrating Adapters to Adapter Framework, Version 2.6 guide

Adapter Framework 2.3 or earlier 1. Uninstall earlier adapter framework; then install data handlers, Adapter Framework 2.6, adapters, and optionally ADK.
2. Migrate adapters as needed (if most recent adapter version runs with Adapter Framework 2.4, you must migrate)
1. See Installation process and then Upgrading WebSphere Business Integration Adapters.


2. See the Migrating Adapters to Adapter Framework, Version 2.6 guide

Copyright IBM Corp. 1997, 2004