Oracle 11g Release 1 (11.1) Database Client Software Client Installation Guide

Oracle® Database

Client Installation Guide

11g Release 1 (11.1) for HP-UX

B32073-06

July 2010

Oracle Database Client Installation Guide, 11g Release 1 (11.1) for HP-UX

B32073-06

Copyright © 2009, 2010, Oracle and/or its affiliates. All rights reserved.

Primary Author: Namrata Bhakthavatsalam

Contributing Authors: Kevin Flood, Clara Jaeckel, Emily Murphy, Terri Winters

Contributors: David Austin, Subhranshu Banerjee, Mark Bauer, Robert Chang, Jonathan Creighton, Sudip

Datta, Thirumaleshwara Hasandka, Joel Kallman, George Kotsovolos, Simon Law, Richard Long, Rolly Lv,

Padmanabhan Manavazhi, Sreejith Minnanghat, Krishna Mohan, Rajendra Pingte, Hanlin Qian, Janelle

Simmons, Roy Swonger, Lyju Vadassery, Douglas Williams

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.

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.

If this software or related documentation is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. 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, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial

Computer Software License (December 2007). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA

94065.

This software 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 which may create a risk of personal injury. If you use this software in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure the safe use of this software. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software in dangerous applications.

Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

This software and documentation may provide access to or information on 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. 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.

Contents

Preface

................................................................................................................................................................ vii

Audience...................................................................................................................................................... vii

Documentation Accessibility .................................................................................................................... vii

Command Syntax ...................................................................................................................................... viii

Accessing Documentation........................................................................................................................ viii

Related Documentation .............................................................................................................................. ix

Typographic Conventions.......................................................................................................................... x

1 Overview of Oracle Client Installation

Planning Your Installation

..................................................................................................................... 1-1

Installation Considerations

.................................................................................................................... 1-2

Hardware and Software Certification ............................................................................................. 1-2

Multiple Oracle Homes Support...................................................................................................... 1-2

Installing the Software on a System with an Existing Oracle Installation.......................... 1-2

Oracle Client Installation Methods

...................................................................................................... 1-3

Interactive Installation Methods ...................................................................................................... 1-3

Automated Installation Methods Using Response Files .............................................................. 1-3

Oracle Client Installation Types

........................................................................................................... 1-3

Upgrade Considerations

......................................................................................................................... 1-4

AL24UTFFSS Character Set .............................................................................................................. 1-5

2 Preinstallation Tasks

Logging In to the System as root

........................................................................................................... 2-1

Checking the Hardware Requirements

................................................................................................ 2-2

Memory Requirements...................................................................................................................... 2-2

System Architecture........................................................................................................................... 2-3

Disk Space Requirements.................................................................................................................. 2-3

Checking the Software Requirements

................................................................................................. 2-4

Operating System Requirements ..................................................................................................... 2-4

Compiler Requirements .................................................................................................................... 2-5

Patch Requirement............................................................................................................................. 2-5

Additional Software Requirements ................................................................................................. 2-7

Oracle ODBC Drivers ................................................................................................................. 2-7

Oracle JDBC/OCI Drivers ......................................................................................................... 2-7

Programming languages............................................................................................................ 2-7

iii

Browser Requirements ............................................................................................................... 2-7

Creating Required Operating System Group and User

.................................................................... 2-8

Creating the Oracle Inventory Group ............................................................................................. 2-9

Creating the Oracle Software Owner User..................................................................................... 2-9

Determining Whether an Oracle Software Owner User Exists............................................ 2-9

Creating an Oracle Software Owner User............................................................................ 2-10

Modifying an Oracle Software Owner User ........................................................................ 2-10

Identifying Required Software Directories

..................................................................................... 2-10

Oracle Base Directory ..................................................................................................................... 2-10

Oracle Inventory Directory............................................................................................................ 2-11

Oracle Home Directory .................................................................................................................. 2-12

Identifying or Creating an Oracle Base Directory

.......................................................................... 2-12

Identifying an Existing Oracle Base Directory............................................................................ 2-12

Creating an Oracle Base Directory................................................................................................ 2-13

Configuring the oracle User’s Environment

.................................................................................... 2-14

3 Installing Oracle Database Client

Reviewing Installation Guidelines

....................................................................................................... 3-1

Accessing the Installation Software

..................................................................................................... 3-1

Downloading Oracle Software from the Oracle Technology Network Web Site..................... 3-2

Downloading the Installation Archive Files ........................................................................... 3-2

Extracting the Installation Files................................................................................................. 3-2

Copying the Software to the Hard Disk ......................................................................................... 3-3

Mounting Disks........................................................................................................................... 3-3

Copying the Oracle Client Software to a Hard Disk ............................................................. 3-4

Installing the Oracle Client Software

................................................................................................... 3-4

Running Oracle Universal Installer ................................................................................................. 3-4

4 Oracle Database Postinstallation Tasks

Required Postinstallation Tasks

........................................................................................................... 4-1

Downloading and Installing Patches .............................................................................................. 4-1

Updating Instant Client..................................................................................................................... 4-2

Connecting with Instant Client ........................................................................................................ 4-2

Recommended Postinstallation Tasks

................................................................................................. 4-3

Configuring Instant Client Light ..................................................................................................... 4-3

Creating a Backup of the root.sh Script...................................................................................... 4-4

Connecting Instant Client or Instant Client Light to an Oracle Database ................................. 4-4

Specifying a Connection by Using the Easy Connect Naming Method ............................. 4-4

Specifying a Connection by Configuring a tnsnames.ora File ........................................ 4-5

Specifying a Connection by Using an Empty Connect String and the TWO_TASK

Environment Variable ................................................................................................................ 4-5

Setting Up User Accounts ................................................................................................................. 4-6

Setting the NLS_LANG Environment Variable............................................................................. 4-6

Generating the Client Static Library................................................................................................ 4-6

Required Product-Specific Postinstallation Tasks

............................................................................ 4-6

Configuring Oracle Net Services ..................................................................................................... 4-7

Configuring Oracle Precompilers .................................................................................................... 4-7 iv

Configuring Pro*C/C++ ............................................................................................................ 4-7

Configuring Pro*FORTRAN ..................................................................................................... 4-7

5 Removing Oracle Software

Removing Oracle Software

..................................................................................................................... 5-1

A Installing and Configuring Oracle Database Using Response Files

How Response Files Work?

................................................................................................................... A-1

Reasons for Using Silent Mode or Noninteractive Mode............................................................ A-2

General Procedure for Using Response Files................................................................................ A-2

Preparing a Response File

..................................................................................................................... A-3

Editing a Response File Template................................................................................................... A-3

Recording a Response File ............................................................................................................... A-4

Running Oracle Universal Installer Using a Response File

........................................................... A-5

B Configuring Oracle Database Globalization Support

Installing and Using Oracle Components in Different Languages

............................................... B-1

Configuring Oracle Components to Run in Different Languages ............................................. B-1

Determining the Operating System Locale by Using the LANG Environment Variable B-1

Configuring Locale and Character Sets by Using the NLS_LANG Environment Variable ....

...........................................................................................................................................B-2

Installing Translation Resources ..................................................................................................... B-3

Running Oracle Universal Installer in Different Languages

......................................................... B-4

C Troubleshooting

Verify Requirements

.............................................................................................................................. C-1

X Window Display Errors

...................................................................................................................... C-1

What to Do If an Installation Error Occurs?

....................................................................................... C-2

Reviewing the Log of an Installation Session

................................................................................... C-2

Troubleshooting Configuration Assistants

........................................................................................ C-3

Configuration Assistant Failure...................................................................................................... C-3

Irrecoverable Errors .......................................................................................................................... C-4

Silent-Mode Response File Error Handling

....................................................................................... C-4

Cleaning Up After a Failed Installation

.............................................................................................. C-4

D Frequently Asked Questions About Installation

Installing Oracle Database or Oracle Client

...................................................................................... D-1

Installing Oracle Database Tools

......................................................................................................... D-3

Installing Oracle Database with Oracle Applications

..................................................................... D-7

Installing Oracle Database Heterogeneous Connectivity Tools (Gateways)

.............................. D-8

Index

v

vi

Preface

This guide provides instructions about installing and configuring Oracle Database for

HP-UX. This guide also talks about installing and configuring database using response files, globalization support, ports, and troubleshooting.

The preface contains the following topics:

■

Audience

■

■

■

■

■

Documentation Accessibility

Command Syntax

Accessing Documentation

Related Documentation

Typographic Conventions

Audience

Oracle Database Client Installation Guide for HP-UX guide is intended for anyone responsible for installing Oracle Client 11g Release 1 (11.1) on a single HP-UX system.

Additional installation guides for Oracle Database, Oracle Real Application Clusters,

Oracle Clusterware, Oracle Database Examples, and Oracle Enterprise Manager Grid

Control are available on the relevant installation media.

See Also:

Oracle Database Installation Guide for HP-UX to install

Oracle Database using the default settings

Documentation Accessibility

Our goal is to make Oracle products, services, and supporting documentation accessible to all users, including users that are disabled. 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 vii

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.

Access to Oracle Support

Oracle customers have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/support/contact.html

or visit http://www.oracle.com/accessibility/support.html

if you are hearing impaired.

Command Syntax

