Oracle Unified Directory 11gR2 ( Installation Cheat-sheet

This is a cheat-sheet for installing Oracle Unified Directory (OUD) including the graphical administration tool (Oracle Directory Services Manager – ODSM). While the core of OUD does not require an application server such as WebLogic, ODSM does, so you need to install that too (unless you want to do all administration from the command line). All of this information can be found in the documentation and the Oracle Technology Network (OTN) website – all I’m doing here is drawing all the bits together in one place. I tested the below steps on Linux, but the steps for other supported platforms will be similar. These steps are for a single node install (such as a development environment).

Step 1: Download JDK, WebLogic, ADF and OUD

OUD is written in Java, so it requires the JDK. OUD itself does not use WebLogic or ADF, but ODSM does. So we need to download all these bits:

Step 2: Install JDK

Extract jdk-7u67-linux-x64.tar.gz to a directory on your filesystem. There is no installer to be used for this product, just extract the archive into the desired install location. I’m going to extract it under /app/oud, so I’ll end up with my JDK under /app/oud/jdk1.7.0_67. Make sure the newly installed JDK comes first in your PATH, e.g:

export JAVA_HOME=/app/oud/jdk1.7.0_67
export PATH=$JAVA_HOME/bin:$PATH

We’ll assume the above environment variables are set for the remainder of these steps.

Step 3: Install OUD

Unzip into a temporary directory.

cd into Disk1, and then run: ./runInstaller -jreLoc $JAVA_HOME

You need to choose some install directory – I’ll once more use /app/oud. Then the OUD software is installed into /app/oud/Oracle_OUD1.

Step 4: Configure OUD

Go to the OUD install directory, e.g. /app/oud/Oracle_OUD1. Run the oud-setup script. The setup process will create a new OUD instance and start it for you.

Step 5: Install WLS

Run: java -jar wls_generic1036.jar

Do a “Typical” install. The screens are largely self-explanatory. Important: you must select the OUD install location as the Middleware Home – this is the parent of the Oracle_OUD1 directory. So in my case, the directory is /app/oud. If you install WLS somewhere else, you won’t be able to install ODSM. You will get a warning that the directory is not empty – ignore it.

Step 6: Install ADF Runtime

Unzip into a temporary directory.

cd into Disk1, and then run: ./runInstaller -jreLoc $JAVA_HOME

Choose the same Middleware Home as in the previous step.

Step 7: Create WebLogic domain

Go to the Middleware Home, then wlserver_10.3/common/bin, and run

Choose to create a new domain. Make sure to tick “Oracle Directory Services Manager” on the “Select Domain Source” screen.

Step 8: Start Admin Server

Go to the just created WLS domain directory, e.g. /app/oud/user_projects/domains/base_domain, and then into the bin subdirectory. Run to start your admin server

Step 9: Connect to ODSM

Now you can login to ODSM. Go to http://HOSTNAME:PORT/odsm, where HOSTNAME is your hostname and PORT is your Admin Server port. Login with the OUD credentials you configured in step 4.


  1. Hello Simon,

    I have a question relating to integrating OUD and Active Directory 2008R2.

    The AD team in my environment is concerned about permitting OUD access to the AD, and have requested for an alternative as to using DIP to synchronize.

    Alternatively, I was considering using OUD’s proxy; however, I’m not very clear about how this works especially regarding the passwords.

    Can you please explain the configuration process of OUD proxy to AD? How would the users authenticate to various application with OUD proxy as the identity store in OAM?


Add Your Comment