Skip Headers
Oracle® Fusion Middleware Installation Guide for Oracle Unified Directory
11g Release 2 (11.1.2)

Part Number E23737-02
Go to Documentation Home
Home
Go to Table of Contents
Contents
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

2 Installing the Software

Oracle Unified Directory can be managed by using the command line or by using the graphical Oracle Directory Services Manager (ODSM) interface. ODSM relies on Oracle WebLogic Server and on the Oracle Application Development Framework, so, if you plan to use ODSM you must install these components.

This chapter describes how to obtain and install Oracle Unified Directory, Oracle WebLogic Server, and the Oracle Application Development Framework. The ODSM bits are installed when you install Oracle Unified Directory but ODSM must be configured when you have installed Oracle WebLogic Server and the Oracle Application Development Framework.

Note:

The version of ODSM described in this document is 11.1.2.0.0. ODSM 11.1.2.0.0 can be used to manage Oracle Unified Directory only. It cannot be used with Oracle Internet Directory or Oracle Virtual Directory. Versions of ODSM prior to 11.1.1.5.0 cannot be used with Oracle Unified Directory.

The installation process requires that you identify certain directories into which the software is installed. For a complete understanding of the installation directory structure, see Section 1.4, "Understanding the Installation Directories".

This section covers the following topics:

2.1 Getting the Oracle Unified Directory Software

You can obtain Oracle Unified Directory, Oracle WebLogic Server, and the Oracle Application Development Framework by using one of the following methods:

The ODSM software is installed when you install Oracle Unified Directory.

2.2 Installing Oracle Unified Directory

  1. Download the Oracle Unified Directory zip file (oud.zip) from OTN or Oracle Software Delivery Cloud.

  2. Unzip the Oracle Unified Directory zip file:

    $ cd download-path
    $ unzip oud.zip
    
  3. Change to the Disk1 directory.

    $ cd download-path/oud/Disk1
    
  4. Start the Oracle Universal Installer (OUI) by running the runInstaller (UNIX) or setup.exe (Windows) script, specifying the location of a valid Java installation (at least Java 6).

    On UNIX systems:

    $ ./runInstaller -jreLoc JAVA_HOME
    

    For example:

    $ ./runInstaller -jreLoc /usr/lang/JAVA/jre1.6.0_20
    

    On Windows systems:

    C:\download-path\oud\Disk1>setup.exe -jreLoc JAVA_HOME
    

    For example:

    C:\oud\Disk1>setup.exe -jreLoc C:\Progra~1\Java\jre1.6.0_20
    

    Note:

    On Windows systems, if the path to your Java installation includes a space character, you must provide the path in DOS 8.3 format, as shown in the previous example.

  5. On Linux and Solaris systems, if this is the first OUI-based product to be installed on the system, the Specify Inventory Directory screen is displayed. Perform the following steps:

    1. Specify an inventory directory.

      The Central Inventory directory contains information relating to all Oracle products that are installed on this host. It includes an inventory.xml file and a logs directory. The inventory.xml file lists the Oracle homes that are installed on the system. For each Oracle home, it also lists the home name, the home index, and the nodes on which the home is installed. You should not remove or manually edit this file as this might affect installation and patching.

    2. Enter the ID of a group that has write access to the inventory directory.

    3. Click OK to continue. The Inventory Location Confirmation Dialog is displayed.

    4. In a separate terminal window, as a user with root privileges, run the script located at
      /inventory-directory/createCentralInventory.sh
      where inventory-directory is the path that you specified in step a.

      The createCentralInventory.sh script does the following:

      • Sets the inventory directory and group name to what you specified in steps a and b.

      • Creates an Oracle inventory pointer file (/var/opt/oracle/oraInst.loc).

      • Changes the permissions of the inventory directory to 770.

    5. When you have run the script, click OK on the Inventory Location Confirmation Dialog.

    If you do not have root access to the machine, and want to continue with the installation, select Continue With Local Inventory.

    If other Oracle products have been installed on this system, the inventory screen is not displayed.

    On Windows systems, you are not prompted to specify an inventory directory. The inventory directory is created in a default location under C:\Program Files\Oracle\Inventory.

  6. On the Welcome screen, click Next.

  7. On the Install Software Updates screen, select Skip Software Updates and click Next.

  8. Monitor the prerequisites checking.

    If there is an issue, an error or warning message is displayed. Investigate the issue and resolve it. After resolving the issue, click Retry to restart the prerequisite checks.

    You can proceed with the installation without resolving the issue by clicking Continue. However, failing to resolve the issue during the prerequisites checking may cause additional issues later in the installation.

    If all prerequisite checks pass inspection, click Next.

  9. On the Specify Installation Location screen, provide the following locations:

    • OUD Base Location Home. This directory will house any Oracle Unified Directory instances that are configured at a later stage, unless you specify an alternate instance directory path.

    • 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 OUD Base Location field. The Installer installs the files (such as binaries and libraries) required to host Oracle Unified Directory in the Oracle Home directory. The Oracle Home directory is commonly referred to as ORACLE_HOME. The default Oracle Home directory for Oracle Unified Directory is Oracle_OUD1.

    Click Next.

  10. Verify the installation and configuration information on the Installation Summary screen.

    Click Save to save the installation response file, which contains your responses to the Installer prompts and fields. You can use this response file to perform silent installations.

    The installation response file is not saved by default-you must click Save to retain it.

    Click Install. The Installation Progress screen is displayed.

  11. On the Installation Progress screen, click Next.

  12. On the Installation Complete screen, check the details of the installation and click Finish.

