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

2
Pre-Installation

After verify that your system meets the requirements described in Chapter 1, "System Requirements", use this chapter when you prepare your system for installing Oracle Internet Directory.

UNIX System Configuration

Table 2-1 through Table 2-5 summarizes the requirements for installing Oracle Internet Directory on Compaq Tru64 UNIX, HP 9000 Series HP-UX, Linux Intel, Sun SPARC Solaris and Solaris Intel. If your system fails to satisfy any listed requirement, perform the tasks listed as necessary to configure your system to meet these requirements

Table 2-1 Compaq Tru64 UNIX configuration
System Factor  Requirement for Oracle Internet Directory   

UNIX Kernel Parameters:

Shared Memory 

SHMMAX

SHMMIN

SHMMNI

SHMSEG 

2139095040 (2GB - 8MB)

This setting does not affect how much shared memory is needed or used by Oracle Internet Directory or the operating system. It is used only to indicate the maximum allowable size. This setting also does not impact operating system kernel resources.

1

100

32 

Note: If any of the kernel parameters above are less than your current values, continue to use the current value. These are the requirements for Oracle Internet Directory only. If you have other programs which use shared memory, you will need to adjust the values accordingly. Take into account that a system reboot is necessary for kernel changes to take effect when planning for current and future database requirements. 

Table 2-2 HP 9000 Series HP-UX specific configuration
System Factor  Requirement for Oracle Internet Directory 

UNIX Kernel Parameters:

Shared Memory 

Use the System Administrator's Menu (SAM) to configure the HP-UX kernel with the minimum recommended values.

SHMMAX 1 GB

This setting does not affect how much shared memory is needed or used by Oracle Internet Directory or the operating system. It is used only to indicate the maximum allowable size. This setting also does not impact operating system kernel resources.

SHMMIN 1

SHMMNI 100

SHMSEG 10 

Semaphores 

SEMMNI 70

Set the number of semaphore set identifiers in the system. SEMMNI determines the number of semaphore sets which can be created at any one time.

The PROCESSES parameter can be found in each initsid.ora file, located in the $ORACLE_HOME/dbs directory. The default value of PROCESSES for the preconfigured database created by Oracle Database Configuration Assistant is 50.

SEMMNS 200

Set the number of semaphores in the system to 200. The default value of SEMMNS is 128, which is, in most cases, too low for Oracle. 

Threads 

MAX_THREAD_PROC 256 or more

Set the maximum number of threads per process to 256 or more. The default value of MAX_THREAD_PROC is 64, which is, in most cases, too low for Oracle. 

Note: If any of the kernel parameters above are less than your current values, continue to use the current value. If you have other programs which use shared memory and semaphores, you will need to adjust the values accordingly. Take into account that a system reboot is necessary for kernel changes to take effect when planning for current and future database requirements. 

Table 2-3 Linux Intel specific configuration
System Factor  Requirement for Oracle Internet Directory 

UNIX Kernel Parameters:

Shared Memory 

SHMMAX 0.5*(physical memory present in machine). Check your system for additional restrictions.

This setting does not affect how much shared memory is needed or used by Oracle Internet Directory or the operating system. It is used only to indicate the maximum allowable size. This setting also does not impact operating system kernel resources.

SHMMIN 1

SHMMNI 100

SHMSEG 10 

Semaphores 

SEMMNI 100

SEMMSL Set to 10 plus the largest PROCESSES parameter of any Oracle database on the system.

The PROCESSES parameter can be found in each initsid.ora file, located in the $ORACLE_HOME/dbs directory. The default value of PROCESSES for the preconfigured database created by Oracle Database Configuration Assistant is 50.

SEMMNS Set to the sum of the PROCESSES parameter for each Oracle database, adding the largest one twice, then add an additional 10 for each database. See "Configure the UNIX Kernel for Oracle8i" for an example of this formula.

SEMOPM 100

SEMVMX 32767 

Note: If any of the kernel parameters above are less than your current values, continue to use the current value. If you have other programs which use shared memory and semaphores, you will need to adjust the values accordingly. Take into account that a system reboot is necessary for kernel changes to take effect when planning for current and future database requirements. 

Table 2-4 Sun SPARC Solaris specific configuration
System Factor  Requirement for Oracle Internet Directory 

UNIX Kernel Parameters:

Shared Memory 

