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 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 8.3 to 9.0. When cloning a server instance with a valid license, you do not need a new license.
The upgrade 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 setup
Use 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:
- Use the server's status tool.
- In the administrative console, go to the Status page and search for License on the Monitors tab.
License expiration
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. For more information, see Upgrading a PingDirectory license.
An expiring license causes alerts and alarms but does not affect the functionality of the product.