Qlik Community

Ask a Question

Knowledge

Search or browse our knowledge base to find answers to your questions ranging from account questions to troubleshooting error messages. The content is curated and updated by our global Support team

Announcements
Talk to Experts Tuesday: Live chat Aug. 24th 10 AM ET: Bring your Qlik Gold Client questions REGISTER TODAY

Installing Qlik GeoAnalytics Extensions for Qlik Sense Enterprise

Bjorn_Wedbratt
Support
Support

Installing Qlik GeoAnalytics Extensions for Qlik Sense Enterprise

 

Environment:

Qlik GeoAnalytics 

 

Qlik GeoAnalytics extensions and connector for Qlik Sense Enterprise is delivered as a zip archive. To install do the following:

  1. Extract the downloaded GeoAnalyticsForQlikSenseServer-x.x.x.zip archive
  2. Open Qlik Management Console and go to Extensions
  3. Delete any previously imported Idevio extensions (idevio*), CTRL+ select to multi-select and press Delete

    Delete old extension.png

    Delete old extension confirm.png

  4.  Press Import and Choose File
  5. Locate the extensions in the folder where you previously extracted GeoAnalyticsForQlikSenseServer-x.x.x.zip and import them one by one into Qlik Sense Enterprise
  6. Once done there should be a total of 8 extensions in Qlik Management Console
  7. Run GeoAnalyticsSetup_x.x.x.exe located in the folder where you previously extracted GeoAnalyticsForQlikSenseServer-x.x.x.zip
  8. Accept the license agreement and press Next >
  9. If not running a local GeoAnalytics server, leave the default server URL and press Next >

    This setting can later be changed in IdevioGeoAnalyticsConnector.exe.config file found in C:\Program Files\Common Files\Qlik\Custom Data\QvIdevioConnector\

    Setup Geo Analytics.png

  10.  Press Install to start the installation process
  11. Once the installation process is finished, the License Activation Tool will be launched automatically. (located in C:\Program Files (x86)\QlikView\GeoAnalyticsLicenseTool)

    Geo Analytics License Activation Tool.png

  12.  Enter your Serial number and Control number

    If running a local GeoAnalytics server, use the Serial number and Control number for the GeoAnalytics server to activate the license

  13. Synchronized Persistence: Make sure to select the correct environment, "QlikSense Server". This will ensure license details are written in the correct location
  14. Qlik Sense Multi node Environment: Run GeoAnalyticsSetup_x.x.x.exe  in all Qlik Sense nodes and re start all Qlik sense services.
  15. Shared Persistence: Make sure to select the environment "Custom Installation" and insert the Extension path. For example, if your root folder is \\myserver\share, insert path \\myserver\share\StaticContent\Extensions\  OR C:\myserver\share\StaticContent\Extensions\

    Geo Analytics License Activation Tool Filled out.png
     License details for Qlik Sense Enterprise will by default be written into license.js during activation, which can be found in C:\ProgramData\Qlik\Sense\Repository\Extensions\ideviomap\ (Synchronized persistence) or \\myserver\share\StaticContent\Extensions\ideviomap\ (Shared persistence)

    License details for GeoAnalytics Connector will by default be written into IdevioGeoAnalyticsConnector.exe.config during activation, which can be found in C:\Program Files\Common Files\Qlik\Custom Data\QvIdevioConnector\

  16.  Press Activate/Refresh license to activate the license

    Internet access is not required, but you may receive a red text saying "Check your internet connection" followed by this message in Installation Log. Ignore the message. 

  17. Then restart Qlik Sense server, Qlik GeoAnalytics for QlikSense Enterprise is now installed and ready to use

 

Note: Since the Engine loads connectors (and DSNs) from local resources, it is important to install the GeoAnalytics connector to all nodes with an Engine service active or the GeoAnalytics Connector may not function properly.

Note 2: On successful activation the "Installation Log" will show LEF details for the license, if LEF license server can be contacted. This information is only to verify that the correct license has been applied during activation and is not written down in any LEF.txt or similar. 

 

Reactivating / Changing license 

Should you need to reactivate or change the license, use the License Activation tool:

  1. In Windows Explorer go to C:\Program Files (x86)\QlikView\GeoAnalyticsLicenseTool
  2. Launch GeoAnalyticsLicenseTool.exe
  3. Follow the steps above to add your Serial and Control number and reactivate the license

 

Configuration when running a local GeoAnalytics server

If connecting to a local GeoAnalytics server the URL to the server can be entered during setup or altered afterwards.

  1. Edit IdevioGeoAnalyticsConnector.exe.config found inC:\Program Files\Common Files\Qlik\Custom Data\QvIdevioConnector\
  2. Change the setting for "serverURL" to point to your local GeoAnalytics server
  3. Save the file
  4. Edit settings.js found in C:\ProgramData\Qlik\Sense\Repository\Extensions\ideviomap\ (Synchronized persistence) or \\myserver\share\StaticContent\Extensions\ideviomap\ (Shared persistence)
  5. Alter the "server" setting to point to your local GeoAnalytics server (or add it if settings.js is empty)
    define({
    "server": "http://qlikserver.domain.local"
    });​
  6. Save the file
  7. Run the License Activation Tool found in C:\Program Files (x86)\QlikView\GeoAnalyticsLicenseTool
  8. Enter the Serial number and Control number for your GeoAnalytics server and press Activate/Refresh license to activate the license

 

Common paths

 

Extensions

Installation: C:\ProgramData\Qlik\Sense\Repository\Extensions\ 
Needs to be imported through Qlik Management Console
License file: C:\ProgramData\Qlik\Sense\Repository\Extensions\ideviomap\license.js
Settings file: C:\ProgramData\Qlik\Sense\Repository\Extensions\ideviomap\settings.js

 

Connector

Installation: C:\Program Files\Common Files\Qlik\Custom Data\QvIdevioConnector
Settings file: C:\Program Files\Common Files\Qlik\Custom Data\QvIdevioConnector\IdevioGeoAnalyticsConnector.exe.config
URL for Geo Server
License key

 

Licensing tool

InstallationC:\Program Files (x86)\QlikView\GeoAnalyticsLicenseTool

 

Logs

C:\ProgramData\QlikTech\Custom Data\IdevioGeoAnalyticsConnector\Log

Labels (1)
Version history
Revision #:
2 of 2
Last update:
‎2021-05-12 07:25 AM
Updated by:
 
Contributors