PingFederate Server

Updating to the latest maintenance release

For PingFederate maintenance releases, you have the option to update your installation using the incremental update package. This in-place update method lets you replace and merge only the files that have changed.

Before you begin

  • Ensure your installation is running PingFederate 12.0.x, where "x" represents an older maintenance release of 12.0.

  • Make a backup copy of the PingFederate home directory.

About this task

You can incrementally update your PingFederate 12.0 installation to the latest 12.0 maintenance release. For example, if you are on PingFederate 12.0.1 and the latest maintenance release is version 12.0.4, you can use the in-place update method to update your installation to version 12.0.4.

The in-place update doesn’t contain files from Ping Identity integration kits. You can upgrade an integration kit manually by downloading the latest kit from the PingFederate Downloads page’s Add-ons tab and following the instructions provided by the kit’s documentation.

You cannot use the in-place update method to upgrade an older version of PingFederate, such as 10.3.2 or 11.1.4, to version 12.0.x. For those older versions, you must use the standard upgrade method for your platform described in Upgrading PingFederate.

The in-place update method involves manual modification of PingFederate files. If you’re not comfortable moving and editing these files, then instead use the standard upgrade method for your platform described in Upgrading PingFederate.

If your installation includes a cluster, perform the following procedure on each node starting with the administrative console node.

Steps

  1. Go to the PingFederate Downloads page on the Ping Identity website.

  2. In the Maintenance Update section, download the In-place Update (ZIP) file and extract its contents.

  3. Stop PingFederate.

  4. Copy the files in the in-place update’s pingfederate directory and paste them into their corresponding locations in your current PingFederate installation, replacing the old files.

    For example, if the in-place update contains pingfederate/server/default/lib/pf-protocolengine.jar, copy the pf-protocolengine.jar file to the same location in your PingFederate installation: <pf_install>/pingfederate/server/default/lib.

  5. Compare each file in the in-place update’s merge_required directory with the version of the file in your current PingFederate installation and manually merge the changes into the file in your current installation.

    For example, if the in-place update contains merge_required/pingfederate/server/default/conf/language-packs/pingfederate-messages.properties, copy the changes in the new version into the pingfederate-messages.properties file in your PingFederate installation.

  6. Start PingFederate.