B
Oracle9iAS Client Installation

This appendix describes how to install the Oracle9i Database Client software from the Oracle9iAS Client CD-ROM. It contains the following sections:

• Introduction

• Oracle9i Options

• Preinstallation Requirements

• Installation

• Postinstallation Configuration Tasks

• Individual Components Available for Installation

• Installing Oracle Components in Noninteractive Mode

  Note: This appendix is relevant only for the Windows platform.

B.1 Introduction

This section provides information about Oracle Universal Installer, installation types, and concepts you should be aware of in planning an installation.

B.2 Oracle9i Options

The following products require a separate license:

• Oracle Advanced Security

• Oracle Diagnostics Pack

• Oracle Tuning Pack

  See Also: Global License Terms for additional licensing information Section B.6.1, "Oracle9i Database Client Components"

B.3 Preinstallation Requirements

This section contains the following topics:

• Single Oracle Home Components

• Client Component System Requirements

• Oracle9i Database Client Products for Installation

• Mandatory Individual Component Requirements

• Linking and Relinking Applications

• Supported Vendors for Networking Protocols

B.3.1 Single Oracle Home Components

Most of the Oracle9i Database Client components can be installed multiple times on the same computer. However, the following components can be installed only once for each computer:

• Oracle Objects for OLE

• Oracle Provider for OLE DB

Oracle Universal Installer detects that these products are already installed in another Oracle home and automatically removes them from the installation process without prompting you. The following information is logged to the installActions.log file in the following location:

c:\Program Files\Oracle\Inventory\logs

If you are performing an installation and notice that one or more single Oracle home components are not available for installation during the current session, check to see whether any of these components or any previous versions of these components are installed in another Oracle home. If you want to install these in the current Oracle home, deinstall the conflicting versions.

B.3.2 Client Component System Requirements

The following sections list the system requirements for the Oracle9i Database Client. The Oracle9i Database Client contains several individual components. Some components also have requirements that must be satisfied before installation.

Important: The hard disk requirements for client components includes 25 MB to install Java Runtime Environment (JRE) and Oracle Universal Installer on the installation partition. If sufficient space is not detected, the installation fails.

B.3.2.1 System Requirements for FAT and NTFS File Systems

This section lists system requirements for both the File Allocation Table (FAT) and Windows NT File System (NTFS) file systems. Because of the difference in space allocation on both file systems, hard disk requirements vary.

Oracle Corporation recommends configuring NTFS for Windows NT, Windows 2000, Windows XP, and FAT32 for Windows 98.

See Also: Section B.5.1, "About NTFS File System and Windows NT Registry Permissions"

Important: Oracle Corporation recommends that you review the FAT and NTFS system requirements to determine whether you have enough hard disk space for installation.

B.3.3 Oracle9i Database Client Products for Installation

The Oracle9i Application Server (Oracle9iAS) Database Client includes a set of products, services, and client-side utilities used to connect to a backend Oracle9i database.

• Oracle9i Database Client

  Installs the Oracle Enterprise Manager Console, including enterprise management tools, networking services, utilities, and basic client software.

• Oracle9i SOAP Client

  Installs the Oracle9i SOAP Client software.

  See Also: Section B.6, "Individual Components Available for Installation" for a list of individual components installed with each installation type

Table B-1 shows the system requirements for Oracle9i Database Client.

Table B-1 Oracle9i Database Client System Requirements  

Requirement	Database ClientFoot 1 and SOAP Client
Operating System	Windows 98, Windows NT 4.0Foot 2, Windows 2000Foot 3, Windows XPFoot 4, and Windows Terminal ServerFoot 5
Windows NT 4.0 Service Pack	Certified with Service Pack 5 or higher
Windows 2000 Service Pack	Not required; certified with Service Pack 1 or higher
Minimal Processor	Pentium 166
Recommended Processor	Pentium II 266
RAM	128 MB (minimal); 256 MB (recommended)
FAT file system:
Oracle home disk space	1 GB
System disk space	51 MB
NTFS file system:
Oracle home disk space	650 MB
System disk space	51 MB
Web browser (if using Oracle Enterprise Manager Web Site)	Netscape Navigator 4.7 or higher Microsoft Internet Explorer 5.0 or higher

