4 Installing the Gateway

Step 1: Log on to the host

Log on to your host as the Oracle 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.1.0
$ chown oracle:dba /oracle/tg4drda/10.1.0
$ chmod 755 /oracle/tg4drda/10.1.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.1.0; export ORACLE_HOME

If you are a C shell user, then enter:

$ setenv ORACLE_HOME /oracle/tg4drda/10.1.0

Step 4: Mount the CD-ROM

Place the CD-ROM in your CD-ROM drive:

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

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

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

$ 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 a C shell user, 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: – File Locations: "Source and Destination"

Response: – Check that the Source Path points to the stage/products.jar file in the path of the mounted CD-ROM. Check that the Destination Path points to your ORACLE_HOME. Click "Next"."

Prompt: – Available Products

Response: – Select "Oracle 10i Database". Click "Next".

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". Remove selection from everything else for a standalone gateway installation. Click "Next".

Prompt: – Optional JDK home prompt

Response: – Click "Next".

Prompt: – DRDA Network Interface Product Software

Response: – Choose the network interface software appropriate for this installation of the gateway. Click "Next".

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 inventory’s log directory. The default file name is installActions<DATE>.log.

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

De-installing the Gateway

De-installing the Oracle Transparent Gateway for DRDA requires the use of the Oracle Universal Installer. Follow the procedures below to de-install the gateway.

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):

   1. Step 1: Log on to the host

   2. Step 3: Set the ORACLE_HOME environment variable

   3. Step 4: Mount the CD-ROM

   4. 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, then click "Remove."