This chapter describes how to obtain and install Oracle Unified Directory, Oracle WebLogic Server, and the Oracle Application Development Framework (Oracle ADF).
This chapter includes the following sections:
Section 2.1, "Obtaining the Software to Install Oracle Unified Directory"
Section 2.3, "Configuring Oracle WebLogic Server for Oracle Directory Services Manager"
Section 2.4, "Configuring Oracle Unified Directory with Oracle Directory Integration Platform"
You can manage Oracle Unified Directory either from the command line or by using the Oracle Directory Services Manager (ODSM) graphical user interface. ODSM requires Oracle WebLogic Server and Oracle ADF, so if you plan to use ODSM, you must also install these additional components.
If you do not plan to use ODSM, you need to download and install only Oracle Unified Directory.
ODSM is installed when you install Oracle Unified Directory, but ODSM must be configured when you have installed Oracle WebLogic Server and Oracle ADF.
Note:
The version of ODSM described in this document is 11g Release 2 (11.1.2.3). You can use ODSM version 11.1.2.3 to manage only Oracle Unified Directory 11g Release 2 (11.1.2.3.)You cannot use ODSM version 11.1.2.3 to manage previous versions of Oracle Unified Directory, Oracle Internet Directory, or Oracle Virtual Directory. Conversely, you cannot use versions of ODSM shipped with Oracle Internet Directory or Oracle Virtual Directory to manage any versions of 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 Oracle Unified Directory Installation Directories."
This section describes how to obtain the following software:
Notes:
If you are planning to manage Oracle Unified Directory using ODSM, you must also install Oracle WebLogic Server and Oracle ADF.
When you install Oracle Unified Directory, Oracle WebLogic Server, and Oracle ADF you must specify the same Middleware home directory. The examples in this chapter use path-to-mw-home/MW_HOME to represent the Middleware home directory.
To download the Oracle Unified Directory software from the Oracle Software Delivery Cloud:
Download the production distribution for Oracle Unified Directory from the Oracle Software Delivery Cloud.
If prompted, login, choose your language, and click Continue.
Enter Oracle Unified Directory in the type-ahead input field and click Search.
Select Oracle Unified Directory 11.1.2.3.0 from the list of available platforms.
After you have made your selection, the software title will immediately be placed into your Selected Software cart where you can assign a platform for each individual Release.
Click your Selected Software cart.
Select your platform from the Platform/Language drop-down list for Oracle Unified Directory 11.1.2.3.0 and click Continue.
Complete the Terms & Restrictions and Export License Agreement as instructed on the site and click Continue.
Click on the file name to download. Each file has a unique part number.
Browse to the directory where you want to save the file. Click Save to start the file download. A compressed ZIP file is downloaded.
Extract the contents of the ZIP file to a directory of your choice.
Note:
ODSM is also installed when you install the Oracle Unified Directory software. However, you must configure ODSM, as described in Section 2.3, "Configuring Oracle WebLogic Server for Oracle Directory Services Manager."If you are planning to configure and manage Oracle Unified Directory with ODSM, you must also install Oracle WebLogic Server (and Oracle ADF), as described in subsequent sections.
You can download the Oracle WebLogic Server 11g Release 1 (10.3.6) installation program from either of the following locations:
For more information, see:
Product distribution in the Oracle Fusion Middleware Installation Guide for Oracle WebLogic Server
Section 1.1, "Checking the System Requirements for Oracle Unified Directory"
To download the Oracle WebLogic Server installer from the Oracle Software Delivery Cloud:
Download the production distribution for Oracle Unified Directory from the Oracle Software Delivery Cloud.
If prompted, login, choose your language, and click Continue.
Enter Oracle WebLogic Server 10.3.6.0.0 in the type-ahead input field and click Search.
Select Oracle WebLogic Server 10.3.6.0.0 from the list of available platforms.
After you have made your selection, the software title will immediately be placed into your Selected Software cart where you can assign a platform for each individual Release.
Click your Selected Software cart.
Select your platform from the Platform/Language drop-down list for Oracle WebLogic Server 10.3.6.0.0 and click Continue.
Complete the Terms & Restrictions and Export License Agreement as instructed on the site and click Continue.
Click on the file name to download. Each file has a unique part number.
Browse to the directory where you want to save the file. Click Save to start the file download. A compressed ZIP file is downloaded.
Extract the contents of the ZIP file to a directory of your choice.
To download the Oracle WebLogic Server installer from the Oracle Technology Network:
Download the production distribution for Oracle WebLogic Server from the Oracle Technology Network.
Accept the OTN License Agreement.
Click a package of your choice under Oracle WebLogic Server 10.3.6.
Click OK to save the file.
Browse to the directory where you want to save the file. Click Save to start the file download. A compressed ZIP file is downloaded.
Extract the contents of the ZIP file to a directory of your choice.
If you are planning to configure and manage Oracle Unified Directory with ODSM, you must install Oracle ADF.
You can download Oracle ADF from the Oracle Technology Network (OTN) at the following location:
http://www.oracle.com/technetwork/developer-tools/adf/downloads/index.html
To install Oracle Unified Directory, complete the following steps:
Make sure you have obtained the software, as described in Section 2.1, "Obtaining the Software to Install Oracle Unified Directory."
Make sure you have a supported Java installation (JRE 7 or JDK 7) installed. See Section 1.3, "Setting the JAVA_HOME Environment Variable."
If you have not already done so, extract the contents of the .zip file, which contains only the appropriate Oracle Unified Directory installer executable for the selected platform. The installer is located in the .zip file part number directory.
Note:
If you are also planning to install Oracle WebLogic Server and Oracle ADF, you must specify the same Middleware home directory to install all three products.Use the cd command to move from your present working directory to the directory where you extracted the contents of the Oracle Unified Directory .zip file.
For example, to move to the Middleware home directory on UNIX and Linux systems:
$ cd path-to-mw-home/MW_HOME
Or, on Windows systems:
C:\>cd path-to-mw-home\MW_HOME
Start the Oracle Universal Installer (OUI) by running the runInstaller script (UNIX and Linux systems) or setup.exe script (Windows systems), specifying the location of a supported Java installation (JRE 7 or JDK 7).
Caution:
Do not run the Oracle Unified Directory installer as the root user on UNIX and Linux systems.On UNIX and Linux systems:
$ ./runInstaller -jreLoc path-to-JRE/JDK-directory
For example, using the JAVA_HOME environment variable:
$ ./runInstaller -jreLoc $JAVA_HOME
Or, on Windows systems:
C:\>setup.exe -jreLoc path-to-JRE/JDK-directory
For example:
C:\>setup.exe -jreLoc $JAVA_HOME
Note:
On Windows systems, if the path to your Java installation includes a space character, you must specify the path in DOS 8.3 format. For example:C:\>setup.exe -jreLoc C:\Progra~1\Java\jre1.7
Running the installer creates the Oracle_OUD1 directory under the Middleware home directory.
On UNIX and Linux 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:
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 home directories 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.
Enter the ID of a group that has write access to the inventory directory.
Click OK to continue. The Inventory Location Confirmation Dialog is displayed.
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.
When you have run the script, click OK on the Inventory Location Confirmation Dialog.
If you do not have root access to the system 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.
On the Welcome screen, click Next.
The Install Software Updates screen is displayed.
Select Skip Software Updates and click Next.
The Prerequisite Checks screen is displayed.
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.
The Specify Installation Location screen is displayed.
Enter the following information:
OUD Base Location Home: Specify a directory that you want to use as the Middleware home, which will include any Oracle Unified Directory instances that are configured at a later stage, unless you specify an alternate instance directory path. For example, /Oracle/MW_Home.
Oracle Home Directory. The Installer uses the name you enter in this field to create the Oracle home directory under the Middleware home 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.
The Installation Summary screen is displayed.
Verify the installation and configuration information.
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.
Click Next.
The Installation Complete screen is displayed.
Check the details of the installation and click Finish.
Tip:
After a successful installation, save the OUD Installation details in a text file for your future reference.After you have installed Oracle Unified Directory, you can configure a server instance as a directory server, proxy server, or replication gateway. For more information, see one of the following sections:
To set up a directory server, see Section 3, "Setting Up Oracle Unified Directory as a Directory Server."
To set up a proxy server, see Section 4, "Setting Up Oracle Unified Directory as a Proxy Server."
To set up a replication gateway, see Section 5, "Setting Up Oracle Unified Directory as a Replication Gateway."
An Oracle Unified Directory silent installation uses a set of responses that you provided in an earlier installation and thus does not require any user intervention.
To perform an Oracle Unified Directory silent installation:
Follow steps 1 through 9 of Section 2.2, "Installing Oracle Unified Directory."
Click Save on the Installation Summary screen.
Specify the location to which the response file should be saved, for example /tmp/oud-install.rsp (UNIX and Linux systems), and click Save.
When the response file has been saved, cancel the installation.
Run the following command to perform the silent installation:
On UNIX and Linux systems:
$ download-path/oud/Disk1/runInstaller -jreLoc $JAVA_HOME -silent -responseFile /tmp/oud-install.rsp
On Windows systems:
C:\>download-path\oud\Disk1\setup.exe -jreLoc $JAVA_HOME -silent -responseFile \tmp\oud-install.rsp
If you plan to manage Oracle Unified Directory with ODSM, you must install and configure Oracle WebLogic Server, by following these steps:
Installing Oracle Application Development Framework for Oracle WebLogic Server
Running Oracle Fusion Middleware Configuration Wizard to Create an Oracle WebLogic Domain
Accessing Oracle Directory Services Manager (ODSM) for Oracle WebLogic Server
Make sure you have obtained the required software, as described in Section 2.1, "Obtaining the Software to Install Oracle Unified Directory."
For information about preparing for installation and installing Oracle WebLogic Server, see the Oracle Fusion Middleware Installation Guide for Oracle WebLogic Server.
Notes:
You must install Oracle WebLogic Server as the same user who installed Oracle Unified Directory.
On UNIX and Linux systems, do not install Oracle WebLogic installer as the root user.
When you install WebLogic Server, you must use the same Middleware home directory that you used to install Oracle Unified Directory.
On the Choose Middle Home Directory screen, check Create a new Middleware Home and then specify the same Middleware home you used for Oracle Unified Directory. You can ignore the warning that this directory is not empty and click Yes to continue.
Installing WebLogic Server creates the wlserver_10.3 and coherence_3.7 directories under the Middleware home directory.
Oracle Directory Services Manager is a Java EE application that runs inside an Oracle WebLogic Server container and relies on certain libraries that are not installed with the Oracle Unified Directory software. These libraries are provided in Oracle ADF. If you plan to manage Oracle Unified Directory with ODSM, you must also install Oracle ADF.
For information about installing Oracle ADF, see the Oracle Fusion Middleware Installation Guide for Application Developer.
Notes:
You must install Oracle ADF as the same user who installed Oracle Unified Directory and WebLogic Server, which on Linux and UNIX systems is not the root user.
For the Oracle ADF Inventory Directory, specify the same directory you used for Oracle Unified Directory.
For the Oracle ADF Oracle Middleware Home, use the same Middleware home directory you used for Oracle Unified Directory and WebLogic Server.
If you do not use the same Middleware home directory, WebLogic Server will be grayed out in the subsequent Oracle ADF Application Server selection.
After a successful installation, click Save for Save Installation Details to save the information in a text file for your future reference.
After you install Oracle ADF, you are ready to create an ODSM instance, as described in the next section.
When you have installed Oracle ADF, you must create a new WebLogic domain for ODSM. The following procedure outlines the configuration on a UNIX or Linux system.
Run the configuration wizard from the following location:
$ path-to-mw-home/MW_HOME/oracle_common/common/bin/config.sh
On Windows systems, run the config.cmd script.
On the Welcome screen, select Create a new WebLogic domain and click Next.
The Select Domain Source screen is displayed.
Select the Oracle Directory Services Manager - 11.1.2.3.0 check box.
Note:
If Oracle WebLogic Server and Oracle Unified Directory do not share the same Middleware home directory, ODSM will not be available in the panel.When you select ODSM, Oracle JRF is automatically selected.
Click Next.
The Specify Domain Name and Location screen is displayed.
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.
Click Next.
The Configure Administrator User Name and Password screen is displayed.
Enter 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.
Click Next.
The Configure Server Start Mode and JDK screen is displayed.
Select Production Mode and a valid JDK.
Click Next.
The Optional Configuration screen is displayed.
Click Next.
The Configuration Summary screen is displayed.
Verify the domain details and click Create.
The Creating Domain Screen is displayed.
When the domain creation process completes, click Done to close the Configuration Wizard.
On Windows systems, to start the Administration Server after closing the Configuration Wizard, select the Start Admin Server check box. This check box is not available on UNIX and Linux systems.
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 and Linux systems.
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 4 of the previous procedure. For example:
$ OUD-Base-Location-Home/user_projects/domains/base_domain/bin/startWebLogic.sh
On Windows systems, run domain_home\startWebLogic.cmd.
The user name and password that are requested here correspond to those in Step 5 of the previous procedure.
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 administrative port for the WebLogic Administration Server.
Note:
Ensure that the Administration Server is up and running before you access ODSM. When the server successfully completes its startup process, it displays the following message:<Notice> <WebLogicServer> <BEA-000360> <Server started in RUNNING mode>
Oracle Directory Integration Platform is a Java EE application that enables you to integrate your applications and directories, including third-party LDAP directories, with Oracle Unified Directory.
Oracle Directory Integration Platform includes services and interfaces that allow you to deploy synchronization solutions with other enterprise repositories. It can also be used to provide Oracle Unified Directory interoperability with third party metadirectory solutions.
For example, in an Oracle Fusion Middleware environment, where access to Oracle components relies on data stored in an Oracle directory, you can still use Microsoft Active Directory as the central enterprise directory. Users of that directory can still access Oracle components because Oracle Directory Integration Platform can synchronize the data in Microsoft Active Directory with that in Oracle Unified Directory.
To configure Oracle Unified Directory, Oracle Directory Services Manager, Oracle Directory Integration Platform, and Fusion Middleware Control in an Oracle WebLogic Server domain, see the Oracle Fusion Middleware Installation Guide for Oracle Identity Management.