README revision 7beeb415ca3f1b230d35a8d385d99d2901cf9ff9
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:
0e9dcd548051a8ec34744bfa18b4e09fea742a39Andreas Gustafsson xfer/ Zone transfer, update, and NOTIFY tests
a185ac41ac0627ec711d13bf6fdd8a830b753060Andreas Gustafsson notify/ More NOTIFY tests
a185ac41ac0627ec711d13bf6fdd8a830b753060Andreas Gustafsson xferquota/ Zone transfer quota tests
0e9dcd548051a8ec34744bfa18b4e09fea742a39Andreas Gustafsson dnssec/ DNSSEC 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
7beeb415ca3f1b230d35a8d385d99d2901cf9ff9Andreas Gustafssonset up these addresses by running "ifconfig.sh start".
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".
7beeb415ca3f1b230d35a8d385d99d2901cf9ff9Andreas Gustafsson$Id: README,v 1.6 2000/06/16 19:51:34 gson Exp $