4
Pre-installation

MQSeries Software

1. Determine where the MQSeries queue manager is running.

   • Local Machine

     If the MQSeries queue manager is running on a local machine, then the queue manager is running on the same machine where you intend to install the gateway product set.

   • Remote Machine

     If the MQSeries queue manager is running on a remote machine, then the queue manager is running on a different machine, not the machine where you intend to install the gateway product set.

2. Verify that the MQSeries software is already installed.  If the MQSeries server software resides on a different machine than the gateway, then the MQSeries client software must be installed on the gateway machine.

3. Identify the name of the MQSeries queue manager.

4. Identify the MQSeries client channel definition.

If the queue manager resides on a different machine than the gateway, then the MQSeries client software is used to access the remote queue manager.  A channel definition is required for this configuration.

Setting Environment Variables

Before installing Oracle9i Procedural Gateway for IBM MQSeries on UNIX platforms, the following environment variables must be set:

• ORACLE_HOME

• ORACLE_SID

• DISPLAY

• TMP

  
  

  Note: Verify that the values that you assign to the environment variables, which are listed in this section, are less than 42 characters long.  Longer values might generate errors such as ÒWord too longÓ during installation.

  
  

oraInventory Directory

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

• When a UNIX group name is specified, it grants that group the permission to write to the oraInventory directory.  If another group attempts to run the Oracle Universal Installer, then they must have permission to write to the oraInventory directory.  If they do not have permission the installation will fail.

• Be sure the user running the Oracle Universal Installer has permission to write to the oraInventory directory and all its files.  This is required to run the installer.

• The location of oraInventory is defined in /etc/oratab/oraInst.loc for HP 9000 Series HP-UX and AIX-Based Systems. 

• The location of oraInventory is defined in /var/opt/oraInst.loc for Sun Solaris.

• The latest log file is oraInventory_location/logs/installActions.log.  Log file names of previous installation sessions take the form installActionsdatetime.log.

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

Starting Oracle Universal Installer

Perform the following steps to launch Oracle Universal Installer, which installs Oracle9i Procedural Gateway for IBM MQSeries:

1. Stop all Oracle processes and services (for example, the Oracle database).

2. Mount the installation CD-ROM.

   The Oracle Product Installation CD-ROM is in RockRidge format.  To begin installation, insert the CD.

   To manually mount or unmount the CD-ROM, you must have root privileges.  Unmount the CD-ROM before removing it from the drive.

   To manually mount the CD-ROM, perform the following tasks:

   1. Insert the Oracle9i Procedural Gateway for IBM MQSeries CD-ROM into the CD-ROM drive.

   2. Log in as the root user.

   3. Create the CD-ROM mount point directory.

      prompt> mkdir <mount_point>
      
      

   4. Mount the CD-ROM drive on the mount point directory and exit the root account:

      prompt> mount options <device_name> <mount_point>
      prompt> exit
      
      

   The following examples show how to mount the CD-ROM manually on /cdrom:

   Platform	Command Example
   AIX-Based Systems	prompt> mkdir /cdrom prompt> mount -o ro -V cdrfs <device_name> /mnt/cdrom prompt> exit
   HP 9000 Series HP-UX	Note: Add the following line to the /etc/pfs_fstab file: /dev/dsk/c5t2d0./cdrom pfs-rrip xlat=unix 0 0 where /dev/dsk/c5t2d0 is the CD-ROM device file and pfs-rripxlat=unix 0 0 indicates the CD-ROM is in Rockridge extention. prompt> nohup /usr/sbin/pfs_mountd & prompt> nohup /usr/sbin/pfsd & Note: Insert CD-ROM in tray. prompt> /usr/sbin/pfs_mount /cdrom prompt> exit
   Sun Solaris	prompt> mkdir /cdrom prompt> mount -r -F hsfs <device_name> /cdrom prompt> exit

   
   

   Note: For AIX-Based System users only. Before installing the gateways from the CD-ROM, become root and run rootpre.sh. Log in as root and change directory to the CD-ROM mount point. prompt> su root prompt> cd <mount_point> Run rootpre.sh and exit root account. prompt> ./rootpre.sh prompt> exit

   
   

3. Run Oracle Universal Installer from the CD-ROM.

   
   

   Note: Be sure you are not logged in as the root user when you start the Oracle Universal Installer.  If you are, then only the root user will have permissions to manage Oracle9i Procedural Gateway for IBM MQSeries.

   
   

   1. Log in as the Oracle9i Procedural Gateway for IBM MQSeries user.

   2. Start the Oracle Universal Installer by entering:

      prompt> <mount_point>/runInstaller
      
      

This launches Oracle Universal Installer through which you can install Oracle9i Procedural Gateway for IBM MQSeries.