Tools that honor the Number of Retries on Failures environment will retry the same worker process a specified number of attempts when there is a failure processing a particular job.
Usage notes
- Occasionally, failures are encountered when running parallel raster analysis jobs.
- For example, if the tool is running with a custom Python raster function code, failures can be caused by third-party Python code, such as memory errors when the worker process is processing a particular section of an image.
- Having the worker process retry a particular section can recover analysis jobs.
Dialog syntax
- Number of Retries on Failures—The number of retries that will be attempted when a worker process fails. The default is 0.
Scripting syntax
arcpy.env.retryOnFailures = retry_on_failures
Parameter | Explanation |
---|---|
retryOnFailures | The number of times a worker process will be retried when there is failure processing a particular job. The default is 0. |
Script example
import arcpy
# Set the retry on failure to 3
arcpy.env.retryOnFailures = 3