Installation process

This section describes the different kinds of WebSphere Business Integration Adapters environments you might have to prepare and the workflow you have to follow in order to do so.

Figure 1 illustrates the types of WebSphere Business Integration Adapter environments.

Figure 1. WebSphere Business Integration Adapter environments

Local adapter environments

Typically you install an adapter on the same computer where the integration broker is installed and runs. This type of environment is easiest to maintain and manage, particularly when you are developing and testing interfaces, because all the components in the business integration system are installed on a single computer. Environment 1 in Figure 1 illustrates this type of environment.

Do the following to prepare a local adapter environment:

  1. Obtain computers that satisfy the hardware requirements for each of the required environments.

    For more information about hardware requirements, see Hardware and software requirements.

  2. If your integration broker is WebSphere Business Integration Message Broker or WebSphere Application Server, install the WebSphere MQ client as described in the WebSphere MQ documentation. The supported version of the WebSphere MQ client is listed in the techdoc describing hardware and software requirements. For further information, see Hardware and software requirements.
  3. Do one of the following depending on which integration broker you are implementing:
  4. Read the configuration chapterin the guide for each adapter you plan to install in the environment and determine any data handler requirements for the environment.
  5. Install each data handler required for the environment as described in Installing WebSphere Business Integration Adapters, V. 2.6.
  6. Install each adapter required for the environment as described in Installing adapters.
  7. 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.
  8. If you wish to run adapters released with an earlier framework, see the Migrating Adapters to Adapter Framework, Version 2.6 guide.

Distributed adapter environments

Although it is frequently possible to install adapters on the same computer that hosts the integration broker, it is sometimes necessary to distribute the adapters. This means installing the adapters on a different computer than the computer on which the broker is installed.

There are several reasons you might want to distribute connectors agents, including the following:

Environment 2 in Figure 1 illustrates this type of environment, where the adapter is distributed to communicate with a mainframe application.

Do the following to prepare a distributed adapter environment within the enterprise network:

  1. Obtain computers that satisfy the hardware requirements for each of the required environments.

    For more information about hardware requirements, see Hardware and software requirements.

  2. Install the WebSphere MQ client as described in the WebSphere MQ documentation. Be sure to install the Java Messaging feature. The supported version of the WebSphere MQ client is listed in the techdoc describing hardware and software requirements. For further information, see Hardware and software requirements.
  3. Do the following depending on your integration broker:
  4. Do the following to configure the environment to communicate with the broker:
    1. Open the shared environment file located in the ProductDir\bin directory in a text editor.

      On Windows computers, the shared environment file is named CWSharedEnv.bat.

      On UNIX computers, the shared environment file is named adapterEnv.sh or CWSharedEnv.sh, depending on the broker you are using and the version of its release.

    2. Set the value of the ORB_PORT property to the port over which the Object Request Broker installed on the broker computer is configured to communicate.
    3. Set the value of the ORB_HOST property to the IP address of the computer on which the broker is installed.
  5. 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.

Remote adapter environments

You must prepare a remote adapter environment to enable an adapter to exchange data with the integration broker across the boundaries of the network. This is common when a company must exchange business data with trading partners.

Environment 3 in Figure 1 illustrates this type of environment, where the adapter is enabled to communicate with the broker over the internet.

Do the following to prepare a remote adapter environment:

  1. Obtain computers that satisfy the hardware requirements for each of the required environments.

    For more information about hardware requirements, see Hardware and software requirements.

  2. Install the WebSphere MQ client as described in the WebSphere MQ documentation. Be sure to install the Java Messaging feature. The supported version of the WebSphere MQ client is listed in the techdoc describing hardware and software requirements. For further information, see Hardware and software requirements.
  3. Install and configure WebSphere MQ Internet pass-thru as described in Distributing connector agents across networks.
  4. Do the following depending on your integration broker:
  5. 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.

Adapter development environments

You must prepare an adapter development environment in order to create custom adapters. Although you can develop adapters in an environment in which the broker is installed and adapters are running, you can also use an environment that is dedicated exclusively to adapter development.

Environment 4 in Figure 1 illustrates this type of environment.

Do the following to prepare an adapter development environment:

  1. Obtain computers that satisfy the hardware requirements for each of the required environments.

    For more information about hardware requirements, see Hardware and software requirements.

  2. Install the Adapter Framework as described in Installing WebSphere Business Integration Adapters, V. 2.6. Then apply Adapter Framework Fix Pack 2.6.0.3 as described in the Installing Adapter Framework Fix Pack 2.6.0.3 Technote.
  3. Install each data handler that will be required for the adapters you are developing as described in Installing WebSphere Business Integration Adapters, V. 2.6.
  4. Install the Adapter Development Kit as described in Installing WebSphere Business Integration Adapters, V. 2.6.
  5. Install a compiler appropriate for the language in which you will be developing the adapter:

Copyright IBM Corporation 2003, 2005. All Rights Reserved.