Skip Headers
Oracle® Fusion Middleware Installation Guide for Oracle Identity Management
11g Release 1 (11.1.1)
E12002-02
  Go To Documentation Library
Library
Go To Product List
Product
Go To Table Of Contents
Contents

Previous
Previous
 
Next
Next
 

7 Installing and Configuring Oracle Directory Integration Platform

This chapter explains how to install and configure Oracle Directory Integration Platform. It includes the following topics:

7.1 Installing and Configuring Oracle Directory Integration Platform with Fusion Middleware Control in a New WebLogic Administration Domain

This topic describes how to install and configure Oracle Directory Integration Platform with Fusion Middleware Control in a new WebLogic administration domain. It includes the following sections:

7.1.1 Appropriate Deployment Environment

The installation and configuration described in this topic is appropriate if there is no WebLogic Administration Server managing other 11g Release 1 (11.1.1) Oracle Directory Services components and Oracle Internet Directory is installed without a domain.

7.1.2 Components Deployed

Performing the installation and configuration in this section deploys the following components:

  • WebLogic Managed Server

  • Oracle Directory Integration Platform

  • WebLogic Administration Server

  • Fusion Middleware Control

7.1.3 Dependencies

The installation and configuration in this section depends on the following:

  • Oracle WebLogic Server

  • Oracle Internet Directory

  • Oracle Database for Oracle Internet Directory

  • Identity Management - Oracle Internet Directory schema existing in the Oracle Internet Directory database.

7.1.4 Procedure

Perform the following steps to install and configure Oracle Directory Integration Platform with Fusion Middleware Control in a new domain:

  1. Install Oracle WebLogic Server. Refer to "Installing Oracle WebLogic Server and Creating the Oracle Middleware Home" for more information.

  2. Start your installation by performing all the steps in "Starting an Installation". After you complete those steps, the Select Domain screen appears.

  3. On the Select Domain screen, select Create New Domain and enter the following information:

    • Enter the user name for the new domain in the User Name field.

    • Enter the user password for the new domain in the User Password field.

    • Enter the user password again in the Confirm Password field.

    • Enter a name for the new domain in the Domain Name field.

    Click Next. The Specify Installation Location screen appears.

  4. Identify the Homes, Instances, and the WebLogic Server directory by referring to "Identifying Installation Directories". After you enter information for each field, click Next. The Specify Security Updates screen appears.

  5. Choose how you want to be notified about security issues:

    • If you want to be notified about security issues through email, enter your email address in the Email field.

    • If you want to be notified about security issues through My Oracle Support (formerly MetaLink), select the My Oracle Support option and enter your My Oracle Support Password.

    • If you do not want to be notified about security issues, leave all fields empty.

    Click Next. The Configure Components screen appears.

  6. Select only Oracle Directory Integration Platform. The Fusion Middleware Control management component is automatically selected for this installation.

    Ensure no other components are selected and click Next. The Configure Ports screen appears.

  7. Choose how you want the Installer to configure ports:

    • Select Auto Port Configuration if you want the Installer to configure ports from a predetermined range.

    • Select Specify Ports using Configuration File if you want the Installer to configure ports using the staticports.ini file. You can click View/Edit File to update the settings in the staticports.ini file.

    Click Next. The Specify OID Details screen appears.

  8. Identify the Oracle Internet Directory for Oracle Directory Integration Platform by entering the following information:

    • Hostname: Enter the hostname or IP address of the Oracle Internet Directory host.

    • Port: Enter the Oracle Internet Directory LDAP SSL port.

    • User Name: Enter the user name of the Oracle Internet Directory Administrator.

    • Password: Enter the password for the user name Oracle Directory Integration Platform will use to connect to Oracle Internet Directory.

    Click Next. The Specify Schema Database screen appears.

  9. Enter the following information about the Oracle Internet Directory schema:

    • Connect String: Enter the database connection information. The connection string must be in the form of hostname:port:servicename. For Oracle Real Application Clusters (RAC), the connection string must be in the form of hostname1:port1:instance1^hostname2:port2:instance2@servicename.

    • Password: Enter the password for the ODSSM schema in the Password field.

    Click Next. The Installation Summary screen appears.

  10. Complete the installation by performing all the steps in "Completing an Installation".

7.2 Installing and Configuring Only Oracle Directory Integration Platform in an Existing WebLogic Administration Domain

This topic describes how to install and configure only Oracle Directory Integration Platform in an existing WebLogic administration domain. It includes the following sections:

7.2.1 Appropriate Deployment Environment

The installation and configuration described in this topic is appropriate for the following environments:

An environment that has the following condition: 

  • A WebLogic Administration Server is managing an 11g Release 1 (11.1.1) Oracle Internet Directory component and you want Oracle Directory Integration Platform to join that domain.

An environment that has the following condition: 

  • A WebLogic Administration Server is managing other 11g Release 1 (11.1.1) Oracle Directory Services—but not Oracle Internet Directory, which is installed without a domain.

7.2.2 Components Deployed

Performing the installation and configuration in this section deploys the following components:

  • WebLogic Managed Server

  • Oracle Directory Integration Platform

7.2.3 Dependencies

The installation and configuration in this section depends on the following:

  • Oracle WebLogic Server

  • Oracle Internet Directory

  • Oracle Database for Oracle Internet Directory

  • Identity Management - Oracle Internet Directory schema existing in the Oracle Internet Directory database.

7.2.4 Procedure

