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.

    The Software License Agreement screen appears.

    Figure 9. Software License Agreement screen

    Software License Agreement screen

  2. 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 10. Destination screen

    Destination screen

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

    One of the following occurs:

  4. 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.
  5. As the installation process begins, the installer verifies that enough disk space exists for the installation:
  6. 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 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 differ based on the Windows platform being used. 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 Windows platforms in both production and development environments.

The following sections describe the installable components available per Windows operating system:

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.

Components available for installation on a Windows 2000 system

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

Components available for installation on a Windows XP system

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

Components available for installation on a Windows 2003 system

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

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 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.bat file on the local machine.

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 that contains the name of the queue manager. The Queue Manager Status in the right pane must show the Queue Manager Status as Running. If it does not, right-click on the queue manager name in the right pane, then select Start from the drop-down list. The Queue Manager Status changes 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 left pane of the MQServices window, under the Console Root tree, expand WebSphere MQ Services, then select the queue manager.

    Three entries for your particular queue are listed in the right pane: Queue Manager, Command Server, and Channel Initiator. If you do not see a Channel Initiator, do the following:

    1. In the left pane of the MQServices window, under the Console Root tree, right-click the queue manager name.
    2. Select New > Channel Initiator from the drop-down list.
    3. In the Create Channel Initiator Service dialog, accept the default values and select OK.
  5. Configure the Startup mode of each of these entries to Automatic by right-clicking each, then selecting All Tasks > Automatic.
  6. If any of these services are not running, manually start them by right-clicking each service, then selecting All Tasks > Start.
  7. Add a listener entry by right-clicking the queue manager name in the left pane under the Console Root tree and then selecting New > Listener from the drop-down list.
  8. 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.

  9. Configure the listener for automatic startup by right-clicking it and then selecting All Tasks > Automatic.
  10. Start the listener manually by right-clicking it and then selecting All Tasks > Start.
  11. Close the MQServices window and IBM WebSphere MQ Explorer. Select Yes when prompted to save your changes.
If you restart your machine:
You do not have to restart your machine, but any time you do, verify that the Channel Initiator and Listener have 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 start-up. If the Channel Initiator is running and is set for Automatic start-up, proceed to Step 3. If it is not, do the following:
    • If the Channel Initiator is not running, right-click it in the right pane of System Manager and select All Tasks > Start.
    • If the Channel Initiator is not set for Automatic start-up, right-click it in the right pane of System Manager and select All Tasks > Automatic.
  3. In the MQServices window, verify that the Listener is running and that it is set for Automatic start-up. If the Listener is running and is set for Automatic start-up, close the MQServices window. If it is not, do the following:
    • If the Listener is not running, do the following:
      1. Right-click it in the right pane of System Manager and select Properties.
      2. On the Parameters tab, for the Protocol field, choose TCP; for the port, choose 1414. Then select OK.
      3. Right-click the Listener in the right pane of System Manager and select All Tasks > Start.
    • If the Listener is not set for Automatic start-up, right-click it in the right pane of System Manager and select All Tasks > Automatic.

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 and the Windows platform being used. 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 Windows 2000 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 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.

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.

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