HowTo/Flunc

Version 1 (modified by arneke, 5 years ago)

--

Flunc is an OpenPlans product used for testing websites. It's meant to simulate user interaction, but a subset of this functionality can be used to test other web services. It can deal with reasonable amounts of text or XML output. It's not very fast, so do not expect it to replace the CITE tests, but it's good to check that a service is up and that noone has disabled the database you depend on.

To add yourself to the notification list

The setup:

SSH into atlas and look in /var/flunc , you'll find:

  • flunc_wrapper.sh - the script run by the cron daemon
  • logs/log_<timestamp> - complete logs from the past 3 days
  • tests/test_wrapper.tsuite - the file where you add your own tsuites
  • tests/sigma_geoserver.tsuite - the test suite for /geoserver on sigma.openplans.org. Look at this for an example.
  • tests/lib_wms_getcapabilities.twill - a very simple test that checks the document has some of the expect elements as well as the presence of a layer name

To use the existing tests:

  • copy sigma_geoserver.tsuite to <your hostname>_<your path>.tsuite
  • modify as appropriate
  • add <your hostname>_<your path> on a new line in test_wrapper.tsuite

To add a new test script you simply create