Qlik Community

Ask a Question

Knowledge

Search or browse our knowledge base to find answers to your questions ranging from account questions to troubleshooting error messages. The content is curated and updated by our global Support team

Announcements
Support Cases coming to Qlik Community Oct. 4! Start chats, open cases, explore resources. Prep for the big move: READ DETAILS

How to Upgrade or Migrate QlikView 11.20 and later versions

Yoichi_Hirotake
Support
Support

How to Upgrade or Migrate QlikView 11.20 and later versions

The upgrade procedure of QlikView is straight forward and can be applied between all currently supported major versions, such as 11.20 to November 2017 (12.20) or April 2019 (12.40). 

The steps in this article are a basic guideline for upgrading, as well as for when moving/migrating QlikView to a new host.

The official and up to date procedure about upgrade can be found on the official Help site.

Preparation: 


IMPORTANT: If Digital Certificates were used previously, the certificates need to be removed prior to the upgrade. A net set of certificates needs to be created by the Management Console and services on different machines need to be re-added for the certificates to be distributed. 

IMPORTANT: When upgrading, ensure that Desktop, Server & Plug-in (if used) are always upgraded so they are on the same version (including release number). If not, there may be unpredictable side effects. Running with mixed versions is not supported.

Environments:

  • QlikView 11.20
  • QlikView 12.00, 12.10 and 12.20 (November 2017)
  • QlikView 12.30 (November 2018)
  • QlikView 12.40 (April 2019)
  • QlikView 12.50 (April 2020)

 

Step 1: Backup and Upgrade Preparation

 

  • Backup C:\ProgramData\QlikTech folder on each machine that you installed QlikView Services. 
  • Backup Root Folder 
  • Backup C:\Program Files\QlikView

See Backup and upgrade preparation for details. 

Step 2: Upgrade the QlikView Server

 

Note: Before upgrade production environment, it is recommended to test QlikView on a test environment first to make sure everything behaves as expected, such as QlikView documents, objects, or tasks. This reduces the potential risks of compatibility issues.

  • Download QlikView Server installation package from our download site. 
  • Put QlikView Server installation package onto each machine that you installed QlikView Service 
  • Stop all of the QlikView Services on each machine that you installed QlikView Services 
  • Run QlikView Server installation package on each machine that you installed QlikView Service and follow the installation wizard displayed and install QlikView Server. 
  • Reboot all of the machines after the upgrade.

See Upgrading on the same machine for details. 

Step 2 (Migration): Moving the QlikView Server, including the QVPR and tasks. 

 

An alternative way is to build a new environment entirely. Proceed as follows to perform a migration to a new machine. The example is written for a single node environment.

See Upgrading to a different machine for details.

Summary:

  • On the new machine, install a running, licensed version of QlikView Server.
  • Stop all QlikView services on the old machine.
  • On the new machine, remove or rename the %ProgramData%\QlikTech\ManagementService\QVPR folder.
  • On the new machine, remove or rename the %ProgramData%\QlikTech\ManagementService\qvpr_<NewMachineName>.ini file.
  • Copy the QVPR folder and the .ini file “as is” from the old machine to the new one (that is, keep the folder name).
  • 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
  • Rename the .ini file (that is, change qvpr_<OldMachineName>.ini to qvpr_<NewMachineName>.ini).
  • Change all references to <OldMachineName> to <NewMachineName> in the QVPR .xml files.
  • Start the QlikView services on the new machine.
  • 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.  
  • 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.  

Step 4: Upgrade the QlikView Desktop client(s)

 

Download the QlikView Desktop client installation files and have them distributed to developers working with the creation and development of QlikView apps.

Step 5: Upgrade the QlikView Internet Explorer Plugin (if in use)

 

Note: The QlikView Desktop upgrade or installation will upgrade or install the correct version of the Plugin.

If no automated software rollout is being used, end-users can install the IE Plugin from the AccessPoint. Verify that the AccessPoint is configured to show the Plugin Download link. The setting is located in the QVWS@Webserver settings > AccessPoint > Access Point Settings > Plugin Download [ ] Show link.

Additional Resources:

 

(Note that the titles of the video may refer to a specific version of QlikView, but generally apply to all versions after 11.20)

QlikView Upgrade Guide - Step by Step

  • Detailed preparation steps to follow before the upgrade including what to back up
  • Information about QlikView related files and how they are affected by the upgrade
  • A step-by-step upgrade example

STT - Reinforcing QlikView Server November 2017

In this webinar we will discuss:

  • Changes with Shared File Format
  • New Script Evaluator
  • Publisher Improvements

Reinforcing QlikView Server November 2017

 

 

Version history
Revision #:
5 of 5
Last update:
‎2021-03-09 11:31 AM
Updated by: