4
Getting Started with Installation

This chapter describes how to get started with the three Oracle Collaboration Suite installations. You must follow the procedures in this chapter to ensure that the installation process is successful.

This chapter contains these topics:

• Installing Oracle Components from the CD-ROMs

• Installing Oracle Components from a Hard Drive

• Oracle Universal Installer Overview

• Starting Oracle Universal Installer

Installing Oracle Components from the CD-ROMs

Table 4-1 shows the number of CD-ROMs on which the three Oracle Collaboration Suite installations are delivered.

Table 4-1 CD-ROMs for Each Installation

Installation	Number of CD-ROMs
Oracle9iAS Infrastructure	3
Oracle Collaboration Suite Information Storage	2
Oracle Collaboration Suite	2
Oracle Collaboration Suite Interoperability	1
Oracle Collaboration Suite Clients	1

The Oracle CD-ROMs are in ISO 9660 format with Rockridge extensions. You can either choose to install directly from the CD-ROMs, or copy the CD-ROM contents and then install from your system hard drive. You must complete the procedures required for the installation method you choose before starting Oracle Universal Installer.

For operating systems that do not support automatic mounting of CD-ROMs, the CD-ROMs must be mounted manually. You must have root privileges to mount or unmount a CD-ROM. Be sure to unmount a CD-ROM before removing it from the drive.

Refer to these mounting procedures during installation as necessary:

• Mounting CD-ROMs for Solaris

• Mounting CD-ROMs for HP

• Mounting CD-ROMs for Linux

Mounting CD-ROMs for Solaris

Mount the first CD-ROM to begin the installation. Mount the subsequent disk or disks when prompted. Use the following procedures to mount CD-ROMs.

This section contains these topics:

• Mounting CD-ROMs for Solaris with Volume Management Software

• Mounting CD-ROMs for Solaris Manually

Mounting CD-ROMs for Solaris with Volume Management Software

If you are using Volume Management software (available by default on Solaris), the CD-ROM is mounted automatically to the /cdrom/volume_name directory when inserted into the CD-ROM drive. Proceed to "Starting Oracle Universal Installer".

To check if you have Volume Management software, use the following command:

$ ps -e | grep vold

If you have Volume Management software, the output must be similar to the following:

404 ? 16:03 vold

• If the Volume Management software is running, the CD-ROM is mounted automatically. Use the following commands to unmount subsequent CD-ROMs:

  $ cd /
  $ eject
  
  

  After entering these commands, proceed to "Starting Oracle Universal Installer".

• If no lines are returned, then Volume Management software is not running, and you need to mount the CD-ROM manually. Proceed to "Mounting CD-ROMs for Solaris Manually".

Follow these steps to mount subsequent CD-ROMs:

1. Remove the CD-ROM from the CD-ROM drive by using the following commands:

   $ cd /
   $ eject
   
   

2. Insert the next CD-ROM into the CD-ROM drive and enter the correct mount point in the Installation screen of Oracle Universal Installer.

3. Click OK to continue.

Mounting CD-ROMs for Solaris Manually

Follow these steps to mount the CD-ROM manually:

1. Place the first CD-ROM of the appropriate installation in the CD-ROM drive.

2. Log in as the root user and, if necessary, create a CD-ROM mount point directory by using the following commands:

   $ su root
   # mkdir cdrom_mount_point_directory
   
   

3. Mount the CD-ROM drive on the mount point directory, and then exit the root account by using the following commands:

   # mount options device_name cdrom_mount_point_directory 
   # exit
   
   

If you are unsure of the correct device_name, consult your system administrator. Typically, the device_name is /dev/dsk/c0t6d0s0. For example:

$ su root
# mkdir /cdrom
# mount -r -F hsfs /dev/dsk/c0t6d0s0 /cdrom
# exit

If you run Oracle Universal Installer while the current working directory is on the CD-ROM, follow these steps to mount the next CD-ROM:

1. Change directories to the root directory of your system and log in as the root user by using the following commands:

   $ cd /
   $ su root
   
   

2. Unmount the CD-ROM by using the following command:

   # umount cdrom_mount_point_directory
   
   

3. Remove the CD-ROM from the CD-ROM drive.

4. Insert and mount the next CD-ROM in the CD-ROM drive by using the following command:

   # mount options device_name cdrom_mount_point_directory
   
   

5. Enter the correct mount point in the Installation screen of Oracle Universal Installer.

6. Click OK to continue.

Mounting CD-ROMs for HP

Mount the first CD-ROM of the appropriate installation to begin. Mount the subsequent disk or disks when prompted. Follow these steps to mount the Oracle CD-ROM manually:

1. Place the CD-ROM in the CD-ROM drive.

2. Log in as the root user and create a CD-ROM mount point directory, if one does not already exist, by using the following commands:

   $ su root
   # mkdir cdrom_mount_point_directory
   
   

