Configuring the Agent-Initiated Agent Status Check

Keepalive messages are enabled by default on agents. These messages are used by ActiveMQ to keep the connection between an agent and a server (or relay) open. You can configure a server to respond to those messages and update agent status accordingly.

To configure an agent-initiated status check:

Navigate to the directory or folder where the Deployment Automation agent is stored. For example:
..\Users\username\.microfocus\da\conf\server

Edit the agentStatusTracking settings in the da_config.xml file:

Setting	Description
enabled	Turns the agent status tracker on or off. Default: `false`
verificationPeriodInSec	Specifies how often to initiate scheduled agent status verifications (in seconds). Default: 60
bringingOnlineTimeoutInSec	Specifies the timeout period (in seconds) to bring an agent online after it is connected. If this timeout is reached and the agent is not online, the server re-sends a connectivity test and waits for another timeout. This process is repeated until the agent goes online. Default: 150
busyWhenQueueSizeIsHigherThen	Specifies the maximum average number of agents in a connection queue. If there are more agents than specified, agent status checks do not run until the average number goes below the specified value. Default: 20
busyCountPeriodInMs	Specifies the number of milliseconds for the time period when the average is calculated for `busyWhenQueueSizeIsHigherThen`. Default: 2500

Example Agent Status Tracker Settings

Example settings for agent status check options in the da_config.xml file.

<agentStatusTracker>
	  <enabled>true</enabled>
	  <verificationPeriodInSec>60</verificationPeriodInSec>
		  <bringingOnlineTimeoutInSec>150</bringingOnlineTimeoutInSec>
	  <busyWhenQueueSizeIsHigherThen>20</busyWhenQueueSizeIsHigherThen>
	  <busyCountPeriodInMs>2500</busyCountPeriodInMs>
	</agentStatusTracker>

Note: Agent status checks do not run when:

A server has more connected agents than allowed (busyWhenQueueSizeIsHigherThen)
When an agent actor manager or the system is busy, see Configuring Server Settings.

Note: Status checks for agents connected through the agent relay only work with version 6.2.2 or higher. Versions earlier than 6.2.2 cannot pass agent keepalive information to the server and are ignored.