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.
- 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 requirements.
For more information about hardware requirements, see Hardware 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 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.