After you have installed Oracle Unified Directory, you can configure a server instance as a directory server, a proxy server, or a replication gateway. For more information, see Section 1.2, "Selecting a Server Role".

2.2.1 Performing a Silent Installation

Oracle Unified Directory enables you to perform a silent installation (that is, an installation that does not require user intervention) by using the set of responses that you provided in an earlier installation. To perform a silent installation, follow steps 1-9 of the previous procedure, then do the following:

  1. Click Save on the Installation Summary screen.

  2. Specify the location to which the response file should be saved, for example /tmp/oud-install.rsp, and click Save.

  3. When the response file has been saved, cancel the installation.

  4. Run the following command to perform the silent installation:

    $ download-path/oud/Disk1/runInstaller -jreLoc JAVA_HOME -silent -responseFile /tmp/oud-install.rsp
    

2.3 Installing Oracle WebLogic Server

If you plan to manage Oracle Unified Directory with ODSM, you must install Oracle WebLogic Server, as described in this section. For complete installation information, see the Oracle Fusion Middleware Installation Guide for Oracle WebLogic Server (http://download.oracle.com/docs/cd/E15523_01/doc.1111/e14142/toc.htm).

Note:

You must install Oracle WebLogic Server as the same user who installed Oracle Unified Directory.

  1. Insert the Oracle WebLogic Server CD-ROM or download the Oracle WebLogic Server Installer from the following Web site:

    http://www.oracle.com/technetwork/middleware/downloads/index-087510.html

    Oracle Unified Directory 11.1.2 supports Oracle WebLogic Server Installer versions 10.3.5 and 10.3.6.

  2. Locate the appropriate executable file for your system, for example:

    • wls1036_linux32.bin for 32-bit Linux systems

    • wls1036_win32.exe for 32-bit Windows systems

    • wls1036_generic.jar for all 64-bit platforms

    The 32-bit executable files are bundled with the appropriate JDK version. If you use the 64-bit installer, you will need to invoke the installer with a supported JDK for your platform. This JDK must be installed on your system before you install Oracle WebLogic Server. Refer to the Oracle Fusion Middleware certification document (http://www.oracle.com/technology/software/products/ias/files/fusion_certification.htm) for a list of supported JDKs for your platform

  3. Run the Oracle WebLogic Server Installer directly from the CD-ROM, or copy the file to your local system and run it locally. For 64-bit installations:

    • Replace JAVA_HOME with the installation location of the supported JDK you installed for your platform.

    • Use the -d64 flag when using 32/64-bit hybrid JDKs (such as the HP JDK for HP-UX and SUN JDK for Solaris SPARC).

    • Execute JAVA_HOME/bin/java -version (or JAVA_HOME/bin/java -d64 -version on 32/64-bit hybrid JDKs) to ensure that your JAVA_HOME refers to a 64-bit JDK.

    Examples for 32-bit systems:

    Linux:

    ./wls1036_linux32.bin

    Windows:

    wls1036_win32.exe

    Examples for 64-bit systems:

    UNIX:

    JAVA_HOME/bin/java -jar wls1036_generic.jar

    or

    JAVA_HOME/bin/java -d64 -jar wls1036_generic.jar

    Windows:

    JAVA_HOME\bin\java -jar wls1036_generic.jar

    After you start the Oracle WebLogic Server Installer, the Welcome screen is displayed.

    Click Next.

  4. On the Choose Middleware Home Directory screen, appears select Create a new Middleware Home.

    The Middleware Home directory must be the same directory as the OUD Base Location Home that you defined when you installed Oracle Unified Directory (see Step 7 of the previous procedure). If these directories are not the same, ODSM will not work correctly.

    Click Browse to navigate to the OUD Base Location Home directory, then click Next.

    A message is displayed, indicating that the directory is not empty. Click Yes to proceed with the installation.

  5. On the Register for Security Updates screen, select whether or not you want to receive the latest product and security updates. If you choose not to receive updates, you are asked to verify your selection before continuing.

    Click Next.

  6. On the Choose Install Type screen, select Typical and click Next.

  7. On the JDK Selection screen, select a valid JDK.

  8. On the Choose Product Installation Directories screen, verify the location for the WebLogic Server Installation and click Next.

  9. If you are installing Oracle WebLogic Server on a UNIX system, the Installation Summary screen is displayed. Proceed to step 10.

    If you are installing Oracle WebLogic Server on a Windows system, the Choose Shortcut Location screen appears. Specify a location where you want Windows to create a shortcut to Oracle products and click Next.

  10. Click Next on the Installation Summary screen.

  11. On the Installation Complete screen, de-select Run Quickstart and click Done to exit the Installer.

2.4 Installing the Oracle Application Development Framework

ODSM is a J2EE application that runs inside a Web Logic container and relies on certain libraries that are not installed with the Oracle Unified Directory software. These libraries are provided in the Oracle Application Development Framework. If you plan to manage Oracle Unified Directory with ODSM, you must therefore install the Oracle Application Development Framework.

Note:

You must install the Oracle Application Development Framework as the same user who installed Oracle Unified Directory.

  1. Download the Oracle Application Development Framework from Oracle Technology Network (OTN) at the following location:

    http://www.oracle.com/technetwork/developer-tools/adf/downloads/index.html

    Oracle Unified Directory 11.1.2 supports Oracle Application Development Framework 11.1.1.6.0.

    The Oracle Application Development Framework Runtime 11.1.2.1.0 is provided as a patch for Oracle Application Development Framework Runtime 11.1.1.5 and is available through Oracle Support.

  2. Unzip the Oracle Application Development Framework zip file:

    $ cd download-path
    $ unzip ofm_appdev_generic_11.1.1.6.0_disk1_1of1.zip
    
  3. Change to the Disk1 directory.

    $ cd download-path/appdev/Disk1
    
  4. Start the Oracle Universal Installer by running the runInstaller script, specifying the location of a valid Java installation.

    On UNIX systems:

    $ ./runInstaller -jreLoc JAVA_HOME
    

    On Windows systems:

    DRIVE:\setup.exe -jreLoc JAVA_HOME
    
  5. If this is the first time an Oracle product is being installed on the system, specify the inventory directory.

  6. On the Welcome screen, click Next.

  7. On the Install Software Updates screen, select Skip Software Updates and click Next.

  8. Monitor the prerequisites checking.

    If there is an issue, an error or warning message is displayed. Investigate the issue and resolve it. After resolving the issue, click Retry to restart the prerequisite checks.

    You can proceed with the installation without resolving the issue by clicking Continue. However, failing to resolve the issue during the prerequisites checking may cause additional issues later in the installation.

    If all prerequisite checks pass inspection, click Next.

  9. On the Specify Installation Location screen, provide the following locations:

    • Oracle Middleware Home. This directory must be the same as the OUD Base Location Home that you specified during the Oracle Unified Directory installation.

    • Oracle Home Directory. The Oracle Home directory is created under the location you enter in the OUD Base Location field. The Installer installs the files (such as binaries and libraries) required to host Oracle Unified Directory in the Oracle Home directory. The Oracle Home directory is commonly referred to as ORACLE_HOME.

  10. On the Application Server screen, WebLogic Server should be selected by default. Click Next.

  11. Verify the installation and configuration information on the Installation Summary screen.

    Click Save to save the installation response file, which contains your responses to the Installer prompts and fields. You can use this response file to perform silent installations.

    The installation response file is not saved by default-you must click Save to retain it.

    Click Install. The Installation Progress screen is displayed.

  12. On the Installation Progress screen, click Next.

  13. On the Installation Complete screen, check the details of the installation and click Finish.

2.5 Configuring WebLogic Server for Oracle Directory Services Manager

When you have installed the Oracle Application Development Framework, you must create a new WebLogic domain for ODSM. The following procedure outlines the configuration on a UNIX system.

  1. Run the configuration wizard from the following location:

    $ OUD Base Location Home/oracle_common/common/bin/config.sh
    

    On Windows systems, run the comparable config.bat script.

  2. On the Welcome screen, select Create a new WebLogic domain and click Next.

  3. On the Select Domain Source screen, select the Oracle Directory Services Manager check box.

    Oracle JRF is selected automatically.

  4. Click Next.

  5. On the Specify Domain Name and Location screen, type a domain name and specify its location.

    A new WebLogic domain is created in this location, and ODSM and its related components are deployed into this domain.

    Make a note of the domain location as you will need it to start the WebLogic domain in the following procedure.

  6. On the Configure Administrator User Name and Password screen, type a name and password for the user who will administer this domain.

    The password must be at least eight characters and must contain at least one number or special character. Confirm the password and click Next.

    Make a note of these details as you will need them to start or restart the WebLogic domain in the following procedure.

  7. On the Configure Server Start Mode screen, select Production Mode.

    Select a valid JDK and click Next.

  8. On the Optional Configuration screen, click Next.

  9. On the Configuration Summary screen, verify the domain details and click Create.

  10. On the Creating Domain Screen, click Done.

2.6 Accessing Oracle Directory Services Manager

When you have created the WebLogic domain, as described previously, you can start the Administration Server, and access ODSM through a browser. The following section outlines the process on a UNIX system.

  1. Run the script to start the Administration Server from the following location:

    $ domain-home/bin/startWebLogic.sh
    

    where domain-home is the domain that you created in Step 5 of the previous procedure. For example:

    $ OUD-Base-Location-Home/user_projects/domains/base_domain/bin/startWebLogic.sh
    

    On Windows systems, the command to run is:

    domain_home\startWebLogic.cmd
    

    The user name and password that are requested here correspond to those in step 6 of the previous procedure.

  2. Access ODSM through a browser, using the following URL:

    http://hostname:7001/odsm
    

    where hostname is the name of the server on which WebLogic Server is installed. 7001 is the default ODSM port.