{"_id":"598db0e23a24fa001985c107","project":"55faf11ba62ba1170021a9a7","version":{"_id":"55faf11ba62ba1170021a9aa","project":"55faf11ba62ba1170021a9a7","__v":38,"createdAt":"2015-09-17T16:58:03.490Z","releaseDate":"2015-09-17T16:58:03.490Z","categories":["55faf11ca62ba1170021a9ab","55faf8f4d0e22017005b8272","55faf91aa62ba1170021a9b5","55faf929a8a7770d00c2c0bd","55faf932a8a7770d00c2c0bf","55faf94b17b9d00d00969f47","55faf958d0e22017005b8274","55faf95fa8a7770d00c2c0c0","55faf96917b9d00d00969f48","55faf970a8a7770d00c2c0c1","55faf98c825d5f19001fa3a6","55faf99aa62ba1170021a9b8","55faf99fa62ba1170021a9b9","55faf9aa17b9d00d00969f49","55faf9b6a8a7770d00c2c0c3","55faf9bda62ba1170021a9ba","5604570090ee490d00440551","5637e8b2fbe1c50d008cb078","5649bb624fa1460d00780add","5671974d1b6b730d008b4823","5671979d60c8e70d006c9760","568e8eef70ca1f0d0035808e","56d0a2081ecc471500f1795e","56d4a0adde40c70b00823ea3","56d96b03dd90610b00270849","56fbb83d8f21c817002af880","573c811bee2b3b2200422be1","576bc92afb62dd20001cda85","5771811e27a5c20e00030dcd","5785191af3a10c0e009b75b0","57bdf84d5d48411900cd8dc0","57ff5c5dc135231700aed806","5804caf792398f0f00e77521","58458b4fba4f1c0f009692bb","586d3c287c6b5b2300c05055","58ef66d88646742f009a0216","58f5d52d7891630f00fe4e77","59a555bccdbd85001bfb1442"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"category":{"_id":"55faf970a8a7770d00c2c0c1","version":"55faf11ba62ba1170021a9aa","pages":["5626a8c022ef6a2100fb3351","5626a9b766c62617009d1717","5626ab339ef9ea0d0029239a","56426aedb48bdf19006a4d34","56426b18b0dc090d00f884e3","56eff15b01da23190009bc74","56eff7ebb31ea117009ed4d4","56effc9d0b91372200aa2a40"],"project":"55faf11ba62ba1170021a9a7","__v":8,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-09-17T17:33:36.928Z","from_sync":false,"order":20,"slug":"review-task","title":"REVIEW A TASK"},"user":"575e85ac41c8ba0e00259a44","__v":0,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-08-11T13:28:02.616Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":3,"body":"##Overview\n\nWhen running a task, jobs can fail for a number of reasons. In some cases, the Platform is able to automatically retry failed jobs, avoiding task failure. Read this page to learn more about the cases when the Platform carries out automatic job retry. \n\n##Mechanisms for job retry\n\nSometimes during task execution, job(s) can fail. Jobs that fail for the reasons described below are retried automatically according to the nature of the interruption:\n\n  * **Instance stops responding.** There are two reasons why this type of interruption might occur and they are indistinguishable to the Platform at runtime:\n   * **Memory or hard disk exhaustion:** The tool demands so many resources that the instance is unable to respond, even to a direct HTTP request.\n   * **Cloud provider issue:** There has been a cloud provider-related network and/or hardware malfunction.\n\n    Following this interruption, unfinished jobs are retried once, since either the initial error is unlikely to be resolved without manually editing the tool or because it is reasonable to expect that the same error will not happen again.\n\n  * **Spot Instance is terminated.** Because of high demand, the market price of the Spot Instance became higher than the bid price. Unfinished jobs will be restarted on On-Demand instance(s) and task execution will be continued on on-demand instance(s). Learn more about [spot instance termination](doc:about-spot-instances#section-the-impact-of-spot-instance-termination).\n\n##Job retry example\n\nThe image below is a screenshot from the [task stats page](doc:view-task-stats), showing how the job retry mechanism steps in when a job is interrupted. \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/600bbfa-job-retry.png\",\n        \"job-retry.png\",\n        961,\n        366,\n        \"#f9fafa\"\n      ]\n    }\n  ]\n}\n[/block]\n  **[ 1 ]** The execution of GATK_IndelRealigner is interrupted, causing this job to fail.\n  **[ 2 ]** The job retry mechanism is triggered and a new instance is being initialized.\n  **[ 3 ]** The job inputs are being downloaded.\n  **[ 4 ]** The Docker image is being pulled.\n  **[ 5 ]** GATK_IndelRealigner is being run from the beginning on a new instance.\n  **[ 6 ]** The job outputs are being uploaded.","excerpt":"<a name=\"top\"></a>","slug":"job-retry","type":"basic","title":"Job retry"}

Job retry

<a name="top"></a>

##Overview When running a task, jobs can fail for a number of reasons. In some cases, the Platform is able to automatically retry failed jobs, avoiding task failure. Read this page to learn more about the cases when the Platform carries out automatic job retry.  ##Mechanisms for job retry Sometimes during task execution, job(s) can fail. Jobs that fail for the reasons described below are retried automatically according to the nature of the interruption: * **Instance stops responding.** There are two reasons why this type of interruption might occur and they are indistinguishable to the Platform at runtime: * **Memory or hard disk exhaustion:** The tool demands so many resources that the instance is unable to respond, even to a direct HTTP request. * **Cloud provider issue:** There has been a cloud provider-related network and/or hardware malfunction. Following this interruption, unfinished jobs are retried once, since either the initial error is unlikely to be resolved without manually editing the tool or because it is reasonable to expect that the same error will not happen again. * **Spot Instance is terminated.** Because of high demand, the market price of the Spot Instance became higher than the bid price. Unfinished jobs will be restarted on On-Demand instance(s) and task execution will be continued on on-demand instance(s). Learn more about [spot instance termination](doc:about-spot-instances#section-the-impact-of-spot-instance-termination). ##Job retry example The image below is a screenshot from the [task stats page](doc:view-task-stats), showing how the job retry mechanism steps in when a job is interrupted.  [block:image] { "images": [ { "image": [ "https://files.readme.io/600bbfa-job-retry.png", "job-retry.png", 961, 366, "#f9fafa" ] } ] } [/block] **[ 1 ]** The execution of GATK_IndelRealigner is interrupted, causing this job to fail. **[ 2 ]** The job retry mechanism is triggered and a new instance is being initialized. **[ 3 ]** The job inputs are being downloaded. **[ 4 ]** The Docker image is being pulled. **[ 5 ]** GATK_IndelRealigner is being run from the beginning on a new instance. **[ 6 ]** The job outputs are being uploaded.