2 Installing the Oracle Unified Directory Software
Oracle Unified Directory primarily supports two domain configurations. You can install Oracle Unified Directory either as a collocated configuration that is managed through a WebLogic server or as a standalone configuration.
Topics:
2.1 Before You Install Oracle Unified Directory
You can manage Oracle Unified Directory either from the command line or by using the Oracle Unified Directory Services Manager (OUDSM) graphical user interface.
Oracle Unified Directory Services Manager (OUDSM) requires Oracle WebLogic Server and Oracle ADF, so if you plan to use OUDSM, you must install Oracle Unified Directory in a Collocated Oracle Unified Directory Server (Managed through WebLogic server) mode. When you configure Oracle Unified Directory in a WebLogic Server domain, the Oracle Unified Directory instances can be managed like any other elements of the WebLogic Server domain. To configure Oracle Unified Directory in a WebLogic Server domain, you must install the Oracle Unified Directory software in an existing Oracle Fusion Middleware Infrastructure Oracle home.
You can also install Oracle Unified Directory in a Standalone Oracle Unified Directory Server (Managed independently of WebLogic server) mode. A standalone Oracle Unified Directory is not managed by or registered to a WebLogic Server domain. A standalone Oracle Unified Directory 12c (12.2.1.4.0) topology is installed and configured without the Oracle Fusion Middleware Infrastructure. You install the Oracle Unified Directory software in its own Oracle home and you configure the Oracle Unified Directory instance in its own standalone domain. You can use OUDSM installed in a different location or host to manage Oracle Unified Directory that is installed in a standalone mode.
Note:
The product templates for OUD and OUDSM are not interrelated; they are independent of each other. Hence, you can configure OUD and OUDSM independently in separate domains. So, it is possible to have OUD in collocated mode without OUDSM and also you can configure OUDSM alone in a domain without OUD.
You can upgrade Oracle Unified Directory from Oracle Unified Directory Release 12c (12.2.1.3.0) to 12c (12.2.1.4.0). See Updating the Oracle Unified Directory Software.
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 Understanding the Oracle Unified Directory Installation Directories.
2.2 Installing the Java Development Kit
The installation of Oracle Unified Directory 12c (12.2.1.4.0) requires Java Development Kit (JDK) 1.8.
The archive binary file (.tar.gz
) can be installed by anyone (not only root users), in any location that you can write to. However, only the root user can install the JDK into the system location.
For the system requirements and instructions to install JDK, see JDK Installation for Linux Platforms and JDK Installation for Microsoft Windows.
2.3 Setting the JAVA_HOME Environment Variable
After installing the Java Development Kit (JDK), you must set the JAVA_HOME
environment variable to point to the Java installation directory.
The setup scripts will not work if the JAVA_HOME
environment variable is not set or does not point to a supported Java installation (JDK 8).
For example, on UNIX or Linux systems, run a command similar to the following, depending on your shell:
JAVA_HOME=/usr/lang/JAVA/jdk1.8.0_191 export JAVA_HOME
To set the JAVA_HOME environment variable on Windows systems:
2.4 Setting the PATH Environment Variable
After installing the Java Development Kit, you must set the PATH
environment variable to point to the Java installation directory.
For example, on UNIX or Linux systems, run a command similar to the following, depending on your shell:
JAVA_HOME=/usr/lang/JAVA/jdk1.8.0_191 export JAVA_HOME PATH=$JAVA_HOME/bin:$PATH export PATH
For more information on how to set the PATH environment variable on Windows systems, see How do I set or change the PATH system variable?.
2.5 Obtaining Product Distributions
Oracle provides multiple locations for downloading Oracle Unified Directory and the software it requires.
-
Downloading the Oracle Fusion Middleware Infrastructure Distribution
-
Downloading the Oracle Unified Directory Distribution from OSDC
-
Downloading the Oracle Unified Directory Distribution from OTN
Note:
-
If you are planning to manage Oracle Unified Directory using Oracle Unified Directory Services Manager, you must first install the Oracle Fusion Middleware Infrastructure.
-
When you install Oracle Unified Directory and Oracle Fusion Middleware Infrastructure, you must specify the same Oracle Home directory. The examples in this chapter use
path-to-oracle-home
/ORACLE_HOME
to represent the Oracle Home directory.
2.5.1 Downloading the Oracle Fusion Middleware Infrastructure Distribution
If you are planning to configure and manage Oracle Unified Directory with OUDSM, you must also install Oracle WebLogic Server and Oracle Application Development Framework. The Oracle Fusion Middleware Infrastructure includes several products and feature sets including Oracle WebLogic Server and Oracle ADF.
To download the Oracle Fusion Middleware Infrastructure distribution:
- Download the Oracle Fusion Middleware Infrastructure distribution from the Oracle ADF download page. In the Oracle ADF Downloads section, select 12.2.1.4 from the Application Development Runtime field. Click Download File.
- When your browser asks to download the
.zip
file, save this file onto your system. - Extract the
.zip
file contents onto your system. The extracted filefmw_12.2.1.4.0_infrastructure_generic.jar
runs the product installer and installs the software onto your system.
2.6 Installing and Configuring OUD/OUDSM Domains
You can either install and configure both OUD and OUDSM in a single domain or OUD and OUDSM independently in separate domains.
Topics:
2.6.1 Installing the OUD/OUDSM Software
You can install OUD and OUDSM independently in separate domains or both in a single domain. This section describes how to install OUD and OUDSM.
2.6.1.1 Installing Oracle Fusion Middleware Infrastructure
The installation of Oracle Fusion Middleware Infrastructure is a prerequisite if you are planning to configure and manage Oracle Unified Directory with Oracle Unified Directory Services Manager. Since OUDSM requires Oracle WebLogic Server and Oracle ADF, the installation of Oracle Fusion Middleware Infrastructure takes care of the installation of WebLogic Server, ADF, and other infrastructure components.
If you are planning to configure and manage Oracle Unified Directory with Oracle Unified Directory Services Manager, you must install Oracle Unified Directory in a Collocated Oracle Unified Directory Server (Managed through WebLogic server) mode.
To install Oracle Fusion Middleware Infrastructure:
2.6.1.2 Installing Oracle Unified Directory
You can install Oracle Unified Directory in two ways depending on how you want to manage it. If you plan to manage OUD through WebLogic server or OUDSM, you must install OUD in collocated mode or a single domain. However, if you plan to manage OUD independently of WebLogic server, you must choose the standalone mode or separate domains.
To install Oracle Unified Directory:
2.6.2 Configuring OUD and OUDSM in Separate Domains
After the product installation is complete, you can start the process of domain creation. You can configure OUD and OUDSM in separate domains.
Note:
This is the Oracle preferred approach to set up domains for OUD and OUDSM. If you follow this approach, you can create a domain for OUDSM without depending on Oracle database.
2.6.2.1 Configuring a Domain for OUD Using the Configuration Wizard
You can configure a domain for OUD either by creating a new domain or by extending an existing domain using the Fusion Middleware Configuration Wizard.
To either create a new domain or update an existing domain for OUD:
2.6.2.2 Creating a Domain for OUDSM Using the WebLogic Scripting Tool
You can create a domain for OUDSM without depending on the Oracle Database or the Repository Creation Utility (RCU) using the WLST command.
Note:
This is the Oracle preferred approach to set up a domain for OUDSM. It is recommended not to extend this domain with any other products or components. In this approach, you do not have to run config.sh
.
To set up the OUDSM domain using the WLST:
2.6.3 Configuring OUD and OUDSM in a Single Domain
You can configure OUD and OUDSM in a single WebLogic domain if you have selected Collocated Oracle Unified Directory Server (Managed through WebLogic server) as the installation type.
You can also configure the WebLogic domain for OUDSM using the Fusion Middleware Configuration Wizard. Since the configuration wizard only supports Oracle Platform Security Services (OPSS) DB store, therefore, OUDSM relies on a DB-based OPSS security store for storing the administrator configurations securely.
Before running config.sh
to set up OUDSM, you must first install and configure a certified database. To use a database repository for the OPSS security store, you must use the Repository Creation Utility (RCU) to create the required schema and to seed some initial data.
2.6.3.1 Creating Database Schemas for the Infrastructure Domain Using the Repository Creation Utility
After Oracle Fusion Middleware Infrastructure is installed, start Repository Creation Utility (RCU) from the ORACLE_HOME/oracle_common/bin
directory. The Repository Creation Utility enables you to create database schemas that are required for Oracle Fusion Middleware products.
Note:
This database schema creation procedure is required only if you are planning to install the Oracle Unified Directory Services Manager (OUDSM) by selecting the OUDSM template.
To create schemas using the Repository Creation Utility:
2.6.3.2 Configuring OUD/OUDSM Domain Using the Configuration Wizard
You can configure a domain for OUD/OUDSM either by creating a new domain or by extending an existing domain using the Fusion Middleware Configuration Wizard.
Note:
If you are updating an existing domain to add OUD (for example, adding OUD to a DIP Domain), then the Configuration Wizard screens documented at steps 4 and 5 are not actually displayed and it skips straight to the Database Configuration Type page (step 6).To create a new domain or extend an existing domain for OUD/OUDSM:
2.7 Starting the Administration Server
After the WebLogic domain configuration is complete, you can start the Administration Server to manage the domain. OUDSM also uses this WebLogic Admin Server, so once the Admin Server is up and running, OUDSM is also effectively running as well.
To start the Administration Server:
2.9 Performing an Oracle Unified Directory Silent Installation
Silent installation eliminates the need to monitor your product installation because no graphical output is displayed and no input by the user is required.
To perform an Oracle Unified Directory silent installation:
2.10 Configuring Oracle Unified Directory with Oracle Directory Integration Platform
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 Oracle Unified 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 Unified Directory Services Manager, Oracle Directory Integration Platform, and Fusion Middleware Control in an Oracle WebLogic Server domain, see Configuring Oracle Unified Directory in Administrator's Guide for Oracle Directory Integration Platform.