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.

Screenshot of the cluster management banners

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
Property Description

The timeout period for replication status requests, in milliseconds.

The default value is 2000.


The timeout period for requests to retrieve configuration data, in milliseconds.

The default value is 20000.


The number of retry attempts, if an error occurs while retrieving configuration data.

The default value is 1.


The interval in seconds to check if more recent configuration data is available

The default value is 60.


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 false.


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.


This feature relies on the saved replication data being accessible after node restarts. If the data directory does not persist across restarts, a restarted node will have no replication data to publish. To benefit from this flag, the console's data directory must persist across restarts at a minimum.

The default value is true for fresh installations and false for upgrades.