{"_id":"57975504fa1ff60e006a131a","project":"55faf11ba62ba1170021a9a7","user":{"_id":"566590c83889610d0008a253","username":"","name":"Aleksandar Gazibara"},"__v":0,"initVersion":{"_id":"55faf11ba62ba1170021a9aa","version":"1.0"},"createdAt":"2016-07-26T12:18:12.828Z","changelog":[],"body":"Each time you run a tool or a workflow on the Seven Bridges Platform, you create a task. The task goes through several different phases before it is finally completed. A change in its status, displayed in the upper left corner of the task page, marks off each phase, as shown below.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/8bf6ae9-qs-cgc-update1.jpg\",\n        \"qs-cgc-update1.jpg\",\n        1165,\n        805,\n        \"#ecedef\"\n      ],\n      \"border\": true\n    }\n  ]\n}\n[/block]\nYou can also view the task status from the **Tasks** tab of your project.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/951b73d-cgc-qs-edit2.jpg\",\n        \"cgc-qs-edit2.jpg\",\n        1097,\n        487,\n        \"#f0f2f3\"\n      ],\n      \"border\": true\n    }\n  ]\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Status\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"<img src=\\\"https://files.readme.io/ebdd3f5-draft-phase.png\\\" align=\\\"inline\\\" style=\\\"margin:1px; width:auto; height:24px; max-width:none;\\\"/>\",\n    \"0-1\": \"Once you run a tool or a workflow, you create a DRAFT task. During this DRAFT phase, you can set up the analysis by selecting input files and defining the app settings.\\n\\nOnce you click **RUN**, the Platform will perform validations to ensure that suitable information has been entered to run the analysis\\n and will check that your account has sufficient resources to run the task. After your task has been validated, it will move to the next phase and task's status will change to **QUEUED**.\",\n    \"1-0\": \"<img src=\\\"https://files.readme.io/9524626-task-phase-queued.png\\\" align=\\\"inline\\\" style=\\\"margin:1px; width:auto; height:26px; max-width:none;\\\"/>\",\n    \"1-1\": \"When a task is **QUEUED**, you have submitted it for execution for the execution, and it will automatically proceed to the **RUNNING** phase shortly.\",\n    \"2-0\": \"<img src=\\\"https://files.readme.io/3a59e39-running-phase-task.png\\\" align=\\\"inline\\\" style=\\\"margin:1px; width:auto; height:27px; max-width:none;\\\"/>\",\n    \"2-1\": \"During the **RUNNING** phase, the Platform initializes the computation instances to execute your task. You will be able to track your task's progress by observing the information in the Progress field below the task status. The number of already-executed nodes is displayed within the brackets (e.g. 4/18, to indicate 4 out of 18 nodes have been executed).\\n\\nSome background processes also take place as the task initializes. The initializing phase may take a while if:\\n \\nA computation instance the Platform tried to acquire has failed basic validation tests, which indicates that it may be likely to fail during execution.\\n\\nNo computation instance of the requested type is available in the primary AWS or Google Cloud data center and the Platform has to search for an alternative zone's data center.\\n\\nThe Platform has to wait for the computation instance to boot up before running. If, after 3 attempts, the Platform cannot communicate with the instance, the Platform begin the process of acquiring a new instance.\",\n    \"3-0\": \"<img src=\\\"https://files.readme.io/a7f9b77-task-completed-status.png\\\" align=\\\"inline\\\" style=\\\"margin:1px; width:auto; height:29px; max-width:none;\\\"/>\",\n    \"3-1\": \"Your task status displays as **COMPLETED** once your task has successfully completed. This means the analysis has been performed without errors, and you can review the output files of your task.\",\n    \"4-0\": \"<img src=\\\"https://files.readme.io/6dd511e-task-phase-failed.png\\\" align=\\\"inline\\\" style=\\\"margin:1px; width:auto; height:24px; max-width:none;\\\"/>\",\n    \"4-1\": \"If your task status displays as **FAILED**, it means your task ran into a problem during execution and did not finish. You will also receive an error message providing further information on the cause of the task failure (see [troubleshooting a failed task](doc:troubleshoot-a-failed-task)).\",\n    \"5-0\": \"<img src=\\\"https://files.readme.io/a8583fc-task-phase-aborting.png\\\" align=\\\"inline\\\" style=\\\"margin:1px; width:auto; height:24px; max-width:none;\\\"/>\",\n    \"5-1\": \"If you decide to abort your task, the task status displays as **ABORTING**. This means the task has been successfully submitted for cancellation and will be aborted shortly.\",\n    \"6-0\": \"<img src=\\\"https://files.readme.io/4b3c0f1-task-phase-aborted.png\\\" align=\\\"inline\\\" style=\\\"margin:1px; width:auto; height:26px; max-width:none;\\\"/>\",\n    \"6-1\": \"Once your task has been aborted, its status changes to **ABORTED**.\",\n    \"7-0\": \"<img src=\\\"https://files.readme.io/71e8aab-creating-task-status.png\\\" align=\\\"inline\\\" style=\\\"margin:1px; width:auto; height:24px; max-width:none;\\\"/>\",\n    \"7-1\": \"This phase is specific to a parent task when [performing a batch analysis](doc:perform-batch-analysis). Running a batch task involves a **CREATING** phase in which all of the children tasks are created.\\n\\nAfter all children tasks are created, the status changes to **RUNNING**.\\n\\nIf any of the children tasks failed to be created, the parent task's status reverts to **DRAFT**.\"\n  },\n  \"cols\": 2,\n  \"rows\": 8\n}\n[/block]","slug":"what-happens-when-i-run-a-task","title":"What happens when I run a task?"}

