Oracle Internet Directory Installation Guide
Release 2.1.1 for UNIX

Part Number A88797-01

Library

Contents

Index

Go to previous page Go to next page

3
Installation

This chapter describes how to start the Oracle Universal Installer and install Oracle Internet Directory. Review and complete the tasks listed in Chapter 1, "System Requirements" and Chapter 2, "Pre-Installation" before beginning the installation.

Oracle Universal Installer

Complete these tasks to start Oracle Universal Installer:

Mount the Oracle Internet Directory CD-ROM

The Oracle Internet Directory CD-ROMs are in ISO 9660 format with Rockridge extensions.

If you are using Volume Management software (available by default on Solaris Intel and Sun SPARC Solaris) the CD-ROM is mounted automatically to /cdrom/oracle8i when you put it into the disk drive. Proceed to "Start Oracle Universal Installer (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. Unmount the CD-ROM before removing it from the drive by using the umount command.

Mounting the CD-ROM for AIX-Based Systems, Compaq Tru64 UNIX, Linux Intel, Solaris Intel and Sun SPARC Solaris.

  1. Place the Oracle Internet Directory CD-ROM in the CD-ROM drive.

  2. Log in as the root user and create a CD-ROM mount point directory:

    $ su root
    # mkdir cdrom_mount_point_directory
    
    
  3. Mount the CD-ROM drive on the mount point directory and exit the root account.

    For AIX-Based Systems, Linux Intel and Solaris Intel, use the following:

    # mount options device_name cdrom_mount_point_directory 
    # exit
    
    

    For Compaq Tru64 UNIX, use the following:

    # mount -t cdfs -r -o nodefperm, noversion, rrip device_name 
    cdrom_mount_point_directory
    # exit
    

    These options have the following meaning:

    -t cdfs = ISO 9660 CD.
    -r = mount the CD read-only
    -o = include the following options.
    nodefperm = use the file permissions recorded on the CD instead of 
    defaults.
    noversion = do not show ISO version numbers.
    rrip = use Rockridge extensions.
    

Example 3-1 Mounting the CD-ROM

The following examples show how to manually mount the CD-ROM on AIX-Based Systems, Compaq Tru64 UNIX, Linux Intel, Solaris Intel and Sun SPARC Solaris.

On AIX-Based Systems, enter:

$ su root
# mkdir /cdrom
# chmod 777 /cdrom
# mount -rv cdrfs /dev /cd0 /cdrom
# exit
Running the rootpre.sh Script

Shut down all running databases, become root, and run rootpre.sh:

  1. As the oracle user, shut down all databases on the machine.

  2. Log in as root and change to the CD-ROM mount point directory:

    $ su root
    # cdrom_mount_point_directory
    
  3. Run the rootpre.sh on all nodes before installing the Oracle Parallel Server Option:

    $ su root
    # cd /cdrom
    # ./rootpre.sh
    # exit
    
On Compaq Tru64 UNIX, enter:

$ su root
# mkdir /cdrom
# mount -t cdfs -r -o nodefperm, noversion, rrip /dev/rz4c /cdrom
# exit
On Linux Intel, enter:

$ su root
# mkdir /cdrom
# mount -t iso9660 /dev/cdrom /cdrom
On Solaris Intel, enter:

$ /etc /mount -F hsfs -r /dev/dsk/c0t6d0p0 /cdrom
On Sun SPARC Solaris, enter:

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

Mounting the CD-ROM for HP 9000 Series HP-UX:

The Oracle Internet Directory CD-ROMs are in ISO 9660 format with Rockridge extensions. There are two CD-ROM disks included with Oracle Internet Directory Release 2.1.1. Use disk one to begin the installation. Mount disk two when prompted to do so.


Note:

See the release notes for your platform for details on mounting disks for Oracle Internet Directory Release 2.1.1. 


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.

  1. Use a system editor to add the following line to the /etc/pfs_fstab file.

Syntax

<device_file> <mount_point> <filesystem_type> <translation_method>

The first entry is the CD-ROM device file; the second is the mount point. The third indicates that the CD-ROM to be mounted is in ISO 9660 format with RockRidge extensions.

