%
% webalizer.tex
% Last Update: $Id$
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%% Kapitel Webalizer %%%%%%%%%%%%%%%%%%%%%%%%%%%

\chapter{Webalizer}
\index{WEBALIZER}


\section{Allgemeines}


    Das Webalizer-Paket erm"oglicht es, die Logdateien von Apache grafisch
    auszuwerten.

    Es werden u.a. Statistiken "uber den durchschnittlichen Traffic erzeugt,
    aus welchem Land die Besucher des Webservers kommen oder wie viele Zugriffe
    zu einer bestimmten Stunde erfolgten.


\section{Der Webzugriff}


    Der Webzugriff erfolgt f"ur den jeweiligen Host(Domain) "uber den
    eingestellten \jump{WEBALIZERALIAS}{\glqq{}alias\grqq{}}


    Bei der Einstellung \jump{WEBALIZERVHOSTSALL}{WEBALIZER\_VHOSTS\_RUN\_ALL}

    \hinweis{Entspricht die URL dem jeweiligen \texttt{APACHE2\_VHOST\_x\_SERVER\_NAME}.}

    Beispiel: \pfeil  \{http\{s\}://\}APACHE2\_VHOST\_x\_SERVER\_NAME/WEBALIZER\_VHOSTS\_ALIAS \\\\




    Bei der Einstellung \jump{WEBALIZERHOST}{WEBALIZER\_HOST\_N}


    \hinweis{Entspricht die URL dem jeweiligen \texttt{WEBALIZER\_HOST\_x\_HOST\_NAME}.}

    Beispiel: \pfeil  \{http\{s\}://\}WEBALIZER\_HOST\_x\_HOST\_NAME/WEBALIZER\_HOST\_x\_ALIAS \\\\

    In der Konfiguration des Apache WebServers m"ussen keine Parameter
    Einstellungen vorgenommen werden.


\section{Das Men"u im Setup-Programm}

    Das Men"u im Setup-Programm  ist wie folgt aufgebaut:

    \glqq{}Webalizer\grqq{} ist als Modul im Apache2 Menu zu finden

    \mbox{}

    \begin{tabular}{llll}
    & x. &  Apache2 Webserver \\
    \end{tabular}
\eline
    \begin{tabular}{p{1cm}llll}
    & x. &  Configuration \\
    \end{tabular}
\eline
    \begin{tabular}{p{2cm}llll}
    & x. &  Modules configuration \\
    \end{tabular}
\eline
    \begin{tabular}{p{3cm}llll}
    & x. &  Webalizer Administration \\
    \end{tabular}
\eline
    \begin{tabular}{p{4cm}llll}
    & 1. &  View documentation \\
    & 2. &  Edit configuration \\
    & 3. &  Advanced configuration file handling \\
    & 4. &  Run Webalizer now \\
    & 5. &  User handling for web access  (Optional) \\
    \end{tabular}

    \mbox{}


\section{Die Konfigurationsdatei}


\begin{description}


\config{START\_WEBALIZER}
{START\_WEBALIZER}
{STARTWEBALIZER}
{
    F"ur die Aktivierung von 'WEBALIZER' muss diese Variable auf
    den Wert 'yes' gestellt werden. Die Einstellung 'no' schaltet
    'WEBALIZER' ab.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{START\_WEBALIZER='no'}
}


\config{WEBALIZER\_CRON}
{WEBALIZER\_CRON}
{WEBALIZERCRON}
{
    Hier wird angegeben, wann und wie oft Webalizer die
    Auswertungen aktualisieren soll. Die Eingabe erfolgt im
    Standard-Cron-Format.

\input{cron_time_definition}

    Standardeinstellung: \texttt{WEBALIZER\_CRON='55 23 * * *'}
}


\config{WEBALIZER\_LANG\_TYPE}
{WEBALIZER\_LANG\_TYPE}
{WEBALIZERLANGTYPE}
{
    Hier kann die Standard Sprache f"ur den Webalizer eingestellt
    werden.

    G"ultige Werte: english, german, french

    Standardeinstellung: \texttt{WEBALIZER\_LANG\_TYPE='english'}
}


\config{WEBALIZER\_ACCESS\_AUTH\_SEND\_MAIL\_FROM}
{WEBALIZER\_ACCESS\_AUTH\_SEND\_MAIL\_FROM}
{WEBALIZERACCESSAUTHSENDMAILFROM}
{
    Bei der Einstellung WEBALIZER\_x\_ACCESS\_AUTH muss hier eine
    Mail Adresse angeben werden, die als Absender benutzt werden soll.
    Bleibt sie leer wird keine Mail versandt.

    G"ultige Werte: Mail Adresse

    Standardeinstellung: \texttt{WEBALIZER\_ACCESS\_AUTH\_SEND\_MAIL\_FROM=''}
}


\config{WEBALIZER\_QUIET}
{WEBALIZER\_QUIET}
{WEBALIZERQUIET}
{
    Die Quiet Option unterdr"uckt die Ausgabe von Meldungen ... \\
    N"utzlich, bei einem Cron-Job, um un"otige E-Mails zu verhindern. \\
    Hinweis: Warnungen und Fehler, die auf stderr ausgegeben werden,
    sind davon nicht betroffen.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{WEBALIZER\_QUIET='no'}
}


\config{WEBALIZER\_REALLY\_QUIET}
{WEBALIZER\_REALLY\_QUIET}
{WEBALIZERREALLYQUIET}
{
    ReallyQuiet unterdr"uckt alle Meldungen, einschlie"slich Fehler und
    Warnungen. Bei 'yes', kann sie nicht auf der Kommandozeile "uberschrieben
    werden.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{WEBALIZER\_REALLY\_QUIET='no'}
}


\config{WEBALIZER\_TIME\_ME}
{WEBALIZER\_TIME\_ME}
{WEBALIZERTIMEME}
{
    Mit TimeMe kann die Anzeige von Zeitinformationen am Ende der
    Verarbeitung eingeschaltet werden.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{WEBALIZER\_TIME\_ME='no'}
}


\end{description}


\subsection{Apache VHOSTs Konfiguration}


\begin{description}


\marklabel{WEBALIZERVHOSTSALL}{}
\config{WEBALIZER\_VHOSTS\_RUN\_ALL}
{WEBALIZER\_VHOSTS\_RUN\_ALL}
{WEBALIZERVHOSTSRUNALL}
{
    Ist diese Variable auf 'yes' gesetzt, werden alle Logdateien
    ausgewertet, die in der Apache-VHost-Konfiguration konfiguriert sind.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{WEBALIZER\_VHOSTS\_RUN\_ALL='yes'}
}


\marklabel{WEBALIZERALIAS}{}
\config{WEBALIZER\_VHOSTS\_ALIAS}
{WEBALIZER\_VHOSTS\_ALIAS}
{WEBALIZERVHOSTSALIAS}
{
    Hier wird der Alias angegeben, "uber den Webalizer angesprochen
    werden soll.

    Die URL entspricht dem jeweiligen \texttt{APACHE2\_VHOST\_x\_SERVER\_NAME}.

    Beispiel: \pfeil  \{http\{s\}://\}APACHE2\_VHOST\_x\_SERVER\_NAME/httpd

    G"ultige Werte: Name

    Standardeinstellung: \texttt{WEBALIZER\_VHOSTS\_ALIAS='httpd'}
}


\config{WEBALIZER\_VHOSTS\_TITLE}
{WEBALIZER\_VHOSTS\_TITLE}
{WEBALIZERVHOSTSTITLE}
{
    Hier wird die "Uberschrift der Auswertungen angegeben.

    Ist z.B. WEBALIZER\_TITLE='Auswertungen von' gesetzt wird die
    "Uberschrift der Auswertung vom Virtual Host bzw. vom Mainhost,
    dessen Hostname eis.meinesubdomain.eisfair.net ist
    'Auswertungen von eis.meinesubdomain.eisfair.net' lauten.
}


\config{WEBALIZER\_VHOSTS\_BGCOLOR}
{WEBALIZER\_VHOSTS\_BGCOLOR}
{WEBALIZERVHOSTSBGCOLOR}
{
    Hier wird die Hintergrundfarbe der Auswertung in hexadezimaler
    Schreibweise angegeben. Als Pr"afix muss eine Raute (\#)
    angegeben werden.

    G"ultige Werte: Html Farbcode

    Standardeinstellung: \texttt{WEBALIZER\_VHOSTS\_BGCOLOR='\#E8E8E8'}
}


\config{WEBALIZER\_VHOSTS\_COLOR\_SCHEME}
{WEBALIZER\_VHOSTS\_COLOR\_SCHEME}
{WEBALIZERVHOSTSCOLORSCHEME}
{
    Hier kann ein Farb Schema angegeben werden.

    G"ultige Werte: default, aqua, fresh

    Standardeinstellung: \texttt{WEBALIZER\_VHOSTS\_COLOR\_SCHEME='default'}
}



\config{WEBALIZER\_VHOSTS\_ACCESS\_ALL}
{WEBALIZER\_VHOSTS\_ACCESS\_ALL}
{WEBALIZERVHOSTSACCESSALL}
{
    Hier ist der Zugriff f"ur alle erlaubt, Weltweit.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{WEBALIZER\_VHOSTS\_ACCESS\_ALL='no'}
}


\config{WEBALIZER\_VHOSTS\_ACCESS\_AUTH}
{WEBALIZER\_VHOSTS\_ACCESS\_AUTH}
{WEBALIZERVHOSTSACCESSAUTH}
{
    Hier ist der Zugriff mit Benutzernamen und Passwort erlaubt.
    Benutzer m"ussen daf"ur "uber den Men"upunkt
    \glqq{}User handling for web access\grqq{} in der Webalizer-Administration
    ein Passwort erhalten.\\
    Dieser Men"upunkt ist nur sichtbar, falls
    \texttt{WEBALIZER\_VHOSTS\_ACCESS\_AUTH='yes'} gesetzt ist.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{WEBALIZER\_VHOSTS\_ACCESS\_AUTH='no'}
}


\config{WEBALIZER\_VHOSTS\_ACCESS\_HOST}
{WEBALIZER\_VHOSTS\_ACCESS\_HOST}
{WEBALIZERVHOSTSACCESSHOST}
{
    Hier ist der Zugriff von Hostname erlaubt. Es d"urfen mehrere,
    durch ein Leerzeichen getrennt, angegeben werden.

    G"ultige Werte: Hostname, Domain

    Standardeinstellung: \texttt{WEBALIZER\_VHOSTS\_ACCESS\_HOST=''}
}


\config{WEBALIZER\_VHOSTS\_ACCESS\_IP}
{WEBALIZER\_VHOSTS\_ACCESS\_IP}
{WEBALIZERVHOSTSACCESSIP}
{
    Hier ist der Zugriff von der IP Adresse erlaubt. Es d"urfen
    mehrere, durch ein Leerzeichen getrennt, angegeben werden.

    Beispiel: 10 192.168.6 192.168.6.1 192.168.6.0/24

    G"ultige Werte: IP Adresse

    Standardeinstellung: \texttt{WEBALIZER\_VHOSTS\_ACCESS\_IP=''}
}


\config{WEBALIZER\_VHOSTS\_ACCESS\_LOCAL}
{WEBALIZER\_VHOSTS\_ACCESS\_LOCAL}
{WEBALIZERVHOSTSACCESSLOCAL}
{
    Hier ist der Zugriff nur local erlaubt.

    \hinweis{Diese Einstellung l"asst sich nicht mit anderen Methoden kombinieren.}

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{WEBALIZER\_VHOSTS\_ACCESS\_LOCAL='yes'}
}


\end{description}


\subsection{Konfiguration f"ur zus"atzliche Logfiles}


\begin{description}


\marklabel{WEBALIZERHOST}{}
\config{WEBALIZER\_HOST\_N}
{WEBALIZER\_HOST\_N}
{WEBALIZERHOSTN}
{
    Bei diesem Parameter wird angegeben, wie viele Hosts
    konfiguriert werden sollen.

    G"ultige Werte: Zahl

    Standardeinstellung: \texttt{WEBALIZER\_HOST\_N='1'}
}


\config{WEBALIZER\_HOST\_x\_NAME}
{WEBALIZER\_HOST\_x\_NAME}
{WEBALIZERHOSTxNAME}
{
    Der Name wird nicht ausgewertet, es ist zur Eigenen Kontrolle.

    G"ultige Werte: alles

    Standardeinstellung: \texttt{WEBALIZER\_HOSTS\_x\_NAME=''}
}


\config{WEBALIZER\_HOST\_x\_ACTIVE}
{WEBALIZER\_HOST\_x\_ACTIVE}
{WEBALIZERHOSTxACTIVE}
{
    "Uber diesen Parameter wird eingestellt, ob der Datensatz
    aktiv sein soll.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{WEBALIZER\_HOST\_x\_ACTIVEL='no'}
}


\config{WEBALIZER\_HOST\_x\_ALIAS}
{WEBALIZER\_HOST\_x\_ALIAS}
{WEBALIZERHOSTxALIAS}
{
    Hier wird der Alias angegeben, "uber den Webalizer angesprochen
    werden soll.

    Beispiel: \pfeil  \{http\{s\}://\}WEBALIZER\_HOST\_x\_HOST\_NAME/httpd

    G"ultige Werte: Name

    Standardeinstellung: \texttt{WEBALIZER\_HOST\_x\_ALIAS='httpd'}
}


\config{WEBALIZER\_HOST\_x\_ACCESS\_LOG}
{WEBALIZER\_HOST\_x\_ACCESS\_LOG}
{WEBALIZERHOSTxACCESSLOG}
{
    Hier wird die auszuwertende Logdatei angegeben.

    Z.B. WEBALIZER\_HOST\_x\_ACCESS\_LOG='/var/log/ftpd.log'
}


\config{WEBALIZER\_HOST\_x\_HOST\_NAME}
{WEBALIZER\_HOST\_x\_HOST\_NAME}
{WEBALIZERHOSTxHOSTNAME}
{
    Hier wird der Hostname angegeben, auf dem der Server, der die
    Logdateien produziert hat, l"auft.

    Gleichzeitig ist das auch die URL "uber den Webalizer erreicht
    werden kann.

    Beispiel: \pfeil  \{http\{s\}://\}www.meine.de/WEBALIZER\_HOST\_x\_ALIAS

    G"ultige Werte: Hostname

    Standardeinstellung: \texttt{WEBALIZER\_HOST\_x\_HOST\_NAME=''}
}


\config{WEBALIZER\_HOST\_x\_TITLE}
{WEBALIZER\_HOST\_x\_TITLE}
{WEBALIZERHOSTxTITLE}
{
    Hier wird die "Uberschrift der Auswertungen angegeben.

    Ist z.B. WEBALIZER\_TITLE='Auswertungen von' gesetzt, wird die
    "Uberschrift der Auswertung vom Virtual Host bzw. vom Mainhost,
    dessen Hostname eis.meinesubdomain.eisfair.net ist
    'Auswertungen von eis.meinesubdomain.eisfair.net' lauten.
}


\config{WEBALIZER\_HOST\_x\_BGCOLOR}
{WEBALIZER\_HOST\_x\_BGCOLOR}
{WEBALIZERHOSTxBGCOLOR}
{
    Hier wird die Hintergrundfarbe der Auswertung in hexadezimaler
    Schreibweise angegeben. Als Pr"afix muss eine Raute (\#)
    angegeben werden.

    G"ultige Werte: Html Farbcode

    Standardeinstellung: \texttt{WEBALIZER\_HOST\_x\_BGCOLOR='\#E8E8E8'}
}


\config{WEBALIZER\_HOST\_x\_COLOR\_SCHEME}
{WEBALIZER\_HOST\_x\_COLOR\_SCHEME}
{WEBALIZERHOSTxCOLORSCHEME}
{
    Hier kann ein Farb Schema angegeben werden.

    G"ultige Werte: default, aqua, fresh

    Standardeinstellung: \texttt{WEBALIZER\_HOST\_x\_COLOR\_SCHEME='default'}
}


\config{WEBALIZER\_HOST\_x\_TYPE}
{WEBALIZER\_HOST\_x\_TYPE}
{WEBALIZERHOSTxTYPE}
{
    Webalizer kann mehrere Logdateiformate lesen. Das g"angiste
    davon ist das {"`Common Logfile Format\grqq} (CLF). Dies ist z.B.
    auch das Standard-Logfileformat von Apache.

    Weitere M"oglichkteien neben 'clf' sind 'squid', 'ftp' und 'w3c'.

    Wobei das FTP-Format nicht von dem FTP-D"amon aus dem
    Pure-FTPd-Paket unterst"utzt wird. Hier muss in der
    Pure-FTPd-Konfiguration das Logdateiformat vom ftpd auf das
    Common Logfile Format umgestellt werden. In der
    Webalizer-Konfiguration ist dann nat"urlich unter
    \texttt{WEBALIZER\_HOST\_x\_TYPE 'clf'} einzustellen.
}



\config{WEBALIZER\_HOST\_x\_ACCESS\_ALL}
{WEBALIZER\_HOST\_x\_ACCESS\_ALL}
{WEBALIZERHOSTxACCESSALL}
{
    Hier ist der Zugriff f"ur alle erlaubt, Weltweit.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{WEBALIZER\_HOST\_x\_ACCESS\_ALL='no'}
}


\config{WEBALIZER\_HOST\_x\_ACCESS\_AUTH}
{WEBALIZER\_HOST\_x\_ACCESS\_AUTH}
{WEBALIZERHOSTxACCESSAUTH}
{
    Hier ist der Zugriff mit Benutzername und Passwort erlaubt.
    Benutzer m"ussen daf"ur "uber den Men"upunkt
    \glqq{}User handling for web access\grqq{} in der Webalizer-Administration
    ein Passwort erhalten. \\
    Dieser Men"upunkt ist nur sichtbar, falls
    \texttt{WEBALIZER\_VHOSTS\_ACCESS\_AUTH='yes'} gesetzt ist.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{WEBALIZER\_HOST\_x\_ACCESS\_AUTH='no'}
}


\config{WEBALIZER\_HOST\_x\_ACCESS\_HOST}
{WEBALIZER\_HOST\_x\_ACCESS\_HOST}
{WEBALIZERHOSTxACCESSHOST}
{
    Hier ist der Zugriff von Hostname erlaubt. Es d"urfen mehrere,
    durch ein Leerzeichen getrennt angegeben werden.

    G"ultige Werte: Hostname, Domain

    Standardeinstellung: \texttt{WEBALIZER\_HOST\_x\_ACCESS\_HOST=''}
}


\config{WEBALIZER\_HOST\_x\_ACCESS\_IP}
{WEBALIZER\_HOST\_x\_ACCESS\_IP}
{WEBALIZERHOSTxACCESSIP}
{
    Hier ist der Zugriff von der IP Adresse erlaubt. Es d"urfen
    mehrere, durch ein Leerzeichen getrennt, angegeben werden.

    Beispiel: 10 192.168.6 192.168.6.1 192.168.6.0/24

    G"ultige Werte: IP Adresse

    Standardeinstellung: \texttt{WEBALIZER\_HOST\_x\_ACCESS\_IP=''}
}


\config{WEBALIZER\_HOST\_x\_ACCESS\_LOCAL}
{WEBALIZER\_HOST\_x\_ACCESS\_LOCAL}
{WEBALIZERHOSTxACCESSLOCAL}
{
    Hier ist der Zugriff nur local erlaubt.

    \hinweis{Diese Einstellung l"asst sich nicht mit anderen Methoden kombinieren.}

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{WEBALIZER\_HOST\_x\_ACCESS\_LOCAL='yes'}
}


\end{description}

