OGCE Bridge

From Ogce

Contents

[edit]

OGCE Bridge Clients Information

[edit]

Submit Job

Used to submit job to resource using GFAC. This service needs a xml message with job parameters and header data to submit job to compute resource (queenbee, lonestar or Ranger)


Service URL : 

https://gw61.quarry.iu.teragrid.org:7443/ogce-rest/job/runjob/async


Sample XML : 

<?xml version="1.0" encoding="UTF-8"?>
<Message>
 <Header>
       <hostname>queenbee.loni-lsu.teragrid.org</hostname>
       <processorcount>16</processorcount>
       <hostcount>2</hostcount>
       <queuename>workq</queuename>
       <walltime>60</walltime>
       <userdn>/C=US/O=National Center for Supercomputing Applications/CN=Community User</userdn>
       <serviceName>simplegrid-application</serviceName>
       <workflowName></workflowName>
 </Header>
   <Body>
       <Method>US3_Run</Method>
       <input>
       </input>
   </Body>
</Message>


All these parameters are set by Ultrascan client call. Parameters like processercount, queuename and walltime are optional. GFAC have default value for optional parameter.

This service returns you a xml message with experimentid in following format 

<?xml version="1.0" encoding="UTF-8"?>
<MessageResponse>
   <experimentid>Experiment-1c15651c-d872-4234-a561-f58df81fb542</experimentid>
</MessageResponse>


[edit]

Job Status

To get status of current experiment. You need to create following url with experimentid which was returned from Submit job service.

Service URL : 

https://gw61.quarry.iu.teragrid.org:7443/ogce-rest/job/jobstatus/$experimentid


Service will return xml message with status of current job status on compute resource. Response format is 

<?xml version="1.0" encoding="UTF-8"?> 
<MessageResponse>
   <status>COMPLETED</status>
   <message>Job working folders etc</message>
</MessageResponse>

Other status are : SUBMITTED|INITIALIZED|PENDING|ACTIVE|COMPLETED|CANCELED|FAILED|UNKNOWN(if job id does not exit in job database)


[edit]

Cancel Job

To cancel running or queued jobs from compute resource. Pass experimentID from Submit Job service.

Service URL : 

https://gw61.quarry.iu.teragrid.org:7443/ogce-rest/job/canceljob/$experimentid


Service will return call status. It can either be Success or Already Canceled in following xml format 

<?xml version="1.0" encoding="UTF-8"?>
<MessageResponse>
   <status>Success</status>
</MessageResponse>

Other status are: CANCELED | NOTALLOWED(if already canceled or completed) | UNKNOWN(if job id does not exit in job database)

[edit]

Services Code

SVN location of this code is 

https://ogce.svn.sourceforge.net/svnroot/ogce/incubator/OGCERestService/
Retrieved from "http://gridfarm018.ucs.indiana.edu/ogce/index.php/OGCE_Bridge"
Web site tools