To successfully install an Adapter
Capacity Pack, you and your system must meet the following
prerequisites:
- WebSphere Business Integration Server Express must not be installed on the
same machine on which you are installing the adapter. (Adapters
supplied with Adapter Capacity Packs can be used only with an existing
WebSphere Business Integration Server Express Plus installation.)
- If the adapter will not be installed on the same machine as InterChange
Server Express, an installation of the WebSphere MQ
5.3.0.2 CSD06 Client must exist on the same machine on
which the adapter will be installed.
- In order for the adapter license to be registered successfully,
InterChange Server Express must be running and, if installed on a
remote machine, running and reachable.
The installation GUI supplied with the Adapter Capacity Pack installs and
registers with the InterChange Server Express up to three adapters, which can
be selected from the list in the section Deciding which adapter to install. The installer installs and registers only one
adapter at a time (thus, you must run the Adapter Capacity Pack installer
separately for each adapter you want to install).
To invoke the Launchpad to launch the installation GUI, do the
following:
- Select the button labeled Install Capacity Pack from the left
column of the Launchpad.
The Install Capacity Pack screen appears with two buttons.
- Select Install Adapter Capacity Pack.
The Select User screen appears.
- On the Select User screen, type the name of the user who will install the
Adapter Capacity Pack, and then select Install Product. A
dialog appears, which requests that you insert the appropriate CD into the
machine.
- Insert the appropriate CD into the machine and select
OK. (If the Launchpad does not detect the installation
program, an "Open" dialog box is displayed, in which you must select the
location to which the CD is mounted.) The GUI launches to install the
Adapter Capacity Pack and the Welcome screen appears.
- At the Welcome screen, select Next.
The Software License Agreement screen appears.
- Read and accept the terms of the Software License Agreement by selecting
the radio button beside the entry I accept the terms in the license
agreement, then selecting Next.
The installer checks that the prerequisites listed at the beginning of this
section have been met. If any have not been met, it forces you to
cancel the installation by selecting the Cancel button. If
all prerequisites have been met, the Feature screen appears.
- Note:
- If you are running the installer in a non-English locale, a button labeled
English appears on the Software License Agreement screen.
Select this button to view the software license agreement in English.
The text of the button then changes to the non-English language used for the
installer. Select the button again to display the software license
agreement in the non-English language used for the installer.
- On the Feature screen, select one adapter from the list of
available adapters, by selecting the radio button beside its name, then select
Next. For more information about which adapter to select,
see the section Deciding which adapter to install.
One of the following screens appears:
- If the InterChange Server Express is installed on the local machine, the
InterChange Server Express Password screen appears. In this case,
proceed to Step 10.
- If the InterChange Server Express exists on a remote machine, the Server
IP Address Configuration screen appears. In this case, proceed to Step 8.
- On the Server IP Address Configuration screen, type
the IP address of the computer on which you have installed the InterChange
Server Express component. If the InterChange Server Express is on an
OS/400 machine, select the checkbox beside the entry InterChange Server
Express is on OS/400. Then select Next. One of
the following screens appears:
- If you did not select the checkbox beside the entry InterChange
Server Express is on OS/400, the InterChange Server Express Password
screen appears. In this case, proceed to Step 10.
- If you selected the checkbox beside the entry InterChange Server
Express is on OS/400, the Server Name Configuration screen
appears. In this case, proceed to Step 9.
- On the Server Name Configuration screen, do the
following:
- Type the name of the InterChange Server Express instance on the OS/400
machine. (The default is QWBIDFT. If you created a
different name for your instance, type it instead.)
- Type the ORB port number. (The default is 14500.
If you used a different port number, type it instead.)
Then select Next.
The InterChange Server Express Password screen appears.
- On the InterChange Server Express Password screen, type the
password of the user admin for the InterChange Server Express, and
then select Next.
The Pre-installation Summary screen appears.
- On the Pre-installation Summary screen, review your
selection and installation location and select Next.
The installer verifies that enough disk space exists for the
installation. Installation then proceeds, as follows:
- If enough space does not exist, the Next button is disabled
since installation cannot be completed with the provided disk space. In
this case, you must select Back and delete some unneeded space on
the specified file system.
- If enough space does exist, installation and configuration begin.
When installation and configuration are complete, the installer attempts to
connect to the server to register the license for this adapter. A
message dialog informs you if the adapter was registered successfully; an
error dialog alerts you if registration was unsuccessful or if you exceeded
the maximum number of adapters that can be registered with the InterChange
Server Express. Select OK to exit the dialog. For
more information on how the system updates the license file, see Updating the license file. The Post-installation Summary screen appears, which
indicates if the process was successful or if problems were
encountered.
- On the Post-installation Summary screen, select Finish to exit
the installation GUI.
Running the Adapter Capacity Pack installer allows you to choose one
adapter component from the following:
- Adapter for mySAP.com
- Adapter for Oracle Applications
- Adapter for Telcordia
- Adapter for WebSphere Commerce
Notes:
- Some adapters have corresponding Object Discovery Agents (ODAs), which are
installed if those adapters are selected. With any adapter selection,
the following components are also installed:
- e-Mail Adapter
- XML Data Handler
- Adapter Framework
- The Adapter for MetaSolv Applications, Adapter for JD Edwards OneWorld,
Adapter for Siebel eBusiness Applications, Adapter for i2, and Adapter for
PeopleSoft are supported only on the Windows 2000 and Windows 2003
platforms. However, each of these adapters can be configured as a
distributed adapter to communicate with InterChange Server Express installed
on the Linux platform. For information on configuring distributed
adapters, see the System Implementation Guide.
For descriptions of individual adapters, see the Adapter documentation at
the following Web site: http://www.ibm.com/websphere/wbiserverexpress/infocenter.
The Adapter Capacity Pack installer and uninstaller update the adapter
license file in the InterChange Server Express component of WebSphere Business
Integration Server Express Plus any time an adapter is installed or
uninstalled. In this way, the license file is always current. Up
to three adapters installed from an Adapter Capacity Pack can be registered
with the InterChange Server Express. These three adapters can be
registered in addition to the one to five adapters you might have installed
during WebSphere Business Integration Server Express Plus installation.
The installer and uninstaller obtain the connection password of the
InterChange Server Express from the InterChange Server Express Password screen
during the installation and uninstallation processes. Near the end of
the installation and uninstallation processes, a message dialog informs you if
the adapter was registered successfully; an error dialog alerts you if
registration was unsuccessful or if you exceeded the maximum number of
adapters that can be registered with the InterChange Server Express.
- Note:
- You can install as many adapters as you want. However, a maximum of
eight adapters can be registered with the InterChange Server
Express. This total number is composed of the up to five adapters you
might have selected during installation of WebSphere Business Integration
Server Express Plus plus the number of adapters you have installed
by running the Adapter Capacity Pack installer.