1 The processor and RAM requirements identified are applicable to an Enterprise Manager Client installation and to a thin Web-based Enterprise Manager Client. 2 Windows NT includes: Windows NT Workstation 4.0, Windows NT Server 4.0, Windows NT Server Enterprise Edition 4.0, and Windows NT 4.0 Server Terminal Server Edition. 3 Windows 2000 includes: Windows 2000 Professional, Windows 2000 Server, Windows 2000 Advanced Server, and Windows 2000 Datacenter. 4 Windows XP Professional Edition. 5 Oracle supports Terminal Services on Windows 2000 Server, Windows 2000 Advanced Server, and Windows 2000 Datacenter. See "Unsupported Components and Features on Windows Terminal Servers" for additional information.

B.3.3.1 Unsupported Components and Features on Windows Terminal Servers

The following products are not supported on Windows Terminal Servers:

• Oracle Migration Workbench

• Oracle Services for Microsoft Transaction Server

  See Also: The Microsoft Web site for more information on terminal servers: http://www.microsoft.com/ The OracleMetaLink Web site for the latest Terminal Server certification information: http://metalink.oracle.com/

B.3.4 Mandatory Individual Component Requirements

Table B-2 describes mandatory individual component preinstallation requirements. Refer to Section B.6, "Individual Components Available for Installation" for a list of the individual components that can be installed. Appropriate documentation for preinstallation procedures is also identified.

Table B-2 Mandatory Individual Component Requirements  

Component	Description	See Also...
Oracle Advanced Security	You must satisfy hardware and software requirements to use authentication support with Oracle components. In addition, using Oracle Advanced Security with Secure Socket Layer (SSL) and public key infrastructure (PKI) requires preinstallation of a Lightweight Directory Access Protocol (LDAP) directory such as Oracle Internet Directory (provided on the component CD-ROM).	Oracle Advanced Security Administrator's Guide This manual is not on the Oracle 9iAS Documentation CD-ROM. You can view it at: http://tahiti.oracle.com
Oracle9i integration with Active Directory	The user performing the Oracle9i installation must satisfy the preinstallation requirements for integration to be successful.	"Using Oracle9i Directory Server Features with Active Directory" in the Oracle9i Network, Directory, and Security Guide for Windows This manual is not on the Oracle 9iAS Documentation CD-ROM. You can view it at: http://tahiti.oracle.com

B.3.5 Linking and Relinking Applications

Oracle Corporation recommends that you upgrade your client software to match the current server software. If you upgrade your Oracle server to the current release, then Oracle Corporation recommends upgrading the client software to the same release. Keeping the server and client software up to date ensures application stability and provides enhanced functionality and performance enhancements.

B.3.6 Supported Vendors for Networking Protocols

Table B-3 lists the supported vendor for each networking protocol:

Table B-3 Supported Networking Protocol Vendors

Protocol Feature	Operating System	Supported Vendor
TCP/IP protocol	Windows NT and Windows 98	Microsoft TCP/IP
Named Pipes protocol	Windows NT and Windows 98	Microsoft NETBEUI
Host naming method	Windows NT	Microsoft TCP/IP
Windows native authentication method	Windows NT and Windows 98	Microsoft
Logical Unit Type 6.2 (LU6.2) protocol	Windows NT	LU6.2 protocol support is obsolete in this release.

B.4 Installation

This section includes the following topics:

• Preinstallation Tasks

• Installing Oracle Components

• Reviewing the Installation Session Log

• Deinstalling Oracle Components and Services

B.4.1 Preinstallation Tasks

Complete the following preinstallation tasks before installing the Oracle9i Database Client.

Note: The ORACLE_HOME environment variable is automatically set in the registry. Setting this variable is not necessary or recommended and prevents multiple Oracle home environments from functioning properly.

To perform preinstallation tasks:

1. Start your operating system.

2. Verify system and component requirements listed in Section B.3, "Preinstallation Requirements" before you begin installation.

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

4. If applicable, install and test your network hardware and software.

5. Stop all Oracle services (if any are running) for the Oracle home into which you want to install Oracle components:
   1. On Windows NT, choose Start > Settings > Control Panel > Services. On Windows 2000, choose Start > Programs > Administrative Tools > Services.

   2. If any Oracle services (their names begin with Oracle) exist and have the status Started, select the service and choose Stop on Windows NT, or choose Action > Stop on Windows 2000.

   3. Choose Close to exit the Services window.

6. Continue to Section B.4.2, "Installing Oracle Components".

B.4.2 Installing Oracle Components

Complete the following steps to install Oracle components:

1. Ensure that you have followed all preinstallation steps described in Section B.4.1, "Preinstallation Tasks".

2. Insert the Oracle9iAS Client CD-ROM.

   The Autorun window automatically appears. If the Autorun window does not appear:

   1. Select Start > Run.

   2. Enter the following:

      DRIVE_LETTER:\autorun\autorun.exe

      The Autorun window appears.

