QlikView: Migrating to a different machine

[Andre_Sostizzo]

Basic instructions on how to migrate a QlikView server installation to a different host. 

If direct assistance is needed and you require hands-on help with a migration, engage Qlik Consulting. Qlik Support cannot provide walk-through assistance with server migrations outside of a post-installation and migration completion break/fix scenario.

To note:

• If you are also planning to upgrade during the migration, see How to Upgrade or Migrate QlikView 11.20 and later versions. 
• The example is written for a single-node environment.
• See the QlikView Online Help Upgrading to a different machine for details.
• When planning your migration consider how to maintain CAL assignments. See Migrating QlikView Server without losing CAL assignments?

Summary:

1. On the new machine, install a running, licensed version of QlikView Server.
2. Stop all QlikView services on the old machine.
3. On the new machine, remove or rename the %ProgramData%\QlikTech\ManagementService\QVPR folder.
4. On the new machine, remove or rename the %ProgramData%\QlikTech\ManagementService\qvpr_<NewMachineName>.ini file.
5. To retain User Document mounts, copy the %ProgramData\QlikTech\QlikViewServer\Settings.ini file and move it to the new server.
6. Copy the QVPR folder and the .ini file “as is” from the old machine to the new one (that is, keep the folder name).
7. Change all references to <OldMachineName> to <NewMachineName> in the following files:
   
   ProgramData\QlikTech\DistributionService\Configuration.xml
   ProgramData\QlikTech\DistributionService\Registration.xml
   ProgramData\QlikTech\WebServer\Config.xml
   ProgramData\QlikTech\ManagementService\Config.xml
   
   If you wish to migrate the historical task files to the new server, include:
   
   ProgramData\QlikTech\DistributionService\TaskLogIndex_XXXXX.xml 
   
   
8. (Only applicable for previous version of QlikView such as 12.30 and earlier) Rename the .ini file (that is, change qvpr_<OldMachineName>.ini to qvpr_<NewMachineName>.ini).
9. Change all references to<OldMachineName> to <NewMachineName> in the QVPR .xml files.
10. Start the QlikView services on the new machine.
11. Do NOT use the QMC to change the Distribution Service Source Document paths, as doing so will potentially break the task links.  If you need to change paths, go directly to the SourceFolderDocumentResource.xml in the QVPR and make the changes directly there to point to the new paths, do not change anything but the path information, as the GUID links must stay the same in order to keep the tasks aligned. An alternative to editing the XML file directly is to use the XML DB Viewer power tool which allows you to search as well as find/replace.  
12. Shut down the old machine.

NOTE: If there have been any changes made to the QMS exe.config file, be certain those changes are documented somewhere, as they will need to be re-applied to the new QMS exe.config file post-upgrade.  The upgrade uninstalls the 11.20 files and installs new 12.xx files, which means the exe.config will be removed and recreated without customizations.  The QMS is unique in that it does not write changes to the programdata path like the other services, so be certain the customizations are documented and reapplied post-upgrade prior to bringing the services back online again.  

[zied_ahmed1]

Hello,

Is there any Tutorial to migrate QlikView to another Machine (Need to keep the same version in the old Server and install a new version in the new Server )

Thank you 

[Sonja_Bauernfeind]

Hello @zied_ahmed1 this article, or the help site (Upgrading to a different machine) document what you require. While the help site states upgrade as well, you can just skip the part where we mention upgrading.

If you need assistance beyond the available documentation, please contact our professional service team for a quote.

All the best,
Sonja