Enter your keyword

Installation Prerequisites

Minimum Hardware Requirements

Ping can be installed on the same server as Qlik Sense, however it is recommended that Ping is installed on its own server separate to the Qlik Sense server. This is to follow Qlik’s best practices of having dedicated hardware for Qlik Sense. Here are the minimum hardware requirements for Ping:

Platforms Microsoft Windows Server 2012
Microsoft Windows Server 2012 R2
Microsoft Windows Server 2016
Processors (CPUs) Multi-Core x64 compatible processors
Memory 8 GB RAM minimum
Disk Space 32 GB minimum
Ping Mobile App Android Support Version 4.4 or above
Ping Mobile App iOS Support iOS 10.3.x or above

 

IMPORTANT! –  The following software must be installed before installing Ping.

NodeJS is the core engine of Ping.

  • Download the 10.13.0 LTS version for Windows from the Nodes.js® web site.
  • Run the installer (the .msi file you downloaded in the previous step.)
  • Follow the prompts in the installer:
    • Accept the license agreement.
    • click the NEXT button several times.
    • accept all the default installation settings.
  • Restart your computer

 

You can make sure you have Node and NPM installed by running the following simple commands to see what version of each is installed.

  • Test Node.
    • open the Command window, Powershell or a similar command line tool, and type node -v.
    • This should print a version number, so you’ll see something like this v10.13.0.
  • Test NPM.
    • open the Command window, Powershell or a similar command line tool, and type npm -v.
    • This should print NPM’s version number, so you’ll see something like this 6.4.1

 

MongoDB is the main repository database for Ping.

  • Download MongoDB version 4.0.4 for Windows.
  • A .msi file similar to mongodb-win32-x86_64-2008plus-ssl-4.0.4-signed.msi will be downloaded in your system. Double click on the file to run the installer.
  • Click Next when the MongoDB installation windows pops up.
  • Accept the MongoDB user Agreement and click Next.
  • When the setup asks you to choose the Setup type, choose Complete.
  • Accept the default Service Configuration settings and click Next
  • Click Install to begin the installation.
  • That’s it. Click Finish once the MongoDB installation is complete.

(Required in version 2019.03.02 and later)
We use the Redis database as a persistent cache which ensures no alerts are missed, even when there is downtime on the server.

  • Download the windows installer version of Redis.
    Note: This install process uses version 3 of Redis which is not the most recent but Redis is not natively supported on Windows OS’. We are building out a number of infrastructure options with Docker and Kubernetes which will allow us to manage this process better in the very near future.
  • Extract the downloaded redis64-latest.zip files
    • right click on the zip file,
    • select Extract All.
    • enter your chosen location, for example C:\Redis
  • Initiate Redis for the first time
    • Navigate to the folder where you have extracted the files to, from this point on this will show as C:\Redis.
    • Right click on the C:\Redis\redis-server.exe file and run as administrator. This will open a command window and the final line will show you the port on which Redis is running, port 6379.
    • Do not close this window at this time, Redis is running through the command line so closing it will close Redis. We will create the service shortly.
  • Validate Redis connectivity
      • Right click on the C:\Redis\redis-cli.exe file and run as administrator. This will open a command window.
      • Type ping and press enter.
    • Redis should return the text ‘PONG’.
    • Close all command windows before the next step
  • Setup Windows Service for Redis
    • open a new command window with run as administrator privileges.
    • change directory to the Redis folder
      • type cd c:\Redis (or the path to your Redis folder) and press enter.
    • Create the Redis service
      • type (or copy and paste) redis-server --service-install redis.windows.conf --loglevel verbose --service-name redis and press enter.
      • type net start redis and press enter to start the service
    • Update the recovery settings for this service so it restarts if something happens to cause it to stop (such as windows updates etc)
      • type (or copy and paste) sc failure "redis" actions= restart/5000/restart/5000/restart/5000 reset= 86400 and press enter.
        Alternatively you can make these changes through the windows services GUI.
  • You can now close all of the command line windows as Redis is now running as a windows service.

 

There are ports that are required to be opened in order to enable communication between Ping and Qlik Sense.

 

Server Firewall settings
  1. You will need to open one or both of the following ports on the Ping Server:
    • 4551 (http); and/or
    • 4552 (https).
  2. You will need to open the following ports on the Qlik Sense central node (and separate proxy server if necessary):
    • 443 (HTTPS access to Qlik Sense Proxy)
    • 4242 (Qlik Repository Service API listen port)
    • 4243 (Qlik REST API listen port)