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:

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

  2. 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.
  3. Click Next. The Software License Agreement window appears.
  4. 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.

  5. 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.
  6. 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:

  7. 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.
  8. Click Next. The Default Folder Name window appears.
  9. 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.
  10. 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.
  11. Click Next. The Summary window appears.
  12. 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.
  13. 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.
  14. 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.
  15. Click Next. The Installation Confirmation window appears.
  16. 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:

  1. Open a command line on the machine on which you want to install the code.
  2. Navigate to the location of the installation executable.
  3. 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:

  1. Open a command line on the machine on which you want to install the code.
  2. Navigate to the location of the installation executable.
  3. 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:

  1. Open a command prompt window.
  2. Navigate to the location of the installation executable.
  3. Enter the following command at the prompt:
    setup -console 

Copyright IBM Corp. 2003, 2005