| <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
| <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr"> |
| <head> |
| <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> |
| <meta name="keywords" content="SMILA/Documentation/JobRuns,SMILA/Documentation/JobDefinitions" /> |
| <link rel="shortcut icon" href="http://wiki.eclipse.org/SMILA/Documentation/favicon.ico" /> |
| <link rel="search" type="application/opensearchdescription+xml" href="http://wiki.eclipse.org/opensearch_desc.php" title="Eclipsepedia (English)" /> |
| <link rel="alternate" type="application/rss+xml" title="Eclipsepedia RSS Feed" href="http://wiki.eclipse.org/index.php?title=Special:Recentchanges&feed=rss" /> |
| <link rel="alternate" type="application/atom+xml" title="Eclipsepedia Atom Feed" href="http://wiki.eclipse.org/index.php?title=Special:Recentchanges&feed=atom" /> |
| |
| |
| <title>SMILA/Documentation/JobRuns - Eclipsepedia</title> |
| |
| <style type="text/css" media="screen,projection">/*<![CDATA[*/ @import "/skins/eclipsenova/novaWide.css?116"; /*]]>*/</style> |
| <link rel="stylesheet" type="text/css" media="print" href="http://wiki.eclipse.org/skins/eclipsenova/eclipsenovaPrint.css?116" /> |
| <link rel="stylesheet" type="text/css" media="handheld" href="http://wiki.eclipse.org/skins/eclipsenova/handheld.css?116" /> |
| <link rel="stylesheet" type="text/css" href="http://wiki.eclipse.org/skins/eclipsenova/Nova/css/header.css" media="screen" /> |
| <link rel="stylesheet" type="text/css" href="http://wiki.eclipse.org/skins/eclipsenova/tabs.css" media="screen" /> |
| <link rel="stylesheet" type="text/css" href="http://wiki.eclipse.org/skins/eclipsenova/Nova/css/visual.css" media="screen" /> |
| <link rel="stylesheet" type="text/css" href="http://wiki.eclipse.org/skins/eclipsenova/Nova/css/layout.css" media="screen" /> |
| <link rel="stylesheet" type="text/css" href="http://wiki.eclipse.org/skins/eclipsenova/Nova/css/footer.css" media="screen" /> |
| <!--[if IE]><link rel="stylesheet" type="text/css" href="/skins/eclipsenova/IEpngfix.css" media="screen" /><![endif]--> |
| <!--[if lt IE 5.5000]><style type="text/css">@import "/skins/eclipsenova/IE50Fixes.css?116";</style> <![endif]--> |
| <!--[if IE 5.5000]><style type="text/css">@import "/skins/eclipsenova/IE55Fixes.css?116";</style><![endif]--> |
| <!--[if IE 6]><style type="text/css">@import "/skins/eclipsenova/IE60Fixes.css?116";</style><![endif]--> |
| <!--[if IE 7]><style type="text/css">@import "/skins/eclipsenova/IE70Fixes.css?116";</style><![endif]--> |
| <!--[if lt IE 7]><script type="text/javascript" src="/skins/common/IEFixes.js?116"></script> |
| <meta http-equiv="imagetoolbar" content="no" /><![endif]--> |
| <script type= "text/javascript">/*<![CDATA[*/ |
| var skin = "eclipsenova"; |
| var stylepath = "/skins"; |
| var wgArticlePath = "/$1"; |
| var wgScriptPath = ""; |
| var wgScript = "/index.php"; |
| var wgServer = "http://wiki.eclipse.org"; |
| var wgCanonicalNamespace = ""; |
| var wgCanonicalSpecialPageName = false; |
| var wgNamespaceNumber = 0; |
| var wgPageName = "SMILA/Documentation/JobRuns"; |
| var wgTitle = "SMILA/Documentation/JobRuns"; |
| var wgAction = "view"; |
| var wgRestrictionEdit = []; |
| var wgRestrictionMove = []; |
| var wgArticleId = "32457"; |
| var wgIsArticle = true; |
| var wgUserName = null; |
| var wgUserGroups = null; |
| var wgUserLanguage = "en"; |
| var wgContentLanguage = "en"; |
| var wgBreakFrames = false; |
| var wgCurRevisionId = "267004"; |
| var wgVersion = "1.12.0"; |
| var wgEnableAPI = true; |
| var wgEnableWriteAPI = false; |
| /*]]>*/</script> |
| |
| <script type="text/javascript" src="http://wiki.eclipse.org/skins/common/wikibits.js?116"><!-- wikibits js --></script> |
| |
| <!-- Performance mods similar to those for bug 166401 --> |
| <script type="text/javascript" src="http://wiki.eclipse.org/index.php?title=-&action=raw&gen=js&useskin=eclipsenova"><!-- site js --></script> |
| |
| <!-- Head Scripts --> |
| <script type="text/javascript" src="http://wiki.eclipse.org/skins/common/ajax.js?116"></script> |
| <link rel="stylesheet" type="text/css" href="JobRuns.html" /> </head> |
| <body class="mediawiki ns-0 ltr page-SMILA_Documentation_JobRuns"> |
| <div id="globalWrapper"> |
| |
| |
| <div id="column-one"> |
| <!-- Eclipse Additions for the Top Nav start here M. Ward--> |
| |
| <div id="header"> |
| <div id="header-graphic"> |
| <img src="http://wiki.eclipse.org/skins/eclipsenova/eclipse.png" alt="Eclipse Wiki"> |
| </div> |
| <!-- Pulled 101409 Mward --> |
| |
| <div class="portlet" id="p-personal"> |
| <div class="pBody"> |
| <ul> |
| <li id="pt-login"><a href="http://wiki.eclipse.org/index.php?title=Special:Userlogin&returnto=SMILA/Documentation/JobRuns">Log in</a></li> |
| </ul> |
| </div> |
| </div> |
| |
| <div id="header-icons"> |
| <div id="sites"> |
| <ul id="sitesUL"> |
| <li><a href="http://www.eclipse.org"><img src="http://dev.eclipse.org/custom_icons/eclipseIcon.png" width="28" height="28" alt="Eclipse Foundation" title="Eclipse Foundation" /><div>Eclipse Foundation</div></a></li> |
| <li><a href="http://marketplace.eclipse.org"><img src="http://dev.eclipse.org/custom_icons/marketplace.png" width="28" height="28" alt="Eclipse Marketplace" title="Eclipse Marketplace" /><div>Eclipse Marketplace</div></a></li> |
| <li><a href="https://bugs.eclipse.org/bugs"><img src="http://dev.eclipse.org/custom_icons/system-search-bw.png" width="28" height="28" alt="Bugzilla" title="Bugzilla" /><div>Bugzilla</div></a></li> |
| <li><a href="http://live.eclipse.org"><img src="http://dev.eclipse.org/custom_icons/audio-input-microphone-bw.png" width="28" height="28" alt="Live" title="Live" /><div>Eclipse Live</div></a></li> |
| <li><a href="http://planeteclipse.org"><img src="http://dev.eclipse.org/large_icons/devices/audio-card.png" width="28" height="28" alt="PlanetEclipse" title="Planet" /><div>Planet Eclipse</div></a></li> |
| <li><a href="http://portal.eclipse.org"><img src="http://dev.eclipse.org/custom_icons/preferences-system-network-proxy-bw.png" width="28" height="28" alt="Portal" title="Portal" /><div>My Foundation Portal</div></a></li> |
| </ul> |
| </div> |
| </div> |
| </div> |
| <!-- NEW HEADER STUFF HERE --> |
| <div id="header-menu"> |
| <div id="header-nav"> |
| <ul> <li><a class="first_one" href="http://wiki.eclipse.org/" target="_self">Home</a></li> <li><a href="http://www.eclipse.org/downloads/" target="_self">Downloads</a></li> |
| <li><a href="http://www.eclipse.org/users/" target="_self">Users</a></li> |
| <li><a href="http://www.eclipse.org/membership/" target="_self">Members</a></li> |
| <li><a href="http://wiki.eclipse.org/index.php/Development_Resources" target="_self">Committers</a></li> |
| <li><a href="http://www.eclipse.org/resources/" target="_self">Resources</a></li> |
| <li><a href="http://www.eclipse.org/projects/" target="_self">Projects</a></li> |
| <li><a href="http://www.eclipse.org/org/" target="_self">About Us</a></li> |
| </ul> |
| </div> |
| <div id="header-utils"> |
| <!-- moved the search window here --> |
| <form action="http://wiki.eclipse.org/Special:Search" > |
| <input class="input" name="search" type="text" accesskey="f" value="" /> |
| <input type='submit' onclick="this.submit();" name="go" id="searchGoButton" class="button" title="Go to a page with this exact name if one exists" value="Go" /> |
| <input type='submit' onclick="this.submit();" name="fulltext" class="button" id="mw-searchButton" title="Search Eclipsepedia for this text" value="Search" /> |
| </form> |
| </div> |
| </div> |
| |
| |
| <!-- Eclipse Additions for the Header stop here --> |
| <!-- Additions and mods for leftside nav Start here --> |
| |
| <!--Started nav rip here--> |
| <!-- these are the nav controls main page, changes etc --> |
| <div id="novaContent" class="faux"> |
| <div id="leftcol"> |
| <ul id="leftnav"> |
| <!-- these are the page controls, edit history etc --> |
| <li class="separator"><a class="separator">Navigation   </li> |
| <li id="n-mainpage"><a href="http://wiki.eclipse.org/Main_Page">Main Page</a></li> |
| <li id="n-portal"><a href="http://wiki.eclipse.org/Eclipsepedia:Community_Portal">Community portal</a></li> |
| <li id="n-currentevents"><a href="http://wiki.eclipse.org/Eclipsepedia:Current_events">Current events</a></li> |
| <li id="n-recentchanges"><a href="http://wiki.eclipse.org/Special:Recentchanges">Recent changes</a></li> |
| <li id="n-randompage"><a href="http://wiki.eclipse.org/Special:Random">Random page</a></li> |
| <li id="n-help"><a href="http://wiki.eclipse.org/Help:Contents">Help</a></li> |
| <li class="separator"><a class="separator">Toolbox   </a></li> |
| |
| <li id="t-whatlinkshere"><a href="http://wiki.eclipse.org/Special:Whatlinkshere/SMILA/Documentation/JobRuns">What links here</a></li> |
| <li id="t-recentchangeslinked"><a href="http://wiki.eclipse.org/Special:Recentchangeslinked/SMILA/Documentation/JobRuns">Related changes</a></li> |
| <!-- This is the toolbox section --> |
| <li id="t-upload"><a href="http://wiki.eclipse.org/Special:Upload">Upload file</a></li> |
| <li id="t-specialpages"><a href="http://wiki.eclipse.org/Special:Specialpages">Special pages</a></li> |
| <li id="t-print"><a href="http://wiki.eclipse.org/index.php?title=SMILA/Documentation/JobRuns&printable=yes">Printable version</a></li> <li id="t-permalink"><a href="http://wiki.eclipse.org/index.php?title=SMILA/Documentation/JobRuns&oldid=267004">Permanent link</a></li> </ul> |
| </div> |
| |
| |
| <!-- Additions and mods for leftside nav End here --> |
| |
| |
| <div id="column-content"> |
| <div id="content"> |
| <a name="top" id="top"></a> |
| |
| <div id="tabs"> |
| <ul class="primary"> |
| <li class="active"><a href="JobRuns.html"><span class="tab">Page</span></a></li> |
| <li><a href="http://wiki.eclipse.org/index.php?title=Talk:SMILA/Documentation/JobRuns&action=edit"><span class="tab">Discussion</span></a></li> |
| <li><a href="http://wiki.eclipse.org/index.php?title=SMILA/Documentation/JobRuns&action=edit"><span class="tab">View source</span></a></li> |
| <li><a href="http://wiki.eclipse.org/index.php?title=SMILA/Documentation/JobRuns&action=history"><span class="tab">History</span></a></li> |
| <li><a href="http://wiki.eclipse.org/index.php?title=Special:Userlogin&returnto=SMILA/Documentation/JobRuns"><span class="tab">Edit</span></a></li> |
| </ul> |
| </div> |
| |
| |
| <script type="text/javascript"> if (window.isMSIE55) fixalpha(); </script> |
| <h1 class="firstHeading">SMILA/Documentation/JobRuns</h1> |
| <div id="bodyContent"> |
| <h3 id="siteSub">From Eclipsepedia</h3> |
| <div id="contentSub"><span class="subpages">< <a href="../../SMILA.html" title="SMILA">SMILA</a> | <a href="../Documentation.html" title="SMILA/Documentation">Documentation</a></span></div> |
| <div id="jump-to-nav">Jump to: <a href="JobRuns.html#column-one">navigation</a>, <a href="JobRuns.html#searchInput">search</a></div> <!-- start content --> |
| <div class="messagebox" style="background-color: #def3fe; border: 1px solid #c5d7e0; color: black; padding: 5px; margin: 1ex 0; min-height: 35px; padding-left: 45px;"> |
| <div style="float: left; margin-left: -40px;"><a href="http://wiki.eclipse.org/Image:Note.png" class="image" title="Note.png"><img alt="" src="http://wiki.eclipse.org/images/c/cc/Note.png" width="35" height="35" border="0" /></a></div> |
| <div><b> Available since SMILA 0.9!</b><br /></div> |
| </div> |
| <table id="toc" class="toc" summary="Contents"><tr><td><div id="toctitle"><h2>Contents</h2></div> |
| <ul> |
| <li class="toclevel-1"><a href="JobRuns.html#Job_runs"><span class="tocnumber">1</span> <span class="toctext">Job runs</span></a> |
| <ul> |
| <li class="toclevel-2"><a href="JobRuns.html#Job_modes"><span class="tocnumber">1.1</span> <span class="toctext">Job modes</span></a></li> |
| <li class="toclevel-2"><a href="JobRuns.html#Start_job_run"><span class="tocnumber">1.2</span> <span class="toctext">Start job run</span></a></li> |
| <li class="toclevel-2"><a href="JobRuns.html#Monitor_a_job_run_or_delete_job_run_data"><span class="tocnumber">1.3</span> <span class="toctext">Monitor a job run or delete job run data</span></a></li> |
| <li class="toclevel-2"><a href="JobRuns.html#Monitor_a_job_run_with_details"><span class="tocnumber">1.4</span> <span class="toctext">Monitor a job run with details</span></a></li> |
| <li class="toclevel-2"><a href="JobRuns.html#Finish_job_run"><span class="tocnumber">1.5</span> <span class="toctext">Finish job run</span></a></li> |
| <li class="toclevel-2"><a href="JobRuns.html#Cancel_job_run"><span class="tocnumber">1.6</span> <span class="toctext">Cancel job run</span></a></li> |
| <li class="toclevel-2"><a href="JobRuns.html#Monitor_a_workflow_run"><span class="tocnumber">1.7</span> <span class="toctext">Monitor a workflow run</span></a></li> |
| </ul> |
| </li> |
| </ul> |
| </td></tr></table><script type="text/javascript"> if (window.showTocToggle) { var tocShowText = "show"; var tocHideText = "hide"; showTocToggle(); } </script> |
| <a name="Job_runs"></a><h1> <span class="mw-headline"> Job runs </span></h1> |
| <p>With a <a href="JobDefinitions.html" title="SMILA/Documentation/JobDefinitions">job definition</a> alone, the system is not yet doing anything. First, the job must be started to get a so called job run. How the actual processing is then triggered, depends on the mode of the job run. |
| </p> |
| <a name="Job_modes"></a><h2> <span class="mw-headline"> Job modes </span></h2> |
| <p>There are two different modes in which job runs can be operated: |
| </p> |
| <ul><li> Job runs in "standard" mode are triggered with every new object that is dropped into the bucket connected to the start action of the respective workflow. They continue until they are finished manually. Once in the FINISHING state, no new workflow runs are accepted anymore, but the active ones continue until completed. |
| </li><li> Job runs in "runOnce" mode require that the connected workflow has exactly one input bucket in its start action. Unlike job runs in standard mode, they do not react on new objects but process all objects that are currently contained in the respective input bucket and then finish automatically. Once in the FINISHING state, they do not react on further changes and then go to SUCCESSFUL when all tasks have been processed successfully. If something goes wrong while creating the tasks, the job run goes to state FAILED immediately and no task should be processed at all. All tasks are executed in a single workflow run. The details of the task creation depend on the start action worker, because the task creation is actually done by the worker's task generator. Usually it will create one task for each object in the input bucket. |
| </li></ul> |
| <a name="Start_job_run"></a><h2> <span class="mw-headline"> Start job run </span></h2> |
| <p>Use a POST request to start a job run in "standard" mode. To start a job run in "runOnce" mode, add the following simple JSON object to the request body: |
| </p> |
| <pre> |
| { |
| "mode": "runOnce" |
| } |
| </pre> |
| <p><b>Supported operations:</b> |
| </p> |
| <ul><li>POST: Start job run. |
| </li></ul> |
| <p><b>Usage:</b> |
| </p> |
| <ul><li>URL: <tt>http://<hostname>:8080/smila/jobmanager/jobs/<job-name>/</tt> |
| </li><li>Allowed methods: |
| <ul><li>POST (with optional request body specifying the mode) |
| </li></ul> |
| </li><li>Response status codes: |
| <ul><li>200 OK: Upon successful execution. A JSON object with <tt>jobId</tt> and <tt>url</tt> will be returned. |
| </li></ul> |
| </li></ul> |
| <p><b>Example:</b> |
| </p><p>To start the job named "myJob" in "standard" mode: |
| </p> |
| <pre> |
| POST /smila/jobmanager/jobs/myJob/ |
| </pre> |
| <p>The result would be: |
| </p> |
| <pre> |
| HTTP/1.x 200 OK |
| |
| { |
| "jobId" : "20110712-184509666721", |
| "url" : "http://localhost:8080/smila/jobmanager/jobs/myJob/20110712-184509666721/" |
| } |
| </pre> |
| <p>To start the job named "myJob" in "runOnce" mode: |
| </p> |
| <pre> |
| POST /smila/jobmanager/jobs/myJob/ |
| |
| { |
| "mode": "runOnce" |
| } |
| </pre> |
| <p>The result object would be equal to "standard" mode. |
| </p> |
| <a name="Monitor_a_job_run_or_delete_job_run_data"></a><h2> <span class="mw-headline"> Monitor a job run or delete job run data </span></h2> |
| <p>Use a GET request to view job run data of a specific job run. Use DELETE to delete the data of a specific job run. |
| </p><p><b>Job run data:</b> |
| </p><p>The following parameters are contained in the job run data: |
| </p> |
| <ul><li><tt>jobId</tt>: The ID of the job run. |
| </li><li><tt>runMode</tt>: The mode of the job run, i.e. either <tt>STANDARD</tt> or <tt>RUNONCE</tt>. |
| </li><li><tt>state</tt>: The current status of the job run. May be one of the following: |
| <ul><li><tt>PREPARING</tt>: started but not running yet |
| </li><li><tt>RUNNING</tt>: running |
| </li><li><tt>FINISHING</tt>: finished but not completed yet |
| </li><li><tt>SUCCEEDED</tt>: successfully completed |
| </li><li><tt>FAILED</tt>: failed |
| </li><li><tt>CANCELING</tt>: canceled, but clean-up is not yet completed. |
| </li><li><tt>CANCELED</tt>: canceling done. |
| </li></ul> |
| </li><li><tt>workflowRuns</tt>: Describes the workflow runs which are part of this job run. Note: startedWorkflowRunCount == activeWorkflowRunCount + successfulWorkflowRunCount + failedWorkflowRunCount + canceledWorkflowRuns |
| <ul><li><tt>startedWorkflowRunCount</tt>: The number of started workflow runs. |
| </li><li><tt>activeWorkflowRunCount</tt>: The number of active workflow runs. |
| </li><li><tt>successfulWorkflowRunCount</tt>: The number of successfully finished workflow runs. |
| </li><li><tt>failedWorkflowRunCount</tt>: The number of failed workflow runs. |
| </li><li><tt>canceledWorkflowRunCount</tt>: The number of canceled workflow runs. |
| </li></ul> |
| </li><li><tt>tasks</tt>: Describes the tasks which are part of this job run. After the job has finished it should be createdTaskCount == successfulTaskCount + retriedAfterErrorTaskCount + retriedAfterTimeoutTaskCount + failedAfterRetryTaskCount + failedWithoutRetryTaskCount + canceledTaskCount + obsoleteTaskCount. However, we cannot strictly guarantee this, under very high load it's possible that a task is not counted correctly. |
| <ul><li> <tt>createdTaskCount</tt>: The number of tasks created in this run. This includes tasks created due to retry. |
| </li><li> <tt>successfulTaskCount</tt>: The number of tasks that were finished successfully by a worker. |
| </li><li> <tt>retriedAfterErrorTaskCount</tt>: The number of tasks that were retried because a worker finished the task with a recoverable error (e.g. IOError while reading the input or writing the output). |
| </li><li> <tt>retriedAfterTimeoutTaskCount</tt>: The number of tasks that were retried because a worker did not send the "keepAlive" signal anymore. |
| </li><li> <tt>failedAfterRetryTaskCount</tt>: The number of tasks that finally failed after reaching the configured maximum number of retries. |
| </li><li> <tt>failedWithoutRetryTaskCount</tt>: The number of tasks that finally failed because the worker finished the task with a fatal error (e.g. due to corrupt input data). |
| </li><li> <tt>canceledTaskCount</tt>: The number of tasks that were canceled because a workflow run was canceled or failed due to another task in the workflow run having finally failed. They may have produced their result successfully, but they did not trigger follow-up tasks. |
| </li><li> <tt>obsoleteTaskCount</tt>: The number of tasks that became obsolete for some reason. The difference to 'canceledTaskCount' is that becoming obsolete is not triggered by an error on the workflow run resp. another task. It's just that the cause / precondition to process this task is gone. |
| </li></ul> |
| </li><li> <tt>startTime</tt>: The timestamp when the job run was started (DateTime format ISO). |
| </li><li> <tt>finishTime</tt>: The timestamp when the finish command was called for this job run (DateTime format ISO). |
| </li><li> <tt>endTime</tt>: The timestamp when the job status changed to <tt>SUCCEEDED</tt>, <tt>FAILED</tt> or <tt>CANCELED</tt>. |
| </li><li> <tt>worker</tt>: Contains accumulated job run data for all workers that have contributed to this job run. It contains: |
| <ul><li> The number of successful, failed, and retried tasks for each worker in this job run (same counter names and meanings as in the global section above). |
| </li><li> <tt>startTime</tt>: The timestamp when the first task for a worker of this type was started in the job run (DateTime format ISO). |
| </li><li> <tt>finishTime</tt>: The timestamp when the latest task for a worker of this type was finished in the job run (DateTime format ISO). This timestamp is updated with every finished task. |
| </li><li> The accumulated counters as reported by the workers in their result descriptions. |
| </li></ul> |
| </li></ul> |
| <p><b>Supported operations:</b> |
| </p> |
| <ul><li>GET: To monitor the job run. |
| </li><li>DELETE: To delete job run data. |
| </li></ul> |
| <p><b>Usage:</b> |
| </p> |
| <ul><li>URL: <tt>http://<hostname>:8080/smila/jobmanager/jobs/<job-id>/</tt> |
| </li><li>Allowed methods: |
| <ul><li>GET |
| </li><li>DELETE |
| </li></ul> |
| </li><li>Response status codes: |
| <ul><li>200 OK: Upon successful execution (GET/DELETE). If the job run with the given job name and job id does not exist, no error will occur during DELETE. |
| </li><li>500 Server Error: If the job run is still running (DELETE). |
| </li></ul> |
| </li></ul> |
| <a name="Monitor_a_job_run_with_details"></a><h2> <span class="mw-headline"> Monitor a job run with details </span></h2> |
| <p>It is possible to update existings jobs. You can update the job definition, workflow definition and bucket definition. To see which definitions have been used during a job run you can display additional information with returnDetails=true. |
| </p> |
| <pre> |
| GET /smila/jobmanager/jobs/<job-name>/<job-id>/?returnDetails=true |
| </pre> |
| <a name="Finish_job_run"></a><h2> <span class="mw-headline"> Finish job run </span></h2> |
| <p>Use a POST request to finish a job run. |
| </p><p><b>Supported operations:</b> |
| </p> |
| <ul><li>POST: finish job run. |
| </li></ul> |
| <p><b>Usage:</b> |
| </p> |
| <ul><li>URL: <tt>http://<hostname>:8080/smila/jobmanager/jobs/<job-name>/<job-id>/finish/</tt> |
| </li><li>Allowed methods: |
| <ul><li>POST |
| </li></ul> |
| </li><li>Response status codes: |
| <ul><li>202 ACCEPTED: Finishes the job run (asynchronous call) |
| </li><li>400 BAD REQUEST: wrong URL pattern. |
| </li><li>404 NOT FOUND: job run not found |
| </li><li>405 METHOD NOT ALLOWED: wrong HTTP method used, only POST is accepted here |
| </li><li>410 GONE: job run was finished before and has already been moved to the history of job runs |
| </li><li>500 INTERNAL SERVER ERROR: other errors |
| </li></ul> |
| </li></ul> |
| <a name="Cancel_job_run"></a><h2> <span class="mw-headline"> Cancel job run </span></h2> |
| <p>Use a POST request to cancel a job run. |
| </p><p><b>Supported operations:</b> |
| </p> |
| <ul><li>POST: cancel job run. |
| </li></ul> |
| <p><b>Usage:</b> |
| </p> |
| <ul><li>URL: <tt>http://<hostname>:8080/smila/jobmanager/jobs/<job-name>/<job-id>/cancel/</tt> |
| </li><li>Allowed methods: |
| <ul><li>POST |
| </li></ul> |
| </li><li>Response status codes: |
| <ul><li>200 OK: Upon successful execution. Cancel the job run |
| </li><li>400 BAD REQUEST: wrong URL pattern. |
| </li><li>404 NOT FOUND: job run not found |
| </li><li>405 METHOD NOT ALLOWED: wrong HTTP method used, only POST is accepted here |
| </li><li>410 GONE: job run was finished before and has already been moved to the history of job runs |
| </li><li>500 INTERNAL SERVER ERROR: other errors |
| </li></ul> |
| </li></ul> |
| <a name="Monitor_a_workflow_run"></a><h2> <span class="mw-headline"> Monitor a workflow run </span></h2> |
| <p>Use a GET request to monitor a workflow run. |
| </p><p><b>Supported operations:</b> |
| </p> |
| <ul><li>GET: monitor workflow run. |
| </li></ul> |
| <p><b>Usage:</b> |
| </p> |
| <ul><li>URL: <tt>http://<hostname>:8080/smila/jobmanager/jobs/<job-name>/<job-id>/workflowrun/<workflowRun-id>/</tt> |
| </li><li>Allowed methods: |
| <ul><li>GET |
| </li></ul> |
| </li><li>Response status codes: |
| <ul><li>200 OK: Upon successful execution. |
| </li><li>404 NOT FOUND: If the workflow run specified does not exist. This can either mean that the workflow run existed but has already been finished, or that it never existed all. You cannot differentiate both cases without further information unless you can make sure that the ID existed before. |
| </li></ul> |
| </li></ul> |
| <p><b>Examples:</b> |
| </p><p>To monitor a workflow run: |
| </p> |
| <pre> |
| GET /smila/jobmanager/jobs/myJob/20110527_175314695579/workflowrun/1/ |
| </pre> |
| <p>If it is still running, the result would be: |
| </p> |
| <pre> |
| HTTP/1.x 200 OK |
| |
| { |
| "activeTaskCount": 1 |
| "transientBulkCount": 1 |
| } |
| </pre> |
| <p>If not, the result would be: |
| </p> |
| <pre> |
| HTTP/1.x 404 NOT FOUND |
| </pre> |
| |
| <!-- |
| NewPP limit report |
| Preprocessor node count: 127/1000000 |
| Post-expand include size: 643/2097152 bytes |
| Template argument size: 113/2097152 bytes |
| #ifexist count: 0/100 |
| --> |
| |
| <!-- Saved in parser cache with key wikidb:pcache:idhash:32457-0!1!0!!en!2!edit=0 and timestamp 20111027144359 --> |
| <div class="printfooter"> |
| Retrieved from "<a href="JobRuns.html">http://wiki.eclipse.org/SMILA/Documentation/JobRuns</a>"</div> |
| <!-- end content --> |
| <div class="visualClear"></div> |
| </div> |
| </div> |
| |
| |
| </div> |
| |
| |
| <!-- Yoink of toolbox for phoenix moved up --> |
| |
| |
| </div> |
| </div> |
| <div id="clearFooter"/> |
| <div id="footer" > |
| <ul id="footernav"> |
| <li class="first"><a href="http://www.eclipse.org/">Home</a></li> |
| <li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li> |
| <li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li> |
| <li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li> |
| <li><a href="http://www.eclipse.org/org/foundation/contact.php">Contact</a></li> |
| <li><a href="http://wiki.eclipse.org/Eclipsepedia:About" title="Eclipsepedia:About">About Eclipsepedia</a></li> |
| </ul> |
| <span id="copyright">Copyright © 2011 The Eclipse Foundation. All Rights Reserved</span> |
| <p id="footercredit">This page was last modified 12:23, 5 September 2011 by <a href="http://wiki.eclipse.org/index.php?title=User:Juergen.schumacher.attensity.com&action=edit" class="new" title="User:Juergen.schumacher.attensity.com">Juergen Schumacher</a>. Based on work by <a href="http://wiki.eclipse.org/index.php?title=User:Nadine.auslaender.attensity.com&action=edit" class="new" title="User:Nadine.auslaender.attensity.com"> </a> and <a href="http://wiki.eclipse.org/User:Drazen.cindric.attensity.com" title="User:Drazen.cindric.attensity.com">Drazen Cindric</a>.</p> |
| <p id="footerviews">This page has been accessed 326 times.</p> |
| </div> |
| |
| <script type="text/javascript"> |
| var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www."); |
| document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E")); |
| </script> |
| <script type="text/javascript"> |
| var pageTracker = _gat._getTracker("UA-910670-4"); |
| pageTracker._trackPageview(); |
| </script> |
| |
| |
| |
| |
| |
| |
| |
| <!-- <div class="visualClear"></div> --> |
| |
| <script type="text/javascript">if (window.runOnloadHook) runOnloadHook();</script> |
| </div> |
| |
| <!-- Served in 0.135 secs. --></body></html> |
