Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- tachtler:awstats [2016/05/17 13:56] – [Plugins GeoIP/GeoLightCity] klaus
+++ tachtler:awstats [Unbekanntes Datum] (aktuell) – gelöscht - Externe Bearbeitung (Unbekanntes Datum) 127.0.0.1
@@ Zeile 1: / Zeile 1: @@
-====== AWStats ======
-[[http://www.awstats.org|{{:tachtler:index:awstats-48x48.png }}]] [[http://www.awstats.org|AWStats]] ist ein freies, sehr mächtiges und mit zahlreichen Funktionen ausgestattetes Werkzeug, zur Erstellung von grafischen Auswertungen und Statistiken von //Webserver//-, //FTP-Server//- und //e-Mail-Server//-Logdateien zur Darstellung in HTML-Seiten.
-===== Voraussetzungen =====
-Als Voraussetzung für die Installation von [[http://www.awstats.org|AWStats]] sind folgende Komponenten erforderlich:
-  * Lauffähiger Web-Server z.B. [[http://httpd.apache.org/|Apache HTTP Server]]
-  * Ein installierte Version der Script-Sprache [[http://www.perl.org/|Perl]]
-===== Herunterladen =====
-Es wird empfohlen die letzte stabile Version von [[http://www.awstats.org|AWStats]] im //Download//-Bereich herunter zu laden. Es empfiehlt sich das RPM-Paket welches Architektur unabhängig ist herunterzuladen. Aktuell ist das die Version ''6.8 - 2008-07-20 14:58'' - die zu herunterladende Datei lautet aktuell
-  * ''awstats-6.8-1.noarch.rpm''
-===== Installation =====
-Ab hier werden ''root''-Rechte zur Ausführung der nachfolgenden Befehle benötigt. Um ''root'' zu werden geben Sie bitte folgenden Befehl ein:
-<code>
-$ su -
-Password:
-</code>
-Ein mögliche Installation wäre das RPM-Paket mit folgendem Befehl zu installieren, ausgehend davon das das RPM-Paket sich im Verzeichnis ''/tmp'' befindet:
-<code>
-# yum localinstall --nogpgcheck /tmp/awstats-6.8-1.noarch.rpm
-</code>
-Die Installation von [[http://www.awstats.org|AWStats]] erfolgt im Verzeichnis ''/usr/local/awstats''.
-Der Inhalt dieses Verzeichnisses sieht wie folgt aus:
-<code>
-# ll
-total 20
-drwxr-xr-x 3 root root 4096 Aug 23 20:58 docs
--r--r--r-- 1 root root 6718 Jul 21 00:26 README.TXT
-drwxr-xr-x 4 root root 4096 Aug 23 20:58 tools
-drwxr-xr-x 7 root root 4096 Aug 23 20:58 wwwroot
-</code>
-:!: Weitere Instruktionen zu Installation und Konfiguration sind in in der lokal installierten Datei ''/usr/local/awstats/docs/index.html'' zu finden.
-===== Konfiguration =====
-Die Konfiguration von [[http://www.awstats.org|AWStats]] besteht hauptsächlich aus zwei Schritten:
-  - Installation und Konfiguration erfolgt durch ein //Perl//-Script mit dem Namen ''awstats_configure.pl'', oder durch manuelle Tätigkeiten.
-  - Generieren von Statistiksätzen für [[http://www.awstats.org|AWStats]] durch ein //Perl//-Script mit dem Namen ''awstats.pl''.
-==== Konfiguration Webserver ====
-Hier soll die Konfiguration eines **virtuellen Host** für den [[http://httpd.apache.org/|Apache HTTP Server]] beschrieben werden. Der Aufruf von [[http://www.awstats.org|AWStats]] soll über die URL
-  * http://www.awstats.tachtler.net
-ermöglicht werden.
-:!: Falls Sie noch keine Erfahrungen mit **virtuellen Hosts** in Verbindung mit dem [[http://httpd.apache.org/|Apache HTTP Server]] haben sollten, lesen Sie bitte die Dokumentation des //Apache HTTP Server Projektes//, da hier nur die grundlegenden Schritte erläutert werden.
-Falls noch nicht geschehen wird im Verzeichnis ''/etc/httpd/conf.d'' eine Datei mit dem Namen ''vhosts.conf'' erstellt. Der Inhalt dieser Datei sollte minimal für einen **virtuellen Host** für [[http://www.awstats.org|AWStats]] wie folgt aussehen:
-<code apache>
-# This configuration file enables the vhosts to this
-# Server
-#
-NameVirtualHost *:80
-#
-# awstats.tachtler.net
-#
-<VirtualHost *:80>
-        ServerAdmin webmaster@tachtler.net
-        ServerName awstats.tachtler.net
-        ServerAlias www.awstats.tachtler.net
-        ServerPath /
-        DocumentRoot "/var/www/html/awstats"
-        <Directory "/var/www/html/awstats">
-                Options FollowSymLinks
-                AllowOverride AuthConfig
-                Order allow,deny
-                Allow from all
-        </Directory>
-        #
-        # Directives to add to your Apache conf file to allow use of AWStats as a CGI.
-        # Note that path "/usr/local/awstats/" must reflect your AWStats install path.
-        #
-        Alias /awstatsclasses "/usr/local/awstats/wwwroot/classes/"
-        Alias /awstatscss "/usr/local/awstats/wwwroot/css/"
-        Alias /awstatsicons "/usr/local/awstats/wwwroot/icon/"
-        ScriptAlias /awstats/ "/usr/local/awstats/wwwroot/cgi-bin/"
-        #
-        # This is to permit URL access to scripts/files in AWStats directory.
-        #
-        <Directory "/usr/local/awstats/wwwroot">
-                Options None
-                AllowOverride AuthConfig
-                Order allow,deny
-                Allow from all
-        </Directory>
-        DirectoryIndex index.htm
-        ErrorLog logs/awstats_error.log
-        CustomLog logs/awstats_access.log combined
-</VirtualHost>
-</code>
-Anschließend wird das Verzeichnis ''/var/www/html/awstats'' mit folgendem Befehl angelegt:
-<code>
-# mkdir /var/www/html/awstats
-</code>
-Die Besitzrechte für das Verzeichnis ''/var/www/html/awstats'' müssen noch korrigiert werden, was mit folgendem Befehl durchgeführt wird:
-<code>
-# chown -R root.apache /var/www/html/awstats
-</code>
-Die Zugriffsrechte müssen ebenfalls noch für das Verzeichnis ''/var/www/html/awstats'' noch korrigiert werden, was mit folgendem Befehl durchgeführt wird:
-<code>
-# chmod -R 750 /var/www/html/awstats
-</code>
-:!: Abschließend muss noch das Besitzrecht auf das Verzeichnis ''/var/log/httpd'' mit folgendem Befehl angepasst werden:
-<code>
-# chown root.apache /var/log/httpd
-</code>
-:!: Die Zugriffsrechte müssen ebenfalls noch auf das Verzeichnis ''/var/log/httpd'' mit folgendem Befehl angepasst werden:
-<code>
-# chmod 750 /var/log/httpd
-</code>
-Ein erneuter oder erster Start des [[http://httpd.apache.org/|Apache HTTP Server]] mit folgenden Befehl für eine erstmaligen Start
-<code>
-# service httpd start
-</code>
-oder einen erneuten Start des [[http://httpd.apache.org/|Apache HTTP Server]] mit folgendem Befehl
-<code>
-# service httpd restart
-</code>
-macht die oben beschriebenen Konfigurationen für den [[http://httpd.apache.org/|Apache HTTP Server]] wirksam.
-==== Konfiguration AWStats ====
-Zur Konfiguration von [[http://www.awstats.org|AWStats]] kann das //Perl//-Script ''awstats_configure.pl'' genutzt werden.
-:!: Dies möchte ich allerdings hier **NICHT** verwenden !!! - Jedoch der Vollständigkeit halber, hier auch diese Beschreibung!
-Dazu könnte mit folgendem Befehl in das Verzeichnis ''/usr/local/awstats/tools'' gewechselt werden:
-<code>
-# cd /usr/local/awstats/tools
-</code>
-Dort befindet sich das //Perl//-Script ''awstats_configure.pl'' welches mit folgendem Befehl aufgerufen werden kann:
-<code>
-# perl awstats_configure.pl
-</code>
-Folgen Sie den Anweisungen, die im Script-Verlauf an Sie gestellt werden!
-:!: Bitte gehen Sie ab hier meinen Beschreibungen nach !!!
-Als erstes wird das Verzeichnis ''/etc/awstats'' mit folgendem Befehl unter ''root''-Rechten erstellt:
-<code>
-# mkdir /etc/awstats
-</code>
-Als nächstes wird das Verzeichnis ''/var/lib/awstats'' mit folgendem Befehl unter ''root''-Rechten erstellt:
-<code>
-# mkdir /var/lib/awstats
-</code>
-:!: Das Besitzrecht auf das Verzeichnis ''/var/lib/awstats'' mit folgendem Befehl angepasst werden:
-<code>
-# chown root.apache /var/lib/awstats
-</code>
-:!: Die Zugriffsrechte müssen ebenfalls noch auf das Verzeichnis ''/var/lib/awstats'' mit folgendem Befehl angepasst werden:
-<code>
-# chmod 770 /var/lib/awstats
-</code>
-Anschließen wird eine Konfigurationsdatei aus der Vorlage für Konfiguration von [[http://www.awstats.org|AWStats]] erstellt die Auswertungen und Statistiken für dem auf dem [[http://httpd.apache.org/|Apache HTTP Server]] laufenden Host ''www.tachtler.net'' beinhaltet. Dies wird mit folgendem Befehl durchgeführt:
-<code>
-# cp /usr/etc/awstats/awstats.model.conf /etc/awstats/awstats.tachtler.net.conf
-</code>
-Der Inhalt dieser Datei muss nun angepasst werden. Die folgenden Änderungen müssen bzw. sollten durchgeführt werden um ein Ergebnis aus [[http://www.awstats.org|AWStats]] zu erlagen:
-=== LogFile ===
-  * LogFile="/var/log/httpd/access.log"
-=== SiteDomain ===
-  * SiteDomain="www.tachtler.net"
-=== HostAlias ===
-  * HostAliases="localhost 127.0.0.1 REGEX[tachtler\.net$] REGEX[www\.tachtler\.net$]"
-=== DirData ===
-  * DirData="/var/lib/awstats"
-=== DirCgi ===
-  * DirCgi="/awstats"
-=== DirIcons ===
-  * DirIcons="/awstatsicons"
-=== AllowToUpdateStatsFromBrowser ===
-  * AllowToUpdateStatsFromBrowser=1
-=== SaveDatabaseFilesWithPermissionsForEveryone ===
-  * SaveDatabaseFilesWithPermissionsForEveryone=1
-=== KeepBackupOfHistoricFiles ===
-  * KeepBackupOfHistoricFiles=1
-=== DefaultFile ===
-  * DefaultFile="index.htm"
-=== Lang ===
-  * Lang="de"
-==== Plugins GeoIP/GeoLightCity ====
-Falls folgende Plugins aktiviert und genutzt werden sollen, ist eine Installation eines weiteren //Perl//-Modules bzw. //Perl//-Paketes notwendig:
-  * LoadPlugin="geoip GEOIP_STANDARD /usr/local/share/GeoIP/GeoIP.dat"
-  * LoadPlugin="geoip_city_maxmind GEOIP_STANDARD /usr/local/share/GeoIP/GeoLiteCity.dat"
-:!: **WICHTIG**, alle anderen Module bzw. Pakete von [[http://www.maxmind.com|MaxMind]] sind aktuell Lizenz pflichtig!
-Das //Perl//-Module bzw. //Perl//-Paket welches benötigt wird lautet ''Geo::IP''.
-=== Herunterladen ===
-Das //Perl//-Module bzw. //Perl//-Paket kann unter folgender URL heruntergeladen werden:
-  * [[http://www.maxmind.com/download/geoip/api/pureperl/Geo-IP-PurePerl-1.25.tar.gz|MaxMind Geo::IP Modul herunterladen]]
-=== Installation ===
-Nach dem Herunterladen kann mit folgendem Befehl das *.tar-Archiv (aus dem und in das ''/tmp''-Verzeichnis) entpackt werden:
-<code>
-# tar -xvzf /tmp/Geo-IP-PurePerl-1.20.tar.gz
-</code>
-Anschließend wir das Verzeichnis mit dem Namen ''Geo-IP-PurePerl-1.20'' mit folgendem Befehl in das Verzeichnis ''/usr/local/share/GeoIP'' verschoben:
-<code>
-# mv /tmp/Geo-IP-PurePerl-1.20 /usr/local/share/GeoIP
-</code>
-Abschließend müssen noch die Besitzrechte mit folgendem Befehl angepasst werden:
-<code>
-# chown -R root.root /usr/local/share/GeoIP
-</code>
-Nun kann die eigentliche Installation beginnen!
-Als erstes wird ein wechsel in des Verzeichnis ''/usr/local/share/GeoIP'' durchgeführt:
-<code>
-# cd /usr/local/share/GeoIP
-</code>
-Als nächstes werden mit folgendem Befehl die aktuellen Geo-Daten heruntergeladen:
-<code>
-# wget http://geolite.maxmind.com/download/geoip/database/GeoLiteCountry/GeoIP.dat.gz
---10:58:06--  http://geolite.maxmind.com/download/geoip/database/GeoLiteCountry/GeoIP.dat.gz
-Resolving geolite.maxmind.com... 64.246.48.99
-Connecting to geolite.maxmind.com|64.246.48.99|:80... connected.
-HTTP request sent, awaiting response... 200 OK
-Length: 577935 (564K) [application/x-gzip]
-Saving to: `GeoIP.dat.gz'
-%[=======================================>] 577,935      397K/s   in 1.4s
-:58:08 (397 KB/s) - `GeoIP.dat.gz' saved [577935/577935]
-</code>
-:!: **WICHTIG**, die Geo-Daten werden einmal im Monat aktualisiert zur Verfügung gestellt!
-Im nächsten Schritt entpacken wir die soeben heruntergeladene Datei mit dem Namen ''GeoIP.dat.gz'' mit folgendem Befehl:
-<code>
-# gunzip GeoIP.dat.gz
-</code>
-Abschließend muss das //Perl//-Module noch compiliert werden, was mit folgenden vier Befehlen nacheinander eingegeben durchgeführt werden kann:
-<code>
-perl Makefile.PL
-make
-make test
-make install
-</code>
-Das Ergebnis der oben genannten vier Befehle sollte in etwa wie folgt aussehen:
-<code>
-# perl Makefile.PL
-Checking if your kit is complete...
-Looks good
-Writing Makefile for Geo::IP::PurePerl
-# make
-cp lib/Geo/IP/PurePerl.pm blib/lib/Geo/IP/PurePerl.pm
-cp geoip-lookup blib/script/geoip-lookup
-/usr/bin/perl "-MExtUtils::MY" -e "MY->fixin(shift)" blib/script/geoip-lookup
-Manifying blib/man1/geoip-lookup.1
-Manifying blib/man3/Geo::IP::PurePerl.3pm
-# make test
-PERL_DL_NONLAZY=1 /usr/bin/perl "-MExtUtils::Command::MM" "-e" "test_harness(0, 'blib/lib', 'blib/arch')" t/*.t
-t/0_base..........ok
-t/1_lookup........ok
-t/2_namelookup....ok
-All tests successful.
-Files=3, Tests=31,  1 wallclock secs ( 0.34 cusr +  0.06 csys =  0.40 CPU)
-# make install
-Installing /usr/lib/perl5/site_perl/5.8.8/Geo/IP/PurePerl.pm
-Installing /usr/share/man/man1/geoip-lookup.1
-Installing /usr/share/man/man3/Geo::IP::PurePerl.3pm
-Installing /usr/bin/geoip-lookup
-Writing /usr/lib/perl5/site_perl/5.8.8/i386-linux-thread-multi/auto/Geo/IP/PurePerl/.packlist
-Appending installation info to /usr/lib/perl5/5.8.8/i386-linux-thread-multi/perllocal.pod
-</code>
-Um weitere Geo-Daten über Städte herunterzuladen kann folgender Befehl genutzt werden:
-<code>
-# wget http://www.maxmind.com/download/geoip/database/GeoLiteCity.dat.gz
---21:01:06--  http://www.maxmind.com/download/geoip/database/GeoLiteCity.dat.gz
-Resolving www.maxmind.com... 67.15.94.80
-Connecting to www.maxmind.com|67.15.94.80|:80... connected.
-HTTP request sent, awaiting response... 200 OK
-Length: 17392701 (17M) [application/x-gzip]
-Saving to: `GeoLiteCity.dat.gz'
-%[====================================================================================================================>] 17,392,701   407K/s   in 44s
-:01:51 (386 KB/s) - `GeoLiteCity.dat.gz' saved [17392701/17392701]
-</code>
-Anschließend entpacken wir ebenfalls die soeben heruntergeladene Datei mit dem Namen ''GeoLiteCity.dat.gz'' mit folgendem Befehl:
-<code>
-# gunzip GeoLiteCity.dat.gz
-</code>
-==== Plugin HostInfo ====
-Falls folgendes Plugin aktiviert und genutzt werden soll, ist eine Installation eines weiteren //Perl//-Modules notwendig:
-  * LoadPlugin="hostinfo"
-Das //Perl//-Module bzw. //Perl//-Paket welches benötigt wird lautet ''Net::XWhois''.
-=== Herunterladen ===
-Das //Perl//-Module kann unter folgender URL heruntergeladen werden:
-  * [[http://sourceforge.net/project/showfiles.php?group_id=9941&package_id=9903|Net::XWhois]]
-=== Installation ===
-Nach dem Herunterladen kann mit folgendem Befehl das *.tar-Archiv (aus dem und in das ''/tmp''-Verzeichnis) entpackt werden:
-<code>
-# tar -xzvf Net-XWhois-0.90.tar.gz
-</code>
-Anschließend erfolgt mit folgendem Befehl ein Wechseln in das neu entstandene Verzeichnis mit dem Namen ''/tmp/Net-XWhois-0.90'':
-<code>
-# cd /tmp/Net-XWhois-0.90
-</code>
-Abschließend muss das //Perl//-Module noch compiliert werden, was mit folgenden vier Befehlen nacheinander eingegeben durchgeführt werden kann:
-<code>
-perl Makefile.PL
-make
-make test
-make install
-</code>
-Das Ergebnis der oben genannten vier Befehle sollte in etwa wie folgt aussehen:
-<code>
-# perl Makefile.PL
-Checking if your kit is complete...
-Looks good
-Writing Makefile for Net::XWhois
-# make
-cp lib/Net/XWhois.pm blib/lib/Net/XWhois.pm
-Manifying blib/man3/Net::XWhois.3pm
-# make test
-PERL_DL_NONLAZY=1 /usr/bin/perl "-Iblib/lib" "-Iblib/arch" test.pl
-..1
-ok 1
-# make install
-Installing /usr/lib/perl5/site_perl/5.8.8/Net/XWhois.pm
-Installing /usr/share/man/man3/Net::XWhois.3pm
-Writing /usr/lib/perl5/site_perl/5.8.8/i386-linux-thread-multi/auto/Net/XWhois/.packlist
-Appending installation info to /usr/lib/perl5/5.8.8/i386-linux-thread-multi/perllocal.pod
-</code>
-==== Logrotate ====
-Folgende Problemstellung: Zu einem bestimmten Zeitpunkt in einem festgelegten Intervall werden die Log-Dateien des [[http://httpd.apache.org|Apache HTTP Server]] rotiert. Da hier evtl. Daten rotiert werden die noch nicht von [[http://www.awstats.org|AWStats]] ausgewertet wurden, muss dies verhindert werden.
-Die einfachste Möglichkeit besteht darin, **vor** dem sog. //logrotate// [[http://www.awstats.org|AWStats]] anzuweisen, eine Aktualisierung der Auswertungen und Statistiken der Log-Dateien des [[http://httpd.apache.org|Apache HTTP Server]] durchzuführen.
-Dazu muss die Konfigurationsdatei ''/etc/logrotate.d/httpd'' des //logrotate//-Daemons entsprechend wie folgt beschrieben angepasst werden:
-<code ini>
-    prerotate
-        /usr/local/awstats/wwwroot/cgi-bin/awstats.pl -update -config=tachtler.net
-    endscript
-</code>
-Hier die komplette Konfigurationsdatei ''/etc/logrotate.d/httpd'':
-<code ini>
-/var/log/httpd/*log {
-    missingok
-    notifempty
-    sharedscripts
-    prerotate
-        /usr/local/awstats/wwwroot/cgi-bin/awstats.pl -update -config=tachtler.net
-    endscript
-    postrotate
-        /sbin/service httpd reload > /dev/null 2>/dev/null || true
-    endscript
-}
-</code>
-==== Cron-Job ====
-Eine weitere gute Möglichkeit die Daten für [[http://www.awstats.org|AWStats]] aktuell zu halten, ist einen ''cron''-Job z.B. einmal am Tag, oder sogar jede Stunde laufen zu lassen. Die hier beschrieben Methode beschreibt erstere Möglichkeit - die Daten jeden Tag bzw. Nacht einmal zu aktualisieren.
-Dazu wird eine Datei mit dem Namen ''awstats-update'' im Verzeichnuis ''/etc/cron.daily'' mit folgendem Befehl angelegt:
-<code>
-# touch /etc/cron.daily/awstats-update
-</code>
-Als nächstes muss die Datei noch die entsprechenden Zugriffsrechte erhalten, hier das Recht zur Ausführung, was mit folgendem Befehl realisiert werden kann:
-<code>
-# chmod +x /etc/cron.daily/awstats-update
-</code>
-Ob die Erstellung der Datei mit den richtigen Zugriffsrechten erfolgreich war kann mit folgendem Befehl überprüft werden und sollte eine Ausgabe wie diese zeigen:
-<code>
-# ll /etc/cron.daily/awstats-update
--rwxr-xr-x 1 root root 1146 Sep  3 16:59 /etc/cron.daily/awstats-update
-</code>
-Zum Abschluss muss die Datei ''/etc/cron.daily/awstats-update'' noch mit folgendem Inhalt gefüllt werden:
-<code bash>
-#!/bin/sh
-/usr/local/awstats/wwwroot/cgi-bin/awstats.pl -update -config=tachtler.net >/dev/null
-/usr/local/awstats/wwwroot/cgi-bin/awstats.pl -update -databasebreak=day -config=tachtler.net >/dev/null
-</code>
-Zum testen, ob das //Script// auch funktioniert, kann mit folgendem Befehl in das Verzeichnis ''/etc/cron.daily'' gewechselt werden:
-<code>
-# cd /etc/cron.daily
-</code>
-Anschließend wird folgender Befehl genutzt um das //Script// auszuführen (:!: es wird keine Ausgabe erzeugt !!!)
-<code>
-# ./awstats-update
-</code>
-===== Erster Aufruf =====
-Nach erfolgreicher Konfiguration steht dem ersten Aufruf nichts mehr im Wege. Der Aufruf erfolgt über folgende URL:
-  * http://www.awstats.tachtler.net/awstats/awstats.pl?config=tachtler.net
-:!: **WICHTIG** ist, der Teil nach ''?config='', dieser Teil ergibt sich aus dem Namen, welcher der Konfigurationsdatei im Verzeichnis ''/etc/awstats'' gegeben wurde, also hier in diesem Beispiel:
-<code>
-awstats.tachtler.net.conf
-</code>
-:!: **WICHTIG**, da noch keine Auswertung der Log-Datei (hier ''/var/log/httpd/access.log'') des [[http://httpd.apache.org/|Apache HTTP Server]] durchgeführt wurde, können auch noch **__keine Daten__** angezeigt werden!
-===== Tagesstatistiken =====
-:!: **WICHTIG** - **Voraussetzung für eine tagesbezogene Auswertung, ist nachfolgende Angabe im ''cron''-Job von [[http://www.awstats.org|AWStats]]** (**nur relevanter Ausschnitt**):
-<code>
-...
-/usr/local/awstats/wwwroot/cgi-bin/awstats.pl -update -databasebreak=day -config=tachtler.net >/dev/null
-...
-</code>
-Der Aufruf über die URL im Browser, muss zusätzlich mit nachfolgenden Parametern ergänzt werden, um anstelle von __**Monatsstatistiken**__ - __**Tagesstatistiken**__ zu erhalten:
-  * http://www.awstats.tachtler.net/awstats/awstats.pl?config=tachtler.net&databasebreak=day&day=16&month=10&year=2012
-Die Parameter müssen in der URL, wie folgt angegeben werden:
-  * **&databasebreak=day** - Auswertung auf einen Tag beschränken
-  * **&day=nn** - Tag
-  * **&month=nn** - Monat
-  * **&year=nnnn** - Jahr
-===== BetterAWStats =====
-Als Erweiterung die auf [[http://www.awstats.org|AWStats]] aufbaut, kann [[http://sourceforge.net/projects/betterawstats/|BetterAWStats]] installiert werden!
-Diese Erweiterung ermöglicht zwar nicht den vollen Umfang der Anzeigemöglichkeiten von [[http://www.awstats.org|AWStats]] und ist **keinesfalls** als **Ersatz** anzusehen, vor allem weil auch [[http://sourceforge.net/projects/betterawstats/|BetterAWStats]] auf die Daten aus [[http://www.awstats.org|AWStats]] angewiesen ist!
-==== Voraussetzungen BetterAWStats ====
-Als Voraussetzung für die Installation von [[http://sourceforge.net/projects/betterawstats/|BetterAWStats]] sind folgende Komponenten erforderlich:
-  * Lauffähiger Web-Server z.B. [[http://httpd.apache.org/|Apache HTTP Server]]
-  * Ein installierte Version der Script-Sprache [[http://www.perl.org/|Perl]] :!: **ab Version 5.2** - Dies kann jedoch durch einen **Workaround** umgangen werden zur Nutzung älterter Versionen!
-  * Das Paket ''php-gd'' zur PHP Unterstützung der //GD Gaphic Library//
-==== Herunterladen BetterAWStats ====
-Unter folgendem Link, kann eine aktuelle Version von [[http://sourceforge.net/projects/betterawstats/|BetterAWStats]] heruntergeladen werden:
-  * [[http://sourceforge.net/projects/betterawstats/|Akuelle Version BetterAWStats herunterladen]]
-==== Konfiguration BetterAWStats ====
-Für den Betrieb von [[http://sourceforge.net/projects/betterawstats/|BetterAWStats]] wird noch das Paket ''php-gd'' zur PHP-Unterstützung der //GD Gaphic Library// benötigt, welches mit folgendem Befehl installieren werden kann.
-<code>
-# yum install php-gd
-</code>
-Anschließend kann die heruntergeladene Datei, hier ''/tmp/betterawstats-1.0.zip'' mit folgendem Befehl entpackt werden:
-<code>
-# unzip /tmp/betterawstats-1.0.zip /usr/local/awstats/wwwroot/cgi-bin
-</code>
-Besondere Beitzerrechte benötigt die Konfigurationsdatei ''/usr/local/awstats/wwwroot/cgi-bin/betterawstats/config.php'', welche zur späteren Konfiguration von [[http://www.betterawstats.com|BetterAWStats]] über das //Web-Interface// folgende Rechte mit folgendem Befehl erhalten muss:
-<code>
-# chown root.apache /usr/local/awstats/wwwroot/cgi-bin/betterawstats/config.php
-</code>
-Zusätzlich benötigt die Konfigurationsdatei ''/usr/local/awstats/wwwroot/cgi-bin/betterawstats/config.php'' auch spezielle Dateirechte, welche zur späteren Konfiguration von [[http://www.betterawstats.com|BetterAWStats]] über das //Web-Interface// folgende Rechte mit folgendem Befehl erhalten muss:
-<code>
-# chmod 664 /usr/local/awstats/wwwroot/cgi-bin/betterawstats/config.php
-</code>
-Die Benutzer- und Dateirechte können dann mit nachfolgendem Befehl überprüft werden und sollte in etwa folgende Ausgabe erzeugen:
-<code>
-# ll /usr/local/awstats/wwwroot/cgi-bin/betterawstats/
-total 108
--r--r--r-- 1 root root     135 Mar 14  2008 bawstats.info
--r--r--r-- 1 root root    1296 Mar 16  2008 bawstats.install
--r--r--r-- 1 root root    7721 Mar 16  2008 bawstats.module
--rw-rw-r-- 1 root apache 31875 Dec  9 10:19 config.php
-drwxr-xr-x 2 root root    4096 Dec  8 16:17 core
-drwxr-xr-x 2 root root    4096 Mar 18  2008 docs
--r--r--r-- 1 root root     766 Jun  1  2004 favicon.ico
--r--r--r-- 1 root root    1116 Mar  9  2008 horizontal.css
-drwxr-xr-x 2 root root    4096 Mar 18  2008 icons
-drwxr-xr-x 2 root root    4096 Mar 18  2008 includes
--r--r--r-- 1 root root    4643 Mar 17  2008 index.php
-drwxr-xr-x 2 root root    4096 Mar 18  2008 language
-drwxr-xr-x 2 root root    4096 Mar 18  2008 modules
--r--r--r-- 1 root root    2258 Mar 17  2008 scripts.js
--r--r--r-- 1 root root    8658 Mar  9  2008 style.css
--r--r--r-- 1 root root     306 Mar  9  2008 vertical.css
-</code>
-Die bereits im Verzeichnis ''/etc/httpd/conf.d'' angelegte Datei mit dem Namen ''vhosts.conf'' muss wie folgt bei den Einstellungen für den **virtuellen Host** für [[http://www.awstats.org|AWStats]] angepasst werden:
-<code apache>
-# This configuration file enables the vhosts to this
-# Server
-#
-NameVirtualHost *:80
-#
-# awstats.tachtler.net
-#
-<VirtualHost *:80>
-        ServerAdmin webmaster@tachtler.net
-        ServerName awstats.tachtler.net
-        ServerAlias www.awstats.tachtler.net
-        ServerPath /
-        DocumentRoot "/var/www/html/awstats"
-        <Directory "/var/www/html/awstats">
-                Options FollowSymLinks
-                AllowOverride AuthConfig
-                Order allow,deny
-                Allow from all
-        </Directory>
-        #
-        # Directives to add to your Apache conf file to allow use of AWStats as a CGI.
-        # Note that path "/usr/local/awstats/" must reflect your AWStats install path.
-        #
-        Alias /awstatsclasses "/usr/local/awstats/wwwroot/classes/"
-        Alias /awstatscss "/usr/local/awstats/wwwroot/css/"
-        Alias /awstatsicons "/usr/local/awstats/wwwroot/icon/"
-        Alias /awstats/betterawstats "/usr/local/awstats/wwwroot/cgi-bin/betterawstats/"
-        Alias /icons "/usr/local/awstats/wwwroot/cgi-bin/betterawstats/icons/"
-        ScriptAlias /awstats/ "/usr/local/awstats/wwwroot/cgi-bin/"
-        #
-        # This is to permit URL access to scripts/files in AWStats directory.
-        #
-        <Directory "/usr/local/awstats/wwwroot">
-                Options None
-                AllowOverride AuthConfig
-                Order allow,deny
-                Allow from all
-        </Directory>
-        DirectoryIndex index.htm index.php
-        ErrorLog logs/awstats_error.log
-        CustomLog logs/awstats_access.log combined
-</VirtualHost>
-</code>
-:!: **WICHTIG** - Die Reihenfolge in der die ''Alias''- bzw. ''ScriptAlias''-Anweisungen stehen ist entscheidend!
-Folgende Zeilen wurden hinzugefügt, bzw. abgeändert:
-<code apache>
-...
-        Alias /awstats/betterawstats "/usr/local/awstats/wwwroot/cgi-bin/betterawstats/"
-        Alias /icons "/usr/local/awstats/wwwroot/cgi-bin/betterawstats/icons/"
-...
-        DirectoryIndex index.htm index.php
-...
-</code>
-:!: **WICHTIG** - **Workaround**, falls eine **PHP-Version** kleiner als **5.2** installiert ist und kein //Update// auf PHP Version 5.2 möglich oder gewollt ist, sind folgende Anpassungen vorzunehmen!
-Die relevanten Änderungen gegenüber der Standard-Programmcode, sind mit folgendem Kommentar
-<code>
-# Tachtler
-</code>
-versehen.
-In der Datei ''/usr/local/awstats/wwwroot/cgi-bin/betterawstats/core/display_helpers.php'', welches Programm-Bestandteil von [[http://sourceforge.net/projects/betterawstats/|BetterAWStats]] ist, ist an folgender Stelle nachfolgende Änderung durchzuführen: //(Danke an Michi :-))//
-<code php>
-        /* Tachtler
-        * default:
-        * . baw_display_version("<br" . XHTML . "> in $finaltime, max menory: " . baw_byte_format(memory_get_peak_usage(true)))
-        */
-        . baw_display_version("<br" . XHTML . "> in $finaltime")
-</code>
-Zum Abschluss die Einstellungen für die Hauptkonfiguratiosndatei ''/usr/local/awstats/wwwroot/cgi-bin/betterawstats/config.php''. Die relevanten Änderungen gegenüber der Standard-Konfiguration, sind mit folgendem Kommentar
-<code>
-// Tachtler
-</code>
-versehen.
-:!: **WICHTIG** - Es werden **nur** die relevanten Einstellungen angezeigt, welche von der Standard-Konfiguration abweichen müssen, um einen grundlegenden Start von [[http://sourceforge.net/projects/betterawstats/|BetterAWStats]] zu ermöglichen:
-<code ini>
-...
-$BAW_CONF['site_url'] = 'http://www.awstats.tachtler.net/awstats/betterawstats';
-$BAW_CONF['site_path'] = '/usr/local/awstats/wwwroot/cgi-bin/betterawstats';
-$BAW_CONF['path_data'] = '/var/lib/awstats';
-$BAW_CONF['path_lib'] = '/usr/local/awstats/wwwroot/cgi-bin/lib';
-$BAW_CONF['path_lang'] = '/usr/local/awstats/wwwroot/cgi-bin/lang';
-$BAW_CONF['icons_url'] = 'http://awstats.tachtler.net/awstatsicons';
-$BAW_CONF['online_config'] = true;
-$BAW_CONF['online_config_password'] = 'geheim';
-$BAW_CONF['limit_server'] = 'show_all';
-...
-</code>
-[[http://sourceforge.net/projects/betterawstats/|BetterAWStats]] sollte jetzt als Ergänzung zu [[http://www.awstats.org|AWStats]] zur Verfügung stehen!
-==== Erster Aufruf BetterAWStats ====
-Nach erfolgreicher Konfiguration steht dem ersten Aufruf nichts mehr im Wege. Der Aufruf erfolgt über folgende URL:
-  * http://www.awstats.tachtler.net/awstats/betterawstats
-==== JpGraph einbinden BetterAWStats  ====
-Eine weitere Möglichkeit der Verbesserung von [[http://sourceforge.net/projects/betterawstats/|BetterAWStats]] besteht darin, [[http://www.aditus.nu/jpgraph/index.php|JpGraph]] einzubinden! [[http://www.aditus.nu/jpgraph/index.php|JpGraph]] ist ein Objekt-Orientierte Grafikbibliothek, speziell für den Einsatz mit PHP konzipiert!
-=== JpGraph Herunterladen ===
-Unter folgendem Link, kann eine aktuelle Version von [[http://www.aditus.nu/jpgraph/index.php|JpGraph]] heruntergeladen werden:
-  * [[http://www.aditus.nu/jpgraph/jpdownload.php|Akuelle Version JpGraph herunterladen]]
-=== JpGraph Installieren ===
-Nach dem erfolgreichen herunterladen der aktuellen [[http://www.aditus.nu/jpgraph/index.php|JpGraph]]-Datei, z.Zt. ''jpgraph-2.3.3.tar.gz'' kann diese JAR-Archivdatei mit folgendem Befehl entpackt werden:
-<code>
-# tar -xzvf /tmp/jpgraph-2.3.3.tar.gz
-</code>
-Anschließend muss das so entpackte Verzeichnis noch in das in das [[http://sourceforge.net/projects/betterawstats/|BetterAWStats]]-Verzeichnis mit folgendem Befehl verschoben werden:
-<code>
-# mv /tmp/jpgraph-2.3.3 /usr/local/awstats/wwwroot/cgi-bin/betterawstats/
-</code>
-Als nächstes kann das Verzeichnis ''/usr/local/awstats/wwwroot/cgi-bin/betterawstats/jpgraph-2.3.3'' mit folgendem Befehl in ''/usr/local/awstats/wwwroot/cgi-bin/betterawstats/jpgraph'' umbenannt werden:
-<code>
-# mv /usr/local/awstats/wwwroot/cgi-bin/betterawstats/jpgraph-2.3.3 /usr/local/awstats/wwwroot/cgi-bin/betterawstats/jpgraph
-</code>
-Abschließend müssen noch die Besitzrechte des kompletten Verzeichnisses und etwaiger Unterverzeichnisse mit folgendem Befehl korrigiert werden:
-<code>
-# chown -R root.apache jpgraph
-</code>
-:!: **WICHTIG** - Zum Abschluss müssen in der Konfigurationsdatei '''' noch folgende Anpassungen erfolgen:
-<code ini>
-...
-$BAW_CONF['use_jpgraph'] = true;
-$BAW_CONF['jpgraph_path'] = '/usr/local/awstats/wwwroot/cgi-bin/betterawstats/jpgraph/src';
-...
-</code>