5 Installing Oracle Database Gateway for WebSphere MQ

The following topics guide you through the installation of the Enterprise Edition of Oracle Database Gateway for WebSphere MQ.

Installation

This table guides you through the installation process.

Table 5-1 guides you through the installation process. For each screen, perform the actions described in the Response column.

Table 5-1 Installing Oracle Database Gateway for WebSphere MQ

Oracle Universal Installer Screen Response

Welcome

Click Next.

File Locations

The Source section of the screen is where you specify the source location that Oracle Universal Installer uses to install Oracle Database Gateway for WebSphere MQ. You need not edit the file specification in the Path field - the default setting for this field points to the Oracle Universal Installer file on your Oracle Database Gateway for WebSphere MQ CD-ROM.

The Path field in the Destination section of the File Locations screen is where you specify the destination for your installation. You need not edit the path specification in the Path field. The default setting for this field points to ORACLE_HOME. After you set the fields in the File Locations screen, as necessary, click Next to continue. After loading the necessary information from the CD-ROM, the installer displays the Available Products screen.

Available Products

Select Oracle Database 12.2 and click Next to continue. Oracle Universal Installer displays the Installation Types screen.

Installation Types

Select Custom and click Next to continue. Oracle Universal Installer displays the Available Product Component screen.

Available Product Components

Use the check boxes to indicate the product components that you want to install. By default, all the available components are selected for you. You need to de-select the components that you do not want by clicking on the check boxes. Click Next to continue, and Oracle Universal Installer displays the Where is the WebSphere MQ Queue Manager Installed? screen.

Where is the WebSphere MQ Queue Manager Installed?

Select Local if the MQM runs on the same system as the gateway, or select Remote if the MQM runs on a different system than the gateway. Click Next to continue.

Local WebSphere MQ Queue Manager Name

If you choose Local for your MQM in the Where is the WebSphere MQ Queue Manager Installed? screen, then the Local WebSphere MQ Queue Manager Name screen is displayed. Type in the local WebSphere MQ queue manager name in the Queue Manager field. Click Next to continue, and Oracle Universal Installer displays the Summary screen.

Remote WebSphere MQ Queue Manager Name

If you choose Remote for your MQM in the Local WebSphere MQ Queue Manager Name screen, then the Remote WebSphere MQ Queue Manager Name screen is displayed. Enter the name for the remote WebSphere MQ queue manager in the Queue Manager field, and also enter the WebSphere MQ channel name in the Channel field.

For information about server connection channels, refer to the IBM publication about WebSphere MQ Clients or ask your WebSphere MQ system administrator for the channel definition of the queue manager to which you want the gateway to connect.

The definition syntax is:

CHANNEL_NAME/PROTOCOL/server_address[(port)]

where CHANNEL_NAME and PROTOCOL must be in uppercase, and server_address is the TCP/IP host name of the server. The port value is optional and is the TCP/IP port number on which the server is listening.

If you do not provide a port number, then WebSphere MQ uses the port number that is specified in the QM.INI file. If no value is specified in the QM.INI file, then WebSphere MQ uses the port number that is identified in the TCP/IP services file for the WebSphere MQ services name. If this entry in the services file does not exist, then the default value of 1414 is used. It is important that the port number that is used by the client and the port number that is used by the server listener program be the same.

For example: CHANNEL1/TCP/Sales

Click Next to continue. The Oracle Universal Installer displays the Summary screen.

Oracle Universal Installer Summary

This screen enables you to review a tree list of options and components for this installation. Click Install to display the Installation Status screen.

Installation Status

The Installation Status screen displays the status of the installation as it proceeds, as well as the location of the Oracle Universal Installer log file for this installation session.

Be patient as Oracle Universal Installer processes the software installation. Depending on the CPU, CD-ROM drive, and hard drive on your system, the installation process might take time to complete.

End of Installation

This is the final screen of Oracle Universal Installer in the installation process. Assuming that your installation was successful, click Exit to exit the installer.

Running root.sh on UNIX Based Systems

This topic explains how to run root.sh on UNIX based systems.

After you complete the installation, perform the following steps to run the root.sh script:

  1. Log on as the root user.
  2. Go to the $ORACLE_HOME/dg4mq/admin directory for your WebSphere MQ gateway.
    prompt> cd $ORACLE_HOME/dg4mq/admin
    
  3. Run the root.sh script.
    prompt> ./root.sh
    

    This script enables the WebSphere MQ gateway to operate for the strict security model.

  4. Exit the root account.