UNIX command syntax appears in monospace font. The dollar character ($), number sign (#), or percent character (%) are UNIX command prompts. Do not enter them as part of the command. The following command syntax conventions are used in this guide:

Convention

backslash \ braces { } brackets [ ] ellipses ...

italics

vertical line |

Description

A backslash is the UNIX command continuation character. It is used in command examples that are too long to fit on a single line. Enter the command as displayed (with a backslash) or enter it on a single line without a backslash: dd if=/dev/rdsk/c0t1d0s6 of=/dev/rst0 bs=10b \ count=10000

Braces indicate required items:

.DEFINE {macro1}

Brackets indicate optional items: cvtcrt termname [outfile]

Ellipses indicate an arbitrary number of similar items:

CHKVAL fieldname value1 value2 ... valueN

Italic type indicates a variable. Substitute a value for the variable:

library_name

A vertical line indicates a choice within braces or brackets:

FILE filesize [K|M]

Accessing Documentation

The documentation for this release includes platform-specific documentation and generic product documentation.

Platform-Specific Documentation

Platform-specific documentation includes information about installing and using

Oracle products on particular platforms.

viii

This guide contains information required to install Oracle Database 11g Release 1

(11.1) on various platforms of Hp-UX. Ensure that you review information related to the platform on which you intend to install Oracle Database 11g.

The platform-specific documentation for this product is available in both Adobe portable document format (PDF) and HTML format on the product media. To access the platform-specific documentation on media:

1.

Use a Web browser to open the welcome.htm file in the top-level directory of the media.

2.

3.

For DVD only, select the appropriate product link.

Select the Documentation tab.

If you prefer paper documentation, then open and print the PDF files.

Product Documentation

Product documentation includes information about configuring, using, or administering Oracle products on any platform. The product documentation for

Oracle Database 11g products is available in both HTML and PDF formats in the

Oracle Database 11g Release 1 (11.1) Online Documentation Library. To check for updates to this document and to view other Oracle documentation, select the

Documentation link or the Software & Patches link on the Oracle Database 11g Release

1 Beta Program Web site.

Related Documentation

The platform-specific documentation for Oracle Database 11g products includes the following manuals:

■

■

■

■

■

■

■

■

Oracle Database Release Notes for HP-UX

Oracle Database Installation Guide for HP-UX

Oracle Database Examples Installation Guide

Oracle Real Application Clusters Installation Guide for HP-UX

Oracle Database Quick Installation Guide for HP-UX Itanium

Oracle Database Client Quick Installation Guide for HP-UX Itanium

Oracle Enterprise Manager Grid Control Installation and Basic Configuration

Oracle Database Administrator's Reference for Linux and UNIX

■

■

■

■

Oracle Database Storage Administrator's Guide

Oracle Clusterware Installation Guide for HP-UX

Oracle Database Upgrade Guide

Oracle Database 2 Day DBA

For information about Oracle error messages, see Oracle Database Error Messages.

Oracle error message documentation is available only in HTML. If you only have access to the Oracle Database 10g Release 2 (10.2) Online Documentation Library, then you can browse the error messages by range. Once you find the specific range, use your browser's "find in page" feature to locate the specific message. When connected to the Internet, you can search for a specific error message using the error message search feature of the Oracle online documentation. ix

x

Many books in the documentation set use the sample schemas of the seed database, which is installed by default when you install Oracle. Refer to Oracle Database Sample

Schemas for information on how these schemas were created and how you can use them yourself.

Printed documentation is available for sale in the Oracle Store at: http://shop.oracle.com/

To download free release notes, installation documentation, white papers, or other collateral, please visit the Oracle Technology Network. You must register online before using OTN; registration is free and can be done at: http://www.oracle.com/technology/membership/

If you already have a user name and password for Oracle Technology Network, then you can go directly to the documentation section of the Oracle Technology Network

Web site at: http://www.oracle.com/technology/documentation/

Refer to Oracle Database Release Notes for HP-UX or important information that was not available when this book was released. The release notes for Oracle Database 11g are updated regularly. The most recent version is available on Oracle Technology

Network at: http://www.oracle.com/technology/documentation/index.html

Typographic Conventions

The following text conventions are used in this document:

Convention boldface

italic

monospace

Meaning

Boldface type indicates graphical user interface elements associated with an action, or terms defined in text or the glossary.

Italic type indicates book titles, emphasis, or placeholder variables for which you supply particular values.

Monospace type indicates commands within a paragraph, URLs, code in examples, text that appears on the screen, or text that you enter.

1

1

Overview of Oracle Client Installation

This chapter describes the different installation types of Oracle Client for HP-UX and issues to consider before you install Oracle Database:

■

■

Planning Your Installation

Installation Considerations

■

■

Oracle Client Installation Methods

Oracle Client Installation Types

Planning Your Installation

The Oracle Database installation process consists of the following phases:

1.

Read the release notes:

Read Oracle Database Release Notes for HP-UX before you begin the installation. The release notes are available with the platform-specific documentation. The latest version of the release notes is available on Oracle

Technology Network at: http://www.oracle.com/technology/documentation

2.

Review the licensing information:

Although the installation media in your media pack contain many Oracle components, you are permitted to use only those components for which you have purchased licenses.

Oracle Support Services does not provide support for components for which licenses have not been purchased.

See Also:

Oracle Database Licensing Information

3.

4.

5.

Plan the installation:

This chapter describes the Oracle products that you can install and issues that you must consider before starting the installation.

You can also refer to

Appendix D , which covers frequently asked questions about

installing Oracle Database components, such as how to install Oracle client if the site uses Oracle applications or if you need multiple Oracle client connections.

Complete preinstallation tasks:

Chapter 2

describes preinstallation tasks that you must complete before installing the product.

Install the software:

Use the following sections to install Oracle Database:

■

Chapter 3

describes how to use Oracle Universal Installer to install Oracle

Client.

Overview of Oracle Client Installation

1-1

Installation Considerations

6.

■

■

■

■

Appendix A

provides information on performing noninteractive (silent) installations, which you may want to use if you must perform multiple installations of Oracle Client.

Appendix B describes globalization support information.

Appendix C

provides troubleshooting advice in case you encounter problems with the installation.

Chapter 5

describes how to remove Oracle Client.

Complete postinstallation tasks:

Chapter 4

describes recommended and required postinstallation tasks.

Installation Considerations

This section contains information that you should consider before deciding how to install this product. It contains the following sections:

■

■

Hardware and Software Certification

Multiple Oracle Homes Support

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 My Oracle Support

(formerly OracleMetalink) Web site for the most up-to-date list of certified hardware platforms and operating system versions. The My Oracle Support (formerly

OracleMetalink) Web site is available at the following URL: https://support.oracle.com

You must register online before using My Oracle Support (formerly OracleMetalink).

After logging in, click Certify from the top right-hand side of the screen. The

Certifications page appears. Other options include Product Availability, Desupport

Notices, and Alerts.

Multiple Oracle Homes Support

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

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 11.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, then the installation fails.

Oracle Database Client can be installed in the same Oracle Database home if both products are at the same release level. For example, you can install Oracle Database

Client 10g Release 2 (10.2) into an existing Oracle Database 10g Release 2 (10.2) home.

If you apply a patch set before installing the client, then you must apply the patch set again.

1-2

Oracle Database Client Installation Guide

Oracle Client Installation Types

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

Oracle Client Installation Methods

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

■

■

Interactive Installation Methods

Automated Installation Methods Using Response Files

Interactive Installation Methods

When you use the interactive method to install Oracle Client, Oracle Universal

Installer displays a series of screens that enable you to specify all of the required information to install the Oracle Client software.

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 Database installation. These automated installation methods are useful if you must 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 .

Oracle Client Installation Types

You can choose one of the following installation types when installing Oracle Client:

■

Instant Client:

Enables you to install only the shared libraries required by Oracle

Call Interface (OCI), Oracle C++ Call Interface (OCCI), Pro*C, or Java database connectivity (JDBC) OCI applications. This installation type requires much less disk space than the other Oracle Client installation types.

See Also:

Oracle Call Interface Programmer's Guide or Oracle

Database JDBC Developer's Guide and Reference for more information about Instant Client

Included in the Instant Client installation is Instant Client Light. You may want to use this version of Instant Client if the applications generate error messages in

American English only. Instant Client Light is beneficial to application that use one of the supported character sets and can accept error messages in American

English. The following are the supported character sets:

–

US7ASCII

Overview of Oracle Client Installation

1-3

Upgrade Considerations

■

■

■

–

WE8DEC

–

WE8ISO8859P1

–

WE8EBCDIC37C

for EBCDIC platform only

–

WE8EBCDIC1047

for EBCDIC platform only

–

WE8MSWIN1252

–

UTF8

–

AL32UTF8

–

AL16UTF16

The advantage of using Instant Client Light is that it has a smaller footprint than the regular Instant Client. The shared libraries, which an application must load, are only 34 MB as opposed to the 110 MB that regular Instant Client uses.

Therefore, the applications use less memory.

Administrator:

Enables applications to connect to an Oracle Database instance on the local system or on a remote system. It also provides tools that enable you to administer Oracle Database.

Runtime:

Enables applications to connect to an Oracle Database instance on the local system or on a remote system.

Custom:

Enables you to select individual components from the list of

Administrator and Runtime components.

Caution:

AL32UTF8 is the Oracle Database character set that is appropriate for XMLType data. It is equivalent to the IANA registered standard UTF-8 encoding, which supports all valid XML characters.

Do not confuse Oracle Database database character set UTF8 (no hyphen) with database character set AL32UTF8 or with character encoding UTF-8. Database character set UTF8 has been superseded by

AL32UTF8. Do not use UTF8 for XML data. UTF8 supports only

Unicode version 3.0 and earlier; it does not support all valid XML characters. AL32UTF8 has no such limitation.

Using database character set UTF8 for XML data could potentially cause a irrecoverable error or affect security negatively. If a character that is not supported by the database character set appears in an input-document element name, then a replacement character (usually

"?") is substituted for it. This terminates parsing and raises an exception.

Upgrade Considerations

For information about upgrading a earlier release of Oracle Database to Oracle

Database 11g Release 1 (11.1), refer to Oracle Database Upgrade Guide. The following sections provide additional platform-specific upgrade information that you should review before upgrading an existing database:

1-4

Oracle Database Client Installation Guide

Upgrade Considerations

AL24UTFFSS Character Set

Note:

The information in this section does not apply to an upgrade of a eelease 1 (9.0.1) or later release of Oracle Database.

Before you upgrade an existing database that uses the AL24UTFFSS character set, you must upgrade the database character set to UTF8. Oracle recommends that you use the

Character Set Scanner (csscan) utility for data analysis before attempting to upgrade the existing database character set.

The Character Set Scanner utility checks all character data in the database and tests for the effects of, and problems with, changing the character set encoding. Before running the Character Set Scanner utility, set the shared library path environment variable for the platform to include the $ORACLE_HOME/lib directory. The shared library path environment path that you must set is LD_LIBRARY_PATH.

Note:

AL32UTF8 is the Oracle Database character set that is appropriate for XMLType data. It is equivalent to the IANA registered standard UTF-8 encoding, which supports all valid XML characters.

Do not confuse Oracle Database database character set UTF8 (no hyphen) with database character set AL32UTF8 or with character encoding UTF-8. Database character set UTF8 has been superseded by

AL32UTF8. Do not use UTF8 for XML data. UTF8 supports only

Unicode version 3.0 and earlier; it does not support all valid XML characters. AL32UTF8 has no such limitation.

Using database character set UTF8 for XML data could potentially cause a irrecoverable error or affect security negatively. If a character that is not supported by the database character set appears in an input-document element name, then a replacement character (usually

"?") is substituted for it. This will terminate parsing and raise an exception.

See Also:

Oracle Database Globalization Support Guide for more information about Character Set Support

Overview of Oracle Client Installation

1-5

Upgrade Considerations

1-6

Oracle Database Client Installation Guide

2

2

Preinstallation Tasks

This chapter describes the tasks that you must complete before you start Oracle

Universal Installer. It includes information about the following tasks:

■

■

Logging In to the System as root

Checking the Hardware Requirements

■

■

■

■

■

Checking the Software Requirements

Creating Required Operating System Group and User

Identifying Required Software Directories

Identifying or Creating an Oracle Base Directory

Configuring the oracle User’s Environment

Logging In to the System as root

Before you install the Oracle software, you must complete several tasks as the root user. To log in as the root user, complete one of the following procedures:

Note:

Unless you intend to complete a silent-mode installation, you must install the software from an X Window System workstation, an X terminal, or a PC or other system with X server software installed.

For more information about silent-mode installations, refer to

Appendix A

.

■

If you are installing the software from an X Window System workstation or X terminal, then:

1.

Start a local terminal session, for example, an X terminal (xterm).

2.

If you are not installing the software on the local system, then enter the following command to enable the remote host to display X applications on the local X server:

$ xhost fully_qualified_remote_host_name

For example:

$ xhost somehost.us.example.com

Preinstallation Tasks

2-1

Checking the Hardware Requirements

3.

If you are not installing the software on the local system, then use the ssh, rlogin

, or telnet command to connect to the system where you want to install the software:

$ telnet fully_qualified_remote_host_name

4.

If you are not logged in as the root user, then enter the following command to switch user to root:

$ su password:

#

■

If you are installing the software from a PC or other system with X server software installed, then:

Note:

If necessary, refer to your X server documentation for more information about completing this procedure. Depending on the X server software that you are using, you must complete the tasks in a different order.

1.

2.

3.

4.

Start the X server software.

Configure the security settings of the X server software to permit remote hosts to display X applications on the local system.

Connect to the remote system where you want to install the software and start a terminal session on that system, for example, an X terminal (xterm).

If you are not logged in as the root user on the remote system, then enter the following command to switch user to root:

$ su password:

#

Checking the Hardware Requirements

The system must meet the following minimum hardware requirements:

■

■

■

Memory Requirements

System Architecture

Disk Space Requirements

Memory Requirements

The following are the memory requirements for installing Oracle Database 11g Release

1:

■

At least 256 MB of RAM

To determine the RAM size, enter the following command:

–

On HP-UX PA-RISC

# grep "Physical:" /var/adm/syslog/syslog.log

–

On HP-UX Itanium

# /usr/contrib/bin/machinfo | grep -i Memory

2-2

Oracle Database Client Installation Guide

Checking the Hardware Requirements

■

If the size of the RAM is less than the required size, then you must install more memory before continuing.

The following table describes the relationship between installed RAM and the configured swap space requirement.

Available RAM

Up to 256 MB

Between 257 MB and 512 MB

More than 726 MB

Swap Space Required

3 times the size of RAM

2 times the size of RAM

0.75 times the size of RAM

To determine the size of the configured swap space, enter the following command:

# /usr/sbin/swapinfo -a

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

System Architecture

To determine whether the system architecture can run the software, enter the following command:

# /bin/getconf KERNEL_BITS

Note:

The expected output of this command is 64. If you do not see the expected output, then you cannot install the software on this system.

Disk Space Requirements

The following are the disk space requirements for installing Oracle Database 11g

Release 1:

■

Between 150 and 400 MB of disk space in the /tmp directory

To determine the amount of free disk space in the /tmp directory enter the following command:

# bdf /tmp

■

If there is less than 400 MB of free disk space available in the /tmp directory, then complete one of the following steps:

■

Delete unnecessary files from the /tmp directory to meet the disk space requirement.

■

■

Set the TMP and TMPDIR environment variables when setting the oracle user’s environment (described later).

Extend the file system that contains the /tmp directory. If necessary, contact the system administrator for information about extending file systems.

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

Preinstallation Tasks

2-3

Checking the Software Requirements

To determine the amount of free disk space on the system, enter the following command:

# bdf

The following table shows the approximate disk space requirements for software files for each installation type:

Installation Type

Instant Client

Administrator

Runtime

Custom (maximum)

Requirement for Software Files (MB)

206

1.76 (GB)

1.34 (GB)

1.67 (GB)

Checking the Software Requirements

Depending on the products that you intend to install, verify that the following software is installed on the system.

Note:

Oracle Universal Installer performs checks on your system to verify that it meets the listed requirements. To ensure that these checks pass, verify the requirements before you start Oracle

Universal Installer.

■

■

■

■

Operating System Requirements

Compiler Requirements

Patch Requirement

Additional Software Requirements

Operating System Requirements

The following are the operating system requirements for Oracle Database 11g Release

1:

■

■

HP-UX 11i v2 (11.23)

HP-UX 11i v3 (11.31)

To determine the distribution and version of HP-UX installed, enter the following command:

# uname -a

HP-UX hostname B.11.23 ia64 109444686 unlimited-user license

In this example, the version of HP-UX 11i is 11.23.

To determine whether a bundle, product, or fileset is installed, enter a command similar to the following, where level is bundle, product, or fileset:

# /usr/sbin/swlist -l level | more

2-4

Oracle Database Client Installation Guide

Checking the Software Requirements

If a required bundle, product, or fileset is not installed, then you must install it. Refer to your operating system or software documentation for information about installing products.

In addition, you must verify that the following patches are installed on the system.

The procedure following the table describes how to check these requirements.

Note:

There may be more recent versions of the patches listed installed on the system. If a listed patch is not installed, then determine whether a more recent version is installed before installing the version listed.

Compiler Requirements

The following are the compiler requirements for HP-UX Pro*C/C++, Oracle Call

Interface, Oracle C++ Call Interface, and Oracle XML Developer’s Kit (XDK) with

Oracle Database 11g release 1:

For HP-PA RISC:

■

HP C/ANSI C Compiler (B11.11.16)

■

HP ANSI C compiler (B.11.11.16) - June (AR0606) release

HP aC++ Compiler (A.03.73)

C++ (aCC) compiler (A.03.70) - June 2006 (AR0606) release

For HP-UX Itanium:

■

HP C/ANSI C Compiler (A.06.14)

HP ANSI C compiler (C.06.10) - June 2006 (AR0606) release

■

HP aC++ Compiler (A.06.14)

C++ (aCC) compiler (C.06.10) - June 2006 (AR0606) release

Patch Requirement

In addition, you must verify that the following patches are installed on the system.

Note:

There may be more recent versions of the patches listed installed on the system. If a listed patch is not installed, then determine whether a more recent version is installed before installing the version listed.

Refer to the following Web site for information about additional java patches: http://www.hp.com/products1/unix/java/patches/index.html

Preinstallation Tasks

2-5

Checking the Software Requirements

Installation Type or

Product

All installations

All installations

Pro*C/C++,

Oracle Call Interface,

Oracle C++ Call Interface,

Oracle XML Developer’s

Kit (XDK)

Pro*C/C++,

Oracle Call Interface,

Oracle C++ Call Interface,

Oracle XML Developer’s

Kit (XDK)

Requirement

For HP-UX 11i V2 (11.23):

■

■

Mar '07 Patch bundle for HP-UX 11iV2 (B.11.23.0703)

PHKL_35478: s700_800 11.23 shmget(2) cumulative patch

■

■

■

PHCO_36673: s700_800 11.23 libc cumulative patch

PHKL_36853: s700_800 11.23 pstat patch

PHSS_37958: 11.23 Libcl patch

For HP-UX 11i V3 (11.31):

■

■

PHKL_35900: 11.31 evacd performance, kvaddr leak panic

PHKL_36248: 11.31 esctl cumulative patch

■

■

■

■

PHKL_36249: 11.31 esdisk cumulative patch

PHKL_35936: 11.31 call to read(2) or write(2) may incorrectly return -1

PHKL_38038: ABORT CORRUPTION HANG OTHER

PANIC

PHSS_37959: 11.31 Libcl patch

Patches for HP-UX 11i V2 (11.23) on HP-UX PA-RISC:

■

PHSS_35176 - For HP C/ANSI C Compiler

■

■

PHSS_35101 - For HP C/ANSI C Compiler

PHSS_35103 - For HP C/ANSI C and HP aC++ compilers

■

PHSS_35102 - For HP aC++ Compiler. It changes the compiler version to A.03.73

Patches for HP-UX 11i V2 (11.23) on HP-UX Itanium:

■

■

■

PHSS_35974 - For HP C/ANSI C Compiler. It changes the compiler version to A.06.14

PHSS_35975 - For HP aC++ Compiler. It changes the compiler version to A.06.14

PHSS_35977 - For HP C/ANSI C and HP aC++ compilers

The following patch is required for HP C/ANSI C Compiler for

HP-UX 11i V3 (11.31) on HP-UX PA-RISC:

HP C/aC++ B.11.31.01 (Swlist Bundle - C.11.31.01) February

2007

The following patch is required for HP aC++ Compiler for HP-UX

11i V3 (11.31) on HP-UX PA-RISC:

HP C/aC++ A.03.74 (Swlist Bundle - C.11.31.01) February 2007

The following patch is required for HP C/ANSI C and HP aC++ compilers for HP-UX 11i V3 (11.31) on HP-UX Itanium:

HP C/aC++ A.06.12 (Swlist Bundle - C.11.31.01) February 2007

To ensure that the system meets these requirements:

1.

To determine whether a patch is installed, enter a command similar to the following:

# /usr/sbin/swlist -l patch | grep PHSS_35979

Alternatively, to list all installed patches, enter the following command:

# /usr/sbin/swlist -l patch | more

2-6

Oracle Database Client Installation Guide

Checking the Software Requirements

2.

If a required patch is not installed, then download it from the following Web site and install it: http://itresourcecenter.hp.com

If the Web site displays a recent version of the patch, then download and install that version.

Additional Software Requirements

Depending on the components you want to use, you must ensure that the following software are installed:

■

■

■

■

Oracle ODBC Drivers

Oracle JDBC/OCI Drivers

Programming languages

Browser Requirements

Oracle ODBC Drivers

If you intend to use ODBC, then you should build and install the most recent ODBC

Driver Manager. You can download and install the Driver Manager from the following link: http://www.unixodbc.org

You do not require ODBC Driver Manager to install Oracle Database.

To use ODBC, you must also install gcc 3.4.5 or later

Oracle JDBC/OCI Drivers

You can use Java SDK 5.0 as an optional software with the Oracle JDBC/OCI drivers.

However, this is not required for the installation.

■

■

Programming languages

The following products are certified for use with:

Pro*COBOL

Micro Focus Cobol 5.0

Pro*FORTRAN

HP FORTRAN 90 (B11.23.20)

■

■

■

■

■

■

Browser Requirements

Web browsers must support Java Script and the HTML 4.0 and CSS 1.0 standards. The following browsers meet these requirements:

Netscape Navigator 7.2

Netscape Navigator 8.1

Mozilla version 1.7

Microsoft Internet Explorer 6.0 SP2

Microsoft Internet Explorer 7.0

Firefox 1.0.4

Preinstallation Tasks

2-7

Creating Required Operating System Group and User

■

■

Firefox 1.5

Firefox 2.0

Creating Required Operating System Group and User

Depending on whether this is the first time Oracle software is being installed on this system and on the products that you are installing, you must create the following operating system group and user:

■

The Oracle Inventory group (oinstall)

You must create this group the first time you install Oracle software on the system. The usual name chosen for this group is oinstall. This group owns the

Oracle inventory, which is a catalog of all Oracle software installed on the system.

Note:

If Oracle software is already installed on the system, then the existing Oracle Inventory group must be the primary group of the operating system user that you use to install new Oracle software.

■

The Oracle software owner user (typically, oracle)

You must create this user the first time you install Oracle software on the system.

This user owns all of the software installed during the installation. This user must have the Oracle Inventory group as its primary group. It must also have the

OSDBA and OSOPER groups as secondary groups.

Note:

In Oracle documentation, this user is referred to as the oracle

user.

A single Oracle Inventory group is required for all installations of Oracle software on the system. After the first installation of Oracle software, you must use the same

Oracle Inventory group for all subsequent Oracle software installations on that system.

However, you can choose to create different Oracle software owner users for separate installations.

Note:

The following sections describe how to create local users and groups. As an alternative to creating local users and groups, you could create the appropriate users and groups in a directory service, for example, Network Information Services (NIS). For information about using directory services, contact your system administrator or refer to your operating system documentation.

The following sections describe how to create the required operating system users and groups:

■

■

Creating the Oracle Inventory Group

Creating the Oracle Software Owner User

2-8

Oracle Database Client Installation Guide

Creating Required Operating System Group and User

Creating the Oracle Inventory Group

You must create the Oracle Inventory group if it does not already exist. The following subsections describe how to determine the Oracle Inventory group name, if it exists, and how to create it if necessary.

Determining Whether the Oracle Inventory Group Exists

When you install Oracle software on the system for the first time, Oracle Universal

Installer creates the oraInst.loc file. This file identifies the name of the Oracle

Inventory group and the path of the Oracle Inventory directory.

To determine whether the Oracle Inventory group exists, enter the following command:

# more /var/opt/oracle/oraInst.loc

If the oraInst.loc file exists, then the output from this command is similar to the following: inventory_loc=/u01/app/oracle/oraInventory inst_group=oinstall

The inst_group parameter shows the name of the Oracle Inventory group, oinstall

.

Creating the Oracle Inventory Group

If the oraInst.loc file does not exist, then create the Oracle Inventory group by entering the following command:

# /usr/sbin/groupadd oinstall

Creating the Oracle Software Owner User

You must create an Oracle software owner user in the following circumstances:

■

■

If an Oracle software owner user does not exist, for example, if this is the first installation of Oracle software on the system

If an Oracle software owner user exists, but you want to use a different operating system user

Determining Whether an Oracle Software Owner User Exists

To determine whether an Oracle software owner user named oracle exists, enter the following command:

# id oracle

If the oracle user exists, then the output from this command is similar to the following: uid=440(oracle) gid=200(oinstall) groups=201(dba),202(oper)

If the user exists, then determine whether you want to use the existing user or create another oracle user. If you want to use the existing user, then ensure that the user’s primary group is the Oracle Inventory group. Refer to one of the following sections for more information:

Preinstallation Tasks

2-9

Identifying Required Software Directories

Note:

If necessary, contact your system administrator before using or modifying an existing user.

■

■

■

If you want to use the existing Oracle software owner user, and the user’s primary

group is the Oracle Inventory group, then refer to the "Identifying Required

Software Directories" section on page 2-10.

To modify an existing user, refer to the "Modifying an Oracle Software Owner

User" section on page 2-10.

To create a user, refer to the following section.

Creating an Oracle Software Owner User

If the Oracle software owner user does not exist or if you require a new Oracle software owner user, then create it as follows. In the following procedure, use the user name oracle unless a user with that name already exists.

1.

To create the oracle user, enter a command similar to the following:

# /usr/sbin/useradd -g oinstall[ -G dba] oracle

2.

In this command:

■

The -g option specifies the primary group, which must be the Oracle

Inventory group, for example oinstall

■

The -G option specifies optional secondary groups, the OSOPER group. For example, dba

Set the password of the oracle user:

# passwd oracle

Refer to the "Identifying Required Software Directories" section on page 2-10 to

continue.

Modifying an Oracle Software Owner User

If the oracle user exists, but its primary group is not oinstall, then enter a command similar to the following to modify it. Specify the primary group using the

-g

option and any required secondary group using the -G option:

# /usr/sbin/usermod -g oinstall -G dba[,oper] oracle

Identifying Required Software Directories

You must identify or create the following directories for the Oracle software:

■

■

■

Oracle Base Directory

Oracle Inventory Directory

Oracle Home Directory

Oracle Base Directory

The Oracle base directory is a top-level directory for Oracle software installations. It is analogous to the C:\Oracle directory used for Oracle software installations on

Microsoft Windows systems. On HP-UX systems, the Optimal Flexible Architecture

2-10

Oracle Database Client Installation Guide

Identifying Required Software Directories

(OFA) guidelines recommend that you use a path similar to the following for the

Oracle base directory:

/mount_point/app/oracle_sw_owner

In this example:

■

mount_point

is the mount point directory for the file system that will contain the

Oracle software.

■

The examples in this guide use /u01 for the mount point directory. However, you could choose another mount point directory, such as /oracle or /opt/oracle.

oracle_sw_owner

is the operating system user name of the Oracle software owner, for example oracle.

You must specify the ORACLE_BASE folder that contains all Oracle products.

Note:

If you have an existing ORACLE_BASE ,then you can select it from the Use existing drop down box .By default ,the drop down box contains the existing value for ORACLE_BASE already selected. Refer to

"Installing the Oracle Client Software" on page 3-4 for further

information.

If you do not have an OARCLE_BASE,then you can create a new one by editing the text in the list box.

You can use the same Oracle base directory for more than one installation or you can create separate Oracle base directories for different installations. If different operating system users install Oracle software on the same system, then each user must create a separate Oracle base directory. The following example Oracle base directories could all exist on the same system:

/u01/app/oracle

/u01/app/orauser

/opt/oracle/app/oracle

The following sections describe how to identify existing Oracle base directories that may be suitable for your installation and how to create an Oracle base directory if necessary.

Regardless of whether you create an Oracle base directory or decide to use an existing one, you must set the ORACLE_BASE environment variable to specify the full path to this directory.

Oracle Inventory Directory

The Oracle Inventory directory (oraInventory) stores an inventory of all software installed on the system. It is required by, and shared by, all Oracle software installations on a single system. The first time you install Oracle software on a system,

Oracle Universal Installer prompts you to specify the path to this directory. then

Oracle recommends that you choose the following path:

oracle_base/oraInventory

Oracle Universal Installer creates the directory that you specify and sets the correct owner, group, and permissions for it. You do not need to create it.

Preinstallation Tasks

2-11

Identifying or Creating an Oracle Base Directory

Note:

All Oracle software installations rely on this directory.

Ensure that you back it up regularly.

Do not delete this directory unless you have completely removed all Oracle software from the system.

Oracle Home Directory

The Oracle home directory is the directory where you choose to install the software for a particular Oracle product. You must install different Oracle products, or different releases of the same Oracle product, in separate Oracle home directories. When you run Oracle Universal Installer, it prompts you to specify the path to this directory, and a name that identifies it. The directory that you specify must be a subdirectory of the

Oracle base directory. Oracle recommends that you specify a path similar to the following for the Oracle home directory:

oracle_base/product/11.1.0/client_1

Oracle Universal Installer creates the directory path that you specify under the Oracle base directory. It also sets the correct owner, group, and permissions on it. You do not need to create this directory.

Caution:

During installation, you must not specify an existing directory that has predefined permissions applied to it as the Oracle home directory. If you do, then you may experience installation failure due to file and group ownership permission errors.

Identifying or Creating an Oracle Base Directory

Before starting the installation, you must either identify an existing Oracle base directory or if required, create one. This section contains information about the following:

■

■

Identifying an Existing Oracle Base Directory

Creating an Oracle Base Directory

Note:

You can choose to create an Oracle base directory, even if other Oracle base directories exist on the system.

Identifying an Existing Oracle Base Directory

Existing Oracle base directories may not have paths that obey OFA guidelines.

However, if you identify an existing Oracle Inventory directory or existing Oracle home directories, then you can usually identify the Oracle base directories, as follows:

■

Identifying an existing Oracle Inventory directory

Enter the following command to view the contents of the oraInst.loc file:

# more /var/opt/oracle/oraInst.loc

If the oraInst.loc file exists, then the output from this command is similar to the following: inventory_loc=/u01/app/oraInventory inst_group=oinstall

2-12

Oracle Database Client Installation Guide

Identifying or Creating an Oracle Base Directory

■

The inventory_loc parameter identifies the Oracle Inventory directory

(oraInventory). The parent directory of the oraInventory directory is typically an Oracle base directory. In the previous example, /u01/app/oracle is an Oracle base directory.

Identifying existing Oracle home directories

Enter the following command to view the contents of the oratab file:

# more /etc/oratab

If the oratab file exists, then it contains lines similar to the following:

*:/u03/app/oracle/product/11.1.0/db_1:N

*:/opt/orauser/infra_904:N

*:/oracle/9.2.0:N

The directory paths specified on each line identify Oracle home directories.

Directory paths that end with the user name of the Oracle software owner that you want to use are valid choices for an Oracle base directory. If you intend to use the oracle

user to install the software, then you could choose one of the following directories from the previous example:

/u03/app/oracle

/oracle

Note:

If possible, choose a directory path similar to the first

(/u03/app/oracle). This path complies with the OFA guidelines.

To continue:

■

If an Oracle base directory exists and you want to use it, then refer to the

"Configuring the oracle User’s Environment" section on page 2-14.

■

When you configure the oracle user’s environment later in this chapter, set the

ORACLE_BASE

environment variable to specify the directory you chose.

If an Oracle base directory does not exist on the system or if you want to create an

Oracle base directory, then refer to the following section.

Creating an Oracle Base Directory

Before you create an Oracle base directory, you must identify an appropriate file system with disk space.

To identify an appropriate file system:

1.

Use the bdf command to determine the free disk space on each mounted file system.

2.

3.

From the display, identify a file system that has appropriate free space.

Note the name of the mount point directory for the file system that you identified.

To create the Oracle base directory and specify the correct owner, group, and permissions for it:

1.

Enter commands similar to the following to create the recommended subdirectories in the mount point directory that you identified and set the appropriate owner, group, and permissions on them:

Preinstallation Tasks

2-13

Configuring the oracle User’s Environment

# mkdir -p /mount_point/app/oracle_sw_owner

# chown -R oracle:oinstall /mount_point/app/oracle_sw_owner

# chmod -R 775 /mount_point/app/oracle_sw_owner

For example, if the mount point you identify is /u01 and oracle is the user name of the Oracle software owner, then the recommended Oracle base directory path is as follows:

/u01/app/oracle

2.

When you configure the oracle user’s environment later in this chapter, set the

ORACLE_BASE

environment variable to specify the Oracle base directory that you have created.

Configuring the oracle User’s Environment

You run Oracle Universal Installer from the oracle account. However, before you start Oracle Universal Installer you must configure the environment of the oracle user. To configure the environment, you must:

■

■

Set the default file mode creation mask (umask) to 022 in the shell startup file.

Set the DISPLAY environment variable.

Caution:

Use shell programs supported by your operating system vendor. If you use a shell program that is not supported by your operating system, then you can encounter errors during installation.

To set the oracle user’s environment:

1.

Start a new terminal session, for example, an X terminal (xterm).

2.

Enter the following command to ensure that X Window applications can display on this system:

$ xhost fully_qualified_remote_host_name

For example:

$ xhost somehost.us.example.com

3.

4.

If you are not already logged in to the system where you want to install the software, then log in to that system as the oracle user.

If you are not logged in as the oracle user, then switch user to oracle:

$ su - oracle

5.

To determine the default shell for the oracle user, enter the following command:

$ echo $SHELL

6.

Open the oracle user’s shell startup file in any text editor:

■

C shell (csh or tcsh):

% vi .login

7.

Enter or edit the following line, specifying a value of 022 for the default file mode creation mask: umask 022

2-14

Oracle Database Client Installation Guide

Configuring the oracle User’s Environment

8.

9.

If the ORACLE_SID, ORACLE_HOME, or ORACLE_BASE environment variable is set in the file, then remove the appropriate lines from the file.

Save the file, and exit from the editor.

10.

To run the shell startup script, enter one of the following commands:

■

Bash shell:

$ . ./.bash_profile

■

Bourne or Korn shell:

$ . ./.profile

■

C shell:

% source ./.login

11.

If you are not installing the software on the local computer, then run the following command on the remote computer to set the DISPLAY variable:

■

Bourne, Bash or Korn shell:

$ export DISPLAY=local_host:0.0

■

C shell:

% setenv DISPLAY local_host:0.0

In this example, local_host is the host name or IP address of the local computer that you want to use to display Oracle Universal Installer.

Run the following command on the remote computer to check if the shell and the

DISPLAY environmental variable are set correctly: echo $SHELL echo $DISPLAY

Now to enable X applications, run the following commands on the local computer:

$ xhost + fully_qualified_remote_host_name

To verify that X applications display is set properly, run a X11 based program that comes with the operating system such as xclock:

$ xclock_path

In this example, xclock_path is the directory path. For example, you can find xclock

at /usr/X11R6/bin/xclocks. If the DISPLAY variable is set properly, then you can see xclock on your computer screen.

See Also:

PC-X Server or Operating System vendor documents for further assistance.

12.

If you determined that the /tmp directory has less than 400 MB of free disk space, then identify a file system with at least 400 MB of free space and set the TMP and

TMPDIR

environment variables to specify a temporary directory on this file system:

a.

Use the bdf command to identify a suitable file system with sufficient free space.

Preinstallation Tasks

2-15

Configuring the oracle User’s Environment

b.

If you are not logged in as the root user, then enter the following command to switch user to root:

$ su password:

#

If necessary, enter commands similar to the following to create a temporary directory on the file system that you identified, and set the appropriate permissions on the directory:

# mkdir /mount_point/tmp

# chmod a+wr /mount_point/tmp

# exit

c.

Enter commands similar to the following to set the TMP and TMPDIR environment variables:

*

Bourne, Bash, or Korn shell:

$ TMP=/mount_point/tmp

$ TMPDIR=/mount_point/tmp

$ export TMP TMPDIR

*

C shell:

% setenv TMP /mount_point/tmp

% setenv TMPDIR /mount_point/tmp

13.

Enter commands similar to the following to set the ORACLE_BASE environment variable:

■

Bourne, Bash, or Korn shell:

$ ORACLE_BASE=/u01/app/oracle

$ export ORACLE_BASE

■

C shell:

% setenv ORACLE_BASE /u01/app/oracle

In these examples, /u01/app/oracle is the Oracle base directory that you created or identified earlier.

14.

Enter the following commands to ensure that the ORACLE_HOME and TNS_ADMIN environment variables are not set:

■

Bourne, Bash, or Korn shell:

$ unset ORACLE_HOME

$ unset TNS_ADMIN

■

C shell:

% unsetenv ORACLE_HOME

% unsetenv TNS_ADMIN

2-16

Oracle Database Client Installation Guide

Configuring the oracle User’s Environment

Note:

If the ORACLE_HOME environment variable is set, then

Oracle Universal Installer uses the value that it specifies as the default path for the Oracle home directory. However, if you set the

ORACLE_BASE

environment variable, then Oracle recommends that you unset the ORACLE_HOME environment variable and choose the default path suggested by Oracle Universal Installer.

15.

To verify that the environment has been set correctly, enter the following commands:

$ umask

$ env | more

Verify that the umask command displays a value of 22, 022, or 0022 and the environment variables that you set in this section have the correct values.

Preinstallation Tasks

2-17

Configuring the oracle User’s Environment

2-18

Oracle Database Client Installation Guide

3

3

Installing Oracle Database Client

The Oracle Client software is available on installation media or you can download it from the Oracle Technology Network Web site. In most cases, you use the graphical user interface (GUI) provided by Oracle Universal Installer to install the software.

However, you can also use Oracle Universal Installer to complete silent-mode installations, without using the GUI.

■

■

■

Reviewing Installation Guidelines

Accessing the Installation Software

Installing the Oracle Client Software

See Also:

Appendix A

for information about silent-mode installations

Reviewing Installation Guidelines

Review the following guidelines before starting Oracle Universal Installer:

■

■

Oracle Universal Installer

Do not use Oracle Universal Installer from an earlier Oracle release to install components from this release.

Reinstalling Oracle Software

If you reinstall Oracle software into an Oracle home directory where Oracle

Database is already installed, you must also reinstall any components, such as

Oracle Partitioning, that were installed before you begin the reinstallation.

Accessing the Installation Software

The Oracle Client software is available on installation media or you can download it from the Oracle Technology Network Web site. To install the software from the hard disk, you must either download it from Oracle Technology Network and unpack it, or copy it from the installation media, if you have it.

You can access and install Oracle Database by using one of the following methods:

■

To install the software from a installation media or from an existing hard disk

location, refer to "Installing the Oracle Client Software" on page 3-4

■

To copy the software to a hard disk, refer to "Copying the Software to the Hard

Disk" on page 3-3

Installing Oracle Database Client

3-1

Accessing the Installation Software

■

To download the software from Oracle Technology Network, refer to

"Downloading Oracle Software from the Oracle Technology Network Web Site" on page 3-2

Downloading Oracle Software from the Oracle Technology Network Web Site

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

■

■

Downloading the Installation Archive Files

Extracting the Installation Files

Downloading the Installation Archive Files

To download the installation archive files from Oracle Technology Network:

1.

Use any browser to access the software download page from Oracle Technology

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

2.

3.

4.

5.

6.

7.

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 OraDB11g, 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 Oracle Technology Network.

Extracting the Installation Files

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

1.

2.

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

If the downloaded file has the zip extension, use the following command to extract the content: unzip file_name.zip

If the downloaded file has the cpio.gz extension, use the following command:

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

3-2

Oracle Database Client Installation Guide

Accessing the Installation Software

$ cpio -idcmv < 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.

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

When you have extracted all of the required installation files, refer to

"Installing the

Oracle Client Software" on page 3-4.

Copying the Software to the Hard Disk

Before installing Oracle Database, 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 disk. The following sections describe to mount disk and copy its content to the hard disk.

Mounting Disks

On most HP-UX systems, the disk mounts automatically when you insert it into the installation media. If the disk does not mount automatically, then follow these steps to mount it:

1.

Switch user to root:

$ su -

2.

If necessary, enter the following command to unmount the currently mounted disc, then remove it from the drive:

# /usr/sbin/umount /SD_DVD

3.

In this example, /SD_DVD is the mount point directory for the disc drive.

Insert the appropriate disc into the disc drive, then enter a command similar to the following to mount it:

# /usr/sbin/mount -F cdfs -o rr /dev/dsk/cxtydz /SD_DVD

4.

In this example, /SD_DVD is the disc mount point directory and

/dev/dsk/cxtydz

is the device name for the disc device, for example

/dev/dsk/c0t2d0

.

If Oracle Universal Installer is displaying the Disk Location dialog box, enter the disc mount point directory path, for example:

/SD_DVD

To continue, go to one of the following sections:

■

If you want to copy software to a hard disk, refer to "Copying the Oracle Client

Software to a Hard Disk" on page 3-4.

■

If you want to install the software from the installation media, refer to

"Installing the Oracle Client Software" on page 3-4.

Installing Oracle Database Client

3-3

Installing the Oracle Client Software

Copying the Oracle Client Software to a Hard Disk

If the system does not have a installation media, you can copy the software from the installation media to a file system on another system, then either mount that file system using NFS, or use FTP to copy the files to the system where you want to install the software.

To copy the contents of the installation media to a hard disk:

1.

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

$ mkdir OraCl11g

2.

Change directory to the directory you created in step 1:

$ cd OraCl11g

3.

4.

Mount the disk, if it is not already mounted.

Some platforms automatically mount the disk when you insert it into the drive. If

the disk does not mount automatically, refer to the "Mounting Disks" section on page 3-3 for platform-specific information about mounting it.

Copy the contents of the mounted disk to the corresponding new subdirectory as follows:

$ cp -R /directory_path OraCl11g

5.

In this example, /directory_path is the disk mount point directory, for example /mnt/dvd on Red Hat Enterprise Linux systems, or the path of the client directory on the installation media. The mount point directory is /dvd.

If necessary, mount the next disk and repeat step 5.

Installing the Oracle Client Software

Use Oracle Universal Installer to install the Oracle Client software. The following section describes how to install the Oracle software.

Note:

If you have an existing HP-UX 11.23 installation with patch

PHSS_34824

installed, then you must deinstall this patch before installing or upgrading to Oracle Database 11g Release 1. If you do not remove this patch, then Oracle Database installation fails.

Running Oracle Universal Installer

This section describes the Basic Installation as a default setting. For any type of installation process, start Oracle Universal Installer and install the software, as follows:

1.

2.

Log on as a member of the Administrators group to the computer on which to install Oracle components.

If you are installing the software from installation media, mount the disk if it is not already mounted.

If the disk does not mount automatically, refer to the

"Mounting Disks" section on page 3-3 for platform-specific information about mounting it.

Some platforms automatically mount the disk when you insert the installation media into the drive.

3-4

Oracle Database Client Installation Guide

Installing the Oracle Client Software

3.

To start Oracle Universal Installer, complete one of the following steps depending on the location of the installation files:

Note:

Start Oracle Universal Installer from the terminal session where you logged in as the oracle user and set the user’s

environment (described in Chapter 2

).

■

■

If the installation files are on disk, enter a command similar to the following, where directory_path is the path of the client directory on the installation media:

$ /directory_path/runInstaller

If the installation files are on the hard disk, change directory to the client directory and enter the following command:

$ ./runInstaller

4.

5.

If Oracle Universal Installer is not displayed, refer to the

"X Window Display

Errors" on page C-1 for information about troubleshooting.

In the Select a Product to Install screen, select Oracle Client and click Next.

In the Select Installation Type screen, select the type of installation that you want:

Instant Client

, Administrator, Runtime, or Custom and click Next.

See Also:

"Oracle Client Installation Types" for more information on

these installation types.

6.

7.

8.

9.

In the Install Location screen, enter the following details:

■

■

Oracle base path: Enter the directory location for Oracle base. Do not include spaces in the path name.

Name: Enter the name of the Oracle home.

Do not install Oracle Client 11g release 1 (11.1) software into an existing Oracle home that contains Oracle Database 11g or earlier software. You can install

Oracle Client into an existing Oracle home that contains Oracle Database

Client 11g release 1 (11.1) or later software, so long as Oracle Database is not installed in the same home.

■

Oracle home path: This field is populated by default in concurrence with

Oracle base location.

Click Next.

If you selected Custom in Step 5, in the Available Product Components screen,

select the components you want to install and click Next or Install.

In the Product-specific Prerequisite Checks screen, correct any errors that Oracle

Universal Installer may have found, and then click Next.

10.

In the Summary screen, check the installed components listing and click Install.

11.

If you have selected Custom installation types, follow steps 12 to 20 to complete

the Oracle Net Configuration Assistant procedure.

If you have selected the Administrator or Runtime installation type, then Net

Configuration Assistant is invoked as a part of the installation. Click Next to

Installing Oracle Database Client

3-5

Installing the Oracle Client Software complete the installation You should then start the Net Configuration Assistant

and follow steps 12 to 20 to complete configuration process.

If you selected the Instant Client installation type, go to Step 21. After you

complete the installation, you can follow the steps under

"Connecting Instant

Client or Instant Client Light to an Oracle Database" on page 4-4 to configure the

database connection.

12.

In the Oracle Net Configuration Assistant: Welcome screen, either select Perform

typical configuration

to use a default configuration, or select the Naming

Methods

configuration option. Then click Next. (The remaining steps in this procedure assume you are using Naming Methods.)

13.

In the Naming Methods Configuration, Select Naming Methods screen, select the naming method you want and then click Next.

In most cases, Local Naming is sufficient.

14.

In the Net Service Name Configuration, Service Name screen, enter the name of the database service to which you want to connect. Click Next.

For example, to connect to a database named sales, enter sales.

15.

In the Net Service Name Configuration, Select Protocol screen, depending on the protocol you selected, enter the appropriate information and click Next.

16.

In the Net Service Name Configuration, TCP/IP Protocol screen, enter the host name of the computer where the Oracle database is installed. Specify the port number, then click Next.

For example, to connect to the computer shobeen, you would enter shobeen.

17.

In the Net Service Name Configuration, Test screen, click Yes to perform a test of the connection. Then click Next.

In most cases, the test fails only because the default user name and password

Oracle Universal Installer supplies in the dialog box do not match the user name and password for the target database. Click Change Login, reenter the user name and password, and then click OK.

18.

In the Connecting screen, click Next.

19.

In the Net Service Name screen, enter the name of the net service name to use.

20.

Answer the remaining prompts to complete the configuration.

21.

In the End of Installation screen, click Exit, then click Yes to exit from Oracle

Universal Installer.

22.

Go to Chapter 4, "Oracle Database Postinstallation Tasks" to complete the

postinstallation tasks.

3-6

Oracle Database Client Installation Guide

4

4

Oracle Database Postinstallation Tasks

This chapter describes how to complete postinstallation tasks after you have installed the software. It includes information about the following topics:

■

■

Required Postinstallation Tasks

Recommended Postinstallation Tasks

■

Required Product-Specific Postinstallation Tasks

You must perform the tasks listed in the

"Required Postinstallation Tasks" section.

Oracle recommends that you perform the tasks listed in the "Recommended

Postinstallation Tasks" section after all installations.

If you install and intend to use any of the products listed in the

"Required

Product-Specific Postinstallation Tasks"

section, then you must perform the tasks listed in the product-specific subsections.

Note:

This chapter describes basic configuration only. Refer to

Oracle Database Administrator's Reference for Linux and UNIX, Oracle

Database Administrator's Guide and product-specific administration and tuning guides for more detailed configuration and tuning information.

Required Postinstallation Tasks

You must perform the tasks described in the following sections after completing an installation:

■

■

■

Downloading and Installing Patches

Updating Instant Client

Connecting with Instant Client

Downloading and Installing Patches

Check the My Oracle Support (formerly OracleMetaLink) Web site for required patches for the installation.

Note:

You cannot update Instant Client by downloading a patch.

Use the procedure under "Updating Instant Client" on page 4-2 to

update Instant Client.

Oracle Database Postinstallation Tasks

4-1

Required Postinstallation Tasks

To download required patches:

1.

Use a Web browser to view the My Oracle Support (formerly OracleMetaLink)

Web site: https://support.oracle.com

2.

Log in to My Oracle Support (formerly OracleMetaLink).

Note:

If you are not an My Oracle Support (formerly

OracleMetaLink) registered user, click Register Here and follow the registration instructions.

4.

5.

3.

On the main My Oracle Support (formerly OracleMetaLink) page, click Patches

and Updates

.

Select Simple Search.

Specify the following information, then click Go:

■

■

■

■

In the Search By field, choose Product or Family, then specify RDBMS Server.

In the Release field, specify the current release number.

In the Patch Type field, specify Patchset/Minipack.

In the Platform or Language field, select your platform.

Updating Instant Client

To update Instant Client:

1.

2.

Download Instant Client from Oracle Technology Network http://www.oracle.com/technology/index.html

.

If you want to place the files in the existing directory, then ensure that the directory is empty.

If you want to place the files into a different directory (and remove the previous files), ensure that you update the PATH environment variable setting to reflect the new location.

Note:

A restriction on using Instant Client or Instant Client Light is that you cannot perform patch upgrades on it using the opatch utility. The reason is that the Instant Client installation does not create an inventory, which the patch upgrade process must perform. The absence of an inventory also means that installed intern patch reporting and conflict detection before a patch attempt are not possible.

Connecting with Instant Client

If you installed the Instant Client installation type, you can configure users’ environments to enable dynamically linked client applications to connect to a database as follows:

1.

Set the appropriate shared library path environment variable for the platform to specify the directory that contains the Instant Client libraries. For the Instant

4-2

Oracle Database Client Installation Guide

Recommended Postinstallation Tasks

Client installation type, this directory is the Oracle home directory that you specified during the installation, for example:

/u01/app/oracle/product/11.1.0/client_1

2.

Use one of the following methods to specify database connection information for the client application:

■

Specify a SQL connect URL string using the following format:

//host:port/service_name

■

■

Set the TNS_ADMIN environment variable to specify the location of the tnsnames.ora

file and specify a service name from that file.

Set the TNS_ADMIN environment variable and set the TWO_TASK environment variable to specify a service name from the tnsnames.ora file.

Note:

You do not have to specify the ORACLE_HOME environment variable.

Recommended Postinstallation Tasks

Oracle recommends that you perform the tasks described in the following section after completing an installation:

■

■

■

■

■

■

Configuring Instant Client Light

Creating a Backup of the root.sh Script

Connecting Instant Client or Instant Client Light to an Oracle Database

Setting Up User Accounts

Setting the NLS_LANG Environment Variable

Generating the Client Static Library

Configuring Instant Client Light

When you install Instant Client, the Instant Client libraries are installed under the

ORACLE_HOME

directory and the Instant Client Light specific library is installed under the ORACLE_HOME/light directory. To configure Instant Client Light, you must replace the following files:

■

■

On HP-UX PA-RISC:

$ORACLE_HOME/libociei.sl

with $ORACLE_HOME/light/libociicus.sl

On HP-UX Itanium:

$ORACLE_HOME/libociei.so

with $ORACLE_HOME/light/libociicus.so

After replacing the library file, you must set the following environment variable to point to the location of the Instant Client shared library files:

■

On HP-UX PA-RISC:

■

SHLIB_PATH

On HP-UX Itanium:

LD_LIBRARY_PATH

Oracle Database Postinstallation Tasks

4-3

Recommended Postinstallation Tasks

Creating a Backup of the root.sh Script

Oracle recommends that you back up the root.sh script after you complete an installation. If you install other products in the same Oracle home directory, then

Oracle Universal Installer updates the contents of the existing root.sh script during the installation. If you require information contained in the original root.sh script, then you can recover it from the backed up root.sh file.

Connecting Instant Client or Instant Client Light to an Oracle Database

Before you can connect Instant Client (including Instant Client Light) to an Oracle database, ensure that the LD_LIBRARY_PATH environment variable specifies the directory that contains the Instant Client libraries. This directory is the ORACLE_HOME directory that you specified during installation.

For example, the shared libraries for Instant Client or Instant Client Light (if you have configured Instant Client Light), are in:

/u01/app/oracle/product/11.1.0/client_1

After you have checked the LD_LIBRARY_PATH environment variable, you can use any of the following methods to specify Oracle Database connection information for client applications:

■

■

■

Specifying a Connection by Using the Easy Connect Naming Method

Specifying a Connection by Configuring a tnsnames.ora File

Specifying a Connection by Using an Empty Connect String and the TWO_TASK

Environment Variable

Specifying a Connection by Using the Easy Connect Naming Method

You can specify a connection address to an Oracle Database directly from a client application, without having to configure a tnsnames setting for the Instant Client.

This method is convenient in that you do not have to create and manage a tnsnames.ora

file. However, the application users must specify the host name and port number when they want to log in to the application.

For example, you run SQL*Plus on the client computer and want to connect to the sales_us

database, which is located on a server whose host name is shobeen and port number is 1521, then you can log in as follows:

Enter user-name: system@admin@//shobeen:1521/sales_us

Similarly, in the application code, you can use Oracle Call Interface net naming methods to create the Instant Client-to-Oracle Database connection. For example, the following formats in the OCIServerAttach() call specify the connection information:

■

Specify a SQL connect URL string using the following format:

//host[:port][/service_name]

■

For example:

//shobeen:1521/sales_us

Alternatively, you can specify the SQL connect information as an Oracle Net keyword-value pair. For example:

"(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp) (HOST=shobeen) (PORT=1521))

4-4

Oracle Database Client Installation Guide

Recommended Postinstallation Tasks

(CONNECT_DATA=(SERVICE_NAME=sales_us)))"

