Skip Headers
Oracle® Fusion Middleware Installation Guide for Oracle Identity Management
11g Release 1 (11.1.1)

Part Number E12002-09
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

7 Configuring Oracle Virtual Directory

This chapter explains how to configure Oracle Virtual Directory (OVD). You must configure Oracle Virtual Directory after installing the softfware, as described in Installation Roadmap and Installing Oracle Identity Management (11.1.1.5.0).

This chapter discusses the following topics:

7.1 OVD with ODSM and Fusion Middleware Control in a New WebLogic Domain

This topic describes how to configure Oracle Virtual Directory (OVD) with Oracle Directory Services Manager (ODSM) and Fusion Middleware Control in a new WebLogic administration domain. It includes the following sections:

7.1.1 Appropriate Deployment Environment

The configuration described in this topic is appropriate for environments that have all of the following conditions:

  • You want to manage Oracle Virtual Directory using Fusion Middleware Control.

  • You want Oracle Virtual Directory to be in a WebLogic administration domain.

  • There is no WebLogic Administration Server managing other 11g Release 1 (11.1.1) Oracle Directory Services components.

  • You want to install Oracle Virtual Directory and a WebLogic Administration Server colocated on the same host.

7.1.2 Components Deployed

Performing the configuration in this section deploys the following components.

  • WebLogic Administration Server

  • Oracle Virtual Directory

  • Oracle Directory Services Manager

  • Fusion Middleware Control

7.1.3 Dependencies

The configuration in this section depends on Oracle WebLogic Server.

7.1.4 Procedure

Perform the following steps to configure Oracle Virtual Directory with Oracle Directory Services Manager and Fusion Middleware Control in a new domain:

  1. Ensure that Oracle Virtual Directory is installed, as described in Installation Roadmap and Installing Oracle Identity Management (11.1.1.5.0).

  2. Run <ORACLE_HOME>/bin/config.sh (On UNIX) or <ORACLE_HOME>\bin\config.bat to start the Oracle Identity Management Configuration Wizard. Click Next to continue.

  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 Virtual Directory. The Oracle Directory Services Manager and Fusion Middleware Control management components are 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 Oracle Virtual Directory Information screen appears.

  8. Enter the following information:

    • LDAP v3 Name Space: Enter the name space for Oracle Virtual Directory. The default value is dc=us,dc=oracle,dc=com.

    • HTTP Web Gateway: Select this option to enable the Oracle Virtual Directory HTTP Web Gateway.

    • Secure: Select this option if you enabled the HTTP Web Gateway and you want to secure it using SSL.

    • Administrator User Name: Enter the user name for the Oracle Virtual Directory administrator. The default value is cn=orcladmin.

    • Password: Enter the password for the Oracle Virtual Directory administrator.

    • Confirm Password: Enter the password for the Oracle Virtual Directory administrator again.

    • Configure Administrative Server in secure mode: Select this option to secure the Oracle Virtual Directory Administrative Listener using SSL. This option is selected by default. Oracle recommends selecting this option.

    Click Next. The Installation Summary screen appears.

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

7.2 Only OVD in an Existing WebLogic Domain

This topic describes how to configure only Oracle Virtual Directory (OVD) in an existing WebLogic administration domain. It includes the following sections:

7.2.1 Appropriate Deployment Environment

The configuration described in this topic is appropriate for environments that have both of the following conditions:

  • A WebLogic Administration Server is available to manage 11g Release 1 (11.1.1) Oracle Directory Services components and you want Oracle Virtual Directory to join that domain.

  • You want to install Oracle Virtual Directory separately from the WebLogic Administration Server.

7.2.2 Components Deployed

Performing the configuration in this section deploys only Oracle Virtual Directory.

7.2.3 Dependencies

The configuration in this section depends on Oracle WebLogic Server.

7.2.4 Procedure

Perform the following steps to configure only Oracle Virtual Directory in an existing domain:

  1. Ensure that Oracle Virtual Directory is installed, as described in Installation Roadmap and Installing Oracle Identity Management (11.1.1.5.0).

  2. Run <ORACLE_HOME>/bin/config.sh (On UNIX) or <ORACLE_HOME>\bin\config.bat to start the Oracle Identity Management Configuration Wizard. Click Next to continue.

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

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

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

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

    4. 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.

    Note:

    To configure Oracle Identity Management components in an existing Oracle WebLogic Server administration domain, each Oracle WebLogic Server Home, Oracle Middleware Home, and Oracle Home directory in the domain must have identical directory paths and names.

    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 Virtual Directory. 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 Oracle Virtual Directory Information screen appears.

  8. Enter the following information:

    • LDAP v3 Name Space: Enter the name space for Oracle Virtual Directory. The default value is dc=us,dc=oracle,dc=com.

    • HTTP Web Gateway: Select this option to enable the Oracle Virtual Directory HTTP Web Gateway.

    • Secure: Select this option if you enabled the HTTP Web Gateway and you want to secure it using SSL.

    • Administrator User Name: Enter the user name for the Oracle Virtual Directory administrator. The default value is cn=orcladmin.

    • Password: Enter the password for the Oracle Virtual Directory administrator.

    • Confirm Password: Enter the password for the Oracle Virtual Directory administrator again.

    • Configure Administrative Server in secure mode: Select this option to secure the Oracle Virtual Directory Administrative Listener using SSL. This option is selected by default. Oracle recommends selecting this option.

    Click Next. The Installation Summary screen appears.

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

