Installing Qlik GeoAnalytics for Qlik Sense Server
Welcome to this quick guide to installing QlikGeoAnalytics 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
-
Download GeoAnalyticsForQlikSenseServer-<version>.zip from the Qlik Download Site.
-
Unzip the file into any folder on the server computer.
- Open up the Qlik Management Console (QMC).
- Enter your user name and password to login.
- Click 'Extensions' in the left hand menu.
- Click 'Import' at the bottom.
- Click 'Choose File'.
- Navigate to the folder where you unzipped GeoAnalyticsForQlikSenseServer-<version>.zip.
- Select any of the extension .zip files.
- Click 'Open'
- And repeat steps 4 - 8 until all .zip files have been imported.
The following steps need to be done on the actual server computer.
-
Run the GeoAnalyticsSetup to set up GeoAnalytics. This includes activating the Serial Number.
Information noteWhen 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.
- 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
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.
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.
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 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.
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 you will find a tab called "Network". It will be between "Elements" and "Sources". Click it.
- On the very top of the "Network" tab you will find the check box "Disable Cache". Check it if not already checked.
- Hit F5 to refresh.
- 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.
Firefox
- Navigate to the app you are having problems with.
- Press F12 to open the developer tools.
- 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.
- Look for a check box labeled "Disable Cache". Check it if not already checked.
- Hit F5 to refresh.
- 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.
Internet Explorer
- Open the browser settings.
- Switch to the Safety options and click the Delete Browsing History button.
- Uncheck everything except Preserve Favorites website data and Temporary Internet files.
- Select Delete.
- Hit F5 to refresh.
Once an app is working the cache should not be a problem again.