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 that
follow.
Before you begin, install Adapter Framework 2.6 and configure your
WebSphere environment with one of the following integration brokers:
- InterChange Server 4.2.2
- InterChange Server 4.3
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 framework, perform the following steps:
- 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.
- 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.
Figure 3. Selecting 2.4 framework documentation

- Under Download documentation, Quick Start Installation
Kit click the installer language as shown in Figure 4.
Figure 4. Downloading documentation

This downloads the installation guide and release notes for the
2.4.x framework. The file is named
wbia24install.zip.
- Save the zip file, and then extract its contents.
- Open the installation_wbia.pdf file and then open the release notes
for your platform. Use the installation guide to help guide you through
the installation of the adapter into your environment.
- To obtain the 2.4.x framework version user guide for the
adapter, follow the directions on the page shown in Figure 2 to do the following:
- Download the documentation viewer (prerequisite)
- Download the documentation
- 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.
- 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.
- Obtain the 2.4.x (framework) version of the adapter in
either of the following ways:
- If you are using
Passport Advantage, do the following to prepare for installation:
- On Windows, download the self-extracting executable file from Passport
Advantage and then double-click it to extract the installation files.
- On UNIX, download the compressed .tar file from Passport Advantage
and then inflate it to extract the installation files.
- Note:
- For information on obtaining Passport Advantage software, ask your IBM
representative.
- See your IBM representative about obtaining a media pack that contains the
adapter you need.
- Launch the 2.4.x framework Adapters Installer for the
adapter.
- Install the adapter, using the 2.4.x installation guide you
downloaded as needed.
- Migrate the adapter to Adapter Framework 2.6. See Migrating adapters to Adapter Framework 2.6.
- Note:
- You configure the installed 2.4.x version adapter to run with
Adapter Framework 2.6. You perform this configuration by
migrating the adapter to the 2.6 framework.
