{"_id":"58dd0c5d1f8bff1900b4bdb1","__v":0,"parentDoc":null,"githubsync":"","project":"5773dcfc255e820e00e1cd4d","user":"575e85ac41c8ba0e00259a44","category":{"_id":"577baf92451b1e0e006075ac","__v":0,"project":"5773dcfc255e820e00e1cd4d","version":"5773dcfc255e820e00e1cd50","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-07-05T13:01:06.540Z","from_sync":false,"order":6,"slug":"developer-hub","title":"Developer tools"},"version":{"_id":"5773dcfc255e820e00e1cd50","__v":26,"project":"5773dcfc255e820e00e1cd4d","createdAt":"2016-06-29T14:36:44.812Z","releaseDate":"2016-06-29T14:36:44.812Z","categories":["5773dcfc255e820e00e1cd51","5773df36904b0c0e00ef05ff","577baf92451b1e0e006075ac","577bb183b7ee4a0e007c4e8d","577ce77a1cf3cb0e0048e5ea","577d11865fd4de0e00cc3dab","578e62792c3c790e00937597","578f4fd98335ca0e006d5c84","578f5e5c3d04570e00976ebb","57bc35f7531e000e0075d118","57f801b3760f3a1700219ebb","5804d55d1642890f00803623","581c8d55c0dc651900aa9350","589dcf8ba8c63b3b00c3704f","594cebadd8a2f7001b0b53b2","59a562f46a5d8c00238e309a","5a2aa096e25025003c582b58","5a2e79566c771d003ca0acd4","5a3a5166142db90026f24007","5a3a52b5bcc254001c4bf152","5a3a574a2be213002675c6d2","5a3a66bb2be213002675cb73","5a3a6e4854faf60030b63159","5c8a68278e883901341de571","5cb9971e57bf020024523c7b","5cbf1683e2a36d01d5012ecd"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"metadata":{"title":"","description":"","image":[]},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-03-30T13:47:09.430Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":17,"body":"[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Hint name\",\n    \"h-1\": \"Workflow level\",\n    \"h-2\": \"Node level\",\n    \"h-3\": \"Tool level\",\n    \"h-4\": \"Default\",\n    \"h-5\": \"Notes\",\n    \"h-6\": \"See also\",\n    \"0-0\": \"`sbg:CPURequirement`<sup>1</sup>\\nAllocates this many CPU cores for the execution of the tool.\",\n    \"1-2\": \":no-entry-sign:\",\n    \"0-3\": \":white-check-mark:\",\n    \"2-4\": \"Decided by the scheduling algorithm\",\n    \"2-5\": \":warning: The task will fail if the resources available on the instance are insufficient for any tool in the workflow.\",\n    \"0-2\": \":no-entry-sign:\",\n    \"0-1\": \":no-entry-sign:\",\n    \"0-4\": \"1\",\n    \"0-5\": \"Accepts dynamic expressions\",\n    \"0-6\": \"[Tool resource requirements](doc:about-tool-resource-requirements)\",\n    \"1-1\": \":no-entry-sign:\",\n    \"1-3\": \":white-check-mark:\",\n    \"2-1\": \":white-check-mark:\",\n    \"2-2\": \":white-check-mark:\",\n    \"2-3\": \":white-check-mark:\",\n    \"3-1\": \":white-check-mark:\",\n    \"4-3\": \":white-check-mark:\",\n    \"3-2\": \":no-entry-sign:\",\n    \"3-3\": \":no-entry-sign:\",\n    \"4-1\": \":no-entry-sign:\",\n    \"4-2\": \":no-entry-sign:\",\n    \"3-5\": \":warning:  If a step is an inner workflow, its `sbg:maxNumberOfParallelInstances` will be overridden with the value from the outer workflow, even if it has not been set explicitly (*i.e.* the default value takes precedence).\",\n    \"1-5\": \"Accepts dynamic expressions\",\n    \"1-4\": \"1024 [MB]\",\n    \"3-4\": \"1\",\n    \"4-4\": \"file name\",\n    \"1-0\": \"`sbg:MemRequirement`<sup>1</sup>\\nAllocates this much MB of RAM for the execution of the tool.\",\n    \"2-0\": \"`sbg:AWSInstanceType`\\nConfigures the type of all the AWS instances provisioned for this workflow/node/tool.\\nPriority: \\n*workflow > node > tool*\",\n    \"3-0\": \"`sbg:maxNumberOfParallelInstances`\\nSets the maximum number of instances that can run in parallel for workflow execution.\",\n    \"4-0\": \"`sbg:SaveLogs`\\nConfigures the additional files to preserve as logs inside the project\",\n    \"1-6\": \"[Tool resource requirements](doc:about-tool-resource-requirements)\",\n    \"2-6\": \"[AWS US East instances](doc:list-of-available-amazon-web-services-instances) \\n\\n[AWS EU instances](doc:list-of-available-amazon-web-services-eu-instances)\"\n  },\n  \"cols\": 7,\n  \"rows\": 5\n}\n[/block]\n<sup>1</sup> The hints prefixed with **sbg:** are specific for the Seven Bridges execution environment. CWL 1.0 introduces **coresMin** / **coresMax** (minimum and maximum number of CPU cores) and **ramMin** / **ramMax** (minimum and maximum amount of RAM) in [resource requirements](http://www.commonwl.org/v1.0/CommandLineTool.html#ResourceRequirement), which can be found on any level (**Workflow**, **Step**, **Tool**). If your CWL 1.0 app description contains only the **-Min** or the **-Max** value, the Seven Bridges execution environment will use the specified value as the number of cores or amount of RAM required for execution. If both the **-Min** and the **-Max** value are specified, the execution will ignore the **-Max** value and provide enough resources to accommodate the **-Min** requirement, in order to provide consistency in execution of apps described using either sbg:draft-2 or 1.0 version of CWL. Finally, if **sbg:CPURequirement** or **sbg:MemRequirement** are evaluated along with the corresponding CWL 1.0 **-Min** requirements (**coresMin** or **ramMin**), the execution will use the higher of these two values as the required number of cores or amount of RAM.\n\nDisk space requirements introduced in CWL 1.0 (**tmpdirMin** / **tmpdirMax** and **outdirMin** / **outdirMax**) are unfortunately not currently supported by Cavatica.","excerpt":"","slug":"list-of-execution-hints","type":"basic","title":"List of execution hints"}

List of execution hints


[block:parameters] { "data": { "h-0": "Hint name", "h-1": "Workflow level", "h-2": "Node level", "h-3": "Tool level", "h-4": "Default", "h-5": "Notes", "h-6": "See also", "0-0": "`sbg:CPURequirement`<sup>1</sup>\nAllocates this many CPU cores for the execution of the tool.", "1-2": ":no-entry-sign:", "0-3": ":white-check-mark:", "2-4": "Decided by the scheduling algorithm", "2-5": ":warning: The task will fail if the resources available on the instance are insufficient for any tool in the workflow.", "0-2": ":no-entry-sign:", "0-1": ":no-entry-sign:", "0-4": "1", "0-5": "Accepts dynamic expressions", "0-6": "[Tool resource requirements](doc:about-tool-resource-requirements)", "1-1": ":no-entry-sign:", "1-3": ":white-check-mark:", "2-1": ":white-check-mark:", "2-2": ":white-check-mark:", "2-3": ":white-check-mark:", "3-1": ":white-check-mark:", "4-3": ":white-check-mark:", "3-2": ":no-entry-sign:", "3-3": ":no-entry-sign:", "4-1": ":no-entry-sign:", "4-2": ":no-entry-sign:", "3-5": ":warning: If a step is an inner workflow, its `sbg:maxNumberOfParallelInstances` will be overridden with the value from the outer workflow, even if it has not been set explicitly (*i.e.* the default value takes precedence).", "1-5": "Accepts dynamic expressions", "1-4": "1024 [MB]", "3-4": "1", "4-4": "file name", "1-0": "`sbg:MemRequirement`<sup>1</sup>\nAllocates this much MB of RAM for the execution of the tool.", "2-0": "`sbg:AWSInstanceType`\nConfigures the type of all the AWS instances provisioned for this workflow/node/tool.\nPriority: \n*workflow > node > tool*", "3-0": "`sbg:maxNumberOfParallelInstances`\nSets the maximum number of instances that can run in parallel for workflow execution.", "4-0": "`sbg:SaveLogs`\nConfigures the additional files to preserve as logs inside the project", "1-6": "[Tool resource requirements](doc:about-tool-resource-requirements)", "2-6": "[AWS US East instances](doc:list-of-available-amazon-web-services-instances) \n\n[AWS EU instances](doc:list-of-available-amazon-web-services-eu-instances)" }, "cols": 7, "rows": 5 } [/block] <sup>1</sup> The hints prefixed with **sbg:** are specific for the Seven Bridges execution environment. CWL 1.0 introduces **coresMin** / **coresMax** (minimum and maximum number of CPU cores) and **ramMin** / **ramMax** (minimum and maximum amount of RAM) in [resource requirements](http://www.commonwl.org/v1.0/CommandLineTool.html#ResourceRequirement), which can be found on any level (**Workflow**, **Step**, **Tool**). If your CWL 1.0 app description contains only the **-Min** or the **-Max** value, the Seven Bridges execution environment will use the specified value as the number of cores or amount of RAM required for execution. If both the **-Min** and the **-Max** value are specified, the execution will ignore the **-Max** value and provide enough resources to accommodate the **-Min** requirement, in order to provide consistency in execution of apps described using either sbg:draft-2 or 1.0 version of CWL. Finally, if **sbg:CPURequirement** or **sbg:MemRequirement** are evaluated along with the corresponding CWL 1.0 **-Min** requirements (**coresMin** or **ramMin**), the execution will use the higher of these two values as the required number of cores or amount of RAM. Disk space requirements introduced in CWL 1.0 (**tmpdirMin** / **tmpdirMax** and **outdirMin** / **outdirMax**) are unfortunately not currently supported by Cavatica.