Upgrading a custom adapter

Do the following to upgrade an adapter that you have developed to use the WebSphere Business Integration Adapters 2.4 adapter framework when your integration broker is one of the supported message brokers or WebSphere Application Server:

  1. Do the following in a development environment:
    1. Back up the integration broker system to preserve it.
    2. Save the definition for the adapter to a file.
    3. Upgrade the hardware of the computer on which you are upgrading the adapter as necessary to meet the WebSphere Business Integration Adapters 2.4 requirements.

      For more information about hardware requirements, see Hardware requirements.

    4. Uninstall the VisiBroker Object Request Broker.

      The IBM Java Object Request Broker has replaced the VisiBroker Object Request Broker in WebSphere Business Integration Adapters 2.4.

    5. Upgrade any prerequisite software to the required version.

      For more information on software requirements, see Software requirements.

    6. 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.
    7. Prepare an upgraded adapter development environment as described in Upgrading an adapter development environment and re-compile the adapter using the WebSphere Business Integration Adapters 2.4 Adapter Framework.
    8. Follow the direction of the adapter developer to install the re-compiled adapter into the framework environment prepared in step 1f. Be sure to modify any path references or other environment-specific information in any scripts used by the adapter.
    9. Modify the adapter scripts in the following ways:
      • Remove any references to vbjapp.jar and vbjorb.jar.
      • Add references to ibmorb.jar in %CROSSWORLDS%\jre\lib\ext.

      These modifications update the adapter script to use the IBM Java Object Request Broker, which replaces the VisiBroker Object Request Broker in WebSphere Business Integration Adapters 2.4.

    10. Import the definition for the adapter into the integration broker environment.
    11. 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