Die jeweils aktuelle Version von TraffStats können sie hier herunterladen:
1.2.1 Installation der Basisversion
Nach dem Sie die aktuelle Version von TraffStats heruntergeladen haben, entpacken Sie diese in
ein Verzeichnis welches sie über den HTTP-Server erreichen können. z.B.
/var/www/:
tar xz -f TraffStats-0.10.2-core.tgz -C /var/www/
Zwecks Vereinfachung der URL zum Zugriff auf die Web-Applikation können das
TraffStats-0.10.2-Verzeichis verlinken:
ln -sv /var/www/TraffStats-0.10.2/ /var/www/traffstats
Wechseln Sie in das neu erstellte TraffStats-Verzeichnis; alle weiteren Beispiele haben dieses Verzeichnis als Ausgangspunkt.
cd /var/www/TraffStats-0.10.2
Sollten Sie eine alte Version von TraffStats installiert haben, aber eine Neuinstallation wünschen,
müssen Sie vorher die Datenbank und den Datenbankbenutzer löschen,
es sei denn Sie möchten ein Upgrade durchführen. (siehe:
1.3 Upgrade)
Hierfür gibt es 2 Hilfsskripte, die Sie wie folgt anwenden können:
(
Achtung: führen Sie diese Schritte
NICHT durch, wenn Sie ein Upgrade vornehmen möchten!)
mysql -u root -p < sql/99_dropdatabase.sql;
mysql -u root -p < sql/99_dropuser.sql;
Datenbank erstellen: (
Achtung: führen Sie diese Schritte
NICHT durch, wenn Sie ein Upgrade vornehmen möchten!)
Um die Datenbank und die Datenbankbenutzer zu erstellen, benutzen Sie bitte folgende Befehle:
mysql -u root -p < sql/00_create-traffstats-db.sql;
mysql -u root -p < sql/01_createuser.sql;
Anpassung der Dateirechte
Sämtliche Dateien, die sensitive Informationen (Datenbankpasswörter usw.) enthalten,
sollten möglichst restriktive Rechte zugewiesen bekommen, um Unbefugten den Zugriff
auf diese zu verwehren.
Die Datei
config/config.php sollte nur vom Benutzeraccount,
unter dessen ID der Webserver läuft, lesbar sein. z.B.:
chown root.www-data config/config.php;
chmod 640 config/config.php;
Die Datei
collector/collector.pl sollte nur vom Benutzeraccount,
unter dessen ID später der cron-Job zur Datensammlung läuft, les- und ausführbar sein (root). z.B.:
chown root collector/*.pl;
chmod 700 collector/*.pl;
1.2.1.1 Zusätzliche Software - JPGraph
Um den vollen Funktionsumfang von TraffStats benutzen zu können, benötigen Sie noch JpGraph.
Diese Bibliothek können Sie
hier
herunterladen.
JpGraph wird in 2 Versionen ausgeliefert.
Die Versionen 1.x für PHP4 und Versionen 2.x für PHP5.
Bitte laden Sie die Ihrer PHP-Version entsprechende JpGraph-Version herunter.
Sollten Sie eine bereits bestehende Installation von JpGraph besitzen,
lesen Sie bitte unter dem Punkt
"Installation in ein externes Verzeichnis" nach,
wie Sie diese für TraffStats nutzen können.
Zur Installation von JpGraph haben Sie 2 Möglichkeiten:
-
Installation in das TraffStats-Verzeichnis
Diese Möglichkeit bietet sich insbesondere dann an,
wenn Sie JpGraph nur für TraffStats nutzen wollen.
Vorhergehensweise:
Entpacken Sie das heruntergeladene JpGraph-Archiv
und erstellen Sie einen symbolischen Link
jpgraph
zu dem src-Unterverzeichnis des
JpGraph-Verzeichnis:
tar xz -f jpgraph-x.y.tar.gz;
ln -sv jpgraph-x.y/src/ jpgraph;
(ersetzen Sie in beiden Befehlszeilen x.y mit der verwendeten JpGraph-Versionsnummer und
passen Sie gegebenenfalls die Pfadangaben an)
-
Installation in ein externes Verzeichnis:
Diese Möglichkeit bietet sich insbesondere dann an, wenn Sie beabsichtigen JpGraph auch
für andere Projekte einzusetzen.
Vorhergehensweise:
Extrahieren des JpGraph-Paketes in ein externes Verzeichnis
(z.B.: /usr/local/share/jpgraph-x.y
wobei x.y für die entsprechende Version steht)
tar xz -f jpgraph-x.y.tar.gz -C /usr/local/share/;
Anschließend haben Sie nun 2 Möglichkeiten diese JpGrap-Version für TraffStats zu nutzen:
(ersetzen Sie in beiden Fällen x.y mit der verwendeten JpGraph-Versionsnummer und
passen Sie gegebenenfalls die Pfadangaben an)
-
Erstellen Sie einen symbolischen Link jpgraph
zu dem src-Verzeichnis der JpGraph-Installation
ins Installations-Verzeichnis von Traffstats:
ln -sv /usr/local/share/jpgraph-x.y/src/ jpgraph;
-
Editieren Sie die Datei config/graphconfig.php
und ändern Sie den Wert der Variable TRAFFSTATS__JPGRAPH
define("TRAFFSTATS__JPGRAPH", "/usr/local/share/jpgraph-x.y/src/");
1.2.1.2 Zusätzliche Software - Microsoft TrueType core fonts
Die benötigten Schriftarten finden sie unter:
corefonts.sourceforge.net
Sie benötigen nur Arial und Courier um UTF Zeichen in den Grafiken
richtig darstellen zu können.
cabextract können sie von
www.cabextract.org.uk hreunterladen.
mkdir ttf;
cd ttf;
wget http://downloads.sourceforge.net/corefonts/arial32.exe;
wget http://downloads.sourceforge.net/corefonts/courie32.exe;
cabextract -q arial32.exe;
cabextract -q courie32.exe;
for i in Arial*.TTF; do LCF=`echo $i | tr [:upper:] [:lower:]`; ln -sv $i $LCF; done;
Wenn sie die Schriften bereits in einem anderen Verzeichnis installiert haben, können sie:
-
einen symbolischen Link in das Installations-Verzeichnis von Traffstats erstellen:
ln -sv /usr/share/fonts/truetype/msttcorefonts ttf;
-
die Datei config/graphconfig.php editieren
und den Wert der Variable TTF_DIR anpassen:
define("TTF_DIR", "/usr/share/fonts/truetype/msttcorefonts/");
1.2.3 Installation als deb-Paket
Die
deb-Pakete wurden für Debian etch (4.0)
entwickelt. Tests auf testing und unstable (lenny und sid) stehen noch aus.
Es existiert auch ein experimentelles Repository.
Wenn sie dieses benutzen möchten, tragen Sie bitte folgende Zeile
in die Datei
/etc/apt/sources.list ein:
deb http://zero-sys.net/deb/traffstats/ ./
Um den Schlüssel der für die Signierung der Pakete verwendet wurde
zu importieren, geben Sie bitte folgende Befehle als
root ein:
gpg --keyserver subkeys.pgp.net --recv-key ED7D414C ;
gpg --export --armor ED7D414C | apt-key add - ;
Liste der Dateien (deb-Pakete):
- traffstats_0.10.2_all.deb - traffstats
- JpGraph 2.x für die Verwendung mit PHP5
- libphp-jpgraph2_2.3-1_all.deb
- libphp-jpgraph2-examples_2.3-1_all.deb
- libphp-jpgraph2-doc_2.3-1_all.deb
- JpGraph 1.x für die Verwendung mit PHP4
- libphp-jpgraph1_1.22-3_all.deb
- libphp-jpgraph1-examples_1.22-3_all.deb
Um TraffStats für PHP5 zu installieren benötigen Sie die Dateien
traffstats_0.10.2_all.deb und
libphp-jpgraph2_2.3-1_all.deb.
Installieren Sie die benötigten Pakete:
apt-get install apache2 php5 libapache2-mod-php5 php5-gd php5-snmp php5-mysql \
libnet-snmp-perl libdbd-mysql-perl debianutils dbconfig-common debconf ucf \
mysql-server msttcorefonts
Installieren Sie JpGraph:
dpkg -i libphp-jpgraph2_2.3-1_all.deb
Wenn sie lieber das Repository verwenden möchten:
apt-get install libphp-jpgraph2
Installieren Sie TraffStats:
dpkg -i traffstats_0.10.2_all.deb
oder via Repository:
apt-get install traffstats
Analog wäre das Vorgehen für PHP4:
Laden sie folgende Dateien herunter:
traffstats_0.10.2_all.deb und
libphp-jpgraph1_1.22-3_all.deb.
Installieren Sie die benötigten Pakete:
apt-get install apache2 php4 libapache2-mod-php4 php4-gd php4-snmp php4-mysql \
libnet-snmp-perl libdbd-mysql-perl debianutils dbconfig-common debconf ucf \
mysql-server msttcorefonts
Installieren Sie JpGraph:
dpkg -i libphp-jpgraph1_1.22-3_all.deb
Wenn sie lieber das Repository verwenden möchten:
apt-get install libphp-jpgraph1
Installieren Sie TraffStats:
dpkg -i traffstats_0.10.2_all.deb
oder via Repository:
apt-get install traffstats
Bei der Installation von TraffStats können Sie die erforderlichen Datenbanken
automatisch erstellen lassen und die erforderlichen Konfigurationseinstellungen
für den Webserver automatisch erledigen lassen.
Sollten Sie diesen bequemen Weg wählen, können Sie gleich nach der Installation
mit dem Punkt
Erste Anmeldung fortfahren.
