Learn how to install the PingIntelligence Dashboard.
Ensure that the following prerequisites are met:
- Server: 8 core CPU, 16 GB, 1 TB HDD
- Operating system: RHEL 7.9 or Ubuntu 18.04 LTS
- OpenJDK: 11.0.2
- SSL certificate: One private key and certificate. By default, PingIntelligence Dashboard uses the private key and certificate shipped with the binary.
- Password: If you want to change the default password, set a minimum 8 character password.
- API Behavioral Security (ABS): ABS URL, access, and secret key. Make sure that ABS is reachable from the PingIntelligence Dashboard machine.
- API Security Enforcer (ASE): ASE management URL, access, and secret key. Make sure that ASE is reachable from the PingIntelligence Dashboard machine.
Connecting the Dashboard to ASE is optional. Functionality, such as adding discovered APIs to ASE and attack management, will be limited.
Make sure the following default port numbers are available:
- PingIntelligence Dashboard (WebGUI) server: 8030. Port number 8030 should be exposed to public internet. Make sure that your organization's firewall allows access to this port.
- Elasticsearch: 9200
- Dataengine: 8040
- H2 database: 9092. The H2 database is installed and runs as a part of the PingIntelligence Dashboard.
Make sure you have one of the following supported browsers installed. The following table shows the compatibility of PingIntelligence for APIs Dashboard with different browsers and their versions.
Operating System | Google Chrome | Mozilla Firefox | Apple Safari | Microsoft Edge |
---|---|---|---|---|
Mac OS Mojave -10.14 |
Version 56.0 and later |
Version 69.0 and later |
Version 12.0 and later |
|
Mac OS Sierra -10.12 |
Version 56.0 and later |
Version 69.0 and later |
Version 10.1 and later |
|
Mac OS High Sierra - 10.13 |
Version 56.0 and later |
Version 69.0 and later |
Version 11.1 and later |
|
Mac OS Catalina -10.15 |
Version 56.0 and later |
Version 69.0 and later |
Version 13.0 and later |
|
Windows 8.1 |
Version56.0 and later |
Version 69.0 and later |
||
Windows 10 |
Version 56.0 and later |
Version 69.0 and later |
Version 79.0 and later |
Ensure you have completed the following configuration for the operating system:
- Increase the
ulimit
to 65536:# sudo sysctl -w fs.file-max=65536 # sudo sysctl -p
- Increase the
vm.max_map_count
limit to 262144:# sudo echo "vm.max_map_count=262144" >> /etc/sysctl.conf # sudo sysctl -p
- Set
JAVA_HOME
to the <jdk_install> directory and add<jdk_install>/bin
to the systemPATH
variable. <jdk_install_dir> is the directory where JDK is installed. - Choose the <pi_install_dir> directory. The <pi_install_dir> directory is the directory where the PingIntelligence Dashboard is installed. This directory should be readable and writable by the logged in user.
Installing the PingIntelligence for APIs Dashboard automatically installs Elasticsearch.
There are two preconfigured login users in PingIntelligence Dashboard:
admin
ping_user
Multiple admin
and ping_user
can simultaneously sign
on to PingIntelligence Dashboard.
The admin user has full access toPingIntelligence Dashboard. An admin
can view the
dashboard of various APIs as well as tune threshold and unblock a client identifier.
ping_user
can only view the API dashboard. A total of 25
admin
and ping_user
can sign on simultaneously.
To install the PingIntelligence Dashboard: