3 Installing and Configuring Oracle Application Server for Oracle Identity Manager

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

• Installing Oracle Application Server

• Setting the RMI Port Number Range

• Setting Environment Variables

• Verifying the Java JDK Version

Installing Oracle Application Server

When you run the Oracle SOA Suite installer program you must choose the Advanced Install option and choose only the J2EE Server and Web Server option on the Select Installation Type screen. No other installation type will support Oracle Identity Manager Release 9.0.3—you must choose the J2EE Server and Web Server option. After the installer finishes, the OC4J instance within your Oracle Application Server instance starts automatically.

Setting the RMI Port Number Range

The Oracle Process Manager and Notification server (OPMN) dynamically assigns port numbers to each OC4J instance within your Oracle Application Server instance. To ensure you can access the Oracle Identity Manager Design Console and Administrative and User Console on Oracle Application Server, you must set the RMI port number range to be unique in the <ORACLE_HOME>/opmn/conf/opmn.xml file. Perform the following steps to set a unique RMI port number range:

1. Open the <ORACLE_HOME>/opmn/conf/opmn.xml file with a text editor.

2. Locate the <port id="rmi" range="12401-12500"/> entry for the instance you will install Oracle identity Manager on.

3. Set the port number in the range to be a port within the OC4J range, for example:

   <port id="rmi" range="12408"/>
   

   Note:

   When you install Oracle Identity Manager, on the installer's Application Server Information page, you must enter this RMI port number you set in the opmn.xml file in the RMI Port No field.

4. Save and close the opmn.xml file.

For Oracle Application Server clusters, repeat these steps on each node in the cluster so that each opmn.xml file contains the same unique port number.

Setting Environment Variables

After you have verified that Oracle Identity Manager is using the JDK included with Oracle 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:

   <ORACLE_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, for example: <ORACLE_HOME>\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, for example: <ORACLE_HOME>\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.3 for Oracle Application Server requires that you use the JDK included with Oracle Application Server.

Verifying the Java JDK Version

Oracle Identity Manager for Oracle Application Server requires that you use the JDK included with Oracle Application Server. Remove any other 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)