4 Preinstallation

4.1.1 WebSphere MQ Software

Perform the following steps to check for WebSphere MQ software:

1. Determine where the WebSphere MQ queue manager is running.

   • Local System

     If the WebSphere MQ queue manager runs on a local system, then the queue manager runs on the same system where you intend to install the gateway product set.

   • Remote System

     If the WebSphere MQ queue manager runs on a remote system, then the queue manager runs on a different system, not the system where you intend to install the gateway product set.

2. Verify that the WebSphere MQ software is already installed. If the WebSphere MQ server software is installed on a different system than the gateway, then the WebSphere MQ client software must be installed on the gateway system.

3. Identify the name of the WebSphere MQ queue manager.

4. Identify the WebSphere MQ client channel definition.

If the queue manager is installed on a different system than the gateway, then the WebSphere MQ client software is used to access the remote queue manager. A channel definition is required for this configuration.

4.1.2 ORACLE_HOME

ORACLE_HOME is the root directory in which Oracle software is installed.

Throughout this book, ORACLE_HOME is used to refer to the home directory of the Procedural Gateway for WebSphere MQ, unless stated otherwise.

4.2.1 oraInventory Directory

The Oracle Universal Installer creates the oraInventory directory the first time that it is run on your system. The oraInventory directory keeps an inventory of the products that the installer installs on your system as well as other installation information. If you have previously installed Oracle products, then you might already have an oraInventory directory.

• The user running the Oracle Universal Installer must have permission to write to the oraInventory directory and all its files. This is required to run the installer.

• The latest log file is C:\Program Files\Oracle\Inventory\logs\installActions.log. Log file names of previous installation sessions are in the following format:

  installActionsdatetime.log.

• Do not delete or manually alter the oraInventory directory or its contents. Doing this can prevent the Oracle Universal Installer from locating the products that you have installed on your system.

4.2.2 Starting Oracle Universal Installer

Perform the following steps to launch Oracle Universal Installer, which installs Oracle Procedural Gateway for WebSphere MQ:

1. Start your system and select MS Windows from the operating system Loader option. Log in to your MS Windows system as a member of the Administrators group.

2. If you are installing the gateway for the first time, ensure there is sufficient space on the disk where you are installing the gateway as specified in the Hardware Requirements.

3. Before installing the software, stop all Oracle NT Services that are running:

   1. From the Start menu, go to Setting, then Control Panel, and then click Services. A list of all NT services is displayed.

   2. Select an Oracle NT service (these services begin with Oracle).

   3. Click Stop.

   4. Continue to select and stop all Oracle NT services until all active Oracle NT Services are stopped.

4. Load the installation media and start the Oracle Universal Installer.

This launches Oracle Universal Installer using which you can install Oracle Procedural Gateway for WebSphere MQ.