Installing WebSphere Partner Gateway - Express on a Windows
system
There are three ways to install WebSphere Partner Gateway
- Express on a Windows system:
Using
the graphical installer for Windows
To install WebSphere Partner Gateway - Express using the
graphical installer:
- Insert the WebSphere Partner Gateway - Express 6.0 CD-ROM into
the CD-ROM drive on your computer. The Launchpad window opens.
Note:
If the Launchpad does not start automatically, you
can start it manually by executing LaunchPad.bat, located in the root directory of the CD.
The Launchpad window offers five options:
- Product Overview, which utilizes your
Web browser to take you to the IBM Web site containing product information
about WebSphere Partner Gateway - Express.
- ReadMe File, which opens the ReadMe file
on the installation disk.
- InfoCenter Documentation, which utilizes
your Web browser to take you to the IBM WebSphere Partner Gateway
- Express library Web site where you can download documentation
for any edition of WebSphere Partner Gateway - Express.
- Install the product, which starts the
installation wizard.
- Exit, which closes the Launchpad window.
-
From the Launchpad, click Install the product.
A Windows InstallShield window opens and shows the status of pre-install
preparation; this can take several minutes. When pre-install preparation
is completed, the InstallShield window closes and the WebSphere
Partner Gateway - Express Welcome window appears.
- Click Next. The Software License Agreement
window appears.
- Click I accept the terms in the license agreement.
Note:
You must accept the terms of the license agreement
to proceed with the installation.
Click Next. The Installation Directory
window appears.
- The path under Directory Name shows where
the WebSphere Partner Gateway - Express software will be installed.
You can change this path if desired by either entering a new path
or clicking the Browse button and specifying
a different path.
Note:
If you change the installation directory, make a
note of the location; you will need that information in a later
step.
- Click Next. The HTTP Port window appears.
The installation wizard detects ports that are currently in use,
then assigns default unused ports for use by WebSphere Partner Gateway
- Express.
The following types of ports are displayed:
- HTTP Port -- The default communications port for normal
communications
- HTTPS1 Port -- The communications port used for secure
(encrypted) communications.
- HTTP2 Port -- A duplicate of the default communications
port for normal communications
- HTTPS2 Port -- A duplicate of the communications port
used for secure (encrypted) communications.
- Bootstrap Port -- A port that is used internally by
WebSphere Partner Gateway to start the embedded version of WebSphere
Application Server
- SOAP Address Port -- A port that is used internally
by WebSphere Partner Gateway to start the embedded version of WebSphere
Application Server
- If the default ports shown will not conflict with other resources
on the computer, accept them. Otherwise, change any default HTTP
ports that might cause a conflict.
Note:
If you specify an HTTP port that is already in use,
the system generates a warning and an Exception when you start the
server. If this occurs, re-install WebSphere Partner Gateway - Express
and choose a different HTTP port.
- Click Next. The Default Folder Name window
appears.
- The Default Folder Name window shows the name of the shortcut
menu folder that WebSphere Partner Gateway - Express will install
on your Start > Programs menu. Either accept the default
name or change it.
- Click Next. The Windows Service Installation
window appears. If you would like to register WebSphere Partner
Gateway - Express as a Windows service, select the Install as a
Windows Service check box.
Note:
You must have administrator privileges in order
to configure WebSphere Partner Gateway - Express to run as a service.
If you do not have administrator privileges, you will see the Administrator
check window. You must click Back and clear
the Install WebSphere as a service check box.
- Click Next. The Summary window appears.
- Review your selections in the Summary window. If you need to
change any of them, click the Back button
to return to the appropriate window, make your changes, and click Next until
you return to the Summary window.
- Click Next. The Installer installs the
WebSphere Partner Gateway - Express software (this can take several
minutes).
Note:
WebSphere Application Server 6.0 is automatically
installed with the WebSphere Partner Gateway - Express product.
- When the installation process is complete, the First Steps application
options window appears, asking whether or not you want to launch
the First Steps application. To learn how to get started with WebSphere
Partner Gateway - Express, select Yes. Otherwise,
click No.
Note:
If you have installed WebSphere Partner Gateway
- Express version 6.0 as an upgrade from a previous version, select No to
avoid starting the First Steps application.
- Click Next. The Installation Confirmation
window appears.
- Click Finish on the installation confirmation
window to complete the installation process. If Yes was
selected in the First Steps Application launch window, the First
Steps application window opens. See Using the First Steps application for information on using this feature.
Note:
On particularly fast PCs, the First Steps window
may open on top of the installation confirmation window before you
have clicked Finish. If this happens, make
the installation confirmation window the current window and click Finish to
close it before proceeding to First Steps.
Performing a silent installation
WebSphere Partner Gateway - Express provides a way to
install the code "silently" using the command
line and is often used as part of a software distribution tool.
A silent installation installs the program without using a GUI (graphical
user interface).
This feature requires an options file that provides values for
all of the installation options and must have the -silent option
enabled. Each option in the file appears on a separate line.
WebSphere Partner Gateway - Express includes a sample file called BCGExpressWindowsInstall.iss.
The sample file is in the express directory
on the CD or archive file. Note that the sample file includes the
-silent option enabled, which means WebSphere Partner Gateway -
Express installs without a GUI if you use the file unmodified. You
can either modify the provided sample file or perform an install using
the GUI and record your choices to create a custom options file.
For information, see Generating an options file.
To install WebSphere Partner Gateway - Express silently:
- Open a command line on the machine on which you want to install
the code.
- Navigate to the location of the installation executable.
- Enter the following command:
setup -options "<options file name>"
where <options file name> identifies
the file that contains the option values the installer will use.
This can be a full-path name.
Generating an options file
To generate an options file with settings specific to
your installation:
- Open a command line on the machine on which you want to install
the code.
- Navigate to the location of the installation executable.
- Enter the following command:
setup -options-record "<options file name>"
where <options file name> identifies
the file to contain the options used in the installation.
The installer runs using the GUI. It installs WebSphere Partner
Gateway - Express and places the given options file in the command
in the install directory. You can then edit this file with any text
editor, or use it without changes to reinstall the product or create duplicate
installs on other machines
Installing with console mode
IBM also provides a command line (console mode) install
program that you can use to install WebSphere WebSphere Partner
Gateway - Express on your computer.
To install WebSphere Partner Gateway - Express:
- Open a command prompt window.
- Navigate to the location of the installation executable.
- Enter the following command at the prompt:
setup -console
