Skip Headers
Oracle® Content Database Installation Guide
10g Release 1 (10.2.0.0.0) for Solaris Operating System (x86) and Solaris Operating System (x86-64)

Part Number B32188-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

4 Preinstallation Requirements for Oracle Content DB Middle Tier


Note:

Prior to installing Oracle Content DB middle tier, you must first install OracleAS Infrastructure (which contains Oracle Identity Management) and Oracle Database. Refer to Chapter 3, "Installing OracleAS Infrastructure and Oracle Database" for more details.

This chapter discusses necessary requirements that must be met prior to installing Oracle Content DB.


See Also:


This chapter includes the following topics:

4.1 Oracle Content DB Hardware Requirements

This section lists the hardware configurations required to install Oracle Content DB.

Oracle Universal Installer checks these requirements at the start of the installation process and warns you if any of these requirements are not met. Therefore, to save time, you can manually check only the remaining requirements.

You can also run the system checks performed by Oracle Universal Installer without doing an installation by running the following command, where the runInstaller executable is on the Oracle Content DB DVD.

$ mount_point/runInstaller -executeSysPrereqs

The results are displayed on the screen as well as written to a log file.


See Also:

"Prerequisite Checks Performed by Oracle Universal Installer" for more information about the subset of checks performed

Table 4-1 Hardware Requirements for Solaris x86 and x86-64

Item Requirement Checked by Oracle Universal Installer

Operating System

Solaris x86: Solaris 9 or Solaris 10

Solaris x86-64: Solaris 10

Yes

Processor Type

i386 Compatible

You can check the processor type by using the following command:

prompt>/usr/sbin/psrinfo -v 
Status of virtual processor 0 as of: 07/03/2006 05:45:42
on-line since 04/18/2006 15:31:30.
The i386 processor operates at 2393 MHz,
and has an i387 compatible floating point processor

No

Processor Speed

450 Mhz or faster

You can check the processor type by using the following command:

prompt>/usr/sbin/psrinfo -v
Status of virtual processor 0 as of: 07/03/2006 05:45:42
on-line since 04/18/2006 15:31:30.
The i386 processor operates at 2393 MHz,
and has an i387 compatible floating point processor

No

Network

You can install Oracle Content DB on a computer that is connected to a network.

No

IP

The computer's IP address must be static.

No

Hostname

Ensure that your hostnames are not longer than 255 characters.

No

Support for 32-bit and 64-bit Applications

Oracle Content DB runs as a 32-bit application. Therefore, the operating system must be configured to support 32-bit applications. To check if this requirement is met, run the isainfo command with the -v option as follows:

On a 32-bit operating system:

prompt> /usr/bin/isainfo -v
32-bit i386 applications

On a 64-bit operating system:

prompt> /usr/bin/isainfo -v
64-bit amd64 applications
32-bit i386 applications

If the output does not show both lines, you need to reconfigure your computer. Check with your system administrator.

No

Memory

Oracle recommends that the system have atleast 3 GB of memory.

Notes:

The installer checks the amount of memory on your computer and will warn you if your computer does not meet the minimum memory requirements.

To determine the amount of memory, use the prtconf command:

prompt> /usr/sbin/prtconf | grep Memory

Yes

Available Memory

In addition to the total memory requirement, you also need to check that your computer has enough available memory during installation.

To check, run the /usr/bin/vmstat command as follows:

prompt> /usr/bin/vmstat 2 2

The command returns two lines of data. For example:

procs     memory            page            disk          faults      cpu
r b w   swap  free  re  mf pi po fr de sr f0 s0 s1 s6   in   sy   cs us sy id
0 0 0 2110504 142240 40 145 3  0  0  0  0  0  0  1  0  310  144  290  8  5 87
0 0 0 2090368 128816 17 100 0  0  0  0  0  0  0  0  0  307  573  281  2  2 96

The amount of available memory is shown on the second line (shown in bold in the example).

No

Disk space

