[Home]

tgolem

tgolem is a framework for automatically executing scripts on remote hosts and reporting the results. It is used for automated testing of the CACAO JIT compiler (results).

tgolem is free software distributed under the GPL.

NOTE: While already useful, tgolem currently is a prototype of itself.

Some features of tgolem:

no need to install software on remote hosts
written in Perl, thus portable
remote execution of scripts over SSH, possibly relayed over several hosts
parallel execution of scripts on one or more hosts
strict separation of online (scripts) and offline (report generation) processing
immediate feedback
logging of stdin, stdout and stderr streams
extendible parsing of script output
detailed reports on and comparisons of test results

See the file README for details.

Limitations

Some limitations and design trade-offs:

needs public-key SSH access to hosts
centralized, synchronous architecture

The first limitation could be removed by writing customized scripters that do not use SSH. The centralized design can be worked around by creating several result files de-centrally and then combining them to create unified reports. Synchronous interaction with scripts is fundamental to tgolem.

Dependencies

tgolem requires some Perl modules that can be found on CPAN:

Config::Scoped
Error
HTML::Entities
HTML::Template::Expr
Log::Agent
Log::Agent::Driver::File
Test::More
YAML

Download

There are no versioned releases of tgolem, yet. You can download development snapshots here:

tgolem-2006-04-26T02-53-15
tgolem-2006-04-13T20-37-20
tgolem-2006-03-22T15-42-10
tgolem-2006-03-22T14-48-53
tgolem-2006-03-22T04-01-15
tgolem-2006-03-17T20-36-45
tgolem-2006-03-04T23-48-26
tgolem-2006-03-04T23-27-26

Logo

If you use tgolem to create reports please use the following HTML logo in the generated pages:

You can use HTML code like this:

<div style="text-align: right">
<a href="http://stud4.tuwien.ac.at/~e9825234/tgolem/index.html">
<img src="created_by_tgolem_100.png" alt="[created by tgolem]" style="border:0"></a>
</div>

Please copy the image and refer to it locally.