README revision 55e5c51e661e23e24573db84114a3837817745c9
280a8a0544b4aeb52414d20e8c6e6c5b1108562eTinderbox UserCopyright (C) 2004, 2010, 2011 Internet Systems Consortium, Inc. ("ISC")
59602f2a7c4e4809941583bed3e94cd26e628f1aTinderbox UserCopyright (C) 2000, 2001 Internet Software Consortium.
6fe48fb46e53ffc37542853a1edb74cb481b7d94Automatic UpdaterSee COPYRIGHT in the source root or http://isc.org/copyright.html for terms.
19558a04decde0e7261d489d92d04ad88104217bTinderbox UserThis is a simple test environment for running bind9 system tests
827f8cccb5280f4da66c46186e792d1cb9d73503Mark Andrewsinvolving multiple name servers.
c57668a2fbbe558c1bd21652813616f2f517c469Tinderbox UserThere are multiple test suites, each in a separate subdirectory and
03ebc228ee3725738b067b6bd7082a9a731822a1Tinderbox Userinvolving a different DNS setup. They are:
a2c370ca12bb0360ff7e969474ead3f788c65fffTinderbox User dnssec/ DNSSEC tests
8de3f14f1c300c3e1ed99084cc03485b42c92bf1Tinderbox User forward/ Forwarding tests
e5a6871cd0635ecdb2bf792316a2d8c53206f4b2Tinderbox User glue/ Glue handling tests
950d203b64f512b85fcc093ee1e9e3e531a1aea3Tinderbox User limits/ Tests of handling of large data (close to server limits)
b886b04d8d2b085cbf3e1bf4442dee87f43ba5e4Tinderbox User lwresd/ Tests of the lightweight resolver library and daemon
03ebc228ee3725738b067b6bd7082a9a731822a1Tinderbox User notify/ More NOTIFY tests
3759f10fc543747668b1ca4b4671f35b0dea8445Francis Dupont nsupdate/ Dynamic update and IXFR tests
e676a596869d8a80a644c99a848afb53d1c5975eMark Andrews resolver/ Regression tests for resolver bugs that have been fixed
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews (not a complete resolver test suite)
b91d11bfcc30b96f2c80f3a76d12e3dcc8597a68Mark Andrews rrl/ query rate limiting
d5637bdbb931ff79fced3d4858d83212ea58ed15Tinderbox User rpz/ Tests of response policy zone (RPZ) rewriting
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews stub/ Tests of stub zone functionality
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews unknown/ Unknown type and class tests
3759f10fc543747668b1ca4b4671f35b0dea8445Francis Dupont upforwd/ Update forwarding tests
d5637bdbb931ff79fced3d4858d83212ea58ed15Tinderbox User views/ Tests of the "views" statement
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews xfer/ Zone transfer tests
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User xferquota/ Zone transfer quota tests
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox UserTypically each test suite sets up 2-5 name servers and then performs
e813f036c8251b6d9d2a72fa84f80c2c9d2795afMark Andrewsone or more tests against them. Within the test suite subdirectory,
30370d905e9be3be7d9b947fd432bacecbb13bb9Evan Hunteach name server has a separate subdirectory containing its
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrewsconfiguration data. By convention, these subdirectories are named
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User"ns1", "ns2", etc.
e813f036c8251b6d9d2a72fa84f80c2c9d2795afMark AndrewsThe tests are completely self-contained and do not require access to
30370d905e9be3be7d9b947fd432bacecbb13bb9Evan Huntthe real DNS. Generally, one of the test servers (ns1) is set up as a
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrewsroot name server and is listed in the hints file of the others.
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsTo enable all servers to run on the same machine, they bind to
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox Userseparate virtual IP address on the loopback interface. ns1 runs on
e813f036c8251b6d9d2a72fa84f80c2c9d2795afMark Andrews10.53.0.1, ns2 on 10.53.0.2, etc. Before running any tests, you must
30370d905e9be3be7d9b947fd432bacecbb13bb9Evan Huntset up these addresses by running "ifconfig.sh up" as root.
03ebc228ee3725738b067b6bd7082a9a731822a1Tinderbox UserIf you wish to make the interfaces survive across reboots
aa9c561961e9d877946ebaa8795fa2be054ab7bfEvan Huntcopy org.isc.bind.system and org.isc.bind.system to
827f8cccb5280f4da66c46186e792d1cb9d73503Mark Andrews"launchctl load /Library/LaunchDaemons/org.isc.bind.system.plist" as
3759f10fc543747668b1ca4b4671f35b0dea8445Francis DupontThe servers use port 5300 instead of the usual port 53, so they can be
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic Updaterrun without root privileges once the interfaces have been set up.
dc238a06bffa79de141ee7655765e2df91498a8aTinderbox UserThe tests can be run individually like this:
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic UpdaterTo run all the tests, just type "make test".
cdfc81e048bd34c1d628380247bda6b80a89e20eAutomatic Updater$Id: README,v 1.16 2011/01/13 04:59:24 tbox Exp $