<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Chapter 3. Installing on Microsoft Windows</title><link rel="stylesheet" href="docbook.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /><link rel="home" href="index.html" title="PowerDNS manual" /><link rel="up" href="index.html" title="PowerDNS manual" /><link rel="prev" href="pdns-on-unix.html" title="3. Running PDNS on unix" /><link rel="next" href="running-on-windows.html" title="2. Running PDNS on Microsoft Windows" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 3. Installing on Microsoft Windows</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="pdns-on-unix.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="running-on-windows.html">Next</a></td></tr></table><hr /></div><div class="chapter" title="Chapter 3. Installing on Microsoft Windows"><div class="titlepage"><div><div><h2 class="title"><a id="windows"></a>Chapter 3. Installing on Microsoft Windows</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="windows.html#windows-configuration">1. Configuring PDNS on Microsoft Windows</a></span></dt><dt><span class="sect1"><a href="running-on-windows.html">2. Running PDNS on Microsoft Windows</a></span></dt></dl></div><p>
</p><div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="warning.png" /></td><th align="left">Warning</th></tr><tr><td align="left" valign="top"><p>
As of 3.0 and up, Windows support is untested and probably does not work at all.
</p></td></tr></table></div><p>
</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="note.png" /></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
PowerDNS support for Windows is, as of 1.99.12, very recent and therefore quite 'beta'. For reliability, we currently advise the use of
the Unix versions. Furthermore there is no support for master or slave operation in the ODBC backend, which is the only one provided currently.
</p></td></tr></table></div><p>
</p><p>
As of 1.99.12, PowerDNS supports Windows natively. PDNS can act as an NT service and works with any ODBC drivers you may have.
</p><p>
To install PowerDNS for Windows you should check if your PC meets the following requirements:
</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
A PC running Microsoft NT (with a recent servicepack and at least mdac 2.5), 2000 or XP.
</p></li><li class="listitem"><p>An ODBC source containing valid zone information (an example MS Access database is supplied in the form of <code class="filename">powerdns.mdb</code>).
</p></li></ul></div><p>
</p><p>
After installing the software you should create a valid ODBC source.
To do this you have open the ODBC sources dialog: <code class="filename">Start->Settings->Control Panel->Administrative Tools->Data Sources (ODBC)</code>.
</p><p>
We'll use the example zone database that is included in the installation to explain how to create a source.
</p><p>
When you are in the ODBC sources dialog you activate the <code class="filename">System DSN</code> tab.
</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="note.png" /></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>It is important to create a System DSN instead of an User DSN, otherwise the ODBC backend cannot function.</p></td></tr></table></div><p>
</p><p>
Press <code class="filename">Add...</code>, then you have to select a driver.
</p><p>
Select <code class="filename">Microsoft Access Driver (*.mdb)</code>.
</p><p>
Use <code class="filename">PowerDNS</code> as the DSN name, you can leave the description empty.
</p><p>
Then press <code class="filename">Select...</code> to select the database (ie. <code class="filename">C:\Program Files\PowerDNS\powerdns.mdb</code>).
</p><p>
Press <code class="function">Ok</code> and you should be done.
</p><p>
For more information, see <a class="xref" href="odbc.html" title="8. ODBC backend">Section 8, “ODBC backend”</a>.
</p><div class="sect1" title="1. Configuring PDNS on Microsoft Windows"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="windows-configuration"></a>1. Configuring PDNS on Microsoft Windows</h2></div></div></div><p>
You can specify program parameters in the <code class="filename">pdns.conf</code> file
which should be located in pdns directory (ie. <code class="filename">C:\Program Files\PowerDNS\</code>).
</p><p>
To see a list of available parameters you can run <code class="filename">pdns.exe --help</code>.
</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="note.png" /></td><th align="left">Note</th></tr><tr><td align="left" valign="top"><p>
A default configuration file has been supplied with the installation.
</p></td></tr></table></div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="pdns-on-unix.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="running-on-windows.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">3. Running PDNS on unix </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 2. Running PDNS on Microsoft Windows</td></tr></table></div></body></html>
