Upgrading PingFederate
Use this section to learn how to upgrade your PingFederate environment to the latest version on Windows and Linux systems.
Depending on your PingFederate installation, you can upgrade by using the PingFederate installer for Windows or the Upgrade Utility, which automatically migrates existing PingFederate installations of 8.0 and later to the latest version. The Upgrade Utility is included with the software distribution.
Learn more about the updates to the latest version of PingFederate in Upgrade considerations.
Best Practices: Planning your upgrade has general information about upgrading Ping Identity products and an upgrade planning guide.
|
Learn how to reduce the downtime involved in upgrading PingFederate in Performing a near-zero downtime PingFederate upgrade |
|
Before upgrading your production environment, you should:
After you complete the upgrade process, you can create a backup of your previous installation and remove it from the server. End users might experience service disruptions as you upgrade your PingFederate environment. As needed, schedule a maintenance window to perform the upgrade. |
Upgrade paths
| Operating system | Source version | Source installation medium | Possible upgrade paths |
|---|---|---|---|
Microsoft Windows |
Step 8.x through 11.x |
PingFederate installer for Windows |
PingFederate installer for Windows or PingFederate Upgrade Utility |
Step 8.x through 11.x |
PingFederate product distribution |
PingFederate Upgrade Utility |
|
Linux |
Step 8.x through 11.x |
PingFederate product distribution |
PingFederate Upgrade Utility |
|
If you are upgrading from PingFederate 7.x or earlier, contact Support for more information. |
Both the PingFederate installer for Windows and the Upgrade Utility create a new installation based on the new product distribution .zip archive and then copy the relevant files and property values from the existing installation (the source) to the new installation (the target). As a result, neither tool affects the source installation.
Integration kits
Both upgrade tools also copy the program files for the deployed adapters, connectors, and token translators (the integration kits in general) from the source installation to the target installation. Although the tools don’t upgrade the integration kits automatically, you can download newer versions from the Ping Identity https://www.pingidentity.com/en/resources/downloads.html website and upgrade the integration kits manually. You can find integration kit documentation in the Ping Identity Integrations Directory page.