You are here:>>>Oracle Unified Directory Installation And Configuration

Oracle Unified Directory Installation And Configuration

Video Tutorial

In this post I will show you how to install and configure Oracle Unified Directory

Oracle Unified Directory is an enterprise level Directory Server which provides storage, replication and proxy functionality.

It is designed to handle large deployments and provide high performance. It is also relatively easy to deploy and manage.

Types of OUD Deployments

  • OUD as a Directory Server
    • Used as storage of directory data
  • OUD as a Proxy Server
    • Used as an interface between LDAP clients and backend Directory Servers and acts as a load balancer
  • OUD as a Replication Gateway
    • Used as a replication gateway to synchronize data between Directory Servers

In this post, I will be covering the setup of OUD as a Directory Server.

My Environment & Software Used

  • Oracle Linux 6.7 64Bit Virtual Machine
  • VMware Workstation Player (to run the virtual machine)
  • Oracle Weblogic Server 10.3.6
  • Oracle Application Development Runtime
  • Oracle Unified Directory
  • Java Development Kit (JDK) 1.8

I already have my Oracle Linux 6.7 64Bit Virtual Machine already built.

Please note that Oracle Weblogic Server & Oracle Application Development Runtime are required only if you are planning to use Oracle Directory Services Manager (ODSM) to manage your OUD.

Operating System Package Requirements

  • binutils-
  • compat-libcap1-1.10-1-x86_64
  • compat-libstdc++-33-3.2.3-69.el6-x86_64
  • compat-libstdc++-33-3.2.3-69.el6-i686
  • libgcc-4.4.4-13.el6-i686
  • libgcc-4.4.4-13.el6-x86_64
  • libstdc++-4.4.4-13.el6-x86_64
  • libstdc++-4.4.4-13.el6-i686
  • libstdc++-devel-4.4.4-13.el6-x86_64
  • sysstat-9.0.4-11.el6-x86_64
  • gcc-4.4.4-13.el6-x86_64
  • gcc-c++-4.4.4-13.el6-x86_64
  • glibc-2.12-1.7.el6-i686
  • glibc-2.12-1.7.el6-x86_64
  • glibc-devel-2.12-1.7.el6-x86_64
  • libaio-0.3.107-10.el6-x86_64
  • libaio-devel-0.3.107-10.el6-x86_64

Operating System Kernel Requirements

  • Kernel version higher than 2.6.32-100.28.5.el6
  • hardnofiles should be greater than 4096
  • softnofiles should be greater than 4096

Oracle Unified Directory Installation

  • Navigate to the extracted software directory and execute runInstaller from Disk1 directory
cd software_location\Disk1
./runInstaller -jreLoc /u01/app/jdk1.8.0_73
  • Click Next on the Welcome screen


  • Skip Software Updates and click Next


  • Make sure all prerequisites are met and click Next


  • Provide Middleware Home & OUD Home
    • Middleware Home : /u01/app/oracle/product/fmw
    • OUD Home : Oracle_OUD1
  • Click Install on the summary screen
  • Installation progress screen
  • Click Next when installation progress reaches 100%
  • Click Finish on Installation Complete screen

Oracle Unified Directory Configuration

  • Navigate to OUD Home and execute OUS setup script
cd /u01/app/oracle/product/fmw/Oracle_OUD1
The default OUD instance name is asinst_1 and location is MW_HOME/asinst_1/OUD. If you want to change it please specify your instance name using INSTANCE_NAME environment variable.
  • Click Next on the Welcome screen
  • Provide below LDAP settings and click Next
    • Hostname : localhost.localdomain (FQDN of the server)
    • LDAP Listener Port : 1389
    • Administration Connector Port : 4444 (This port is used for administration traffic)
    • Root User DN : cn=Directory Manager (This is the administrator user)
    • Password : Admin Password
  • If you want to configure SSL click Configure on above screen and provide below details
    • Check Enable SSL check box and provide SSL port as 1636
    • Select Generate Self-Signed Certificate
  • Select Stand Alone server in Topology Options
    • In production environment, if you have multiple OUD servers, you can select second option and provide your existing OUD details to setup replication
  • Specify Directory Data and click Next
    • Directory Base DN : dc=prasad,dc=com (This will be the base DN for all users and groups)
    • Directory Data : You can select any option that is apt for your environment. For demo purposes I have selected last option where it creates sample data for testing purposes.
  • Select No Specific Integration on Integration screen and click Next
  • Accept default memory settings and click next. For production environments, provide sufficient RAM depending on number of entries.
  • Review Summary screen and click Finish. You can also make note of the command that will be used to configure OUD by selecting Command Line option from the drop down menu


  • Wait for the configuration process to complete and click Close

Oracle Unified Directory Verification & Management

  • Verify OUD ports using netstat command
netstat -an | grep 1389
netstat -an | grep 1636
  • Verify the status of OUD by navigating into instance bin directory and executing status command
cd /u01/app/oracle/product/fmw/asinst_1/OUD/bin
  • Start OUD by running start-ds command
cd /u01/app/oracle/product/fmw/asinst_1/OUD/bin
  • Stop OUD by running stop-ds command
cd /u01/app/oracle/product/fmw/asinst_1/OUD/bin

Oracle Weblogic Server Installation

  • Ensure JAVA home’s bin directory is added in PATH and start the Weblogic installer
java -jar wls1036_generic.jar
  • Click Next on the Welcome screen
  • Create new Middleware home and click Next. Make sure you provide the same Middleware home as OUD
  • Click Yes on the screen where it says directory not empty
  • UNcheck Security Updates and click Next. Click Yes on the confirmation screens.
  • Select Typical Installation and click Next
  • Verify JDK path and click Next
  • Click Next on the Installation Directories screen
  • Review the information on Summary screen and click Next
  • Installation Progress screen
  • Uncheck Run Quick Start and click Next