See Also:

Oracle Call Interface Programmer's Guide for more information on using Oracle Call Interface Instant Client

Specifying a Connection by Configuring a tnsnames.ora File

By default, when you install Instant Client, Oracle Universal Installer does not include a sample tnsnames.ora file nor the Oracle Net Configuration Assistant utility normally used to create it. However, if you want to shield users from having to specify actual host names and port numbers, you may want to consider using a tnsnames.ora

file to set the Client-to-Oracle Database connection.

You can create the tnsnames.ora file manually by copying and modifying a version of this file from another Oracle installation, or you can use Oracle Net Configuration

Assistant to create and manage it for you.

To install Oracle Net Configuration Assistant:

1.

Run Oracle Universal Installer.

2.

3.

Select the Custom installation type.

In the Summary screen, click Install, then click Exit and Yes to exit Oracle

Universal Installer.

On each client computer, configure either of the following settings:

■

■

Set the TNS_ADMIN environment variable to specify the location of the tnsnames.ora

file and specify a service name from that file.

Place the tnsnames.ora file in the $ORACLE_HOME/network/admin directory, and ensure that the ORACLE_HOME environment has been set to this Oracle home.

See Also:

Oracle Call Interface Programmer's Guide for more information on Oracle Call Interface Instant Client connection strings

