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.
Before you begin, install Adapter Framework 2.6 and configure your
WebSphere environment with one of the following integration brokers:
- WebSphere MQ Integrator Broker, 2.1 CSD05
-
WebSphere Business Integration Message Broker, 5.0 CSD02
-
WebSphere Application Server, Enterprise Edition, 5.0.2
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:
- 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.
- 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
- Save the zip file, and then extract its contents.
- 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.
- 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:
- 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.
- 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.
- 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 with 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. You configure the installed 2.4.x
version adapter to run with Adapter Framework 2.6.
- Migrate the adapter to Adapter Framework 2.6. See Migrating adapters to Adapter Framework 2.6.
