4 Installing the Gateway

Introduction

The complete Oracle Transparent Gateway for DRDA installation process is divided into installation and configuration tasks. This process is described in Chapters 4 through 12. If this is the first time that the gateway has been installed on your host, then you must perform all of the steps that are documented in these chapters.

The installation tasks include:

• Ensuring that your hardware and software requirements are met

• Loading and installing the gateway software from the distribution medium into your system

• Determining your gateway system identifier

• Reconfiguring your network

Yu can use the checklist in Checklist for Gateway Installation to check each completed step in the process.

Before You Begin

This chapter requires you to set parameters that are unique to your system in order to properly configure the gateway. Refer to Appendix E, "Configuration Worksheet", for a worksheet listing all of the installation parameters that you will need to know in order to complete the configuration process. Ask your network administrator to provide these parameters before you begin.

You will also need to confirm that all hardware and software requirements have been met. Refer to Chapter 3, "System Requirements", to verify these requirements.

Checklist for Gateway Installation

Use the following checklist for installing the gateway:

• Step 1: Log on to the host

• Step 2: Create the Product Installation Directory

• Step 3: Set the ORACLE_HOME environment variable

• Step 4: Mount the Installation Media

• Step 5: Set the DISPLAY Variable

• Step 6: Start the Oracle Universal Installer

• Step 7: Step through the Oracle Universal Installer

• Step 8: Verify installation success

Installation Overview

The primary installation tasks assume that you configure the gateway with a single Oracle integrating server and a single DRDA database. The steps for expanding the configuration to multiple integrating servers and multiple DRDA databases are described in Chapter 11, "Configuring the Gateway".

For general information about installing Oracle products, and how to use the Oracle Universal Installer, refer to the Oracle Database Installation Guide 10g for UNIX Systems.

Before Beginning Installation

Before installing the gateway, confirm that all hardware and software requirements are met. Refer to Chapter 3, "System Requirements", to verify these requirements.

Installing the Gateway from CD-ROM

The Oracle Transparent Gateway for DRDA is completely self-contained and must be installed in its own directory. The following are the steps that are required to install the gateway:

Step 1: Log on to the host

Log on to your host as the database administrator (DBA) user. Refer to your platform release notes.

Step 2: Create the Product Installation Directory

When you create a new directory, we recommend that you use the version number as part of the pathname. Doing so allows different versions of the same Oracle product to be installed under one Oracle directory tree. The product installation directory is also known as the Oracle home for the gateway, and it has also been called the tg4drda directory.

For example, enter:

$ mkdir /oracle
$ mkdir /oracle/tg4drda
$ mkdir /oracle/tg4drda/10.2.0
$ chown oracle:dba /oracle/tg4drda/10.2.0
$ chmod 755 /oracle/tg4drda/10.2.0

Step 3: Set the ORACLE_HOME environment variable

ORACLE_HOME must point to the directory that you created in Step 2. Set the ORACLE_HOME environment variable to point to this directory. The command that you enter depends on the shell that you are using.

For example, if you are a Bourne or Korn shell user, then enter:

$ ORACLE_HOME=/oracle/tg4drda/10.2.0; export ORACLE_HOME

If you are a C shell user, then enter:

$ setenv ORACLE_HOME /oracle/tg4drda/10.2.0

Step 4: Mount the Installation Media

Place the installation media and follow the steps as per your operating system:

• Step 4a: on Solaris

  Most Solaris installations will have the auto-mounter running, in which case the installation media will be mounted automatically. Typically the mount point will be /cdrom. To manually mount the installation media, enter:

  $ su root
  # mkdir /cdrom
  # mount -r -F hsfs /dev/dsk/c0t6d0s0 /cdrom
  # exit
  $ cd /cdrom
  
  

• Step 4b: on AIX, to mount the installation media enter:

  $ su root
  # mkdir /cdrom
  # mount -rv cdrfs /dev/cd0 /cdrom
  # exit
  $ cd /cdrom
  
  

• Step 4c: on hp-ux,to mount the installation media enter:

  $ su root
  # nohup /usr/sbin/pfs_mountd &
  # nohup /usr/sbin/pfsd &
  # /usr/sbin/pfs_mount /SD_CDROM
  # exit
  $ cd /cdrom
  
  

• Step 4d: on Linux, to mount the installation media enter:

  $ su root
  # mkdir /cdrom
  # mount /dev/hdb /cdrom
  # exit
  $ cd /cdrom
  

Step 5: Set the DISPLAY Variable

For example, if you are using a Bourne or Korn shell, then enter:

$ DISPLAY=machine:0; export DISPLAY

If you are using a C shell, then enter:

$ setenv DISPLAY machine:0

Step 6: Start the Oracle Universal Installer

The Oracle Universal Installer is provided on the distribution CD-ROM with the gateway. If you are installing over an older gateway instance, then you must upgrade the Oracle Universal Installer to this version by selecting the new Oracle Universal Installer from the Available Products menu.

For general information about installing Oracle products and how to use the Oracle Universal Installer, refer to the Oracle Database Installation Guide 10g for UNIX Systems.

Start the Installer with the following command:

$ ./runInstaller

Step 7: Step through the Oracle Universal Installer

Oracle Universal Installer is a menu-driven utility that guides you through installing the gateway by prompting you with action items. The action items and the sequence in which they appear depend on your platform. Use the following list as a guide to the installation. The prompts that Oracle Universal Installer offers are listed in bold face font. Respond to the prompts by implementing the responses that follow the prompts.

Prompt: – Welcome

Response: – Click Next."

Prompt: – Specify Home Details

Response: – Check that the Destination Path points to your ORACLE_HOME.

Prompt: – Installation Types

Response: – Select Custom. Click Next.

Prompt: – Available Products Components

Response: – Open the Oracle Transparent gateways product group and select Oracle Transparent Gateway for DRDA. Open the Oracle Transparent gateway for DRDA product group, if not already open, and select one protocol from the list of supported protocols. Remove selection from everything else for a standalone gateway installation. Click Next.

Prompt: – DRDA Network Interface Product Software

Response: – If the SNA protocol was selected, choose the network interface software appropriate for this installation of the gateway. Click Next. If the SNA protocol was not selected, this panel does not appear.

Prompt: – Summary

Response: – Verify the products to be installed. Click Next.

Step 8: Verify installation success

After the Oracle Universal Installer confirms that the installation has ended, verify that the installation was successful. To do this, check the contents of the installation log file, located in the Oracle inventorys log directory. The default file name is installActions<DATE>.log.

Ignore the instruction to run the root.sh script, if applicable.

Installation Complete

Your gateway installation is now complete. Proceed with the configuration tasks described in Chapters 5 through 8.

Removing the Gateway

Removing the Oracle Transparent Gateway for DRDA requires the use of the Oracle Universal Installer. To remove the gateway do the following:

1. To restart the Oracle Universal Installer, refer to the installation process followed earlier in this chapter in "Installing the Gateway from CD-ROM" , and repeat the following steps (steps 1, 3, 4, and 6 of the installation startup process):

   • Step 1: Log on to the host

   • Step 3: Set the ORACLE_HOME environment variable

   • Step 4: Mount the Installation Media

   • Step 6: Start the Oracle Universal Installer

2. When the Welcome panel appears, click the Deinstall Products button.

3. In the list of installed products, select the gateway product and any other products you wish to remove, and then click Remove.