3. Choose to install the Oracle9i Database Client from the CD-ROM.

4. Select Next.

5. The File Locations window appears.

6. In the Destination fields, enter the Oracle home name and directory path in which to install Oracle components.

   The directory path must be a mapped drive. Do not change the directory path in the Source field. This is the location of installation files.

   Attention: If you have an existing Oracle home created with a pre-9.0.x release, you must change the default installation location to a new Oracle home. Universal Naming Convention (UNC) names are not supported.

   The Oracle home name can be up to 16 characters in length and must consist of alphanumeric characters and underscores. Spaces are not allowed. Do not use a number as the first character in the Name field. The default directory path is C:\oracle\ora9ias.

7. Click Next.

   The Available Products window appears.

8. Select Oracle9i Database Client or Oracle9i SOAP Client and click Next.

9. If you selected Oracle9i SOAP Client, the SOAP Server Location window appears. Enter the address for the server. If you selected Oracle9i Database Client, go to step 10. The Summary window appears.

10. Click Install.

    See Also: Section B.4.3, "Reviewing the Installation Session Log" for a summary of your installation session

B.4.3 Reviewing the Installation Session Log

The first time Oracle Universal Installer runs, it creates the SYSTEM_DRIVE:\Program Files\Oracle\Inventory\logs directory. An inventory of installed components and installation actions performed are kept in this directory.

Log file names of installation sessions are in this directory and take the following form:
installActionsdate_time.log

For example:

installActions2001-07-14_09-00-56-am.log

You can also view a list of installed components by selecting Installed Products on any window of Oracle Universal Installer.

Note: Do not delete or manually alter the Inventory directory or its contents. Doing so can prevent Oracle Universal Installer from locating products that you have installed on your system.

B.4.4 Deinstalling Oracle Components and Services

This section describes how to deinstall Oracle components, utilities, and services.

Note: Silent deinstallations are not supported.

This section contains the following topics:

• Stopping Oracle Services for Windows

• Removing Oracle Keys From the Registry on Windows NT, Windows 2000, and Windows XP

• Removing Oracle Keys from the Registry on Windows 98

  Note: Manual removal of components is permitted only if you exit Oracle Universal Installer during an installation by: Choosing Cancel Turning off the computer Not completing the installation, that is, all required configuration tools do not run at the end of the installation process In these cases, Oracle Universal Installer does not register the installation in its inventory. However, files may have been copied to your Oracle home. Remove these files manually and restart the installation.

B.4.4.1 Stopping Oracle Services for Windows

You must first stop the Oracle for Windows NT services before deinstalling Oracle components or removing any registry entries.

To stop Windows NT services:

1. Choose Start > Settings > Control Panel > Services.

2. If any Oracle services (names begin with Oracle or Ora) exist and have the status Started, select the service, and choose Stop.

3. Choose Close to exit the Services window.

4. Exit the Control Panel.

B.4.4.2 Removing Oracle Keys From the Registry on Windows NT, Windows 2000, and Windows XP

You may want to correct serious system problems by completely removing Oracle components from the computer.

To remove the Oracle Net Service Registry Entry:

1. Log in as a member of the Administrators group.

2. Follow the instructions listed in Section B.4.4.1, "Stopping Oracle Services for Windows".

3. Start the registry editor at the command prompt:

   C:\> regedt32
   
   

4. Go to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services and delete the OracleHOME_NAMETNSListener registry entry if you also have an Oracle9i database installed. Oracle Universal Installer automatically deletes all other Oracle Net Services.

5. Exit the registry editor.

To remove all Oracle components from a computer on Windows NT, Windows 2000, and Windows XP:

Caution: These instructions remove all Oracle components, services, and registry entries from your computer. In addition, any database files under ORACLE_BASE\oradata\DB_NAME are also removed. Exercise extreme care when removing registry entries. Removing incorrect entries can make your system inoperable.

1. Log in as a member of the Administrators group.

2. Follow the instructions listed in Section B.4.4.1, "Stopping Oracle Services for Windows".

3. Start the registry editor at the command prompt:

   C:\> regedt32
   
   

4. Go to HKEY_CLASSES_ROOT and delete any key that starts with Oracle, ORA, or ORCL.

5. Go to HKEY_LOCAL_MACHINE\SOFTWARE and delete the ORACLE and Apache Group keys.

6. Go to HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\odbcinst.ini and delete the Oracle in HOME_NAME key.

7. Go to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services and delete all keys under this location that begin with ORACLE.

8. Go to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services \Eventlog\Application and delete all keys under this location that begin with ORACLE.

