README revision 1928be262ca25485f4d7f0f6473fc5cafa0c3905
6fe48fb46e53ffc37542853a1edb74cb481b7d94Automatic UpdaterThis is a simple test environment for running bind9 system tests
18920d790825d96ca3943aa2dcb6eb80dc611c5fTinderbox Userinvolving multiple name servers.
a5636b773fa05a272b6876afd99309c0b3090e2fMark AndrewsThere are multiple test suites, each in a separate subdirectory and
e9e4257668ff6c4e583b0c0db2508650b0b677b8Tinderbox Userinvolving a different DNS setup. They are:
c57668a2fbbe558c1bd21652813616f2f517c469Tinderbox User dnssec/ DNSSEC tests
a7c412f37cc73d0332887a746e81220cbf09dd00Mark Andrews forward/ Forwarding tests
1f4c645185bd8fc70048e0a69eee46193a284e5cTinderbox User glue/ Glue handling tests
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark Andrews limits/ Tests of handling of large data (close to server limits)
bed0874e1a09e810575328c4bfc346a47514b69fMark Andrews lwresd/ Tests of the lightweight resolver library and daemon
02b47c5d62e1e827743684c28a08e871da454a2dMark Andrews notify/ More NOTIFY tests
b886b04d8d2b085cbf3e1bf4442dee87f43ba5e4Tinderbox User nsupdate/ Dynamic update and IXFR tests
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark Andrews resolver/ Regression tests for resolver bugs that have been fixed
e20309353e6246485c521278131d3fced73d7957Tinderbox User (not a complete resolver test suite)
e20309353e6246485c521278131d3fced73d7957Tinderbox User stub/ Tests of stub zone functionality
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews unknown/ Unknown type and class tests
a7c412f37cc73d0332887a746e81220cbf09dd00Mark Andrews upforwd/ Update forwarding tests
a7c412f37cc73d0332887a746e81220cbf09dd00Mark Andrews views/ Tests of the "views" statement
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews xfer/ Zone transfer tests
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews xferquota/ Zone transfer quota tests
e20309353e6246485c521278131d3fced73d7957Tinderbox UserTypically each test suite sets up 2-5 name servers and then performs
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrewsone or more tests against them. Within the test suite subdirectory,
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrewseach name server has a separate subdirectory containing its
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrewsconfiguration data. By convention, these subdirectories are named
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews"ns1", "ns2", etc.
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsThe tests are completely self-contained and do not require access to
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrewsthe real DNS. Generally, one of the test servers (ns1) is set up as a
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrewsroot name server and is listed in the hints file of the others.
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsTo enable all servers to run on the same machine, they bind to
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrewsseparate virtual IP address on the loopback interface. ns1 runs on
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews10.53.0.1, ns2 on 10.53.0.2, etc. Before running any tests, you must
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrewsset up these addresses by running "ifconfig.sh start".
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsThe servers use port 5300 instead of the usual port 53, so they can be
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrewsrun without root privileges once the interfaces have been set up.
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsThe tests can be run individually like this:
aa9c561961e9d877946ebaa8795fa2be054ab7bfEvan HuntTo run all the tests, just type "make test".
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updater$Id: README,v 1.9 2000/12/19 19:21:06 gson Exp $