Updating to the latest maintenance release - PingFederate - 10.3

PingFederate Server

bundle
pingfederate-103
ft:publication_title
PingFederate Server
Product_Version_ce
PingFederate 10.3
category
Product
pf-103
pingfederate
ContentType_ce

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.

  • Ensure your installation is running PingFederate 10.3.x, where "x" represents an older maintenance release of 10.3.
  • Make a backup copy of the PingFederate home directory.

You can incrementally update your PingFederate 10.3 installation to the latest 10.3 maintenance release. For example, if you are on PingFederate 10.3.1 and the latest maintenance release is version 10.3.4, you can use the in-place update method to update your installation to version 10.3.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.

Important:

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

Note:

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.

  1. Go to the PingFederate Previous Releases page on the Ping Identity website.
  2. In the PingFederate 10.3.x section, download the maintenance in-place update and extract its contents from the .zip file.
  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.