If the Upgrade Utility or the PingFederate installer for Windows determines that the Log4j2 configuration file (log4j2.xml in the <pf_install>/pingfederate/server/default/conf directory) has changed since it was originally installed, new features are not activated; the upgrade tools do not currently support automatic merging of customizations made to the existing logging configuration. Instead, these upgrade tools copy the modified log4j2.xml to the new installation intact and rename the configuration file from the product ZIP file using the new PingFederate version number. Both configuration files are located in the same conf directory.

To activate new features:

  1. Review the new features by comparing the renamed Log4j2 configuration file against log4j2.xml.
  2. Modify log4j2.xml to suit your needs.
  3. If you have a clustered PingFederate environment, repeat step 2 for all applicable PingFederate nodes in the cluster.