1 | $Id: INSTALL 262 2012-03-04 22:53:54Z kdeugau $
|
---|
2 |
|
---|
3 | Requirements
|
---|
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 | - DBI
|
---|
26 | - DBD::Pg
|
---|
27 | - NetAddr::IP >= 4.x. 3.x may work, however 4.x has been out for
|
---|
28 | more than 4 years.
|
---|
29 | - Frontier::Responder (only required if using dns-rpc.cgi)
|
---|
30 | - tinydns - support for other DNS server software is planned
|
---|
31 |
|
---|
32 | Installing DeepNet DNS Administrator
|
---|
33 | ====================================
|
---|
34 |
|
---|
35 | 1) Untar in a convenient location. You should be able to simply use the
|
---|
36 | unpacked tarball as-is, or you can run "make install" to install files
|
---|
37 | in /usr/local/share/dnsadmin-#VERSION#, with configuration in
|
---|
38 | /usr/local/etc/dnsdb.
|
---|
39 |
|
---|
40 | The Makefile supports substitution on most standard GNU/FHS-ish paths,
|
---|
41 | so you could also run:
|
---|
42 |
|
---|
43 | make install prefix=/opt
|
---|
44 |
|
---|
45 | to install it under /opt.
|
---|
46 |
|
---|
47 | The Makefile also supports DESTDIR for packaging, so you can use:
|
---|
48 |
|
---|
49 | make install datadir=/usr/share sysconfdir=/etc DESTDIR=/tmp/dnsdbpkgroot
|
---|
50 |
|
---|
51 | to install for packaging under /tmp/dnsdbpkgroot with the core scripts
|
---|
52 | and HTML packaged under /usr/share/dnsdb-#VERSION#, and the configuration
|
---|
53 | packaged under /etc/dnsdb.
|
---|
54 |
|
---|
55 | 2) Configuration: By default DNS Administrator looks for configuration in
|
---|
56 | /etc/dnsdb/dnsdb.conf. Edit this file with the database name, user, and
|
---|
57 | password, and the database host if necessary.
|
---|
58 |
|
---|
59 | Setting the options under the "mail" heading is also recommended.
|
---|
60 |
|
---|
61 | 3) As a Postgres superuser, create a database user and the database (replace
|
---|
62 | the database name, user and password as appropriate):
|
---|
63 |
|
---|
64 | shell> psql template1
|
---|
65 | pg# create user dnsdb with password "dnsdbpwd";
|
---|
66 | pg# create database dnsdb owner dnsdb;
|
---|
67 |
|
---|
68 | Create the inital tables using dns.sql:
|
---|
69 |
|
---|
70 | shell> psql -U dnsdb dnsdb <dns.sql
|
---|
71 |
|
---|
72 | 4) Configure your webserver to call the DNS Administrator scripts
|
---|
73 | at an appropriate web path. A webroot pointing to the unpacked tarball
|
---|
74 | directory or the default install location /usr/local/lib/dnsadmin-#VERSION#
|
---|
75 | should work fine; a directory alias under an existing virtual host should
|
---|
76 | work as well.
|
---|
77 |
|
---|
78 | The directory containing the HTML and scripts must have at least the
|
---|
79 | following Apache directives (or other server equivalent) set:
|
---|
80 |
|
---|
81 | Options ExecCGI IncludesNoEXEC
|
---|
82 |
|
---|
83 | 5) A default user "admin", password "admin" is created when you create
|
---|
84 | the initial tables in step 3. You should at least change the password
|
---|
85 | on this account, or create another superuser account and remove this
|
---|
86 | one.
|
---|
87 |
|
---|
88 | ---
|
---|
89 |
|
---|
90 | Basic installation should now be complete! Log in and start adding
|
---|
91 | your domains and domain records.
|
---|
92 |
|
---|
93 | A minimal export script is included (export.pl). This should be modified
|
---|
94 | to create the tinydns data file where appropriate for your installation,
|
---|
95 | and set to be called from cron on a regular basis.
|
---|