Oracle® Transparent Gateway

Installation Guide

10g Release 2 (10.2) for Solaris Operating System, hp-ux, IBM AIX, and hp Tru64 UNIX

B19084-01

June 2005

Oracle Transparent Gateway Installation Guide, 10g Release 2 (10.2) for Solaris Operating System, hp-ux, IBM AIX, and hp Tru64 UNIX

B19084-01

Copyright © 2005, Oracle. All rights reserved.

Primary Author:  Maitreyee Chaliha

Contributing Author:  Vira Goorah

The Programs (which include both the software and documentation) contain proprietary information; they are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright, patent, and other intellectual and industrial property laws. Reverse engineering, disassembly, or decompilation of the Programs, except to the extent required to obtain interoperability with other independently created software or as specified by law, is prohibited.

The information contained in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. This document is not warranted to be error-free. Except as may be expressly permitted in your license agreement for these Programs, no part of these Programs may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose.

If the Programs are delivered to the United States Government or anyone licensing or using the Programs on behalf of the United States Government, the following notice is applicable:

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the Programs, including documentation and technical data, shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement, and, to the extent applicable, the additional rights set forth in FAR 52.227-19, Commercial Computer Software--Restricted Rights (June 1987). Oracle Corporation, 500 Oracle Parkway, Redwood City, CA 94065

The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently dangerous applications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup, redundancy and other measures to ensure the safe use of such applications if the Programs are used for such purposes, and we disclaim liability for any damages caused by such use of the Programs.

Oracle, JD Edwards, PeopleSoft, and Retek are registered trademarks of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

The Programs may provide links to Web sites and access to content, products, and services from third parties. Oracle is not responsible for the availability of, or any content provided on, third-party Web sites. You bear all risks associated with the use of such content. If you choose to purchase any products or services from a third party, the relationship is directly between you and the third party. Oracle is not responsible for: (a) the quality of third-party products or services; or (b) fulfilling any of the terms of the agreement with the third party, including delivery of products or services and warranty obligations related to purchased products or services. Oracle is not responsible for any loss or damage of any sort that you may incur from dealing with any third party.

Contents

List of Tables

Title and Copyright Information

Send Us Your Comments

Preface

Intended Audience

Documentation Accessibility

Structure

Related Documents

Typographic Conventions

1 Oracle Transparent Gateway Overview

1.1 Gateway Installation Configurations

1.2 Gateway Installation Methods

1.2.1 Interactive Installation Methods

1.2.2 Automated Installation Methods Using Response Files

1.3 Installation Considerations

1.3.1 Read the Release Notes

1.3.2 Hardware and Software Certification

1.3.3 Multiple Oracle Homes

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

1.4 Upgrades 1.5 Accessing the Installation Software

1.5.1 Copying the Oracle Software to a Hard Disk

1.5.1.1 Mounting Disc

1.5.1.2 Copying the Oracle Transparent Gateway Software to a Hard Disk

1.5.2 Downloading Oracle Software from the OTN Web Site

1.5.2.1 Downloading the Installation Archive Files

1.5.2.2 Extracting the Installation Files

1.6 Running the Oracle Universal Installer
2 Installing Oracle Transparent Gateway for Sybase

2.1 Hardware Requirements

2.1.1 Checking the Hardware Requirements

2.2 Software Requirements

2.2.1 Operating System

2.2.2 Checking the Software Requirements

2.2.3 Non-Oracle System Requirements

2.3 Installation Steps for Oracle Transparent Gateway for Sybase
3 Installing Oracle Transparent Gateway for Informix

3.1 Hardware Requirements

3.1.1 Checking the Hardware Requirements

3.2 Software Requirements

3.2.1 Operating System

3.2.2 Checking the Software Requirements

3.2.3 Non-Oracle System Requirements

3.3 Installation Steps for Oracle Transparent Gateway for Informix
4 Installing Oracle Transparent Gateway for Ingres II

4.1 Hardware Requirements

4.1.1 Checking the Hardware Requirements

4.2 Software Requirements

4.2.1 Operating System

4.2.2 Checking the Software Requirements

4.2.3 Non-Oracle System Requirements

4.3 Installation Steps for Oracle Transparent Gateway for Ingres II
5 Installing Oracle Transparent Gateway for Teradata

5.1 Hardware Requirements

5.1.1 Checking the Hardware Requirements

5.2 Software Requirements

5.2.1 Operating System

5.2.2 Checking the Software Requirements

5.2.3 Non-Oracle System Requirements

5.3 Installation Steps for Oracle Transparent Gateway for Teradata
6 Deinstalling Oracle Transparent Gateway

A Using Response Files for Non-Interactive Installation

A.1 Introduction

A.1.1 Installation Overview

A.2 Creating the oraInst.loc File A.3 Preparing a Response File

A.3.1 Editing a Response File Template

A.3.2 Recording a Response File

A.4 Running Oracle Universal Installer in Silent or Suppressed Mode
B Troubleshooting

B.1 Verify Requirements

B.2 What to Do If an Installation Error Occurs

B.3 Reviewing the Log of an Installation Session

B.4 Troubleshooting Configuration Assistants

B.4.1 Configuration Assistant Failure

B.4.2 Fatal Errors

B.5 Silent-Mode Response File Error Handling B.6 Cleaning Up After a Failed Installation
Index

List of Tables

2-1 Hardware requirements for Oracle Transparent Gateway for Sybase

2-2 Operating Systems version for Oracle Transparent Gateway for Sybase

2-3 The Oracle Universal Installer: Steps for Installing the Gateway

3-1 Hardware requirements for Oracle Transparent Gateway for Informix

3-2 Operating Systems version for Oracle Transparent Gateway for Informix

3-3 The Oracle Universal Installer: Steps for Installing the Gateway

4-1 Hardware requirements for Oracle Transparent Gateway for Ingres II

4-2 Operating Systems version for Oracle Transparent Gateway for Ingres II

4-3 The Oracle Universal Installer: Steps for Installing the Gateway

5-1 Hardware requirements for Oracle Transparent Gateway for Teradata

5-2 Operating Systems version for Oracle Transparent Gateway for Teradata

5-3 The Oracle Universal Installer: Steps for Installing the Gateway

6-1 Steps to DeInstall the Oracle Transparent Gateway Using Oracle Universal Installer

Send Us Your Comments

Oracle Transparent Gateway Installation Guide, 10g Release 2 (10.2) for Solaris Operating System, hp-ux, IBM AIX, and hp Tru64 UNIX

B19084-01

Oracle welcomes your comments and suggestions on the quality and usefulness of this publication. Your input is an important part of the information used for revision.

- Did you find any errors?

- Is the information clearly presented?

