General procedures for using installation media

This section describes general procedures for using the installation media. Other sections in this guide refer to the content in this section.

Invoking the graphical WBIA installer

The graphical WebSphere Business Integration Adapters Installer presents you with a wizard that allows you to make choices about the installation of WebSphere Business Integration Adapters. You invoke Installer by running platform-specific executables for the different product installers. The product installers are identical whether you obtain them from a CD or from Passport Advantage. This section describes how to invoke Installer for any of the WebSphere Business Integration Adapters products on both Windows and UNIX computers.

Invoking Installer in a Windows environment

Make sure you are logged in with administrative privileges before you install WebSphere Business Integration Adapters in a Windows environment.To invoke Installer in a Windows environment, navigate to the Windows directory of the installation media 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 UNIX directory of the installation media.

When you install on a UNIX-based 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.Make sure that you do not install WebSphere Business Integration Adapters as root on an AIX computer. The entry that is added to the Object Data Manager (ODM) when installing as root prevents you from using System Management Interface Tool (SMIT) to uninstall other applications, so you should not install WBIA as root.

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

If you are running Common Desktop Environment CDE on a UNIX computer

Navigate to the UNIX directory of the installation media and double-click the .bin file specific to the operating system.

You can also navigate to the UNIX directory of the installation media and execute the .bin file at the command line. The following example shows how to do so on an AIX computer:

# ./setupAIX.bin

If you are connecting to a UNIX computer through X emulation software

Do the following to invoke the installer:

  1. Follow the steps in Configuring your environment for X emulation.
  2. Execute the .bin file specific to the operating system. The following example shows how to do so on an AIX computer:
    # ./setupAIX.bin
    

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

Note:
Accessibility hotkeys do not function when you are working on a UNIX computer through emulation software. To use accessibility hotkeys, you must work directly on a UNIX computer.

Performing a silent installation

You can perform a silent installation of WebSphere Business Integration Adapters, where you provide your installation choices in a file rather than at the screens of the installation wizard. This is particularly helpful when you have to perform multiple installations that are identical.

To perform a silent installation, you create a file with your installation choices as described in Preparing the installation response file and then perform the installation using the file as described in Executing the silent installation. The following sections about installing the different types of WebSphere Business Integration Adapters products address the installation options that are specific to each product type:

Preparing the installation response file

When performing a silent installation, you prepare a response file (or options file) that contains your installation choices. IBM provides response file templates that contain the options for each WebSphere Business Integration Adapters product. The response file templates are named settings.txt and are provided with the other installation files.

If you are performing identical installations on multiple machines, you can easily record an image of the first installation to a file and use that file as the installation response file for subsequent installations. Refer to Recording installation selections for more information.

The following tables list the options that are available for each type of WebSphere Business Integration Adapters products:

Be sure to read all the information in the Option values column, as it specifies when particular options should be commented out and what the broker and platform compatibilities are.

You can modify one of the response file templates and use it for the silent installation. In this case you should be sure that any options that are incompatible with others you require are commented out by placing a hash symbol # in front of them. Alternatively, you can create a new response file with the options you require. This approach has the benefit that no unnecessary options or commented description blocks are present to clutter the response file, making it easier to read and edit. If you take this latter approach, it is recommended that you copy a template file and remove the sections and options that are not necessary, rather than typing the necessary options into a new file.

Note:
There should not be any spaces in front of any of the options in the response file.

Executing the silent installation

To execute the silent installation, you run the platform-specific installer executable at the command line with several options, including the name of the response file you prepared.

The following example shows how to do so on a Windows computer where the response file exists in the C:\data directory:

D:\WebSphereBI>setupwin32.exe -silent -options C:\data\settings.txt

The following example shows how to do so on an AIX computer where a custom response file named install.txt has been created in the /home/wbia directory:

# ./setupAIX.bin -silent -options /home/wbia/install.txt

Copyright IBM Corp. 1997, 2004