The disk space requirement for Oracle Content DB is 2 GB.

To determine the amount of free disk space, use the df command:

prompt> df -h dir

Replace dir with the directory where you plan to install Oracle Content DB or with the parent directory if the directory does not exist yet. For example, if you plan to install Oracle Content DB in /opt/oracle/cdb, replace dir with /opt/oracle or /opt/oracle/cdb.

No

Space in /tmp Directory

400 MB

To determine the amount of free space in the /tmp directory, use the df command:

prompt> df -h /tmp

If the /tmp directory does not have enough free space, you can specify a different directory by setting the TMP environment variable. See TMP and TMPDIR for details.

Yes

Swap Space

1.5 GB or greater of available swap space

To determine the amount of available swap space, use the swap command:

prompt> /usr/sbin/swap -l

The value in the "free" column indicates the number of free blocks, where a block is 512 bytes. To convert blocks to KB, divide the number by 2. For example, 2,000,000 free blocks is equivalent to 1,000,000 KB.

If you do not have enough swap space, perform the following tasks:

  1. Log in as the root user, and create an empty swap file:

    prompt> su
    Password: root_user_password
    # mkfile sizem swap_file_name
    
    

    Append an "m" to the size to specify the size in megabytes (example: 900m). The minimum size of this file must be greater than the difference between the currently available swap space and required swap space. For example, if you have 100 MB of free swap space, then this swap file must be at least 1400 MB.

  2. Add the file to the swap space using the following command:

    # /usr/sbin/swap -a swap_file_name
    
    
  3. Add a line to /etc/vfstab file. If you do not add the line, the new swap space will not persist when you restart the computer.

    /path/to/swap/file   -   -   swap   -   no   -
    
    

    Replace /path/to/swap/file with the location of the swap file.

  4. Verify the new swap space size:

    prompt> /usr/sbin/swap -l
    

Yes

Monitor

256 color display

To determine your monitor's display capabilities:

  1. Check that the DISPLAY environment variable is set properly. See DISPLAY for details. To test, see if you are able to run /usr/openwin/bin/xclock.

  2. Run the xwininfo command.

    prompt> /usr/openwin/bin/xwininfo
    
    

    Look for the "Depth" line. You need a depth of at least 8 (bits per pixel).

Yes

Supported Browsers

Oracle Content DB is supported on the following browsers:

  • Microsoft Internet Explorer 6.0 with SP2 or later (supported on Microsoft Windows only)

  • Netscape 7.2

  • Mozilla 1.7. You can download Mozilla from http://www.mozilla.org.

  • Firefox 1.0.4. You can download Firefox from http://www.mozilla.org.

  • Safari 1.2,2.0 (on Apple Macintosh computers)