9. Go to HKEY_CURRENT_USER and delete ORACLE.

10. Go to HKEY_CURRENT_USER\SOFTWARE\ORACLE and delete keys that start with Oracle or ORCL (if any exist).

11. Go to HKEY_CURRENT_USER\SOFTWARE\ODBC\odbcinst.ini and delete any Oracle keys (if any exist).

12. Close the registry editor and restart your computer.

B.4.4.3 Update the System Variable Path

1. Choose Start > Settings > Control Panel > System > Environment tab.

2. Select the system variable path and modify the PATH variable.

3. Remove any Oracle entries from the path. For example, if JRE was installed by Oracle, remove the %ORACLE_HOME%\BIN path and the JRE path. The path should be:

   C:\oracle\ora92\bin;C:\program files\oracle\jre\1.1.7\bin 
   
   

4. Exit the Control Panel.

B.4.4.4 Remove Oracle from the Start Menu

1. Go to SYSTEM_DRIVE:\winnt\profiles\all users\start menu\programs. On Windows XP go to SYSTEM_DRIVE:\documents and settings\all users\start menu\programs.

2. Delete the following icons:
   • Oracle - HOME_NAME
     where HOME_NAME is the previous Oracle home name.

   • Oracle Installation Products

3. Delete SYSTEM_DRIVE:\program files\oracle through Windows Explorer.

4. Delete all ORACLE_BASE directories on your hard drive.

5. Restart your computer.

B.4.5 Removing Oracle Keys from the Registry on Windows 98

To remove all Oracle components from a computer on Windows 98:

1. Start the registry editor at the command prompt:

   C:\> regedit
   
   

2. Go to HKEY_CLASSES_ROOT and delete any key that starts with Oracle or ORCL.

3. Go to HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE and delete the ORACLE key.

4. Go to HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\odbcinst.ini and delete the Oracle ODBC Driver key.

5. Go to HKEY_CURRENT_USER\SOFTWARE\ORACLE and delete keys that start with Oracle or ORCL (if any exist).

6. Go to HKEY_CURRENT_USER\SOFTWARE\ODBC\odbcinst.ini and delete any Oracle keys.

7. Close the registry editor and restart your computer.

B.4.5.1 Update the System Variable Path

Edit your autoexec.bat file and remove your %ORACLE_HOME%\BIN and JRE paths from the path setting.

B.4.5.2 Remove Oracle from the Start Menu

1. Delete SYSTEM_DRIVE:\Program Files\Oracle using the Windows Explorer.

2. Delete icons from:

   c:\windows\start menu\programs\oracle - HOME_NAME
where HOME_NAME is the previous Oracle home name.

   • c:\windows\start menu\programs\oracle installation products

3. Delete all ORACLE_BASE directories on your hard drive.

4. Restart your computer.

B.5 Postinstallation Configuration Tasks

This section includes the following topics:

• About NTFS File System and Windows NT Registry Permissions

• Individual Component Postinstallation Configuration Tasks

B.5.1 About NTFS File System and Windows NT Registry Permissions

Oracle Corporation recommends that you configure Oracle9i database files, directories, and registry settings to allow only authorized database administrators (DBAs) to have full control. These topics describe how to perform these tasks:

• Setting NTFS File System Security

• Setting Windows NT Registry Security

  See Also: Your Windows NT documentation for more information about modifying NTFS file system and Windows NT registry settings

B.5.1.1 Setting NTFS File System Security

The Oracle9i database uses files to store database data, backup data, log information, and other database information. The Oracle9i database process runs under a security account. The Windows NT LocalSystem account, called SYSTEM, enables the user to create and access these database files. The security account is assigned to the service that the Oracle9i database uses (in the Windows Control Panel). This account requires full file system permissions to create, read, write, delete, and execute files.

To ensure that only authorized users have full file system permissions:

1. Run Windows NT Explorer.

2. Right-click Oracle9i database files (in the ORACLE_BASE\oradata\DB_NAME directory), executables and dynamic link libraries (in the ORACLE_HOME\bin directory), and directories.

3. Select Properties from the menu that appears.

4. Select file and directory permissions to ensure that:
   • Only the security account that the Oracle9i database is configured to use has full control permissions to these files

   • User accounts that must run Oracle applications (for example, SQL*Plus and Pro*C) have read privileges on their executables (for example, sqlplus.exe for SQL*Plus)

     Note: The Oracle9i database uses the Windows NT LocalSystem built-in security account. Therefore, file permissions must be granted to the SYSTEM account of the local computer running the Oracle9i database.