- Do you need more information? If so, where?

- Are the examples correct? Do you need more examples?

- What features did you like most about this manual?

If you find any errors or have any other suggestions for improvement, please indicate the title and part number of the documentation and the chapter, section, and page number (if available). You can send comments to us in the following ways:

- Electronic mail: infodev_us@oracle.com

- FAX:(650) 506-7227. Attn: Server Technologies Documentation Manager

- Postal service:

Oracle Corporation

Server Technologies Documentation Manager

500 Oracle Parkway, Mailstop 4op11

Redwood Shores, CA 94065

USA

If you have problems with the software, please contact your local Oracle Support Services.

Preface

This guide describes how to install Oracle Transparent Gateway for Solaris Operating System, hp-ux, IBM AIX, and hp Tru64 UNIX.

Intended Audience

This manual is intended for users responsible for installing Oracle Transparent Gateway on UNIX platforms.

Documentation Accessibility

Our goal is to make Oracle products, services, and supporting documentation accessible, with good usability, to the disabled community. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Accessibility standards will continue to evolve over time, and Oracle is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For more information, visit the Oracle Accessibility Program Web site at

http://www.oracle.com/accessibility/

Accessibility of Code Examples in Documentation

Screen readers may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, some screen readers may not always read a line of text that consists solely of a bracket or brace.

Accessibility of Links to External Web Sites in Documentation

This documentation may contain links to Web sites of other companies or organizations that Oracle does not own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites.

TTY Access to Oracle Support Services

Oracle provides dedicated Text Telephone (TTY) access to Oracle Support Services within the United States of America 24 hours a day, seven days a week. For TTY support, call 800.446.2398.

Structure

This guide contains the following chapters:

Chapter 1, "Oracle Transparent Gateway Overview"

This chapter contains an overview of Transparent Gateway as well as issues you should consider before installing the software.

Chapter 2, "Installing Oracle Transparent Gateway for Sybase"

This chapter contains the hardware and software requirements and the installation procedure for Oracle Transparent Gateway for Sybase.

Chapter 3, "Installing Oracle Transparent Gateway for Informix"

This chapter contains the hardware and software requirements and the installation procedure for Oracle Transparent Gateway for Informix.

Chapter 4, "Installing Oracle Transparent Gateway for Ingres II"

This chapter contains the hardware and software requirements and the installation procedure for Oracle Transparent Gateway for Ingres II.

Chapter 5, "Installing Oracle Transparent Gateway for Teradata"

This manual contains the hardware and software requirements and the installation procedure for Oracle Transparent Gateway for Teradata.

Chapter 6, "Deinstalling Oracle Transparent Gateway"

This chapter contains the deinstallation procedure for Oracle Transparent Gateway.

Appendix A, "Using Response Files for Non-Interactive Installation"

This appendix contains information about installing and configuring Oracle Transparent Gateway using response files.

Appendix B, "Troubleshooting"

This appendix contains information about troubleshooting the installation process.

Related Documents

The platform-specific documentation for Oracle Transparent Gateway 10g 10g Release 2 (10.2) products includes the following manuals:

- Oracle Transparent Gateway for Informix Administrator's Guide for Solaris Operating System (SPARC 64-Bit)

- Oracle Transparent Gateway for Sybase Administrator's Guide for Solaris Operating System (SPARC 64-Bit)

- Oracle Transparent Gateway for Teradata Administrator's Guide for Solaris Operating System (SPARC 64-Bit)

- Oracle Transparent Gateway for Ingres II Administrator's Guide for Solaris Operating System (SPARC 64-Bit)

- Oracle Transparent Gateway for Informix Administrator's Guide for hp-ux

- Oracle Transparent Gateway for Sybase Administrator's Guide for hp-ux

- Oracle Transparent Gateway for Teradata Administrator's Guide for hp-ux

- Oracle Transparent Gateway for Ingres II Administrator's Guide for hp-ux

- Oracle Transparent Gateway for Sybase Administrator's Guide for IBM AIX

- Oracle Transparent Gateway for Sybase Administrator's Guide for hp Tru64 UNIX

Typographic Conventions

The following typographic conventions are used in this manual:

Convention

Meaning

monospace

Monospace type indicates UNIX commands, directory names, usernames, pathnames, and filenames.

italics

Italic type indicates variables, including variable portions of filenames. It is also used for emphasis and for book titles.

UPPERCASE

Uppercase letters indicate Structured Query Language (SQL) reservedwords, initialization parameters, and environment variables.

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:

1. On the same computer as an existing Oracle Server but in a different Oracle home.

2. On a system with no Oracle Server.

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

1. Switch user to root

$ su - root

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

3. Insert the appropriate disc into the disc drive.

4. To verify that the disc mounted automatically, enter a command similar to the following depending on your platform:
Solaris:

# ls /cdrom/cdrom0

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

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

1. Create a directory on the hard disk to hold the Oracle software:

$ mkdir Ora10g

2. Change directory to the directory you created in step 1:

$ cd Ora10g

3. Create subdirectories for each installation disc with names similar to the following, where n is the disc number:

$ mkdir Diskn

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

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

1. Use any browser to access the software download page on OTN:

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

2. Navigate to the download page for the product that you want to install.

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

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

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

6. Download all of the installation archive files to the directory that you created in step 5.

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

1. If necessary, change directory to the directory that contains the downloaded installation archive files.

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

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

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

2. If necessary, log in as the Oracle software owner user (oracle) and set the DISPLAY environment variable.

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

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

5. When all of the configuration tools have finished, click Exit, then click Yes to exit from the Installer.

2 Installing Oracle Transparent Gateway for Sybase

This chapter provides information about the hardware and software requirements and the installation procedure for Oracle Transparent Gateway for Sybase for Solaris Operating System (SPARC), hp-ux, AIX, and hp Tru64 UNIX. It contains the following sections:

- Hardware Requirements

- Software Requirements

- Installation Steps for Oracle Transparent Gateway for Sybase

2.1 Hardware Requirements

Table 2-1 shows the hardware requirements for Oracle Transparent Gateway for Sybase.

Table 2-1 Hardware requirements for Oracle Transparent Gateway for Sybase

Hardware Items

Required for AIX-Based Systems

Required for HP 9000 Series hp_ux

Required for Solaris Operating System

Required for hp Tru64 UNIX

CPU

IBM RS/6000 AIX-Based System Processor

HP 9000 Series 700 or 800 processor for hp-ux 11.0

Sun Solaris Operating System (SPARC) Processor

Alpha processor

Temporary Disk Space

500 MB

500 MB

500 MB

500 MB

Disk Space

1.5 GB

1.5 GB

750 MB

1.5 GB

Memory

512 MB

512 MB

512 MB

