3 Installing and Configuring OC4J for Oracle Identity Manager

This chapter explains how to set up OC4J before installing Oracle Identity Manager and contains the following topics: You must perform the following tasks:

• Verifying the Java JDK Version

• Setting Environment Variables

• Installing OC4J

• Installing OC4J JDBC Drivers

Verifying the Java JDK Version

Oracle Identity Manager Release 9.0 for the OC4J application server requires that you use the JDK included with OC4J, which is version 1.5.0_06. Remove any older JDK versions from your system.

The following procedure explains how to verify that the correct version of the Java JDK will be used by Oracle Identity Manager. To verify on a Windows system:

1. Open a console window.

2. Enter java -version

   For example, the information that appears should look like the following:

   C:\>java -version
   java version "1.5.0_06"
   Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_06-b05)
   Java HotSpot(TM) Client VM (build 1.5.0_06-b05, mixed mode) 
   
   

Setting Environment Variables

After you have verified that Oracle Identity Manager is using the JDK included with the OC4J application server (refer to "Verifying the Java JDK Version" for more information), complete the following steps to set your environment variables:

Note:

The following instructions are for Windows. For UNIX or Linux, use the equivalent shell variable commands and settings.

1. From the Windows Start Menu, select Settings, select Control Panel, select System, select Advanced, then select Environment Variables. In the scroll box labelled System Variables, select Path, then click Edit.

   In the text box labelled Variable Value, add the location of your JDK to the beginning of the existing path. For example, if your existing path is the following:

   %SystemRoot%\system32;%SystemRoot%;C:\Program Files;
   
   

   Change it to the following:

   <OC4J_HOME>\jdk\bin;%SystemRoot%\system32;%SystemRoot%;C:\Program Files
   
   

   Click OK to commit your change.

2. In the scroll box labelled System Variables, search for JAVA_HOME. If it does not exist, complete Step a. If JAVA_HOME does exist, complete Step b.

   1. Click New. In the text box labelled Variable Name, enter JAVA_HOME. In the text box labelled Variable Value, enter the path to your JDK. Click OK to commit your entry, then click OK twice more to close the Environment Variables and System Properties dialogs, respectively.

   2. Click Edit. Verify that the path to your JDK exists in the text box labelled Variable Value. If it does not exist, set Variable Value to the path for your JDK. Click OK to commit your entry, then click OK twice more to close the Environment Variables and System Properties dialogs, respectively.

      Note:

      A message may appear displaying a message asking if you want to update the JDK. Close this window without updating the JDK, as Oracle Identity Manager Release 9.0 for OC4J requires that you use the JDK included with OC4J.

Installing OC4J

Perform the following steps to install OC4J for Oracle Identity Manager:

1. Install OC4J on the computer where you are going to install Oracle Identity Manager by using the OC4J application server documentation. After OC4J installs on the system, it will start automatically.

2. Stop OC4J.

3. Set the ORACLE_HOME system variable to the following:

   c:\product\10.1.3.1\OracleAS_n
   

   Note:

   n is a variable that changes after each OC4J installation on the system. For example, if you have installed OC4J twice on the system, n will be 2.

4. Start the OC4J application server.

Installing OC4J JDBC Drivers

You must install the latest OC4J JDBC drivers before installing Oracle Identity Manager on OC4J. The following is a list of the OC4J JDBC drivers required for Oracle Identity Manager on OC4J:

• ojdbc14.jar

• ojdbc14_g.jar

• ojdbc14dms.jar

• ojdbc14dms_g.jar

• orail8n.jar

Use the following steps to acquire and apply the latest OC4J JDBC drivers:

1. Log in to Oracle Technology Network at the following URL:

   http://www.oracle.com/technology/index.html

2. Select Downloads from the horizontal menu at the top of the page.

3. In the Drivers section, select JDBC.

4. Select the Oracle Database 10g Release 2 (10.2.0.1.0) drivers option and accept the terms and conditions to download the drivers.

5. Use the following steps to install the OC4J JDBC drivers:

   1. Log in to the Oracle Enterprise Manager 10g Application Server Control

   2. Select Home from the Members section.

   3. Select Administration from the horizontal navigation at the top.

   4. Select the Shared Libraries: Manage the shared libraries of this OC4J instance option in the Administration Tasks section.

   5. Click Create on the Shared Libraries page.

   6. Enter oracle.jdbc as the name for the shared library and 10.2.0.1.0 (or higher) as the shared library version. Click Next.

   7. Click Add on the Create Shared Library: Add Archives page and browse to the location of the OC4J JDBC files. Select one of the OC4J JDBC files.

   8. Click Continue and repeat Step g until you add all OC4J JDBC files.

   9. Click Finish on the Create Shared Library: Add Archives page to install all the OC4J JDBC drivers.

After installing the OC4J JDBC drivers, the following is added to the <OC4J_HOME>/j2ee/home/config/server.xml file on UNIX or Linux, or to the <OC4J_HOME>\j2ee\home\config file on Windows:

<shared-library name="oracle.jdbc" version="10.2.0.1.0">
    <code-source path="ojdbc14.jar"/>
    <code-source path="ojdbc14_g.jar"/>
    <code-source path="ojdbc14dms.jar"/>
    <code-source path="ojdbc14dms_g.jar"/>
    <code-source path="orai18n.jar"/>
</shared-library>