GangaTest-TestRobot documentation

The robot is a autonomous testing framework which can be configured to run indefinitely on any machine to download a new pre-release of ganga and to test any part of it automatically.

Is is an implementation of GangaRobot with the actions Checker, Installer, Tester, Cleaner. The checker periodically checks for updates to the VERSIONS file and if found, will then proceed to install the new releases and test them using the tests defined in the configuration file. The cleaner then removes then new releases, and tidies up.

Usage:

ganga --config-path=GangaTest/Lib/TestRobot/TESTROBOT.INI robot run

Functionality:

It is possible to run the TestRobot to test just one release, or to test as many releases as you like. This is configured in the 'VersionTime' config option, and it will test all releases newer then this time. If you want it to test one release, set the GangaRobot Driver_Repeat = False, and it will only run once, testing the release immediately after the VersionTime set.

The gangadir for TestRobot is defaulted to ~/gangadir_testrobot, which contains the Releases Directory, and the Jobs directory. Each test is run as an individual job in ganga, and the job files have their own directory. The reports from the testing go in the reports folder of each specific job directory.

A heartbeat file is created regularly, and if indefinite running is required, it suggested to use a cron job to run the file TestRobot/heartbeatchecker.py which will check for the process, and a recently updated heartbeatfile, and then

-- AlexShires - 03 Sep 2008