Configuration Guides › Federation Security Services Guide › Review the JVMOptions File Which Creates 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. SAML 1.x, SAML 2.0, and WS-Federation use this file.

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

The installed location of this file is:

policy_server_home/config/

Important! If you update the JVMOptions.txt file, 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 Policy Server is running, the Policy Server service fails because of a JVM issue. To prevent the failure, 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, 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.