3. Use the following command to determine the device name:

   $ ioscan -fun -C disk
   
   

   The output is similar to the following:

   disk     10  10/12/5.2.0   sdisk       CLAIMED   DEVICE    TOSHIBA CD-ROM 
   XM-5701TA /dev/dsk/c4t2d0   /dev/rdsk/c4t2d0
   
   

4. If there is no entry in the /etc/pfs_fstab file for your CD-ROM device, you must add one. As the root user, use a system editor to add a line to the /etc/pfs_fstab file following this format:

   device_file mount_point filesystem_type translation_method
   
   

   In the preceding format, the first entry is the CD-ROM device, the second entry is the mount point, and the third entry indicates that the CD-ROM to be mounted is in ISO 9660 format with Rockridge extensions.

   The device_file in this example is /etc/pfs_fstab. For a CD-ROM device with the path /etc/pfs_fstab, enter the following:

   /dev/dsk/c4t2d0 /SD_CDROM pfs-rrip xlat=unix 1 0
   
   

5. Log in as the root user with the following command:

   $ su root
   
   

6. Enter the following commands:

   # nohup /usr/sbin/pfs_mountd &
   # nohup /usr/sbin/pfsd &
   
   

7. Mount the CD-ROM by entering the following command:

   # /usr/sbin/pfs_mount /SD_CDROM
   
   

8. Log out of the root account.

   # exit
   
   

If you run Oracle Universal Installer while the current working directory is on the CD-ROM, follow these steps to mount the next CD-ROM:

1. Change to the system root directory and log in as the root user:

   $ cd /
   $ su root
   
   

2. To unmount the CD-ROM, use the following command:

   # /usr/sbin/pfs_umount /SD_CDROM
   
   

3. Remove the CD-ROM from the CD-ROM drive.

4. Insert the required CD-ROM into the CD-ROM drive and mount it with the following command:

   # /usr/sbin/pfs_mount /SD_CDROM
   
   

5. Enter the correct mount point in the Installation screen.

6. Click OK to continue.

Mounting CD-ROMs for Linux

Mount the first CD-ROM of the appropriate installation to begin. Mount the subsequent disk or disks when prompted. Use the following procedures to mount the CD-ROMs:

• Mounting CD-ROMs for Linux with Auto Mounting Software

• Mounting CD-ROMs for Linux Manually

Mounting CD-ROMs for Linux with Auto Mounting Software

If you are using auto mounting software, the CD-ROM is mounted automatically to the directory specified in your auto mount configuration when you insert it into the CD-ROM drive. Proceed to "Starting Oracle Universal Installer".

To check if you have auto mounting software, use the following command:

$ ps -aux | grep automount

If you have auto mounting software, the output must be similar to the following:

root 628 0.0 0.2 1148 588 ? S 17:32 0:00 /usr/sbin/automount /misc file 
/etc/auto.misc

In the preceding output, the /etc/auto.misc entry defines the directory under the /misc file where the CD-ROM is to be mounted.

• If the auto mounting software is running and configured properly, the CD-ROM is mounted automatically. Proceed to "Starting Oracle Universal Installer".

• If no lines are returned, the auto mounting software is not running, you must mount the CD-ROM manually. Proceed to "Mounting CD-ROMs for Linux Manually".

Follow these steps to mount subsequent CD-ROMs:

1. Remove the CD-ROM from the CD-ROM drive by using the following commands:

   $ cd /
   $ eject
   
   

2. Insert the next CD-ROM into the CD-ROM drive and enter the correct mount point in the Installation dialog box of Oracle Universal Installer.

3. Click OK to continue.

Mounting CD-ROMs for Linux Manually

To mount the Oracle CD-ROM manually, use the following steps:

1. Place the first CD in the CD-ROM drive.

2. Log in as the root user and, if necessary, create a CD-ROM mount point directory by using the following commands:

   $ su root
   # mkdir cdrom_mount_point_directory
   
   

3. Mount the CD-ROM drive on the mount point directory by using the following commands:

   # mount options device_name cdrom_mount_point_directory
   
   

4. Exit the root account:

   # exit
   
   

If you are unsure of the correct device_name, consult your system administrator. Typically, the device_name is /dev/cdrom. For example:

$ su root
# mkdir /cdrom
# mount -t iso9660 /dev/cdrom /cdrom
# exit

If you run Oracle Universal Installer while the current working directory is in the CD-ROM, follow these steps to mount the next CD-ROM:

1. Change directories to the root directory of your system and log in as the root user by using the following commands:

   $ cd /
   $ su root
   
   

2. Unmount the CD-ROM by using the following command:

   # umount cdrom_mount_point_directory
   
   

3. Remove the CD-ROM from the CD-ROM drive.

