Upgrading a WebSphere Business Information adapter
This section describes how to upgrade an adapter that
is released as part of the WebSphere Business Integration Adapters
product set.
Note:
To migrate adapters to Adapter Framework, Version
2.6, see the document Migrating Adapters to Adapter Framework, Version 2.6.
The migration procedures described in that document are germane
if you have applied Adapter Framework Fix Pack 2.6.0.3.
-
Do the following in a development environment:
- Back up the integration broker system to preserve it.
-
Open the definition for the version of the
adapter that is currently in use in Connector Configurator.
Record all configuration information about the adapter.
- Upgrade the hardware of the computer on which you are upgrading the adapter as necessary to meet the WebSphere Business Integration Adapters 2.6.0.3 requirements.
For more information about hardware requirements, see Hardware and software requirements.
- If you were running Adapter Framework 2.3.1, uninstall the Visibroker
Object Request Broker. The IBM Java Object Request Broker replaced
the VisiBroker Object Request Broker in WebSphere Business Integration
Adapters Version 2.4 through 2.6
- Upgrade any prerequisite software to the required version.
For more information on software requirements, see Hardware and software requirements..
- If your integration broker is one of the supported message brokers
or WebSphere Application Server, install the Adapter Framework as
described in Installing
the adapter framework into a
directory other than the one where the adapter framework is currently
installed.
Note:
If your integration broker is WebSphere InterChange
Server and you are installing WebSphere Business Integration Adapters
on the same computer on which InterChange Server is installed, you must install the adapter framework in a separate directory. The adapter framework is not installed with WebSphere InterChange Server.
- If your integration broker is InterChange Server, rename the
directory of the currently-installed adapter to preserve it.
- Install the new version of the adapter as described in Installing
adapters.
-
Import the definition for the WebSphere
Business Integration Adapters 2.6 version of the adapter
into the integration broker environment.
-
Read the chapter named "Installing
and configuring the connector" in the guide for the adapter
you are upgrading and determine any new properties that must be
configured.
- Configure the adapter definition imported in step 1i with the information recorded in step 1b and any new properties discovered in step 1j.
- Install each data handler required for the environment as described
in Installing
data handlers.
- Perform any adapter-specific installation steps, such as installing
the application client on the adapter host computer, as described
in the guide for each adapter required in the environment.
- Perform regression testing to ensure that the upgraded adapter
still meets the business requirements of the implementation.
- Perform step 1 to
upgrade the adapter in a stress-testing environment and then perform
regression testing to ensure that the upgraded adapter still meets
the performance requirements of the implementation.
- Perform step 1 to
upgrade the adapter in the production environment.