What happens when I run a task?


Each time you run a tool or a workflow on the Seven Bridges Platform, you create a task. The task goes through several different phases before it is finally completed. A change in its status, displayed in the upper left corner of the task page, marks off each phase, as shown below. [block:image] { "images": [ { "image": [ "https://files.readme.io/8bf6ae9-qs-cgc-update1.jpg", "qs-cgc-update1.jpg", 1165, 805, "#ecedef" ], "border": true } ] } [/block] You can also view the task status from the **Tasks** tab of your project. [block:image] { "images": [ { "image": [ "https://files.readme.io/951b73d-cgc-qs-edit2.jpg", "cgc-qs-edit2.jpg", 1097, 487, "#f0f2f3" ], "border": true } ] } [/block] [block:parameters] { "data": { "h-0": "Status", "h-1": "Description", "0-0": "<img src=\"https://files.readme.io/ebdd3f5-draft-phase.png\" align=\"inline\" style=\"margin:1px; width:auto; height:24px; max-width:none;\"/>", "0-1": "Once you run a tool or a workflow, you create a DRAFT task. During this DRAFT phase, you can set up the analysis by selecting input files and defining the app settings.\n\nOnce you click **RUN**, the Platform will perform validations to ensure that suitable information has been entered to run the analysis\n and will check that your account has sufficient resources to run the task. After your task has been validated, it will move to the next phase and task's status will change to **QUEUED**.", "1-0": "<img src=\"https://files.readme.io/9524626-task-phase-queued.png\" align=\"inline\" style=\"margin:1px; width:auto; height:26px; max-width:none;\"/>", "1-1": "When a task is **QUEUED**, you have submitted it for execution for the execution, and it will automatically proceed to the **RUNNING** phase shortly.", "2-0": "<img src=\"https://files.readme.io/3a59e39-running-phase-task.png\" align=\"inline\" style=\"margin:1px; width:auto; height:27px; max-width:none;\"/>", "2-1": "During the **RUNNING** phase, the Platform initializes the computation instances to execute your task. You will be able to track your task's progress by observing the information in the Progress field below the task status. The number of already-executed nodes is displayed within the brackets (e.g. 4/18, to indicate 4 out of 18 nodes have been executed).\n\nSome background processes also take place as the task initializes. The initializing phase may take a while if:\n \nA computation instance the Platform tried to acquire has failed basic validation tests, which indicates that it may be likely to fail during execution.\n\nNo computation instance of the requested type is available in the primary AWS or Google Cloud data center and the Platform has to search for an alternative zone's data center.\n\nThe Platform has to wait for the computation instance to boot up before running. If, after 3 attempts, the Platform cannot communicate with the instance, the Platform begin the process of acquiring a new instance.", "3-0": "<img src=\"https://files.readme.io/a7f9b77-task-completed-status.png\" align=\"inline\" style=\"margin:1px; width:auto; height:29px; max-width:none;\"/>", "3-1": "Your task status displays as **COMPLETED** once your task has successfully completed. This means the analysis has been performed without errors, and you can review the output files of your task.", "4-0": "<img src=\"https://files.readme.io/6dd511e-task-phase-failed.png\" align=\"inline\" style=\"margin:1px; width:auto; height:24px; max-width:none;\"/>", "4-1": "If your task status displays as **FAILED**, it means your task ran into a problem during execution and did not finish. You will also receive an error message providing further information on the cause of the task failure (see [troubleshooting a failed task](doc:troubleshoot-a-failed-task)).", "5-0": "<img src=\"https://files.readme.io/a8583fc-task-phase-aborting.png\" align=\"inline\" style=\"margin:1px; width:auto; height:24px; max-width:none;\"/>", "5-1": "If you decide to abort your task, the task status displays as **ABORTING**. This means the task has been successfully submitted for cancellation and will be aborted shortly.", "6-0": "<img src=\"https://files.readme.io/4b3c0f1-task-phase-aborted.png\" align=\"inline\" style=\"margin:1px; width:auto; height:26px; max-width:none;\"/>", "6-1": "Once your task has been aborted, its status changes to **ABORTED**.", "7-0": "<img src=\"https://files.readme.io/71e8aab-creating-task-status.png\" align=\"inline\" style=\"margin:1px; width:auto; height:24px; max-width:none;\"/>", "7-1": "This phase is specific to a parent task when [performing a batch analysis](doc:perform-batch-analysis). Running a batch task involves a **CREATING** phase in which all of the children tasks are created.\n\nAfter all children tasks are created, the status changes to **RUNNING**.\n\nIf any of the children tasks failed to be created, the parent task's status reverts to **DRAFT**." }, "cols": 2, "rows": 8 } [/block]