SHMMAX 4294967295

This setting does not affect how much shared memory is needed or used by Oracle Internet Directory or the operating system. It is used only to indicate the maximum allowable size. This setting also does not impact operating system kernel resources.

SHMMIN 1

SHMMNI 100

SHMSEG 10 

Semaphores 

SEMMNI 100

SEMMSL Set to 10 plus the largest PROCESSES parameter of any Oracle database on the system.

The PROCESSES parameter can be found in each initsid.ora file, located in the $ORACLE_HOME/dbs directory. The default value of PROCESSES for the preconfigured database created by Oracle Database Configuration Assistant is 50.

SEMMNS Set to the sum of the PROCESSES parameter for each Oracle database, adding the largest one twice, then add an additional 10 for each database. See "Configure the UNIX Kernel for Oracle8i" for an example of this formula.

SEMOPM 100

SEMVMX 32767 

Note: If any of the kernel parameters above are less than your current values, continue to use the current value. If you have other programs which use shared memory and semaphores, you will need to adjust the values accordingly. Take into account that a system reboot is necessary for kernel changes to take effect when planning for current and future database requirements. 

Table 2-5 Solaris Intel specific configuration
System Factor  Requirement for Oracle Internet Directory 

UNIX Kernel Parameters:

Shared Memory 

SHMMAX 0.5*(physical memory present in machine).

This setting does not affect how much shared memory is needed or used by Oracle Internet Directory or the operating system. It is used only to indicate the maximum allowable size. This setting also does not impact operating system kernel resources.

SHMMIN 1

SHMMNI 100

SHMSEG 10 

Semaphores 

SEMMNI 100

SEMMSL Set to 10 plus the largest PROCESSES parameter for any Oracle database on the system.

The PROCESSES parameter can be found in each initsid.ora file, located in the $ORACLE_HOME/dbs directory. The default value of PROCESSES for the preconfigured database created by Oracle Database Configuration Assistant is 50.

SEMMNS Set to the sum of the PROCESSES parameter for each Oracle database, adding the largest one twice, then add an additional 10 for each database. See "Configure the UNIX Kernel for Oracle8i" for an example of this formula.

SEMOPM 100

SEMMNI 100

SSEMMNS Set to the sum of the PROCESSES parameter for each Oracle database, adding the largest one twice, then add an additional 10 for each database. See "Configure the UNIX Kernel for Oracle8i" for an example of this formula. 

Understanding Setup Tasks

