Oracle® Fusion Middleware Installation Guide for Oracle Unified Directory 11g Release 2 (11.1.2) Part Number E23737-02 |
|
|
PDF · Mobi · ePub |
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:
Section 2.1, "Getting the Oracle Unified Directory Software"
Section 2.4, "Installing the Oracle Application Development Framework"
Section 2.5, "Configuring WebLogic Server for Oracle Directory Services Manager"
You can obtain Oracle Unified Directory, Oracle WebLogic Server, and the Oracle Application Development Framework by using one of the following methods:
Oracle Technology Network (OTN) (http://www.oracle.com/technetwork/index.html
)
Oracle Software Delivery Cloud (https://edelivery.oracle.com
)
The ODSM software is installed when you install Oracle Unified Directory.
Download the Oracle Unified Directory zip file (oud.zip
) from OTN or Oracle Software Delivery Cloud.
Unzip the Oracle Unified Directory zip file:
$ cd download-path
$ unzip oud.zip
Change to the Disk1 directory.
$ cd download-path/oud/Disk1
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.
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:
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.
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 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
.
On the Welcome screen, click Next.
On the Install Software Updates screen, select Skip Software Updates and click Next.
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.
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.
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.
On the Installation Progress screen, click Next.
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".
Instructions for setting up the directory server are described in Chapter 3, "Setting Up the Directory Server".
Instructions for setting up the proxy server are described in Chapter 4, "Setting Up the Proxy Server".
Instructions for setting up the replication gateway are described in Chapter 5, "Setting Up the Replication Gateway".
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:
Click Save on the Installation Summary screen.
Specify the location to which the response file should be saved, for example /tmp/oud-install.rsp
, and click Save.
When the response file has been saved, cancel the installation.
Run the following command to perform the silent installation:
$ download-path/oud/Disk1/runInstaller -jreLoc JAVA_HOME -silent -responseFile /tmp/oud-install.rsp
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.
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.
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
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.
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.
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.
On the Choose Install Type screen, select Typical and click Next.
On the JDK Selection screen, select a valid JDK.
On the Choose Product Installation Directories screen, verify the location for the WebLogic Server Installation and click Next.
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.
Click Next on the Installation Summary screen.
On the Installation Complete screen, de-select Run Quickstart and click Done to exit the Installer.
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.
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.
Unzip the Oracle Application Development Framework zip file:
$ cd download-path
$ unzip ofm_appdev_generic_11.1.1.6.0_disk1_1of1.zip
Change to the Disk1 directory.
$ cd download-path/appdev/Disk1
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
If this is the first time an Oracle product is being installed on the system, specify the inventory directory.
On the Welcome screen, click Next.
On the Install Software Updates screen, select Skip Software Updates and click Next.
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.
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
.
On the Application Server screen, WebLogic Server should be selected by default. Click Next.
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.
On the Installation Progress screen, click Next.
On the Installation Complete screen, check the details of the installation and click Finish.
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.
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.
On the Welcome screen, select Create a new WebLogic domain and click Next.
On the Select Domain Source screen, select the Oracle Directory Services Manager check box.
Oracle JRF is selected automatically.
Click Next.
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.
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.
On the Configure Server Start Mode screen, select Production Mode.
Select a valid JDK and click Next.
On the Optional Configuration screen, click Next.
On the Configuration Summary screen, verify the domain details and click Create.
On the Creating Domain Screen, click Done.
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.
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.
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.