Installation Guides › 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/IdentityMinder.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