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

- 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

- 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:
- 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.
- As the installation process begins, the installer verifies that
enough disk space exists for the installation:
- 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:
- Installed product components.
- Configured the Cwtools.cfg file used by the Toolset
Express.
- Configured the InterchangeSystem.cfg file used by the
InterChange Server Express.
- Configured a queue manager for WebSphere MQ.
- Configured the InterChange Server Express and adapters as services.
- Provided platform-specific configuration and registration.
- Deployed content to the InterChange Server Express.
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.
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.
During installation on a Windows 2000 system, you can choose from the
following set of components:
- InterChange Server Express component
- Toolset Express component, which includes the following
subcomponents:
- Administrative Tools
- Development Tools
By installing the Administrative tools, you receive the following:
- Flow Manager
- Log Viewer
- Relationship Manager
- System Manager
- System Monitor
- Failed Event Manager
By installing the Development tools, you receive the following:
- Adapter Framework
- Business Object Designer Express
- Connector Configurator Express
- Process Designer Express (available with WebSphere Business Integration
Server Express Plus installations only)
- Integrated Test Environment
- Map Designer Express
- Relationship Designer Express
- WebSphere Studio WorkBench 2.0.3 (WSWB203)
- Note:
- The installer installs this product to the directory
ProductDir\Tools\WSWB203. All necessary System
Manager plugins are installed in the directory
ProductDir\Tools\WSWB203\plugins.
- Test Connector
- A choice of adapter components from the following list. You can
install as many adapters as you want. However, a maximum of
three can be registered with the InterChange Server Express if you
are installing WebSphere Business Integration Server Express; a maximum
of five if you are installing WebSphere Business Integration Server
Express Plus.
- Adapter for COM
- Adapter for e-Mail
- Adapter for Exchange
- Adapter for iSeries
- Adapter for JDBC
- Adapter for JMS
- Adapter for JText
- Adapter for Lotus(R) Domino(R)
- Adapter for Portal Infranet 6.x
- Adapter for SWIFT
- Adapter for Web Services
- Adapter for WebSphere MQ
- Adapter for XML
- Note:
- Some adapters have corresponding Object Discovery Agents (ODAs), which are
installed if those adapters are selected. With any adapter selection,
the following components are also installed:
- e-Mail Adapter
- XML Data Handler
- Adapter Framework
- Samples component, which installs a preconfigured sample called System
Test that you can run to verify that your installation is installed and
operating correctly. See Verifying the installation for more details.
During installation on a Windows XP system, you can choose from the
following set of components:
- InterChange Server Express component (not supported in production
environments)
- Toolset Express component, which includes the following
subcomponents:
- Administrative tools
- Development tools
By installing the Administrative tools, you receive the following:
- Flow Manager
- Log Viewer
- Relationship Manager
- System Manager
- System Monitor
- Failed Event Manager
By installing the Development tools, you receive the following:
- Adapter Framework
- Business Object Designer Express
- Connector Configurator Express
- Process Designer Express (available with WebSphere Business Integration
Server Express Plus installations only)
- Integrated Test Environment
- Map Designer Express
- Relationship Designer Express
- WebSphere Studio WorkBench 2.0.3 (WSWB203)
- Note:
- The installer installs this product to the directory
ProductDir\Tools\WSWB203. All necessary System
Manager plugins are installed in the directory
ProductDir\Tools\WSWB203\plugins.
- Test Connector
- Samples component, which installs a preconfigured sample called System
Test that you can run to verify that your installation is installed and
operating correctly. See Verifying the installation for more details.
During installation on a Windows 2003 system, you can choose from the
following set of components:
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.
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:
- Select Start > Programs > IBM WebSphere MQ > WebSphere MQ
Explorer to launch the WebSphere MQ Explorer.
- 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.
- 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.
- 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:
- In the left pane of the MQServices window, under the Console Root tree,
right-click the queue manager name.
- Select New > Channel Initiator from the drop-down
list.
- In the Create Channel Initiator Service dialog, accept the default values
and select OK.
- Configure the Startup mode of each of these entries to
Automatic by right-clicking each, then selecting All Tasks
> Automatic.
- If any of these services are not running, manually start them by
right-clicking each service, then selecting All Tasks >
Start.
- 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.
- 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.
- Configure the listener for automatic startup by right-clicking it and then
selecting All Tasks > Automatic.
- Start the listener manually by right-clicking it and then selecting
All Tasks > Start.
- 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:
- Select Start > Programs > IBM WebSphere MQ > WebSphere MQ
Services. (Alternatively, right-click the WebSphere MQ icon on
your taskbar, then select WebSphere MQ Services.)
- 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.
- 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:
- Right-click it in the right pane of System Manager and select
Properties.
- On the Parameters tab, for the Protocol field, choose
TCP; for the port, choose 1414. Then select
OK.
- 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.
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.
|
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.
