4 Installing and Configuring JBoss for Oracle Identity Manager

This chapter explains how to set up JBoss before for Oracle Identity Manager. You must perform the following tasks:

1. Install the Java JDK—see "Installing the Java JDK" for more information.

2. Install JBoss—see "Installing JBoss" for more information.

3. Set memory parameters—see "Setting Memory Parameters" for more information.

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

Installing the Java JDK

To use JBoss with Oracle Identity Manager, you must have j2sdk1.4.2_08 or higher already installed on your computer.

To verify that the correct version of the Java JDK has been installed on your machine, complete the following steps:

1. Open a console window.

2. Type java -version

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

   C:\>java -version
   java version "1.4.2_08"
   Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.
   Java HotSpot(TM) Client VM (build 1.4.2_08-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 a copy of JBoss 4.0.2 from: http://www.sourceforge.net

Setting Environment Variables

After you have verified that j2sdk1.4.2_08 or higher is installed on your computer, complete the following steps to set your environment variables:

Note: The following instructions are for Windows. For 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 end of the existing path.

   For example, if your existing path is something like the following:

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

   You change it to something like the following:

   c:\j2sdk1.4.2_08\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, type JAVA_HOME, In the text box labelled Variable Value, type 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, 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 pop-up window may appear displaying a message asking if you want to update the JDK. Close this window without updating the JDK, since you previously verified that j2sdk1.4.2_08 or higher is installed on your computer.

      
      

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 Windows or Linux.

Setting Memory Allocation for Windows

To set JBoss memory on a Windows host, complete the following steps:

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 Linux

To set the memory allocation for JBoss on Linux, complete the following steps:

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

2. Locate the commented line that contains:

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

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

   JAVA_OPTS="$JAVA_OPTS -Xms512m -Xmx1024mÓ 
   
   

4. Save and close the run.sh file.