Installing IBM WebSphere InterChange Server software

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".

HA

For high availability, you must be logged in as the Domain user on each machine in the cluster. To create the Domain user for the cluster, refer to "Creating the Domain user for high availability".

* 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:

  1. Insert the ICS CD in your drive and double-click the setupwin32.exe file, located in the WebSphereBI directory.
  2. On the Language Selection screen, select a language for viewing Installer screens from the pull-down menu, then click OK.
  3. On the Welcome screen, click Next. See Figure 2..

    Figure 2. Installation welcome screen


  4. 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.
  5. 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


  6. 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.
  7. 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.
  8. 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.
  9. 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


  10. 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.
  11. 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.
  12. 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.
  13. Enter the folder location name for your installation or accept the default location of IBM WebSphere InterChange Server, and click Next.
  14. 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


Completing the installation process

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.

InterChange Server directories and files

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.

Copyright IBM Corp. 1997, 2004