This chapter provides general information about gateway installation that is specific to this release of the Oracle Transparent Gateway for DRDA. It contains the following sections:
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.
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.
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 installing the gateway, confirm that all hardware and software requirements are met. Refer to Chapter 3, "System Requirements", to verify these requirements.
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:
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.
Response: – Click Next."
Response: – Check that the Destination Path points to your ORACLE_HOME
.
Response: – Select Custom. Click Next.
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.
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.
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.
Your gateway installation is now complete. Proceed with the configuration tasks described in Chapters 5 through 8.
Removing the Oracle Transparent Gateway for DRDA requires the use of the Oracle Universal Installer. To remove the gateway do the following:
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):
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, and then click Remove.