AWStats 6.2 auf einem Hosting-Account von all-inkl.com installieren.
Der folgende Text beschreibt, wie man AWStats in der Version 6.2 auf einem Hosting-Account der Firma all-inkl.com (Neue Medien Münnich) installieren kann. Das vorgestellte Verfahren sollte sich, mit kleinen Änderungen, auch auf andere Hoster anwenden lassen.
AWStats soll für die Domain testdomain.tld installiert werden, die dort veröffentlichte Seite ist zusätzlich auch unter www.testdomain.tld zu erreichen. Die Logfiles des Webservers liegen im Verzeichnis /logs, wobei für jeden Tag eine einzelne, mit gzip komprimierte Datei angelegt wird. Das Namensschema der Logfiles lautet access_log_[JAHR]-[MONAT]-[TAG].gz, das aktuelleste verfügbare Logfile ist das vom Vortag. Das cgi-bin des Webservers ist als /cgi-bin verfügbar.
Aus Gründen der Vereinfachung wird in diesem HOWTO davon ausgegangen, dass ein Abbild der online verfügbaren Website auf der lokalen Festplatte vorhanden ist. Dieses Verzeichnis, bspw. /var/www/testdomain.tld/, wird im weiteren Verlauf als [site-root] bezeichnet. Ferner sollte sich die Datei awstats-6.2.tgz (bzw. awstats-62.zip), welche alle von AWStats benötigten Dateien enthält, schon auf der Festplatte befinden.
AWStats ist eigentlich zur Installation durch den Hoster gedacht, weshalb die im Archiv awstats-6.2.tgz enthaltene Dokumentation sich nicht ohne weiteres nutzen lässt - vor allem lässt sich das Skript awstats_configure.pl nicht nutzen, welches die Installation von AWStats automatisiert. Daher sind einige manuelle Schritte zur Vorbereitung der Installation notwendig:
Die Konfiguration von AWStats erfolgt über Dateien, die nach dem Namensschema awstats.[HOST].conf benannt sind und sich im Verzeichnis [site-root]/cgi-bin/awstats finden. Mitgeliefert wird eine als [site-root]/cgi-bin/awstats/awstats.model.conf verfügbare Modellkonfiguration, welche sich als Schablone für die Konfiguration verschiedener Hosts nutzen lässt. Will man eine Konfiguration für den Host testdomain.tld anlegen ist nichts weiter zu tun, als die [site-root]/cgi-bin/awstats/awstats.model.conf zu kopieren, und zwar so, dass sie den Dateinamen [site-rot]/cgi-bin/awstats/awstats.testdomain.tld.conf erhält. Nach diesem Vorgang müssen nur noch ein paar Zeilen in der neuen Konfigurationsdatei geändert werden:
Hat man alle sechs Zeilen angepasst kann man die Konfigurationsdatei speichern und den Editor schließen.
Beim Upload sollte die vorbereitete Struktur im Dateisystem erhalten bleiben, so dass auf dem Server die Verzeichnisse /cgi-bin/awstats und /awstats-files inkl. deren Unterverzeichnissen entstehen. Nach dem erfolgreichen Upload fehlt nur noch ein Schritt bevor man AWStats zum ersten mal nutzen kann: Die Rechte für das Verzeichnis /cgi-bin/awstats/data müssen geändert werden. Dies geschieht in den meisten FTP-Programmen über eine „chmod” genannte Funktion, die benötigten Rechte sind 777, bzw. rwxrwxrwx (lesen, schreiben und ausführen erlaubt für jeden).
Windows-User sollten beachten, dass evtl. noch weitere Rechte gesetzt werden müssen (auf dem Server):
Hat man alles richtig gemacht ist AWStats nach dem Upload unter dem URL http://testdomain.tld/cgi-bin/awstats/awstats.pl erreichbar, über einen Klick auf den Link „Jetzt aktualisieren” oben rechts kann man via Browser die Statistiken aktualisieren.
Ein wichtiger Nachteil darf natürlich nicht verschwiegen werden: Durch die meist nicht vorhandene Möglichkeit den Server automatisch Aktionen starten zu lassen ist ein täglich von Hand gestartetes Update der Statistiken leider notwendig. Vergisst man dies auch nur einmal, so ist der vergessene Tag auch in den Statistiken auf ewig vergessen. Solche „Fehler” lassen sich nur durch eine Änderung der Konfigurationsdatei beheben (LogFile exakt auf die vergessene Logdatei setzen), evtl. ist auch ein löschen des DirData-Verzeichnisses notwendig.
Zur allgemeinen Erheiterung hier einmal die „Originalversion” dieses HOWTOs:
Quick Installation: AWStats on all-inkl.com
===========================================
cd /[local-web-dir]/
tar xvzf /[path-to]/awstats-6.2.tgz
mkdir awstats-files
mkdir cgi-bin/awstats
mkdir cgi-bin/awstats/data
chmod 777 cgi-bin/awstats/data
cp -R awstats-6.2/wwwroot/icon awstats-files/
cp -R awstats-6.2/wwwroot/cgi-bin/* cgi-bin/awstats/
cp cgi-bin/awstats/awstats.model.conf cgi-bin/awstats/awstats.testdomain.tld.conf
vim cgi-bin/awstats/awstats.testdomain.tld.conf
LogFile="gzip -d < ../../logs/access_log_%YYYY-0-%MM-0-%DD-24.gz |"
SiteDomain="testdomain.tld"
HostAliases="www.testdomain.tld"
DNSLookup=1 (optional)
DirData="./data"
DirCgi="/cgi-bin/awstats"
DirIcons="/awstats-files/icon"
AllowToUpdateStatsFromBrowser=1
rm -rf awstats-6.2/
sitecopy -o -u testdomain.tld
Was aus ein wenig Text nicht alles werden kann...