1 Oracle Transparent Gateway Overview

This chapter describes the installation of Oracle Transparent Gateways as well as issues that you should consider before installing the software. It includes information about the following topics:

Gateway Installation Configurations
Gateway Installation Methods
Installation Considerations
Upgrades
Accessing the Installation Software
Running the Oracle Universal Installer

1.1 Gateway Installation Configurations

You can install Oracle Transparent Gateway in either of the following configurations:

On the same computer as an existing Oracle Server but in a different Oracle home.
On a system with no Oracle Server.
On the same computer as the Oracle Server, and in the same Oracle home directory. Note that in this case, the Oracle Server and the gateway must be at the same release level.

1.2 Gateway Installation Methods

You can choose different installation methods to install Oracle Transparent Gateways, as follows:

Interactive Installation Methods
Automated Installation Methods Using Response Files

1.2.1 Interactive Installation Methods

When you use the interactive method to install Oracle Transparent Gateways, Oracle Universal Installer displays a series of screens that enable you to specify all of the required information to install the Oracle Database software and optionally create a database.

1.2.2 Automated Installation Methods Using Response Files

By creating a response file and specifying this file when you start Oracle Universal Installer, you can automate some or all of the Oracle Transparent Gateway installation. These automated installation methods are useful if you need to perform multiple installations on similarly configured systems or if the system where you want to install the software does not have X Window system software installed.

When you use a response file, you can run Oracle Universal Installer in the following modes, depending on whether you specify all of the required information or not:

Silent Mode: Oracle Universal Installer runs in silent mode if you use a response file that specifies all required information. None of the Oracle Universal Installer screens are displayed.

Suppressed Mode: Oracle Universal Installer runs in suppressed mode if you do not specify all required information in the response file. Oracle Universal Installer displays only the screens that prompt for the information that you did not specify.

For more information about these modes and about how to complete an installation using response files, refer to Appendix A.

1.3 Installation Considerations

This section contains information that you should consider before installing this product. It contains the following sections:

Read the Release Notes
Hardware and Software Certification
Multiple Oracle Homes

1.3.1 Read the Release Notes

Read the release notes for the product before installing it. The release notes are available on the Oracle Database 10g 10g Release 2 (10.2) installation media. The latest version of the release notes is also available on the OTN Web site:

http://www.oracle.com/technology/documentation/

1.3.2 Hardware and Software Certification

The platform-specific hardware and software requirements included in this installation guide were current at the time this guide was published. However, because new platforms and operating system software versions might be certified after this guide is published, review the certification matrix on the OracleMetaLink Web site for the most up-to-date list of certified hardware platforms and operating system versions. The OracleMetaLink Web site is available at the following Web site:

http://metalink.oracle.com

If you do not have a current Oracle Support Services contract, you can access the same information at the following Web site:

http://www.oracle.com/technology/support/metalink/content.html

1.3.3 Multiple Oracle Homes

This product supports multiple Oracle homes. This means that you can install this release or previous releases of the software more than once on the same system, in different Oracle home directories.

1.3.3.1 Installing the Software on a System with an Existing Oracle Installation

You must install this product into a new Oracle home directory. You cannot install products from one release of Oracle Database into an Oracle home directory of a different release. For example, you cannot install release 10.1 software into an existing Oracle9i Oracle home directory. If you attempt to install this release into an Oracle home directory that contains software from an earlier Oracle release, the installation fails.

You can install this release more than once on the same system if each installation is installed in a separate Oracle home directory.

1.4 Upgrades

Upgrades are not supported for Oracle Transparent Gateways.

1.5 Accessing the Installation Software

You can access and install Transparent Gateway by using one of the following methods:

Copy the software to a hard disk. Refer to Copying the Oracle Software to a Hard Disk
Download the software from OTN. Refer to Downloading Oracle Software from the OTN Web Site .

1.5.1 Copying the Oracle Software to a Hard Disk

Before installing Oracle Transparent Gateway, you might want to copy the software to the hard disk. This enables the installation process to run a bit faster. Before copying the installation media content to the hard disk, you must mount the installation media. The following section describes how to mount discs and copy their content to the hard disk.

1.5.1.1 Mounting Disc

On most Solaris systems, the disc mounts automatically when you insert it into the disc drive. If the disc does not mount automatically, follow these steps to mount it:

Switch user to root
```
$ su - root
```
If necessary, enter a command similar to one of the following to eject the currently mounted disc, then remove it from the drive:

