Updating QPR ProcessAnalyzer Server

This page contains instructions how to update an existing Windows installation to a newer QPR ProcessAnalyzer version.

Starting with QPR ProcessAnalyzer 2026.1, the platform now uses .NET 10 instead of .NET 8. If you are upgrading from a version earlier than 2026.1, you must install .NET 10 before completing the update. While both .NET versions can run side by side, .NET 8 does not need to be removed immediately. However, for security reasons, it is strongly recommended that .NET 8 be uninstalled as soon as possible after the upgrade. Download .NET 10: https://dotnet.microsoft.com/en-us/download/dotnet/10.0. For QPR ProcessAnalyzer Server, install the ASP.NET Core Runtime (hosting bundle). For QPR ScriptLauncher, install the .NET Runtime (x64 version for Windows).

Update procedure

Follow these instructions to update QPR ProcessAnalyzer to the latest version:

1. Pre-Update Steps:
   • Read the Upgrade Notes and Known Issues page to go through the considerations between the original and target releases.
2. Download and Prepare:
   • Download the QPR ProcessAnalyzer Server package from the downloads page.
   • Extract the package into a temporary folder (e.g., C:\temp\QPR_ProcessAnalyzer_<build number>).
3. Backup and Stop Services:
   • In the Internet Information Services (IIS) Manager, stop the application pool used by QPR ProcessAnalyzer Server.
   • Backup QPR ProcessAnalyzer Server root folder (by default C:\inetpub\QPRPA).
4. Replace Files:
   • Remove all files in the QPR ProcessAnalyzer Server root folder (by default C:\inetpub\QPRPA).
   • Copy all files from the Service folder of the extracted package into the QPR ProcessAnalyzer Server root folder (by default C:\inetpub\QPRPA).
   • Restore the backed-up appsettings.json file (from C:\temp\QPR_ProcessAnalyzer_<build number>) to the ProcessAnalyzer Server root folder (by default C:\inetpub\QPRPA).
5. Restart Services:
   • Start the QPR ProcessAnalyzer Server IIS application pool.

Migrating the Configuration Database

QPR ProcessAnalyzer Server applies pending database schema migrations automatically when the server starts. Migrations can also be run on demand, without starting the server, using the --migrateDatabase command line parameter. This is useful when the configuration database needs to be updated as a separate step, for example before starting a new server version or as part of an automated deployment.

Run the migration by starting the QPR ProcessAnalyzer Server executable with the parameter:

QPRProcessAnalyzerServer.exe --migrateDatabase

The command behaves as follows:

• It applies all pending database migrations and then exits without starting the QPR ProcessAnalyzer HTTP service.
• If the migration succeeds, including when there are no pending migrations, the process exits with exit code 0.
• If the migration fails, the error is written to the server log and the process exits with exit code 1. The migration is not retried.

Rollback procedure

Follow these instructions to rollback the updated version back to the original version:

1. In the Internet Information Services (IIS) Manager, stop the application pool used by QPR ProcessAnalyzer Server.
2. Restore the backed-up QPR ProcessAnalyzer Server root folder to the ProcessAnalyzer Server root folder (C:\temp\QPR_ProcessAnalyzer_<build number> folder content to C:\inetpub\QPRPA folder).
3. Start the QPR ProcessAnalyzer Server IIS application pool.