AWStats installieren

AWStats

AWStats ist ein Tool zur graphischen Auswertung von Logfiles.

mehr Infos unter http://www.awstats.org/

Vorarbeiten

Als Paketadmin die Logfiles per Eintrag in die config.ini auf die entsprechende Domain verteilen (http_log_directory = domain) siehe Traffic_logs.

Download und Entpacken

Login als Domainadmin, in unserem Fall heißt dieser xyz00-doms. In unserem Beispiel verwenden wir die Version 6.7 und laden sie direkt mit wget ins Home-Verzeichnis:

xyz00-doms:~$ wget http://prdownloads.sourceforge.net/awstats/awstats-6.7.tar.gz

Datei entpacken:

xyz00-doms:~$ tar -xvzf awstats-6.7.tar.gz

Die entpackten Ordner verteilen:

xyz00-doms:~$ mv awstats-6.7/wwwroot/cgi-bin/ doms/example.com/cgi/awstats
xyz00-doms:~$ mv awstats-6.7/wwwroot/icon doms/example.com/subs/www/icon
xyz00-doms:~$ mv awstats-6.7/wwwroot/js doms/example.com/subs/www/js

Der Rest kann wieder gelöscht werden:

xyz00-doms:~$ rm awstats-6.7.tar.gz
xyz00-doms:~$ rm -rf awstats-6.7

Verzeichnis anlegen, in das awstats seine Daten schreiben kann:

xyz00-doms:~$ mkdir aw_data

Verzeichnis anlegen, in das die erzeugten Statistiken abgelegt werden:

xyz00-doms:~$ mkdir doms/example.com/subs/www/statistik

Konfiguration

Config-datei zum Editieren öffnen, z.b. mit nano:

xyz00-doms:~$ nano doms/example.com/cgi/awstats/awstats.example.com.conf

Folgende Einträge sind anzupassen:

• LogFile="gzip -cd /home/doms/example.com/var/*example.com-%YYYY-0%MM-0%DD-0*|"
• SiteDomain="www.example.com"
• DirData="/home/pacs/xyz00/aw_data/"
• DirCgi="/cgi-bin/awstats"
• Lang="de"

Die wichtigsten weiteren Möglichkeiten:

• Um über den Browser eine Jahressortierung zu ermöglichen:

 AllowFullYearView=3

• Um Client-Informationen über Javascript auszulesen:

  o MiscTrackerUrl="/js/awstats_misc_tracker.js"
  o ShowScreenSizeStats=1
  o ShowMiscStats=anjdfrqwp

(hinweis: dazu muss die Startseite (index.html) innerhalb des body-tags um folgenden Eintrag ergänzt werden:

<script language=javascript src="/js/awstats_misc_tracker.js"></script>
<noscript><img src="/js/awstats_misc_tracker.js?nojs=y" height=0 width=0 border=0 style="display: none"></noscript>

Weiterführende Informationen zu den Einträgen in der Config-Datei sind hier zu finden: http://awstats.sourceforge.net/docs/awstats_config.html

Config-Datei unter cgi/awstats/awstats.example.com.conf abspeichern.

Rechtevergabe

Folgende Rechte müssen wir noch setzen:

Prüfen:
xyz00-doms:~$ chmod 755 doms/example.com/cgi/awstats/lang
xyz00-doms:~$ chmod 755 doms/example.com/cgi/awstats/lib
xyz00-doms:~$ chmod 755 doms/example.com/cgi/awstats/plugins
xyz00-doms:~$ chmod 755 doms/example.com/cgi/awstats/awstats.pl
xyz00-doms:~$ chmod 755 doms/example.com/cgi/awstats/awredir.pl 
xyz00-doms:~$ chmod 755 doms/example.com/subs/www/icon
xyz00-doms:~$ chmod 755 doms/example.com/subs/www/js

Ändern:
xyz00-doms:~$ chmod 644 doms/example.com/cgi/awstats/awstats.example.com.conf
xyz00-doms:~$ chmod 777 aw_data

Ausführen und Automatisieren

Falls schon ein Log-file für den aktuellen Tag vorhanden ist, kann

awstats durch folgenden Befehl gestartet werden (alles in einer Zeile!):

xyz00-doms:~$ /home/doms/example.com/cgi/awstats/awstats.pl -config=example.com -update -output > /home/doms/example.com/subs/www/statistik/index.html

Diesen Befehl kann man z.B. mit dem event-handler @weblogsplit verbinden. Mit Cronjobs lässt sich der Aufruf natürlich auch automatisieren.

Die Statistiken sind dann im web unter www.example.com/statistik/ erreichbar.