Solaris:
```
# eject
```
AIX:
```
# umount /cdrom
```
hp-ux:
```
# /usr/sbin/umount /SD_CDROM
```
Tru64 UNIX:
```
# /usr/sbin/umount /cdrom
```
In these examples, /cdrom and /SD_CDROM are the mount point directories for the disc drive.
Insert the appropriate disc into the disc drive.
To verify that the disc mounted automatically, enter a command similar to the following depending on your platform:

Solaris:
```
# ls /cdrom/cdrom0
```
If this command fails to display the contents of the disc, enter a command similar to the following to mount it, depending on your platform:

Solaris:
```
# /usr/sbin/mount -r -F hsfs /dev/dsk/cxtydzs2 /cdrom
```
In this example, /cdrom is the disc mount point directory and /dev/dsk/cxtydzs2 is the device name for the disc device, for example /dev/dsk/c0t2d0s2.
If Oracle Universal Installer is displaying the Disk Location dialog box, enter the disc mount point directory path, for example:
```
/mnt/cdrom
```

1.5.1.2 Copying the Oracle Transparent Gateway Software to a Hard Disk

To copy the contents of the disc to a hard disk:

Create a directory on the hard disk to hold the Oracle software:
```
$ mkdir Ora10g
```
Change directory to the directory you created in step 1:
```
$ cd Ora10g
```
Create subdirectories for each installation disc with names similar to the following, where n is the disc number:
```
$ mkdir Diskn
```
Copy the contents of the mounted disc to the corresponding new subdirectory as follows:
```
$ cp -R /directory_path Diskn
```
In this example, n is the disc number and /directory_path is the installation media mount point directory. The mount point directory is /cdrom.
If necessary, mount the next disc and repeat step 5.

1.5.2 Downloading Oracle Software from the OTN Web Site

This section describes how to download the installation archive files and extract them on your hard disk. It contains the following topics:

Downloading the Installation Archive Files
Extracting the Installation Files

1.5.2.1 Downloading the Installation Archive Files

To download the installation archive files from OTN:

Use any browser to access the software download page on OTN:
```
http://www.oracle.com/technology/software/
```
Navigate to the download page for the product that you want to install.
On the download page, identify the required disk space by adding the file sizes for each required file.

The file sizes are listed next to the file names.
Select a file system with enough free space to store and expand the archive files.

In most cases, the available disk space must be at least twice the size of all of the archive files.
On the file system that you selected in step 4, create a parent directory for each product, for example , TG4SYBS, to hold the installation directories.
Download all of the installation archive files to the directory that you created in step 5.
Verify that the files you downloaded are the same size as the corresponding files on OTN.

1.5.2.2 Extracting the Installation Files

To extract the installation archive files, perform the following steps:

If necessary, change directory to the directory that contains the downloaded installation archive files.
To uncompress each file, enter a command similar to the following:
```
$ gunzip filename.cpio.gz
```
This command creates files with names similar to the following:
```
filename.cpio
```
To extract the installation files, enter a command similar to the following:
```
$ cpio -idmv < filename.cpio
```
Note:
Refer to the download page for information about the correct options to use with the cpio command.
Some browsers uncompress files while downloading them, but leave the .gz file extension. If these steps do not work, remove the .gz extension from the files and repeat step 3.

For each file, this command creates a subdirectory named Diskn, where n is either 1 or the disk number identified in the file name.

1.6 Running the Oracle Universal Installer

Start the Installer and install the software, as follows:

If you are installing the software from disc, mount the appropriate disc if it is not already mounted

Some platforms automatically mount discs when you insert them into the drive.
If necessary, log in as the Oracle software owner user (oracle) and set the DISPLAY environment variable.
To start the Installer, enter the following commands where directory_path is the CD-ROM mount point directory or the path of the tg directory on the DVD-ROM.
```
$ /directory_path/runInstaller
```
Use the following guidelines to complete the installation:
- Follow the instruction displayed in the Installer window. If you need additional information, click Help.
- When the Installer prompts you to run a script with root privileges, enter a command similar to the following in a terminal where you are logged in as the root user, then click Continue or OK:
```
# /script_path/script_name
```
- On Tru64 UNIX, when prompted for the JDK home directory specify the location of JDK 1.4.2 on your system.
  
  To determine the JDK home directory, enter the following command:
```
# /usr/sbin/setld -i JAVA142 | more
```
  The default location is /usr/opt/java142.
  
  Caution:
  The Oracle Universal Installer automatically installs the Oracle-supplied version of the Java Runtime Environment (JRE). This version is required to run Oracle Universal Installer and several Oracle assistants. Do not modify the JRE except by using a patch provided by Oracle Support Services.
- If you encounter errors while installing or linking the software, then see Appendix B for information about troubleshooting.
When all of the configuration tools have finished, click Exit, then click Yes to exit from the Installer.