Configuring the Heartbeat Interval

Civic Platform includes a configuration file update that enables a heartbeat between the av.web and av.biz servers to help ensure active connections between the servers. Customers who install the Civic Platform server components av.cfmx and av.web on different servers must modify their configuration files to decrease the default HEARTBEAT_INTERVAL value based on their firewall time-out settings. The value of the HEARTBEAT_INTERVAL must be less than the firewall time-out setting to ensure that the server does not time out, by pinging it and keeping it active for users to access before the server times out.

For example, if your firewall time-out setting is 60 minutes (this is typically the default), you must change the HEARTBEAT_INTERVAL value to 50 minutes, represented in the configuration file in milliseconds. Therefore, the calculation to determine a 50-minute heart-beat ping is as follows: 50x60x1000 = 3000000. If your firewall is configured with a 30-minute time-out setting, configure the HEARTBEAT_INTERVAL for 25 minutes, or 1500000 milliseconds, based on this calculation formula: 25x60x1000.

To set the HEARTBEAT_INTERVAL in your environment:

1. Navigate to your installation directory and open the following files in a text editor:
   • av.cfmx\conf\av\av-biz-client.xml
   • av.web\conf\av\av-biz-client.xml
2. Locate the existing HEARTBEAT_INTERVAL value which is currently set at 2147483640:

   <prop key="remote.connection.biz.connect.options.org.wildfly.remoting3.
   RemotingOptions.HEARTBEAT_INTERVAL">2147483640</prop>

3. Change the HEARTBEAT_INTERVAL value based on the above calculation. For example, change 2147483640 to 3000000 if your firewall time-out setting is 60 minutes; change it to 1500000 if your firewall time-out setting is 30 minutes.
4. After saving the change, restart the Wildfly server.