Installing WebSphere Partner Gateway - Express on a system running i5/OS or OS/400

Prior to installing WebSphere Partner Gateway - Express on a system running i5/OS or OS/400, you must confirm that you have the necessary prerequisite software installed. See Confirming prerequisites.

There are three ways to install WebSphere Partner Gateway - Express on a system running i5/OS or OS/400:

Confirming prerequisites

The following steps describe how to confirm that you have the necessary prerequisite software installed on your system running i5/OS or OS/400.

  1. Insert the WebSphere Partner Gateway - Express 6.0 CD-ROM into the CD-ROM drive on the Windows PC that is connected to the system running i5/OS or OS/400. The Launchpad window opens.
    Note:
    If the Launchpad does not start automatically, you can start it manually by navigating to the "express" folder and double-clicking Launchpad.bat.

    The Launchpad window offers the following six options:
  2. From the Launchpad, click Check Prerequisites. The "Sign on to the Server" window appears.
  3. In the System field, enter a host name of the system running i5/OS or OS/400 on which you are installing WebSphere Partner Gateway - Express. In the User ID and Password fields, enter the i5/OS or OS/400 User ID and password that has ALLOBJ (All Object) authority on the system running i5/OS or OS/400, then click OK.
  4. The Check Prerequisites wizard verifies that you have the required prerequisites and informs you if you are missing any software prerequisites.
    Note:
    If you are missing WebSphere Application Server for OS/400 V6, the wizard offers to perform a silent installation using the WebSphere Application Server for OS/400 V6 installation CD included in the installation package.

Using the graphical installer for systems running i5/OS or OS/400

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 the Windows PC that is connected to the system running i5/OS or OS/400. The Launchpad window opens.
    Note 1:
    If the Launchpad does not start automatically, you can start it manually by navigating to the express folder and double-clicking Launchpad.bat .
    Note 2:
    Alternatively, if you want to bypass the Launchpad, you can start the installer by navigating to the express folder and double-clicking setup.exe -os400. If you do this, the Sign on to the Server window appears. Proceed to 3.
    Caution:
    If you omit the -os400 parameter in the setup.exe -os400 command, the installation will occur on the Windows machine.

    The Launchpad window offers six options:

  2. From the Launchpad, click Install the product.

    The Sign on to the Server window appears.

  3. In the System field, enter the host name of the system running i5/OS or OS/400 on which you are installing WebSphere Partner Gateway - Express. In the User ID and Password fields, enter the i5/OS or OS/400 User ID and password that has ALLOBJ (All Object) authority on the system running i5/OS or OS/400, then click OK.

    The Welcome window appears.

  4. Click Next. The Software License Agreement window appears.
  5. Select I accept the terms in the license agreement.
    Note:
    You must accept the terms of the license agreement to proceed with the installation.
  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 Installer installs the WebSphere Partner Gateway - Express software (this can take several minutes).
  9. 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.
  10. Click Next. The Installation Confirmation window appears.
  11. 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.
  12. Is this installation part of an upgrade from WebSphere Business Integration Connect - Express version 4.2.1 to WebSphere Partner Gateway - Express version 6.0?

    If Yes, go to step 5 to complete the upgrade process.

    If No, the installation process is complete.

Performing a silent installation

WebSphere Partner Gateway - Express provides a way to install the code "silently" from a PC using the command line. A silent installation installs the program without using a GUI. This feature requires an options file that provides values for all of the installation options. Each option in the file appears on a separate line.

WebSphere Partner Gateway - Express includes a sample file called BCGExpressInstall.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 on generating an options file, see Generating an options file.

To install WebSphere Partner Gateway - Express silently:

  1. Edit the BCGExpressInstall.iss options file to specify the required port numbers.
  2. Open a command line on the PC from which you want to install the code.
  3. Navigate to the location of the installation executable.
  4. Enter the following command:

    setup <System> <User_ID> <Password> -options <options file name> -silent

    where <System> is the host name of the system running i5/OS or OS/400, <User_ID> is an i5/OS or OS/400 User ID with ALLOBJ (All Object) authority, <Password> is the password for the User ID, and <options file name> identifies the file that contains the option values the installer will use.

Generating an options file

To generate an options file with settings specific to your installation:

  1. Open a command line on the PC from which you want to install the code.
  2. Navigate to the location of the installation executable.
  3. Enter the following command:
    setup.exe <System> <User_ID> <Password> -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 Partner Gateway - Express from a PC on your computer.

To install WebSphere Partner Gateway - Express:

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

Copyright IBM Corp. 2003, 2005