You can install InterChange Server from Passport Advantage or from a
CD-ROM. The procedures described in this section assume you are
installing the software from the CD. If you obtained your software from
Passport Advantage, make sure you have downloaded it. Refer to your
Passport Advantage information for those downloading instructions.
Before you begin the InterChange Server installation, make sure that you
have installed any prerequisite software. This includes the XML data
handler and adapter for e-Mail, if your installation of ICS will include
collaborations.
Make sure that you are logged in as the administrator before you install
ICS or configure the supporting software. If you need to create the
administrator account, refer to "Creating the InterChange Server Administrator account".
* If you are upgrading your InterChange Server system to a newer
release, see Upgrading the InterChange Server system.
* To prevent the truncation of characters while running Installer, set
your display to Small Font by right-clicking the Windows desktop, selecting
Properties > Settings > Advanced, and selecting Small Fonts from the
Font Size pull-down menu.
Follow these steps to install the ICS software:
- Insert the ICS CD in your drive and double-click the
setupwin32.exe file, located in the WebSphereBI
directory.
- On the Language Selection screen, select a language for viewing Installer
screens from the pull-down menu, then click OK.
- On the Welcome screen, click Next. See Figure 2..
Figure 2. Installation welcome screen

- On the License Agreement screen, read and accept the terms of the license,
and then click Next.
- Note:
- If the WBIA 2.6 Toolset exists on the target machine, the installer
issues an error message after the License Agreement screen, indicating that
installation cannot install to a machine which contains the WBIA 2.6
Toolset. The WBIA 2.6 Toolset must be uninstalled before
starting the installer. You must cancel the installation at this point
and re-start the installation after uninstalling the WBIA 2.6
Toolset.
- Accept the default installation location or browse for a different
location, then click Next.
- Note:
- If you are upgrading the InterChange Server system, you must install to a
different location. See Upgrading the InterChange Server system for details on the upgrade process.
Figure 3. Select components screen

- On the Select Components screen (Figure 3.), select specific features to be installed, allow
the screen time to refresh, confirm your selections, then click Next.
- On the Database Type Selection screen, select a database from the
drop-down menu and select whether or not IBM WebSphere MQ
5.3.0.2 will be used for messaging support. Click
Next to continue.
- If you selected IBM DB2 from the database drop down menu in step 7, type
the installed location on the DB2 Home Directory screen.
- Note:
- If you did not select DB2 as your database, this screen will not appear and
you should proceed to step 10.
- On the InterChange Server Name screen, type the name of InterChange Server
that you plan to use and click Next.
The server name must be unique in a network.
Figure 4. InterChange Server naming screen

- Accept the default installation location for the IBM WebSphere MQ
5.3.0.2 Java Library or browse for a different location,
then click Next.
- Note:
- If in step 7 you chose to use WebSpher MQ 5.3.0.2 for
messaging support, or if the MQ_LIB environment variable already exists on the
target machine, this screen does not appear.
- If WebSphere Studio Application Developer Integration Edition (WSADIE)
5.1 or 5.1.1 is already installed on your machine (and
you elected to install the Toolset in step 6), you will be asked whether or
not your System Manager files should be installed at your existing WSADIE
location, or if you would like to install WebSphere Studio Workbench
2.0.3. If you are not a WSADIE user, proceed to step
12.
- Note:
- If you choose to install System Manager files under the existing WSADIE
location, then the WSADIE Home Directory Panel will be used to enter the
installation location. WSADIE 5.1 and 5.1.1 comes
with WebSphere Studio Workbench 2.0.3. If you are a
WSADIE user and you elect to install WebSphere Studio Workbench
2.0.3, a second instance will be installed to your
machine.
- Select the components to start as services and click Next.
- Note:
- Depending on which components you selected to be started as services, you are
prompted to reboot the system.
- Enter the folder location name for your installation or accept the default
location of IBM WebSphere InterChange Server, and click Next.
- The Installation summary screen appears and the selected components to be
installed to the destination location is displayed. See Figure 5..
Review the features and installation location and click Next.
- Note:
- If you click the Cancel button while the software is installing, some files
appear in the newly created WebSphereICS directory. How many appear
depends on how far the process has gone before you cancel the
installation.
Figure 5. Installation summary screen

After all files and folders are copied to the destination location, the
InterChange Server Configuration screen appears. Do not close this
screen. It signifies the end of the installation process and the
beginning of the configuration process.
Proceed to Configuring or reconfiguring InterChange Server to set up your InterChange Server environment.
See Table 6 for a list of the directories and files that were created
during the installation process.
After InterChange Server is installed, you can view the file system and its
contents. The directories are located under the WebSphereICS
directory. These directories are listed in Table 6..
- Note:
- The particular files and directories that appear in ProductDir
depend on the components selected during InterChange Server
installation. The files and directories in your installation might
differ from the ones listed below.
Table 6. IBM WebSphere InterChange Server directory structure
Directory name
| Contents
|
_jvm
| This directory contains the Java Virtual Machine (JVM) that is used by
Installer.
|
_uninstWICS4.3
| This directory contains the uninstaller.exe file that
is used to remove InterChange Server 4.3.
|
_uninstZip
| This directory contains a listing of the unzipped System Manager files
that are removed when the Uninstaller is run.
|
bin
| This directory contains the executable files, .dll
files, and .bat files that the InterChange Server system
uses.
|
collaborations
| This directory contains subdirectories that contain
.class files and message files for installed
collaborations.
|
DataHandlers
| This directory contains the .jar files for data handlers that
InterChange Server uses.
|
DevelopmentKits
| This directory contains sample files that help you create various system
components. Samples provided include: Server Access for EJB,
Server Access for J2EE Connector Architecture, connectors (C++ and Java), and
Object Discovery Agents.
|
DLMs
| This directory contains subdirectories that contain Dynamic Loadable
Modules (DLMs) and other files for InterChange Server maps.
|
docs
| This directory contains the WebSphere InterChange Server
documentation.
|
jre
| This directory contains the IBM Java Runtime Environment files.
|
legal
| This directory contains the license files.
|
lib
| This directory contains .jar files for the
system.
|
logs
|
|
messages
| This directory contains the generated message files.
|
mqseries
| This directory contains files specific to WebSphere MQ, including certain
executable files.
|
ODA
| This directory contains the Object Discovery Agent .jar
and .bat files for each agent.
|
repository
|
|
Samples
| This directory contains the Benchmark sample files.
|
snmp
| This directory contains various SNMP agent files such as:
wbi_snmpagent.cfg file, located in the config
subdirectory, and the log and state files.
|
src
| This directory contains samples of Relationship Service APIs for
cross-referencing.
|
Tools
| This directory contains the Workbench files if selected during
installation.
|
WBFEM
| This directory contains the Failed-Event Manager files.
|
WBSM
| This directory contains the System Monitor files.
|
