Bedienung der WWW-Statistik

Vorbemerkung

Das WWW-Statistikprogramm läuft täglich einmal ab. Dabei überprüft es für jeden Benutzer die Datei ".admstat", die im WWW-Verzeichnis des jeweiligen Benutzers liegen muß. Die darin enthaltenen Dateinamen, die zeilenweise angegeben werden müssen, werden daraufhin im Logfile des Apache-Servers gesucht. Jedes Auffinden eines solchen Dateinamens entspricht einem Zugriff auf die entsprechende Datei.

Vorgehensweise, um Zugriffe überprüfen zu lassen

1. Anlegen der Datei .admstat
2. Kopieren der Datei .admstat
3. Datei .admstat lesbar machen

Was noch zu beachten ist

Hinweis Gruppendienst

Anlegen der Datei .admstat

Man öffnet mit einem der zahlreichen Editoren (z.B. Notepad,vi,emacs) eine ASCII-Datei mit dem Namen ".admstat". Dort schreibt man in die erste Zeile zwischen zwei "#"-Zeichen den Titel, der in der HTML-Seite, die generiert wird, erscheinen soll. Gewertet wird alles, was zwischen der Ersten und der letzten Raute (#) steht. Alles was nach der letzten Raute steht wird ignoriert. Falls man in der ersten Zeile keine zwei Rauten eingegeben hat, erscheint in der generierten HTML-Seite ein Default-Titel und die erste Zeile wird genauso interpretiert, wie alle folgenden Zeilen:


1. Alles ab dem ersten Leerzeichen wird ignoriert, d.h. Kommentare können auf diese Weise eingefügt werden.
2. Alles bis zum ersten Leerzeichen (exklusive) wird als eine Datei gewertet, deren Zugriffe überprüft werden sollen.
3. Dabei werden Wildcards (*) automatisch expandiert, um dem Benutzer die Eingabe möglichst einfach zu machen.

Als Beispiel mein WWW-Verzeichnis:


.admstat
Index.html
Wari.zip
ZUGRIFFE.DAT
ZUGRIFFE.HTM
gif                   (Verzeichnis)
html                  (Verzeichnis)
markus-klein.html
meinkey.asc

Meine .admstat:

#WWW-Statistik für Markus Klein#      Das ist der Titel
*.html                                Alle .html Dateien im akt. Verzeichnis
Wari.zip
meinkey.asc
html/*                                Alle Dateien im Verzeichnis html

Wirkung:
 
Der Titel der HTML-Seite ZUGRIFFE.HTM wird "WWW-Statistik für Markus Klein". Für alle Dateien in meinem WWW-Verzeichnis, die auf .html (das sind hier "Index.html" und "markus-klein.html") enden, wird die Anzahl der Zugriffe überprüft.
Desweiteren wird für die beiden Dateien Wari.zip und meinkey.asc, sowie für alle Dateien, die im Verzeichnis "html" liegen, die Anzahl der Zugriffe überprüft.

Kopieren der Datei .admstat

Man muß die Datei .admstat in sein WWW- bzw. Homepageverzeichnis kopieren. Dafür benutzt man einen FTP-Klienten. Die Funktionsweise ist von solchen Programmen ist hier erläutert. Man muß dafür Sorge tragen, daß die Datei nach dem Kopieren auch ".admstat" heißt (vor allem, wenn man sie unter Windows erstellt hat).
Die .admstat muß dabei im Homepage-Stammverzeichnis liegen, bei Gruppen beachte man bitte nachfolgenden Hinweis Gruppendienst.

Datei .admstat lesbar machen

Nachdem die .admstat im richtigen Verzeichnis angelangt ist muß man ihr nur noch die entsprechenden Rechte verpassen. Es reicht aus, wenn sie für alle lesbar ist. Das erreicht man mit einem "chmod 644 .admstat". Im Normalfall werden alle Dateien automatisch mit dieser Berechtigung ausgestattet, so daß sich dieser Schritt erübrigt.

Was noch zu beachten ist

Wie aus den obigen Erläuterungen schon hervorgegangen sein müßte, wird pro Zeile nur ein Dateiname akzeptiert, da in jeder Zeile alles nach dem ersten Leerzeichen ignoriert wird. Jeder Eintrag wird auf Richtigkeit überprüft, d.h. Dateien, die nicht existieren oder nicht zum Lesen freigegeben sind, werden ignoriert.
Einige Benutzer könnten den Wunsch hegen, ihre Statistik von Zeit zu Zeit zurückzusetzen. Dies ist auf mehrere Weisen möglich:
 
• Löschen der Datei .admstat
• Leserechte der Datei .admstat entfernen
• In jeder Zeile der .admstat ein Leerzeichen an den Anfang stellen


Alle Dateien, auf die bisher noch nicht zugegriffen wurde, werden nicht in der HTML-Seite aufgefürt. Man kann jedoch an Hand der Datei ZUGRIFFE.DAT, die im selben Verzeichnis wie die ZUGRIFFE.HTM liegt, nachsehen, ob die Dateinamen vom Programm akzeptiert wurden, da dort (ZUGRIFFE.DAT) alle benötigten Daten abgelegt sind. Die Datei ZUGRIFFE.HTM ist nur eine übersichtlichere Darstellung des Inhalts der ZUGRIFFE.DAT.
Falls eine neue Dateie im WWW-Verzeichnis erstellt wird, auf die eine Zeile der .admstat zutrifft, dann erscheint sie nach dem nächsten Programmdurchlauf (also spätestens am darauffolgenden Tag) ebenfalls in der HTML-Seite. Auf das obige Beispiel bezogen bedeutet das, daß z.B. jede neu erstellte Datei im Verzeichnis html automatisch vom WWW-Statistikprogramm erfaßt und überprüft wird.
Gelöschte Dateien werden automatisch aus der HTML-Seite und dem Datenbestand entfernt.
 

Hinweis Gruppendienst

Noch ein wichtiger Hinweis für Gruppen: Die .admstat muß sich im Verzeichnis /WWW/loginID/URL befinden und darf auf keinen Fall im Verzeichnis /WWW/loginID enthalten sein, da das Statistikprogramm nicht unterscheiden kann welches Verzeichnis denn nun das eigentliche WWW Verzeichnis ist und folglich keine Daten erhoben werden können.