README revision e9918d6a9df388b971a4805844165dd3fc3a88ca
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
0e9dcd548051a8ec34744bfa18b4e09fea742a39Andreas Gustafssonthe real DNS. One of the test servers (ns1) is set up as a root
0e9dcd548051a8ec34744bfa18b4e09fea742a39Andreas Gustafssonname 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
0e9dcd548051a8ec34744bfa18b4e09fea742a39Andreas Gustafssonset up these addresses by running the script "ifconfig.sh".
0e9dcd548051a8ec34744bfa18b4e09fea742a39Andreas GustafssonBecause the servers run on port 53, the tests must be run as root.
0e9dcd548051a8ec34744bfa18b4e09fea742a39Andreas GustafssonTo run the tests:
a185ac41ac0627ec711d13bf6fdd8a830b753060Andreas GustafssonTo clean up files left behind by the tests:
e9918d6a9df388b971a4805844165dd3fc3a88caAndreas Gustafsson$Id: README,v 1.4 2000/06/08 18:18:23 gson Exp $