Comprehensive install and uninstall information

The information in this section describes how to install WebSphere Business Integration Adapters (WBIA).

Install the WBIA product by running a platform-specific executable for the installer. Table 6 lists the installer executable for each operating system. The installer executables are located in the WebSphereBI directory on the product CD.

Table 6. Platform-specific executables for WBIA Installer

Operating system WBIA Installer executable file
Windows setupwin32.exe
AIX setupAIX.bin
Solaris setupsolarisSparc.bin
HP-UX setupHP.bin
Note:
These procedures assume that you are installing from a product CD. If you obtain your software from Passport Advantage, make sure you have downloaded it. Refer to your Passport Advantage information for those downloading instructions.
Note:
If you are installing the adapters to communicate with InterChange Server, you must install the broker first. See the installation guide for InterChange Server on the appropriate platform for information on how to install the broker.
Important:
Make sure you are logged in as the WebSphere business integration system administrator before you install the adapters. When you install on a UNIX computer, the permissions of the folders and files that are created are set based on the permissions of the user account that performs the installation.
Important:
You must not install WBIA as root. The entry that is added to the Object Data Manager (ODM) when installing as root prevents you from using SMIT to uninstall other applications, so you should not install WBIA as root.

Invoking the graphical WBIA Installer

The graphical WBIA installer presents you with a wizard that allows you to make choices about the installation of the WBIA product. Although the installer is Java-based and therefore platform-independent, there are different ways of invoking the installer for each platform. This section describes the approaches for both Windows and UNIX computers.

Invoking Installer in a Windows environment

To invoke Installer in a Windows environment, navigate to the WebSphereBI directory of the product CD and execute setupwin32.exe.

Invoking Installer in a UNIX environment

The WBIA installer in a UNIX environment is invoked through a .bin file specific to the platform, located in the WebSphereBI directory. Table 6 provides the name of the .bin file for each platform.

Follow the steps in one of the following sections to invoke the installer depending on how you are working with the UNIX computer:

If you are running CDE on the UNIX computer

If you are running the Common Desktop Environment (CDE) and working on the UNIX computer directly then you can navigate to the WebSphereBI directory of the product CD and double-click the .bin file specific to the operating system.

You can also navigate to the WebSphereBI directory of the product CD and execute the .bin file at the command line. The following example shows how to do so on a Solaris computer:

# ./setupsolarisSparc.bin
 
If you are connecting to the UNIX computer through X emulation software

If you are using a Windows computer to connect to the UNIX computer through X emulation software do the following to invoke the installer:

  1. Determine the IP address of the Windows computer that you are using to connect to the UNIX computer.

    You can execute the ipconfig command at the Windows command line interface to display the IP address of the Windows computer.

  2. Set the DISPLAY environment variable on the UNIX computer to the IP address determined in step 1.

    You must be sure to follow the IP address with a colon and the identifier for the monitor or display on the Windows client computer. If the Windows client computer only has a single monitor then the display value is 0.0.

    The following example shows the DISPLAY environment variable being set to the single monitor on a Windows computer whose IP address is 9.26.244.30:

    DISPLAY=9.26.244.30:0.0
     
    
  3. Export the DISPLAY environment variable by executing the following command:
    export DISPLAY
     
    
  4. Start the X emulation client on the Windows computer and connect to the UNIX computer.
  5. Navigate to the WebSphereBI directory of the product CD at the command line of the X emulation client.
  6. Execute the .bin file specific to the operating system. For example, if the UNIX computer was running AIX then you would execute the following command:
    # ./setupAIX.bin
     
    

    The graphical installer starts on the Windows computer that you are using to connect to the UNIX computer.

Copyright IBM Corp. 1997, 2004