Scheduler
Sugar provides a Scheduler service that can execute predefined functions asynchronously on a periodic basis. The Scheduler integrates with external UNIX systems and Windows systems to run jobs that are scheduled through those systems. The typical configuration is to have a UNIX cron job or a Windows scheduled job execute the Sugar Scheduler service every couple of minutes. The Scheduler service checks the list of Schedulers defined in the Scheduler Admin screen and executes any that are currently due.
A series of Schedulers are defined by default with every Sugar installation such as Process Workflow Tasks and Run Report Generation Scheduled Tasks.
Config Settings
- cron.max_cron_jobs - Determines the maximum number of jobs executed per cron run.
- cron.max_cron_runtime - Determines the maximum amount of time a job can run before forcing a failure.
- cron.min_cron_interval - Specified the minimum amount of time between cron runs.
Considerations
- When defining schedulers, you should note that the scheduler will be run after the specified time and that this execution may not be exact.
- If you are seeing the message "Job runs too frequently, throttled to protect the system." in your sugar log, the cron is being run too frequently. If you would prefer the cron to run more frequently, you can set the cron.min_cron_interval setting to 0 and disable throttling completely.