B.5.1.2 Setting Windows NT Registry Security

Oracle Corporation recommends that you remove write permissions from users who are not Oracle9i DBAs or system administrators in HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE of the Windows NT registry.

To remove write permissions:

1. Start the registry editor at the command prompt:

   C:\> regedt32
   
   

2. Go to HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE and select Permissions from the Security main menu.

   The Registry Key Permissions dialog box appears.

3. Remove write permissions from any users who are not Oracle9i DBAs or system administrators. The SYSTEM account must have Full Control, since this is the account with which the Oracle9i database runs.

4. Verify that user accounts that must run Oracle applications have read privileges.

5. Select OK and exit the registry.

B.5.2 Individual Component Postinstallation Configuration Tasks

Table B-4 lists configuration requirements for specific postinstallation configuration procedures. The manuals listed in the following table are not included on the 9iAS Documentation CD-ROM. You can view them at:

http://tahiti.oracle.com

Table B-4 Individual Component Postinstallation Configuration Tasks 

Component	Description	See Also...
Oracle Advanced Security	Authentication, encryption, integrity support, and enterprise user security require configuration.	Oracle Advanced Security Administrator's Guide
Oracle Net Services network software	Oracle Net Configuration Assistant is a tool that assists you in configuring your Oracle network. If you installed Oracle Net Services, Oracle Net Configuration Assistant automatically guided you through network configuration of client computers and Oracle9i database servers. You can also configure your Oracle network after installation with the Oracle Net Configuration Assistant and Oracle Net Manager tools.	Oracle9i Net Services Administrator's Guide
Pro*COBOL	Pro*COBOL supports specific compilers.	Pro*COBOL Precompiler Getting Started for Windows
SQL*Plus help file	If you want to use online help with SQL*Plus, you must populate the SQL*Plus tables with help files.	SQL*Plus Getting Started for Windows

B.6 Individual Components Available for Installation

This section includes information on Oracle9i Database Client Components.

B.6.1 Oracle9i Database Client Components

Table B-5 alphabetically lists the components available.

Table B-5 Oracle9i Database Client Components  

Component	Database Client	SOAP Client
Advanced Queueing API	Yes	No
Object Type Translator	Yes	No
Oracle Advanced Security	Yes	No
Oracle Call Interface	Yes	No
Oracle Dynamic Services Server	Yes	No
Oracle Enterprise JavaBeans and CORBA Tools	Yes	No
Oracle Enterprise Manager	Yes	No
Oracle interMedia Annotator	Yes	No
Oracle interMedia Client Option	Yes	No
Oracle Internet Directory Client	Yes	No
Oracle SOAP Client software	No	Yes
Oracle JDBC Drivers	Yes	No
Oracle Net Services	Yes	No
Oracle Objects for OLE	Yes	No
Oracle ODBC Driver	Yes	No
Oracle Provider for OLE DB	Yes	No
Oracle SQLJ	Yes	No
Oracle Syndication Server	Yes	No
Oracle Ultra Search Middle Tier	Yes	No
Oracle Universal Installer	Yes	No
Oracle Utilities	Yes	No
Oracle XML Developer's Kit	Yes	No
Oracle XML SQL Utility	Yes	No
PL/SQL	Yes	No
Pro*C/C++	Yes	No
Pro*COBOL 9.0.1	Yes	No
Pro*COBOL 1.8.76	Yes	No
Replication Management API	Yes	No
SQL*Plus	Yes	No

B.7 Installing Oracle Components in Noninteractive Mode

This section includes information on installing Oracle Components in the noninteractive mode.

Note: Noninteractive deinstallations are not supported.

Typically, Oracle Universal Installer runs in interactive mode, which means you are prompted to provide information in windows. However, experienced users can also run Oracle Universal Installer in noninteractive (also called silent) mode by using response files. These are text files containing variables and values used by Oracle Universal Installer during the installation process.

Silent installations are recommended in cases when no interaction with the user is intended or when a nongraphical terminal is used. With Oracle Universal Installer release 1.7.x or earlier, the target installation system still requires login to a desktop system on Windows NT.

Using silent installation enables you to bypass the graphical user interface (GUI) of Oracle Universal Installer interactive mode. The installation is controlled by a response file, you must edit a response file to specify the components to install. The response files, shown in Table B-6, are available in the \Response directory on the component CD-ROM:

Table B-6 Response Files

Response File Name	This File Silently Runs ...
oracle.iappserver.dbclient.client_administrator.rsp	Oracle9i Database Client
oracle.soap.client.Complete.rsp	Oracle9i SOAP Client