4
Installing the Gateway

This chapter provides general information about gateway installation that is specific to this release of the Oracle Transparent Gateway for IBM DRDA. It contains the following sections:

Introduction

The complete Oracle Transparent Gateway for IBM DRDA installation process is divided into installation and configuration tasks. This process is described in Chapters 4 through 8. If this is the first time the gateway has been installed on your RS/6000 host, then you must perform all of the steps 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

An Installation Checklist follows, which you can use to check off each completed step in the process.

Before You Begin

This chapter requires you to input parameters unique to your system in order to properly configure the gateway. Refer to Appendix E, "Configuration Worksheet" for a worksheet listing all the installation parameters you will need to know 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:

Note:

Ensure that the caths.sql script has been run on the Oracle database server before starting the gateway. You can verify that this has been done by doing the following:

Use SQL*Plus to connect to the integrating server as user SYS.
Issue the following statement from SQL*Plus:
```
   DESCRIBE HS_FDS_INST
```

If the DESCRIBE statement is successful, then it is an indication that caths.sql has been run for the database server. If it is not, then you must run the caths.sql script first.

Installation Overview

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

For general information about installing Oracle products, and how to use the Oracle Universal Installer, refer to the Oracle9i Installation Guide Release 1 (9.0.1) 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 gateway is completely self-contained and must be installed in its own directory.

Step 1: Login as the Oracle database administrator (DBA) user

If you are not currently a DBA user, then contact your system administrator to create a DBA login user ID. Refer to the preinstallation chapter in the Oracle9i Installation Guide Release 1 (9.0.1) for UNIX Systems.

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/9.0.1
$ chown oracle:dba /oracle/tg4drda/9.0.1
$ chmod 755 /oracle/tg4drda/9.0.1

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/9.0.1; export ORACLE_HOME

If you are a C shell user, then enter:

$ setenv ORACLE_HOME /oracle/tg4drda/9.0.1

Step 4: Mount the CD-ROM

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

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

Step 5: Set DISPLAY Variable

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

$ DISPLAY=hostname:0
  export DISPLAY

If you are a C shell user, then enter:

$ setenv DISPLAY host:0

Step 6: Start the Oracle Universal Installer

The Oracle Universal Installer Version 2.0.1.4.0 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 Oracle9i Installation Guide Release 1 (9.0.1) for UNIX Systems.

Start the Installer with the following command:
```
$ ./runInstaller
```
A window will appear with the question: "Has the rootpre.sh script been run by root?" Before you proceed with the installation, this script must have been run on the install computer for the gateway.

If you have already run this script (either during a previous installation of this version of the gateway or during an installation of the Oracle9i server), then enter "Y" and continue following the prompts of the Oracle Universal Installer. Otherwise, perform the next step.
If the rootpre.sh script has not yet been run, enter "N" and perfom the following:
1. Log on as the root user
2. Go to the install directory on the CD
3. Run the rootpre.sh script:
```
$ ./rootpre.sh
```
4. Exit root user
5. Restart the Oracle Universal Installer

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 table as a guide to the installation. The left column lists the prompts that Oracle Universal Installer offers; respond to the prompts by implementing the actions listed in the corresponding "Response" column on the right.

Table 4-1 Steps to Install the Gateway Using the Oracle Universal Installer* (2 columns, 1 header row, 8 body rows)*

Prompt	Response
Welcome	Click "Next".
File Locations: "Source and Destination"	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".
Oracle Transparent Gateway for IBM DRDA Available Products Components	Select the "Oracle Transparent Gateway for IBM DRDA" product in the components list. Click "Next".
Oracle Transparent Gateway for IBM DRDA	Click "Next".
Choose the Network Interface	Select "TCP/IP" or "SNA" for the network interface used by the gateway to communicate to remote DRDA servers. Click "Next".
IF YOU CHOSE "SNA", the following prompt appears in the "SNA Network Software" panel: Choose the SNA Software	Select the SNA software supported. Click "Next".
Summary	Verify the products to be installed. Click "Next".
The installation of the Oracle Transparent Gateway for IBM DRDA was successful	You may install additional products by clicking the "Next Install" button. When finished installing products, click "Exit".

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_HOME/install directory. The default file name is install.log.

Installation Complete

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

De-installing the Gateway

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

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, 5 and 6 of the installation startup process):
When the "Welcome" panel appears, click the "Deinstall Products" button.
In the list of installed products, select the Gateway product and any other products you wish to remove, then click "Remove."

4 Installing the Gateway