The following pre-installation setup tasks configure your system and set up accounts, groups, variables and permissions needed to run Oracle8i. If you do not perform these tasks prior to installation, the Installer will give the option during installation to become root and run orainstRoot.sh, a script program that will perform many of these setup tasks for you. However, running orainstRoot.sh might not provide a satisfactory environment for your system and needs. Oracle Corporation recommends that you perform these steps` manually.

Setup Tasks to Perform as the root User

Log in as the root user and perform the following tasks to set up your environment for Oracle8i:

Configure the UNIX Kernel for Oracle8i

Configure the UNIX kernel Interprocess Communication (IPC) parameters to accommodate the System Global Area (SGA) structure of Oracle8i. You will not be able to start up the database if the system does not have adequate shared memory to accommodate the SGA.

  1. Use the ipcs command to obtain a list of the system's current shared memory segments, semaphore segments, their identification number and owner.

    Because the shared memory in AIX-Based Systems, Compaq Tru64 UNIX, HP 9000 Series HP-UX, Linux Intel, Solaris Intel, and Sun SPARC Solaris is dynamically loaded, when you run ipcs you might receive a message that the shared memory facility is not in the system. The shared memory driver loads after the Oracle8i instance is started. You can check the /etc/system file to verify that the system configured with enough shared memory.

  2. Set the kernel parameters that correspond to your platform. Table 2-1 through Table 2-5 provide descriptions of the kernel parameters:

    • maximum size of a shared memory segment (SHMMAX)

    • minimum size of shared memory segment (SHMMIN)

    • maximum number of shared memory identifiers in the system (SHMMNI)

    • maximum number of shared memory segments a user process can
      attach (SHMSEG)

    • maximum number of semaphore identifiers in the system (SEMMNI)

    • maximum number of semaphores in a set (SEMMSL)

    • maximum number of semaphores in the system (SEMMNS)

    • maximum number of operations per semop call (SEMOPM)

    • semaphore maximum value (SEMVMX)

    The total allowable shared memory is determined by the formula:

    SHMMAX * SHMSEG
    

    Set SEMMNS to the sum of the PROCESSES parameter for each Oracle database, adding the largest one twice, then add an additional 10 for each database. For example, consider a system that has three Oracle instances with the PROCESSES parameter in their initsid.ora files set to the following values:

    ORACLE_SID=A, PROCESSES=100
    ORACLE_SID=B, PROCESSES=100
    ORACLE_SID=C, PROCESSES=200
    
    

    The value of SEMMNS is calculated as follows:

    SEMMNS = [(A=100) + (B=100)] + [(C=200) * 2] + [(# of instances=3) * 10] = 630

    Setting parameters too high for the operating system can prevent the machine from booting up. Refer to UNIX system administration documentation for parameter limits.

    The following lines are examples of additions to the /etc/system file to configure the UNIX kernel with the minimum recommended values:

    set shmsys:shminfo_shmmax=4294967295
    set shmsys:shminfo_shmmin=1
    set shmsys:shminfo_shmmni=100
    set shmsys:shminfo_shmseg=10
    set semsys:seminfo_semmni=100
    set semsys:seminfo_semmsl=100
    set semsys:seminfo_semmns=200
    set semsys:seminfo_semopm=100
    set semsys:seminfo_semvmx=32767
    
    
  3. Reboot the system if you have modified the kernel, shared memory, or semaphore parameters.

Create Mount Points

Oracle8i requires at least two mount points:

Create UNIX Groups for Database Administrators

During installation, two Oracle roles are created:

Database administrators are granted these roles by virtue of their membership in corresponding UNIX groups. Oracle8i documentation refers to these UNIX groups as the osdba and osoper groups. Create the group(s) for these roles before you log in as the oracle user and start the Oracle Universal Installer. You may assign the roles to two separate UNIX groups, or to a single group.

Use the admintool or groupadd utility to create a group named dba or another name of your choosing. If you plan to assign the SYSOPER role to a separate group, create that group also.

The Oracle Universal Installer gives both Oracle SYSDBA and SYSOPER privileges to members of the UNIX group dba by default. If you perform a Custom installation of Oracle8i, or if the oracle user is not a member of a group called dba, Oracle Universal Installer will prompt you to enter the group(s) you have created for these roles.

Create a UNIX Group for the Oracle Universal Installer Inventory

Use the admintool or groupadd utility to create a group named oinstall. The oinstall group will own the Oracle Universal Installer's oraInventory directory. The oracle user account that runs the installation should have the oinstall group as its primary group.

Create a UNIX Account to Own Oracle Software

The oracle account is the UNIX user account that owns the Oracle8i software after installation. Run Oracle Universal Installer with this user account.

Use the admintool or useradd utility to create an oracle account with the following properties:

Table 2-6 Properties of the oracle Account

Property 

Description 

Login Name 

Any name, but this document refers to it as the oracle account. 

Primary GID  

The oinstall group. 

Secondary GID 

The dba group. 

Home Directory 

Choose a home directory consistent with other user home directories. The home directory of the oracle account does not have to be the same as the ORACLE_HOME directory. 

Login Shell 

The default shell can be /usr/bin/sh, /usr/bin/csh, or /usr/bin/ksh, but the examples in this document assume the Bourne shell (/usr/bin/sh). 


Caution:

Use the oracle account only for installing and maintaining Oracle software. Never use it for purposes unrelated to the Oracle8i Server. Do not use root as the oracle account. 


Sites with multiple ORACLE_HOMEs on one system may install Oracle software with the same oracle account, or separate ones. Each oracle account must have oinstall as its primary group.

Setup Tasks to Perform as the oracle User

Log in to the oracle account and perform the following tasks as necessary:

Task 1: Set Permissions for File Creation

Set umask to 022 for the oracle account to ensure group and other have read and execute permissions, but not write permission, on files installed.

  1. Enter the umask command to check the current setting.

  2. If the umask command does not return 022, set it in the.profile or.login file of the oracle account and execute the following command:

    $ umask 022
    

Task 2: Set Environment Variables

Before starting the Oracle Universal Installer, set the DISPLAY and PATH environment variables and any of the other variables as appropriate. Table 2-7, "Environment Variable Summary", provides a brief summary of the variables listed in this section. Refer to each variable's entry in this section for instructions on setting the variable correctly.


Note:

If an Oracle Server already exists on your system, its settings might have a bearing on the settings that you choose for the new environment. 


Table 2-7 Environment Variable Summary
Variable  Description  Required? 

DISPLAY 

The name, server number, and screen number of the system where the Oracle Universal Installer will display. 

Yes 

PATH 

Shell's search path for executables. 

Yes 

ORACLE_BASE 

Directory at the top of the Oracle software and administrative file structure. 

No 

ORACLE_HOME 

Directory containing Oracle software for a given release. 

No 

NLS_LANG 

Language, territory and character set to use when installing. 

No 

ORACLE_SID 

The Oracle server instance identifier to use during installation. 

No 

DISPLAY

On the system where you will run Oracle Universal Installer, set DISPLAY to the system name or IP address, X-server, and screen used by your workstation. Do not use the hostname or IP address of the system where the software is being installed unless you are performing the installation from that system's X-windows console. Use the machine name or IP of your own workstation if you are installing from a remote system. If you are not sure what the X-server and screen should be set to, use 0 (zero) for both.

If you get an Xlib error similar to "Failed to connect to server", "Connection refused by server" or "Can't open display" when starting the Installer, run the following Bourne/Korn shell or C shell commands on your X workstation:


For the Bourne or Korn shells:

On the server where the Oracle database will be installed, enter the following:

$ DISPLAY=workstation_name:0.0
$ export DISPLAY

In the session on your workstation:

$ xhost +server_name


For the C shell:

On the server where the Oracle database will be installed, enter the following:

% setenv DISPLAY workstation_name:0.0

In the session on your workstation:

% xhost +server_name

If you are using a PC X server, refer to your PC X server documentation for instructions on how to configure the PC X server to allow remote X clients to connect.

Verify that the DISPLAY variable is correctly set.

PATH

Set the shell's search path to include the following:

ORACLE_BASE

ORACLE_BASE specifies the directory at the top of the Oracle software and administrative file structure. The value recommended for an OFA configuration is
software_mount_point/app/oracle. For example: /u01/app/oracle. If you are not using an OFA-compliant system, Oracle recommends that you set
ORACLE_BASE.

ORACLE_HOME

ORACLE_HOME specifies the directory containing the Oracle software for a given release. The OFA recommended value is:
$ORACLE_BASE/product/release.
For example:
/u01/app/oracle/product/8.1.7.

Ensure that the value of ORACLE_HOME points to a directory that does not already contain any Oracle software prior to Oracle8i Release 1 (8.1.5) or Release 2 (8.1.6).

NLS_LANG

For Oracle Internet Directory, set NLS_LANG for the database to utf8.

Oracle supports client/server environments where clients and servers use different character sets. The character set used by a client is defined by the value of the NLS_LANG parameter for the client session. The character set used by a server is its database character set. Data conversion is done automatically between these character sets if they are different.

See Also:

For more information about National Language Support features, refer to Oracle8i Administrator's Reference. A complete list of valid character sets is available in the Oracle8i National Language Support Guide

ORACLE_SID

If you plan on creating a database during installation, you have the option of setting ORACLE_SID to the value of the Oracle server instance identifier (referred to in this installation guide as the sid). If you choose to create a database during installation, the Installer will prompt you to confirm this value.

Task 3: Update the Environment for Current Session

With a text editor, add the settings for the environment variables listed in "Task 2: Set Environment Variables" to the.profile or.login file of the oracle account. Once you have finished editing these initialization files, you can quickly update the environment in the current shell session before beginning installation by using the appropriate shell command.

For the Bourne or Korn shell:

$ ../.profile

For the C shell:

% source .login

Setup Tasks for Oracle Internet Directory

For optimal directory performance, Oracle Corporation recommends installing Oracle Internet Directory on a system separate from other Oracle software.

If Oracle8i Release 8.1.7 is not already installed on your system, then Oracle Universal Installer will install it with Oracle Internet Directory.

Complete these steps in addition to those steps listed in the chapter on preliminary tasks in Oracle Internet Directory Administrator's Guide.

If Oracle8i Release 8.1.7 is already installed on your system, verify that:


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

All Rights Reserved.

Library

Contents

Index