top of page

Step-by-Step Guide: Implementing Oracle Internet Directory (OID)

Oracle Internet Directory (OID) is a directory service that centralizes information such as user data and application configuration details. OID is commonly used to provide an LDAP-compliant directory for Oracle applications and can integrate with Single Sign-On (SSO) solutions.

This guide provides a step-by-step command line guide for implementing OID.


Prerequisites


  1. Environment Setup:

    • Ensure the operating system (Linux or Solaris) has been configured with the required dependencies for OID.

    • Set up the Oracle environment, including ORACLE_HOME and ORACLE_BASE paths.

  2. Database Requirements:

    • OID requires an Oracle Database to store directory data.

    • Ensure the database is accessible and has sufficient resources (CPU, memory, disk).

  3. Oracle Internet Directory Software:

    • Download the latest OID software from the Oracle Software Delivery Cloud or My Oracle Support.

    • Unzip the software package on the server where OID will be installed.


Step 1: Install Oracle Fusion Middleware Infrastructure


1. Install the Fusion Middleware Infrastructure

OID installation requires the Fusion Middleware Infrastructure as a base.

  1. Navigate to Installation Directory:

    cd /path/to/fmw_infrastructure

  2. Start the Installer:

    ./fmw_12.2.1.4.0_infrastructure.jar

  3. Follow Installer Prompts:

    • Inventory Directory: Choose an inventory directory (e.g., /u01/app/oraInventory).

    • Installation Location: Specify the Oracle Home directory for OID (e.g., /u01/app/oracle/product/OID).

    • Installation Type: Choose "Fusion Middleware Infrastructure" and proceed with the installation.

2. Verify Middleware Installation

ls -l /u01/app/oracle/product/OID


Step 2: Install Oracle Internet Directory


1. Start the OID Installer

  1. Navigate to OID Installation Media:

    cd /path/to/oid_software

  2. Launch the Installer:

    ./runInstaller

2. Configure OID during Installation

  • Oracle Home: Select the Oracle Home where Fusion Middleware Infrastructure is installed.

  • Configure Components: Select "Oracle Internet Directory."

  • Specify Database: Provide the Oracle Database details, including hostname, port, and Service Name or SID.

  • Schema Prefix: Specify a schema prefix for OID (e.g., OID).


3. Run Configuration Assistants


The installer will launch the necessary configuration assistants, such as OID Configuration Assistant, to create schemas and configure OID components.


Step 3: Set Up Oracle WebLogic Domain for OID


  1. Run the Configuration Wizard:

    /u01/app/oracle/product/OID/oracle_common/common/bin/config.sh

  2. Create a New Domain:

    • Domain Location: Choose a domain location, for example, /u01/app/oracle/config/domains/OID_domain.

    • Domain Type: Select "Oracle Internet Directory" template.

  3. Configure Domain:

    • Set Administrator Credentials: Enter the WebLogic Admin username and password.

    • OID Configuration: Specify OID settings, such as instance port (default is 3060).

  4. Complete Domain Creation:

    • Complete the remaining prompts in the Configuration Wizard and click Create to finish.


Step 4: Start OID and WebLogic Components


1. Start the WebLogic Admin Server

cd /u01/app/oracle/config/domains/OID_domain/bin ./startWebLogic.sh

2. Start the OID Managed Server

  • Log into the WebLogic Console at http://<server_ip>:7001/console using the WebLogic admin credentials.

  • Navigate to Servers, select the OID Managed Server, and click Start.

3. Verify OID Server Status

  • Use ldapbind to verify OID is running and accessible:

    $OID_HOME/bin/ldapbind -h <oid_host> -p 3060 -D "cn=orcladmin" -w <password>


Step 5: Configure OID Using Command Line Tools


OID provides several command line tools to manage directory data and configuration.


1. Set Up Directory Contexts

  • Create a Base DN (Distinguished Name):

    $OID_HOME/bin/ldapadd -h <oid_host> -p 3060 -D "cn=orcladmin" -w <password> -f base_dn.ldif

  • Example base_dn.ldif:

    ldif

    dn: dc=example,dc=com objectclass: top objectclass: domain dc: example

2. Add Users and Groups

  • Add a User:

    $OID_HOME/bin/ldapadd -h <oid_host> -p 3060 -D "cn=orcladmin" -w <password> -f add_user.ldif

  • Example add_user.ldif:

    ldif


    dn: uid=johndoe,ou=people,dc=example,dc=com objectClass: top objectClass: person objectClass: organizationalPerson objectClass: inetOrgPerson cn: John Doe sn: Doe uid: johndoe

  • Add a Group:

    $OID_HOME/bin/ldapadd -h <oid_host> -p 3060 -D "cn=orcladmin" -w <password> -f add_group.ldif

  • Example add_group.ldif:

    ldif


    dn: cn=employees,ou=groups,dc=example,dc=com objectClass: top objectClass: groupOfUniqueNames cn: employees uniqueMember: uid=johndoe,ou=people,dc=example,dc=com


Step 6: Configure OID Integration with Oracle E-Business Suite or Other Applications


  1. Set Profile Options in Oracle EBS:

    • Set up EBS profile options to point to the OID server’s hostname and port.

  2. Configure LDAP Authentication:

    • Use the Oracle EBS System Administrator responsibility to set up LDAP authentication with OID.

  3. Test Authentication:

    • Log into Oracle EBS and test login with users authenticated against OID.


Step 7: Monitor and Maintain OID


  1. Monitor OID Logs:

    • OID logs are located in $DOMAIN_HOME/servers/<OID_Server>/logs/:

      bash

      Copy code

      tail -f $DOMAIN_HOME/servers/OID_Server/logs/OID_Server.out

  2. Automate Backups of OID Database:

    • Ensure regular database backups to safeguard directory data.

  3. LDAP Query Testing:

    • Use ldapsearch to verify the data in OID:

      bash

      Copy code

      $OID_HOME/bin/ldapsearch -h <oid_host> -p 3060 -D "cn=orcladmin" -w <password> -b "dc=example,dc=com" "(objectclass=*)"


Additional References


Conclusion

By following these steps, you can implement Oracle Internet Directory (OID) and configure it for integration with Oracle E-Business Suite or other Oracle applications. Regular monitoring and maintenance will help ensure OID remains stable and performs efficiently.


68 views

Recent Posts

See All

Comentários


AiTech

©2023 by AiTech

bottom of page