4 Installing and Configuring JBoss Application Server in Nonclustered Mode

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

You must perform the following tasks described in this chapter:

• Installing the Java JDK

• Installing JBoss Application Server

• Setting Memory Parameters

Note:

See Chapter 5, "Installing and Configuring JBoss Application Server in Clustered Mode" for information about preparing to deploy Oracle Identity Manager in a JBoss Application Server cluster.

4.1 Installing the Java JDK

You must have a certified version of the Java JDK installed to deploy Oracle Identity Manager on JBoss Application Server. See Oracle Identity Manager Readme for information about the certified versions of Java JDK. Then, perform 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. Run the java -version command.

   The output of the command is similar to the following:

   C:\>java -version
   java version "1.6.0_10"
   Java(TM) 2 Runtime Environment (build 1.6.0_10-b33)
   Java HotSpot(TM) Client VM (build 11.0-b15, mixed mode, sharing) 
   

4.2 Installing JBoss Application Server

Install JBoss Application Server on the computer on which you are going to install Oracle Identity Manager. See the JBoss Application Server documentation for detailed information about installation.

Note:

You can download the JBoss Application Server installation package from the JBoss Web site:

http://www.jboss.org

4.2.1 Setting Environment Variables

Perform the following procedure to set environment variables:

For Microsoft Windows

To set environment variables on Microsoft 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 the JDK to the beginning of the existing path. For example, suppose the existing path is the following:

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

   Change it to the following:

   c:\jdk1.6.0_10\bin;%SystemRoot%\system32;%SystemRoot%;C:\Program Files
   

   Click OK to commit the change.

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

   1. If JAVA_HOME does not exist:

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

   2. If JAVA_HOME exists, then:

      Click Edit. Verify that the path to the JDK exists in the Variable Value field. If it does not exist, enter the path 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, respectively.

      For example: JAVA HOME=C:\jdk1.6.0_10

      Note:

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

For UNIX

To set environment variables on UNIX:

1. Set the JAVA HOME variable, for example:

   export JAVA_HOME=/opt/jdk1.6.0_10
   

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

   export PATH=$JAVA_HOME/bin:$PATH
   

4.3 Setting Memory Parameters

After installing JBoss Application Server, you must change the JVM memory settings for production environments or when you are processing large volumes in the nonproduction mode of the Oracle Identity Manager installation. The instructions for setting memory parameters are discussed in the following sections:

• Setting Memory Allocation for Microsoft Windows

• Setting Memory Allocation for UNIX

4.3.1 Setting Memory Allocation for Microsoft Windows

To set JBoss Application Server memory on a Microsoft Windows host:

1. Open the JBOSS_HOME\bin\run.bat file in a text editor.

2. Locate the following line:

   set JAVA_OPTS=%JAVA_OPTS% -Xms128m -Xmx512m
   

3. Change the memory settings to the following values, which are recommended for production deployments:

   set JAVA_OPTS=%JAVA_OPTS% -XX:PermSize=128M -XX:MaxPermSize=256M -ms1280M -mx1280M
   

4. Save and close the run.bat file.

4.3.2 Setting Memory Allocation for UNIX

To set the memory allocation for JBoss Application Server on UNIX:

1. Open the JBOSS_HOME/bin/run.conf file in a text editor.

2. Locate the following text:

   -Xms128m -Xmx512m
   

3. Change the text to the following.

   Note:

   These values are recommended for production deployments.

   $JAVA_OPTS -XX:PermSize=128M -XX:MaxPermSize=256M -Xms1280m -Xmx1280m
   

4. Save and close the run.conf file.