1 Before You Install Oracle Unified Directory

This section includes information that you should review before installing Oracle Unified Directory. It covers the following topics:

1.1 System Requirements and Certification

Before performing any installation, you should read the system requirements and certification documents to ensure that your environment meets the minimum installation requirements for the products you are installing. Both of these documents are available on Oracle Technology Network (OTN):

1.1.1 Pre-Installation System Notes

On Windows systems you cannot install the Oracle Unified Directory software if you do not have administrator privileges.

Before running the installer, set the DISPLAY environment variable on your system.

On UNIX systems, installation as the root user is unsupported.

The Oracle Unified Directory software treats global, full local, and sparse zones as an independent physical system. Installing Oracle Unified Directory in any type of Solaris zone is therefore like installing on an independent system. Oracle Unified Directory does not share services or file locations with other zones.

1.2 Selecting a Server Role

Oracle Unified Directory can function in one of three modes:

  • As an LDAP directory server, used to contain data.

  • As an LDAP proxy server, where the server acts as an interface between the client and the directory server that contains the data.

  • As a replication gateway between Oracle Unified Directory and Oracle Directory Server Enterprise Edition.

The following sections describe which Oracle Unified Directory installation mode you should use, based on your requirements.

As a general rule, the use of the generic term server applies to the directory server, the proxy server, and the replication gateway.

1.2.1 About the Directory Server

Install the Oracle Unified Directory directory server if you want to create an LDAP directory server that contains directory data. For more information, see Chapter 3, "Setting Up the Directory Server".

1.2.2 About the Proxy Server

When you install Oracle Unified Directory as an LDAP proxy server, the server acts as an interface between the client and the remote LDAP server containing the data. The proxy server manages the client requests through load balancing and/or data distribution. The proxy does not contain any data. The proxy can also manipulate the data sent by the client or received from the remote LDAP servers (For example: DN renaming, RDN changing, transformation, or Enterprise User Security).

To install the Oracle Unified Directory in proxy mode, see the procedure in Chapter 4, "Setting Up the Proxy Server".

When you use the Oracle Unified Directory proxy, your data is stored in one or more remote LDAP servers or data centers, which can be any LDAPv3-compliant directory server, such as the Oracle Unified Directory directory server or Oracle Directory Server Enterprise Edition.

1.2.3 About the Replication Gateway

When you install Oracle Unified Directory as a replication gateway, the server acts as a gateway that allows you to replicate between Oracle Directory Server Enterprise Edition and Oracle Unified Directory. For more information, see Chapter 5, "Setting Up the Replication Gateway".

1.3 Setting the Java Environment Variable

You must provide Oracle Unified Directory with information about the location of the Java installation that should be used by setting the JAVA_HOME environment variable. The setup will not work if the JAVA_HOME environment variable is not set, or does not point to the root of a valid (at least Java 1.6) installation.


If you are using IBM WebSphere Application Server and want to use the JVM shipped with IBM WebSphere then you must verify that the JVM is certified with Oracle Unified Directory. For more information, see Section 1.1, "System Requirements and Certification".

For example:

On UNIX Systems, run a command similar to the following, depending on your shell:

$ export JAVA_HOME=/usr/lang/JAVA/jre1.6

On Windows Systems:

  1. Right click on the Computer icon on your Desktop and select Properties.

  2. In the System window select Advanced system settings in the left pane.

  3. In the System Properties window select the Advanced tab and click Environment Variables.

  4. In the Environment Variables window, click New under the User variables pane.

  5. In the New User Variable window, enter the following information:

    • Variable name: Enter JAVA_HOME

    • Variable value: Enter the path to a valid Java installation (at least Java 6. For example, C:\Progra~1\Java\jre1.6.0_20

  6. Click OK.


You can also set the JAVA_HOME by running a command similar to the following:
set JAVA_HOME=C:\Progra~1\Java\jre1.6.0_20

1.4 Understanding the Installation Directories

During the software installation, you are asked to specify several installation directories. It is helpful to have an understanding of those directories and what they contain when installation is complete. The following directories are created:

1.4.1 Oracle Middleware Home Location

This is the directory into which Oracle Unified Directory, Oracle WebLogic Server, and Oracle Application Development Framework are installed. Oracle WebLogic Server and the Application Development Framework must be installed if you plan to manage Oracle Unified Directory by using Oracle Directory Services Manager (ODSM).

If you are using IBM WebSphere as the application server with the Application Development Framework and Oracle Directory Services Manager, specify a directory that you wish to use as the Middleware home. This directory has no relation to the location of your WebSphere installation. If you specify a directory location that does not already exist, the installer will create the directory for you.

1.4.2 Oracle Home Directory

An Oracle home contains installed files necessary to host a specific product. The Installer installs the files required to host the component, such as binaries and libraries, in the Oracle Home directory. It contains the Oracle Unified Directory setup files to set up individual instances. Also contains the default schema files for all server instances associated with that OUD_ORACLE_HOME.

An Oracle home resides within the directory structure of the Middleware home. Each Oracle home can be associated with multiple Oracle instances or Oracle WebLogic Server domains.

The default OUD_ORACLE_HOME directory is Oracle_OUD1.

1.4.3 Oracle Common Directory

The Installer creates this directory under the location you enter in the Oracle Middleware Home Location field. It contains the Application Development Framework.

The default directory is oracle_common.

1.4.4 Oracle WebLogic Domain Directory

A WebLogic domain includes a special WebLogic Server instance called the Administration Server, which is the central point from which you configure and manage all resources in the domain. Usually, you configure a domain to include additional WebLogic Server instances called Managed Servers. You deploy Java components, such as Web applications, EJBs, and Web services, and other resources to the Managed Servers and use the Administration Server for configuration and management purposes only.

The directory structure of a domain is separate from the directory structure of the WebLogic Server home. It can reside anywhere; it need not be within the Middleware home directory. A domain is a peer of an Oracle instance.

By default, the Oracle Fusion Middleware Configuration Wizard creates a domain as subdirectory in a directory named user_projects under your Middleware Home (MW_HOME).

1.4.5 IBM WebSphere Directory

When you install the IBM WebSphere software, you are prompted for the location where you want to install the software. For the purposes of this documentation, this location is later referred to as the WAS Home, or WAS_HOME in examples.

If you accept the default values that are provided during the installation, then the WAS_HOME is installed in the following directory structure:

DISK/IBM/WebSphere/Application Server

Create the WAS_HOME for the IBM WebSphere software on the same host where you plan to install the Oracle Fusion Middleware software. Make a note of this path. You will be asked to identify the location of the IBM WebSphere directory when you configure Oracle Fusion Middleware.

1.5 Directories Summary for Oracle Unified Directory

The directory structure of an Oracle Unified Directory installation on a single host, using all of the default values is as follows:




This can be any directory on your system. The directory is empty before you install the product.