\chapter{Installation}\index{Installation}

This chapter provides a guide on how to install WendzelNNTPd 2.x.

\section{Linux/*nix/BSD}

To install WendzelNNTPd from source you need to download the provided archive file (e.g. wendzelnntpd-2.0.0.tar.gz) file.\footnote{On some *nix-like O.S.es you need to run \textbf{gzip -d wendzelnntpd-VERSION.tgz}, and then \textbf{tar -xf wendzelnntpd-VERSION.tar}.} Extract it and run \textbf{./configure}. Please note that configure indicates missing libraries and packages that you may first need to install using the package system of your operating system.

\begin{verbatim}
$ tar -xzf wendzelnntpd-2.0.0.tgz
$ cd wendzelnntpd
$ ./configure
...
\end{verbatim}

\textbf{Please Note:} \textit{If you wish to compile WITHOUT MySQL or WITHOUT SQlite support}, then run \textbf{MYSQL=NO ./configure} or \textbf{SQLITE=NO ./configure}, respectively.

~

\textbf{Please Note:} \textit{For FreeBSD/OpenBSD/NetBSD/*BSD: There is no MySQL support; you need to use SQLite (i.e.\ run \texttt{MYSQL=NO ./configure}). Run \texttt{configure} as well as \texttt{make} in the \texttt{bash} shell (under some BSDs you first need to install \texttt{bash}).}

~

After \texttt{configure} has finished, run \textbf{make}:

\begin{verbatim}
$ make
...
\end{verbatim}

To install WendzelNNTPd on your system, you need superuser access. Run \textbf{make install} to install it to the default location \textit{/usr/local/*}.

\begin{verbatim}
$ sudo make install
\end{verbatim}

\textbf{Please Note (Upgrades):} Run \textbf{sudo make upgrade} instead of \textbf{sudo make install} for an upgrade. Please cf.\ Section~\ref{Ch:Upgrade}.

\textbf{Please Note (MySQL):} \textit{If you plan to run MySQL}, then no database was set up during 'make install'. Please refer to chapter 3 (configuration) to learn how to generate the MySQL database.

\subsection{Init Script for automatic Startup}

There is a init script in the directory scripts/startup. It uses the usual parameters like ``start'', ``stop'' and ``restart''.

\section{Unofficial Note: Mac OS X}

A user reported WendzelNNTPd-2.0.0 is installable under Mac OS X 10.5.8. The only necessary change was to add the flag ``-arch x86\_64'' to compile the code on a 64 bit system. However, I never tried to compile WendzelNNTPd on a Mac.

\section{Windows}

Not supported.


