PingAccess

Installing PingAccess on your system

Install PingAccess on Linux, on Windows through an installation wizard, or on Windows through the command-line interface (CLI).

Before you begin

  • Ensure you’ve met the installation requirements.

  • Ensure you’re signed on to your system with appropriate privileges to install and run an application.

    On Linux, install and run PingAccess as a non-root user.

  • Install a supported Java runtime.

  • The system or user environment variable JAVA_HOME must exist and be set to a value that represents the location of your Java installation, such as usr/java/jdk 1.8.0_74.

  • Add the relevant Java directory path to the PATH variable so it’s available for scripts that depend on it:

    • On Linux: Add the Java Runtime Environment (JRE) /bin directory path (for example, usr/lib64/jvm/jre/bin).

    • On Windows installer: Add the javapath directory path (for example, C:\Program Files\Oracle\Java\javapath).

    • On Windows CLI: Add the javapath directory path (for example, C:\Program Files\Oracle\Java\javapath).

  • You must have a pingaccess.lic license file.

    If you do not have a PingAccess license, you can request an evaluation key at https://support.pingidentity.com/s/. During the first run of PingAccess, you will be prompted to upload the license file.

    If you are using an existing configuration file to configure the system, copy the configuration file to the system and rename it data.json. For more information about exporting the configuration from an existing system, see Exporting PingAccess configurations.

  • Linux

  • Windows installer

  • Windows CLI

Installing PingAccess on Linux

About this task

To install PingAccess on a Linux system:

Steps

  1. Download the distribution .zip archive from the PingAccess downloads page.

  2. Extract the distribution .zip archive into your installation directory.

  3. Optional: If you are using an existing configuration file to configure the system, move the data.json file to the PA_Home/data/start-up-deployer directory.

    When you start PingAccess for the first time, if this configuration is present it will be imported. After a successful import, the data.json file is deleted. If the configuration is present but cannot be imported, PingAccess is not started.

    If you’re deploying PingAccess in a cluster configuration, see the configuration documentation.

Next steps

Access the administrative console to complete the configuration.

Installing PingAccess on Windows using the installer

About this task

To install PingAccess on a Windows system using the installer:

Steps

  1. Download the PingAccess Windows installer from the PingAccess downloads page.

  2. Double-click on the installer icon to launch the PingAccess setup wizard.

  3. Click Next and follow the prompts to complete the installation using the following information for your selected operational mode.

    Operational Mode Requirements

    Standalone

    Ports:

    • PingAccess administrative console: TCP 9000

    • PingAccess agent protocol: TCP 3030

    Clustered admin node

    Ports:

    • PingAccess administrative console: TCP 9000

    • Configuration query port: TCP 9090

    Clustered replica admin node

    Ports:

    • PingAccess administrative console: TCP 9000

    • Configuration query port: TCP 9090

    Prerequisites:

    • You must install and configure a clustered admin node.

    • You must have a configuration data archive file available for the replica admin node. For more information, see Clustering in PingAccess in Reference Guides.

    Install the clustered replica admin node on a separate machine in the same network.

    Clustered engine node

    Ports:

    • PingAccess agent protocol: TCP 3030

    Prerequisites:

    • You must install a clustered admin node.

    • You must have a configuration data archive file available for the clustered engine node. For more information, see Clustering in PingAccess in Reference Guides.

  4. Copy the Uniform Resource Locator (URL) of the PingAccess administrative console that is displayed on the final page of the PingAccess setup wizard, then click Finish.

  5. To customize and finalize the PingAccess setup, paste the URL you copied into your web browser and connect to the administrative console of the instance you have just installed.

Next steps

Access the administrative console to complete the configuration.

Installing PingAccess on Windows from the command line

About this task

To install PingAccess on a Windows system from the CLI:

Steps

  1. Download the distribution .zip archive.

  2. Extract the distribution .zip archive into your installation directory.

  3. Optional: If you are using an existing configuration file to configure the system, move the data.json file to the PA_Home/data/start-up-deployer directory.

    When you start PingAccess for the first time, if this configuration is present it will be imported. After a successful import, the data.json file is deleted. If the configuration is present but cannot be imported, PingAccess is not started.

Next steps

Access the administrative console to complete the configuration.