3
Installation

This chapter describes how to start the Oracle Universal Installer (OUI) and create a new Oracle8i installation.

Product Installation Categories and Installation Types

Oracle8i comes with a choice of three installation categories: Oracle8i Enterprise Edition, Oracle8i Client, or Oracle Programmer. Each category gives you a choice of installation types: Typical, Minimal, and Custom. Choose the combination of products suitable for your purposes and requirements.

Table 3-1 shows the products which can be installed by each of the three installation categories.

Table 3-1 Oracle Universal Installer: Product Installation Categories

Products	Oracle8i Enterprise Edition	Oracle8i Client	Oracle Programmer
Oracle8i Server	X
Oracle8i Client		X
Oracle Programmer			X
Net8 Assistant	X	X	X
Oracle Call Interface	X	X	X
Oracle Advanced Security Option-Export Edition	X	X
Oracle Object Type Translator	X	X	X
Pro*C			X
Pro*COBOL			X
Pro*FORTRAN			X
Oracle Universal Installer	X	X	X
SQL*Plus	X	X
Oracle8i Utilities	X	X
Net8 Server	X
Net8 Client	X	X	X
Oracle Connection Manager	X
Oracle Intelligent Agent	X
Oracle Names	X
Oracle Parallel Server	X
Oracle Database Configuration Assistant	X	X
Oracle Data Migration Assistant	X	X
Legato Storage Manager	X
Oracle Partitioning	X
Oracle interMedia	X
Oracle Visual Information Retrieval	X
Oracle Spatial	X
Oracle Time Series	X
Solaris Documentation	X	X
SQLJ Translator	X	X	X
SQLJ Runtime	X	X	X
JDBC/OCI Driver	X	X	X
SQL*Module ADA			X
EJB/CORBA	X	X	X

Starting the OUI

Perform the following tasks to run the Installer:

Mount the Oracle8i CD-ROM

The Oracle8i CD-ROM is in ISO 9660 format with Rockridge extensions. If you are using volume management software (available by default on Solaris) the CD-ROM is mounted automatically to /cdrom/oracle8i when you put it into the disk drive, and you can proceed to "Start the OUI".

If you are not using the volume management software, you must mount the CD-ROM manually. You must have root privileges to mount or unmount the CD-ROM manually. Be sure to unmount the CD-ROM before removing it from the drive by using the umount command

Place the Oracle8i CD-ROM in the CD-ROM drive.
Log in as the root user and create a CD-ROM mount point directory:
```
$ su root
# mkdir cdrom_mount_point_directory
```
Mount the CD-ROM drive on the mount point directory and exit the root account:
```
# mount options device_name cdrom_mount_point_directory 
# exit
```

Example 3-1 Mounting the CD-ROM Without Using Volume Management Software

$ su root
# mkdir /cdrom
# mount -r -F hsfs device_name /cdrom
# exit

Start the OUI

Caution:
Do not run the OUI as the root user.

To start the OUI:

Log in as oracle user.
Go to the CD-ROM mount-point directory:
```
cd cdrom_mount_point_directory
```
Start the OUI by entering ./runInstaller .

Note:
The OUI is capable of running a non-interactive, "silent" installation of Oracle products that does not use the graphical interface. For instructions on using this feature of the OUI, see "Non-Interactive Installation" .

Installing Products for the First Time

In the "Welcome" dialog box, click the [Next] button to begin your installation.
In the "File Locations" dialog box, enter a value in the [Destination...] field for the desired location of your ORACLE_HOME.

You will be prompted to run /tmp/orainstRoot.sh as root before proceeding. This is to create a pointer file to the location of the oraInventory directory.
In the "Available Products" dialog box, select a product installation category, and in the dialog box which follows, "Installation Types", select an installation type. For more information on installation types, see "Product Installation Categories and Installation Types" . Products not available in all installation types are annotated as such in the table.
Proceed through the remaining dialogues using the online help for assistance; available by clicking the [Help] button.
After the OUI has finished installing the Oracle products, you must run the root.sh script. See "Run the root.sh Script".

Installing Additional Products after Initial Installation

Referring to Table 3-1 , identify the product installation category for the additional product(s) you wish to install.
Navigate past the "Welcome" and "File Locations" dialog boxes to the "Available Products" dialog box, and select the product installation category identified in the previous step.
Select [Custom] in the "Installation Types" dialog box.
In the dialog box that follows, "Available Product Components", currently installed products are shown pre-selected. Select any additional product(s) to be installed.

Caution:
Do not de-select any currently installed products, otherwise they will be de-installed.

