Unlock a world of possibilities! Login now and discover the exclusive benefits awaiting you.
Qlik Sense may end up experiencing issues during an installation or an upgrade, even if you’ve already tested the same process in a different environment. Those problems can be time consuming and frustrating to resolve, so I am going to give you some tips on how to accomplish a successful install/upgrade from scratch, and how to troubleshoot an issue, should something go wrong.
Here is what we will talk about
Preparation and Best Practices
To prevent any unpleasant surprises, an installation or an upgrade requires a bit of preparation.
This will ensure that the installer completes on its first try and that you can access the platform afterwards. It also allows for a better understanding and control of your system.
Below are a few key points to check before installing or upgrading Qlik Sense:
In addition, if you are upgrading:
In addition, I can only encourage you to take a server backup or a virtual machine snapshot.
Install or Upgrade – How do to it?
Once you have gathered all information and prepared your installation/upgrade, it’s time to proceed.
I‘m not able to give you better explanation than the steps provided on help.qlik.com, so I will attach the links below.
But, be sure to select the correct version top left of the window:
For a new installation
For an upgrade
Troubleshooting
Now the most interesting part: What to do if your installation/upgrade fails?
Well, first we need to find out the root cause and there is no better place for that than the logs.
Luckily, the installation and upgrade logs are stored in the same place which is the user temporary folder running the Qlik Sense installer. (By default: C:\Users\<Username>\AppData\Local\Temp)
Below is an example of a failed upgrade. Let’s try to understand what the files are for.
We can clearly see by sorting the files by Date modified that the installer failed on the service dispatcher and then started to rollback all the services that went through previously.
So, the log is helping us to find the root cause. In this case, it is the Qlik Sense Dispatcher.
Now that we know which logs we should look at, I will tell you what you should search for because these files can become very large.
Basically, if you search for “Return value 3” or “error code 1603” you will find the cause of the failed installation/upgrade.
Back to our example, here is what you will see:
In this case, the error is pretty explicit. Basically, it looks like an Antivirus blocked one of the PowerShell script to execute properly.
But all the above is provided as a guideline to find out the root cause. There will probably be error messages in those logs that are less explicit and in this case, I would highly recommend you to search this exact error message in our knowledge base. #QlikSupport is documenting every error messages identified during case’s investigation, so you will likely find it there.
Help Us Improve
Finally, I want to highlight that just before launching your installation/upgrade, I recommend ticking the box Help Us Improve. This will help us to potentially identify patterns in failure and improve our installer by making it more robust.
Thank you for reading my blog post and I really hope it helps you prepare for your next installation.
I’ll be watching for your questions, feedback or suggestions so please comment!
You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.