Trell HTTP API

This page describes the mod_trell HTTP API for starting and stopping Tinia Server jobs.

Starting the Trell server

http://server/trell/mod/rpc.xml?action=restart_master

Starting a new job

http://server/trell/master/rpc.xml?foo=bar

Add the following XML document in POST:

<?xml version="1.0"?>
<query xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xmlns="http://cloudviz.sintef.no/trell/1.0">
  <addJob>
    <job>JOBID</job>
    <application>BINARY NAME<application/>
  </addJob>
</query>

Here JOBID is a user specified, server unique alphanumeric id. BINARY NAME is the name of the binary to start, as found in <trell dir>/apps on the server.

Stopping a job

http://server/trell/master/rpc.xml?foo=bar

Add the following XML document in POST:

<?xml version="1.0"?>
<query xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xmlns="http://cloudviz.sintef.no/trell/1.0">
  <killJob>
    <job>JOBID</job>
    <force>FORCE</force>
  </killJob>
</query>

Here JOBID is the id of the job to kill, FORCE is either true, which will terminate the job brutally (akin to kill -9), or false which will give the job a chance to cleanup before shutdown.