Federation Security Services Guide › Review the JVMOptions File Used to Create a JVM › The JVMOptions.txt File

The JVMOptions.txt File

The JVMOptions.txt file contains the settings that the Policy Server uses when creating the Java Virtual Machine that is used to support Federation Web Services. This file is used by SAML 1.x, SAML 2.0, and WS-Federation.

Note: In most situations, you will not need to change this file.

The installed location of this file is:

policy_server_home/config/

Important! If you make changes to the JVMOptions.txt file, you must restart the Policy Server for the changes to take effect. Restart the server from the command line or from the Policy Server Management Console.

To stop and start the Policy Server, use the Policy Server Management Console.

Notes:

• In some environments, when you log off from a system where the SiteMinder Policy Server service is running, the Policy Server service fails because of a JVM issue. To prevent this issue from occurring, add the -Xrs command to its own command line in the JVMOptions.txt file. This java command reduces usage of operating system signals by the Java virtual machine.

  This command is case-sensitive so be sure to capitalize the X.

• If you encounter errors relating to missing classes, you may need to modify the classpath directive in this file. For complete information about the settings contained in the JVMOptions.txt file, see your Java documentation. The Java compiler directive java.endorsed.dirs is used in the JVMOptions.txt file to control class loading.