Specifying a Connection by Using an Empty Connect String and the TWO_TASK

Environment Variable

You can set the connect string to an empty connect string (""), and then set the TWO_

TASK

environment variable to one of the following values:

■

■

■

A direct address, as described under

"Specifying a Connection by Using the Easy

Connect Naming Method" on page 4-4

Oracle Net keyword-value pair

A tnsnames.ora entry and TNS_ADMIN is set to the location of tnsnames.ora

■

A tnsnames.ora entry and the following:

–

tnsnames.ora

file located in $ORACLE_HOME/network/admin

–

The ORACLE_HOME environment variable set to this Oracle home

This method allows the applications to specify internally a connection string if the application code itself uses an empty connection string. The benefit of an empty connect string is that the application itself does not need to specify the tnsnames.ora

entry. Instead, when a user invokes the application, the location of the database is determined by a script or the environment, depending on where you have set the TWO_TASK environment variable. The disadvantage of using empty strings is that you must configure this additional information in order for the application to connect to the database.

Oracle Database Postinstallation Tasks

4-5

Required Product-Specific Postinstallation Tasks

Setting Up User Accounts

For information about setting up additional user accounts, refer to Oracle Database

Administrator's Reference for Linux and UNIX.

Setting the NLS_LANG Environment Variable

NLS_LANG

