License keys are required to install, update, and renew all Ping Identity 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 setup.
You have these options:
- Use the --licenseKeyFile <path-to-license> option with setup.
Copy the license file to the 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 server root directory does not work in this case.
How to view the license status
To view the details of a license, including its expiration, you have these options:
- 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 the product.