Grafische (X)NET-Portstatistik fuer WWW
=======================================

Die CGI-Applikation "postat.cgi" kann (X)NET-Statistikdaten
auswerten und sie im Web-Browser anzeigen.

Installation
============

1.) "postat.cgi" in das cgi-Verzeichnis des Web-Servers kopieren.
    Unter Linux ist das normalerweise "/usr/local/httpd/cgi-bin".
2.) Im obigen Verzeichnis ein weiteres Unterverzeichnis "postat"
    anlegen.
3.) In dieses angelegte Verzeichnis die (X)Net Statistik-Dateien
    z.B. "port.sta" (welche von Statd erzeugt wurden) kopieren
    oder einen direkten Link zum Statistikfile erstellen (siehe
    UNIX ln-Kommando)

Damit ist die Installation abgeschlossen.

Aufruf der Statistik
====================

Der Aufruf der Statistik erfolgt zum Beispiel:

http://www.server.ampr.org/cgi-bin/postat.cgi?df=port.sta&port=1

Als Parameter stehen zur Verfuegung:

df	 Dient zur Angabe des Dateinamens der Statistikdatei.
port     Angabe des Ports, der ausgewertet werden soll. Fuer
         eine Gesamtstatistik kann -1 als Portnummer angegeben
         werden
cfg      Definiert die Art der Statistik. Zulaessig sind Angaben
         von 0,1 und 2.
l2con    Mit l2con = 1 werden auch die Anzahl der Connects auf
         dem Port angezeigt
interval Auswertungsintervall in Minuten. Hiermit kann beispielweise
         eine Auswertung nach Stunden (60) oder Tagen (1440) erfolgen.

Die Parameter werden jeweils mit dem '&'-Zeichen voneinander
getrennt und mittels '=' gesetzt.

Als Beispiel fuer die Verwendung von postat.cgi mit HTML ist
die Datei "statistik.html" beigefuegt.

Remote Statistik
================
Mit der "Remote"-Statistik knnen Telemetriedaten zu einem beliebigen
Statistikdaten-Sammel-Server geschickt werden. Dabei wird das UDP/IP
Protokoll verwendet.
Dazu wird auf dem Digi der Hintergrundprozess rstatd gestartet. Er
uebertraegt alle 10 Minuten die Telemetriedaten an den angegebenen
Statistik-Server.

Statistik-Versand mit rstatd
============================
Gestartet wird rstatd mit dem Start-Befehl. Die IP-Nr. des Statistik-
Sammlers (Web-Server) und die Absenderadresse (IP-Nr des Digis) muss
dabei angegeben werden:

Syntax:

start rstatd <Destination-IP-Web> <Source-IP>

Beispiel:

start rstatd 44.130.55.100 44.130.55.115

Dies genuegt um alle erforderlichen Statistikdaten an den Sammler
zu versenden. Wichtig: Der (X)NET-IP-Router muss natuerlich aktiv
sein. Aus diesem Grund sollte der automatische Start von rstatd
in der Datei "IP.NET" stattfinden.

Der Statistik-Sammel-Server rstatrxd
=====================================
Der Linux-Hintergrundprozess rstatrxd empfaengt auf dem UDP-Port 9394
eingehende Statistikinformationen und speichert sie in Dateien ab.
Um die Dateien gezielt ablegen zu koennen muss beim Start von rstatrxd
der Pfad fuer die Statistikdateien angegeben werden. Der Name der 
jeweligen Statistikdatei wird aus dem Rufzeichen des Absenders gebildet
und endet mit ".sta".

Syntax (Unix):

rstatrxd <path> &

Beispiel:

rstatrxd /usr/local/httpd/cgi-bin/postat/ &

Achtung: der Pfad endet mit einem Schrgstrich ("/").
So werden die eingehenden Daten im oben angegebenen Verzeichnis unter
dem Dateinamen <call>.sta (Beispiel: db0sig.sta) gespeichert. Mit Hilfe
von postat.cgi koennen die Daten nun direkt aus dem Web-Server heraus
ausgewertet werden.

73 de Jimy

