README revision 0d50da49baa7d2d39146d46789d88053af5b1b50
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
0d50da49baa7d2d39146d46789d88053af5b1b50Michael Sawyerset up these addresses by running the script "ifconfig.sh start".
0d50da49baa7d2d39146d46789d88053af5b1b50Michael SawyerThe servers do not bind to port 53, so can be run as a normal user once the
0d50da49baa7d2d39146d46789d88053af5b1b50Michael Sawyerinterfaces are set up.
0e9dcd548051a8ec34744bfa18b4e09fea742a39Andreas GustafssonTo run the tests:
0d50da49baa7d2d39146d46789d88053af5b1b50Michael Sawyer$Id: README,v 1.5 2000/06/09 19:51:10 mws Exp $