KNOWLEDGE BASE

Missed scheduled tasks are sometimes run after Tableau Server is restarted


Published: 07 Dec 2022
Last Modified Date: 08 Dec 2022

Issue

If Tableau Server is shut down, tasks such as extract refreshes that were scheduled to run while Tableau Server was stopped are sometimes run when Tableau Server is restarted, despite being past the scheduled time.
As making up a missed task at server startup may or may not be desired, this behavior can be adjusted according to the user's needs in order to avoid unexpected task runs or allow vital tasks to be made up in the case of downtime.
 

Environment

  • Tableau Server

Resolution

The tsm setting backgrounder.out_of_date_schedule_minutes determines how far back the scheduler will attempt to make up a missed task before deciding to skip it until the next scheduled time. This value defaults to 240, so by default when Tableau Server starts up, it will run scheduled tasks that are up to four hours overdue.

To adjust this value, run the following commands:
1. tsm configuration set -k backgrounder.out_of_date_schedule_minutes -v <value>
2. tsm pending-changes apply

The second step requires restarting Tableau Server.

Because this value affects not only User-visible schedules, but also internal schedules that manage data-driven alerts as well as the cleanup of unnecessary files, apply due diligence to verify the effects of the change, particular to disk usage, in a staging environment before applying the change in a production environment.

Cause

The behavior is by design.There is a tsm setting backgrounder.out_of_date_schedule_minutes that determines how far back the scheduler will attempt to make up a missed task before deciding to skip it until the next scheduled time. 
Did this article resolve the issue?