README revision 55e5c51e661e23e24573db84114a3837817745c9
9cee5bb02863bf191e12cd4297adabf1971020deAutomatic UpdaterCopyright (C) 2004, 2010, 2011 Internet Systems Consortium, Inc. ("ISC")
dafcb997e390efa4423883dafd100c975c4095d6Mark AndrewsCopyright (C) 2000, 2001 Internet Software Consortium.
dafcb997e390efa4423883dafd100c975c4095d6Mark AndrewsSee COPYRIGHT in the source root or http://isc.org/copyright.html for terms.
c13b8351b4dfb18806af4eb3c0fea240d83d1f82Andreas GustafssonThis is a simple test environment for running bind9 system tests
c13b8351b4dfb18806af4eb3c0fea240d83d1f82Andreas Gustafssoninvolving multiple name servers.
0e9dcd548051a8ec34744bfa18b4e09fea742a39Andreas GustafssonThere are multiple test suites, each in a separate subdirectory and
c13b8351b4dfb18806af4eb3c0fea240d83d1f82Andreas Gustafssoninvolving a different DNS setup. They are:
dd977047669f15fe3ea1a977871d7678cebf5082Andreas Gustafsson dnssec/ DNSSEC tests
dd977047669f15fe3ea1a977871d7678cebf5082Andreas Gustafsson forward/ Forwarding tests
dd977047669f15fe3ea1a977871d7678cebf5082Andreas Gustafsson glue/ Glue handling tests
dd977047669f15fe3ea1a977871d7678cebf5082Andreas Gustafsson limits/ Tests of handling of large data (close to server limits)
dd977047669f15fe3ea1a977871d7678cebf5082Andreas Gustafsson lwresd/ Tests of the lightweight resolver library and daemon
a185ac41ac0627ec711d13bf6fdd8a830b753060Andreas Gustafsson notify/ More NOTIFY tests
1928be262ca25485f4d7f0f6473fc5cafa0c3905Andreas Gustafsson nsupdate/ Dynamic update and IXFR tests
dd977047669f15fe3ea1a977871d7678cebf5082Andreas Gustafsson resolver/ Regression tests for resolver bugs that have been fixed
dd977047669f15fe3ea1a977871d7678cebf5082Andreas Gustafsson (not a complete resolver test suite)
55e5c51e661e23e24573db84114a3837817745c9Evan Hunt rrl/ query rate limiting
87708bde16713bc02ff2598f4a82f98c699a2f2dMark Andrews rpz/ Tests of response policy zone (RPZ) rewriting
dd977047669f15fe3ea1a977871d7678cebf5082Andreas Gustafsson stub/ Tests of stub zone functionality
ca44fe49bec16436cd95ace0af2e244f2096b284Brian Wellington unknown/ Unknown type and class tests
dd977047669f15fe3ea1a977871d7678cebf5082Andreas Gustafsson upforwd/ Update forwarding tests
dd977047669f15fe3ea1a977871d7678cebf5082Andreas Gustafsson views/ Tests of the "views" statement
1928be262ca25485f4d7f0f6473fc5cafa0c3905Andreas Gustafsson xfer/ Zone transfer tests
a185ac41ac0627ec711d13bf6fdd8a830b753060Andreas Gustafsson xferquota/ Zone transfer quota tests
e9918d6a9df388b971a4805844165dd3fc3a88caAndreas GustafssonTypically each test suite sets up 2-5 name servers and then performs
0e9dcd548051a8ec34744bfa18b4e09fea742a39Andreas Gustafssonone or more tests against them. Within the test suite subdirectory,
0e9dcd548051a8ec34744bfa18b4e09fea742a39Andreas Gustafssoneach name server has a separate subdirectory containing its
0e9dcd548051a8ec34744bfa18b4e09fea742a39Andreas Gustafssonconfiguration data. By convention, these subdirectories are named
0e9dcd548051a8ec34744bfa18b4e09fea742a39Andreas Gustafsson"ns1", "ns2", etc.
0e9dcd548051a8ec34744bfa18b4e09fea742a39Andreas GustafssonThe tests are completely self-contained and do not require access to
0d50da49baa7d2d39146d46789d88053af5b1b50Michael Sawyerthe real DNS. Generally, one of the test servers (ns1) is set up as a
0d50da49baa7d2d39146d46789d88053af5b1b50Michael Sawyerroot name server and is listed in the hints file of the others.
0e9dcd548051a8ec34744bfa18b4e09fea742a39Andreas GustafssonTo enable all servers to run on the same machine, they bind to
0e9dcd548051a8ec34744bfa18b4e09fea742a39Andreas Gustafssonseparate virtual IP address on the loopback interface. ns1 runs on
0e9dcd548051a8ec34744bfa18b4e09fea742a39Andreas Gustafsson10.53.0.1, ns2 on 10.53.0.2, etc. Before running any tests, you must
e1e635578dedd17313312031be2759285c7c8e17Andreas Gustafssonset up these addresses by running "ifconfig.sh up" as root.
17be07ab818846dffb79e898da888a29c919bb02Mark AndrewsIf you wish to make the interfaces survive across reboots
17be07ab818846dffb79e898da888a29c919bb02Mark Andrewscopy org.isc.bind.system and org.isc.bind.system to
17be07ab818846dffb79e898da888a29c919bb02Mark Andrews"launchctl load /Library/LaunchDaemons/org.isc.bind.system.plist" as
7beeb415ca3f1b230d35a8d385d99d2901cf9ff9Andreas GustafssonThe servers use port 5300 instead of the usual port 53, so they can be
7beeb415ca3f1b230d35a8d385d99d2901cf9ff9Andreas Gustafssonrun without root privileges once the interfaces have been set up.
7beeb415ca3f1b230d35a8d385d99d2901cf9ff9Andreas GustafssonThe tests can be run individually like this:
7beeb415ca3f1b230d35a8d385d99d2901cf9ff9Andreas GustafssonTo run all the tests, just type "make test".
9cee5bb02863bf191e12cd4297adabf1971020deAutomatic Updater$Id: README,v 1.16 2011/01/13 04:59:24 tbox Exp $