is an environment variable that specifies the locale behavior for Oracle software. This variable sets the language and territory used by the client application and the database server. It also declares the character set of the client, which is the character set of data entered or displayed by an Oracle client program, such as

SQL*Plus.

See Also:

Appendix B, "Configuring Oracle Database

Globalization Support" for more information about the NLS_LANG

environment variable

Note:

The character set of the data displayed is determined by the environment of the operating system, such as keyboard driver and fonts in use. The NLS_LANG character set should match the operating system.

Generating the Client Static Library

The client static library (libclntst11.a) is not generated during installation. If you want to link the applications to the client static library, you must first generate it as follows:

1.

2.

Switch user to oracle.

Set the ORACLE_HOME environment variable to specify the Oracle home directory used by the Oracle Database installation. For example:

■

Bourne, Bash, or Korn shell:

$ ORACLE_HOME=/u01/app/oracle/product/11.1.0/db_1

$ export ORACLE_HOME

■

C shell:

% setenv ORACLE_HOME /u01/app/oracle/product/11.1.0/db_1

3.

Enter the following command:

$ $ORACLE_HOME/bin/genclntst

Required Product-Specific Postinstallation Tasks

The following sections describe platform-specific postinstallation tasks that you must perform if you install and intend to use the products mentioned:

■

■

Configuring Oracle Net Services

Configuring Oracle Precompilers

Note:

You need only perform postinstallation tasks for products that you intend to use.

4-6

Oracle Database Client Installation Guide

Required Product-Specific Postinstallation Tasks

Configuring Oracle Net Services

If you have an earlier release of Oracle software installed on this system, you might want to copy information from the Oracle Net tnsnames.ora and listener.ora configuration files from the earlier release to the corresponding files for the new release.

Note:

The default location for the tnsnames.ora and listener.ora

files is the $ORACLE_HOME/network/admin/ directory. However, you can also use a central location for these files.

If necessary, you can also add connection information for additional database instances to the new file.

Configuring Oracle Precompilers

This section describes postinstallation tasks for Oracle precompilers:

■

■

Configuring Pro*C/C++

Configuring Pro*FORTRAN

Note:

All precompiler configuration files are located in the

$ORACLE_HOME/precomp/admin

directory.

Configuring Pro*C/C++

Verify that the PATH environment variable setting includes the directory that contains the C compiler executable.

Table 4–1 shows the default directories and the appropriate command to verify the

path setting of the compiler.

Table 4–1 C/C++ Compiler Directory

Path Command

/usr/bin

/opt/ansic/bin

$ which gcc

$ which cc

Configuring Pro*FORTRAN

Verify that the PATH environment variable setting includes the directory that contains the FORTRAN compiler executable. You can verify the path setting by using the whichf90

command.

Oracle Database Postinstallation Tasks

4-7

Required Product-Specific Postinstallation Tasks

4-8

Oracle Database Client Installation Guide

5

5

Removing Oracle Software

This chapter describes how to completely remove all Oracle software from an Oracle home directory.

Removing Oracle Software

The following steps describe how to use Oracle Universal Installer to remove Oracle software from an Oracle home:

Note:

Always use Oracle Universal Installer to remove Oracle software. Do not delete any Oracle home directories without first using Oracle Universal Installer to remove the software.

1.

If necessary, log in as the oracle user:

$ su - oracle

2.

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

■

Bourne, Bash, or Korn shell:

$ ORACLE_HOME=/u01/app/oracle/product/11.1.0/db_1

$ export ORACLE_HOME

■

C shell:

% setenv ORACLE_HOME /u01/app/oracle/product/11.1.0/db_1

3.

Start Oracle Universal Installer as follows:

$ $ORACLE_HOME/oui/bin/runInstaller

4.

5.

In the Welcome window, click Deinstall Products.

The Inventory screen appears, listing all of the Oracle homes on the system.

In the Inventory screen, select the Oracle home and the products that you want to remove, then click Remove.

Note:

If you choose to remove Oracle JVM, Oracle Universal

Installer removes all installed products that depend on Oracle JVM, including Oracle Database 11g.

Removing Oracle Software

5-1

Removing Oracle Software

7.

8.

6.

Oracle Universal Installer displays a confirmation window asking you to confirm that you want to deinstall the products and their dependent components.

Click Yes.

Oracle Universal Installer displays a progress indicator as it removes the software.

Click Close on the Inventory screen.

When the products have been deleted, click Cancel to exit from Oracle Universal

Installer, and then click Yes.

5-2

Oracle Database Client Installation Guide

A

A

Installing and Configuring Oracle Database

Using Response Files

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

■

■

■

How Response Files Work?

Preparing a Response File

Running Oracle Universal Installer Using a Response File

How Response Files Work?

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 prompt. It includes information about the following topics:

■

■

Reasons for Using Silent Mode or Noninteractive Mode

General Procedure for Using Response Files

Typically, Oracle Universal Installer runs in interactive mode, which means that it prompts you to provide information in graphical user interface (GUI) screens. When you use response files to provide this information, you run Oracle Universal Installer at a command prompt using either of the following modes:

■

Silent mode

■

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.

Noninteractive (or suppressed) mode

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.

Installing and Configuring Oracle Database Using Response Files

A-1

How Response Files Work?

You define the settings for a silent or noninteractive installation by entering values for the variables listed in the response file. For instance, to specify the Oracle home name, you would supply the appropriate value for the ORACLE_HOME_NAME variable, as in the following example:

ORACLE_HOME_NAME="OraCLHome1"

Another way of specifying the response file’s variable settings is to pass them as command line arguments when you run Oracle Universal Installer. For example:

-silent "ORACLE_HOME_NAME=OraDBHome1" ...

In this command, directory_path is the path of the database directory on the

DVD or the path of the Disk1 directory on the hard drive.

This method is particularly useful if you do not want to embed sensitive information, such as passwords, in the response file. For example:

-silent "s_dlgRBOPassword=binks342" ...

Ensure that you enclose the variable and its setting in quotes.

See Also:

Oracle Universal Installer and OPatch User's Guide for more information about response file formats.

Reasons for Using Silent Mode or Noninteractive Mode

The following table describes several reasons why you might want to run Oracle

Universal Installer in silent mode or suppressed mode.

Mode

Silent

Suppressed

(noninteractive)

Uses

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.

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, then Oracle Universal Installer displays that screen. It suppresses screens for which you have provided all of the required information.

General Procedure for Using Response Files

The following are the general steps to install and configure Oracle products using

Oracle Universal Installer in silent or suppressed mode:

A-2

Oracle Database Client Installation Guide

Preparing a Response File

Note:

You must complete all required preinstallation tasks on a system before running Oracle Universal Installer in silent or suppressed mode.

1.

2.

Create the oraInst.loc file.

Prepare a response file.

3.

4.

Run Oracle Universal Installer in silent or suppressed mode.

If you completed a software-only installation, then run Net Configuration

Assistant and Database Configuration Assistant in silent or noninteractive mode if required.

These steps are described in the following sections.

Preparing a Response File

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

■

■

Editing a Response File Template

Recording a Response File

Editing a Response File Template

This method is most useful for the Enterprise Edition or Standard Edition installation types.

Oracle provides response file templates for each product and installation type, and for each configuration tool. These files are located at database/response directory on the installation media.

Note:

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

Table A–1 lists the response files provided with Oracle Database.

Table A–1 Response Files

Response File

instantClient.rsp

clientadmin.rsp

clientruntime.rsp

clientcustom.rsp

Description

Instant Client installation of Oracle Client

Administrator installation of Oracle Client

Runtime installation of Oracle Client

Custom installation of Oracle Client

To copy and modify 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

Installing and Configuring Oracle Database Using Response Files

A-3

Preparing a Response File

2.

In this example, directory_path is the path to the database directory on the installation media. If you have copied the software to a hard drive, then you can edit the file in the response directory if you prefer.

Open the response file in a text editor:

$ vi /local_dir/response_file.rsp

In addition to editing settings specific to the Oracle Database installation, check that the FROM_LOCATION path is correct and points to the products.xml file in the stage directory in the installation media. You may want to set this variable to point to an absolute path, for example:

FROM_LOCATION="/directory_path/stage/products.xml"

Remember that you can specify sensitive information, such as passwords, at the

command line rather than within the response file. "How Response Files Work?" on page A-1 explains this method.

See Also:

Oracle Universal Installer and OPatch User's Guide for detailed information on creating response files

3.

Follow the instructions in the file to edit it.

Note:

Oracle Universal Installer or configuration assistant fails if you do not correctly configure the response file. Refer to

"Silent-Mode Response File Error Handling" section on page C-4 for

more information about troubleshooting a failed silent-mode installation.

Recording a Response File

You can use Oracle Universal Installer in interactive mode to record a response file, which you can edit and then use to complete silent-mode or suppressed-mode installations. This method is useful for custom or software-only installations.

When you record 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.

If you use record mode during a noninteractive mode installation, then Oracle

Universal Installer records the variable values that were specified in the original source response file into the new response file.

Note:

You cannot use record mode to create a response file during an installation that uses the Basic installation method.

To record a response file:

1.

Complete the preinstallation tasks listed in Chapter 2

.

2.

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 preinstallation tasks and record the response file while completing an installation.

If you have not installed Oracle software on this system previously, create the oraInst.loc

file, as described in the previous section.

A-4

Oracle Database Client Installation Guide

Running Oracle Universal Installer Using a Response File

3.

4.

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.

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, then Oracle Universal Installer fails.

$ /directory_path/runInstaller -record -destinationFile response_filename

5.

6.

7.

8.

In this command:

■

directory_path

is the path of the database 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

response_filename

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

On each Oracle Universal Installer screen, specify the required information.

When Oracle Universal Installer displays the Summary screen, perform one of the following actions:

■

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

■

Click Cancel and 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.

If you do not complete the installation, then delete the Oracle home directory that

Oracle Universal Installer created using the path you specified on the Specify File

Locations screen.

Before using the recorded response file on another system, edit the file and make any required changes.

Use the instructions in the file as a guide when editing it.

Running Oracle Universal Installer Using a Response File

Now, you are ready to run Oracle Universal Installer at the command line, specifying the response file you created, to perform the installation. The Oracle Universal

Installer executable, runInstaller, provides several options. For help information on the full set of these options, run the runInstaller command with the -help option, for example:

$ directory_path/runInstaller -help

The help information appears in a window after some time.

To run Oracle Universal Installer using a response file:

1.

2.

Complete the preinstallation tasks listed in

Chapter 2

.

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

Installing and Configuring Oracle Database Using Response Files

A-5

Running Oracle Universal Installer Using a Response File

3.

If you are completing a suppressed-mode installation, set the DISPLAY environment variable.

Note:

You do not have to set the DISPLAY environment variable if you are completing a silent-mode installation.

4.

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

$ /directory_path/runInstaller [-silent] [-noconfig] \

-responseFile responsefilename

Note:

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

In this example:

■

directory_path

is the path of the database 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.

responsefilename

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

5.

When the installation completes, log in as the root user and run the root.sh script:

$ su password:

# /oracle_home_path/root.sh

