← Back to branch summary

~ubuntu-branches/ubuntu/quantal/maradns/quantal

« back to all changes in this revision

Viewing changes to doc/en/QuickStart

  • Committer: Package Import Robot
  • Author(s): Iain Lane
  • Date: 2012-01-12 23:35:38 UTC
  • mto: This revision was merged to the branch mainline in revision 26.
  • Revision ID: package-import@ubuntu.com-20120112233538-5jkaqrh9nbqtf1ey
Tags: upstream-2.0.04+really1.4.09
Import upstream version 2.0.04+really1.4.09

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/en/QuickStart
1
 
Sorry, can not find lcol; this is in the utf8 directory
2
 
off of the main maradns tree
 
1
This guide is for experienced UNIX/Linux/BSD users who just want to quickly
 
2
try out MaraDNS
 
3
 
 
4
       MaraDNS acts as both a recursive and an authoritative DNS server. In
 
5
       other words, MaraDNS can both be used to speed up the internet, and/or
 
6
       serve domains that you may have.
 
7
 
 
8
       To try out MaraDNS as a recursive nameserver is easy:
 
9
 
 
10
       * Compile MaraDNS. Type in './configure; make' in the top-level MaraDNS
 
11
         directory.  Note: No need to compile if you downloaded a binary RPM
 
12
         or Debian package.
 
13
 
 
14
       * Take the file server/maradns and place it in /usr/local/sbin
 
15
 
 
16
       * Take the file tools/duende and place it in /usr/local/sbin
 
17
 
 
18
       * Create an empty directory called /etc/maradns
 
19
 
 
20
       * Create a mararc file. This file only needs to be three lines long on
 
21
         systems with a /dev/urandom file, and four lines long on older
 
22
         operating systems without /dev/urandom
 
23
 
 
24
       Here is a sample mararc file:
 
25
 
 
26
            ipv4_bind_addresses = "127.0.0.1"
 
27
            chroot_dir = "/etc/maradns"
 
28
            recursive_acl = "127.0.0.1"
 
29
 
 
30
       This mararc file says that MaraDNS will have the ip "127.0.0.1" (this
 
31
       is the bind_address), run from the directory /etc/maradns (the
 
32
       chroot_dir value), and only allow the ip "127.0.0.1" to make recursive
 
33
       queries (the recursive_acl value).
 
34
 
 
35
       * Place the mararc file in the location /etc/mararc on your system.
 
36
 
 
37
       * Run MaraDNS as a non-daemon:
 
38
 
 
39
              /usr/local/sbin/maradns
 
40
 
 
41
         Since MaraDNS needs to bind to a privileged port (port 53), it needs
 
42
         to start up running as root. MaraDNS is designed with security in
 
43
         mind, and will drop root privileges before being visible to the
 
44
         public internet.
 
45
 
 
46
       * Test MaraDNS in another window or virtual terminal
 
47
 
 
48
              dig @127.0.0.1 www.yahoo.com
 
49
 
 
50
       * In order to make the duende daemonizing tool usable, create a
 
51
         directory named /etc/maradns/logger/
 
52
 
 
53
              mkdir /etc/maradns/logger
 
54
 
 
55
       * If this works, make MaraDNS run as a daemon:
 
56
 
 
57
              /usr/local/sbin/duende /usr/local/sbin/maradns
 
58
 
 
59
         duende is a tool that daemonizes maradns; the daemonizer is a
 
60
         separate program.
 
61
 
 
62
       * If this all works, install MaraDNS:
 
63
 
 
64
              make install
 
65
       It is also possible to set up MaraDNS as both an authoritative and
 
66
       recursive name server with the same IP:
 
67
 
 
68
       * Here is the MaraRC file:
 
69
 
 
70
              ipv4_bind_addresses = "127.0.0.1"
 
71
              chroot_dir = "/etc/maradns"
 
72
              recursive_acl = "127.0.0.1"
 
73
              csv2 = {}
 
74
              csv2["example.com."] = "db.example.com"
 
75
 
 
76
       * Have a zone file named db.example.com in the chroot_dir (/etc/maradns
 
77
         above) that looks like this:
 
78
 
 
79
         example.com. 10.1.2.3
 
80
 
 
81
         (Yes, experienced DNS admins, you can have SOA, NS, MX, SRV, and any
 
82
         other kind of DNS data stored in a csv2 zone file. Read the csv2 man
 
83
         page for details)
 
84
 
 
85
       * Recursive queries will be resolved normally
 
86
 
 
87
       * Queries for example.com will resolve to 10.1.2.3
 
88
 
 
89
       * Any other name.example.com query will return a "this host does not
 
90
         exist" DNS reply.
 
91
 
 
92
       Look in doc (in particular, the tutorial), or read the relevant man
 
93
       pages for more information on how to set up MaraDNS.
 
94