512 MB

Swap Space

1 GB

1 GB

1 GB

1 GB

2.1.1 Checking the Hardware Requirements

The system must meet the following minimum hardware requirements:

- 512 MB of physical RAM

- 1 GB of swap space (or twice the size of RAM)

On systems with 2 GB or more of RAM, the swap space can be between one and two times the size of RAM. On AIX systems with 1 GB or more of memory, do not increase the swap space more than 2 GB. See the Oracle Database Administrator's Reference for UNIX for more information about configuring swap space on AIX.

- 500 MB of disk space in the /tmp directory

- Between 750 MB and 1.5 GB of disk space for the Oracle software, depending on the installation type and platform

To ensure that the system meets these requirements, follow these steps:

1. To determine the physical RAM size, enter one of the following commands:

Operating System

Command

AIX

# /usr/sbin/lsattr -E -l sys0 -a realmem

hp-ux

# /usr/sbin/dmesg | grep "Physical:"

Solaris

# usr/sbin/prtconf | grep "Memory size"

Tru64 UNIX

# /bin/vmstat -P | grep "Total Physical Memory"

If the size of the physical RAM installed in the system is less than the required size, you must install more memory before continuing.

2. To determine the size of the configured swap space, enter one of the following commands:

Operating System

Command

AIX

# /usr/sbin/lsps -a

hp-ux

# /usr/sbin/swapinfo -a

Solaris

# /usr/sbin/swap -s

Tru64 UNIX

# /sbin/swapon -s

If necessary, see your operating system documentation for information about how to configure additional swap space.

2.2 Software Requirements

The follow section describes the software requirements for Oracle Transparent Gateway for Sybase.

2.2.1 Operating System

Table 2-2 shows the operating system version required for Oracle Transparent Gateway for Sybase.

Table 2-2 Operating Systems version for Oracle Transparent Gateway for Sybase

Operating System

Version

Solaris

Solaris 8 or Solaris 9, 64-bit

hp-ux

hp-ux 11i (11.11) PA-RISC

AIX

AIX 5L version 5.2, Maintenance level 1 or higher

hp Tru64 UNIX

hp Tru64 5.1b

2.2.2 Checking the Software Requirements

To ensure that the system meets the software requirements, follow these steps:

- To determine which version of AIX is installed, enter the following command:

# oslevel -r

If the operating system version is lower than AIX 5.2.0.0 Maintenance Level 1 (5200-01), upgrade your operating system to this level. AIX 5L version 5.2 maintenance packages are available from the following Web site:

http://techsupport.services.ibm.com/server/aix.fdc

- To determine which version of hp-ux is installed, enter the following command:

# uname -a
HP-UX hostname B.11.11 U 9000/800 109444686 unlimited-user license

- To determine which version of Solaris Operating System is installed, enter the following command:

# uname -r

If your operating system is lower than Solaris 8 (5.8), upgrade your operating system to this level.

- To determine which version of Tru64 UNIX is installed, enter the following command:

# /usr/sbin/sizer -v
Compaq Tru64 UNIX V5.1B (Rev. 2650); Mon Nov 3 10:13:28 PST 200

In this example, the version shown is V5.1B. If necessary, see your operating system documentation for information about upgrading the operating system.

2.2.3 Non-Oracle System Requirements

This release of the gateway supports Sybase Adaptive Server. For the latest versions supported refer to the OTN Web site:

http://otn.oracle.com/products/gateways/pdf/certmatrix10g.pdf

2.3 Installation Steps for Oracle Transparent Gateway for Sybase

To install the gateway, follow these steps:

1. Run the Oracle Universal Installer
See "Running the Oracle Universal Installer" section for more information on running the Oracle Universal Installer.

2. Step through the Oracle Universal Installer
Oracle Universal Installer is a menu-driven utility that guides you through the installation of the gateway by prompting you with action items. The action items and the sequence in which they appear depend on your platform.

See Table 2-3 for description of the installation procedure of Oracle Transparent Gateway for Sybase.

3. Configure the Gateway
Refer to Oracle Transparent Gateway for Sybase Administrator's Guide of your platform for instruction on how to configure your gateway.

Step Through the Oracle Universal Installer

Table 2-3 describes the installation procedure for Oracle Transparent Gateway for Sybase.

Table 2-3 The Oracle Universal Installer: Steps for Installing the Gateway

Screen

Response

Oracle Universal Installer: Welcome

Click Next.

Oracle Universal Installer: File Locations

The Source section of the screen is where you specify the source location that the Oracle Universal Installer must use to install the Oracle Transparent Gateway. You need not edit the file specification in the Path field. The default setting for this field points to the installer file on your Oracle Transparent Gateway installation media.
The Path field in the Destination section of the File Locations screen is where you specify the destination for your installation. You need not edit the path specification in the Path field. The default setting for this field points to ORACLE_HOME. After you set the fields in the File Locations screen as necessary, click Next to continue. After loading the necessary information from the installation, the Oracle Universal Installer displays the Available Products screen.

Oracle Universal Installer: Available Product Components

a. Deselect the checked products.
b. Select Oracle Transparent Gateway 10.2.0.1.0, open up this row.

c. Select Oracle Transparent Gateway for Sybase 10.2.0.1.0.

d. Click Next.

Sybase Path

Specify the full path of the directory where the Sybase Adaptive Server or Open Client Software is installed. Click Next to continue.

Sybase Server and Database Name

Specify the server name and the database name of the Sybase database that the gateway will access. Click Next to continue.

Oracle Universal Installer: Summary

The Installation Summary screen enables you to review a tree list of options and components for this installation. Click Install to display the Installation Status screen.

Oracle Net Configuration Assistant: Welcome

Click Cancel

Oracle Net Configuration Assistant:

Click Yes

Oracle Universal Installer: Configuration Tools

Click Exit

Exit

The final screen of the Oracle Universal Installer is the End of Installation screen. Click Exit to exit the installer.

3 Installing Oracle Transparent Gateway for Informix

This chapter provides information about the hardware and software requirements and the installation procedure for Oracle Transparent Gateway for Informix for Solaris Operating System(SPARC) and hp-ux. It contains the following sections:

- Hardware Requirements

- Software Requirements

- Installation Steps for Oracle Transparent Gateway for Informix

3.1 Hardware Requirements

Table 3-1 shows the hardware requirements for Oracle Transparent Gateway for Informix.

Table 3-1 Hardware requirements for Oracle Transparent Gateway for Informix

Hardware Items

Required for HP 9000 Series hp_ux

Required for Solaris Operating System

CPU

HP 9000 Series 700 or 800 processor for hp-ux 11.0

Sun Solaris Operating System (SPARC) Processor

Temporary Disk Space

500 MB