A-6

Oracle Database Client Installation Guide

B

B

Configuring Oracle Database Globalization

Support

This appendix describes the following Globalization Support topics:

■

Installing and Using Oracle Components in Different Languages

■

Running Oracle Universal Installer in Different Languages

Installing and Using Oracle Components in Different Languages

This section describes the following procedures:

■

■

Configuring Oracle Components to Run in Different Languages

Installing Translation Resources

Configuring Oracle Components to Run in Different Languages

You can specify the language and the territory, or locale, in which you want to use

Oracle components. The locale setting of a component determines the language of the user interface of the component and the globalization behavior, such as date and number formatting. Depending on the Oracle component, the locale of the component is either inherited from the operating system session that started the component, or is defined by the NLS_LANG environment variable.

The operating system locale usually influences Oracle components that are based on

Java technology. The NLS_LANG environment variable usually influences Oracle components that use Oracle Client libraries such as OCI.

Note:

The user interface of an Oracle component will be displayed in a selected language only if the appropriate translation is available and has been installed. Otherwise, the user interface will be displayed in

English.

Determining the Operating System Locale by Using the LANG Environment Variable

The locale setting of your operating system session determines the language of the user interface and the globalization behavior for components such as Oracle Universal

Installer, Oracle Net Configuration Assistant, and Oracle Database Configuration

Assistant. It also determines the globalization behavior of Oracle Database sessions created by a user application through Oracle JDBC driver, unless overridden by the application.

Configuring Oracle Database Globalization Support

B-1

Installing and Using Oracle Components in Different Languages

The operating system locale on HP-UX is determined by the value of the LANG environment variable. Depending on your desktop environment, such as CDE,

GNOME, or telnet, you can select a default session locale on a login screen, in a configuration panel, or in a configuration file.

Note:

Refer to the operating system documentation on how to select a locale for the operating system session in your desktop environment.

You can modify the LANG variable in the environment of your shell to start an Oracle component in a selected language.

For example, to start Oracle Database Configuration Assistant in German, enter one of the following commands:

Note:

The LC_ALL environment variable overrides the value of the

LANG

environment variable. For the commands listed in this section to work, either ensure that the LC_ALL environment variable is not set in the environment, or substitute LC_ALL for LANG.

■

■

C shell (csh):

$ (setenv LANG de_DE.iso88591; dbca)

Bourne shell (sh) or Korn shell (ksh):

$ LANG=de_DE.iso88591 dbca

To modify the operating system locale for all Oracle components started from now on by the given shell, modify the LANG variable using one of the following commands:

■

C shell (csh):

$ setenv LANG de_DE.iso88591

$ ...

■

Bourne shell (sh) or Korn shell (ksh):

$ LANG=de_DE.iso88591; export LANG

$ ...

The value of the LANG environment variable must be a valid operating system locale.

To see the list of valid locales, enter the following command:

$ locale -a

Note:

Refer to the operating system documentation for a mapping between values of the LANG environment variable and the languages and territories that they represent.

Configuring Locale and Character Sets by Using the NLS_LANG Environment

Variable

The NLS_LANG environment variable determines the language of the user interface and the globalization behavior for components such as SQL*Plus, exp, and imp. It sets

B-2

Oracle Database Client Installation Guide

Installing and Using Oracle Components in Different Languages the language and territory used by the client application and the database. It also declares the character set for entering and displaying data by the client application.

The NLS_LANG environment variable uses the following format:

NLS_LANG=language_territory.characterset

In this format:

■

language

specifies the language used for displaying user interface, error messages, sorting, day names, and month names

■

■

territory

specifies the conventions for default date, monetary and numeric formats

characterset

specifies the encoding used by the client application

In most cases, this is the Oracle character set that corresponds to the character set of the user terminal or the operating system.

The NLS_LANG environment variable is set as a local environment variable for the shell on all UNIX-based platforms. For example, if the operating system locale setting is en_US.utf8, then the corresponding value of NLS_LANG environment variable is

AMERICAN_AMERICA.AL32UTF8

.

See Also:

Oracle Database Globalization Support Guide for information about the NLS_LANG and other Globalization Support parameters

The following examples illustrate some of the valid values for the NLS_LANG environment variable.

Note:

Refer to the operating system documentation for information on how to determine the operating system locale environment setting.

Operating System Locale

French (France)

Japanese (Japan)

NLS_LANG

Values

FRENCH_FRANCE.WE8ISO8859P15

FRENCH_FRANCE.WE8ISO8859P1

FRENCH_FRANCE.WE8MSWIN1252

FRENCH_FRANCE.AL32UTF8

JAPANESE_JAPAN.JA16EUC

JAPANESE_JAPAN.JA16SJIS

JAPANESE_JAPAN.AL32UTF8

Installing Translation Resources

To view the user interface of Oracle components in different languages, you must install the appropriate language translations along with the component. To select the translation resources that you want to install:

1.

Start Oracle Universal Installer.

2.

3.

On the Select Installation Type screen, click Product Languages.

On the Language Selection screen, select the language in which you want to use

Oracle components from the Available Languages field.

Configuring Oracle Database Globalization Support

B-3

Running Oracle Universal Installer in Different Languages

Note:

The Available Languages field lists all languages supported by

Oracle globalization libraries. The set of languages for which a translation is actually available is usually smaller and depends on a particular component. The scope of translation for a given component may differ between languages. For example, some translations may include all user interface text, while others may include only error messages and no help files.

4.

Use the > arrow to move the selected language to the Selected Languages field, and then click OK.

Note:

Oracle Universal Installer will ignore languages in the Selected

Languages field for which no translation is available.

5.

Select the products you want, and then click Next.

Running Oracle Universal Installer in Different Languages

Your operating system locale determines the language in which Oracle Universal

Installer runs. Oracle Universal Installer may run in one of the following languages:

■

■

■

■

■

■

■

■

Brazilian Portuguese (pt_BR)

French (fr)

German (de)

Italian (it)

Japanese (ja)

Korean (ko)

Simplified Chinese (zh_CN)

Spanish (es)

■

Traditional Chinese (zh_TW)

To run Oracle Universal Installer in one of the available languages, change the locale in which your operating system session is running before you start Oracle Universal

Installer with the ./runInstaller command. If the selected language is not one of the listed previoulsly, Oracle Universal Installer runs in English.

You must ensure that the selected value for the LANG environment variable starts with the appropriate language abbreviation. In the aforementioned list of languages, in which Oracle Universal Installer can run, the required abbreviation appears in parentheses beside the language name. For example, fr_FR and fr_CA are valid values to run the Oracle Universal Installer in French.

B-4

Oracle Database Client Installation Guide

C

C

Troubleshooting

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

■

■

Verify Requirements

X Window Display Errors

■

■

■

■

■

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

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 preinstallation

tasks specified in Chapter 2

.

Read the Release Notes

Read the release notes for the product before installing it. The release notes are available on the Oracle Database 11g DVD. The latest version of the release notes is also available on the Oracle Technology Network Web site: http://www.oracle.com/technology/documentation/

X Window Display Errors

If you run Oracle Universal Installer on a remote system and you want to display

Oracle Universal Installer’s user interface on your local system, you might see error messages similar to the following:

"Failed to connect to server"

"Connection refused by server"

"Can’t open display"

If you see one of these error messages, follow these steps:

Troubleshooting

C-1

What to Do If an Installation Error Occurs?

Note:

This procedure applies only to users of UNIX workstations.

If you are using a PC or other system with X server software installed, refer to the X server documentation for information about how to permit remote systems to display X applications on the local system.

1.

2.

In a local terminal window, log in as the user that started the X Window session.

Enter the following command:

$ xhost fully_qualified_remote_host_name

For example:

$ xhost somehost.us.example.com

3.

Enter the following commands, where workstation_name is the host name or IP address of your workstation:

■

Bourne, Bash, or Korn shell:

$ DISPLAY=workstation_name:0.0

$ export DISPLAY

■

C shell:

% setenv DISPLAY workstation_name:0.0

4.

To determine whether X Window applications display correctly on the local system, enter the following command:

$ xclock

5.

The X clock should appear on your monitor.

If the X clock appears, close the X clock and start Oracle Universal Installer again.

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 "Reviewing the Log of an Installation Session" section on page C-2.

If you encounter an error while a configuration assistant is running, refer to

"Troubleshooting Configuration Assistants" section on page C-3.

If you cannot resolve the problem, remove the failed installation by following the steps listed in the

"Cleaning Up After a Failed Installation" section on page C-4.

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.

C-2

Oracle Database Client Installation Guide

Troubleshooting Configuration Assistants

To view the log file, follow these steps:

1.

If necessary, enter the following command to determine the location of the oraInventory

directory:

$ cat /var/opt/oracle/oraInst.loc

2.

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

directory.

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

5.

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

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

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 on page C-2.

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 "Irrecoverable Error. Reinstall" message, look for the cause of the problem by reviewing the log files. Refer to

"Irrecoverable Errors" on page C-4 for

further instructions.

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:

Troubleshooting

C-3

Silent-Mode Response File Error Handling

Status

Configuration assistant succeeded

Configuration assistant failed

Configuration assistant cancelled

Result Code

0

1

-1

Irrecoverable Errors

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

1.

2.

3.

Remove the failed installation as described in the

"Cleaning Up After a Failed

Installation" section on page C-4.

Correct the cause of the irrecoverable error.

Reinstall the Oracle software.

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

For example, a common problem is that while all the product-specific data is filled out correctly, the staging area location may be incorrect. If this is the case, check the FROM_LOCATION variable and ensure that it points to the products.xml file in the installation media. In the installation media, this products.xml is in response/stage

.

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.

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.

2.

Start Oracle Universal Installer as described in

"Installing the Oracle Client

Software" on page 3-4.

Click Deinstall Products on the Welcome window or click Installed Products on any Installer window.

The Inventory window appears, listing installed products.

C-4

Oracle Database Client Installation Guide

Cleaning Up After a Failed Installation

3.

4.

5.

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

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

Reinstall the Oracle software.

To reinstall, you must drop either one or two database schemas, depending upon the installation type.

Troubleshooting

C-5

Cleaning Up After a Failed Installation

C-6

Oracle Database Client Installation Guide

D

D

Frequently Asked Questions About

Installation

Use the following guidelines to decide how to install Oracle Database components:

■

Installing Oracle Database or Oracle Client

■

■

■

Installing Oracle Database Tools

Installing Oracle Database with Oracle Applications

Installing Oracle Database Heterogeneous Connectivity Tools (Gateways)

Note:

Some Oracle Database components may not be available on all platforms. Consult your platform-specific installation guide or release notes.

Installing Oracle Database or Oracle Client

The following are frequently asked questions about installing Oracle database:

■

■

■

■

■

■

■

■

I only need one instance of Oracle Database or I just want to install a test database to get familiar with the product. How do I install Oracle Database for these situations?

How can I create an Oracle database that can handle transaction-heavy or data warehousing applications?

What’s the best way to install multiple Oracle databases?

How do I configure client connections to an Oracle database?

What is the best way to install Oracle Client if my client nodes have limited disk space?

How do I upgrade Oracle Database?

The computers at my site have been configured to run as a cluster. How should I install Oracle Database?

How do I migrate my non-Oracle databases to Oracle Database?

I only need one instance of Oracle Database or I just want to install a test database to get familiar with the product. How do I install Oracle Database for these situations?

■

If you want a quick installation using the default installation settings, then refer to the platform-specific Oracle Database Quick Installation Guide.

Frequently Asked Questions About Installation

D-1

Installing Oracle Database or Oracle Client

■

If your site has special requirements, then refer to platform-specific Oracle Database

Installation Guide for more information.

How can I create an Oracle database that can handle transaction-heavy or data warehousing applications?

If you want to create a starter database designed for transaction-heavy or data warehousing applications, then refer to platform-specific Oracle Database Installation

Guide for more details. Select the Advanced Installation method, and then select the database type you want on the Select Database Configuration screen.

See Also:

Oracle Database Data Warehousing Guide after installation

Alternatively, you can install Oracle OLAP during the Oracle Database installation.

Oracle OLAP provides optimal support for database environments that must meet

OLAP requirements. To do so, select Advanced Installation, then Custom, and on the

Available Product Components screen, select Oracle OLAP.

See Also:

■

■

■

Oracle OLAP User's Guide

Oracle OLAP DML Reference

Oracle OLAP Java API Reference

What’s the best way to install multiple Oracle databases?

Use platform-specific Oracle Database Installation Guide to install Oracle Database using either of the following methods:

■

■

Installing with response files

: This method lets you run Oracle Universal Installer at a command line using a response file that contains settings specific to each computer.

Cloning an existing Oracle home

: Install Oracle Database in one computer using interactive mode. Afterwards, you can clone its existing Oracle home in each location and then create a new database from there. You can also clone databases, which is described in Oracle Database Administrator's Guide.

How do I configure client connections to an Oracle database?

1.

Install Oracle Database on a server by using platform-specific Oracle Database

Installation Guide for more information.

2.

Use this guide to install Oracle Client on each client node, and select the Instant

Client installation type.

If you have many client nodes, consider staging the software centrally, mapping the drive, and running Oracle Universal Installer in the noninteractive mode.

If the client nodes only require a default installation into a new Oracle home directory, consider using platform-specific Oracle Database Installation Guide for more information.

What is the best way to install Oracle Client if my client nodes have limited disk space?

1.

Install Oracle Database onto a server by using platform-specific Oracle Database

Installation Guide for more details.

2.

Use this guide to install Oracle Client on each client node, and select the Instant

Client installation type.

D-2

Oracle Database Client Installation Guide

Installing Oracle Database Tools

If you have many client nodes, then consider running Oracle Universal Installer in noninteractive mode.

How do I upgrade Oracle Database?

Refer to Oracle Database Upgrade Guide.

See Also:

Oracle Database Administrator's Guide if you want to use software cloning to upgrade Oracle Database

The computers at my site have been configured to run as a cluster. How should I install Oracle Database?

Use any of the following installation scenarios:

■

■

■

If you want to run a single-instance Oracle Database in a clustered environment, then install Oracle Clusterware either before or after you install Oracle Database.

If you want a consolidated pool of storage for all databases in a cluster, then install

Oracle Clusterware first and use Automatic Storage Management to manage this storage. Afterwards, install Oracle Database (which can be either single instance or

Real Application Clusters).

If you plan to use Oracle Real Application Clusters, first install Oracle

Clusterware, and then install Oracle Real Application Clusters.

Refer to platform-specific Oracle Clusterware Installation Guide andOracle Real

Application Clusters Installation Guide for HP-UX for the platform to install Oracle

Clusterware or Oracle Real Application Clusters. Oracle Clusterware is available on the Oracle Clusterware installation media. Refer to platform-specific Oracle Database

Installation Guide which explains how to install Automatic Storage Management and

Oracle Database.

Oracle Clusterware is a key component required by Oracle Real Application Clusters installations. Oracle Clusterware is an integrated cluster management solution that can bind multiple servers together to act as a single system. This is referred to as a cluster.

It performs workload management and component restart. For example, when an instance supporting a particular service fails, Oracle Clusterware restarts the service on the next available instance that you have configured for that service. Oracle

Clusterware can monitor non-Oracle programs, as long as they are defined within the

Oracle Clusterware environment using the High Availability API.

How do I migrate my non-Oracle databases to Oracle Database?

Use Oracle Migration Workbench to migrate your non-Oracle databases and applications to Oracle. Oracle Migration Workbench software and documentation are available at: http://www.oracle.com/technology/tech/migration/index.html

Installing Oracle Database Tools

The following are frequently asked questions about installing Oracle database tools:

■

