Overview of upgrading adapters in non-InterChange Server environments

When you upgrade adapters from framework 2.3.x to 2.4.x, you must use a 2.4.x framework installer. This and other tasks are described in the sections follow.

Steps for upgrading adapters in non-InterChange Server environments

Before you begin, install Adapter Framework 2.6 and configure your WebSphere environment with one of the following integration brokers:

For further information, see the Installing WebSphere Business Integration Adapters, V.2.6 guide. If you are installing the 2.6 framework to a machine that is currently running a 2.3.x framework, you must first uninstall the older framework.

To upgrade a 2.3.x adapter to the latest version released with the 2.4.x framework, perform the following steps:

  1. In Connector Configurator, open the .cfg definition file for the 2.3.x framework version of the adapter you want to upgrade. Save adapter configuration information to a renamed .cfg file. You may want to compare connector properties and other values with those of the upgraded version of the adapter.
  2. In a browser, go to http://www.ibm.com/software/integration/wbiadapters/library/infocenter/
    Under Other versions, click Version 2.4 -June 2004 Update as shown in Figure 3.
  3. Under
    Download documentation
    Quick Start Installation Kit
    click the installer language as shown in Figure 4.
    This downloads the installation guide and release notes for the 2.4 framework in a file named wbia24install.zip
  4. Save the zip file, and then extract its contents.
  5. Open the installation_wbia.pdf and then open the release notes for your platform. Use the installation guide to help you install the adapter into your environment.
  6. To obtain the 2.4.x framework version user guide for the adapter, follow the directions on the same web page to do the following:

    1. Download the documentation viewer (prerequisite)
    2. Download the documentation
  7. Review the user guide for the adapter, especially the "New in this release" section. Determine whether you need to upgrade or otherwise install prerequisite software for the 2.4.x framework version of the adapter. Obtain and install any prerequisite software as required.
  8. If you included the toolset when installing Adapter Framework 2.6, skip this step. Otherwise, check the following directory for the presence of a CrossWorlds.jar file:


    <adapter framework 2.6 install location>\lib\


    If no CrossWorlds.jar is listed there, create an empty file and save it as CrossWorlds.jar. Copy this file to the adapter framework 2.6 install location>\lib\ directory.

  9. Obtain the 2.4.x (framework) version of the adapter in either of the following ways:
  10. Launch the 2.4.x framework Adapters Installer for the adapter.
  11. Install the adapter, using the 2.4.x installation guide you downloaded as needed. You configure the installed 2.4.x version adapter to run with Adapter Framework 2.6.
  12. Migrate the adapter to Adapter Framework 2.6. See Migrating adapters to Adapter Framework 2.6.

Copyright IBM Corp. 1997, 2004