Federation Manager Installation and Upgrade Guide › Upgrade a 12.x System to Federation Manager r12.5 › How to Upgrade to Federation Manager r12.5 › Upgrade to Federation Manager r12.5 on Windows

Upgrade to Federation Manager r12.5 on Windows

On a Windows system running an operating platform that supports Federation Manager, you can upgrade directly to Federation Manager r12.5 on the same operating platform.

If you are running your existing system on a pre-12.5 operation system, migrate the configuration; you cannot directly upgrade.

Note: You do not need to deactivate your partnerships before upgrading.

Run the r12.5 Federation Manager installer executable to upgrade. The upgrade preserves your previous Federation Manager configuration.

Important! Be aware of the following installation restrictions:

• Do not install Federation Manager on a system where the SiteMinder Policy Server or Secure Proxy Server (SPS) is already installed. Installing Federation Manager on a SiteMinder system could negatively impact the existing SiteMinder installation.
• Do not install Federation Manager on a system where there is an existing Apache Web Server or Apache Tomcat Server.

If the installer detects the smkeydatabase file, the installer performs the following actions:

• Backs up the smkeydatabase.
• Attempts to migrate the content to the certificate data store.

Important! If the smkeydatabase migration fails, do not return system back to the original environment because this action causes all transactions that require the certificate data to fail.

To locate installation kits

1. Log onto the CA Technical Support site.
2. Click Download Center.
3. Search the Download Center for the installation kit you need.

To upgrade Federation Manager on Windows

1. Exit all applications that are running.
2. Navigate to the folder where you plan to run the installation program.
3. Copy the installation executable to the folder.

   Note: View a list of installation executables.

4. Double-click the installation_executable.

   The installation wizard starts.

5. Go through the installation.
6. Review the installation settings and click Install.
7. The installation program runs and upgrades Federation Manager.

   Restart the system when prompted.

8. After the upgrade is complete, clear all temporary files in the browser so that the correct Federation Manager files load.

Actions to Take if an Upgrade Error Occurs

If the database upgrade fails, Federation Manager displays an error message telling you to run the policy_store_upgrade script. The upgrade script (policy_store_upgrade.bat) is located in federation_mgr_home/install_config_info.

If you experience other problems during the installation, review the installation log file CA_Federation_Manager_InstallLog.log and the upgrade log file CA_Federation_policy_store_upgrade.log. Both files are the directory federation_mgr_home/install_config_info.