You can install PingFederate on Windows and Linux operating systems.
Install PingFederate using the following methods:
- Install PingFederate on a Windows system by running the installer for Windows or by extracting the distribution .zip archive. Using the installer for Windows is the preferred method.
- Install PingFederate on a Linux system by extracting the distribution .zip archive.
This documentation refers to the installation directory path where the pingfederate directory is located as <pf_install>. For example, <pf_install>/pingfederate/bin.
To avoid future problems with automated upgrades, do not rename the installed pingfederate directory.
If you are installing multiple instances of PingFederate on the same machine, such as a console node and an engine node in a clustered environment, install each instance using a unique <pf_install> directory.
If you are upgrading an existing PingFederate environment, see Upgrading PingFederate.
Click the corresponding tabs for your preferred installation method.
Installing PingFederate on Linux systems
- See System requirements for a list of qualified Linux operating systems.
- Request a license key through the Ping Identity licensing website.
- Ensure you are signed on to your system with sufficient privileges to install and run an application. You must install and run PingFederate under a local user account.
- Verify that you have installed the Java Runtime Environment (JRE) and that you have set the required environment variables correctly. For more information, see Installing Java.
To install PingFederate on a Linux system using the distribution .zip archive:
If your organization plans to manage keys and certificates using a hardware security module (HSM), see Supported hardware security modules.
Installing the PingFederate service on Linux manually
- Request a license key through the Ping Identity licensing website.
- Ensure you are signed on to your system with sufficient privileges to install and run an application.
- Verify that you have installed the Java Runtime Environment (JRE) and that you have set the required environment variables correctly. For more information, see Installing Java in the PingFederate Server documentation.
If you have not installed PingFederate on Linux using the distribution .zip archive, you can install it manually. To install the PingFederate service on Linux manually:
After setting up the PingFederate SysV initialization script, you can use the Service Configuration utility or run the following service commands to manage the PingFederate service:
service pingfederate start
service pingfederate stop
service pingfederate restart
service pingfederate status
Installing PingFederate on Windows
- Request a license key through the Ping Identity licensing page.
- Ensure your are signed on to your system with sufficient privileges to install and run an application.
- Verify that you have installed the Java Runtime Environment (JRE) and that you have set the required environment variables correctly. For more information, see Installing Java.
You can install PingFederate on a Windows system using the installer for Windows or the distribution .zip archive. Using the installer for Windows is the preferred method.
To configure PingFederate to run as a service on Windows, install PingFederate on Windows manually. For more information, see Installing the PingFederate service on Windows manually.
To install PingFederate:
If your organization plans to manage keys and certificates using a hardware security module (HSM), see Supported hardware security modules.
Installing the PingFederate service on Windows manually
- Request a license key through the Ping Identity licensing website.
- Ensure you are signed on to your system with sufficient privileges to install and run an application.
- Verify that you have installed the Java Runtime Environment (JRE) and that you have set the required environment variables correctly. See Installing Java.
If you have installed PingFederate using the installer for Windows, skip these steps because PingFederate has already been configured to run as a service and to start automatically at the end of the installation process.
To install the PingFederate service manually:
The PingFederate service starts automatically on reboot.