4. Insert the next CD-ROM into the CD-ROM drive and then use the following command to mount it:

   # mount cdrom_mount_point_directory
   
   

5. Enter the correct mount point in the Installation screen of Oracle Universal Installer.

6. Click OK to continue.

Installing Oracle Components from a Hard Drive

You can avoid the need to mount and unmount CD-ROMs during installation by copying the contents of each CD-ROM to your system's hard drive. You must have a file system that is not in use by other applications and enough disk space available.

1. Copy each CD-ROM to your system's hard drive under a directory named Disk1 for the first CD-ROM, a directory named Disk2 for the second CD-ROM, and so on (depending upon the number of the CD-ROM in the sequence of disks that comprises the set).

2. Start Oracle Universal Installer. Oracle Universal Installer automatically finds the contents of each CD-ROM and does not prompt for the location of any CD-ROM during the course of the installation.

   See Also: "Hardware Requirements" for hard disk requirements for your platform "Installing Oracle Components from the CD-ROMs" for instructions on mounting and unmounting CD-ROMs

Oracle Universal Installer Overview

Oracle Collaboration Suite uses Oracle Universal Installer to guide you through each step of the installation process. Oracle Universal Installer provides the following features:

• Describes installation options for Oracle Collaboration Suite

• Detects preset environment variables and configuration settings

• Sets environment variables and configuration during installation

• Deinstalls Oracle Collaboration Suite products

This section describes the following Oracle Universal Installer features:

• Oracle Universal Installer Prerequisite Checks

• oraInventory Directory and Installation Session Log Files

• Additional Component Installations with Oracle Universal Installer

Oracle Universal Installer Prerequisite Checks

Oracle Universal Installer automatically checks your computer prior to installation to verify that your system meets operational requirements. Table 4-2 lists the prerequisite checks that are performed.

Table 4-2 Oracle Universal Installer Automatic Prerequisite Checks  

Prerequisite Checks	See Also
Check for enough disk space for Oracle home installation	Table 2-1, "Oracle Collaboration Suite Hardware Requirements"
Check for TMP (/var/tmp) variable and sufficient swap space	Table 2-1, "Oracle Collaboration Suite Hardware Requirements"
Check that the install host has enough RAM	Table 2-1, "Oracle Collaboration Suite Hardware Requirements"
Verify existence of one Oracle9iAS Infrastructure installation	Chapter 1, "Installation Overview"
Check the /etc/hosts file	"Hostnames File Configuration"
Prohibit installation of Oracle9iAS Infrastructure if an unpatched 9.0.2.0.0 version of Oracle9iAS Infrastructure is detected	"Upgrading Oracle9iAS Infrastructure 9.0.2.0.0"
Check for Solaris Operating Environment 32-bit version 2.6 or later	"Operating System Versions"
Verify the monitor has 256 color viewing capability	"Hardware Requirements"
Verify installation of correct Solaris kernel patches	"Determining Random Access Memory"
Verify operational requirements of the CPU	Table 2-1, "Oracle Collaboration Suite Hardware Requirements"

See Also: Appendix A, "Installation Checklists" for the installation checklists for each installation of Oracle Collaboration Suite

oraInventory Directory and Installation Session Log Files

Oracle Universal Installer creates the oraInventory directory the first time it is run on a computer. The oraInventory directory keeps an inventory of products that Oracle Universal Installer installs on your computer, as well as other installation information. If you have previously installed Oracle products, then you may already have an oraInventory directory.

The UNIX group that owns Oracle Universal Installer must have permission to write to the oraInventory directory. Attempts to run Oracle Universal Installer without this permission fails. For more information, see "UNIX Group Name for the Oracle Universal Installer Inventory".

The location of oraInventory depends upon your operating system, as shown in Table 4-3:

Table 4-3 Location of oraInventory

Platform	oraInventory location
Solaris	/var/opt/oracle/oraInst.loc
HP 9000 Series HP-UX	/var/opt/oracle/oraInst.loc
Linux Intel	/etc/oraInst.loc

The log file of the most recent installation is:

/your_base_directory/oraInventory/logs/installActionstodays_date_time.log

where your_base_directory identifier is the location for your installation files and todays_date_time is the date and time of installation.

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

Note: The make.log file in the $ORACLE_HOME/install directory contains a log of every make file action executed during the installation process. The make.log file also records any link errors during installation. Do not delete or alter the make.log file.

Additional Component Installations with Oracle Universal Installer

When you are planning to install a subsequent Oracle Collaboration Suite or Oracle9iAS Infrastructure installation on the same host, Oracle Corporation recommends the following steps:

• Review Chapter 2, "Preparing for Installation" for preinstallation tasks.

• Do not delete or modify the /var/opt/oracle directory for subsequent Oracle Collaboration Suite installations.

