Installing WebSphere Business Integration Server Express and Express Plus using the GUI

If the software prerequisites required for your planned installation each have a status of OK, you can proceed to installing WebSphere Business Integration Server Express or Express Plus by doing the following:

  1. Select the button labeled Install Product located at the bottom of the Launchpad Software Prerequisites screen. A dialog appears, which requests that you insert the appropriate CD into the machine.
  2. Insert the CD containing the Base Components of WebSphere Business Integration Server Express or Express Plus into the machine and select OK. (If the Launchpad does not detect the installation program, an "Open" dialog box is displayed, in which you must select the location to which the CD is mounted.)

    The Software License Agreement screen appears.

    Figure 10. Software License Agreement screen

    Software License Agreement screen

  3. Read and accept the terms of the Software License Agreement by selecting the radio button beside the entry I accept the terms in the license agreement, then select Next.

    The Destination screen appears.

    Note:
    If you are running the installer in a non-English locale, a button labeled English appears on the Software License Agreement screen. Select this button to view the software license agreement in English. The text of the button then changes to the non-English language used for the installer. Select the button again to display the software license agreement in the non-English language used for the installer.

    Figure 11. Destination screen

    Destination screen

  4. On the Destination screen, accept the default installation location of Home_directory/IBM/WebSphereServer (where Home_directory is the home directory of the user identified on the previous Select User screen) or browse for a different location, then select Next.
    Note:
    The directory path must not contain any spaces. Throughout this document, the installation directory Home_directory/IBM/WebSphereServer will be referred to as ProductDir.

    One of the following occurs:

  5. On the Name Server Configuration screen, type the IP address of the computer on which you have installed or plan to install the InterChange Server Express component, and then select Next to begin the installation process. See the section Configuring the Name Server for more information about the Name Server.
  6. As the installation process begins, the installer verifies that enough disk space exists for the installation:

The installation process has completed the following:

At this point, you can view the files and directory structure of your system, as detailed in Viewing WebSphere Business Integration Server Express and Express Plus files and directories. The log file called wbi_server_exp_install_log.txt, which details the installation process, is located in the ProductDir directory.

Deciding which WebSphere Business Integration Server Express and Express Plus components to install

When you are installing WebSphere Business Integration Server Express and Express Plus, you can install all or some subset of product components. The installable components are selectable from the screens that appear when you select the Install Product button from the left panel of the Launchpad or from within the response file used during silent installation.

The components available for installation are identical on all supported Linux versions. Support for installed components can differ based on whether they are being used in production or development environments. See Table 4 for a listing of which product components are supported on each of the Linux versions in both production and development environments.

During installation on a Linux system, you can choose from the following set of components:

See the System Administration Guide for descriptions of the InterChange Server Express and Toolset Express components; the individual adapter guides for descriptions of the adapters. All documentation is available at the following Web site: http://www.ibm.com/websphere/wbiserverexpress/infocenter.

Configuring the Name Server

If you install the Administrative Toolset Express component or adapters in a different location from the InterChange Server Express component of WebSphere Business Integration Server Express or Express Plus, the installer must configure a Name Server. As a result, the installer queries you for the IP address of the machine that contains or will contain the InterChange Server Express. The installer obtains this information from the IP address you type in the Name Server Configuration screen during installation and uses it for the value of the ORB_HOST property in the ProductDir/bin/CWSharedEnv.sh file on the local machine.

Viewing WebSphere Business Integration Server Express and Express Plus files and directories

After WebSphere Business Integration Server Express or Express Plus is installed, you can view the resulting file system and its contents. The directories are located by default under the Home_directory/IBM/WebSphereServer directory, which will be referred to as ProductDir throughout this document.

Note:
The particular files and directories that appear in ProductDir depend on the components selected during installation. The files and directories in your installation might differ from the ones listed below.

Table 1. Directory structure of WebSphere Business Integration Server Express and Express Plus installations on a Linux system

Directory name Contents
  • _uninstWBIServerExp (in WebSphere Business Integration Server Express installations)
  • _uninstWBIServerExpPlus (in WebSphere Business Integration Server Express Plus installations)

This directory contains the Java Virtual Machine (JVM) and the executable file that is used to remove WebSphere Business Integration Server Express or Express Plus.
_uninstZip This directory contains a listing of all files unzipped during installation.
bin This directory contains the executable files and .sh files that the system uses.
collaborations This directory contains subdirectories that contain .class files and message files for installed collaborations.
connectors This directory contains files specific to each adapter in the system. It also contains adapter-specific files that you may need to install in the application that the adapter supports.
DataHandlers This directory contains the .jar file for the data handler that the system uses.
DevelopmentKits This directory contains sample files to assist the developer in creation of 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 Express maps.
jre This directory contains the IBM Java Runtime Environment (JRE) files.
legal This directory contains the license files.
lib This directory contains .jar files for the system.
logs This directory contains various log files.
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 .sh files for each agent.
repository This directory contains the definitions for the system components.
Samples This directory contains component definitions for benchmarking samples and sample mail files for collaborations.
src This directory contains samples of Relationship Service APIs for cross-referencing.
templates This directory contains the start_connName.sh file.
WBFEM This directory contains the Failed Event Manager files.
WBSM This directory contains the System Monitor files.

Installing additional components after initial installation

After you have installed WebSphere Business Integration Server Express or Express Plus, you can later install additional components. To do this, select the Install Product button from the left panel of the Launchpad. The Launchpad then offers screens from which you can select components to install, as detailed in Identifying which software prerequisites are required. If you have already installed some components from a particular screen, the screen appears but the checkboxes beside components that are already installed are disabled.

Important:
The user who installs additional components must be the same user who installed the product. Problems with permissions can result if the same user does not perform both tasks.

The Launchpad determines whether additional software prerequisites are required based on your new selections and leads you through their installation, as well as installation of the new WebSphere Business Integration Server Express or Express Plus components.

Copyright IBM Corp. 2004