source: branches/stable/INSTALL@ 779

Last change on this file since 779 was 548, checked in by Kris Deugau, 11 years ago

/branches/stable

Merge reverse DNS work and object conversion from /trunk, part 5

Includes changes through r543 with a few more minor conflicts.

  • Property svn:keywords set to Date Rev Author Id
File size: 3.3 KB
Line 
1$Id: INSTALL 548 2013-12-11 21:01:18Z kdeugau $
2
3Requirements
4============
5
6- Any CGI-capable web server that can execute arbitrary files or
7 files with administrator-defineable extensions
8- PostgreSQL >= 7.4. It should be possible to trivially convert to
9 other DBMSes, however I recommend against any that don't fully
10 support transactions on all changes.
11- Perl >= 5.6
12 - Standard modules:
13 These should be included in any base Perl install
14 - CGI::Carp
15 - POSIX
16 - Text::Wrap - for WHOIS response linewrapping
17 - Extra modules:
18 - CGI::Simple
19 - HTML::Template
20 - CGI::Session
21 - Crypt::PasswdMD5 (primary password encryption)
22 - Digest::MD5 (for imported VegaDNS passwords)
23 - Net::Whois::Raw
24 - Net::DNS
25 - Net::SMTP
26 - DBI
27 - DBD::Pg
28 - NetAddr::IP >= 4.0.27
29 - Frontier::Responder (only required if using dns-rpc.cgi)
30 - FCGI (only required if you want to run the RPC script as FastCGI)
31- tinydns - support for other DNS server software is planned
32
33
34Installing DeepNet DNS Administrator
35====================================
36
371) Untar in a convenient location. You should be able to simply use the
38unpacked tarball as-is, or you can run "make install" to install files
39in /usr/local/share/dnsadmin-#VERSION#, with configuration in
40/usr/local/etc/dnsdb.
41
42The Makefile supports substitution on most standard GNU/FHS-ish paths,
43so you could also run:
44
45 make install prefix=/opt
46
47to install it under /opt.
48
49The Makefile also supports DESTDIR for packaging, so you can use:
50
51 make install datadir=/usr/share sysconfdir=/etc DESTDIR=/tmp/dnsdbpkgroot
52
53to install for packaging under /tmp/dnsdbpkgroot with the core scripts
54and HTML packaged under /usr/share/dnsdb-#VERSION#, and the configuration
55packaged under /etc/dnsdb.
56
572) Configuration: By default DNS Administrator looks for configuration in
58/etc/dnsdb/dnsdb.conf. Edit this file with the database name, user, and
59password, and the database host if necessary.
60
61Setting the options under the "mail" heading is also recommended.
62
633) As a Postgres superuser, create a database user and the database (replace
64the database name, user and password as appropriate):
65
66shell> psql template1
67pg# create user dnsdb with password "dnsdbpwd";
68pg# create database dnsdb owner dnsdb;
69
70Create the inital tables using dns.sql:
71
72shell> psql -U dnsdb dnsdb <dns.sql
73
744) Configure your webserver to call the DNS Administrator scripts
75at an appropriate web path. A webroot pointing to the unpacked tarball
76directory or the default install location /usr/local/lib/dnsadmin-#VERSION#
77should work fine; a directory alias under an existing virtual host should
78work as well.
79
80The directory containing the HTML and scripts must have at least the
81following Apache directives (or other server equivalent) set:
82
83 Options ExecCGI IncludesNoEXEC
84
855) A default user "admin", password "admin" is created when you create
86the initial tables in step 3. You should at least change the password
87on this account, or create another superuser account and remove this
88one.
89
90---
91
92Basic installation should now be complete! Log in and start adding
93your domains and reverse zones and their records.
94
95A minimal export script is included (export.pl). This should be modified
96to create the tinydns data file where appropriate for your installation,
97and set to be called from cron on a regular basis.
Note: See TracBrowser for help on using the repository browser.