500 MB

Disk Space

1.5 GB

750 MB

Memory

512 MB

512 MB

Swap Space

1 GB

1 GB

3.1.1 Checking the Hardware Requirements

The system must meet the following minimum hardware requirements:

- 512 MB of physical RAM

- 1 GB of swap space (or twice the size of RAM)

On systems with 2 GB or more of RAM, the swap space can be between one and two times the size of RAM.

- 500 MB of disk space in the /tmp directory

- Between 750 MB and 1.5 GB of disk space for the Oracle software, depending on the installation type and platform

To ensure that the system meets these requirements, follow these steps:

1. To determine the physical RAM size, enter one of the following commands:

Operating System

Command

hp-ux

# /usr/sbin/dmesg | grep "Physical:"

Solaris

# usr/sbin/prtconf | grep "Memory size"

If the size of the physical RAM installed in the system is less than the required size, you must install more memory before continuing.

2. To determine the size of the configured swap space, enter one of the following commands:

Operating System

Command

hp-ux

# /usr/sbin/swapinfo -a

Solaris

# /usr/sbin/swap -s

If necessary, see your operating system documentation for information about how to configure additional swap space.

3.2 Software Requirements

The follow section describes the software requirements for Oracle Transparent Gateway for Informix.

3.2.1 Operating System

Table 3-2 shows the operating system version required for Oracle Transparent Gateway for Informix for Solaris Operating System and hp-ux .

Table 3-2 Operating Systems version for Oracle Transparent Gateway for Informix

Operating System

Version

Solaris

Solaris 8 or Solaris 9, 64-bit

hp-ux

hp-ux 11i (11.11) PA-RISC

3.2.2 Checking the Software Requirements

To ensure that the system meets the software requirements, follow these steps:

- To determine which version of hp-ux is installed, enter the following command:

# uname -a
HP-UX hostname B.11.11 U 9000/800 109444686 unlimited-user license

- To determine which version of Solaris Operating System is installed, enter the following command:

# uname -r

If your operating system is lower than Solaris 8 (5.8), upgrade your operating system to this level.

3.2.3 Non-Oracle System Requirements

This release of the gateway supports Informix Dynamic Server. For the latest versions supported refer to the OTN Web site:

http://otn.oracle.com/products/gateways/pdf/certmatrix10g.pdf

3.3 Installation Steps for Oracle Transparent Gateway for Informix

To install the gateway, follow these steps:

1. Run the Oracle Universal Installer
See "Running the Oracle Universal Installer" section for more information on running the Oracle Universal Installer.

2. Step through the Oracle Universal Installer
Oracle Universal Installer is a menu-driven utility that guides you through the installation of the gateway by prompting you with action items. The action items and the sequence in which they appear depend on your platform.

See Table 3-3 for description of the installation procedure of Oracle Transparent Gateway for Informix.

3. Configure the Gateway
Refer to Oracle Transparent Gateway for Informix Administrator's Guide of your platform for instruction on how to configure your gateway.

Step Through the Oracle Universal Installer

Table 3-3 describes the installation procedure for Oracle Transparent Gateway for Informix.

Table 3-3 The Oracle Universal Installer: Steps for Installing the Gateway

Screen

Response

Oracle Universal Installer: Welcome

Click Next.

Oracle Universal Installer: File Locations

The Source section of the screen is where you specify the source location that the Oracle Universal Installer must use to install the Oracle Transparent Gateway. You need not edit the file specification in the Path field. The default setting for this field points to the installer file on your Oracle Transparent Gateway installation media.
The Path field in the Destination section of the File Locations screen is where you specify the destination for your installation. You need not edit the path specification in the Path field. The default setting for this field points to ORACLE_HOME. After you set the fields in the File Locations screen as necessary, click Next to continue. After loading the necessary information from the installation media, the Oracle Universal Installer displays the Available Products screen.

Oracle Universal Installer: Available Product Components

a. Deselect the checked products.
b. Select Oracle Transparent Gateway 10.2.0.1.0, open up this row.

c. Select Oracle Transparent Gateway for Informix 10.2.0.1.0.

d. Click Next.

Informix Client Library Path

Specify the full path of the directory where the Informix Client Library is installed. Click Next to continue.

Informix Server and Database Names

Specify the server name and the database name of the Informix database that the gateway will access, then click Next.

Oracle Universal Installer: Summary

The Installation Summary screen enables you to review a tree list of options and components for this installation. Click Install to display the Installation Status screen.

Oracle Net Configuration Assistant: Welcome

Click Cancel

Oracle Net Configuration Assistant:

Click Yes

Oracle Universal Installer: Configuration Tools

Click Exit

Exit

The final screen of the Oracle Universal Installer is the End of Installation screen. Click Exit to exit the installer.

4 Installing Oracle Transparent Gateway for Ingres II

This chapter provides information about the hardware and software requirements and the installation procedure for Oracle Transparent Gateway for Ingres II for Solaris Operating System(SPARC) and hp-ux. It contains the following sections:

- Hardware Requirements

- Software Requirements

- Installation Steps for Oracle Transparent Gateway for Ingres II

4.1 Hardware Requirements

Table 4-1 shows the hardware requirements for Oracle Transparent Gateway for Ingres II.

Table 4-1 Hardware requirements for Oracle Transparent Gateway for Ingres II

Hardware Items

Required for HP 9000 Series hp_ux

Required for Solaris Operating System

CPU

HP 9000 Series 700 or 800 processor for hp-ux 11.0

Sun Solaris Operating System (SPARC) Processor

Temporary Disk Space

500 MB

500 MB

Disk Space

1.5 GB

750 MB

Memory

512 MB

512 MB

Swap Space

1 GB

1 GB

4.1.1 Checking the Hardware Requirements

The system must meet the following minimum hardware requirements:

- 512 MB of physical RAM

- 1 GB of swap space (or twice the size of RAM)

On systems with 2 GB or more of RAM, the swap space can be between one and two times the size of RAM.

- 500 MB of disk space in the /tmp directory

- Between 750 GB and 1.5 GB of disk space for the Oracle software, depending on the installation type and platform

To ensure that the system meets these requirements, follow these steps:

1. To determine the physical RAM size, enter one of the following commands:

Operating System

Command

hp-ux

# /usr/sbin/dmesg | grep "Physical:"

Solaris

# usr/sbin/prtconf | grep "Memory size"

If the size of the physical RAM installed in the system is less than the required size, you must install more memory before continuing.

2. To determine the size of the configured swap space, enter one of the following commands:

Operating System

Command

hp-ux

# /usr/sbin/swapinfo -a

Solaris

# /usr/sbin/swap -s

If necessary, see your operating system documentation for information about how to configure additional swap space.

