README
1How to install the DNSCheck perl library and associated scripts
2===============================================================
3
41) perl Makefile.PL
5
62) make
7
83) make test (optional)
9
104) make install
11 This step may need administrative privileges. If so, do su or
12 sudo first.
13
145) Configuration files are installed in $PREFIX/share/dnscheck. $PREFIX
15 is the top of your Perl installation tree. If you're not sure where
16 that is, you can run "perl -MConfig -le 'print $Config{siteprefix}'" to
17 find out.
18
196) If you plan to use almost any of the included programs or the web gui,
20 you need to set up access information for a MySQL database. Copy the
21 appropriate part from config.yaml to site_config.yaml and modify to
22 match your database setup. The database you point out should be freshly
23 loaded with the contents of db/schema.sql and db/index.sql.
24
257) Do "perldoc DNSCheck::Overview" to get more information about how things
26 fit together and which part does what.
27
28
29
30Upgrading from DNSCheck version 0.81 to 0.90
31============================================
32
331) Install the library as per points 1 to 4 above.
34
352) Run db/upgrade_81_90.sql against your database, if you have one. If you
36 have a lot of data in your 'tests' table, this may take some time, during
37 which new tests cannot be started and running ones cannot finish. Consider
38 doing this during a service window.
39
403) Check the newly installed config.yaml for keys that you may want to
41 override in your site_config.yaml
42
434) Move database access configuration from dnscheck.conf to site_config.yaml
44
455) Change any startup scripts on your server so they run dnscheck-dispatcher
46 instead of dnscheck-qrun (which no longer exists).