KASP Checkerr README -------------------- The KASP checker is written to check the OpenDNSSEC configuration. The checker and its tools are part of the OpenDNSSEC project. For more information, visit http://www.opendnssec.org CONTENTS Introduction Dependencies Installation Testing Running Manually ------------------------------------------------------------------- Introduction ------------------------------------------------------------------- The KASP Checker checks the configuration of the OpenDNSSEC system. It checks that the conf.xml and kasp.xml files validate against the RNG specification, and that the values contained in the files are mutually consistent and sane. The ods-kaspcheck program will display any issues it has found to the console. If a syslog facility has been correctly defined in the configuration file, then the output will also be written to syslog. ------------------------------------------------------------------- Dependencies ------------------------------------------------------------------- The ods-kaspcheck utility depends on Ruby being available on the target system. ------------------------------------------------------------------- Installation ------------------------------------------------------------------- From the base directory /auditor : autoreconf --install ./configure make make install --prefix= Installation directory. All files will be installed relative to this path, and default search paths will be relative to the prefix. Defaults to /usr/local The ods-kaspcheck invocation script will be installed in /bin The Ruby libraries will be installed in /lib/opendnssec ------------------------------------------------------------------- Testing ------------------------------------------------------------------- To run the ods-kaspcheck test files, run the command : ruby test/checker_test.rb If you wish to test the checker locally before installing it, then run the following command from /auditor : ruby -I lib test/checker_test.rb ------------------------------------------------------------------- Running ------------------------------------------------------------------- ods-kaspcheck [--conf path/to/conf.xml] [--kasp path/to/kasp.xml] e.g. ods-kaspcheck --conf /etc/opendnssec/conf.xml Any problems, please contact alex@nominet.org.uk