3 Installing and Configuring JBoss for Oracle Identity Manager

This chapter explains how to set up JBoss before installing Oracle Identity Manager.

You must perform the following tasks described in this chapter:

• Installing the Java JDK

• Installing JBoss

• Setting Memory Parameters

Note:

See Chapter 9, "Deploying in a Clustered JBoss Configuration" for information about preparing to deploy Oracle Identity Manager in a JBoss cluster.

Installing the Java JDK

You must have a certified version of the Java JDK installed to deploy Oracle Identity Manager on JBoss. Refer to the Oracle Identity Manager Release Notes to learn the certified version of the Java JDK and then use the following steps to verify that the correct version of the Java JDK has been installed on the system:

1. Open a console window.

2. Enter java -version

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

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

Installing JBoss

Install JBoss on the computer where you are going to install Oracle Identity Manager. Consult your JBoss application server documentation for detailed installation procedures.

Note:

You can obtain JBoss from: http://www.jboss.org

Setting Environment Variables

Perform the following procedures to set your environment variables:

Windows

To set environment variables on windows:

1. From the Windows Start Menu, select Settings, select Control Panel, select System, select Advanced, then select Environment Variables.

2. In the System Variables list, select Path, then click Edit.

   In the Variable Value field, 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:

   c:\j2sdk1.4.2_12\bin;%SystemRoot%\system32;%SystemRoot%;C:\Program Files
   
   

   Click OK to commit your change.

3. In the System Variables list, search for JAVA_HOME.

   If JAVA_HOME does not exist, complete Step a. If JAVA_HOME does exist, complete Step b.

   1. Click New. In the Variable Name field, enter JAVA_HOME. In the Variable Value field, enter the path to your JDK. Click OK to commit your entries, then click OK twice more to close the Environment Variables and System Properties windows.

   2. Click Edit. Verify the path to your JDK exists in the Variable Value field. If the path to your JDK does not, enter the path to your JDK in the Variable Value field. Click OK to commit your entry, then click OK twice more to close the Environment Variables and System Properties windows.

      For example: JAVA HOME=C:\jdk142_12

      Note:

      A window may appear displaying a message asking if you want to update the JDK. Close this window without updating the JDK.

UNIX and Linux

To set environment variables on UNIX and Linux:

1. Set the JAVA HOME variable, for example:

   export JAVA_HOME=/opt/jdk142_12
   
   

2. Export the path to the JAVA HOME variable, for example:

   export PATH=$<JAVA_HOME>/bin:$PATH
   
   

Setting Memory Parameters

After installing JBoss, configure the memory allocation for JBoss. The instructions for setting the memory parameters, which appear in the following sub-sections, depend on whether the application server host is running on Windows, or on UNIX or Linux.

Setting Memory Allocation for Windows

To set JBoss memory on a Windows host:

1. Launch a plain-text editor and open the <JBOSS_HOME>\bin\run.bat file.

2. Locate the line that contains the following:

   set JAVA_OPTS=%JAVA_OPTS% -Xms128m -Xmx512m
   
   

3. If necessary, uncomment this line, then change the minimum value to 512 MB and the maximum value to 1024 MB. The altered line should now read as follows:

   set JAVA_OPTS=%JAVA_OPTS% -Xms512m –Xmx1024m
   
   

4. Save and close the run.bat file.

Setting Memory Allocation for UNIX or Linux

To set the memory allocation for JBoss on UNIX or Linux:

1. Open the <JBOSS_HOME>/bin/run.sh file in a text editor.

2. Locate the following line:

   JAVA_OPTS="$JAVA_OPTS -Dprogram.name=$PROGNAME" 
   
   

3. Add the following new line immediately after the line shown in the preceding step:

   JAVA_OPTS="$JAVA_OPTS -Xms512m -Xmx1024m"
   
   

4. Save and close the run.sh file.