QPR Knowledge Base 2017.1

Appendix C: Running Multiple Versions Simultaneously

Appendix C: Running Multiple Versions Simultaneously

 Previous topic Next topic No directory for this topic  

Appendix C: Running Multiple Versions Simultaneously

 Previous topic Next topic Topic directory requires JavaScript Mail us feedback on this topic!  

While QPR 2017.1 can be installed side-to-side with earlier QPR versions rather easily (all the default folders are different), there are still a few issues you need to take into account if you are running both QPR 2017.1 and an older version simultaneously.

 

 

Server Ports

 

The default ports are the same in QPR 2017.1 as in the earlier versions. In order to run QPR 2017.1 and an older version simultaneously, port numbers for either version need to be changed. See the instructions regarding port changes in the "Parallel (side-by-side) installations of QPR 2017.1" section.

 

 

Script Clients

 

If you use QPR scripting and have multiple versions installed, the version that runs scripts double-clicked in Windows Explorer is the latest version that is installed. If you need to change this, do the following:

 

1.Open an elevated command prompt (i.e. run command prompt as an administrator).

2.Go to the currently registered version's QPR Modeling/QPR Metrics installation folder depending on which you're registering (folders that contain QPR.Modeling.Client.exe/QPR.PG.Client.exe/Proguide.exe or QPR.Metrics.exe/QPR.SC.Client.exe/SCClient.exe respectively)

3.Run QPR.Modeling.Client.exe /unregserver or QPR.Metrics.Client.exe /unregserver depending on the client. Note that the exe names were proguide.exe and scclient.exe respectively on versions up to the initial release of QPR 8.0, and QPR.PG.Client.exe and QPR.SC.Client.exe up to the initial release of QPR Suite 2012.

4.Go to the corresponding folder for the version with which you want to open the scripts and run QPR.Modeling.Client.exe /regserver or QPR.Metrics.Client.exe /regserver. Note that the exe names were proguide.exe and scclient.exe respectively on versions up to the initial release of QPR 8.0, and QPR.PG.Client.exe and QPR.SC.Client.exe up to the initial release of QPR Suite 2012.

 

 

Parallel (side-by-side) installations of QPR 2017.1 Servers

 

1.Copy the QPR 2017 installation folder under a new name, for example QPR 2017 Servers_Instance2.

2.Launch some executable from the new folder so that the settings are instantiated.

3.Make a copy of your existing database and create a new, version-specific ODBC data source for it, for example QPR-2017-1-2.

4.Create a version specific web content folder under your web server and copy the qprsoftware folder there. So if the webcontents are installed in, for example, C:\InetPub\wwwroot\QPR2017-1\qprsoftware, the new folder should be e.g. C:\InetPub\wwwroot\QPR2017-1_2\qprsoftware. Note that it is essential that the name of the qprsoftware folder is not changed.

5.Similarly create a new folder for the CGI binary and ISAPI DLL and copy QPR.CGI.exe, QPR.ISAPI.dll and qprsettings.dat into that folder.

6.Go to the new version's folder and use the QPR Configuration Manager utility to change the data source and the port numbers (increment every number by 1, for example) to avoid overlaps with the new version. Also change the webcontent folder entries. Consult the table below for information about the required changes:

 

Section

Group

Change

Common

Database operations

Change the data source to instance-specific one.

Common

Server locations

Change the port numbers for all servers

QPR Web Application Server

General

Change the web content URL to point at where the new instance files are installed. You may need to add a new virtual directory to Microsoft IIS at this point and update the value correspondingly.

QPR Web Application Server

General

Change the script location to point at where the new instance files are installed. You may need to add a new virtual directory to Microsoft IIS at this point and update the value correspondingly.

QPR Web Application Server

QPR Metrics Plugin

If this value hasn't changed automatically, change the Web file publishing directory and the Web file publishing URL to point to the new folders.

 

7.Locate the QPR_Servers.ini file that corresponds to the installation. You can determine its location by going to C:\ProgramData\QPR Software\QPR 2017\2017.1\Servers folder and checking the contents of the instances.ini file located there. Check the instance under which the installation folder is the one you created in step 1. The correct QPR_Servers.ini file will be located in Settings\<Instance> folder relative to the folder containing the instances.ini file. Open the QPR_Servers.ini in the instance-specific folder and change the value of WebContentPath in [WAS Settings] section to point to the folder created in step 4, without the qprsoftware part included in the name, i.e. in the case of the example folder the setting should be WebContentPath=C:\InetPub\wwwroot\QPR2017-1_2\.
8.Similarly, under the [WAS Settings] section add the TemplateRoot setting that points to the template folders used by the instance. The template folder will be Templates\<Instance>\WAS relative to the folder containing the instances.ini file, i.e. in the case of the example the setting should be TemplateRoot=C:\ProgramData\QPR Software\QPR 2017\2017.1\Servers\Templates\Instance_2\WAS.
9.Open the qprsettings.dat file in the folder you created in step 5 and change the value of HOST_PORT to be the same you defined for QPR Web Application Server in the Server locations section. If you are using QPR.ISAPI.dll, you need to restart IIS (e.g. by running iisreset) before the new ports are in use.
10.If you want to run also the other servers as a service, first you need to open the QPR_Servers.ini file in the folder created in step 2 and update the values of InternalName and InternalBaseName keys in the [QPR Service] section to something else than the default ones (for instance QPR_2017_2), but use the same value for both keys. After the QPR_Servers.ini modifications, you can start the service installation by opening the command prompt and running 'qpr.init.exe -i' in the Utilities folder. To install also QPR Web Services service, run 'qpr.init.exe -b4' after the main service installation.
11.Change the clients of the parallel installation to use the new port numbers defined in step 6.

 

Both installations can now be used simultaneously. Note that you need to modify the links pointing to the old Portal to point at the new folder. Also note that the parallel version can be removed or upgraded only manually. Parallel installation of the clients package is not supported.