README revision 17be07ab818846dffb79e898da888a29c919bb02
895N/ACopyright (C) 2004 Internet Systems Consortium, Inc. ("ISC")
895N/ACopyright (C) 2000, 2001 Internet Software Consortium.
895N/ASee COPYRIGHT in the source root or http://isc.org/copyright.html for terms.
895N/A
895N/AThis is a simple test environment for running bind9 system tests
895N/Ainvolving multiple name servers.
895N/A
895N/AThere are multiple test suites, each in a separate subdirectory and
895N/Ainvolving a different DNS setup. They are:
895N/A
895N/A dnssec/ DNSSEC tests
895N/A forward/ Forwarding tests
895N/A glue/ Glue handling tests
895N/A limits/ Tests of handling of large data (close to server limits)
895N/A lwresd/ Tests of the lightweight resolver library and daemon
895N/A notify/ More NOTIFY tests
895N/A nsupdate/ Dynamic update and IXFR tests
895N/A resolver/ Regression tests for resolver bugs that have been fixed
895N/A (not a complete resolver test suite)
895N/A stub/ Tests of stub zone functionality
895N/A unknown/ Unknown type and class tests
895N/A upforwd/ Update forwarding tests
927N/A views/ Tests of the "views" statement
927N/A xfer/ Zone transfer tests
927N/A xferquota/ Zone transfer quota tests
927N/A
927N/ATypically each test suite sets up 2-5 name servers and then performs
927N/Aone or more tests against them. Within the test suite subdirectory,
927N/Aeach name server has a separate subdirectory containing its
895N/Aconfiguration data. By convention, these subdirectories are named
895N/A"ns1", "ns2", etc.
895N/A
895N/AThe tests are completely self-contained and do not require access to
895N/Athe real DNS. Generally, one of the test servers (ns1) is set up as a
895N/Aroot name server and is listed in the hints file of the others.
895N/A
895N/ATo enable all servers to run on the same machine, they bind to
895N/Aseparate virtual IP address on the loopback interface. ns1 runs on
895N/A10.53.0.1, ns2 on 10.53.0.2, etc. Before running any tests, you must
895N/Aset up these addresses by running "ifconfig.sh up" as root.
895N/A
895N/AMac OS X:
895N/AIf you wish to make the interfaces survive across reboots
895N/Acopy org.isc.bind.system and org.isc.bind.system to
895N/A/Library/LaunchDaemons then run
895N/A"launchctl load /Library/LaunchDaemons/org.isc.bind.system.plist" as
895N/Aroot.
895N/A
895N/AThe servers use port 5300 instead of the usual port 53, so they can be
895N/Arun without root privileges once the interfaces have been set up.
895N/A
895N/AThe tests can be run individually like this:
895N/A
895N/A sh run.sh xfer
895N/A sh run.sh notify
895N/A etc.
895N/A
927N/ATo run all the tests, just type "make test".
895N/A
895N/A$Id: README,v 1.13 2010/08/25 04:51:51 marka Exp $
895N/A