In the "Products to be Installed" dialog box which follows, currently installed products are shown under "Already Installed". The additional products you have selected are shown under "New Installations".

Installing Legato Storage Manager Manually

The usual procedure for installing Legato Storage Manager is to select Legato Storage Manager installation when you use the Oracle Universal Installer (OUI) to install your Oracle software.

The OUI asks if you want Legato Storage Manager to be installed. If you answer no, you can follow the steps below to install Legato Storage Manager manually at a later time.

Note:
If you are updating Legato Storage Manager, be sure to perform a partial removal of Legato Storage Manager using the procedure in the section "Removing an Existing Legato Storage Manager Installation" in Chapter 2. Be sure not to remove any existing Legato Storage Manager files in the /nsr directory. For more information on updating, refer to the section "Updating Legato Storage Manager".

To install Legato Storage Manager manually, follow these steps:

Be sure no Legato Storage Manager or NetWorker software is installed on your system. The Legato Storage Manager installer, lsminst (step 3 below), attempts to detect existing Legato software. If Legato software exists but is not detected, both the existing Legato software and the Legato Storage Manager might not function properly.
From the CD-ROM mount point, go to the directory:
```
stage/Components/lsm
```
As root user, install the Legato Storage Manager software using the following lsminst command:
```
# ./lsminst . 
```
For each prompt asking if you want to continue the installation, enter Yes.

When prompted for a directory to use for client and server information, you can accept the default or enter another directory name. Be sure the directory used has sufficient disk space, as listed for the indexes in the "Legato Storage Manager Software Requirements" table.

When prompted for a device name, you can enter either a carriage return ([ENTER]) or a proper no-rewind, BSD-semantics tape device name. The device is used by Legato Storage Manager for backups after it has been properly configured in the LSM Administrator GUI. For details on device configuration, refer to Chapter 3 in the Legato Storage Manager Administrator's Guide.

For all other prompts displayed by lsminst, press [ENTER].
Update the MANPATH and PATH environment variables as required. MANPATH must include /usr/share/man, the pathname of the directory where the Legato Storage Manager man pages are installed. PATH must include /usr/bin and /usr/sbin, the pathnames of the directories where the Legato Storage Manager binaries are installed.
For each ORACLE_HOME to be enabled for Legato Storage Manager backups, follow these steps:

Note:
If you later install another ORACLE_HOME on your system, you must follow these steps to enable Legato Storage Manager backups from that ORACLE_HOME.

Log in as the ORACLE_HOME owner.
Copy the file liblsm.so from the directory:

stage/Components/lsm/lib

on the Oracle CD-ROM to the file $ORACLE_HOME/lib/liblsm.so:

cp stage/Components/lsm/lib/liblsm.so $ORACLE_HOME/lib/liblsm.so

Shut down all Oracle instances that use this ORACLE_HOME.

Remove the symbolic link $ORACLE_HOME/lib/libobk.so and replace it with a symbolic link to the file $ORACLE_HOME/lib/liblsm.so:

cd $ORACLE_HOME/librm libobk.soln -s liblsm.so libobk.so

Restart all Oracle instances that use this ORACLE_HOME.

Updating Legato Storage Manager

To update to a newer version of Legato Storage Manager, follow these steps:

Perform a partial removal of Legato Storage Manager using the procedure in the section "Removing an Existing Legato Storage Manager Installation" in Chapter 2.

Be sure not to remove any existing Legato Storage Manager files in the /nsr directory.
Install the updated version of Legato Storage Manager using the procedure in the section "Installing Legato Storage Manager Manually".

Re-Installing Products

To re-install, the product(s) must first be de-installed using the method described in the section "De-installing Oracle Software", then installed according to one of the installation methods outlined elsewhere in this chapter: "Installing Products for the First Time" or "Non-Interactive Installation".

If an installation has failed or aborted, see the section "De-installing Oracle Software".

Re-Installing Oracle Parallel Server

If the install fails before completion and you have to re-install, you must click the [Yes] button to all the OUI dialog boxes that ask "Do you want to re-install name of a product?". Otherwise the remote copy operation to the other nodes will miss the products for which you declined the re-install.

Creating a Database

The OUI does not create a database. However, all server installation types allow at least the option of automatically launching the Oracle Database Configuration Assistant (DBCA) at the end of the installation session. The assistant can create a default or customized database. The assistant can create the database, or can output a SQL script which you can inspect and modify, then run via SQL*Plus or Server Manager.

You can also launch DBCA independently of the OUI. Make sure $ORACLE_HOME/bin is in your search path and enter the following:

$ dbassist &

Upgrading or Migrating an Existing System

