quartz jobDetail requestRecovery

quartz-scheduler fault-tolerance
user1746050 picture user1746050 · Oct 9, 2013 · Viewed 7.9k times · Source

The documentation for JobDetail.requestsRecovery property states the following

Instructs the Scheduler whether or not the Job should be re-executed if a 'recovery' or 'fail-over' situation is encountered.

Now, what is a 'recovery' situation or a 'fail-over' situation?

How are they different?

Does the recovery happen only if the JVM crashes during job execution or does it happen if the job execution fails because of an exception also?

Answer

zerologiko picture zerologiko · Oct 9, 2013

A "Recovery situation" is the generic term, one kind of recovery situation is the "fail-over".

A fail-over is a process used by fault-tolerance systems generally used with redundancy (e.g. clustering). Quartz use fail-over when is used in clustering and more Quartz "nodes" exists.

Quoting documentation:

Fail-over occurs when one of the nodes fails while in the midst of executing one or more jobs. When a node fails, the other nodes detect the condition and identify the jobs in the database that were in progress within the failed node. Any jobs marked for recovery (with the "requests recovery" property on the JobDetail) will be re-executed by the remaining nodes.

A recovery situation is every situation that produce an "Hard-shutdown" (i.e. the process it is running within crashes, or the machine is shut down).

To answer your second question:

  • If the JVM crashes during a job execution > Quartz will recover the job

    (Because a crash is Recovery situation)

  • if the job execution fails because of an exception > Quartz will not recover the job

    (Because exception is not an hard-shutdown, a misfire is thrown instead)

See this answer to activate recovery for your jobs.

Related questions

inject bean reference into a Quartz job in Spring?

I managed to configure and schedule a Quartz job using JobStoreTX persistent store in Spring. I do not use Spring's Quartz jobs, because I need to schedule them dynamically, at run time, and all examples of integrating Spring with Quartz …

Read More
Quartz: Cron expression that will never execute

I know there is a duplicate here, which probably is exactly my case, though it would deserve some better explanation, which I will try to provide here. I work with a Java web application using a Spring application context. In …

Read More
How to run every 25 seconds in Quartz scheduler?

I am using the Quartz Scheduling API for Java. Could you help me to run every 25 seconds using cron-expression. It's just a delay. It does not have to start always at second 0. For example, the sequence is like this: 0:00, 0:25, 0:50, 1:15, 1:40, 2:05, etc …

Read More