■

■

■

How do I install Oracle Application Server?

How can I administer and monitor my Oracle Database products?

How do I manage security for my Oracle Database products?

How do I use Oracle Database to manage my XML data?

Frequently Asked Questions About Installation

D-3

Installing Oracle Database Tools

■

■

■

■

■

Does Oracle Database provide OLAP tools so that I can analyze data such as trends and time series in my database?

Does Oracle Database provide data mining tools that I can use to discover hidden meaning in my data and predict likely outcomes based on my data?

How do I perform backup and recovery operations for Oracle Database?

Is Oracle Workflow included with Oracle Database 11g?

Is there a migration plan for customers that have built solutions using Oracle

Workflow?

How do I install Oracle Application Server?

Refer to Oracle Application Server Installation Guide. How you install Application Server depends on whether you already have Oracle Database installed:

■

■

If you do not have Oracle Database installed or you do not want Oracle

Application Server to use any of your existing Oracle Databases, then Oracle

Universal Installer lets you install a separate Oracle Application Server instance.

This database is populated with the metadata that Oracle Application Server must run.

If you want Oracle Application Server to use an existing Oracle Database, then do the following:

1.

2.

From the Oracle Application Server installation media, run Oracle Application

Server Repository Creation Assistant to populate your database with the metadata that Application Server needs.

Install the remaining Oracle Application Server components by following the instructions in the Oracle Application Server Installation Guide.

How can I administer and monitor my Oracle Database products?

To perform regular administrative functions such as creating, configuring, or deleting databases, or managing database templates, use one of the following methods:

To manage only the single database and listener that you are installing:

1.

Use platform-specific Oracle Database Installation Guide to install Oracle Database.

2.

From Oracle Database, use Database Configuration Assistant to manage your databases.

You can also administer and monitor the database with Oracle Enterprise

Manager Grid Control, which is installed by default with Oracle Database. Oracle

Enterprise Manager Grid Control includes the Oracle Management Agent, Oracle

Management Service, and Oracle Management Repository, and Grid Control, a browser-based central console through which administrators can perform all monitoring, administration, and configuration tasks for the enterprise.

See Also:

Oracle Enterprise Manager Grid Control Installation and Basic

Configuration available on the Enterprise Manager Grid Control installation media

To perform advanced administration tasks, such as monitoring Oracle Database and managing multiple hosts, application servers, and databases including the one that you are installing, install Oracle Enterprise Manager as follows:

1.

Use platform-specific Oracle Database Installation Guide to install Oracle Database.

D-4

Oracle Database Client Installation Guide

Installing Oracle Database Tools

2.

If you plan to use Oracle Real Application Clusters, then install Oracle Database by using platform-specific Oracle Clusterware Installation Guide and Oracle Real

Application Clusters Installation Guide for HP-UX.

Use Oracle Enterprise Manager Grid Control Installation and Basic Configuration to install and configure Oracle Enterprise Manager. For postconfiguration tasks, use

Oracle Enterprise Manager Advanced Configuration.

How do I manage security for my Oracle Database products?

Oracle provides a wide range of security solutions for your enterprise environment, including centralized administration and security features integrated with Oracle

Internet Directory. The set of Oracle security services called Oracle Platform Security integrates the security features built into Oracle Database, Oracle Application Server, and the Oracle Identity Management infrastructure. Combined, these features enable the development and deployment of secure e-business applications.

Oracle Identity Management includes Oracle Internet Directory, a centralized repository that simplifies administration of users and applications in the Oracle environment by the following components:

■

Oracle Internet Directory client tools, including LDAP command-line tools, the

Oracle Internet Directory SDK, and Oracle Directory Manager.

■

Oracle Internet Directory server components, including the directory server, the directory replication server, the directory integration server, and various tools for starting and stopping them.

Oracle Database includes the Oracle Internet Directory client tools, but not the Oracle

Internet Directory server components. To install the Oracle Internet Directory server components, run Oracle Universal Installer from an Oracle 10g Application Server installation.

See Also:

■

■

■

■

■

■

■

Oracle Application Server Installation Guide (to install Oracle

Identity Management)

Oracle Database Security Guide

Oracle Database Advanced Security Administrator's Guide

Oracle Database Enterprise User Security Administrator's Guide

Oracle Label Security Administrator's Guide

Oracle Application Server Security Guide

Oracle Technology Network topics on database security

( http://www.oracle.com/technology/deploy/security

/index.html

)

How do I use Oracle Database to manage my XML data?

Use Oracle XML DB, which is installed as part of Oracle Database. Oracle XML DB enables you to efficiently store, generate, retrieve, query, and manage XML data on your site. Oracle XML DB provides all the advantages of a relational database, for example, allowing you to control the referential integrity of XML data with constraints and triggers. It works well with large amounts of XML data by storing it in a parsed, relational form, which improves access performance.

Oracle XML DB supports XML Type, which is a native data type for XML data, for which you can choose various storage options depending on your needs. In addition,

Frequently Asked Questions About Installation

D-5

Installing Oracle Database Tools

Oracle XML DB supports XML Schema processing, structured and unstructured storage, a content repository that you can access by using common protocols (FTP,

HTTP(S), and WebDAV), and SQL/XML, which is a standard for SQL with XML. For

Oracle Database 11g Release 1 (11.1), Oracle XML DB introduced support for the

XQuery language for querying, transforming, and constructing XML; the ability for users to define their own metadata for schema-based XML; a set of new SQL functions for DML operations on XML data; and more.

You can use Oracle XML DB in conjunction with Oracle XML Developer’s Kit (XDK) to build applications that run on either Oracle Database or Oracle Application Server.

See Also:

■

■

Oracle XML DB Developer's Guide

Oracle XML Developer's Kit Programmer's Guide

Does Oracle Database provide OLAP tools so that I can analyze data such as trends and time series in my database?

Yes, install Oracle OLAP, which is provided in the Oracle Database installation. Oracle

OLAP provides optimal support for database environments that must meet OLAP requirements.

Use either of the following methods in Oracle Database Installation Guide to install

Oracle OLAP:

■

When you run Oracle Universal Installer, select the Custom installation type, and in the Available Product Components screen, select Oracle OLAP.

See Also:

■

■

■

Oracle OLAP User's Guide

Oracle OLAP DML Reference

Oracle OLAP Java API Reference

■

Select the Enterprise Edition installation type, and then on the Select Database

Configuration screen, select the Data Warehouse configuration.

See Also:

Oracle Database Data Warehousing Guide after installation

Does Oracle Database provide data mining tools that I can use to discover hidden meaning in my data and predict likely outcomes based on my data?

Yes. Install Oracle Data Mining, which is provided in the Oracle Database installation.

With the Oracle Data Mining option, you can create and execute predictive and descriptive data mining models that use a variety of algorithms.

Use the following method in platform-specific Oracle Database Installation Guide to install Oracle Data Mining:

1.

When you run Oracle Universal Installer, select the Enterprise Edition installation type.

2.

In the Select Database Configuration screen, select the General

Purpose/Transaction Processing

configuration.

D-6

Oracle Database Client Installation Guide

Installing Oracle Database with Oracle Applications

See Also:

The following manuals after you have installed Oracle

Data Mining:

■

■

Oracle Data Mining Concepts

Oracle Data Mining Administrator's Guide

■

■

■

Oracle Data Mining Application Developer's Guide

Oracle Data Mining Java API Reference

Oracle Database PL/SQL Packages and Types Reference (search for

Data Mining)

How do I perform backup and recovery operations for Oracle Database?

Use Oracle Database Recovery Manager (RMAN), which is a backup and recovery tool integrated into Oracle Database. This tool satisfies the pressing demands of high-performance, manageable backup, and recovery. Recovery Manager is native to the database server, automatically tracks database structure changes, and optimizes operations accordingly. In addition, Recovery Manager is integrated with leading tape media management products, so that Oracle database backups can be integrated with your existing networked data protection infrastructure.

See Also:

■

■

Oracle Database Backup and Recovery User's Guide

Oracle Database Backup and Recovery Reference

Is Oracle Workflow included with Oracle Database 11g?

Starting with Oracle Database 11g, Oracle Workflow is no longer released with the database. Oracle Workflow will be available with the Oracle E-Business Suite releases.

See Also:

Oracle Workflow statement of direction

( http://www.oracle.com/technology/products/ias/workf low/workflow_sod.html

)

Is there a migration plan for customers that have built solutions using Oracle

Workflow?

Starting January 2006, customers are encouraged to re-create and implement workflows using Oracle BPEL Process Manager. Oracle is in the process of creating a technical migration guide that will provide detailed recommendations for migrating

Oracle Workflow processes to Oracle BPEL Process Manager.

See Also:

Oracle Workflow statement of direction

( http://www.oracle.com/technology/products/ias/workf low/workflow_sod.html

)

Installing Oracle Database with Oracle Applications

The following are frequently asked questions about installing Oracle database with

Oracle applications:

■

■

■

■

How do I install my Oracle applications with Oracle Database?

How can I create Web applications that communicate with Oracle Database?

Which Web server can my Oracle applications use?

How can I migrate my non-Oracle applications to Oracle?

Frequently Asked Questions About Installation

D-7

Installing Oracle Database Heterogeneous Connectivity Tools (Gateways)

How do I install my Oracle applications with Oracle Database?

In most cases, install Oracle Database itself, then install the Oracle application. The

Oracle Universal Installer for that application prompts you for the connection information. Check the application documentation requirements.

If you must implement your applications with Oracle Real Applications Clusters databases, refer to Oracle Real Application Clusters Installation Guide for HP-UX and platform-specific Oracle Clusterware Installation Guide.

How can I create Web applications that communicate with Oracle Database?

Install Oracle Application Express and a web server:

Use platform-specific Oracle Database Installation Guide to install Oracle Database.

Oracle Application Express is automatically installed, when you install Oracle database.

Which Web server can my Oracle applications use?

Install Oracle HTTP Server, which ships on the Oracle Fusion Middleware Web Tier

Utilities 11g (11.1.1.2.0) media in your media pack, or use the XML DB HTTP Protocol

Server and the embedded PL/SQL Gateway that installs with Oracle Database 11g

Release 1.

Use Oracle Database Installation Guide to install Oracle Database.

How can I migrate my non-Oracle applications to Oracle?

Use Oracle Migration Workbench to migrate your non-Oracle applications to Oracle.

Oracle Migration Workbench software and documentation are available at: http://www.oracle.com/technology/tech/migration/index.html

Installing Oracle Database Heterogeneous Connectivity Tools (Gateways)

The following section discusses about Gateway products:

How can my Oracle applications access data in a non-Oracle database system?

How can my Oracle applications access data in a non-Oracle database system?

You can use Oracle Database Gateway as the connectivity tool to enable Oracle applications to access data in non-Oracle databases. The following are the functions of

Oracle Database Gateway:

■

■

Integrates a non-Oracle database into your Oracle Database environment.

Enables Oracle PL/SQL applications to integrate with APPC-enabled transactions, or access messages in IBM Websphere MQ.

You can install the Gateway product on a computer independent of the Oracle application, Oracle database, and non-Oracle database.

For example, suppose you have the following scenario:

■

Oracle Database is installed on an UNIX computer.

■

■

The Oracle application is installed on a Microsoft Windows computer and accesses data from the Oracle database on the UNIX computer.

The Oracle application must join data in a DB2 database on Solaris Operating

System and an Oracle Database on UNIX.

D-8

Oracle Database Client Installation Guide

Installing Oracle Database Heterogeneous Connectivity Tools (Gateways)

You have the option of installing the Database Gateway for DRDA on the Solaris computer where DB2 is running, on UNIX where Oracle is running, or on a third computer.

Table D–1 lists the non-Oracle database systems that you can access from Oracle

applications, and the Gateways products that are available for those systems.

Table D–1 Oracle Gateway Products

Non-Oracle Database

IBM DB2 Universal

Database (UDB)

IBM DB2 z/OS

IBM DB2/400

WebSphere MQ

CICS/TS

IMSTM

SQL Server

Sybase Adaptive Server

Teradata

Informix Server

Oracle Gateway Products and Documentation

Oracle Database Gateway for DRDA.

Use Oracle Database Gateway Installation and Configuration Guide for AIX 5L Based

Systems (64-Bit), HP-UX PA-RISC (64-Bit), HP-UX Itanium, Solaris Operating System

(SPARC 64-Bit), Linux x86, and Linux x86-64 and Oracle Database Gateway for DRDA

User's Guide.

Oracle Database Gateway for DRDA.

Use Oracle Database Gateway Installation and Configuration Guide for AIX 5L Based

Systems (64-Bit), HP-UX PA-RISC (64-Bit), HP-UX Itanium, Solaris Operating System

(SPARC 64-Bit), Linux x86, and Linux x86-64 and Oracle Database Gateway for DRDA

User's Guide.

Oracle Database Gateway for DRDA.

Use Oracle Database Gateway Installation and Configuration Guide for AIX 5L Based

Systems (64-Bit), HP-UX PA-RISC (64-Bit), HP-UX Itanium, Solaris Operating System

(SPARC 64-Bit), Linux x86, and Linux x86-64 and Oracle Database Gateway for DRDA

User's Guide.

Oracle Database Gateway for WebSphere MQ.

Oracle Database Gateway for WebSphere MQ Installation and User's Guide.

Oracle Database Gateway for APPC.

Use Oracle Database Gateway for APPC Installation and Configuration Guide for AIX 5L

Based Systems (64-Bit), HP-UX PA-RISC (64-Bit), Solaris Operating System (SPARC

64-Bit), and Linux x86.

Oracle Database Gateway for SQL Server.

Use Oracle Database Gateway Installation and Configuration Guide for AIX 5L Based

Systems (64-Bit), HP-UX PA-RISC (64-Bit), HP-UX Itanium, Solaris Operating System

(SPARC 64-Bit), Linux x86, and Linux x86-64 and Oracle Database Gateway for SQL

Server User's Guide.

Oracle Database Gateway for Sybase.

Use Oracle Database Gateway Installation and Configuration Guide for AIX 5L Based

Systems (64-Bit), HP-UX PA-RISC (64-Bit), HP-UX Itanium, Solaris Operating System

(SPARC 64-Bit), Linux x86, and Linux x86-64 and Oracle Database Gateway for Sybase

User's Guide.

Oracle Database Gateway for Teradata.

Use Oracle Database Gateway Installation and Configuration Guide for AIX 5L Based

Systems (64-Bit), HP-UX PA-RISC (64-Bit), HP-UX Itanium, Solaris Operating System

(SPARC 64-Bit), Linux x86, and Linux x86-64 and Oracle Database Gateway for Teradata

User's Guide.

Oracle Database Gateway for Informix.

Use Oracle Database Gateway Installation and Configuration Guide for AIX 5L Based

Systems (64-Bit), HP-UX PA-RISC (64-Bit), HP-UX Itanium, Solaris Operating System

(SPARC 64-Bit), Linux x86, and Linux x86-64 and Oracle Database Gateway for Informix

User's Guide.

Frequently Asked Questions About Installation

D-9

Installing Oracle Database Heterogeneous Connectivity Tools (Gateways)

Table D–1 (Cont.) Oracle Gateway Products

Non-Oracle Database

IMS

VSAM

Adabas

Oracle Gateway Products and Documentation

Oracle Database Gateway for IMS.

Use Oracle Database Gateway for IMS, VSAM, and Adabas Installation and Configuration

Guide for AIX 5L Based Systems (64-Bit), HP-UX PA-RISC (64-Bit), Solaris Operating

System (SPARC 64-Bit), Linux x86, and Linux x86-64, Oracle Database Gateway for IMS