4.2 Software Requirements

The follow section describes the software requirements for Oracle Transparent Gateway for IngresII.

4.2.1 Operating System

Table 4-2 shows the operating system version required for Oracle Transparent Gateway for Ingres II for Solaris Operating System and hp-ux.

Table 4-2 Operating Systems version for Oracle Transparent Gateway for Ingres II

Operating System

Version

Solaris

Solaris 8 or Solaris 9, 64-bit

hp-ux

hp-ux 11i (11.11) PA-RISC

4.2.2 Checking the Software Requirements

To ensure that the system meets the software requirements, follow these steps:

- To determine which version of hp-ux is installed, enter the following command:

# uname -a
HP-UX hostname B.11.11 U 9000/800 109444686 unlimited-user license

- To determine which version of Solaris Operating System is installed, enter the following command:

# uname -r

If your operating system is lower than Solaris 8 (5.8), upgrade your operating system to this level.

4.2.3 Non-Oracle System Requirements

This release of the gateway supports Ingres II. For the latest versions supported refer to the OTN Web site:

http://otn.oracle.com/products/gateways/pdf/certmatrix10g.pdf

4.3 Installation Steps for Oracle Transparent Gateway for Ingres II

To install the gateway, follow these steps:

1. Run the Oracle Universal Installer
See "Running the Oracle Universal Installer" section for more information on running the Oracle Universal Installer.

2. Step through the Oracle Universal Installer
Oracle Universal Installer is a menu-driven utility that guides you through the installation of the gateway by prompting you with action items. The action items and the sequence in which they appear depend on your platform.

See Table 4-3 for description of the installation procedure of Oracle Transparent Gateway for Ingres II.

3. Configure the Gateway
Refer to Oracle Transparent Gateway for Ingres II Administrator's Guide of your platform for instruction on how to configure your gateway.

Step Through the Oracle Universal Installer

Table 4-3 describes the installation procedure for Oracle Transparent Gateway for Ingres II.

Table 4-3 The Oracle Universal Installer: Steps for Installing the Gateway

Screen

Response

Oracle Universal Installer: Welcome

Click Next.

Oracle Universal Installer: File Locations

The Source section of the screen is where you specify the source location that the Oracle Universal Installer must use to install the Oracle Transparent Gateway. You need not edit the file specification in the Path field. The default setting for this field points to the installer file on your Oracle Transparent Gateway installation media.
The Path field in the Destination section of the File Locations screen is where you specify the destination for your installation. You need not edit the path specification in the Path field. The default setting for this field points to ORACLE_HOME. After you set the fields in the File Locations screen as necessary, click Next to continue. After loading the necessary information from the installation media, the Oracle Universal Installer displays the Available Products screen.

Oracle Universal Installer: Available Product Components

a. Deselect the checked products.
b. Select Oracle Transparent Gateway 10.2.0.1.0, open up this row.

c. Select Oracle Transparent Gateway for Ingres II 10.2.0.1.0.

d. Click Next.

Ingres II Installation

Specify whether the Ingres database complies with the ANSI/ISO Entry SQL-92 standard. Click Next to continue.

Ingres II Installed Path

Specify the full path of the directory where the Ingres software is installed, then click Next.

Ingres Virtual Node and Database Name

Specify the virtual node name and the database name of the Ingres database that the Gateway wuill asccess, then click Next.

Oracle Universal Installer: Summary

The Installation Summary screen enables you to review a tree list of options and components for this installation. Click Install to display the Installation Status screen.

Oracle Net Configuration Assistant: Welcome

Click Cancel

Oracle Net Configuration Assistant:

Click Yes

Oracle Universal Installer: Configuration Tools

Click Exit

Exit

The final screen of the Oracle Universal Installer is the End of Installation screen. Click Exit to exit the installer.

5 Installing Oracle Transparent Gateway for Teradata

This chapter provides information about the hardware and software requirements and the installation procedure for Oracle Transparent Gateway for Teradata for Solaris Operating System(SPARC) and hp-ux. It contains the following sections:

- Hardware Requirements

- Software Requirements

- Installation Steps for Oracle Transparent Gateway for Teradata

5.1 Hardware Requirements

Table 5-1 shows the hardware requirements for Oracle Transparent Gateway for Teradata.

Table 5-1 Hardware requirements for Oracle Transparent Gateway for Teradata

Hardware Items

Required for HP 9000 Series hp_ux

Required for Solaris Operating System

CPU

HP 9000 Series 700 or 800 processor for hp-ux 11.0

Sun Solaris Operating System (SPARC) Processor

Temporary Disk Space

500 MB

500 MB

Disk Space

1.5 GB

750 MB

Memory

512 MB

512 MB

Swap Space

1 GB

1 GB

5.1.1 Checking the Hardware Requirements

The system must meet the following minimum hardware requirements:

- 512 MB of physical RAM

- 1 GB of swap space (or twice the size of RAM)

On systems with 2 GB or more of RAM, the swap space can be between one and two times the size of RAM.

- 500 MB of disk space in the /tmp directory

- Between 750 GB and 1.5 GB of disk space for the Oracle software, depending on the installation type and platform

To ensure that the system meets these requirements, follow these steps:

1. To determine the physical RAM size, enter one of the following commands:

Operating System

Command

hp-ux

# /usr/sbin/dmesg | grep "Physical:"

Solaris

# usr/sbin/prtconf | grep "Memory size"

If the size of the physical RAM installed in the system is less than the required size, you must install more memory before continuing.

2. To determine the size of the configured swap space, enter one of the following commands:

Operating System

Command

hp-ux

# /usr/sbin/swapinfo -a

Solaris

# /usr/sbin/swap -s

If necessary, see your operating system documentation for information about how to configure additional swap space.

5.2 Software Requirements

The follow section describes the software requirements for Oracle Transparent Gateway for Teradata.

5.2.1 Operating System

Table 5-2 shows the operating system version required for Oracle Transparent Gateway for Teradata for Solaris Operating System and hp-ux.

Table 5-2 Operating Systems version for Oracle Transparent Gateway for Teradata

Operating System

Version

Solaris

Solaris 8 or Solaris 9, 64-bit

hp-ux

hp-ux 11i (11.11) PA-RISC

5.2.2 Checking the Software Requirements

To ensure that the system meets the software requirements, follow these steps:

- To determine which version of hp-ux is installed, enter the following command:

# uname -a
HP-UX hostname B.11.11 U 9000/800 109444686 unlimited-user license

- To determine which version of Solaris Operating System is installed, enter the following command:

# uname -r

If your operating system is lower than Solaris 8 (5.8), upgrade your operating system to this level.

5.2.3 Non-Oracle System Requirements

