Upgrading PingFederate on Windows using the installer - 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

If you used the PingFederate installer for Windows to install the previous version of PingFederate, you can use it to upgrade to the current version of PingFederate.

  • Read the Upgrading PingFederate topic for an overview of the upgrade process.
  • Ensure that you are logged on to your server with appropriate privileges to install and run an application.

Upgrade results are contained in the upgrade.log file. If the upgrade succeeds, upgrade.log is located in <pf_install_target>\pingfederate\upgrade\log. If the upgrade fails, upgrade.log is located in <pf_install_target>. The default location for <pf_install_target> is C:\Program Files\Ping Identity. Administrators can change the location during the upgrade process.

Note:

The PingFederate installer for Windows does not support custom mode. If you want to override the newer default security settings or upgrade the OpenToken Adapter, use the PingFederate Upgrade Utility.

Important:

If you are upgrading a clustered PingFederate environment, start with the console node, and then follow the additional steps to upgrade the engine nodes.

  1. Download the PingFederate installer for Windows from the Ping Identity website.
  2. Double-click the pingfederate-10.1.0.msi file to begin the upgrade.
  3. Follow the instructions in the PingFederate Setup Wizard to upgrade PingFederate.
    PingFederate installer for Windows

    Errors are rare, but might include problems such as missing or malformed configuration files in the source installation. If the upgrade tool reports an error, review the error messages in the upgrade.log file.

    Note:

    You can rerun the tool as many times as needed to correct any problems.

    When the tool completes the upgrade, it automatically starts the new PingFederate installation.

  4. If you are upgrading a clustered PingFederate environment, repeat from step 1 to upgrade PingFederate on each engine node.
    Note:

    End users might experience disruptions while you upgrade your PingFederate environment.

  5. Open the administrative console and verify the new installation.
  6. If you are upgrading a clustered PingFederate environment:
    1. Ensure all nodes are shown on the System > Server > Cluster Management window.
    2. Click Replicate Configuration on the Cluster Management window.