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.
- 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:
- 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.
- Check prerequisites, which starts the
prerequisite checking wizard.
- Install the product, which starts the
installation wizard.
- Exit, which closes the Launchpad window.
- From the Launchpad, click Check Prerequisites. The "Sign on
to the Server" window appears.
- 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.
- 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:
- 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:
- 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.
- Check prerequisites, which starts the
prerequisite checking wizard.
- Install the product, which starts the
installation wizard.
- Exit, which closes the Launchpad window.
- From the Launchpad, click Install the product.
The Sign on to the Server window appears.
-
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.
- Click Next. The Software License Agreement
window appears.
- Select 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 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
- SOAP Address Port -- A port that is used internally
by WebSphere Partner Gateway
- 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 Installer installs the
WebSphere Partner Gateway - Express software (this can take several
minutes).
- 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.
- 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:
- Edit the BCGExpressInstall.iss options file to specify the required port numbers.
- Open a command line on the PC from which you want to install
the code.
- Navigate to the location of the installation executable.
- 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:
- Open a command line on the PC from which you want to install
the code.
- Navigate to the location of the installation executable.
- 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:
- Open a command prompt window on your PC.
- Navigate to the location of the installation executable.
- Enter the following command at the prompt:
Setup -console
