Installation Guide › JBoss Version › CA Identity Manager as a Windows Service › Configure the Java Service Wrapper

Configure the Java Service Wrapper

The libraries, classes, and parameters for CA Identity Manager must be configured in the Java Service Wrapper configuration file:

 jboss_home\conf\wrapper.conf 

Note: Property values that are paths to directories or files should not be enclosed in quotation marks. Forward (/) or back-slashes (\) can be used as a path separator.

Local Environment Variables

Several local environment variables will be created in order to simplify later configuration and to prevent the default ability of the Java Service Wrapper to use the %PATH% from the environment. Careful inspection of the run-idm.bat file will reveal that the %PATH% is carefully constructed in order to eliminate any SiteMinder library version conflicts. These variables are not system-wide and will only be available for the JVM created by the Java Service Wrapper. Some system-wide environment variables are used in the creation of these local variables.

Add the following properties to the beginning of wrapper.conf before any other properties:

• set.JAVA_HOME=[JAVA_HOME from run-idm.bat]

  Example: set.JAVA_HOME=C:\CA\j2sdk1.4.2_14

• set.NETE_SPS_PATH=[resolved NETE_SPS_PATH from run-idm.bat]

  Example: set.NETE_SPS_PATH=C:\CA\eTrust SiteMinder\agentframework\bin

• set.IM_EAR=../server/default/deploy/iam_im.ear
• set.SYSTEM_PATH=%SystemRoot%\SYSTEM32;%SystemRoot%;%SystemRoot%\SYSTEM32\WBEM
• set.PATH=%IGW_LOC%;%NETE_SPS_PATH%;%NETE_PS_PATH%;%IM_EAR%/library;%SYSTEM_PATH%

Java Executable

During the CA Identity Manager installation, a java SDK was selected and was used to set the JAVA_HOME variable at the top of jboss_home\bin\run-idm.bat. The local environment variable for this location is used in the following property:

wrapper.java.command=%JAVA_HOME%\bin\java

Java Classpath

Create all java classpath entries populated in jboss_home\bin\run.bat. Also, include the Java Service Wrapper classes in the classpath that are used within the JVM. That list is as follows, taking advantage of local environment variables created previously:

• wrapper.java.classpath.1=../lib/wrapper.jar
• wrapper.java.classpath.2=%JAVA_HOME%\lib\tools.jar
• wrapper.java.classpath.3=./run.jar

Java Library Path

Add the required libraries for JBoss to the library path and the environment path that were created previously:

• wrapper.java.library.path.1=../lib
• wrapper.java.library.path.2=../server/default/lib
• wrapper.java.library.path.3=%PATH%

Java Arguments

Create the Java arguments that are populated in jboss_home\bin\run-idm.bat and jboss_home\bin\run.bat. That list is as follows, taking advantage of local environment variables created previously and excluding memory settings that will be configured separately:

• wrapper.java.additional.1=-server
• wrapper.java.additional.2=-Dprogram.name=run.bat
• wrapper.java.additional.4=-Djava.security.policy=.\workpoint_client.policy
• wrapper.java.additional.5=-XX:MaxPermSize=128m

Java Memory Sizes

Set the JVM memory settings as follows:

• wrapper.java.initmemory=256
• wrapper.java.maxmemory=512

Main Class

Specify the main class that the Java Service Wrapper should be called as follows:

wrapper.app.parameter.1=org.jboss.Main

Java Service Wrapper Logging

The location of the log file for the Java Service Wrapper will default to jboss_home/logs/wrapper.log. Settings can be changed as described in the wrapper.conf file.

Windows Service Names

Specify the names to be used for the Windows Service as follows:

• wrapper.ntservice.name=CAIdentityManager
• wrapper.ntservice.displayname=CA Identity Manager
• wrapper.ntservice.description=CA Identity Manager