This release of the gateway supports Teradata. For the latest versions supported refer to the OTN Web site:

http://otn.oracle.com/products/gateways/pdf/certmatrix10g.pdf

5.3 Installation Steps for Oracle Transparent Gateway for Teradata

To install the gateway, follow these steps:

1. Run the Oracle Universal Installer
See "Running the Oracle Universal Installer" section for more information on running the Oracle Universal Installer.

2. Step through the Oracle Universal Installer
Oracle Universal Installer is a menu-driven utility that guides you through the installation of the gateway by prompting you with action items. The action items and the sequence in which they appear depend on your platform.

See Table 5-3 for description of the installation procedure of Oracle Transparent Gateway for Teradata.

3. Configure the Gateway
Refer to Oracle Transparent Gateway for Teradata Administrator's Guide of your platform for instruction on how to configure your gateway.

Step Through the Oracle Universal Installer

Table 5-3 describes the installation procedure for Oracle Transparent Gateway for Teradata.

Table 5-3 The Oracle Universal Installer: Steps for Installing the Gateway

Screen

Response

Oracle Universal Installer: Welcome

Click Next.

Oracle Universal Installer: File Locations

The Source section of the screen is where you specify the source location that the Oracle Universal Installer must use to install the Oracle Transparent Gateway. You need not edit the file specification in the Path field. The default setting for this field points to the installer file on your Oracle Transparent Gateway installation media.
The Path field in the Destination section of the File Locations screen is where you specify the destination for your installation. You need not edit the path specification in the Path field. The default setting for this field points to ORACLE_HOME. After you set the fields in the File Locations screen as necessary, click Next to continue. After loading the necessary information from the installation media, the Oracle Universal Installer displays the Available Products screen.

Oracle Universal Installer: Available Product Components

a. Deselect the checked products.
b. Select Oracle Transparent Gateway 10.2.0.1.0, open up this row.

c. Select Oracle Transparent Gateway for Teradata 10.2.0.1.0.

d. Click Next.

Teradata ODBC DSN

Specify the ODBC data source name(DSN) for the Teradata database that the gateway will access. Click Next to continue.

ODBC Installation Location

Specify the full path of the directory where the NCR ODBC Driver for Teradata is Installed. Click Next to continue

Oracle Universal Installer: Summary

The Installation Summary screen enables you to review a tree list of options and components for this installation. Click Install to display the Installation Status screen.

Oracle Net Configuration Assistant: Welcome

Click Cancel

Oracle Net Configuration Assistant:

Click Yes

Oracle Universal Installer: Configuration Tools

Click Exit

Exit

The final screen of the Oracle Universal Installer is the End of Installation screen. Click Exit to exit the installer.

6 Deinstalling Oracle Transparent Gateway

If you decide to deinstall the Oracle Transparent Gateway, perform the following steps:

1. Stop the following process: Oracle Net Listener using the following command:

ORACLE_HOME/bin/lsnrctl stop

2. Log in as the oracle user:

$ su - oracle

3. Set the ORACLE_HOME environment variable to specify the path of the Oracle home that you want to remove:

- Bourne, Bash, or Korn shell:

$ ORACLE_HOME=/u01/app/oracle/product/10.2.0/db_1; export ORACLE_HOME

- C shell:

$ setenv ORACLE_HOME /u01/app/oracle/product/10.2.0/db_1

4. Start the Installer as follows:

$ $ORACLE_HOME/oui/bin/runInstaller

5. Step through the Oracle Universal Installer. Use the prompts listed in Table 6-1, "Steps to DeInstall the Oracle Transparent Gateway Using Oracle Universal Installer" as a guide for deinstallation, following the instructions in the Response column.

Table 6-1 Steps to DeInstall the Oracle Transparent Gateway Using Oracle Universal Installer

Prompt

Response

1. Oracle Universal Installer: Welcome

Click Deinstall Products.

2. Inventory

You may either choose to deinstall all products that you may have installed at the time of your original gateway installation, or you may choose to deinstall only an instance of Oracle Transparent Gateway.

- To deinstall all products: Select the ORACLE_HOME where Oracle Transparent Gateway was installed.

- Click Remove...

- To deinstall only one instance of Oracle Transparent Gateway, expand the rows within the ORACLE_HOME recursively until you arrive at the folder.

- Click Remove...

3. Confirmation

Click Yes.

4. Inventory

Click Close.

5. Oracle Universal Installer: Welcome

Click Cancel.

6. Exit

Click Yes.

6. The Oracle Transparent Gateway is now deinstalled.
When the Oracle Universal Installer confirms that the deinstallation has ended, verify that the deinstallation procedure was successful. To do this, read the contents of the deinstallation log file, which is located in the C:\Program Files\Oracle\Inventory\logs directory.

The default file name is InstallActionsYYYY-MM-DD_HH-mm-SS-AM/PM.log, where:

YYYY is year;

MM is month

DD is day

HH is hour

mm is minute

SS is seconds

AM/PM is daytime or evening

These variables in the log file name represent the date and time the product was de-installed.

A Using Response Files for Non-Interactive Installation

This appendix describes how to install and configure Oracle products using response files. It includes information about the following topics:

- Introduction

- Creating the oraInst.loc File

- Preparing a Response File

- Running Oracle Universal Installer in Silent or Suppressed Mode

A.1 Introduction

You can automate the installation and configuration of Oracle software, either fully or partially, by specifying a response file when you start Oracle Universal Installer. Oracle Universal Installer uses the values contained in the response file to provide answers to some or all of Oracle Universal Installer prompts:

- If you include responses for all of the prompts in the response file and specify the -silent option when starting Oracle Universal Installer, then Oracle Universal Installer runs in silent mode. During a silent-mode installation, Oracle Universal Installer does not display any screens. Instead, it displays progress information in the terminal that you used to start it.

- If you include responses for some or all of the prompts in the response file and omit the -silent option, then Oracle Universal Installer runs in suppressed mode. During a suppressed-mode installation, Oracle Universal Installer displays only the screens for which you did not specify all required information. You can also use variables in the response file or command-line options to suppress other installer screens, such as the Welcome screen or Summary screen, that do not prompt for information.

The following table describes several reasons why you might want to run Oracle Universal Installer in silent mode or suppressed mode:

Mode

Uses

Silent

Use silent mode if you want to:

- Complete an unattended installation, which you might schedule using operating system utilities such as at

- Complete several similar installations on multiple systems without user interaction

- Install the software on a system that does not have X Window System software installed on it

Oracle Universal Installer displays progress information in the terminal that you used to start it, but it does not display any of Oracle Universal Installer screens.

Suppressed

