102 WebSphere InterChange Server Migration Scenarios
One of the major changes in Version 4.3.0 is the separation of the Adapter
Framework code completely from the WebSphere InterChange Server code. As
a result, Adapter Framework has to be installed on every machine that hosts an
adapter and it must not be installed in the same directory as WebSphere
InterChange Server 4.3. For exact installation information, refer to the
WebSphere InterChange Server Installation Guide for UNIX or Windows. Also,
keep in mind that only data handlers and adapters from WebSphere Business
Integration Adapters 2.6 can be used. For more detailed instructions about
installing or upgrading adapters, refer to the individual adapter guides at:
6.2.3 Cannot be installed in the same location as old versions
WebSphere InterChange Server 4.3.0 cannot be installed on top of previous
versions of WebSphere InterChange Server. On Windows, the previous version
of WebSphere InterChange Server has to be uninstalled before the new version
of WebSphere InterChange Server can be installed. On UNIX, it is good practice
to install WebSphere InterChange Server to a new directory, with a new user ID.
Using this approach, it is possible to revert to the previous version of WebSphere
InterChange Server if the upgrade or migration is not completed for any reason.
6.3 Installation on Windows
This section describes the minimal set of steps that must be performed and
states that have to be achieved to successfully install WebSphere InterChange
Server 4.3 on Windows. For in-depth explanations, refer to these guides:
IBM WebSphere InterChange Server System Installation Guide for Windows
In the left-side pane, expand Interchange Server and Toolset →
Installation → PDFs and click Windows in the right-side pane.
Installation Guide and Implementation Guide for WebSphere MQ 5.3
Installation Guide and Implementation Guide for the Relational database
management System (RDBMS) used with WebSphere InterChange Server
Important: As mentioned before, WebSphere InterChange Server 4.3 on
UNIX must not be installed using the root user.
Chapter 6. Installation of WebSphere InterChange Server 4.3 103
Each database system (Oracle, Microsoft SQL Server IBM DB2) has its own
set of documentation.
For Oracle, and Microsoft, refer the respective company’s main Web site:
For the following steps, it is assumed that WebSphere MQ is a prerequisite and
must be installed for either delivery transport or for use as the Object Activation
Additionally, many of these steps recommend making a backup. Be sure to test
whether the backup can be restored on a different machine without problems.
1. Install or upgrade the database to bring it to a supported level. Follow the
instructions provided in the database documentation. If the database is
upgraded, take the appropriate database backup steps prior to installation.
2. Install Java Development Kit (JDK) 1.4.2. The JDK is needed to compile maps
and collaboration templates. A compatible JDK is provided with the
WebSphere InterChange Server 4.3.0 product CD. Add the location of the
JDK /bin directory to the beginning of the PATH environment variable.
3. Install WebSphere MQ 18.104.22.168 and apply the latest supported fix pack. To find
the latest supported fix pack, visit:
To apply the fix pack, follow the instructions in the WebSphere MQ
documentation. If WebSphere MQ is upgraded, take the appropriate backup
steps prior to installation.
4. If WebSphere Application Server 22.214.171.124 or 5.1 is installed before running the
WebSphere InterChange Server installer, the installer program automatically
installs and configures System Monitor and deletes the previous version. This
feature is available only on Windows when WebSphere Application Server is
located on the same machine as the WebSphere InterChange Server. Install
or upgrade WebSphere Application Server to Version 126.96.36.199 or 5.1 to use this
feature. The System Monitor can also be installed at a later time. It also
supports Tomcat as the Web server. For details, refer to the WebSphere
InterChange Server 4.3 Installation Guide for Windows at:
5. Adjust settings for WebSphere MQ, database, and any third-party
components involved to the recommended settings. For example, when using
DB2 for the database, make sure that more than 50 connections are available