Perform the following steps to install and configure only Oracle Directory Integration Platform in an existing domain:

  1. Install Oracle WebLogic Server. Refer to "Installing Oracle WebLogic Server and Creating the Oracle Middleware Home" for more information.

  2. Start your installation by performing all the steps in "Starting an Installation". After you complete those steps, the Select Domain screen appears.

  3. On the Select Domain screen, select Extend Existing Domain and enter the following information:

    • Enter the name of the host that contains the domain in the Host Name field.

    • Enter the Oracle WebLogic Server listen port in the Port field.

    • Enter the user name for the domain in the User Name field.

    • Enter the password for the domain user in the User Password field.

    Click Next. The Specify Installation Location screen appears.

  4. Identify the Homes, Instances, and the WebLogic Server directory by referring to "Identifying Installation Directories". After you enter information for each field, click Next. The Specify Security Updates screen appears.

  5. Choose how you want to be notified about security issues:

    • If you want to be notified about security issues through email, enter your email address in the Email field.

    • If you want to be notified about security issues through My Oracle Support (formerly MetaLink), select the My Oracle Support option and enter your My Oracle Support Password.

    • If you do not want to be notified about security issues, leave all fields empty.

    Click Next. The Configure Components screen appears.

  6. Select only Oracle Directory Integration Platform. Ensure no other components are selected and click Next. The Configure Ports screen appears.

  7. Choose how you want the Installer to configure ports:

    • Select Auto Port Configuration if you want the Installer to configure ports from a predetermined range.

    • Select Specify Ports using Configuration File if you want the Installer to configure ports using the staticports.ini file. You can click View/Edit File to update the settings in the staticports.ini file.

    Click Next. The Specify OID Details screen appears.

  8. Identify the Oracle Internet Directory for Oracle Directory Integration Platform by entering the following information:

    • Hostname: Enter the hostname or IP address of the Oracle Internet Directory host.

    • Port: Enter the Oracle Internet Directory LDAP SSL port.

    • User Name: Enter the user name of the Oracle Internet Directory Administrator.

    • Password: Enter the password for the user name Oracle Directory Integration Platform will use to connect to Oracle Internet Directory.

    Click Next. The Specify Schema Database screen appears.

  9. Enter the following information about the Oracle Internet Directory schema:

    • Connect String: Enter the database connection information. The connection string must be in the form of hostname:port:servicename. For Oracle Real Application Clusters (RAC), the connection string must be in the form of hostname1:port1:instance1^hostname2:port2:instance2@servicename.

    • Password: Enter the password for the ODSSM schema in the Password field.

    Click Next. The Installation Summary screen appears.

  10. Complete the installation by performing all the steps in "Completing an Installation".

7.3 Installing Oracle Directory Integration Platform when Oracle Internet Directory is Running in SSL Mode 2 - Server Only Authentication

You cannot install Oracle Directory Integration Platform 11g Release 1 (11.1.1) when Oracle Internet Directory is already installed and running in SSL Mode 2 - Server Only Authentication.

If Oracle Internet Directory is already installed and running in SSL Mode 2 - Server Only Authentication, you must perform the following steps to install Oracle Directory Integration Platform 11g Release 1 (11.1.1):

  1. Configure Oracle Internet Directory to temporarily run in SSL Mode 0 - No Authentication.

    Refer to the "Configuring Secure Sockets Layer (SSL)" chapter in the Oracle Fusion Middleware Administrator's Guide for Oracle Internet Directory for complete information.

  2. Install Oracle Directory Integration Platform using the appropriate procedure in this chapter.

  3. Configure Oracle Internet Directory to run in SSL Mode 2 - Server Only Authentication again. Refer to the "Configuring Secure Sockets Layer (SSL)" chapter in the Oracle Fusion Middleware Administrator's Guide for Oracle Internet Directory.

  4. Configure Oracle Directory Integration Platform to run in SSL Mode 2 by referring to the following sections in the Oracle Fusion Middleware Integration Guide for Oracle Identity Management:

    • Configuring Oracle Directory Integration Platform for SSL Mode 2 - Server Only Authentication

    • Managing the SSL Certificates of Oracle Internet Directory and Connected Directories

7.4 Verifying Oracle Directory Integration Platform

Verify the Oracle Directory Integration Platform installation using the dipStatus command, which is located in the $ORACLE_HOME/bin/ directory.


Note:

You must set the WL_HOME and ORACLE_HOME environment variables before executing the dipStatus command.

The following is the syntax for the dipStatus command:

$ORACLE_HOME/bin/dipStatus -h HOST -p PORT -D wlsuser [-help]

Note:

You will be prompted for the Oracle WebLogic Server login password. You cannot provide the password as a command-line argument.

Best security practice is to provide a password only in response to a prompt from the command. If you must execute dipStatus from a script, you can redirect input from a file containing the Oracle WebLogic Server password. Use file permissions to protect the file and delete it when it is no longer necessary.


7.5 Getting Started with Oracle Directory Integration Platform After Installation

After you install Oracle Directory Integration Platform, no additional configuration is needed. The next step is to create synchronization profiles.

The Oracle Fusion Middleware Integration Guide for Oracle Identity Management explains how to manage Oracle Directory Integration Platform. For information about creating synchronization profiles using Oracle Enterprise Manager Fusion Middleware Control Console, refer to the "Managing Synchronization Profiles Using Fusion Middleware Control" section in that guide.