Use suppressed mode if you want to complete similar Oracle software installations on more than one system, providing default answers to some, but not all of Oracle Universal Installer prompts.
If you do not specify information required for a particular Installer screen in the response file, Oracle Universal Installer displays that screen. It suppresses screens for which you have provided all of the required information.

A.1.1 Installation Overview

To install and configure Oracle products using Oracle Universal Installer in silent or suppressed mode, follow these steps:

1. Create the oraInst.loc file.

2. Prepare a response file.

3. Run Oracle Universal Installer in silent or suppressed mode.

These steps are described in the following sections.

A.2 Creating the oraInst.loc File

If you plan to install Oracle products using Oracle Universal Installer in silent or suppressed mode, you must manually create the oraInst.loc file if it does not already exist. This file specifies the location of the Oracle Inventory directory where Oracle Universal Installer creates the inventory of Oracle products installed on the system.

Note:

If Oracle software has been installed previously on the system, the oraInst.loc file might already exist. If the file does exist, you do not need to create a file.

To create the oraInst.loc file, follow these steps:

1. 1. Switch user to root:

2. 2. On HP-UX, Solaris, and Tru64 UNIX, create the /var/opt/oracle directory if it does not exist:

# mkdir /var/opt/oracle

3. Change directory as follows, depending on your operating system:
AIX:

# cd /etc

HP-UX, Solaris, and Tru64 UNIX:

# cd /var/opt/oracle

4. Enter the following commands to set the appropriate owner, group, and permissions on the oraInst.loc file:

# chown oracle:oinstall oraInst.loc
# chmod 664 oraInst.loc

A.3 Preparing a Response File

This section describes the methods that you can use to prepare a response file for use during silent-mode or suppressed-mode installations:

- Editing a Response File Template

- Recording a Response File

A.3.1 Editing a Response File Template

Oracle provides response file templates for each product and installation type, and for each configuration tool. The response files for Oracle Gateways, tg.rsp and netca.rsp are located in the response directory on the media.

Note:

If you copied the software to a hard disk, the response files are located in the Disk1/response directory.

To prepare a response file:

1. Copy the response file from the response file directory to a directory on your system:

$ cp /directory_path/response/response_file.rsp local_directory

In this example, directory_path is the CD-ROM mount point directory or the directory on the DVD. If you have copied the software to a hard drive, you can edit the file in the response directory if you prefer.

2. Open the response file in a text editor:

$ vi /local_dir/response_file.rsp

3. Edit the file, following the instructions in the file.

Note:

Oracle Universal Installer or configuration assistant fails if you do not correctly configure the response file. Refer to the "Silent-Mode Response File Error Handling" section for more information about troubleshooting a failed silent-mode installation.

4. Change the permissions on the file to 700:

$ chmod 700 /local_dir/response_file.rsp

A.3.2 Recording a Response File

This method is most useful for Custom or software-only installations.

You can use Oracle Universal Installer in interactive mode to record a response file that you can edit and then use to complete silent-mode or suppressed-mode installations. When you are recording the response file, you can either complete the installation, or you can exit from Oracle Universal Installer on the Summary page, before it starts to copy the software to the system.

To record a new response file:

1. Complete the pre-installation tasks listed in respective chapters.
When you run Oracle Universal Installer to record a response file, it checks the system to verify that it meets the requirements to install the software. For this reason, Oracle recommends that you complete all of the required pre-installation tasks and record the response file while completing an installation.

2. If you have not installed Oracle software on this system previously, create the oraInst.loc file, as described in the previous section.

3. Ensure that the Oracle software owner user (typically oracle) has permissions to create or write to the Oracle home path that you will specify when you run Oracle Universal Installer.

4. To record a response file, enter a command similar to the following to start Oracle Universal Installer:

Note:

Do not specify a relative path to the response file. If you specify a relative path, Oracle Universal Installer fails.

$ /directory_path/runInstaller -record -destinationFile filename

In the previous example:

- directory_path is either the CD-ROM mount point directory, the path of the directory on the DVD, or the path of the Disk1 directory on the hard drive

- The -record parameter specifies that you want to record the responses that you enter in a response file

- filename is the full path and file name of the response file that you want to record

5. On each Installer screen, specify the required information.

6. When Oracle Universal Installer displays the Summary screen, do one of the following:

- Click Install to create the response file, then continue with the installation.

- Click Cancel, then Yes to create the response file but exit from Oracle Universal Installer without installing the software.

The response file is saved in the location that you specified using the -destinationFile option.

7. If you did not complete the installation, delete the Oracle home directory that Oracle Universal Installer created using the path you specified on the Specify File Locations screen.

8. Before using the recorded response file on another system, use a text editor to edit the file and make any required changes.
Use the comments in the file as a guide when editing it.

A.4 Running Oracle Universal Installer in Silent or Suppressed Mode

To run Oracle Universal Installer in silent or suppressed mode, follow these steps:

1. Complete the pre-installation tasks listed in the respective chapters.

2. Log in as the Oracle software owner user (typically oracle).

3. To start Oracle Universal Installer in silent or suppressed mode, enter a command similar to the following:

Note:

Do not specify a relative path to the response file. If you specify a relative path, Oracle Universal Installer fails.

In this example:

- directory_path is either the CD-ROM mount point directory, the path of the directory on the DVD, or the path of the Disk1 directory on the hard drive.

- -silent indicates that you want to run Oracle Universal Installer in silent mode.

- -noconfig suppresses running the configuration assistants during installation, and a software-only installation is performed instead.

- filename is the full path and file name of the installation response file that you configured.

Note:

For more information about other options for the runInstaller command, enter the following command:

$ /directory_path/runInstaller -help

B Troubleshooting

This appendix contains information about troubleshooting. It includes information about the following topics:

- Verify Requirements

- What to Do If an Installation Error Occurs

- Reviewing the Log of an Installation Session

- Troubleshooting Configuration Assistants

- Silent-Mode Response File Error Handling

- Cleaning Up After a Failed Installation

B.1 Verify Requirements

Before performing any of the troubleshooting steps in this appendix, ensure that the system meets the requirements and that you have completed all of the pre-installation tasks specified in respective chapters.

Read the Release Notes

Read the release notes for the product before installing it. The release notes are available on the Oracle Database 10g disc. The latest version of the release notes is also available on the OTN Web site:

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

B.2 What to Do If an Installation Error Occurs

If you encounter an error during installation:

- Do not exit Oracle Universal Installer.

- If you clicked Next after you entered incorrect information on one of the installation screens, click Back to return to the screen and correct the information.

- If you encounter an error while Oracle Universal Installer is copying or linking files, refer to the "Reviewing the Log of an Installation Session" section.

- If you encounter an error while a configuration assistant is running, refer to the "Troubleshooting Configuration Assistants" section.