7.3 Only OVD Without a WebLogic Domain

This topic describes how to configure only Oracle Virtual Directory (OVD) without a WebLogic administration domain. It includes the following sections:

7.3.1 Appropriate Deployment Environment

Perform the configuration in this topic if you want to register Oracle Virtual Directory with a remote WebLogic Administration Server for management purposes, but you do not want to install Oracle WebLogic Server locally.

Note:

To manage Oracle Virtual Directory using Fusion Middleware Control in this environment, you must register Oracle Virtual Directory with the remote WebLogic Administration Server after installation.

7.3.2 Components Deployed

Performing the configuration in this section deploys only Oracle Virtual Directory.

7.3.3 Dependencies

The configuration in this section depends on Oracle WebLogic Server.

7.3.4 Procedure

Perform the following steps to configure only Oracle Virtual Directory without a domain:

  1. Ensure that Oracle Virtual Directory is installed, as described in Installation Roadmap and Installing Oracle Identity Management (11.1.1.5.0).

    Note:

    Installing Oracle WebLogic Server is optional in this particular scenario. Instead, you can create the Middleware Home by using the Oracle Identity Management Configuration Wizard, as described later in Step 4 of the procedure.
  2. Run <ORACLE_HOME>/bin/config.sh (On UNIX) or <ORACLE_HOME>\bin\config.bat to start the Oracle Identity Management Configuration Wizard. Click Next to continue.

  3. Select Configure without a Domain on the Select Domain screen and click Next. The Specify Installation Location screen appears.

  4. Enter the following information in each field:

    • Oracle Middleware Home Location: If an Oracle Middleware Home directory already exists, enter the path to it in this field. If an Oracle Middleware Home directory does not exist, enter a path to the location where you want the Installer to create the directory that will contain the Oracle Common Home and Oracle Home directories. The Installer creates an Oracle Common Home directory and an Oracle Home directory inside the directory you identify in this field.

      The Oracle Middleware Home directory is commonly referred to as MW_HOME.

      Note:

      The Oracle Middleware Home directory is not required to contain an Oracle WebLogic Server installation.
    • Oracle Home Directory: Enter a name for the Oracle Home directory. The Installer uses the name you enter in this field to create the Oracle Home directory under the location you enter in the Oracle Middleware Home Location field. The Oracle Home directory is commonly referred to as ORACLE_HOME.

    • Oracle Instance Location: Enter the directory path to the location where you want to create the Oracle Instance directory. The Installer creates the Oracle Instance directory using the location you enter in this field and using the name you enter in the Oracle Instance Name field. You can identify any location on your system for the Oracle Instance directory—it does not have to reside inside the Oracle Middleware Home directory.

    • Oracle Instance Name: Enter a name for the Oracle Instance directory. The Installer uses the name you enter in this field to create the Oracle Instance directory at the location you specify in the Oracle Instance Location field. This directory is commonly referred to as ORACLE_INSTANCE.

    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 Virtual Directory. 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 Oracle Virtual Directory Information screen appears.

  8. Enter the following information:

    • LDAP v3 Name Space: Enter the name space for Oracle Virtual Directory. The default value is dc=us,dc=oracle,dc=com.

    • HTTP Web Gateway: Select this option to enable the Oracle Virtual Directory HTTP Web Gateway.

    • Secure: Select this option if you enabled the HTTP Web Gateway and you want to secure it using SSL.

    • Administrator User Name: Enter the user name for the Oracle Virtual Directory administrator. The default value is cn=orcladmin.

    • Password: Enter the password for the Oracle Virtual Directory administrator.

    • Confirm Password: Enter the password for the Oracle Virtual Directory administrator again.

    • Configure Administrative Server in secure mode: Select this option to secure the Oracle Virtual Directory Administrative Listener using SSL. This option is selected by default. Oracle recommends selecting this option.

    Click Next. The Installation Summary screen appears.

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

  10. Execute the following command to register Oracle Virtual Directory with the WebLogic Administration Server. Registering with the WebLogic Administration Server allows you to manage Oracle Virtual Directory using Fusion Middleware Control.

    $ORACLE_INSTANCE/bin/opmnctl registerinstance 
     -adminHost HOSTNAME 
     -adminPort WEBLOGIC_PORT 
     -adminUsername WEBLOGIC_ADMIN_USERNAME
    

    Note:

    You will be prompted for the WebLogic administrator's user name and password.

    For example:

    $ORACLE_INSTANCE/bin/opmnctl registerinstance \
     -adminHost myhost \
     -adminPort 7001 \
     -adminUsername weblogic \
    

    Note:

    The default administrative port on the WebLogic Administration Server is 7001.

7.4 Verifying OVD

Verify the Oracle Virtual Directory (OVD) installation by:

7.5 Getting Started with OVD After Installation

After installing Oracle Virtual Directory (OVD), refer to the "Getting Started with Administering Oracle Virtual Directory" chapter in the Oracle Fusion Middleware Administrator's Guide for Oracle Virtual Directory.