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

The installation instructions in this section assume the following:

To invoke the Launchpad to launch the product installation GUI, do the following:

  1. Select the button labeled Install Product from the Launchpad. The Install Product screen appears.

    Figure 5. Install Product screen


  2. Select Launch Product Installation.

    The Welcome screen appears.

    Figure 6. Welcome screen


  3. At the Welcome screen, select Next.

    The Software License Agreement screen appears.

    Figure 7. Software License Agreement screen


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

    Figure 8. Destination screen


  5. On the Destination screen, accept the default installation location of C:\IBM\WebSphereServer or browse for a different location, then select Next.
    Note:
    The directory path must not contain any spaces. Throughout this document, the installation directory C:\IBM\WebSphereServer will be referred to as ProductDir.

    The Feature screen appears.

    Figure 9. Feature screen


  6. On the Feature screen, select those components you want to install and select Next. See the section Deciding which WebSphere Business Integration Server Express and Express Plus components to install for descriptions of available components.

    One of the following screens appears:

    Figure 10. Name Server Configuration screen


  7. 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. See the section Configuring the Name Server for more information about the Name Server.

    The Pre-installation Summary screen appears.

    Figure 11. Pre-installation Summary screen


  8. On the Pre-installation Summary screen, review the features and installation location and select Next.

    The installer verifies that enough disk space exists for the installation:

  9. On the Reboot screen, select whether you want to restart your machine now or later, and select Finish to exit the installation GUI.
  10. Add a listener to the WebSphere MQ service by following the instructions in the section Adding a listener to the WebSphere MQ service.

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 directory ProductDir\log.

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 Feature screen that appears when installing with the product installation GUI or from within the response file used during silent installation.

See the sections Installing WebSphere Business Integration Server Express and Express Plus using the GUI and Silently installing WebSphere Business Integration Server Express and Express Plus for descriptions of the installation process. 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.

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

During installation on a Windows XP system, you can choose to install only the Toolset Express component.

Configuring the Name Server

If you install the 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 value typed in the Name Server Configuration screen during installation. It uses this information to edit the default value of the ORB_HOST property listed in the cwSharedEnv.bat file, located in the directory ProductDir\bin.

Adding a listener to the WebSphere MQ service

Installing WebSphere Business Integration Server Express or Express Plus created the queue manager; you must add the WebSphere MQ listener as a Windows service and configure it for automatic startup, as follows:

  1. Select Start > Programs > IBM WebSphere MQ > WebSphere MQ Explorer to launch the WebSphere MQ Explorer.
  2. In the left pane of the WebSphere MQ Explorer, select the queue managers folder with the name of the queue manager. The Queue Manager Status in the right pane should show the queue manager status as Running. If it does not, right-click on the queue manager name, then select Start from the drop-down list. The Queue Manager Status should change to Running.
  3. Open WebSphere MQ Services by right-clicking the queue manager name in the right pane, then selecting All Tasks > Services from the drop-down list.
  4. In the Console Root tree of the MQServices window, expand WebSphere MQ Services, then select the queue manager.

    There should be three entries for your particular queue listed in the right pane: Queue Manager, Command Server, and Channel Initiator. (If you do not see a Channel Initiator, it will appear after you reboot your system.)

  5. For the three entries in the right pane--Queue Manager, Command Server, Channel Initiator--configure the Startup mode to Automatic by right-clicking each, then selecting All Tasks > Automatic.
  6. Add a listener entry by right-clicking the queue manager name in the Console Root tree and then selecting New > Listener from the drop-down list.
  7. In the Parameters tab of the Create Listener Service dialog box, select TCP as the Protocol and 1414 as the port number, then select OK.

    You must use a unique port number for each listener. Assign the port a number other than the default of 1414, then select OK.

  8. Configure the listener for automatic startup by right-clicking it and then selecting All Tasks > Automatic.
  9. Close IBM WebSphere MQ Explorer. Select Yes when prompted to save your changes.
  10. Restart your machine.
  11. Verify that Channel Initiator has been started by following these steps:
    1. Select Start > Programs > IBM WebSphere MQ > WebSphere MQ Services. (Alternatively, right-click the WebSphere MQ icon on your taskbar, then select WebSphere MQ Services.)
    2. In the MQServices window, verify that Channel Initiator is running and that it is set for Automatic.
    3. Close the MQServices window.

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 C:\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

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 uninstaller.exe 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, .dll files, and .bat 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.
log This directory contains the log file, which contains all errors and warnings that occur during installation or uninstallation. The filename is wbi_server_exp_install_log.txt.
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 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.bat file.
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. 2004