piXXal
Impressum
Sitemap

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

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

erstellt: Mai 2006
Copyright©: piXXal Internetmarketing