piXXal-Tutorials
AWStats für einen lokalen Server (Apache2) konfigurieren
Ziel:
In diesem Tutorial soll gezeigt werden, wie man das
Log-File Analyse Tool AWStats installiert und für einen
lokalen Server konfiguriert.
Voraussetzungen:
1) einen installierten Apache2 Web-Server
2) Dieses Tutorial ist für ein Linux- Betriebssystem (Ubuntu/ Debian GNU)
geschrieben und getestet. Die Schritte sollten allerdings ohne
Probleme auf Windows und andere Linux Distributionen übertragbar sein.
3) geringe Kenntnisse der Kommandozeile
AWStats installieren und konfigurieren:
Debian~/ Ubuntu- Packetquellen aktualisieren
>sudo apt-get update
Das Aktualisieren der Packetquellen ist wichtig, um
sicherzustellen, dass immer die neueste Version installiert wird.
AWStats installieren
>sudo apt-get install awstats
Das Installieren muss mit besonderen Rechten (root- Rechten) erfolgen, da bei der Installation Dateien
in Verzeichnissen angelegt werden müssen, in denen nicht jeder Benutzer Dateien anlegen darf.
extra Perl Bibliotheken installieren
>sudo apt-get install libnet-ip-perl
Damit werden dem Programm AWStats mehr Funktionalitäten ermöglicht.
anlegen der Konfigurationsdatei
AWStats wird über die Konfigurationsdatei konfiguriert.
Diese heißt awstats.conf und befindet sich im
Verzeichnis /etc/awstats.
>cd /etc/awstats
>cp awstats.conf awstats.localhost.conf
Wir wechseln mit dem cd- Befehl in das Verzeichnis wo die Standard- Konfigurationsdatei liegt.
Mit dem cp-Befehl erstellen wir uns eine Konfigurationsdatei für unseren Server den wir analysieren wollen.
Für jeden Server (ob lokal oder Internet) muss eine neue Konfigurationsdatei angelegt werden, diese sollte
dann eindeutig bezeichnet werden (awstats.deineDomain.de.conf). Somit ist es
möglich den Traffic verschiedener Server mit einer AWStats- Installation zu analysieren.
Konfigurationsdatei bearbeiten
Die soeben angelegte Konfigurationsdatei muss nun angepasst werden, damit unser Analysetool z.B. weiß wo es
die Apache Log-File herbekommt. Dies sollte mit einem Editor unter root- Rechten erfolgen.
(hier wird der Aufruf des Editors Gedit von Ubuntu mit root- Rechten und der Konfigurationsdatei gezeigt)
>sudo gedit /etc/awstats/awstats.localhost.conf
Nun sollte diese Zeile gefunden werden:
LogFile="/var/log/apache/access.log"
Diese wird mit einem # auskommentiert, da die Log-Files von Apache2 unter Debian GNU Linux
an anderer Stelle zu finden sind. Außerdem wird der richtige Pfad zum Log-File angegeben:
#LogFile="/var/log/apache/access.log"
LogFile="/var/log/apache2/access.log"
Als nächstes passen wir die Zeile:
SiteDomain="localhost"
unserem Server an.
Gleich darunter müssen wir noch die nächste Zeile angepassen.
Localhost ist auch über die IP 127.0.0.1 zu erreichen.
HostAliases="localhost 127.0.0.1"
Dann noch die beiden Zeilen ändern:
AllowToUpdateStatsFromBrowser=1
AllowFullYearView=3
Damit können wir unsere Statistiken über den Browser aktualisieren, was ja sehr praktisch ist und wir bekommen
zusätzlich eine Jahresansicht zur Auswahl.
Dann folgt eine Reihe von Zeilen die uns erstmal nicht interessieren sollten.
Aber am Ende der Datei sollte noch die Zeile:
Include "/etc/awstats/awstats.conf.local"
auskommentiert werden.
#Include "/etc/awstats/awstats.conf.local"
Somit haben wir die Konfigurationsdatei unseren Bedürfnissen angepasst und können
die Datei speichern und den Editor schließen.
AWStats Zugang zu den Apache Log-Files gewähren
Um unserem Programm den Zugang zu den Log- Files zu gewähren müssen wir die Apache2 Konfigurationsdatei
anpassen. Dieses tun wir allerdings nicht indem wir direkt in die Datei reinschreiben,
sondern machen es über einen schönen Apache- Trick. Der Apache2 stellt ein Verzeichnis bereit. Alle
Dateien die sich in diesem Verzeichnis befinden werden automatisch in die Konfiguration eingebunden.
Somit bleibt die eigentliche Datei unberührt und übersichtlich.
>sudo gedit /etc/apache2/conf.d/awstats
Wir legen also eine Datei Namens awstats in dem "Patch"- Ordner an. In diese Datei wird nun folgender Inhalt
geschrieben.
# Apache2 configuration for awstats 6.5 (ubuntu package)
Alias /awstats-icon/ /usr/share/awstats/icon/
ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/
<Directory "/usr/lib/cgi-bin/awstats.pl">
AllowOverride None
Options ExecCGI -MultiViews +SymLinksIfOwnerMatch
Order allow,deny
Allow from all
</Directory>
# EOF
Speichern und Editor schließen.
Apache2 Log- File auslesen und für AWStats aufbereiten
Damit sind wir mit der Installation fertig und können uns an die Aufbereitung der Log- Files machen.
<sudo /usr/lib/cgi-bin/awstats.pl -config=localhost -update
Das Aufbereiten der Log- Files wird durch ein Perl- Skript (awstats.pl) übernommen,
das sich im Verzeichnis /usr/lib/cgi-bin befindet.
Als Meldungen sollte so etwas erscheinen:

AWStats über einen beliebigen Browser aufrufen:
Folgt nun der letzte Schritt, dem anschauen der Analyse:
http://localhost/cgi-bin/awstats.pl?config=localhost
...in einen Browser der Wahl eingeben.
(Diesen Link sollte man sich gleich als Lesezeichen/ Favorit in seinem Browser anlegen, um ihn nicht immer wieder
eingeben zu müssen.)
Fertig!!!
Anregungen und Fehler bitte über folgendes Kontaktformular an uns:
Kontaktformular