MARACONF 10 "August 2006" MARACONF "Maraconf reference"

# NAME

maraconf - MaraDNS configurator

# SYNOPSIS

maraconf [options] Options: [-start] [-help]

# TABLE OF CONTENTS

This man page has the following sections:

>     Name
>     Synopsis
>     Table of Contents
>     Description
>     Usage
>     Legal Disclaimer
>     Author

# DESCRIPTION

maraconf is a MaraDNS DNS server configurator. It will guide you in the task of configuring your mararc and zone files.

maraconf has two arguments: -start that initializes the program, and -help to shows usage information.

# USAGE

Maraconf, like the rest of MaraDNS, is designed to be easy to use. One can simply start maraconf with the -start option and choose options in a menu.

There are two main configuration options: Configuring a recursive server and an authoritative server. Pressing number one will start the recursive mode. Pressing number two will start the authoritative mode.

Recursive DNS server

Recursive DNS servers can convert DNS nodes on the public internet in to their corresponding number. This kind of server can not change the names of any DNS nodes out there. Instead, they simply ask other DNS servers the IP for a given DNS node.

When configuring a recursive DNS server with maraconf, you will be presented with two configuration modes:

1) The easy way (using a wizard)
2) The hard way (for experienced users)

The easy way:

Here the program will do most of the work. Only two two questions need to be answered: The IP address that the server will run on and the ip allowed to perform recursive queries. If you do not answer a given question, the program will use a reasonable default value.

The hard way:

The program will ask ten question about your MaraDNS setup. This mode is designed for experienced administrators. Again, if you do not answer a given question, the program will use a reasonable default value.

Authoritative DNS server

An authoritative DNS server actually controls the records for a subset of DNS nodes in the internet (such as the IPs corresponding to DNS names). Recursive DNS servers (see above) contact authoritative DNS servers in order to learn the IP for a given DNS node.

In this mode there is only one configuration mode; you will start directly answering questions about your zone. Here you can setup A, NS, and MX records, among other things.

# LEGAL DISCLAIMER

THIS SOFTWARE IS PROVIDED BY THE AUTHORS ''AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

# AUTHOR

Maraconf is written by Daniel Zilli and Sam Trenholme. Consequently, all errors in Maraconf are ours (but read the disclaimer above).