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.
  1. Do the following in a development environment:
    1. Back up the integration broker system to preserve it.
    2. Open the definition for the version of the adapter that is currently in use in Connector Configurator.

      Record all configuration information about the adapter.

    3. 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.

    4. 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
    5. Upgrade any prerequisite software to the required version.

      For more information on software requirements, see Software requirements.

    6. 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.
    7. If your integration broker is InterChange Server, rename the directory of the currently-installed adapter to preserve it.
    8. Install the new version of the adapter as described in Installing adapters.
    9. Import the definition for the WebSphere Business Integration Adapters 2.6 version of the adapter into the integration broker environment.
    10. 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.
    11. Configure the adapter definition imported in step 1i with the information recorded in step 1b and any new properties discovered in step 1j.
    12. Install each data handler required for the environment as described in Installing data handlers.
    13. 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.
    14. Perform regression testing to ensure that the upgraded adapter still meets the business requirements of the implementation.
  2. 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.
  3. Perform step 1 to upgrade the adapter in the production environment.

Copyright IBM Corp. 1997, 2004