If you have installed Oracle8i to use with an existing database from a prior software release, you must upgrade or migrate that database prior to mounting it using Oracle8i. The steps for this process exceed the scope of this manual. See Oracle8i Migration for instructions.

De-installing Oracle Software

To de-install Oracle software using the OUI, follow the steps below.

Click the [De-install Products] button on the "Welcome" dialog box or the [Installed Products...] button available on any OUI screen. The "Inventory" dialog box appears, listing installed products.
In the "Inventory" dialog box, select any product(s) to be de-installed, then click the [Remove] button.

Removing Legato Storage Manager Version 5.5

Note:
You cannot remove Legato Storage Manager using the OUI. You must use the following steps to remove Legato Storage Manager version 5.5.

To remove Legato Storage Manager version 5.5, follow these steps:

For each ORACLE_HOME on your system enabled for backups, follow these steps to remove the Media Management API of Legato Storage Manager:
1. Shut down all Oracle instances that use this ORACLE_HOME.
2. Remove $ORACLE_HOME/lib/liblsm.so and create a symbolic link from $ORACLE_HOME/lib/libobk.so to
  $ORACLE_HOME/lib/liborasbt.so:

cd $ORACLE_HOME/librm libobk.sorm liblsm.soln -s liborasbt.so libobk.so

Restart all Oracle instances that use this ORACLE_HOME.

As root user, stop the Legato Storage Manager daemons using the
nsr_shutdown command:
```
# nsr_shutdown
```
As root user, remove the Legato Storage Manager software using the following pkgrm command:
```
# pkgrm ORCLman ORCLserv ORCLnode ORCLdrvr ORCLclnt
```

Note:
Be sure to specify the software packages in this exact order, with ORCLman being followed by ORCLserv, etc.

For each prompt displayed by the pkgrm command, enter yes.

Warning:
This procedure does not remove the /nsr directory containing the Legato Storage Manager client and media index files and resource configuration files.

To remove the Legato Storage Manager index and resource configuration files, remove the /nsr directory by running the following command as root user:
```
# rm -rf /nsr/* /nsr
```

If you remove the /nsr directory containing the index and configuration information, you will not be able to restore from the Legato Storage Manager backups. If you later reinstall the Legato Storage Manager or install another Legato product, you will need to rebuild the configuration.

Cleaning Up After a Failed Installation

If an installation fails, it may be necessary to remove any files that the OUI created during the last session before you attempt another installation.

To clean up after a failed installation:

Start the OUI.
Click the [De-install Products] button and select any products that were left after the failed installation.
Click the [Remove] button.

To complete the clean up, you may need to manually remove the following items:

ORACLE_HOME directory.
oraInventory/../oui.
oraInventory/../jre.

The location of the oraInventory directory can be obtained from the file /var/opt/oracle/oraInst.loc.

Installing Oracle Parallel Server

During installation, software components are installed on the node from which the Oracle Universal Installer is run, and pushed to the other selected nodes in the cluster.

See Also:
For more detailed installation information on Oracle Parallel Server refer to the Oracle 8i Parallel Server Guide.

Non-Interactive Installation

You may perform a non-interactive, or "silent," install by supplying the OUI with a response file, a text file that contains values and variables that are used by the OUI during the installation process. By using a response file, you can perform an installation without some or any of the OUI's graphical interface.

Preparing the Response File

There are seven response files, one for each install type and for each category, included on the Oracle8i CD-ROM. The typical server response file is almost completely configured to perform a non-interactive, typical installation using the OUI. The custom response file requires extensive editing before it can be used as a response file for the OUI.

To use a response file, copy the response file from the Oracle8i CD-ROM to a drive mounted on your system. For example:

% cd cdrom_mount_point_directory/stage/Response/
% cp typical815.rsp local_directory

Edit the response file you want to use with any text editor, to include information specific to your system. Each file contains instructions for properly configuring the response file.

Specifying a Response File for the Oracle Universal Installer

To make the OUI use the response file at install time, follow the same steps as described in the section "Start the OUI" , but specify the location of the response file that you wish to use as a parameter when running OUI:

% ./runInstaller [-silent] -responseFile filename

To perform a completely silent installation with the OUI, use the flag -silent. Note that the OUI will fail if you use this flag and the response file has not been configured. The success or failure of the installation is logged in the silentInstall.log file in the /tmp directory.

Error Handling

The OUI treats wrong context, format, or type values as if no value were specified. Variables which are outside of any section are ignored.

Validation of Values from Response File

Calculation and validation of the response file is performed at install time by OUI. Failure of the validation process results in the termination of installation.

3 Installation