README revision dac2623103983d165dfa06ef510a5e8bdac6cd4c
7e8c1a13e97448db2ec17d05c4917939a12aa9c0Mark AndrewsCopyright (C) 2004, 2010 Internet Systems Consortium, Inc. ("ISC")
35538d7a7df83c7d2713ae86255cebd799715f54Mark AndrewsCopyright (C) 2000, 2001 Internet Software Consortium.
a7038d1a0513c8e804937ebc95fc9cb3a46c04f5Mark AndrewsSee COPYRIGHT in the source root or http://isc.org/copyright.html for terms.
7e8c1a13e97448db2ec17d05c4917939a12aa9c0Mark AndrewsThis is a simple test environment for running bind9 system tests
7e8c1a13e97448db2ec17d05c4917939a12aa9c0Mark Andrewsinvolving multiple name servers.
7e8c1a13e97448db2ec17d05c4917939a12aa9c0Mark AndrewsThere are multiple test suites, each in a separate subdirectory and
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrewsinvolving a different DNS setup. They are:
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews dnssec/ DNSSEC tests
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews forward/ Forwarding tests
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews glue/ Glue handling tests
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews limits/ Tests of handling of large data (close to server limits)
dafcb997e390efa4423883dafd100c975c4095d6Mark Andrews lwresd/ Tests of the lightweight resolver library and daemon
7e8c1a13e97448db2ec17d05c4917939a12aa9c0Mark Andrews notify/ More NOTIFY tests
7e8c1a13e97448db2ec17d05c4917939a12aa9c0Mark Andrews nsupdate/ Dynamic update and IXFR tests
2c15fcdeac4c2402258867fbac24d7475ef98259Mark Andrews resolver/ Regression tests for resolver bugs that have been fixed
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein (not a complete resolver test suite)
ab023a65562e62b85a824509d829b6fad87e00b1Rob Austein stub/ Tests of stub zone functionality
7e8c1a13e97448db2ec17d05c4917939a12aa9c0Mark Andrews unknown/ Unknown type and class tests
7e8c1a13e97448db2ec17d05c4917939a12aa9c0Mark Andrews upforwd/ Update forwarding tests
7e8c1a13e97448db2ec17d05c4917939a12aa9c0Mark Andrews views/ Tests of the "views" statement
7e8c1a13e97448db2ec17d05c4917939a12aa9c0Mark Andrews xfer/ Zone transfer tests
7e8c1a13e97448db2ec17d05c4917939a12aa9c0Mark Andrews xferquota/ Zone transfer quota tests
7e8c1a13e97448db2ec17d05c4917939a12aa9c0Mark AndrewsTypically each test suite sets up 2-5 name servers and then performs
b1b3495eba72ea2b7270c5cd62b0bb824de74e05Mark Andrewsone or more tests against them. Within the test suite subdirectory,
b1b3495eba72ea2b7270c5cd62b0bb824de74e05Mark Andrewseach name server has a separate subdirectory containing its
77b101ced9801cdb226919784bfc1aa0650ace6aMark Andrewsconfiguration data. By convention, these subdirectories are named
77b101ced9801cdb226919784bfc1aa0650ace6aMark Andrews"ns1", "ns2", etc.
7e8c1a13e97448db2ec17d05c4917939a12aa9c0Mark AndrewsThe tests are completely self-contained and do not require access to
b1b3495eba72ea2b7270c5cd62b0bb824de74e05Mark Andrewsthe real DNS. Generally, one of the test servers (ns1) is set up as a
7e8c1a13e97448db2ec17d05c4917939a12aa9c0Mark Andrewsroot name server and is listed in the hints file of the others.
7e8c1a13e97448db2ec17d05c4917939a12aa9c0Mark AndrewsTo enable all servers to run on the same machine, they bind to
669e9657c731176df235832367f61435f7b83ddfAndreas Gustafssonseparate virtual IP address on the loopback interface. ns1 runs on
c2bc56dc65b4b103a5600565680eb5f33fa4c90bMark Andrews10.53.0.1, ns2 on 10.53.0.2, etc. Before running any tests, you must
c2bc56dc65b4b103a5600565680eb5f33fa4c90bMark Andrewsset up these addresses by running "ifconfig.sh up" as root.
92551304a9abff9284de5b79a48e83d781989339Mark AndrewsIf you wish to make the interfaces survive across reboots
c5223c9cb7c22620d5ee6611228673e95b48a270Mark Andrewscopy org.isc.bind.system and org.isc.bind.system to
c5223c9cb7c22620d5ee6611228673e95b48a270Mark Andrews"launchctl load /Library/LaunchDaemons/org.isc.bind.system.plist" as
7e8c1a13e97448db2ec17d05c4917939a12aa9c0Mark AndrewsThe servers use port 5300 instead of the usual port 53, so they can be
66a38d16933a28a0110079a9920ba359d2aad130Danny Mayerrun without root privileges once the interfaces have been set up.
92551304a9abff9284de5b79a48e83d781989339Mark AndrewsThe tests can be run individually like this:
92551304a9abff9284de5b79a48e83d781989339Mark AndrewsTo run all the tests, just type "make test".
b1b3495eba72ea2b7270c5cd62b0bb824de74e05Mark Andrews$Id: README,v 1.14 2010/08/25 23:46:37 tbox Exp $