Housekeeping tasks of Dispatcher

At Topology > Dispatchers, you can assign the Housekeeping role to one or more Dispatchers, so you will have more control on which Dispatcher the housekeeping tasks will be executed.

Housekeeping tasks include:

• Setting components (Consoles, Dispatchers and Agents) offline when there has not been any activity for at least five minutes.
• Cancel Jobs that have been scheduled to Agents that have been removed.
• Timeout of Jobs that have been running longer than the defined timeout period.

Only one Dispatcher will be responsible for running the housekeeping tasks at one time. For performance reasons, it is advised to choose a Dispatcher near the Datastore.

Configuration

At Topology > Dispatchers, on the Settings tab of the Dispatcher’s properties, you enable the setting Housekeeping to assign the Housekeeping role to the selected Dispatcher. To enable the setting for multiple Dispatchers, you can also use the option Change settings of selected Dispatchers from the context menu or settings overview. The same procedure applies to disable the Housekeeping role.

Execution of housekeeping tasks

The Dispatcher will check every 60 seconds if it needs to take over the housekeeping tasks. Depending on the configuration of the Dispatchers, several scenarios are possible:

• One or more Dispatchers have been assigned the Housekeeping role and (some of them) are online: The first available Dispatcher with the Housekeeping role will run or take over the housekeeping tasks.
• All Dispatchers that have been assigned the Housekeeping role are offline: The first available Dispatcher will run or take over the housekeeping tasks.
• No Dispatchers have been assigned the Housekeeping role: The first available Dispatcher will run or take over the housekeeping tasks.

Overview Housekeeping role

Depending on the scenario a different value will be shown in the column Roles in the Dispatchers overview. That way you can see which of the Dispatchers are currently performing the housekeeping tasks. The values for this column are:

Dispatcher role	Definition
<empty>	The Dispatcher is not assigned any role and is not performing housekeeping tasks.
Housekeeping	The Dispatcher is assigned the Housekeeping role, but currently not performing housekeeping tasks.
Housekeeping*	The Dispatcher is assigned the Housekeeping role and is performing housekeeping tasks.
(Housekeeping)*	The Dispatcher is not assigned the Housekeeping role, but is performing housekeeping tasks.

Please note that only one Dispatcher will show the * at one time.