Oracle Application Development Runtime Installation

  • Extract ADF runtime ZIP file and navigate to Disk1 to execute ADF installer
./runInstaller -jreloc /u01/app/jdk1.8.0_73
  • Click Next on the Welcome screen
  • Skip Software Updates and click Next
  • Make sure all prerequisites are met and click Next
  • Provide same Middleware home as OUD & Weblogic and click Next. ADF runtime will be installed in oracle_common.
  • Installer will detect Weblogic Server automatically. Click Next
  • Verify the information on Summary screen and click Install
  • Installation Progress screen
  • Click Next when the progress reaches 100%
  • Click Finish on the Installation Complete screen

Oracle Weblogic Domain Creation for OUD / ODSM

  • Execute script from oracle_common
cd /u01/app/oracle/product/fmw/oracle_common/common/bin
  • Select “Create a new Weblogic domain” and click Next
  • Select “Oracle Directory Services Manager”. “Oracle JRF” will automatically be selected. Click Next
  • Provide name & location for the new domain and click Next
  • Provide Weblogic Administrator username & password and click Next
  • Select “Production Mode”. Verify JDK path and click Next
  • Select “Administration Server” and click Next
  • Customize Admin Server name and port if required and click Next
  • Verify the information on the Summary screen and click Next
  • Wait for the domain creation process to complete and click Done. Make a note of the admin console URL

Oracle Weblogic Domain Startup & ODSM Console Access

  • Start Weblogic Admin Server using script
cd /u01/app/oracle/product/fmw/user_projects/domains/OUDDomain
nohup ./ &
  • Wait for Admin Server to start completely. Below messages will be seen in nohup.out file under the domain directory
Server state changed to RUNNING
Server started in RUNNING mode
  • Login to Weblogic Admin Console using below URL, navigate to deployments section and make sure ODSM deployment is in active state (Click below image to enlarge)
Weblogic Administration Console
  • Access ODSM console using below URL
  • ODSM Home Page (Click below image to enlarge)
ODSM Home Page
  • Provide OUD connection details as below and click Login. Make sure you provide OUD administration port and NOT LDAP port
  • Trust the server certificate by click “Yes, trust always”
  • OUD Home Page (Click below image to enlarge)
OUD Home Page
  • OUD Data Browser with sample data (Click below image to enlarge)
OUD Data Browser

That’s it !! Your OUD environment is configured and fully functional.


About the Author:

I am a Senior Cloud Professional specialized in AWS Cloud with 11 years of IT experience. I am enthusiastic about Serverless Architecture. I am an expert in Oracle Fusion Middleware.


  1. Srikar June 10, 2016 at 3:46 AM - Reply


    Firstly thanks for the Installation Instructions.

    While trying to login from ODSM Home Page, I am facing “ADF_FACES-60097:For more information, please see the server’s error log for an entry beginning with: ADF_FACES-60096:Server Exception during PPR”.
    2 deviations from the above setup are
    1) I didn’t created sample data.
    2) I am using as my OS level is Red Hat Enterprise Linux Server release 6.4.

    All the steps are validations went fine.

    Thanks for your time,

  2. Srikar June 10, 2016 at 5:30 AM - Reply

    Issue solved I was using Java 8, which is not compatible for OUD

  3. Ameer July 2, 2016 at 7:08 PM - Reply

    Hi Prasad,

    Nice explanation..Thank you…
    I would like to know about custom attribute addition to OUD. This attribute should be available to all the users in OUD. If you have any simple steps please provide

    • pdomala July 2, 2016 at 7:30 PM - Reply

      Hello Mohammad
      Create an objectclass and add your new attribute/s to the objectclass. Now add the objectclass name to the list of user’s objectclasses. The new attribute will be visible in all the user profiles who has the objectclass added. Use ldapmodify to add the objectclass to all the users at a time.

      • Ameer August 24, 2016 at 1:28 PM - Reply

        Thank you Prasad.

        Could you provide the example ldif content. I really tried up with creation of new attribute and it is not working for me. Thank you..

        I installed and configured OUD with 1389 and SSL: 4444

        I tried to connect this OUD from jxplorer with below details and it throws “Unable to perform Extended request Connection Request operation”. Let me know if anything wrong here.
        port 1389
        cn=Directory Manager
        baseDn ::: dc=oud,dc=com

        -thank you..

  4. Satish September 19, 2016 at 2:41 PM - Reply

    Can you please provide steps for silent installation? I’m trying to install it on linux and display and root user access is restricted for the user

    • pdomala September 24, 2016 at 4:59 PM - Reply

      You can record response file and use it for installing OUD using below commands
      ./runInstaller -record -destinationFile /u01/app/oracle/oud_response.rsp
      ./runInstaller -silent -responseFile /u01/app/oracle/oud_response.rsp

  5. Pradeep September 20, 2016 at 8:07 PM - Reply

    Great work! I started following your portal for gaining knowledge in Oracle Identity and Access Management technologies. Much appreciated your work!

    • pdomala September 24, 2016 at 4:57 PM - Reply

      Thanks Pradeep. Many Middleware videos in production. Stay tuned.

  6. mayank September 26, 2016 at 4:41 AM - Reply

    how to configure oud as proxy and gateway pls explain

  7. mtee October 20, 2016 at 2:06 PM - Reply

    Thanks for the easy to understand tutorial. I just started Oracle middleware. more more please 🙂

  8. Binish November 8, 2016 at 9:22 AM - Reply

    Hi Prasad, Can you make a video of configuring oud as proxy server.

  9. Som Das June 18, 2017 at 9:21 PM - Reply

    Thank you very much 🙂

Leave A Comment