This chapter guides you through the basic concepts and preinstallation steps for Oracle Procedural Gateway for WebSphere MQ. It contains the following sections:
Before starting the gateway installation process, perform the actions described in this section for WebSphere MQ and Oracle software.
Perform the following steps to check for WebSphere MQ software:
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.
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.
Identify the name of the WebSphere MQ queue manager.
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.
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.
Caution:
Donot install Oracle Transparent Gateway for DRDA in anORACLE_HOME
directory containing other Oracle products, including the database. Such an installation could overwrite shared components, causing the products to malfunction.Oracle Procedural Gateway for WebSphere MQ uses Oracle Universal Installer to configure environment variables and install components. The installer guides you through each step of the installation process, so you can choose configuration options for a customized product.
The Oracle Universal Installer includes features that perform the following tasks:
Explore and provide installation options for products
Detect pre-set environment variables and configuration settings
Set environment variables and configuration during installation
Uninstall products
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:
installActions
datetime
.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.
Perform the following steps to launch Oracle Universal Installer, which installs Oracle Procedural Gateway for WebSphere MQ:
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.
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.
Before installing the software, stop all Oracle NT Services that are running:
From the Start menu, go to Setting, then Control Panel, and then click Services. A list of all NT services is displayed.
Select an Oracle NT service (these services begin with Oracle).
Click Stop.
Continue to select and stop all Oracle NT services until all active Oracle NT Services are stopped.
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.