License keys are required to install, update, and renew all Ping products.
How to obtain a license
To obtain a license key, contact your account representative or use the Ping Identity licensing portal.
When do you need a license
A license is required for setting up a new single server instance and can be used site-wide for all servers in an environment. Additionally, you must obtain a new license when updating a server to a new major version, such as when upgrading from 7.3 to 8.0. When cloning a server instance with a valid license, you do not need a new license.
The update process displays a prompt for a new license.
How to specify a license
Specify a license at setupYou have these options:
- Use the --licenseKeyFile <path-to-license> option with setup.
Copy the license file to the PingAuthorize Server root directory and then run the setup tool. The tool discovers the license file.
Specify a license after setupUse the Administrative Console or dsconfig (in the Topology section, select License).Note: Placing the new license file in the PingAuthorize Server root directory does not work in this case.
For information about how to specify the license with the Policy Editor, see Installing the PingAuthorize Policy Editor noninteractively.
How to view the license status
- The server's status tool
- The Administrative Console's Status page (On the Monitors tab, search for License.)
The server provides a notification as the expiration date approaches.
Before a license expires, obtain a new one and install it by using dsconfig or the Administrative Console.
An expiring license causes alerts and alarms but does not affect the functionality of PingAuthorize Server.
However, PingAuthorize Policy Editor fails to start if the license has expired.