For the most current list of supported browsers, check the OracleMetaLink site (http://metalink.oracle.com).

No


4.1.1 Running Multiple Instances of Oracle Content DB on One Computer

If you are running multiple instances of Oracle Content DB on one computer, each corresponding instance of Application Server Control can consume significant memory. To free up memory, configure a single instance of Application Server Control to manage multiple instances of Oracle Content DB.

4.2 Oracle Content DB Software Requirements

Oracle Content DB depends upon Oracle Identity Management (part of OracleAS Infrastructure) and Oracle Database 10g. The Oracle Database must be registered with Oracle Internet Directory.

Oracle Universal Installer checks that your computer includes any required operating system patches. If Oracle Universal Installer determines that some required patches are missing, it displays an error.

The Oracle Content DB middle tier runs in Oracle Application Server 10g Release 2 (10.1.2.0.2). For information about software requirements for Solaris operating system (x86) and Solaris operating system (x86-64), refer to Section F, "Software Requirements".

4.3 Kernel Parameters

The computers on which you plan to install Oracle Content DB require their kernel parameters to be set to the minimum values shown in Table 4-2.

Kernel parameter values are stored in the /etc/system file. If your /etc/system file does not specify the parameters, you have to add lines to the file to specify them. In Solaris 10, all System V interprocess communication (IPC) facilities are either automatically configured or controlled by resource controls. For more information on this, refer to "Resource Controls in Solaris 10".

Table 4-2 Kernel Parameters Required by Oracle Content DB

Parameter Line in /etc/system Showing the Minimum Value Description

rlim_fd_max

set rlim_fd_max=65536

Defines the hard limit on file descriptors that a single process can have open.

semmni

set semsys:seminfo_semmni=100

Defines the maximum number of semaphore sets in the entire system.

semmns

set semsys:seminfo_semmns=1024

Defines the maximum semaphores on the system. The 1024 is only a minimum value for computers that will be running a single database (the OracleAS Metadata Repository that you are installing).

If you are already running a database on the computer, see To determine the minimum value for the semmns parameter.

semmsl

set semsys:seminfo_semmsl=256

Defines the minimum recommended value, for initial installation only.

shmmax

set shmsys:shminfo_shmmax=4294967295

Defines the maximum allowable size of one shared memory segment (4 GB = 4294967295).

shmmni

set shmsys:shminfo_shmmni=100

Defines the maximum number of shared memory segments in the entire system.


To determine the minimum value for the semmns parameter

If you are installing the Oracle Content DB on a computer that is not already running an Oracle database, set the semmns parameter to a minimum of 256.

If you are installing the Oracle Content DB on a computer that is already running an Oracle database, set the semmns parameter to the sum of the processes initialization parameter for each Oracle database (including the repository), adding the largest one twice, and then adding an additional 10 for each database.

The default value of the processes parameter for the OracleAS Metadata Repository database is 150.

Example: The computer is already running an Oracle database, and its processes parameter is set at 250. In this case, you must set the semmns parameter to at least 920:

To determine the value of the processes parameter for an Oracle database, run the following command in SQL*Plus:

prompt> sqlplus "sys/password as sysdba"
SQL> show parameters processes

password specifies the password for the SYS user.

To add or update kernel parameter values:

  1. Become root user on the computer where you need to change the values.

  2. Make a backup copy of the /etc/system file. For example, the following command makes a backup copy called system.back.

    # cp /etc/system /etc/system.back
    
    
  3. Using a text editor such as vi or emacs, update the values or add new lines in the /etc/system file as necessary. For example, the following lines show sample values for the parameters:

    set semsys:seminfo_semmni=300
    set semsys:seminfo_semmns=1024
    set semsys:seminfo_semmsl=256
    set shmsys:shminfo_shmmax=4294967295
    set shmsys:shminfo_shmmin=1
    set shmsys:shminfo_shmmni=512
    set shmsys:shminfo_shmseg=150
    
    

    Tip:

    The comment character for the /etc/system file is the asterisk (*), not #.

  4. Restart the computer for the new values to take effect.

4.4 Resource Controls in Solaris 10

In Solaris 10, all System V interprocess communication (IPC) facilities are configured automatically or handled by resource controls. Many applications that previously required system tuning may now run automatically because of increased defaults and the automatic allocation of resources. This is due to the reason that the default values for Solaris 10 are higher than those recommended by Oracle. The Solaris 9 default value recommendations by Oracle apply to the corresponding Solaris 10 Resource Control as shown in Table 4-3:

Table 4-3 Solaris 9 Kernel with Corresponding Solaris 10 Resource Control and Default Value

Solaris 9 Kernel Solaris 10 Resource Control Applicable Default Value (for Solaris 9)

seminfo_semmni

project.max-sem-ids

100

seminfo_semmsl

process.max-sem-nsems

256

shminfo_shmmax

project.max-shm-memory

4294967295

shminfo_shmmni

project.max-shm-ids

100


Configuring Resource Controls

Perform the following steps to view the current value specified for resource controls, and to change the value if necessary:

  1. To view the current values of the resource control, enter the following commands:

    # id -p
    project id uid=0(root) gid=0(root) projid=1 (user.root)
    
    

    The id -p command will verify the project id.

    # prctl -n project.max-shm-memory -i project user.root
    # prctl -n project.max-sem-ids -i project user.root
    
    
  2. To modify the existing resource control values, enter the following commands:

    1. To modify the value of max-shm-memory to 6 GB:

      # prctl -n project.max-shm-memory -v 6gb -r -i project user.root
      
      
    2. To modify the value of max-sem-ids to 256:

      # prctl -n project.max-sem-ids -v 256 -r -i project user.root
      
      
  3. The changes made by the prctl command are temporary and lost on reboot.

    1. To permanently change the resource control values, enter the projmod command as follows:

      # projmod -s -K "project.max-sem-ids=(privileged,256,deny)" user.root
      # projmod -s -K "project.max-shm-memory=(privileged,6GB,deny)" user.root
      
      
    2. Reboot the system for values to take effect

For more information on Solaris 10 tuning, refer to:

http://docs.sun.com/app/docs/doc/817-0404/6mg74vs8v?a=view

4.5 Ports Used by Oracle Content DB

Oracle Content DB and components of Oracle Application Server (such as Oracle HTTP Server, Oracle Application Server Web Cache, and Oracle Enterprise Manager 10g) use ports. Oracle Universal Installer assigns default port numbers or you can specify port numbers, including the port numbers under 1024.


See Also:

Appendix D, "Default Port Numbers for Oracle Content DB" for a complete list of default port numbers

This section includes the following topics:

Why the Default Port for Oracle HTTP Server Is Port 7777 and Not Port 80

By default, Oracle Universal Installer configures Oracle HTTP Server to use port 7777, not port 80. Port 7777 is the default port because on UNIX, components that use port numbers lower than 1024 require additional steps to be done as the root user before the components can run. Because Oracle Universal Installer does not have root access, it must use a port greater than 1024.

If you want Oracle HTTP Server to use a different port, such as port 80, use the "static ports" feature, which enables you to specify port numbers for components. Although you can change the port number after installation, it is easier to set the port number during installation.

4.5.1 Checking If a Port Is in Use

To check if a port is being used, enter the netstat command to show the used port as follows:

$ netstat -an | grep port_number

Replace port_number with the port number you want to check.

4.5.2 Using Default Port Numbers

To use the default port numbers for Oracle Application Server components, such as Oracle HTTP Server, Oracle Application Server Web Cache, and Oracle Enterprise Manager 10g, you do not have to do anything.


Notes:

  • Oracle Universal Installer assigns the default ports only if the ports are not in use by other applications. If a default port is in use, Oracle Universal Installer tries other ports in the port number range for the component. For example, the default, non-SSL port for Oracle HTTP Server is port 7777. If this port is in use by another application, Oracle Universal Installer assigns a port in the 7777 - 7877 range.

  • If you plan to install multiple instances of Oracle products on the same computer, only the first instance that you install on the computer will use the default ports. When you install additional instances, Oracle Universal Installer will detect that the default ports are already in use by the first instance, and it will assign other ports to the additional instances.



See Also:

you can also refer to the Oracle Application Server Installation Guide for more information about ports and port numbers.

4.6 Operating System Groups

Create operating system groups in the following situations:


See Also:

Your operating system documentation or contact your system administrator for more information about creating operating system groups..


See Also:

you can also refer to the Oracle Application Server Installation Guide for more information about creating operating system groups.

4.7 Operating System Users

Create an operating system user to install and upgrade Oracle products. This guide refers to this user as the oracle user. The oracle user running Oracle Universal Installer must have write permission for the following directories:

If the computer contains other Oracle products, you might already have a user for this purpose. Look in the /var/opt/oracle/oraInst.loc file. This file lists the location of the inventory directory and the group who owns it. If the file does not exist, the computer does not have any Oracle products installed.

If you do not already have a user for installing Oracle products, create a user with the properties listed in Table 4-4.

Table 4-4 Properties of the Operating System User Who Runs Oracle Universal Installer

Property Description

Login name

You can use any name for the user. This guide refers to the user as the oracle user.

Group identifier

The primary group of the oracle user must have write permission for the directory.

You can use any name for the group. This guide uses the name oinstall.

Home directory

The home directory for the oracle user can be consistent with the home directories of other users.

Login shell

The default login shell can be the C, Bourne, or Korn shell.



Note:

Use the oracle user only for installing and running Oracle products. Do not use root as the oracle user.


See Also:

Your operating system documentation or contact your system administrator for more information about creating operating system users.


See Also:

you can also refer to the Oracle Application Server Installation Guide for more information about creating operating system users.

4.8 Environment Variables

The operating system user who installs Oracle Content DB must set or unset certain environment variables.

When working with environment variables, here are some things to remember:

This section discusses the following environment variables and whether they must be set or unset:

4.8.1 ORACLE_HOME, and ORACLE_SID

ORACLE_HOME, and ORACLE_SID must not be set.

4.8.2 PATH, CLASSPATH, and Shared Library Path Environment Variables

Edit your PATH, CLASSPATH, and shared library path environment variables so that they do not reference any Oracle home directories.

4.8.3 DISPLAY

Set the DISPLAY environment variable to point to the X server that will display Oracle Universal Installer. The format of the DISPLAY environment variable is:

host_name:display_number.screen_number

Example (C shell):

prompt> setenv DISPLAY test.domain.com:0.0

Example (Bourne or Korn shell):

prompt> DISPLAY=test.domain.com:0.0; export DISPLAY

You can test the display by running the xclock program. Make sure you have run the xhost + command first. Then, to test the display, run the xclock & command. For example:

$ /usr/openwin/bin/xclock &

Note:

The location of the xclock and xhost commands may vary, depending on your operating system. Consult your operating system documentation for more information.

Oracle Content DB requires a running X server during installation, only. The frame buffer X server installed with your operating system requires that you remain logged in and have the frame buffer running during installation. If you do not want to do this, then you must use a virtual frame buffer, such as X Virtual Frame Buffer (XVFB) or Virtual Network Computing (VNC).


See Also:

Oracle Technology Network for more information about obtaining and installing XVFB or other virtual frame buffer solutions, at

http://www.oracle.com/technology/index.html


4.8.4 TNS_ADMIN

This section describes the following two requirements:

  • The TNS_ADMIN environment variable must not be set

  • The /etc and the /var/opt/oracle directories must not contain a tnsnames.ora file

These requirements are necessary to prevent conflicts between the Oracle Net Services configuration files for different Oracle products.

To set TNS_ADMIN or if you have the tnsnames.ora file in /etc or /var/opt/oracle, perform the following steps before installing Oracle Content DB.

  1. If the tnsnames.ora file is in the /etc or /var/opt/oracle directory, move the file to a different directory or you can rename the file.

  2. Ensure the TNS_ADMIN environment variable is not set.

    Example (C shell):

    prompt> unsetenv TNS_ADMIN
    
    

    Example (Bourne or Korn shell):

    prompt> unset TNS_ADMIN
    
    

After installation, you can merge the contents of the newly created tnsnames.ora file with your existing tnsnames.ora file.

4.8.5 TMP and TMPDIR

The installer uses a temporary directory for swap space. The installer checks for the TMP and TMPDIR environment variables to locate the temporary directory. If this environment variable does not exist, the installer uses the /tmp directory.

If you want the installer to use a temporary directory other than /tmp, set the TMP and TMPDIR environment variables to the full path of an alternate directory. The oracle user must have right permission for this directory and the directory must meet the requirements listed in Table 4-1.

Example (C shell):

% setenv TMP /tmp2
% setenv TMPDIR /tmp2

Example (Bourne or Korn shell):

$ TMP=/tmp2; export TMP
$ TMPDIR=/tmp2; export TMPDIR

If you do not set this environment variable, and the default directory does not have enough space, then the installer displays an error message that says the environment variable is not set. You can either set the environment variable to point to a different directory or free up enough space in the default directory. In either case, you have to restart the installation.

4.8.6 The /etc/hosts File

The contents of the /etc/hosts file affect both the location of the default identity management realm and the host name for Oracle Application Server Single Sign-On.

Oracle Universal Installer provides alternative methods for you to enter the values that you want without editing the hosts file, as explained in the following sections:

4.8.6.1 Location of the Default Identity Management Realm

Oracle Universal Installer reads the hosts file to construct the location of the default identity management realm. It displays this location in the Specify Namespace in Internet Directory screen.

The hosts file uses the following format:

ip_address   fully_qualified_host_name   short_host_name

For example:

123.45.67.89   primaryHost.domain.com   primaryHost

In the preceding example, the location of the default identity management realm would display as "dc=domain,dc=com".

If the file uses a different format, Oracle Universal Installer displays an incorrect value in the screen.

123.45.67.89   primaryHost   primaryHost.domain.com  <--- incorrect format

In this case, Oracle Universal Installer displays "dc=primaryHost,dc=com" as the default identity management realm. Most likely, this is not the value that you want for the default identity management realm.


Note:

If you require that the hosts file use a different format, you can edit the file to use the required format, perform the installation, then revert the file back to its original format after installation.

If you are unable, or unwilling, to edit the hosts file, you can enter the desired value for the default identity management realm in the Custom Namespace field on the Specify Namespace in Internet Directory screen.


4.8.6.2 Host Name for Oracle Application Server Single Sign-On

If you are installing Oracle Application Server Single Sign-On (OracleAS Single Sign-On) and your hosts file contains only the host name of your computer (without the domain name), you will only be able to sign on to the OracleAS Single Sign-On server using the host name by itself (without the domain name).

To require a domain name when connecting to the OracleAS Single Sign-On server, you can edit the hosts file to include the domain name. If you do not want to edit the file, you can use the OUI_HOSTNAME command-line parameter to Oracle Universal Installer to override the value in the hosts file, as in the following example:

prompt> mount_point/runInstaller OUI_HOSTNAME=myserver.domain.com

4.9 Network Topics

Typically, the computer on which you want to install Oracle Content DB is connected to a network, has local storage to contain the Oracle Content DB installation, has a display monitor, and has an appropriate disk drive.

This section describes how to install Oracle Content DB on computers that do not meet the typical requirements and includes the following topics:

4.9.1 Installing Oracle Content DB on Computers with Multiple Network Cards

If you are installing Oracle Content DB on a computer with multiple network cards, Oracle Universal Installer uses the first names in the /etc/hosts file to determine the host name to use for IP address lookup.

If this is not the name you want to use, you can:

  • Start up Oracle Universal Installer with the OUI_HOSTNAME parameter, if you do not want to edit the /etc/hosts file. Specify the host name that you want to use in this parameter, as in the following example:

    $ mount_point/runInstaller OUI_HOSTNAME=myserver.domain.com
    

4.9.2 Copying the DVD to a Hard Drive and Installing from the Hard Drive

Instead of installing from the Oracle Content DB DVD, you can copy the contents of the DVD to a hard drive and install the product from there. This provides for an easier solution if you plan to install many instances of Oracle Content DB on your network, or if the computers where you want to install Oracle Content DB do not have DVD-ROM drives.

You can also install Oracle Content DB from remote DVD-ROM drives.


See Also:

"Installing from a Remote DVD-ROM Drive" for more information

Checking the Space Requirement

Ensure that the hard drive contains enough space to hold the contents of the Oracle Content DB DVD.

4.9.3 Installing from a Remote DVD-ROM Drive

If the computer where you want to install Oracle Content DB does not have a DVD-ROM drive, you can perform the installation from a remote DVD-ROM drive. Check that you have performed these steps:

  • You need to share the remote DVD-ROM drive through NFS.

    On the remote computer, which has the DVD-ROM drive:

    1. Insert the Oracle Application Server DVD-ROM into the DVD-ROM drive.

    2. Share the DVD-ROM drive.

      prompt> su
      Password: root_password
      # share -F nfs -o ro /dvdrom
      
      

      The path /dvdrom specifies the path to the DVD-ROM in the DVD-ROM drive. You can use any path you like.

    On the local computer, access the DVD-ROM and run the installer as follows:

    prompt> /net/remote_computer_hostname/dvdrom/runInstaller
    
    

    Replace remote_computer_hostname with the name of the remote computer.

You can run the installer on a remote computer ("remote_computer"), but have the installer screens display on your local computer ("local_computer"). The installer will install Oracle Content DB on the remote computer.

  1. Allow remote_computer to display on local_computer. You need to run this command on the local computer's console.

    local_computer> xhost +remote_computer
    
    

    If you do not run xhost, you might get an Xlib error similar to "Failed to connect to server", "Connection refused by server," or "Can't open display" when starting the installer.

  2. On local_computer, perform a remote login (using telnet or rlogin) to remote_computer. Log in as the oracle user, as described in "Operating System Users". Ensure that the user has set the environment variables correctly, as described in "Environment Variables".

    local_computer> rlogin -l oracle remote_computer.mydomain.com
    - OR -
    local_computer> telnet remote_computer.mydomain.com
    
    
  3. Set the DISPLAY environment variable on remote_computer to point to local_computer.

    Example (C shell):

    remote_computer> setenv DISPLAY local_computer.mydomain.com:0.0
    
    

    Example (Bourne or Korn shell):

    remote_computer> DISPLAY=local_computer.mydomain.com:0.0; export DISPLAY
    
    
  4. Run the installer. Refer to Starting Oracle Universal Installer.


Note:

You can use a PC X emulator to run the installer if it supports a PseudoColor color model or PseudoColor visual. Set the PC X emulator to use a PseudoColor visual, and then start the installer. Refer to the X emulator documentation for instructions on how to change the color model or visual settings.

4.9.4 Installing Oracle Content DB on a Remote Computer

You can run Oracle Universal Installer on a remote computer (remote_computer), but display the Oracle Universal Installer screens on your local computer (local_computer). Oracle Universal Installer will install Oracle Content DB on the remote computer.

  1. Allow remote_computer to appear on local_computer. Use the following command on the console of the local computer:

    local_computer> xhost +remote_computer
    
    

    If you do not run xhost, you might get an Xlib error similar to "Failed to connect to server", "Connection refused by server," or "Can't open display" when starting Oracle Universal Installer.

  2. On local_computer, perform a remote login as the oracle user (using ssh, telnet, or rlogin) to remote_computer, as follows:


    See Also:


    local_computer> ssh -X -l oracle remote_computer.domain.com
    

    Note:

    Use of ssh is recommended over rlogin or telnet because it is more secure than either. However, if you do not have ssh available, use rlogin or telnet.

    The ssh server must be configured to allow forwarding X11 connections.


    Alternatively, use one of the following commands:

    local_computer> rlogin -l oracle remote_computer.domain.com
    local_computer> telnet remote_computer.domain.com
    
    
  3. This step is not required if you are using the ssh connection.

    Set the DISPLAY environment variable on remote_computer to point to local_computer.

    Example (C shell):

    remote_computer> setenv DISPLAY local_computer.domain.com:0.0
    
    

    Example (Bourne or Korn shell):

    remote_computer> DISPLAY=local_computer.domain.com:0.0; export DISPLAY
    
    
  4. Run Oracle Universal Installer, as described in Chapter 5, "Installing the Oracle Content DB Middle Tier".


    Note:

    You can use a PC X emulator to run Oracle Universal Installer if it supports a PseudoColor color model or PseudoColor visual. Set the PC X emulator to use a PseudoColor visual, and then start Oracle Universal Installer. Refer to the X emulator documentation for instructions on how to change the color model or visual settings.

4.9.5 Installing Oracle Content DB on NFS-Mounted Storage

Currently, Oracle Content DB is certified to run only on the Network Appliance filers Network File Storage (NFS)-mounted storage system.

The NFS-mounted system should be exported to at least the remote install user and remote root user. You can do this using exportfs command, as follows:

prompt> exportfs -i /vol/vol1

To check the latest certification list for any updates, visit Oracle Technology Network.

4.9.6 Support for NIS and NIS+

You can install and run Oracle Content DB in Network Information System (NIS) and NIS+ environments.

4.10 Prerequisite Checks Performed by Oracle Universal Installer

Table 4-5 lists prerequisite checks performed by Oracle Universal Installer.

Table 4-5 Prerequisite Checks Performed by Oracle Universal Installer

Item Description

Operating system version

See Oracle Content DB Software Requirements for supported versions

Operating system patches

Oracle Universal Installer checks that your computer includes any required operating system patches. If Oracle Universal Installer determines that some required patches are missing, it displays an error. See Appendix F, "Operating System Patches and Packages" for additional information

Operating system packages

See Appendix F, "Operating System Patches and Packages" for additional information.

Monitor

See Oracle Content DB Hardware Requirements for monitor requirements

Instance name

The installer checks that the computer on which you are installing Oracle Application Server does not already have an instance of the same name.

Display permission

Oracle Universal Installer checks that the user has permissions to display on the monitor specified by the DISPLAY environment variable.

Memory

See Oracle Content DB Hardware Requirements for memory requirements

Swap space

See Oracle Content DB Hardware Requirements for swap space requirements

TMP space

See Oracle Content DB Hardware Requirements for /tmp directory space requirements

Oracle home directory name

Oracle Universal Installer checks that the Oracle home directory name does not contain any spaces.

Path to the Oracle home directory

Oracle Universal Installer checks that the path to the Oracle home directory is not longer than 127 characters.

Oracle home directory contents

Oracle Universal Installer checks that the Oracle home directory does not contain any files that might interfere with the installation.

Oracle home directory

Always install Oracle Content DB in a new directory. Do not install Oracle Content DB in an existing Oracle home directory. For example, do not install Oracle Content DB into in an existing Oracle Application Server.

DISPLAY environment variable

The installer checks that the DISPLAY environment variable is set.

TNS_ADMIN environment variable

The TNS_ADMIN environment variable must not be set.

There must not be a tnsnames.ora file in the /etc or /var/opt/oracle directories.

Cluster file system

Oracle Universal Installer checks that you are not installing Oracle Content DB in a cluster file system (CFS).

Oracle Enterprise Manager 10g directories are writable

The installer runs this check only if you are expanding a middle tier or if you are reinstalling Oracle Content DB in the same Oracle home. The installer checks that these directories are writable by the operating system user running the installer:

  • ORACLE_HOME/sysman/emd

  • ORACLE_HOME/sysman/config

  • ORACLE_HOME/sysman/webapps/emd/WEB-INF/config

Oracle Enterprise Manager 10g files exist

The installer runs this check only if you are expanding a middle tier or if you are reinstalling Oracle Content DB in the same Oracle home. The installer checks that these files exist:

  • ORACLE_HOME/sysman/config/iasadmin.properties

  • ORACLE_HOME/sysman/webapps/emd/WEB-INF/config/consoleConfig.xml

Database Initialization Parameters

Oracle Universal Installer checks to make sure that the database you want to use with Oracle Content DB has the required minimum values. See Setting Required Database Initialization Parameters for additional information.

Database Character Set

Oracle Universal Installer checks to make sure that the database character set is AL32UTF8. See Setting the Required Database Character Set for additional information.


4.11 Running Prerequisite Checks from the Command Line

You can run the prerequisite checks without having to install Oracle Content DB by using the following single command:

./runInstaller -prereqChecker PREREQ_CONFIG_LOCATION=DVD_MountPoint/stage/prereq -entryPoint oracle.contentdb.top_Core