While the QPR 2025.1 installation does recognize previously installed major versions of QPR Suite, a direct upgrade from those is not provided. Instead, QPR 2025.1 is installed side-by-side with the older version with new version-specific default folders, so that the settings of the older version installation are not overwritten (provided that also the older version was installed to its default folders). If an older major version of QPR Suite is detected on the computer, there is a possibility to launch the migration utility at the end of the QPR 2025.1 installation. With the help of the migration utility you can transfer your old settings and database from the old version easily. For more information for performing the migration, see the System Migration section in QPR - Configuration Instructions document.
Some issues to note:
•The default communication ports are the same in both versions, so when installing QPR 2025.1 side-by-side with the older version, you either need to run only one version at a time or change the ports the other version is using
•Only one version can be registered for QPR scripting at a time. You may need to manually register the desired version by running QPR.Modeling.Client.exe /regserver or QPR.Metrics.Client.exe /regserver in the corresponding installation directories.
•Customizations to QPR Portal templates do not get transferred automatically by the migration utility. See the next chapter for more information about transferring the Portal customizations.
•Settings for QPR Portal default views are stored in QPR_Servers.ini, and the relevant ini file sections should copied manually in addition to the database transfer.
•Check in all checked out QPR ProcessDesigner or QPR EnterpriseArchitect models before migrating the database.
•When migrating to QPR 2025.1, if you have customized the 'TemplateRoot' setting found in QPR_Servers.ini, you need to manually add 'Templates' to the folder path after the migration. For example, if the value of the TemplateRoot setting is 'D:\QPR\Templates\WAS' before the migration, add the 'Templates' folder to the value so that the value is 'D:\QPR\Templates\WAS\Templates' after the migration.
•If QPR authentication is used, it is recommended that users update their passwords after migrating from a version older than QPR 2022.1.
Summary of automatic migration possibilities
Transferred from an old version (2012.1 or newer) |
|
Database |
X |
Settings (ini files) |
see note below |
Portal customizations |
- |
qprsettings.dat file |
- |
Settings in ini files are partially transferred. When transferring from versions older than 2022.1, any passwords using an older encryption are converted to new stronger encryption. However, other settings such as paths are transferred as such and you will need to review and possibly change them after the migration. Other alternative is to skip settings transfer and input the necessary passwords again using QPR Configuration Manager.