- If you cannot resolve the problem, remove the failed installation by following the steps listed in the "Cleaning Up After a Failed Installation" section.

B.3 Reviewing the Log of an Installation Session

During an installation, Oracle Universal Installer records all of the actions that it performs in a log file. If you encounter problems during the installation, review the log file for information about possible causes of the problem.

To view the log file, follow these steps:

1. If necessary, enter the following command to determine the location of the oraInventory directory:
AIX:

Other operating systems:

The inventory_loc parameter in this file specifies the location of the oraInventory directory.

2. Enter the following command to change directory to Oracle Universal Installer log file directory, where orainventory_location is the location of the oraInventory directory:

$ cd /orainventory_location/logs

3. Enter the following command to determine the name of the log file:

$ ls -ltr

This command lists the files in the order of creation, with the most recent file shown last. Installer log files have names similar to the following, where date_time indicates the date and time that the installation started:

installActionsdate_time.log

4. To view the most recent entries in the log file, where information about a problem is most likely to appear, enter a command similar to the following:

$ tail -50 installActionsdate_time.log | more

This command displays the last 50 lines in the log file.

5. If the error displayed by Oracle Universal Installer or listed in the log file indicates a relinking problem, refer to the following file for more information:

$ORACLE_HOME/install/make.log

B.4 Troubleshooting Configuration Assistants

To troubleshoot an installation error that occurs when a configuration assistant is running:

- Review the installation log files listed in the "Reviewing the Log of an Installation Session" section.

- Review the specific configuration assistant log file located in the $ORACLE_HOME/cfgtoollogs directory. Try to fix the issue that caused the error.

- If you see the "Fatal Error. Reinstall" message, look for the cause of the problem by reviewing the log files. Refer to the "Fatal Errors" section for further instructions.

B.4.1 Configuration Assistant Failure

Oracle configuration assistant failures are noted at the bottom of the installation screen. The configuration assistant interface displays additional information, if available. The configuration assistant execution status is stored in the following file:

oraInventory_location/logs/installActionsdate_time.log

The execution status codes are listed in the following table:

Status

Result Code

Configuration assistant succeeded

0

Configuration assistant failed

1

Configuration assistant cancelled

-1

B.4.2 Fatal Errors

If you receive a fatal error while a configuration assistant is running, you must remove the current installation and reinstall the Oracle software, as follows:

1. Remove the failed installation as described in the "Cleaning Up After a Failed Installation" section.

2. Correct the cause of the fatal error.

3. Reinstall the Oracle software.

B.5 Silent-Mode Response File Error Handling

To determine whether a silent-mode installation succeeds or fails, refer to the following log file:

/oraInventory_location/logs/silentInstalldate_time.log

If necessary, refer to the previous section for information about determining the location of the oraInventory directory.

A silent installation fails if:

- You do not specify a response file

- You specify an incorrect or incomplete response file

- Oracle Universal Installer encounters an error, such as insufficient disk space

Oracle Universal Installer or configuration assistant validates the response file at run time. If the validation fails, the silent-mode installation or configuration process ends. Oracle Universal Installer treats values for parameters that are of the wrong context, format, or type as if no value was specified in the file.

B.6 Cleaning Up After a Failed Installation

If an installation fails, you must remove files that Oracle Universal Installer created during the attempted installation and remove the Oracle home directory. Perform the following steps to remove the files:

1. Start Oracle Universal Installer as described in the "Running the Oracle Universal Installer" section.

2. Click Deinstall Products on the Welcome window or click Installed Products on any Installer window.
The Inventory window appears, listing installed products.

3. Select the Oracle home that contains the products that you want to remove, then click Remove.

4. Manually remove the Oracle home directory created during the failed installation.

5. Reinstall the Oracle software.

Index
A  C  E  F  I  L  M  N  O  S  T  X

A

action items, 2.3, 3.3, 4.3, 5.3

C

configuration assistants

troubleshooting, B.4, B.4

E

errors

configuration assistants, B.4

installation, B.3, B.4.2

non-interactive installation, B.5

silent mode, B.5

X windows, B.1

F

fatal errors, B.4.2

file

InstallActions.log, 6

files

oraInst.loc, A.2

response files, A.3

I

InstallActions.log file, 6

installation

errors, B.3, B.4.2

silent mode, B.5

log files, B.2, B.2 non-interactive

error handling, B.5

oraInst.loc file, A.2

response files, A.3

preparing, A.3

silent mode, B.5

templates, A.3

silent mode, A.3.2, A.4

L

log files, B.2, B.2

troubleshooting, B.3

M

mount point directories, 1.5.1.2

N

Net Configuration Assistant

troubleshooting, B.4

non-interactive installation

oraInst.loc file, A.2

response files

preparing, A.3

templates, A.3

silent mode, A.3.2, A.4

errors, B.5

non-interactive installations

running

Oracle Universal Installer, A.4

O

Oracle Universal Installer

using

to de-install the gateway, 6

S

silent mode installation, A.3.2, A.4

T

troubleshooting, B

fatal errors, B.4.2

X

X windows

display errors, B.1

Oracle Legal Notices

Copyright Notice

Copyright © 1994-2016, Oracle and/or its affiliates. All rights reserved.

License Restrictions Warranty/Consequential Damages Disclaimer

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

Warranty Disclaimer

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

Restricted Rights Notice

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

Hazardous Applications Notice

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Trademark Notice

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

Third-Party Content, Products, and Services Disclaimer

This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.

Alpha and Beta Draft Documentation Notice

If this document is in preproduction status:

This documentation is in preproduction status and is intended for demonstration and preliminary use only. It may not be specific to the hardware on which you are using the software. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to this documentation and will not be responsible for any loss, costs, or damages incurred due to the use of this documentation.

Private Alpha and Beta Draft Documentation Notice

If this document is in private preproduction status:

The information contained in this document is for informational sharing purposes only and should be considered in your capacity as a customer advisory board member or pursuant to your beta trial agreement only. It is not a commitment to deliver any material, code, or functionality, and should not be relied upon in making purchasing decisions. The development, release, and timing of any features or functionality described in this document remains at the sole discretion of Oracle.

This document in any form, software or printed matter, contains proprietary information that is the exclusive property of Oracle. Your access to and use of this confidential material is subject to the terms and conditions of your Oracle Master Agreement, Oracle License and Services Agreement, Oracle PartnerNetwork Agreement, Oracle distribution agreement, or other license agreement which has been executed by you and Oracle and with which you agree to comply. This document and information contained herein may not be disclosed, copied, reproduced, or distributed to anyone outside Oracle without prior written consent of Oracle. This document is not part of your license agreement nor can it be incorporated into any contractual agreement with Oracle or its subsidiaries or affiliates.

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.