Installing a license key on a new or upgraded PingFederate server
You can install a license key on the PingFederate server from the administrative console.
Steps
-
Start PingFederate and sign on to the administrative console.
-
Go to System → Server to open the License Managementwindow, and then click Choose file to select the license file. Click Import.
Result:
If the license is for the wrong version of PingFederate or is found to be invalid for some other reason, PingFederate displays an error message.
When the license file is verified for use with your PingFederate instance, the license information is saved in the
<pf_install>/pingfederate/server/default/conf/pingfederate.lic
file. -
If you have a clustered PingFederate environment, go to System → Server to open the Cluster Management window, and then click Replicate Configuration.
You must use the Replicate Configuration window to initiate the transmission of the license file from the console node to all engine nodes. As an added measure, the administrative console reminds you to do so as well.
When an engine node receives the license information from the console node, it saves the new license information to the
<pf_install>/pingfederate/server/default/conf/pingfederate.lic
license file.For any engine node that was offline at the time of the import, when it restarts and joins the cluster, it consumes the new license information from the console node and applies the same processing logic.
PingFederate no longer maintains its license information in the
<pf_install>/pingfederate/server/default/data/.pingfederate.lic
file, which is referred to as the secondary license file in the previous versions of PingFederate. The.pingfederate.lic
file, if any, is ignored.