<HEAD><TITLE>Converting to MaraDNS</TITLE> <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=utf-8"> </HEAD><BODY> <!-- Copyright 2005-2006 Sam Trenholme TERMS Redistribution and use, with or without modification, are permitted provided that the following condition is met: 1. Redistributions must retain the above copyright notice, this list of conditions and the following disclaimer. This documentation is provided 'as is' with no guarantees of correctness or fitness for purpose. --> <h1>Converting from another DNS server to MaraDNS</h1> The procedure for converting from another DNS server to MaraDNS is as follows: <ul> <li>Make sure that the names of all zones that the other DNS server has are in one's mararc file. <li>Configure the other DNS server to allow the IP of the machine which will run MaraDNS to perform zone transfers. <li>Use the <tt>fetchzone</tt> client to transfer the zones over. </ul> Assuming that one needs to transfer the zones for example.com, maradns.org, and heaven.af.mil over, the procedure would be as follows: <ul> <li>Add the following lines to one's mararc file: <blockquote> <pre> csv2["example.com."] = "db.example.com" csv2["maradns.org."] = "db.maradns.org" csv2["heaven.af.mil."] = "db.heaven.af.mil" </pre> </blockquote> <li>By reading the documentation for the DNS server that one is currently running, set up the DNS server to allow zone transfers for example.com, maradns.org, and heaven.af.mil <li>Run fetchzone three times. Assuming that the IP of the server currently running DNS is at the IP 127.0.0.1: <blockquote> <pre> cd /etc/maradns fetchzone example.com 127.0.0.1 > db.example.com fetchzone maradns.org 127.0.0.1 > db.maradns.org fetchzone heaven.af.mil 127.0.0.1 > db.heaven.af.mil </pre> </blockquote> </ul> <hr> If one is converting from another DNS server, it is probably best to have MaraDNS act in a strictly RFC-compliant manner. In particular, star records should probably be handled in the exact same manner described in section 4.3.3 of RFC1034, and MaraDNS should be configured to have full support for DNS over TCP. <p> To make star record handling strictly RFC compliant, add the following line to the <tt>mararc</tt> configuration file: <blockquote> <tt>bind_star_handling = 1</tt> </blockquote> To give MaraDNS full DNS-over-TCP support, follow the directions in the <A href=dnstcp.html>dnstcp</A> document. </body>