aboutsummaryrefslogtreecommitdiff
path: root/external/unbound/testcode/testbed.txt
blob: b0175049eec464215fbd3a8206746b4a7d4dfdc3 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
Testbed.sh help page.

Testbed helps in running the test packages (using tpkg(1)) on several systems.
The script is specially written for unbound (edit it to change to different
software). It is licensed BSD.

The hosts to run on are listed in host_file.<username>. You need to have
public-key authorized ssh access to these systems (or type your password lots
and lots of times). The host_file describes the directories and environment
of each host. You need only user-level access to the host.

The host_file is very restrictive in formatting. Comments are lines starting
with the # mark. The entries must be separated by tabs. Please list the
hostname<tab>description<tab>checkoutdir<tab>variables

hostname:	network hostname to ssh to.
desc:		pretty text to describe the machine architecture.
checkoutdir:	directory on the remote host where a svn checkout is present.
variables:	zero or more variables separated by spaces. BLA=value BAR=val.

Only important variable for unbound is the LDNS=<dir> variable that if present
forces --with-ldns=<dir> to be passed to ./configure. In case LDNS is not
installed on the system itself, but present somewhere else.

You can also set LIBEVENT=<dir> for the libevent directory, if it is
installed in a nonstandard location.

*** Running the testbed

Run by executing the script. It will take all the hosts from the file in 
turn and update the svn directory there, possible autoreconf if necessary,
possibly ./configure <args> if necessary, make the executables.
Then it will run the testcode/do-tests script. This script should execute
the tests that this host is capable of running.

in testdata/testbed.log has a line-by-line log. See your make errors here.
in testdata/testbed.report has only the tpkg reports. Summary.