Fine-tuning JVM options - PingFederate - 11.3

PingFederate Server

bundle
pingfederate-113
ft:publication_title
PingFederate Server
Product_Version_ce
PingFederate 11.3 (Latest)
category
Administrator
Administratorguide
Audience
Capability
ContentType
DeploymentMethod
Guide
Product
Productdocumentation
SingleSignonSSO
Software
SystemAdministrator
pf-113
pingfederate
ContentType_ce
Guide
Guide > Administrator Guide
Product documentation

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.

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.
Remember:
Before making any edits to the file, consider the following:
  • Make a backup copy prior to any manual edits.
  • The empty lines and comments, indicated by a leading # character, are ignored.
  • JVM options do not need a specific organization or order.
  • You can add any JVM flag to the file to configure and customize the JVM, not just memory-related options.
  1. Edit the <pf_install>/pingfederate/bin/jvm-memory.options file.
  2. To add additional JVM options, insert the applicable options to the file.

    For example, to enable the aggressive options flag, configure the file as follows.

    ...
    
    # Enable the aggressive options flag
    -XX:+AggressiveOpts

    The comment is optional.

  3. When finished, save your changes.
  4. If PingFederate is configured to run as a service on a Windows server, follow these steps:
    1. Open command prompt and go to the <pf_install>/pingfederate/sbin/wrapper directory.
    2. Run generate-wrapper-jvm-options.bat.

      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.

    3. Close the command prompt.
  5. Restart PingFederate.
  6. For a clustered PingFederate environment, repeat these steps on each engine node as needed.