unbound/testcode/testbed.txt

   1 Testbed.sh help page.
   2
   3 Testbed helps in running the test packages (using tpkg(1)) on several systems.
   4 The script is specially written for unbound (edit it to change to different
   5 software). It is licensed BSD.
   6
   7 The hosts to run on are listed in host_file.<username>. You need to have
   8 public-key authorized ssh access to these systems (or type your password lots
   9 and lots of times). The host_file describes the directories and environment
  10 of each host. You need only user-level access to the host.
  11
  12 The host_file is very restrictive in formatting. Comments are lines starting
  13 with the # mark. The entries must be separated by tabs. Please list the
  14 hostname<tab>description<tab>checkoutdir<tab>variables
  15
  16 hostname:       network hostname to ssh to.
  17 desc:           pretty text to describe the machine architecture.
  18 checkoutdir:    directory on the remote host where a svn checkout is present.
  19 variables:      zero or more variables separated by spaces. BLA=value BAR=val.
  20
  21 Only important variable for unbound is the LDNS=<dir> variable that if present
  22 forces --with-ldns=<dir> to be passed to ./configure. In case LDNS is not
  23 installed on the system itself, but present somewhere else.
  24
  25 You can also set LIBEVENT=<dir> for the libevent directory, if it is
  26 installed in a nonstandard location.
  27
  28 *** Running the testbed
  29
  30 Run by executing the script. It will take all the hosts from the file in
  31 turn and update the svn directory there, possible autoreconf if necessary,
  32 possibly ./configure <args> if necessary, make the executables.
  33 Then it will run the testcode/do-tests script. This script should execute
  34 the tests that this host is capable of running.
  35
  36 in testdata/testbed.log has a line-by-line log. See your make errors here.
  37 in testdata/testbed.report has only the tpkg reports. Summary.
  38