Installation Instructions - GeoAnalytics for Qlik Sense Server
Version: February 2021 (5.28.1), Date: 2021-01-21
Introduction
Welcome to this quick guide to installing Qlik GeoAnalytics on
Qlik Sense Server.
Note that you will need a Qlik LEF license to install version 5.8 or later.
Requirements
This version of GeoAnalytics works with Qlik Sense 3.2 or later and QlikView 11.2 or later. Note that Qlik Sense February 2018 requires GeoAnalytics February 2018 or later.
This version of GeoAnalytics requires .NET Framework v4.5.2 or later.
Installation
- 1) Start by unzipping
'GeoAnalyticsForQlikSenseServer-<version>.zip' into any folder
on the server computer.
- 2) Open up the Qlik Management Console(QMC).
- 3) Enter your user name and password to login.
- 4) Click 'Extensions' in the left hand menu.
- 5) Click 'Import' at the bottom.
- 6) Click 'Choose File'
- 7) Navigate to the folder where you unzipped the
'GeoAnalyticsForQlikSenseServer-<version>.zip'
- 8) Select any of the extension .zip files.
- 9) Click 'Open'
- 10) And repeat steps 4 - 8 until all .zip files have been imported.
- The following steps need to be done on the actual server computer.
- 1) Run the GeoAnalyticsSetup to set up GeoAnalytics. This includes activating the Serial Number.
- Note! When entering the license for GeoAnalytics on Qlik Sense Server 3.2.4 you need to specify the installation path of the extension manually since it is now on your specified QlikShare. If you have had an earlier version before, please check that the suggested path for the extensions is the actual one. The installation script can not detect that automatically.
- 2) Sometimes the Server need a restart to detect new connectors.
To restart open the windows Service dialog. Right-click and restart
the ‘Qlik Sense Repository Service’ and the `Qlik Sense Service Dispatcher´.
That is it, you should now be ready to use GeoAnalytics for Qlik Sense Server
Configuration
You can configure a few global extension settings by editing the file IdevioMap\settings.js
in the Qlik Sense extensions folder by adding or changing the values of the following properties.
Note that the settings file is overwritten when upgrading, so any settings will need to be applied again.
Setting | Type | Description |
---|
server | string | Default GeoAnalytics server URL |
allowCustomServer | boolean | If false maps will ignore the map server URL setting in their properties and instead use the default URL |
safeHtml | boolean | If true info bubbles will be limited to only allow a small safer subset of HTML tags (a, b, br, em, i, img, small, span, strong, sup, sub) and attributes (class, style, href, target, rel, alt, src, height, width) |
Custom Installation/Shared persistence
If you have installed your Server to use different paths to resources than the standard paths.
Please use the "Custom Installation" option when applying license in the GeoAnalyticsSetup.
Updating
To update your existing GeoAnalytics for Qlik Sense
Server the process is very similar to how you initially installed
it.
Simply select all the GeoAnalytics extensions.
Press 'Delete' in the lower left corner.
Follow the instructions in the Installation section.
After Installing/Updating
If you install the GeoAnalytics extensions as instructed but
get the error "Invalid Visualization", it most likely is because
Qlik Sense occasionally has problems with its cache. To resolve this
issue you need to clear the browser cache, but how you do that
depends on how you run Qlik Sense.
Below you will find a short step by step guide on how to clear
the cache depending on how you run Qlik Sense. Terminology may
differ between languages but the functionality should be the same.
- 1) Navigate to the app you are having problems with.
- 2) Press F12 or Ctrl+Shift+j to open the developer tools.
- 3) Once the developer tools page is open you will find a tab
called "Network". It will be between "Elements" and "Sources". Click
it.
- 4) On the very top of the "Network" tab you will find the check
box "Disable Cache". Check it if not already checked.
- 5) Hit F5 to refresh.
- 6) You can now close the developer tools by pressing F12 again.
- If you have the same problem with other apps, just repeat the
process with that app.
- 1) Navigate to the app you are having problems with.
- 2) Press F12 to open the developer tools.
- 3) Once the developer tools page is open you will find an icon
that looks like a small cogwheel. It is located in the top-right
corner of the developer tools. Click it.
- 4) Look for a check box labeled "Disable Cache". Check it if not
already checked.
- 5) Hit F5 to refresh.
- 6) You can now close the developer tools by pressing F12 again.
- If you have the same problem with other apps, just repeat the
process with that app.
- This is for Internet Explorer 9, but the steps for Internet
Explorer 10 and 11 is most likely very similar.
- 1) Navigate to the Menu Button (the one looking like a small
cogwheel) and click it.
- 2) Navigate to the "Safety" option and click the "Delete Browsing
History" button.
- 3) Uncheck everything except "Preserve Favorites website data" and
"Temporary Internet files".
- 4) Press Delete.
- 5) Hit F5 to refresh.
- 6) If you have the same problem with other apps, just repeat the
process with that app.
- Once an app is working the cache should not be a problem again.