Installing Qlik GeoAnalytics Server

[Chip_Matejowsky]

This article describes the prerequisites, downloaded files and steps necessary to install Qlik GeoAnalytics Server

Environment

Qlik GeoAnalytics 

 

Prerequisites

1. Qlik GeoAnalytics Server system requirements
2. Ensure you Prerequisites for Java installation
   Prerequisites 
3. GeoAnalytics Server communicates using both HTTP and HTTPS, so ensure those ports (default 80 and 443) are open on the server device
4. Qlik GeoAnalytics Server installation files and data packages
5. Local directory accessible by the Local System account (e.g. C:\GeoAnalytics install)
6. If configuring to use HTTPS, a valid certificate from Computer Account from Qlik Sense Enterprise Server.  Refer to How to prepare SSL certificate to enable HTTPS for Qlik GeoAnalytics Map Server

            Refer to this site for Certificates installation: Certificate 

1. Copy the client and server certificates over to the GeoAnalytics server directory as noted previously (e.g. C:\GA certs)

Note: GeoAnalytics must be install on it's own server. It is not best practice to install GeoAnalytics with other Qlik products. 

 

Download

1. Go to the Qlik Downloads Site
2. Select Qlik Data Analytics (or use Search All)
3. Select Qlik GeoAnalytics
4. Select your Release and Release Number
5. Click the Download Link
   
   
    
    

Installation

1. Run the Qlik GeoAnalytics Server installation file (e.g. GeoAnalyticsServer-February2021.exe)
   
   
   
   
2. Accept the license agreement
   
   
   
   
3. Use default port or change if needed.  
   
   Note:  In a production environment, Qlik GeoAnalytics must be installed on a separate server from that of the Qlik Sense Server.  Therefore, select ports 80 and 443 as defaults.  However, when installing for a proof of concept (POC) or trial, you may install GeoAnalytics Server on the same Windows server as the Qlik Sense Server.  For this scenario, change the ports from 80 and 443 (e.g. 8080 and 4430).
   
   
   
   If configuring with HTTPS:
   
   
   1. Check the Enable HTTPS option
      
      
      
      
   2. Browse to the location where the client and server certificates were copied previously to the GeoAnalytics Server (e.g. C:\GA certs)
      
      
      
      
   3. Enter the certificate password which was previously configured and click Next
      
      
      
      
4. Set an Admin user and API user password of your choosing
   
   
   
   
5. On the Ready to Install screen click Next
   
   
   
   
6. Enter an installation path (default is C:\Program Files\Qlik GeoAnalytics Server) and click Next
   
   
   
   
7. Note the message on changing parameters post-installation and click Next
8. Click Finish to complete the installation
   
   

Licensing

1. Launch the GeoAnalytics Server Administration Interface by opening a browser and entering http(s)://localhost:<port>/ravegeo/admin
   
   

2. Login using username Admin and password chosen during installation
   
   

3. In the left pane, select License Administration
   
   

4. Paste the license code (if using a Signed License Key) or the LEF (if using a LEF based license) into the text area.  If using LEF, also enter the control number associated with the license
   
   
   
   

5. Click the Add License button to activate
6. Once correctly licensed, the Available Licenses section will populate and the licensed modules will be visible in the bottom left pane
   
   

Add Data Package

1. Refer to the Data Package Installation Guide available on the Qlik Downloads website
2. Extract the downloaded data packages to a local directory accessible by the Local System account (e.g. C:\GA server install)
   
   
   
   
3. Open the GeoAnalytics Server Administration console and select Service Administration
   
   
   
   
4. Click Add Services button and browse to the location of the extracted data
5. Select enterpriseServices.xml and click Load
   
   

6. The xml file contains a number of services that will show up in the window but they remain disabled. Check ENABLED for all the new services in the following order:
   1. Enable all services that are not for module geoanalytics or module webmap5, service map.
   2. Enable all remaining services.
7. If a service in the list turns red when enabled it means there was an error.  You can hover the mouse over the service to read more about the error. To fix the most common errors, first make sure the zip files were extracted correctly.  Then, restart each red service (disable then enable). Restarting the services should fix the most common error that is caused by enabling services in the incorrect order.  Each error is also represented in the log (Server Administration -> View Log).

Confirming the Installation

1. Open the GeoAnalytics Server Administration console and select WebMap5 Module > Diagnostics Pages > Default map > Go To Diagnostics Pages > Simple Test
   
   

   
   

2. A map is displayed
   
   
   
   
3. GeoAnalytics Server has been successfully installed

Related Content

• How to prepare SSL certificate to enable HTTPS for Qlik GeoAnalytics Map Server 
• Installing Qlik GeoAnalytics Extensions for Qlik Sense Enterprise 
• Qlik Fix: Installing GeoAnalytics Connector with Qlik Sense 

The information in this article is provided as-is and to be used at own discretion. Depending on tool(s) used, customization(s), and/or other factors ongoing support on the solution below may not be provided by Qlik Support.

[avl_dlimi]

Hi.

I can't find the installation file for GeoAnalytics Server August 2021.

These are the only files I can see

Br

An

[Sonja_Bauernfeind]

Hello @avl_dlimi. 

There was no Server release for August 2021, so that's accurate. If you are worried about compatibility, you can find a compatibility table here:  GeoAnalytics server supported versions.

All the best,
Sonja