</sect1>
</chapter>
-<chapter id="windows">
- <title>Installing on Microsoft Windows</title>
- <para>
- <warning>
- <para>
- As of 3.0 and up, Windows support is untested and probably does not work at all.
- </para>
- </warning>
- <note>
- <para>
- 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.
- </para>
- </note>
- </para>
- <para>
- 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.
- </para>
- <para>
- To install PowerDNS for Windows you should check if your PC meets the following requirements:
- <itemizedlist>
- <listitem>
- <para>
- A PC running Microsoft NT (with a recent servicepack and at least mdac 2.5), 2000 or XP.
- </para>
- </listitem>
- <listitem>
- <para>An ODBC source containing valid zone information (an example MS Access database is supplied in the form of <filename>powerdns.mdb</filename>).
- </para>
- </listitem>
- </itemizedlist>
- </para>
-
- <para>
- After installing the software you should create a valid ODBC source.
- To do this you have open the ODBC sources dialog: <filename>Start->Settings->Control Panel->Administrative Tools->Data Sources (ODBC)</filename>.
- </para>
-
- <para>
- We'll use the example zone database that is included in the installation to explain how to create a source.
- </para>
-
- <para>
- When you are in the ODBC sources dialog you activate the <filename>System DSN</filename> tab.
- <note><para>It is important to create a System DSN instead of an User DSN, otherwise the ODBC backend cannot function.</para></note>
- </para>
-
- <para>
- Press <filename>Add...</filename>, then you have to select a driver.
- </para>
-
- <para>
- Select <filename>Microsoft Access Driver (*.mdb)</filename>.
- </para>
-
- <para>
- Use <filename>PowerDNS</filename> as the DSN name, you can leave the description empty.
- </para>
-
- <para>
- Then press <filename>Select...</filename> to select the database (ie. <filename>C:\Program Files\PowerDNS\powerdns.mdb</filename>).
- </para>
-
- <para>
- Press <function>Ok</function> and you should be done.
- </para>
-
- <para>
- For more information, see <xref linkend="odbc"/>.
- </para>
-
- <sect1 id="windows-configuration">
- <title>Configuring PDNS on Microsoft Windows</title>
-
- <para>
- You can specify program parameters in the <filename>pdns.conf</filename> file
- which should be located in pdns directory (ie. <filename>C:\Program Files\PowerDNS\</filename>).
- </para>
-
- <para>
- To see a list of available parameters you can run <filename>pdns.exe --help</filename>.
- </para>
-
- <note>
- <para>
- A default configuration file has been supplied with the installation.
- </para>
- </note>
-
- </sect1>
-
- <sect1 id="running-on-windows">
- <title>Running PDNS on Microsoft Windows</title>
-
- <para>
- If you installed pdns on Windows NT, 2000 or XP you can run pdns as a service.
- </para>
-
- <para>
- This is how to do it:
- Go to services (<filename>Start->Settings->Control Panel->Administrative Tools->Services</filename>) and locate <filename>PDNS</filename> (you should have registered the program as a NT service during the installation).
- </para>
-
- <para>
- Double-click on <filename>PDNS</filename> and push the start button. You should now see a progress bar that gets to the end and see the status change to 'Started'.
- </para>
-
- <para>
- This is the same as starting pdns like this:
- <filename>pdns.exe --ntservice</filename>
- </para>
-
- <para>
- If you haven't registered pdns as a service during the installation you can do so from the command line by starting pdns like this:
- <filename>pdns.exe --register-service</filename>
- </para>
-
- <para>
- You can run pdns as a standard console program by using a command prompt or <filename>Start->Run...</filename>
- This way you can specify command-line parameters (see the documentation for command line options).
- </para>
-
- <para>
- If you chose to add a PowerDNS menu to the start menu during the installation you can start pdns using the pdns shortcut in that menu.
- </para>
-
- </sect1>
- </chapter>
-
<chapter id="configuring-db-connection">
<title>Basic setup: configuring database connectivity</title>
<para>