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

• Before You Begin

• Checklist for Gateway Installation

• Installation Overview

• Verify SNA Library Install Paths

• Installing the Gateway from CD-ROM

• Installation Complete

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

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

Step 2: Create the product installation directory

Step 3: Set the ORACLE_HOME environment variable

Step 4: Mount the CD-ROM

Step 5: Start the Oracle Universal Installer

Step 6: Step through the Oracle Universal Installer

Step 7: Verify installation success

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. Otherwise, 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 for Sun SPARC Solaris 2.x.

Verify SNA Library Install Paths

Before you can begin installation, the gateway requires that you already have SunLink SNA Peer-to-Peer software installed. The Oracle installation process assumes that the SunLink SNA Peer-to-Peer libraries are installed at the path:

• /opt/SUNWlu62, for Version 9.0, or

• /opt/SUNWappc, for Version 9.0 with CPI-C/APPC support.

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 for Sun SPARC Solaris 2.x.

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 you created in Step 2. Set the ORACLE_HOME environment variable to point to this directory. The command you enter depends on the shell 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:

$ cd /cdrom/tg4drda

Step 5: 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 for Sun SPARC Solaris 2.x.

Start the Installer with the following command:

$ ./runInstaller

Step 6: 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

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

Ignore the instruction to run the root.sh script.

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.

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 5 of the installation startup process):

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

3. Step 3: Set the ORACLE_HOME environment variable

4. Step 4: Mount the CD-ROM

5. Step 5: 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."