Example

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


  • Login as root.

  • Enter the following command.

    $ nohup /usr/sbin/pfs_mountd &
    
    
  • Enter the following command.

    $ nohup /usr/sbin/pfsd &
    
    
  • Place the CD-ROM into the tray and run the following command to mount the CD-ROM:

    $ /usr/sbin/pfs_mount /SD_CDROM
    
    
  • Log out of the root account.

    # exit
    
    Change directories to /SD_CDROM where you can see a lowercase listing of the 
    directories and files on the CD-ROM. The mounted CD-ROM should appear as 
    another read-only file system.
    

    Start Oracle Universal Installer (OUI)


    Caution:

    Do not run the Installer as the root user. 


    To start Oracle Universal Installer:

    1. Log in as the oracle user.

    2. Go to the CD-ROM mount-point directory:

      cd cdrom_mount_point_directory
      
      
      
    3. Start the Installer by entering ./runInstaller.


      Note:

      The Oracle Universal Installer (OUI) is capable of running a non-interactive installation of Oracle products. Optionally, you can configure OUI for "silent" mode which does not display anything on the screen. For instructions on using this feature of the Installer, see "Non-Interactive (Silent) Installation and Configuration"



      Warning:

      Oracle Universal Installer automatically installs Oracle's 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, unless doing so with a patch provided by Oracle Support Services. 


    Performing the Installation

    The following procedure contains instructions for the Oracle Universal Installer.

    1. Start the Installer. The Welcome window appears.

    2. Click [Next].

      The File Locations window appears. Do not change the text in the Source field. This is the location of files for installation.

    3. In the Destination field, enter the ORACLE_HOME directory path in which to install Oracle Internet Directory. The default location is the ORACLE_HOME environment variable if you set it prior to starting the Installer.

      If the destination directory you choose contains a previous release of Oracle Internet Directory, the Installer will upgrade the older version of the software to Release 2.1.1. Oracle Corporation recommends that you install Release 2.1.1 products into a new ORACLE_HOME.

    4. Click [Next].

      If this is the first time Oracle Internet Directory is installed on your system, the UNIX Group Name window appears. If it is not the first install, go to Step 6.

      In the UNIX Group Name field, specify the group that will have permission to update Oracle software on the system. This group typically should be the oinstall group created in "Create a UNIX Group for the Oracle Universal Installer Inventory".

    5. Click [Next].

      If /var/opt/oracle/ does not exist or is not writable by the oracle user, an Installer window will open and prompt you to run /tmp/OraInstall/orainstRoot.sh in another terminal window as the root user. After you run orainstRoot.sh, click [Retry] to continue the installation.


      Attention: The orainstRoot.sh Installer window will open only if you do not complete the pre-installation steps . If you choose to run the orainstRoot.sh script, the oraInventory file and other files will write the Oracle uses in ORACLE_HOME in order to ensure that Oracle has write access. This configuration might not be optimal for your system and your needs. Oracle Corporation recommends that you complete the steps described in Chapter 2, "Pre-Installation".:  
    6. The Available Products window presents two options:

      • Install Oracle Internet Directory Client 2.1.1.0.0

      • Install Oracle Internet Directory 2.1.1.0.0

      If you select the client installation, then Oracle Universal Installer silently processes your request. It then displays the Summary window. Skip to "Performing a Typical Installation".

      If you select the server installation, then the Installation Types window appears.

    7. Select the installation type you want to install--Typical or Custom--and choose [Next].

    8. If you select a custom installation, then skip to "Upgrading Oracle Internet Directory".

      If you select a typical installation, then follow the steps below based on the window that appears:

      If Oracle8i Database...  Then The...  Go To... 

      Release 8.1.7 is already installed on the computer, but Oracle Internet Directory Release 2.1.1 is not installed. 

      Using an existing instance window appears, you are prompted for the SID to use, and another Oracle8i database is not installed. 

      Step 1 of "Performing a Typical Installation" on page 3 - 8

      Releases 8.1.5, 8.1.6 and 8.1.7 and Oracle Internet Directory Releases 2.0.4, 2.0.6 and 2.1 are not installed on the computer. 

      Database Identification window appears and Oracle8i database Release 8.1.7 is automatically installed in the same home with Oracle Internet Directory Release 2.1.1. 

      Step 3 of "Performing a Typical Installation" on page 3 - 8

      Releases 8.1.5 or 8.1.6 and Oracle Internet Directory Release 2.0.4 or 2.0.6 are already installed on the computer. 

      Upgrade OID window appears and prompts you to upgrade to Oracle8i database Release 8.1.7 and Oracle Internet Directory Release 2.1.1. 

      "Upgrading Oracle Internet Directory" on page 3 - 13

    Performing a Typical Installation

    If an Oracle8i database Release 8.1.7 is not currently installed, then Oracle Universal Installer automatically installs one in the same ORACLE_HOME directory in which Oracle Internet Directory is installed.

    1. Select [Yes] to use the installed database with Oracle Internet Directory, and click [Next]. Otherwise, select [No] and click [Next] to use a different database with Oracle Internet Directory, and go to step 4.

      The Oracle SID window appears.

    2. Enter the SID of the installed database.

    3. Click [Next]. Go to step 5.

      The Database Identification window appears.

    4. Enter the Global Database Name and SID fields in the fields provided:

      In This Field...  Enter The... 

      Global Database Name 

      Full database name that uniquely distinguishes it from any other database in your network domain. For example:

        sales.us.acme.com

      where sales is the name you want to call your database, and us.acme.com is the network domain in which the database is located. 

      The OiD Database File Location window appears.

    5. Enter a directory location in which to install the Oracle Internet Directory database files. Oracle Corporation recommends installing database files and Oracle software on separate drives. These database files contain Oracle Internet Directory-specific tables and schema created during configuration.

    6. Click [Next].

      If you are not a member of the DBA group, then the Privileged Operating System Groups window appears. Specify the UNIX groups to which Oracle Universal Installer should assign Oracle DBA and Operator privileges. See the online help for a description of this screen.

    7. Click [Next].

      The Summary window appears. Review the information to ensure that you have enough disk space. You cannot make any product or space allocation changes once the installation begins.

    8. Click [Install]. Wait until the selected products are installed.

      The following information is automatically set during installation:

      The...  Is Automatically Set to... 

      Use of an Encrypted Password 

      Yes 

      Encryption Schema 

      MD4 

      Approximate number of directory entries to be stored in Oracle Internet Directory 

      Under 10,000 entries 

      Password of the Administrator Distinguished Name 

      welcome 

    9. The Install window appears. Run the root.sh Script when prompted.

      The Installer creates the root.sh script in the ORACLE_HOME directory and prompts you to run the script when it finishes installing Oracle products. Log in as the root user and run the script to set the necessary file permissions for Oracle products, and perform other root-related configuration activities.

      # cd $ORACLE_HOME
      # ./root.sh
      
      
      

      The root.sh script prompts you to confirm the environment before it performs any actions. If you need to reset the environment, terminate the root.sh script. You do not need to run Oracle Universal Installer again. Click [OK] in the alert window after root.sh runs successfully to continue the installation.

      Depending on the products you installed, messages are displayed to inform you of the progress of root.sh. You might also be prompted for user names and be given additional instructions.

      You will be asked by the root.sh script to specify the local bin directory. If this directory does not already exist, root.sh creates it for you.

    10. The Configuration Tools window appears at the end of installation and automatically starts the following assistants to create and configure your network and Oracle Internet Directory environments:

      This Assistant...  Starts...  And... 

      Net8 Configuration Assistant 

      If not currently installed on this computer. 

      Prompts you to configure your Net8 server networking software. Select Perform typical configuration and accept all default settings by choosing the [Next] button as each window appears. 

      OiD Configuration Assistant 

      In all cases. 

      Creates Oracle8i tablespaces and schema in the Oracle8i database server and starts the Oracle directory server.

      Note: If a database needs to be installed, Oracle Database Configuration Assistant is automatically launched within OiD Configuration Assistant to create a database with the UTF8 character set. 

    11. The End of Installation window appears.

    12. Click [Exit] to exit Oracle Universal Installer, or click [Next Install] to install additional products. Selecting [Next Install] returns you to the Oracle Universal Installer File Locations Window.

      See Also:

      "Reviewing a Log of an Installation Session" to view a log file summary of your installation session. 

    Performing a Custom Installation

    If you choose to perform a custom installation, then the Component Locations window prompts you to select alternate locations in which to install some components.

    1. Choose [Next] to accept the default locations. Otherwise, choose a component to display a text box for changing the default location. Then, click [Next]. The Database Identification window appears.

    2. Enter the global database name and SID for the Oracle8i database and click [Next]:

      In This Field...  Enter The... 

      Global Database Name 

      Full database name that uniquely distinguishes it from any other database in your network domain. For example:

      sales.us.acme.com

      where sales is the name you want to call your database and us.acme.com is the network domain in which the database is located. 

      SID  

      Database instance name that uniquely distinguishes it from any other database on your computer. The SID automatically defaults to the database name portion of the global database name (sales in the example above) until you reach eight characters or enter a period. You can accept or change the default value. 

      The OiD Database File Location window appears if a database is not currently installed.

    3. Enter a directory location in which to install the Oracle Internet Directory database files. Oracle Corporation recommends installing database files and Oracle software on separate hard disks. These database files correspond to Oracle Internet Directory-specific tables and schema created during configuration.

    4. Click [Next].

      The OiD User Password Encryption window appears.

    5. Select whether or not to enable password encryption and click [Next].

      The User Password Hashing Algorithm window appears.

    6. Select an encryption schema to use and click [Next].

      The OiD Administrator Password window appears.

    7. Enter a password.

      This password enables you to make all changes in Oracle Internet Directory.

    8. Enter the same password a second time and click [Next].

      The OiD Size Configuration window appears.

    9. Select the approximate number of directory entries to be stored in Oracle Internet Directory and click [Next].

      The Summary window appears.

    10. Review the space requirements to ensure that you have enough disk space and click [Install].

      The Configuration Tools window appears at the end of installation and automatically starts the following assistants to create and configure the Oracle8i database for use with Oracle Internet Directory:

      This Tool...  Starts...  And... 

      Net8 Configuration Assistant 

      If Net8 Client Release 8.1.7 is not already installed in the currently-specified Oracle home.

      Note: Net8 Client Release 8.1.6 or earlier installations in this Oracle home will be upgraded. 

      Prompts you to configure your Net8 server networking software. Select Perform typical configuration and accept all default settings by choosing the [Next] button as each window appears. 

      OiD Configuration Assistant 

      In all cases. 

      Creates Oracle Internet Directory tablespaces and schema in the Oracle8i database and starts the Oracle Internet Directory server.

      Note: Oracle Database Configuration Assistant is automatically launched within OiD Configuration Assistant to guide you through a Custom installation of the Oracle8i database. Ensure that you select the UTF8 character set when prompted. 

      The End of Installation window appears.

    11. Click [Exit] to exit Oracle Universal Installer or choose [Next Install] to install additional components.

    Upgrading Oracle Internet Directory

    The Upgrade OiD window appears if you have a previously-installed version of Oracle Internet Directory on your system.

    If Oracle Universal Installer detects an existing Oracle8i database in this location, it does not install another one. However, for optimal results, Oracle Corporation recommends that you install Oracle Internet Directory on a system that does not currently have an Oracle8i database.

    If you intend to upgrade an existing installation of Oracle Internet Directory and Oracle8i Enterprise Edition, and you initially installed Oracle Internet Directory separately, then you should upgrade each program separately in order to ensure that all components of Oracle Internet Directory are upgraded.

    Before upgrading Oracle Internet Directory, stop the following processes:

    1. Select [Yes] to upgrade an existing Oracle database already configured for use with Oracle Internet Directory.

    2. Click [Next].

      The Oracle SID window appears.

    3. Enter the system identifier (SID) of the Oracle database to be upgraded.

      The OiD Password window appears.

    4. Enter the password for the Oracle directory server user (ODS by default) and the Oracle Internet Directory administrator (WELCOME by default).

    5. The Configuration Tools window appears and automatically starts the following assistants to upgrade your Oracle database and Oracle Internet Directory environments:

      This Assistant...  Upgrades... 

      Oracle Data Migration Assistant 

      Oracle8i Release 8.1.5 or 8.1.6 to 8.1.7. 

      OiD Upgrade Assistant 

      Oracle Internet Directory Release 2.0.4 or 2.0.6 to Release 2.1.1 

    Reviewing a Log of an Installation Session

    The first time you use the Installer, it creates the oraInventory directory to keep an inventory of products that it installs on your system as well as other installation information. This information is useful in diagnosing and resolving installation problems.

    The location of oraInventory is defined in /var/opt/oracle/oraInst.loc.

    The latest log file is oraInventory_location/logs/installActions.log. Log file names of previous installation sessions take the form installActionsdatetime.log.

    For example:
    installActions1999-07-14_09-00-56-am.log


    Note:

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

    The make.log file in ORACLE_HOME/install contains a log of every make action called for in the installation process. You can find link errors during installation in the make.log file. Do not delete or alter the make.log file.  


    Cleaning Up After a Failed Installation

    If an installation fails, you might need to remove files that the Installer created during the failed installation:

    To clean up after a failed installation:

    1. Start the Oracle Universal Installer.

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

    3. Click the [Remove] button.

    To complete the clean up, you might need to manually remove the
    ORACLE_HOME directory, in case the Installer copied files to your system but failed to register them during the unsuccessful installation. This step is not required if deinstallation cleans up ORACLE_HOME, and if only insignificant files are left after deinstallation.

    Non-Interactive (Silent) Installation and Configuration

    You can perform a non-interactive (or "silent") installation of Oracle8i products by supplying the Oracle Universal Installer with a response file. The Installer uses the variables and values contained in this text file to provide answers to some or all of the Installer's user prompts. If you include responses for all of the Installer's prompts in the response file, you can run a silent installation that displays no graphical output. You can also run Oracle Data Migration Assistant, Net8 Configuration Assistant, Oracle Database Configuration Assistant, and Oracle Enterprise Manager Configuration Assistant non-interactively by using response files.

    Preparing the Response File

    There are five Oracle Universal Installer response files, one for each install category and type, and three configuration tool response files included on the Oracle Internet Directory CD-ROM. You need to edit the response file to suit your environment. In particular, the custom response files need extensive editing before you can use them for a non-interactive session.

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

    $ cd cdrom_mount_point_directory/response
    $ cp oidtyp.rsp local_directory
    
    

    Edit the response file with any text editor to include information specific to your system. Each file contains instructions for properly configuring the response file. Table 3-1 lists the response files included on the Oracle Internet Directory CD-ROM.

    Table 3-1 Response Files
    File Name  Provides Responses for... 

    oidtyp.rsp 

    Oracle Internet Directory server installation 

    oidcus.rsp 

    Oracle Internet Directory server custom installation 

    oidclnttyp.rsp 

    Oracle Internet Directory client installation 

    dbca.rsp 

    Oracle Database Configuration Assistant 

    net8ca.rsp 

    Net8 Configuration Assistant 

    Specifying a Response File

    To make the Installer use the response file at install time, follow the same steps as described in the section "Start Oracle Universal Installer (OUI)", but specify the location of the response file that you wish to use as a parameter when starting the Installer.

    $ ./runInstaller [-silent] -responseFile filename
    
    

    To use a configuration assistant in silent mode, outside of an installation session, you need to make it use a response file. You may either have the Installer spawn the silent configuration assistant, or run the configuration assistant in standalone mode. Invoke the configuration assistant at the command line using the same mode and response file parameters.

    To perform a completely silent installation or configuration session, use the -silent parameter. In silent mode, the DISPLAY environment variable must still be set as described in "DISPLAY".

    To run the Oracle Enterprise Manger Configuration Assistant in non-interactive mode, you must use both the -silent and -responseFile parameters.

    The success or failure of the installation is logged in the silentInstall.log file. If an Oracle Inventory exists on your system, then the silentInstall.log file is created there. Otherwise, it is created in the oraInventory_location/logs/ directory. The detailed results of the non-interactive installation session are found in the oraInventory_location/logs/installActions.log file.


    Note:

    The Installer or configuration assistant will fail if you attempt a non-interactive session without correctly configuring a response file. 


    See Also:

    For more information on silent install and installation using response files, see the Oracle Universal Installer Concepts Guide

    First time Installation in Silent Mode

    If you will perform the first installation of Oracle products on a system with Oracle Universal Installer running in silent mode, you must manually create the oraInst.loc file. This file specifies the directory where the installer creates the inventory of Oracle products installed on the system. Before creating this file, read and complete the tasks detailed in Chapter 1 and Chapter 2.

    To create the oraInst.loc file:

    1. Log in as the root user.

      $ su
      
      
    2. If it does not already exist on your system, you must create the /var/opt/oracle directory.

      # mkdir /var/opt/oracle
      
      
    3. Change to the /var/opt/oracle directory.

      # cd /var/opt/oracle
      
      
    4. Using a text editor, create a file called oraInst.loc with the following two lines of content:

      inventory_loc-inventory_directory.
      inst_group=
      

      Set inventory_loc to ORACLE_BASE/oraInventory. For example, if ORACLE_BASE is /uo1/app/oracle, then inventory_directory should be /uo1/app/oracle/oraInventory.

      Include, but do not set, inst_group= on the second line.

    Error Handling

    Values for variables that are of the wrong context, format, or type are treated as if they had no value specified. Variables which are outside any section are ignored.

    A non-interactive installation fails if you do not specify a response file is or if you attempt a silent installation with an incorrect or incomplete response file. If you attempt a silent installation and the Installer encounters an error, such as insufficient disk space, the installation fails. The results of your non-interactive installation is recorded in the installation session's log file.

    See Also:

    "Reviewing a Log of an Installation Session" to view a log file summary of your installation session. 

    Validation of Values from Response File

    The Installer or configuration assistant performs calculation and validation of the response file at run time. Failure of the validation process ends the installation or configuration.


  • Go to previous page Go to next page
    Oracle
    Copyright © 2001 Oracle Corporation.

    All Rights Reserved.

    Library

    Contents

    Index