Debian Lenny: AWStats installieren und konfigurieren

AWStats ist ein einfaches Tool um Weblogs auswerten zu können. Unter Debian kann man es ganz einfach mit dem apt-get-Befehl installieren:

apt-get install awstats

Konfiguration:

Ist das Programm installiert, kann man sich über zwei Wege an die Konfiguration machen. Entweder nutzt man die "awstats_configure.pl" unter "/usr/share/doc/awstats/examples/" oder man erledigt alles kurz von Hand. Der erste Weg ist mit einer Menge  Anleitungen unten bei den Links beschrieben. Da dies aber immer auch mit Problemen verbunden ist, wurde der manuelle Weg gewählt (z.B. existiert das beschriebene wwwroot-Verzeichnis aus den Anleitungen nicht, weswegen man dann so Fehler wie Error: Failed to open '/usr/share/doc/awstats/examples/wwwroot/cgi-bin/awstats.model.conf' for read. bekommt).

Zunächst geht man in das Verzeichnis "/etc/awstats" und führt folgenden Befehl aus:

cp awstats.conf awstats.www.meindomain.de.conf

Nun kan man die neue Konfigurationsdatei "awstats.www.meindomain.de.conf" anpassen. Die wichtigsten Parameter die hier anzupassen sind, sind folgende: LogFile, LogFormat und SiteDomain. Bei LogFormat muss man etwas vorsichtig sein. Eigentlich sollte man hier eine "1" angeben, damit alles mit dem Apache konform ist. Allerdings zeigte sich im Test, dass hier die "4" gewählt werden musste. Alle anderen Schalterchen sind in der Dokumentation gut beschrieben und sind zum teil selbsterklärend oder kommentiert.

Da viele Benutzer ein eignes CGI-Verzeichnis bevorzugen und auch keine Lust haben, den Apache auf ein allgemeines Verzeichnis einzurichten, sollte folgender Befehl ausgeführt werden:

cp /usr/lib/cgi-bin/awstats.pl /MEINPFAD/MEIN-CGI-VERZEICHNIS/awstats.pl

Aus Sicherheitsgründen sollte man die awstats.pl per htaccess schützen, da sonst jeder unserer Statistiken aufrufen kann. Wie das funktioniert findet man bei http://www.undertec.de/blog/2008/10/htusers-passwort-per-crypt-ver.html und http://de.selfhtml.org/servercgi/server/htaccess.htm#verzeichnisschutz. Ein Beispiel für eine ".htaccess"-Datei kann so aussehen:

# .htaccess-Datei für Web-Verzeichnis /private
AuthType Basic
AuthName "Geschützter Bereich"
AuthUserFile /PFAD-ZUR-HTUSERS/.htusers

<Files awstats.pl>
Require user BENUTZER
</Files>

Nun muss auf der Kommadozeile noch die Daten für AWStats erzeugen, da momentan noch keine vorhanden sind:

perl awstats.pl -config=www.MEINE-DOMAIN.de -update

Danach kann im Browser den ersten Aufruf wagen:

http://www.MEINE-DOMAIN/MEIN-CGI-VERZEICHNIS/awstats.pl

(Nicht zu vergessen Benutzernamen und Passwort eingeben)

Icons einbinden:

Einen kleine Schönheitfehler gibt es noch: Es werden keine Icons in AWStats dargstellt. Dies kann man beheben in dem man in seiner Apache-Konfiguration unter "/etc/apache2/httpd.conf" folgende Zeilen hinzufügt:

Alias /awstatsicons "/usr/share/awstats/icon/"

<Directory "/usr/share/awstats/icon">
    Options None
    AllowOverride None
    Order allow,deny
    Allow from all
</Directory>

Nun muss man nur noch den Apache neustarten:

/etc/init.d/apache2 restart

Cron zur Aktualisierung nutzen:

Wer jetzt noch "Cron" nutzen will, um seine Statistiken regelmäßig zu aktualisieren, der kann unten bei den Links Hilfe finden. Im Normalfall wird bei der Installation ein automatischer Cron-Job erstellt, der aber noch ein wenig angepasst werden muss.

Fazit:

AWStats ist ein tolles Tool; leider sind bei der Installtion/Konfiguration für Debian noch etliche Lücken. Zum Beispiel funktionieren die Anleitungen bei den Links unten alle nicht mehr exakt. Die manuelle Konfiguration wie oben beschrieben verläuft aber problemlos.

Projektseite von AWStats:
http://awstats.sourceforge.net

Wikipedia-Artikel zu AWStats:
http://de.wikipedia.org/wiki/AWStats

Installationsanleitungen mit awstats_configure.pl:
http://www.debian-administration.org/articles/277
http://www.debianhelp.co.uk/awstats.htm
http://www.debianadmin.com/apache-log-file-analyzer-using-awstats-in-debian.html#

Weitere Anleitungen:
http://www.webmaster-homepage.de/82.0.html
http://www.ponnath-webdesign.de/2006/11/09/hallo-welt/