• Stop the Oracle Enterprise Manager Web Site. For more information, see the Oracle9i Application Server Administrator's Guide.

• Ensure that all other previously installed Oracle Collaboration Suite instances are running when you begin installation.

• Specify a different Oracle home than the first Oracle Collaboration Suite installation.

• Use the same oraInventory directory for subsequent Oracle Collaboration Suite installations.

• Review Chapter 3, "Deployment" in this guide to ensure successful coexistence of Oracle Collaboration Suite components.

  See Also: "oraInventory Directory and Installation Session Log Files"

Starting Oracle Universal Installer

Caution: Oracle Universal Installer automatically installs the Oracle-supplied version of the Java Runtime Environment (JRE). This version is required to run Oracle Universal Installer and several Oracle assistants. Do not modify the JRE except by using a patch provided by Oracle Support Services. Oracle Universal Installer also installs JDK 1.3.1 on Linux and Solaris. On HP, Oracle Universal Installer prompts for the downloaded/installed location of JDK 1.3.1.

See Also: The Oracle Universal Installer online help if you have questions about the type of information to enter during the installation procedures described in this section

Follow these steps to start Oracle Universal Installer and each Oracle Collaboration Suite installation:

1. Ensure that you have completed all the requirements described in Chapter 2, "Preparing for Installation".

2. Print and complete the installation checklists in Appendix A, "Installation Checklists" for each installation. Many of the values are needed to complete the other installations.

3. Log in as the oracle user.

   Notes: Ensure that you are not logged in as the root user when you start Oracle Universal Installer. If you are, then only the root user has permissions to manage Oracle Collaboration Suite. Do not use mount_point as your working directory when you start Oracle Universal Installer. If you do, then you cannot eject the first CD-ROM during the installation step to insert the second CD-ROM. Oracle Corporation recommends using the same operating system user account when installing and configuring additional Oracle Collaboration Suite applications on the same host.

4. Insert the first CD-ROM of the appropriate installation into the CD-ROM drive.

5. Mount the installation CD-ROM as described in "Installing Oracle Components from the CD-ROMs" for your operating system.

6. Change directories to the directory from which to start Oracle Universal Installer:

   For...	Enter...
   Oracle9iAS Infrastructure	$mount_point_directory/ocs_infr_cd1
   Oracle Collaboration Suite	$mount_point_directory/ocs_mt_cd1
   Oracle Collaboration Suite Information Storage	$mount_point_directory/ocs_stor_cd1
   Oracle Collaboration Suite Interoperability	$mount_point_directory/ocs_interop
   Oracle Collaboration Suite Client	$mount_point_directory/ocs_clients

7. Start Oracle Universal Installer by entering one of the following commands:
   • ./runInstaller

   • ./runInstallerNLS

     Note: The runInstallerNLS command installs user interface support for ten languages. See "Multilingual Support" for a list of supported languages. The runInstaller command installs user interface support only in English.

   8. After Oracle Universal Installer starts, the Welcome screen appears.

   9. Click Next.

      The Inventory Location screen appears if this is the first Oracle installation on this computer.

   10. Verify the location of the base directory for installation files. See "oraInventory Directory and Installation Session Log Files" for more information.

       Note: If you install Oracle Collaboration Suite Information Storage on a cluster, the Cluster Node Selection screen appears. Select the nodes on which you want to install the Oracle software. Oracle Real Application Clusters software is installed on the node from which Oracle Universal Installer is run and copied to the other selected nodes in the cluster. The local node is always selected by default. Do not install Oracle9iAS Infrastructure or Oracle Collaboration Suite on a cluster. Only Oracle Collaboration Suite Information Storage can be installed on a cluster.

   See Also: Oracle9i Real Application Clusters Setup and Configuration for more information on installing Oracle Real Application Clusters (available on the Oracle Technology Network)

   11. Click Next.

       The UNIX Group Name screen appears.

   12. Specify the oinstall group. Members of this group are granted permission to update Oracle software on the system. Review "UNIX Group Name for the Oracle Universal Installer Inventory" if you are not sure what group to specify as owner of oraInventory files.

   13. Click Next.

       The Oracle Universal Installer screen appears if the:

       • /etc directory does not exist or is not writable by the oracle user on HP or Linux

       • /var/opt/oracle/ directory does not exist or the oracle user cannot write to this directory

   14. Run the /tmp/OraInstall/orainstRoot.sh script in another terminal window as the root user. When the script has finished running, click Retry to continue the installation.

       The File Locations screen appears.

   15. Verify the source path, destination name, and destination path for your Oracle installation. The source path is the location of the product.jar file for the component you are installing. The destination name is the instance name and the destination path is the Oracle home location.

   16. Click Next.

   17. Proceed to Chapter 5, "Oracle Collaboration Suite Installations".