Oracle Unified Directory (OUD) is a required directory component in the EBS SSO infrastructure. The main reason is that E-Business Suite has hardcoded dependencies on Oracle Directory for this configuration. These dependencies mean that you cannot replace Oracle Unified Directory with any third-party LDAP directory for this particular configuration. Oracle Internet Directory (OID) is a supported LDAP server for the EBS SSO as well.

In addition, all EBS internally-managed users must posses a Global Unique Identifier (GUID), and these GUIDs are generated exclusively by Oracle Unified Directory.

In this article, we will show how to install OUD and the management application called Oracle Directory Server Manager (ODSM).

OUD Installation

The OUD installation consists of 3 main processes.

  1. Prepare the server environment

  2. Install the product

  3. Validate the environment

Prepare the Server Environment

Here are the OUD version and Server requirement for this installation:

Server OS: Oracle Linux 6.8 UEK4

Server Memory: 4G

Server DiskSpace: 60G

Server CPU Core: 4

WLS Version: 10.3.6

OUD Version:

ADF Version:

Ensure that all prerequisites are met (swap space, disk space, temp space, monitor/X server, kernel parameter, o.s. user/group creation).

  1. Make sure you update /etc/yum.repos.d to change the repo URL to use the public Oracle yum repo for "Latest"/"Addons"/"UEK_latest" 3 section.

  2. Run yum update.

  3. Run yum install oracle-ebs-server-R12-preinstall (EBS contains almost of all the required paches that any Oracle product requires).

  4. Run yum install xterm.

Make sure you have already installed a WebLogic Server 10.3.6, which will host the OUD and ODSM Service.

Install the OUD

  1. Install an Oracle WebLogic Server 10.3.6 if it hasn’t already been installed. It will be used to host the Oracle Directory Server Manager (ODSM).

  2. Set environment var $JAVA_HOME.

  3. Run the OUD installer below:

    ssh oracle@oud1
    export JAVA_HOME=/u01/oracle/java-jdk1.7
    ./runInstaller -jreLoc $JAVA_HOME
  4. Skip the software update, and make sure the prerequisite checks are all good.

    Oracle OUD Installation

  5. Select the OUD base location. Oracle WLS 10.3.6 must be installed prior to the installation of OUD.

    Oracle OUD Installation

  6. Click Install to start the installation.

    Oracle OUD Installation

  7. Click Next and then Finish to complete the installation of OUD.

    Oracle OUD Installation

Install the Application Developer Framework

Before we install the ODSM web application, we must first install the Oracle Application Developer Framework (ADF).

  1. Run the ADF installer below:

    export JAVA_HOME=/u01/oracle/java-jdk1.7
    /runInstaller -jreLoc $JAVA_HOME
  2. Make sure the prerequisite checks are all successful.

  3. Make sure the Oracle Middleware Home is the same middleware home as the OUD server installed earlier.

  4. Click Next.

    Oracle OUD Installation

  5. Select Weblogic Server as the App Server, and click Next.

    Oracle OUD Installation

  6. Verify the installation settings, and click Install to install the ADF framework.

    Oracle OUD Installation

Configure ODSM WLS Domain

  1. Navigate to the WLS common/bin directory.

    cd WLS-MIDDLEWARE-HOME/oracle_common/common/bin
    ./ (configure the WLS with a new Domain for the ODSM)
  2. Select Create a new WebLogic Domain.

    Oracle OUD Installation

  3. Select the Oracle Directory Services Manager and Oracle JRF options.

    Oracle OUD Installation

  4. Create a new domain called odsm_domain.

    Oracle OUD Installation

  5. Enter weblogic and Password1 in the Name and password fields (standard username and password).

    Oracle OUD Installation

  6. Select the proper JDK; take default shown.

  7. Click Next on the Optional Configuration Screen. (By not selecting a new server, we are installing the ODSM on the Admin server itself in this scenario).

    Oracle OUD Installation

  8. Verify the settings and click Create (Notice where the ODSM domain is located).

    Oracle OUD Installation

  9. Complete the configuration of the new domain.

Create the OUD instance server

  1. Create a password file for OUD.

    cd /u01/app
    vi oud_pwd and enter “Password1”. Save the file. (We will reference this password file later in the installation and configuration of OUD).
  2. Navigate to the OUD instance directory.

    cd /u01/app/oracle/Middleware/Oracle_OUD1
    ./oud-setup –cli –hostName –ldapPort 1389 –ldapsPort 1636 –adminConnectorPort 4444 –rootUserDN “cn=oud-orcl” –rootUserPasswordFile /u01/app/oud_pwd –generateSelfSignedCertificate –enableStartTLS –baseDN dc=okta,dc=info –integration generic –sampleData 30 –no-prompt
    The OUD ldap port: 1389
    The OUD ldaps port: 1636
    The OUD admin port: 4444
    The OUD root admin user id: oud-orcl
    Note: This instance of OUD is ssl enabled
  3. Patch OUD with the latest Oracle Bundle Patch: See See Doc

    Download OUD bundle patch.
    cd /u01/app/oracle/Middleware/oracle_common/OPatch
    export ORACLE_HOME=/u01/app/oracle/Middleware/Oracle_OUD1/
    ./opatch lsinventory - this is the check the current patch level
    cd /download/OUD-BundlePatch-DIR
    /u01/app/oracle/Middleware/oracle_common/OPatch/opatch apply
  4. Shut down the OUD Server.

    Make sure to clear the OUD lock file before the restart. cd /u01/app/oracle/Middleware/asinst_1/OUD/locks

    mv server.lock serverbadlock
    ps -ef|grep OUD and kill –9 the OUD process.
  5. Start the OUD Server.

    cd /u01/app/oracle/Middleware/asinst_1/OUD/bin
    ./start-ds  ## to start the directory server.

Validate the Environment (OUD / ODSM)

  1. Check OUD status.

  2. Access the ODSM WLS console ( and the ODSM GUI ( to validate the environment.

    Oracle OUD Installation