article Qlik Replicate Upgrade Best Practices in Official Support Articles

Qlik Replicate Upgrade Best Practices

David_Fergen — Thu, 18 Jul 2024 13:04:37 GMT

Content:

Before the Upgrade: What Version of Qlik Replicate should I upgrade to?

While the first option is to upgrade to the latest and current release, some companies adopt a latest release minus one version policy. The idea is to upgrade to a version that has been in the field longer and has received any needed service packs. But there are things to be considered when choosing:

Source and target endpoint compatibilities

Always verify compatibility of your clients or driver software for certified endpoints. Upgrading your endpoints can drive an upgrade of Qlik Replicate, or it can prevent you from upgrading to the latest version.

Each supported Qlik Replicate version has its supported target and source endpoints listed on the Qlik help site:

Supported source endpoints (latest version)
Supported target endpoints (latest version)

Operating system compatibility

Does your operating system support the version of Qlik Replicate you want to upgrade to? Verify the supported platforms for your version:

Supported platforms (latest version)

Qlik Enterprise Manager and Qlik Compose compatibility

If you use Qlik Enterprise Manager or Qlik Compose, review compatibility with Qlik Replicate:

Compatibility with related products

Release Cadence, Patches, and Release Notes

Review Qlik's Release Management Policy on how frequently new versions are released and how long they receive patches and support
Review the Qlik Replicate Product Lifecycle for End of Support Dates
Review the Release Notes of the version you choose, including the Release notes for your Qlik Enterprise Manager and Qlik Compose installations. Qlik generally does not publish every service pack on the main downloads page as they are for specific issues. If you locate an issue in the Release Notes which has a service pack available that is not listed on the download site, request a download link from Support.

Upgrade Instructions and Best Practices

Detailed instructions on how to upgrade your version of Qlik Replicate (on Windows and Linux) can be found on the official Help Site (Setting up Qlik Replicate on Windows).

Additional guides can be found in:

Qlik Replicate Upgrade Instructions for Windows and Linux: 2022 and 2023
Qlik Replicate upgrade on a Windows Cluster from 2022.5 or .11 to 2023.5 and 2023.11
Qlik Replicate upgrade on a Windows Cluster from 2021.5 to 2021.11 and 2022.5
The basic PDF guide attached applies to old versions of Qlik Replicate (6.4, 6.5, and 6.6).

The following Techspert Talks session covers:

Understanding the requirements
Upgrade process demonstration
Troubleshooting tips & resources

Chapters:

00:58 - Windows requirements
02:37 - Endpoint compatibility
04:00 - Choosing the version
04:52 - Upgrade methods
05:32 - Automated Log Cleanup
06:10 - Downloading the correct file
06:56 - Upgrade demo
08:57 - Troubleshooting 404 error
11:51 - Troubleshooting files not extracting
12:49 - Q&A: Issues Replicating to Fabric High Latency AI?
13:24 - Q&A: What about upgrading Windows?
14:33 - Q&A: What files are good to archive?
15:40 - Q&A: Should Log Stream and Data Folder be separate?
16:43 - Q&A: How to enable High Availability on Linux?
17:33 - Q&A: How to move the Data Directory folder?
18:31 - Q&A: How to handle tables with no primary keys?
19:02 - Q&A: How to keep Replicate when upgrading Windows?
19:46 - Q&A: Can the same license keys be used?
20:10 - Q&A: What about upgrading SAP endpoints?
21:13 - Q&A: Which version of Replicate is more stable?
21:48 - Q&A: How should you upgrade from a very old version?

Resources:

Click here to see video transcript

Re: Qlik Replicate Upgrade Guide

pillaikapil256 — Wed, 13 Jul 2022 06:56:18 GMT

1. Does this issue occur in your Production Environment (Not QA/Test/Dev etc)? Do you have a workaround?
This is in PROD

2. Is the issue with one task or all tasks?
All PostgreSQL Tasks

3. Is it a brand new task? Has anything changed in the environment or the design of the task?
This is Old Task . There was upgrade in PostgreSQL Version to 12.x

4. If this is related to an upgrade have you followed the steps for backing out of an upgrade?

a. Replicate: https://community.qlik.com/t5/Qlik-Support-Knowledge-Base/Qlik-Replicate-Upgrade-Guide/ta-p/1729651
b. Compose: https://help.qlik.com/en-US/compose/August2021/Content/ComposeDWDL/Main/DW/Installation%20and%20Setup/install_compose.htm
How much time will upgrade take ?

5. Have you attached the relevant info/files to the ticket? Please refer:
a. Replicate https://help.qlik.com/en-US/replicate/November2021/Content/Global_Common/Content/SharedEMReplicate/Monitor%20and%20Control%20Tasks/monitor_download_diagnostics.htm

b. Compose https://community.qlik.com/t5/Knowledge/How-to-collect-Diagnostics-Package-from-Qlik-Compose/ta-p/1893972

c. Catalog https://community.qlik.com/t5/Knowledge/Where-to-find-troubleshooting-logs-for-Qlik-Catalog/ta-p/1893998

6. Please provide your direct phone number to call in case it's needed
EDITED: We have edited out personal contact information.

Re: Qlik Replicate Upgrade Guide

KellyHobson — Mon, 11 Jul 2022 12:58:35 GMT

Hey @pillaikapil256 ,

How much time will upgrade take ? -> Replicate upgrades do not take a long time to apply, but there are pre-upgrade steps which ensure a successful upgrade. We highly recommend testing upgrades on a lower DEV or TEST environment before applying to PROD.

Based on your description, I recommend opening a Support case so we can assist you and gather relevant details.

Please follow this link to create a new case:

https://community.qlik.com/t5/Knowledge/How-to-create-a-case-and-contact-Qlik-Support/ta-p/1710992

Thank you,

Kelly

Re: Qlik Replicate Upgrade Guide

pandurangarsule — Mon, 23 Jan 2023 07:09:24 GMT

1) On Production Environment

2) It's For All Task

3) This Is Old Task, but Endpoint Connection is New

4) Not Related to Upgrade

5) Already Attached

Re: Qlik Replicate Upgrade Guide

KellyHobson — Fri, 20 Jan 2023 10:27:37 GMT

Hey @pandurangarsule ,

If you are trying to submit details related for a Support Case please open a new request via:

1. Support Case - > Open a new case

2. Start a new live chat to get help opening a case

Thanks,

Kelly

Re: Qlik Replicate Upgrade Best Practices

KavitaL — Sat, 21 Jun 2025 05:56:10 GMT

Dear All,

I got a question regarding upgrade Qlik Replicate, We are currently in May 2023 version in PROD. If I need to upgrade either May 2025 or Nov24 it is too much of work, I need to upgrade on Nov 2023 then May 2024 and Nov2024. What if I backup the datadirectory and then perform a fresh installation on the system then replace it with data directory(only tasks)

will it work?

Re: Qlik Replicate Upgrade Best Practices

john_wang — Tue, 24 Jun 2025 08:02:24 GMT

Hello @KavitaL ,

Not exactly — that approach will not work because the upgrade process involves two major changes:

The executable program files under the bin subfolder are upgraded.
The embedded SQLite repository files are also upgraded.

If you replace the DATA folder with a backup from the previous version, it will likely corrupt the upgraded SQLite repository (Step 2).

For your scenario, the recommended steps are:

Upgrade to Qlik Replicate November 2023 SR.
Then upgrade to Qlik Replicate November 2024.
Be sure to back up the DATA folder before each upgrade.

By the way, Replicate 2024.11 is the recommended version.

Hope this helps!

John.