Updating QPR ProcessAnalyzer Server: Difference between revisions

From QPR ProcessAnalyzer Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(32 intermediate revisions by the same user not shown)
Line 1: Line 1:
This page contains instructions how to update an existing Windows installation to a newer QPR ProcessAnalyzer version.
<div style="border:1px solid #dfdfdf;padding:0.5em 1em 0.5em 1em;background-color:#E7EAEC;margin:10px 0px 0px 10px;">
<div style="border:1px solid #dfdfdf;padding:0.5em 1em 0.5em 1em;background-color:#E7EAEC;margin:10px 0px 0px 10px;">
This page describes how to update QPR ProcessAnalyzer starting from 2022.6 release (.Net 6 based). To update older (.Net Framework based) QPR ProcessAnalyzer release, [[Updating_QPR_ProcessAnalyzer_Server_(.Net_Framework)|click here]].
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).
</div>
</div>


Follow these instructions to update existing QPR ProcessAnalyzer Server to the latest version:
==Update procedure==
# Read the [[QPR_ProcessAnalyzer_Release_Notes|release notes]] between the original and new versions, to see any special considerations regarding the update.
 
# Download QPR ProcessAnalyzer Server package (available in the [[QPR Product Downloads#QPR_ProcessAnalyzer_Server|downloads page]]).
Follow these instructions to update QPR ProcessAnalyzer to the latest version:
# Extract the package to a temporary folder (e.g. C:\temp\QPR_ProcessAnalyzer).
# Pre-Update Steps:
# In the '''Internet Information Services (IIS) Manager''', stop the application pool where QPR ProcessAnalyzer is running.
#* Read the [[QPR_ProcessAnalyzer_Release_Notes|release notes]] between the original and new releases to identify any special considerations.
# Go to the ProcessAnalyzer Server IIS root folder (e.g. C:\inetpub\QPRPA) and backup the '''appsettings.json''' file.
# Download and Prepare:
# Delete all files in the QPR ProcessAnalyzer Server root folder.
#* Download the QPR ProcessAnalyzer Server package from the [[QPR Product Downloads#QPR_ProcessAnalyzer_Server|downloads page]].
# Copy all files from the '''Service''' folder (in the temporary folder) to the IIS root folder of the ProcessAnalyzer Server (e.g. from C:\temp\QPR_ProcessAnalyzer\Service to C:\inetpub\QPRPA).
#* Extract the package into a temporary folder (e.g., C:\temp\QPR_ProcessAnalyzer_<build number>).
# Copy the backed up appsettings.json file to the C:\inetpub\QPRPA folder.
# 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).
# 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).
# Restart Services:
#* Start the QPR ProcessAnalyzer Server IIS application pool.


[[Category: QPR ProcessAnalyzer]]
==Rollback procedure==
Follow these instructions to rollback the updated version back to the original version:
# In the Internet Information Services (IIS) Manager, stop the application pool used by QPR ProcessAnalyzer Server.
# 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).
# Start the QPR ProcessAnalyzer Server IIS application pool.

Latest revision as of 11:03, 22 December 2025

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 release notes between the original and new releases to identify any special considerations.
  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.

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.
Retrieved from "https://wiki.onqpr.com/pa/index.php?title=Updating_QPR_ProcessAnalyzer_Server&oldid=27553"