User's Guide and Oracle Connect for IMS, VSAM, and Adabas Gateways Installation and

Configuration Guide for IBM z/OS

Oracle Database Gateway for VSAM.

Use Oracle Database Gateway for IMS, VSAM, and Adabas Installation and Configuration

Guide for AIX 5L Based Systems (64-Bit), HP-UX PA-RISC (64-Bit), Solaris Operating

System (SPARC 64-Bit), Linux x86, and Linux x86-64, Oracle Database Gateway for VSAM

User's Guide and Oracle Connect for IMS, VSAM, and Adabas Gateways Installation and

Configuration Guide for IBM z/OS.

Oracle Database Gateway for Adabas.

Use Oracle Database Gateway for IMS, VSAM, and Adabas Installation and Configuration

Guide for AIX 5L Based Systems (64-Bit), HP-UX PA-RISC (64-Bit), Solaris Operating

System (SPARC 64-Bit), Linux x86, and Linux x86-64, Oracle Database Gateway for Adabas

User's Guide and Oracle Connect for IMS, VSAM, and Adabas Gateways Installation and

Configuration Guide for IBM z/OS.

D-10

Oracle Database Client Installation Guide

Symbols

/, C-3

A

Acucorp ACUCOBOL-GT

requirement on Linux, 2-7

Administrator

disk space requirements, 2-4

Administrator installation type, 1-4

administrator.rsp file, A-3

APPC-enabled databases, D-9

applications, empty connection strings, 4-5

applications, migrating non-Oracle applications to

Oracle, D-8

authorized problem analysis report

See APAR

B

backups of database

Oracle Database Recovery Manager, D-7

base directory

See Oracle base directory

Bash shell

default user startup file, 2-14

.bash_profile file, 2-14

Basic installation type

noninteractive installations, A-4

Bourne shell

default user startup file, 2-14

bundle

checking, 2-4

C

C compiler

requirement, 2-5

See also Pro*C/C++

C shell

default user startup file, 2-14

certification, hardware and software, 1-2

Character Set Scanner, 1-5

checking distribution of the operating system, 2-4 checking version of the operating system, 2-4

chmod command, 2-13

Index

chown command, 2-13

client static library, generating, 4-6

Cluster Ready Services (CSS). See Oracle Clusterware

clusters

See also Oracle Clusterware, Oracle Real

Application Clusters configuration assistants

failure, C-3 troubleshooting, C-3

Custom

disk space requirements, 2-4

Custom installation type, 1-4

custom.rsp file, A-3

D

data mining tools

Oracle Data Mining, D-6

data warehousing tool

Oracle OLAP, D-6

Database Configuration Assistant

troubleshooting, C-3

databases non-Oracle

APPC-enabled, D-9 non-Oracle, listed, D-9

OLAP support (Oracle OLAP), D-6

recovery with Oracle Backup and Recovery, D-7

security management, D-5

DB2 database, D-9

DB2 z/OS database, D-9

DB2/400 database, D-9

default file mode creation mask

setting, 2-14

directory

Oracle base directory, 2-10

Oracle home directory, 2-12

Oracle Inventory directory, 2-11 oraInventory, 2-11

disc

mounting, 3-3

disk space

checking, 2-3, 2-4

disk space requirements

Administrator, 2-4

Custom, 2-4

Index-1

Instant Client, 2-4

Runtime, 2-4

DISPLAY environment variable

setting, 2-14

E

easy connect naming method for Instant

Client-to-database connection, 4-4

empty connect strings, 4-5

env command, 2-17

environment

checking settings, 2-17

configuring for oracle user, 2-14

environment variables

DISPLAY, 2-14

NLS_LANG, B-2

ORACLE_BASE, 2-11, 2-14

ORACLE_HOME, 2-14, 2-16

PATH, 2-14

removing from shell startup file, 2-15

SHELL, 2-14

TMP and TMPDIR, 2-3, 2-15

TNS_ADMIN, 2-16, 4-5

TWO_TAKS, 4-5

errors

configuration assistants, C-3

installation, C-2, C-4

noninteractive installation, C-4 silent mode, C-4

X Window, C-1

X Window display errors, C-1

examples

Oracle base directories, 2-11

F

fatal errors, C-4

file mode creation mask

setting, 2-14

file sets, 2-4

file system

appropriate for Oracle base directory, 2-13

files

administrator.rsp, A-3

.bash_profile, 2-14

custom.rsp, A-3

editing shell startup file, 2-14

instantclient.rsp, A-3

.login, 2-14

oraInst.loc, 2-9, 2-12

oratab, 2-13

.profile, 2-14

response files, A-3 runtime.rsp, A-3

tnsnames.ora, 4-7

filesets

checking, 2-4

Index-2

G

Gateways products FAQ, D-8

globalization support, B-1

Grid Control. See Oracle Enterprise Manager Grid

Control groups

checking for existing oinstall group, 2-9 creating the oinstall group, 2-9

H

hardware certification, 1-2

hardware requirements, 2-2

home directory

See Oracle home directory

I

IBM DB2 database, D-9

IBM DB2 z/OS database, D-9

IBM DB2/400 database, D-9

IBM WebSphere MQ Series databases, D-9

Informix Server database, D-9

installation

accessing installation software, 3-1

available products, 1-3

cleaning up after a failed installation, C-4

component-specific guidelines, 3-1

considerations, 1-2

errors, C-2, C-4

silent mode, C-4

log files, C-2

noninteractive

error handling, C-4

overview, 1-1 to ??

procedure, 3-6

reinstalling Oracle software, 3-1

response files, A-1, A-3 preparing, A-3, A-4

silent mode, C-4

templates, A-3

silent mode, A-5, A-6

upgrading, D-3

installation errors

steps to resolve, C-2

installation overview, 1-1

installation software

copying to a hard disk, 3-4

extracting, 3-2

installation software, accessing, 3-1

installation types

Administrator, 1-4

Custom, 1-4

Instant Client, 1-3

Runtime, 1-4

Instant Client

connecting to database with Oracle Call

Interface, 4-4 connecting to Oracle Database, 4-4

disk space requirements, 2-4

easy connect naming method, 4-4

empty connect strings, 4-5

Instant Client Light

about, 1-3

connecting to database, 4-4

restrictions, 4-2 updates, 4-2 patch upgrades, 4-2 restrictions, 4-2

TNS_ADMIN environment variable, connecting to database, 4-5 tnsnames.ora file connection method, 4-5

TWO_TASK environment variable, connecting to database, 4-5

updates, 4-2

Instant Client installation type, 1-3

Instant Client Light

about, 1-3

connecting to database, 4-4

restrictions, 4-2 updates, 4-2

Instant Client Light, configuring, 4-3

Instant Client, connecting with, 4-2

instantclient.rsp file, A-3

J

JDK requirements, 2-4

K

Korn shell

default user startup file, 2-14

L

languages

installing Oracle components in different languages, B-4

using Oracle components in different languages, B-3

log files, C-2 troubleshooting, C-2

.login file, 2-14

M

mask

setting default file mode creation mask, 2-14

memory requirements, 2-2

Microsoft SQL Server database, D-9

migrating

See upgrading

migrating applications to Oracle, D-8

migrating non-Oracle databases to Oracle, D-3

mkdir command, 2-13

mode

setting default file mode creation mask, 2-14

mount point

for Oracle base directory, 2-11

mount point directories, 3-4

multiple Oracle homes, 1-2

N

Net Configuration Assistant

troubleshooting, C-3

NLS_LANG environment variable, B-2

noninteractive installation response files

preparing, A-3, A-4 templates, A-3

silent mode, A-5, A-6

errors, C-4

noninteractive mode

about, A-1

reasons for using, A-2

See also response files, silent mode, A-1

non-Oracle databases, listed, D-9

O

oinstall group

checking for existing, 2-9 creating, 2-9

description, 2-8

OLAP tools

about, D-6

Oracle OLAP, D-6

opatch utility, 4-2

operating system

checking distribution and version, 2-4

operating system groups

creating the oinstall group, 2-9

oinstall, 2-8 requirements, 2-8

operating system requirements, 2-4

operating system users

creating the oracle user, 2-9

oracle, 2-8 requirements, 2-8

Optimal Flexible Architecture

recommendations for Oracle base directory, 2-10 recommended path for Oracle base directory, 2-10

recommended path for Oracle home directory, 2-12

recommended path for Oracle Inventory directory, 2-11

Oracle Application Server, D-4

Oracle applications

installing with Oracle Database, D-8

Oracle base directory

and ORACLE_BASE environment variable, 2-11

creating, 2-13 creating new, 2-13

description, 2-10

equivalent directory on Microsoft Windows, 2-11 examples, 2-11

identifying appropriate file system, 2-13

identifying existing, 2-12

Index-3

mount point for, 2-11

recommended path, 2-10

relationship with Oracle software owner user, 2-11

requirement for, 2-10

Oracle Call Interface

Instant Client connection method, 4-4

See also Instant Client

Oracle Clusterware

about, D-3 used with Oracle Real Application Clusters, D-3

Oracle components

using in different languages, B-3

Oracle Data Mining

about, D-6 installing, D-6

Oracle Database

administering and monitoring, D-4

connecting to Instant Client, 4-4

installing with Oracle applications, D-8

security management, D-5

upgrading, D-3

Web servers, D-8

Oracle Database Client

configuring connections, D-2

installation procedure, 3-6

Oracle Database components

administering and monitoring, D-4

connectivity FAQ, D-8

FAQ on installing, D-1 to D-3

installing with Oracle applications, D-8

installing with Oracle Database tools, D-4

Oracle Database Recovery Manager (RMAN)

about, D-7

Oracle home directory

description, 2-12 recommended path, 2-12 requirement for, 2-12 requirements, 2-12

using to identify Oracle base directory, 2-13

Oracle home name, 2-12

Oracle Internet Directory, D-5

Oracle Inventory

description, 2-11

pointer file, 2-9

Oracle Inventory directory

description, 2-11 recommended path, 2-11

Oracle Inventory group

checking for existing, 2-9 creating, 2-9

description, 2-8

Oracle Migration Workbench

migrating non-Oracle applications to Oracle, D-8

migrating non-Oracle databases to Oracle, D-3

Oracle Net

configuration file directory, 4-7

Oracle Net Configuration Assistant

installing, 4-5

Oracle Net Services

Index-4

post-installation tasks, 4-7

Oracle OLAP

about, D-6

Oracle Precompilers

postinstallation tasks, 4-7

Oracle Procedural Gateway

listed products, D-9

Oracle Real Application Clusters (RAC)

installing with Oracle Enterprise Manager, D-5

Oracle Clusterware

about, D-3

Oracle Schemas, x

Oracle software

removing, 5-1

Oracle Software Owner user

creating, 2-9

Oracle software owner user

configuring environment for, 2-14

creating, 2-9

description, 2-8

determining default shell, 2-14

relationship with Oracle base directory, 2-11

Oracle Technology Network (OTN)

downloading documentation from, x

Oracle Transparent Gateway

listed products, D-9

Oracle Universal Installer

guidelines for using, 3-1 installation guidelines, 3-1

response files, A-1

list of, A-3

running, 3-4

running in different languages, B-4

oracle user

configuring environment for, 2-14

creating, 2-9, 2-10

description, 2-8

determining default shell, 2-14

relationship with Oracle base directory, 2-11

Oracle XML DB

about, D-5

ORACLE_BASE environment variable, 2-11, 2-14

removing from shell startup file, 2-15

setting, 2-14

ORACLE_HOME environment variable

removing from shell startup file, 2-15

unsetting, 2-16

ORACLE_SID environment variable

removing from shell startup file, 2-15

oraInst.loc file, 2-12

location, 2-9 location of, 2-9

oraInventory directory

See Oracle Inventory directory

oratab file, 2-13 formats, 2-13 location of, 2-13

OTN Web site

downloading installation software from, 3-2

P

passwd command, 2-10

passwords

specifying for response files, A-2

See alsosecurity

patch download location, 2-7

patches

download location, 2-7

Instant Client/Instant Client Light restrictions, 4-2 opatch utility, 4-2

PATH environment variable

setting, 2-14

permissions

for Oracle base directory, 2-13

post-installation recommended tasks

user accounts, setting up, 4-6

required tasks, 4-1

Oracle Net Services, configuring, 4-7

patches, installing and downloading, 4-1

postinstallation recommended tasks

client static library, generating, 4-6

Instant Client Light, configuring, 4-3

root.sh script, backing up, 4-4

required tasks

Instant Client, connecting with, 4-2

Oracle Precompilers, 4-7

postinstallation tasks

Instant Client-to-database connection, 4-4

Precompilers

requirements, 2-5

Pro*C/C++

configuring, 4-7

requirements, 2-5

See also C compiler

product

checking, 2-4

.profile file, 2-14

program technical fix

See PTF

R

RAM requirements, 2-2

recovery of databases

Oracle Backup and Recovery, D-7

reinstalling Oracle software, 3-1

requirements

hardware, 2-2

response files

about, A-1

administrator.rsp, A-3 creating with template, A-3 custom.rsp, A-3

general procedure, A-2

instantclient.rsp, A-3

passing values at command line, A-2 passwords, A-2

runtime.rsp, A-3

security, A-2

specifying with Oracle Universal Installer, A-5

See also silent mode, noninteractive mode, A-1

response files installation

about, A-1

root user

logging in as, 2-1

root.sh script

backing up, 4-4

Runtime

disk space requirements, 2-4

Runtime installation type, 1-4

runtime.rsp file, A-3

S

schemas

Oracle Schemas, about, x

security

management tools, D-5

See alsopasswords

shell

determining default shell for oracle user, 2-14

SHELL environment variable

checking value of, 2-14

shell startup file

editing, 2-14

removing environment variables, 2-15

silent mode

about, A-1

reasons for using, A-2

See also noninteractive mode, response files, A-1

silent mode installation, A-5, A-6

software certification, 1-2

software requirements, 2-4

SQL Server database, D-9

startup file

for shell, 2-14

suppressed mode

reasons for using, A-2

suppressed mode. See noninteractive mode

swap space

checking, 2-3

requirements, 2-2

swlist command, 2-4, 2-6

Sybase Adapter Server database, D-9

T

temporary disk space

requirements, 2-2

Teradata database, D-9

TMP environment variable, 2-3

setting, 2-15

TMPDIR environment variable, 2-3

setting, 2-15

TNS_ADMIN environment variable, 4-5

unsetting, 2-16

tnsnames.ora file, 4-7

Index-5

Instant Client-to-database connection, 4-5

troubleshooting, C-1

fatal errors, C-4

TWO_TASK environment variable, 4-5

U

umask, 2-17 umask command, 2-14, 2-17

UNIX commands, 2-17

chmod, 2-13 chown, 2-13

env, 2-17

mkdir, 2-13

passwd, 2-10

swlist, 2-4, 2-6

umask, 2-14

unset, 2-16 unsetenv, 2-16

useradd, 2-10

xhost, 2-1

xterm, 2-2

UNIX groups

checking for existing oinstall group, 2-9

UNIX users

creating the oracle user, 2-9

UNIX workstation

installing from, 2-1

unset command, 2-16 unsetenv command, 2-16

updating Instant Client, 4-2

upgrading, 1-4

useradd command, 2-10

users

creating the oracle user, 2-9

Oracle software owner user, 2-8

W

Web servers (Oracle HTTP Server), D-8

WebSphere MQ Series database, D-9

Windows

analogy for Oracle base directory, 2-11

X

X Window

display errors, C-1

X Window system

enabling remote hosts, 2-1, 2-2 xhost command, 2-1

XML data, D-5

xterm command, 2-2

Index-6