Cluster management
When multiple PingFederate servers are running as a cluster, the administrative console provides a Cluster Management window that you can use to ensure the all the nodes have the same configuration and license.
When you change the configuration of PingFederate on the administrative console, a notification banner appears at the top of the console, reminding you to go to the Cluster Management window and replicate the configuration of the administrative console node to all engine nodes in the cluster. The replication procedure generates new replication data that the engine nodes use to replicate from the administrative node’s configuration. Another notification banner appears when a cluster node is out-of-date or has failed.
Each node periodically reaches out to a random node in the cluster to see if newer replication data is available. If a node finds newer data, it attempts to retrieve and apply it. By default, the nodes poll another node every 60 seconds. You can change the replication poll interval by editing the value of the replication.poll.interval property in the <pf_install>/pingfederate/server/default/conf/cluster-config-replication.conf file.
The Cluster Management window also shows the version of each node.
The following table describes the properties in the <pf_install>/pingfederate/server/default/conf/cluster-config-replication.conf file.
| Property | Description | ||
|---|---|---|---|
|
The timeout period for replication status requests, in milliseconds. The default value is |
||
|
The timeout period for requests to retrieve configuration data, in milliseconds. The default value is |
||
|
The number of retry attempts, if an error occurs while retrieving configuration data. The default value is |
||
|
The interval in seconds to check if more recent configuration data is available The default value is |
||
|
Indicates if engines require replication data for startup and serving traffic. When set to true, engines that fail to retrieve replication data from the cluster during startup will exit, preventing them from serving traffic. NOTE: If an engine has previously retrieved replication data from a console or engine and is restarted, this flag will not be enforced. Instead, the engine will start up with the previously downloaded data. The default value is |
||
|
Enables availability of previously published replication data (in the case of consoles) or retrieved data (in the case of engines) to the cluster during startup, eliminating the need for manual or automated replication triggers upon console restart.
The default value is |