Fine-tuning JVM options
Edit the JVM options jvm-memory.options
file to customize minimum and maximum heap sizing, garbage collection, and generation specific sizing for your memory use and to optimize PingFederate’s performance.
About this task
PingFederate reads Java virtual machine (JVM) options from the jvm-memory.options
file, located in the <pf_install>/pingfederate/bin
directory. Any manual modifications or additions should be made in this file. For more information on JVM tuning options, see HotSpot Virtual Machine Garbage Collection Tuning Guide in the Oracle documentation.
Before making any edits to the file, consider the following:
|
Steps
-
Edit the
<pf_install>/pingfederate/bin/jvm-memory.options
file. -
To add additional JVM options, insert the applicable options to the file.
Example:
For example, to enable the aggressive options flag, configure the file as follows.
... # Enable the aggressive options flag -XX:+AggressiveOpts
The comment is optional.
-
When finished, save your changes.
-
If PingFederate is configured to run as a service on a Windows server, follow these steps:
-
Open command prompt and go to the
<pf_install>/pingfederate/sbin/wrapper
directory. -
Run
generate-wrapper-jvm-options.bat
.Result:
This helper utility reads the JVM options from the
jvm-memory.options
file and creates a resource file that the PingFederate Windows service requires to configure its JVM options. -
Close the command prompt.
-
-
Restart PingFederate.
-
For a clustered PingFederate environment, repeat these steps on each engine node as needed.