::Go back to Oozie Documentation Index::
Coordinator Rerun
Pre-Conditions
- Rerun coordinator action must be in TIMEDOUT/SUCCEEDED/KILLED/FAILED.
- Coordinator actions cannot be rerun if the coordinator job is in the KILLED or FAILED state.
- Rerun a PAUSED coordinator job, the status and pause time and pending flag will not be reset.
- Rerun a SUSPENDED coordinator job, the status will reset to RUNNING.
- All rerun actions must exist already.
- Coordinator Rerun will only use the original configs from first run.
- Coordinator Rerun will not re-read the coordinator.xml in hdfs.
Rerun Arguments
$oozie job -rerun <coord_Job_id> [-nocleanup] [-refresh] [-failed] [-config <arg>]
[-action 1, 3-4, 7-40] (-action or -date is required to rerun.)
[-date 2009-01-01T01:00Z::2009-05-31T23:59Z, 2009-11-10T01:00Z, 2009-12-31T22:00Z]
(if neither -action nor -date is given, the exception will be thrown.)
- Either -action or -date should be given.
- If -action and -date both are given, an error will be thrown.
- Multiple ranges can be used in -action or -date. See the above examples.
- If one of action in the given list of -action does not exist or not in terminal state, the rerun throws an error.
- The dates specified in -date must be UTC.
- Single date specified in -date must be able to find an action with matched nominal time to be effective.
- If -nocleanup is given, coordinator directories will not be removed; otherwise the 'output-event' will be deleted, unless nocleanup attribute is explicitly set in coordinator.xml
- If -refresh is set, new dataset is re-evaluated for latest() and future().
- If -refresh is set, all dependencies will be re-checked; otherwise only missed dependencies will be checked.
- If -failed is set, re-runs the failed workflow actions of the coordinator actions.
- -config can be used to supply properties to workflow by job configuration file '.xml' or '.properties'.
Rerun coordinator actions
- Rerun terminated (timeout, succeeded, killed, failed) coordinator actions.
- By default, Oozie will delete the 'output-event' directories before changing actions' status and materializing actions.
- If coordinator job is RUNNING, rerun actions will be materialized and compete with current running actions.
- Rerun for job, user should use job's start date and end date in -date.
- If the user specifies a date range (say Jan 1 to May 1), the actions that will be re-run are the existing actions
within that range. If the existing actions are action #5....#40, which map to Jan 15 to Feb 15, then only those actions will run.
- The rerun action_id and nominal_time of the actions which are eligible to rerun will be returned.
::Go back to Oozie Documentation Index::