5
Installation

Installation

The first screen that is presented by the Oracle Universal Installer is the Welcome screen.  To continue with the installation, click Next.

The next screen to be presented is the File Locations screen, Figure 5-1.

In the File Locations screen (Figure 5-1), the Source section of the screen allows you to specify the source location that the Oracle Universal Installer will use to install Oracle9i PG4MQ.  You should not need to edit the file specification in the Path field - the default setting for this field points to the Oracle Universal Installer file on your Oracle9i PG4MQ CD-ROM.

The Path field in the Destination section of the File Locations screen allows you to specify the destination for your installation.  You should not need to edit the path specification in the Path field because the default setting for this field points to ORACLE_HOME.  After you have 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 will display the Available Products screen, Figure 5-2.

In the Available Products screen (Figure 5-2), select Oracle9i Database 9.2.0.1.0 and click Next to continue.  The Oracle Universal Installer will display the Installation Types screen, Figure 5-3.

In the Installation Types screen (Figure 5-3), select Custom and click Next to continue.  The Oracle Universal Installer will display the Available Product Component screen (Figure 5-4).

In the Available Product Components screen (Figure 5-4), use the check boxes to indicate the available product components that you want to install.  By default, all of 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 the Oracle Universal Installer will display the Where is the MQSeries Queue Manager Installed ? screen, Figure 5-5.

In the Where is the MQSeries Queue Manager Installed ? screen (Figure 5-5), select Local if the MQM runs on the same computer as the gateway, or select Remote if the MQM runs on a different computer than the gateway.  Click Next to continue.

If you chose Local for your MQM in the earlier Oracle Universal Installer screen, then use this Local MQSeries Queue Manger Name screen (Figure 5-6), which is displayed now, and type in the local MQSeries queue manager name in the Queue Manager field.  Click Next to continue and to display the Summary screen.

If you chose Remote for your MQM in the earlier Oracle Universal Installer screen, then the Remote MQSeries Queue Manager Name screen is displayed now.  Enter the name for the remote MQSeries queue manger in the Queue Manager field and also enter the MQSeries channel name in the Channel field.

For information about server connection channels, refer to the IBM publication about MQSeries Clients or ask your MQSeries 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 uppercase, where server_address is the TCP/IP host name of the server, and where (port) is optional and is the TCP/IP port number on which the server is listening.  If you do not provide a port number, then MQSeries uses the port number that is specified in the QM.INI file.  If no value is specified in the QM.INI file, then MQSeries uses the port number that is identified in the TCP/IP services file for the service name MQSeries.  If this entry in the services file does not exist, then a 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 are the same.

For example: CHANNEL1/TCP/Sales

Click Next to continue and to display the Summary screen, Figure 5-8.

The Oracle Universal Installer Summary screen (Figure 5-8) allows you to review a tree list of options and components for this installation.  Click Install to display the Installation Status screen, Figure 5-9.

The Installation Status screen (Figure 5-9) shows 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 the Oracle Universal Installer processes the software installation.  Depending upon the CPU, CD-ROM drive, and hard drive in your computer, the installation process might take quite some time to be completed.

The final screen of the Oracle Universal Installer is the End of Installation screen (Figure 5-10).  Assuming that your installation was successful, you can click Exit to exit the installer.

Running root.sh

After installation is completed, use the following steps to run the root.sh script.

1. Log on as the root user.

2. Go to the $ORACLE_HOME/pg4mqseries/admin directory for your MQ gateway.

   prompt> cd $ORACLE_HOME/pg4mqseries/admin
   

3. Run the root.sh script.

   prompt> ./root.sh
   
   

   This script will allow the MQ gateway to operate for the strict security model.

4. Exit root user.