tonywhitmore.co.uk  

 Project Homepage

DNSMasq

• This document covers the compilation, installation and basic configuration of the DNSMasq DNS "relay" server. More advanced configuration is covered in the help file for DNSMasq and on the DNSMasq website.
• If you install this software it is highly recommended that you keep up-to-date with security advisories published on the CERT website.
• I cannot be held responsible for the security of your DNSMasq server. It is up to you to understand the software you are running. The setup detailed here is that of a basic DNS relay and nothing more.
• If you spot any major errors on this page, please e-mail me using the link above.

• It is assumed that this installation takes place on a computer on which Core Linux has been successfully installed.
• No software other than the packages bundled with Core Linux have been installed.
• As described in the installation guide, it is assumed that any downloaded application source code is stored in a directory called /apps on the CD-R.
• It is assumed that the Core Linux computer is attached to a network on which there is at least one other machine with internet access and a CD burner. It must also be running an DNS client program, for example a web browser or FTP client.

Preparation

1. Download the DNSMasq source code from www.thekelleys.org.uk/dnsmasq/.
2. Burn the file dnsmasq-1.10.tar.gz to a CD. This page assumes that the subdirectory /apps is used for the .tar.gz file. The CD-ROM can be a multi-session disk.

Give me more details on this

Booting

1. Boot your Core Linux PC.
2. Login as root. You will need to enter the password at the prompt.

Give me more details on this

Extract the source

1. Place the CD-R in the CD-ROM drive. Mount the CD-ROM drive under /mnt/cdrom.
2. Change to the /apps directory on the CD-R.
3. Copy the dnsmasq-1.10.tar.gz file to the directory /usr/src.
4. Change to the /usr/src directory and extract the source from the .tar.gz file.

Give me more details on this

Configure and compile

1. Change to the /usr/src/dnsmasq-1.10 directory.
2. Run the make program with the argument install.

Give me more details on this

Testing

1. Configure the upstream DNS servers for your Core Linux system.
2. Add the user nobody.
3. Start the DNSMasq daemon using /usr/local/sbin/dnsmasq --log-queries.
4. Set your other computer to use your Core Linux system as its only DNS server.
5. Make a DNS lookup from the client computer (e.g. try to open a web page in a web browser using its domain name).
6. Check logs on your Core Linux system to ensure that DNSMasq performed the query correctly.

Give me more details on this

Automating DNSMasq

1. Append the following line to the /etc/rc.d/rc.mu script:
   /usr/local/sbin/dnsmasq -q
   You should adjust the above line to reflect the options with which you want DNSMasq to run. You can also add comments and echoes for your own information.
2. Insert the following line at the second line of the /etc/rc.d/rc.rb script:
   kill `cat /var/run/dnsmasq.pid`
   You can also add comments and echoes for your own information.
3. Insert the following line at the second line of the /etc/rc.d/rc.ha script:
4. Reboot the system and check that DNSMasq is running.

Give me more details on this

The text of this page is licensed under a Creative Commons License.