<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>Running PDNS on unix</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="PowerDNS manual"
HREF="index.html"><LINK
REL="UP"
TITLE="Installing on Unix"
HREF="installing-on-unix.html"><LINK
REL="PREVIOUS"
TITLE="Testing your install"
HREF="testing.html"><LINK
REL="NEXT"
TITLE="Installing on Microsoft Windows"
HREF="windows.html"></HEAD
><BODY
CLASS="SECT1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>PowerDNS manual</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="testing.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Chapter 2. Installing on Unix</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="windows.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="PDNS-ON-UNIX"
>2.3. Running PDNS on unix</A
></H1
><P
> PDNS is normally controlled via a SysV-style init.d script, often located in <TT
CLASS="FILENAME"
>/etc/init.d</TT
> or
<TT
CLASS="FILENAME"
>/etc/rc.d/init.d</TT
>. This script accepts the following commands:
<P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
>monitor</DT
><DD
><P
> Monitor is a special way to view the daemon. It executes PDNS in the foreground with
a lot of logging turned on, which helps in determining startup problems.
Besides running in the foreground, the raw PDNS control socket is made available. All external
communication with the daemon is normally sent over this socket. While useful, the control console
is not an officially supported feature. Commands which work are: <B
CLASS="COMMAND"
>QUIT</B
>, <B
CLASS="COMMAND"
>SHOW *</B
>,
<B
CLASS="COMMAND"
>SHOW varname</B
>, <B
CLASS="COMMAND"
>RPING</B
>.
</P
></DD
><DT
>start</DT
><DD
><P
> Start PDNS in the background. Launches the daemon but makes no special effort to determine success,
as making database connections may take a while. Use <B
CLASS="COMMAND"
>status</B
> to query success. You
can safely run <B
CLASS="COMMAND"
>start</B
> many times, it will not start additional PDNS instances.
</P
></DD
><DT
>restart</DT
><DD
><P
> Restarts PDNS if it was running, starts it otherwise.
</P
></DD
><DT
>status</DT
><DD
><P
> Query PDNS for status. This can be used to figure out if a launch was successful.
The status found is prefixed by the PID of the main PDNS process.
</P
></DD
><DT
>stop</DT
><DD
><P
> Requests that PDNS stop. Again, does not confirm success. Success can be ascertained with the <B
CLASS="COMMAND"
>status</B
> command.
</P
></DD
><DT
>dump</DT
><DD
><P
> Dumps a lot of statistics of a running PDNS daemon. It is also possible to single out specific variable by using
the <B
CLASS="COMMAND"
>show</B
> command.
</P
></DD
><DT
>show variable</DT
><DD
><P
> Show a single statistic, as present in the output of the <B
CLASS="COMMAND"
>dump</B
>.
</P
></DD
><DT
>mrtg</DT
><DD
><P
> See the performance monitoring <A
HREF="monitoring.html"
>Chapter 6</A
>.
</P
></DD
></DL
></DIV
>
</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="testing.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="windows.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Testing your install</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="installing-on-unix.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Installing on Microsoft Windows</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
