Installing Qlik GeoAnalytics for QlikView Server
This is a guide to installing Qlik GeoAnalytics on a QlikView Server.
Note that you will need a Qlik LEF license to install version 5.8 or later.
Installation
-
Download GeoAnalyticsForQlikViewServer<version>.zip from Product Downloads.
For more information, see Downloading installation files.
-
Unzip the file into any folder on the server computer.
-
Navigate to the folder where you unzipped the file.
- Move the unzipped extension files into the folder where your QlikView Server will check for new extensions. This file path differs based on the server OS, as follows:
- Windows Server 2008: C:\ProgramData\QlikTech\QlikViewServer\Extensions\Objects
- Windows Server 2003: C:\Documents and Settings\All Users\Application Data\QlikTech\QlikViewServer\Extensions\Objects
- After you have placed all GeoAnalytics files the directory structure should contain these folders:
- ..\QlikTech\QlikViewServer\Extensions\Objects\IdevioAreaLayer
- ..\QlikTech\QlikViewServer\Extensions\Objects\IdevioBubbleLayer
- ..\QlikTech\QlikViewServer\Extensions\Objects\IdevioChartLayer
- ..\QlikTech\QlikViewServer\Extensions\Objects\IdevioLineLayer
- ..\QlikTech\QlikViewServer\Extensions\Objects\IdevioHeatmapLayer
- ..\QlikTech\QlikViewServer\Extensions\Objects\IdevioGeodataLayer
- ..\QlikTech\QlikViewServer\Extensions\Objects\IdevioMap
- Run the GeoAnalyticsSetup file to set up GeoAnalytics. This will require you to activate your license.
-
The setup ends with a new window where you enter your license.
By default the license tool will authenticate against Qlik Sense SaaS, but if you have configured a custom server during installation it will use that instead.Information noteIf you have a signed key and a local installation of GeoAnalytics Server you will need to make sure that it has been upgraded to the May 2021 release or newer, as older versions don't support signed keys.
Custom installation
If you have set up your QlikView Server installation to use non-default resource paths, select the Custom Installation option when activating your license in the GeoAnalyticsSetup file.
Configuration
You can configure a few global extension settings by editing the file IdevioMap\settings.js in the QlikView extensions folder by adding or changing the values of the following properties.
The settings file is overwritten when upgrading, so any settings will need to be applied again. It is therefore recommended that you, if you edit the settings, make a copy of the file for easy restoration after upgrade.
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) |
Updating
To update your existing GeoAnalytics for QlikView Server installation, remove all GeoAnalytics extension folders, and repeat the installation process with the updated extension files.
Troubleshooting installation
If you install the GeoAnalytics extensions as instructed, but QlikView Server displays an "Invalid Visualization" error, it is likely a QlikView cache error.
To resolve this issue, you need to clear your browser cache. If you have the same problem with other QlikView Server apps, repeat the process with that app.
Google Chrome
- Navigate to the app you are having problems with.
- Press F12 or Ctrl+Shift+J to open the developer tools.
- Once the developer tools page is open, find and open the Network tab.
- On the very top of the Network tab you will find a check box labeled Disable Cache. Check it, if not already checked.
- Hit F5 to refresh.
- Close the developer tools, and try again.
Firefox
- Navigate to the app you are having problems with.
- Press F12 to open the developer tools.
- Once the developer tools page is open, find the gear icon in the upper right corner.
- Look for a check box labeled Disable Cache. Check it, if not already checked.
- Hit F5 to refresh.
- Close the developer tools, and try again.
Microsoft Edge
- Open the browser settings.
- Under Clear browsing data, select Choose what to clear.
- Uncheck everything except Cached data and files.
- Select Clear.
- Hit F5 to refresh.