+------------------------------------------------------------------------------+
:                            methodica LogzMon  1.4                            :
:                            Installations-Anleitung                           :
+------------------------------------------------------------------------------+


Index
-----

1. Einfhrung
2. Umfang
3. Installation
4. Konfiguration
5. Sicherheit
6. Rechtliches


1. Einfhrung
   ----------
   
   LogzMon ist ein Tool zur Anzeige und berwachung von Log-Dateien.
   Das Programm listet ausgewhlte Dateien vordefinierter Verzeichnisse
   eines (Web-) Servers. Die Datei-Inhalte von Log-Dateien und Archiven
   (ZIP/GZ) knnen im Detail angezeigt werden. Dabei lassen sich Hervor-
   hebungen definieren und festlegen, welche Zeilen nicht angezeigt werden
   sollen.
   blicherweise werden mit LogzMon Log-Dateien angezeigt. Tatschlich
   lassen sich aber alle ASCII-Dateien verarbeiten.
   
   Im Modus "Auto-Aktualisierung" schickt der Client periodisch Anfragen
   zum Aktualisieren des Inhalts aktueller Log-Dateien an den Server. 
   Dabei lassen sich Aktionen festlegen, die bei Eintreffen vordefinierter
   Ereignisse ausgelst werden. Aktionen sind Meldungen, die via SMTP-
   (E-Mail) oder SYSLOG-Protokoll oder ber SMS verschickt werden.
   
   Ein Satz von server-seitigen PHP-Skripten, Style-Sheets, Vorlagen und 
   Bildern wird verwendet, um HTML- und JavaScript-Code zu erzeugen, der 
   client-seits in einem Browser interpretiert wird. Jeder moderne Browser 
   sollte dazu in der Lage sein.
   Client und Server kommunizieren mit Hilfe der AJAX-Techniken. Deshalb 
   muss der Browser die Ausfhrung von JavaScript und - im Falle von 
   Microsoft's Internet Explorer (IE) - deren AJAX ActiveX-Komponente 
   zulassen.
   
   Da die anzuzeigenden Dateien vollstndig in den Arbeitsspeicher eingelesen
   werden, ist das Tool fr kleine bis mittel-grosse Dateien, nicht aber fr
   sehr grosse Dateien geeignet. Wo die Grenze liegt, hngt hauptschlich vom
   auf dem Server verfgbaren Arbeitsspeicher ab. Um eine Idee zu geben: wenn
   wir annehmen, dass eine durchschnittliche Zeile einer Log-Datei 200 
   Zeichen umfasst, bentigt eine Datei mit 40'000 Zeilen 8 MBytes.


2. Umfang
   --------
   
   root
   +- admin                              [Verzeichnis]
      +- logviewer                       [Verzeichnis]
         +- css                          [Verzeichnis]
            +- standard.css              Style sheet, mittlere Fenstergrsse
            +- standard_large.css        Style sheet, grosse Fenstergrsse
            +- standard_small.css        Style sheet, kleine Fenstergrsse
            +- standard1.css             Wie oben, andere Browser als IE
            +- standard1_large.css       Wie oben, andere Browser als IE
            +- standard1_small.css       Wie oben, andere Browser als IE
         +- help                         [Verzeichnis]
            +- help_en.htm               Hilfeseiten, englisch
            +- help_en*.htm
            +- help_de.htm               Hilfeseiten, deutsch
            +- help_de*.htm
         +- HTML                         [Verzeichnis]
            +- Template                  [Verzeichnis], Template-Module
               +- IT.php
               +- IT_Error.php
               +- ITX.php
         +- templates                    [Verzeichnis]
            +- logviewer.htm.tpl         Vorlange fr Client-Seite
            +- *.png                     Bilder for logviewer.htm.tpl
         +- logviewer.php                LogzMon Haupt-Skript
         +- logviewer_config.inc.php     Konfigurationsdatei, Beispiel
         +- logviewer_lang_de.php        Deutsche Text-Definitionen
         +- logviewer_lang_en.php        Englische Text-Definitionen
         +- addon_smsclick.php           Add-on fr SMS-Meldungen
         +- addon_smtpmail.php           Add-on fr E-Mail-Meldungen
         +- addon_syslog.php             Add-on fr SYSLOG-Meldungen
         +- scandir.inc.php              Include-Datei fr logviewer.php (1)
         +- syslog.php                   Include-Datei fr addon_syslog.php (2)
         +- zip.lib.php                  Include-Datei fr logviewer.php (2)
         +- index.htm, index.html        Index-Datei. Redirect auf logviewer.php
         
         (1) Diese Datei wird fr PHP-Versionen < 5 bentigt.
             Wir empfehlen sie hier zu belassen.
         (2) Diese Dateien knnten bereits als PHP-Module installiert vorhanden
             sein. In diesem Fall knnen sie hier gelscht werden.
   
   
3. Installation
   ------------
   
   Das Program ist in diesen Formen verfgbar:
   - Ein ZIP-Archiv fr Windows-Plattformen,
   - Ein TAR-Archiv fr UNIX / LINUX-Plattformen,
   - Eine Installer-Datei fr Windows-Plattformen.
   
   Mit einem der ZIP- oder TAR-Archive...
   - Expandieren Sie das Archiv in ein Verzeichnis, auf das sie via Web-Server
     Zugriff haben. Falls bereits ein Verzeichnis "admin" existiert, expandie-
     ren Sie das Archiv ins bergeordnete Verzeichnis. Alle LogzMon-Dateien
     werden im Verzeichnis /admin/logviewer/ und seinen Unter-Verzeichnissen
     gespeichert.
           
   Mit dem Windows-Installer...
   - Fhren Sie das Installer-Programm aus (Doppel-Klick).
   - Befolgen Sie dessen Anweisungen und geben Sie die erfragten Parameter
     (wie beispielsweise das Ziel-Verzeichnis, in das LogzMon installiert
     werden soll) an.
     
   In beiden Fllen...
   - Editieren Sie die Konfigurationsdati 
        /admin/logviewer/logviewer_config.inc.php
     damit LogzMon Ihrer Installtion und Ihren Bedrfnissen entsprechen
     arbeitet. (Sie dazu Abschnitt 4. Konfiguration unten.)
   - Editieren Sie die Datei
        /admin/logviewer/index.htm
     um den korrekten Parameter "user_name" einzustellen.
     Dieser Parameter wird verwendet, um allfllige mehrfache Konfiguration
     in der Konfigurationsdatei zu unterscheiden.
     Die zu editierende Zeile:
        <meta HTTP-EQUIV=REFRESH CONTENT="0;
              URL=logviewer.php?mode=init&user=user_name">
     Passen Sie gegebenenfalls die Namenserweiterung dieser Datei so an, dass 
     sie dem Namen der Standard-Homepage Ihrer Web-Server-Konfiguration entspricht
     (z.B. "index.html").

   Jetzt sollten Sie LogzMon im Browser ber folgenden Link aufrufen knnen:
        http://www.yourhost.com/admin/logviewer/

   Und schliesslich editieren Sie die Addon-Dateien(*), die Sie verwenden 
   mchten:
     - "addon_smsclick.php":
       $apiid      = '1234567';   // Clickatell HTTP API id.
       $user       = 'your_user'; // Clickatell Konto Benutzername.
       $password   = 'your_pswd'; // Clickatell Konto Passwort.
       $callback   = '1';         // Rckmeldung von Clickatell erwnscht. 
                                  // 1=JA, 0=NEIN,
		                  // Falls JA mssem Sie eine Rckmeldungs-URL
		                  // fr Ihr Clickatell-Konto angegeben haben.
     - "addon_smtpmail.php":
       $smtpServer = "mail.yourdomain.com";
       $port       = "25";        // SMTP-Port, anpassen falls nicht zutreffend
       $timeout    = "30";        // Timeout, wahrscheinlich nicht anzupassen
       $username   = "your_acct"; // Ihre Mail-User-ID. Leer lassen, falls keine
       				  // SMPT-Authentisierung erwnscht.
       $password   = "your_pswd"; // Passwort fr Ihre Mail-Konto.
                                  // Nur ntig, wenn $username nicht leer.
     - "addon_syslog.php":
       $facility   = (isset($params[0]))?$params[0]:23;          // Default: local7
       $severity   = (isset($params[1]))?$params[1]:5;           // Default: notice
       $hostname   = (isset($params[2]))?$params[2]:'';
       $process    = (isset($params[3]))?$params[3]:'';
       $serverip   = (isset($params[4]))?$params[4]:'127.0.0.1'; // Default: locahost
       $serverport = (isset($params[5]))?$params[5]:514;         // Default: 514

   (*) Die entsprechenden Code-Sequenzen sind gekennzeichnet mit:
       //  COFIGURATION BEGIN ----------------------------------------
           ...
       //  COFIGURATION END ------------------------------------------
   
   
4. Konfiguration
   -------------

   Die Konfigurationsdatei ist gespeichert als "logviewer_config.inc.php". 
   Sie enthlt PHP-Code, der zur Laufzeit ausgefhrt wird. 
   Deshalb folgt die Konfigurationsdatei auch den Syntax-Regeln des PHP-
   Interpeters.

   WARNUNG:
   Die Konfigurationdatei wird zur Laufzeit in das Haupt-Skript als PHP-
   Code eingebunden. Aus diesem Grund wird der PHP-Interpreter blicherweise
   die Verarbeitung abbrechen, falls in der Konfigurationsdatei Syntax-Fehler
   erkannt werden.
   Seien Sie also sehr vorsichtig bei Editieren dieser Datei!

   Die Abschnitte der Konfigurationsdatei:
   -	Logfiles,
   -	Logdirs,
   -	Archivedirs,
   -	Filters,
   -	Filtersets,
   -	Actions, and
   -	Konstanten (defines).

   Unterschiedliche Konfigurationen knnen in der gleichen Datei kombiniert 
   werden. Dazu aktivieren Sie bitte die Anweisung 'if ($user==) {  }' und
   bergeben Sie den entsprechenden Parameter user=user_name beim ersten 
   Aufruf von LogzMon.
   Z.B.: 
   https://www.yourserver.com/admin/logviewer/logviewer.php?user=ADMINISTRATOR.


   Abschnitt Logfiles
   ------------------

   Zweck:
   Liste von Dateinamen (inkl. Pfad), die zwingend im bersichtsfenster ange-
   zeigt werden sollen.

   Syntax:
   $logfiles = array (
   	array ('full_filename','identifier'),
	array (),
	
   );

   Wobei:
   full_filename	ist der Name der anzuzeigenden Datei inkl. des voll-
                        stndigen Verzeichnis-Pfades.
                        Z.B.:
                           'F:\web\logs\syslog_catchall.txt' or
                           '/var/www/www.yourhost.com/logs/syslog_catchall.txt'
   identifiler          ist eine (fakultative) Kennung, die mit dem Datei-Namen
                        zusammen angezeigt wird. Dies kann hilfreich sein, wenn
                        gleichnamige Dateien aus unterschiedlichen Verzeich-
                        nissen einbezogen werden sollen.
   
   Beachte: bitte stellen Sie sicher, dass der Benutzer-Account, unter dem der
            Web-Server luft (Lese-) Berechtigung fr die hier konfigurierten
            Dateien hat.


   Abschnitt LogDirs
   -----------------

   Zweck:
   Liste von Verzeichnissen, deren Dateien als (aktuelle) Log-Dateien im 
   bersichts-Fenster angezeigt werden sollen. Nur Dateien mit einer Endung, 
   die der Konstante 'logext' entspricht, werden dabei bercksichtigt.

   Syntax:
   $logdirs = array (
	array ('directory_name','identifier'),
	array (..),
	
   );

   Wobei:
   directory_name       is the Verzeichnis-Pfad der einzubeziehenden Dateien. 
                        Z.B.:
                          'F:\web\www.yourhost.com\logs' or
                          '/var/www/www.yourhost.com/logs'
                        Bitte kein abschliessendes Slash- oder Back-Slash-
                        Zeichen angeben.
   identifiler          ist eine (fakultative) Kennung, die mit dem Datei-Namen
                        zusammen angezeigt wird. Dies kann hilfreich sein, wenn
                        gleichnamige Dateien aus unterschiedlichen Verzeich-
                        nissen einbezogen werden sollen.

   Beachte: bitte stellen Sie sicher, dass der Benutzer-Account, unter dem der
            Web-Server luft (Lese-) Berechtigung fr die hier konfigurierten
            Verzeichnisse und darin enthaltenen Dateien hat.


   Abschnitt ArchiveDirs
   ---------------------
   
   Zweck:
   Liste von Verzeichnissen, deren Dateien als Archiv-Dateien im bersichts-
   Fenster angezeigt werden sollen. Nur Dateien mit einer Endung, die der 
   Konstante 'arcext' entspricht, werden dabei bercksichtigt.

   Syntax:
   $archivedirs = array (
   	array ('directory_name','identifier'),
   	array (),
   	
   );

   Wobei:
   directory_name       is the Verzeichnis-Pfad der einzubeziehenden Dateien. 
                        Z.B.:
                           'F:\web\www.yourhost.com\logs\archive' or
                           '/var/www/www.yourhost.com/logs/archive'
                        Bitte kein abschliessendes Slash- oder Back-Slash-
                        Zeichen angeben.
   identifiler          ist eine (fakultative) Kennung, die mit dem Datei-Namen
                        zusammen angezeigt wird. Dies kann hilfreich sein, wenn
                        gleichnamige Dateien aus unterschiedlichen Verzeich-
                        nissen einbezogen werden sollen.

   Beachte: bitte stellen Sie sicher, dass der Benutzer-Account, unter dem der
            Web-Server luft (Lese-) Berechtigung fr die hier konfigurierten
            Verzeichnisse und darin enthaltenen Dateien hat.


   Abschnitt Filters
   -----------------
   
   Zweck:
   Filter werden auf jede Zeile einer Datei angewendet, um
   - Hervorhebungen und
   - Aktionen, die im Modus Auto-Aktualisieren auszufhren sind,
   zu bestimmen.
   Filter werden angewendet, wenn kein Filterset anwendbar ist.

   Syntax:
   $filters = array (
   	array ('filter_regex','foreground','background','actions'),
   	array (),
   	
   );

   Wobei:
   filter_regex         ist das Filter-Muster als regulrer Ausdruck (Regex)
                        ausgedrckt. Die Parameter 'foreground' und 
                        'background' werden gewrdigt, wenn das Filter-Muster
                        im Zeilen-Inhalt gefunden wird.
                        Unix-/ Linux-Benutzer kennen blicherweise die Regeln 
                        nach denen ein regulrer Ausdruck gebildet wird. 
                        Zustzliche Informationen dazu sind hier zu finden:
                        -  http://www.regular-expressions.info
                        -  http://www.amk.ca/python/howto/regex/.
                        -  http://de.wikipedia.org/wiki/Regulrer_Ausdruck
                        Meta-Zeichen mssen durch einen Back-Slash (\) 
                        eingeleitet werden, damit sie buchstblich verwendet 
                        werden.
			Die Meta-Zeichen sind: ^ $ * + ? {} [ ] \ | ( )
			Mehrere Muster knnen durch das Pipe-Zeichen (|) 
			aneinander gefgt werden.
   foreground           Einer dieser drei Werte:
                         Der RGB-Code der Vordergrund-Farbe, 
                         Das Schlsselwort hide, oder 
                         Ein leerer String (= keine Hervorhebung).
                        Ist der Parameter foreground = hide, werden Zeilen, bei
                        denen 'filter_regex' zutrifft, nicht angezeigt. Sonst 
                        werden solche Zeilen in der entsprechenden Vordergrund-
                        Farbe angezeigt.
                        Das Format des RGB-Codes ist: #rrggbb, wobei
                         rr = ROT-Anteil, hexadezimal (00..FF),
                         gg = GRN-Anteil, hexadezimal (00..FF),
                         bb = BLAU-Anteil, hexadezimal (00..FF).
   background           Einer dieser beiden Werte:
                         Der RGB-Code der Hintergrund-Farbe,
                         Ein leerer String (= keine Hervorhebung).
   actions              Der Name einer oder mehrerer Aktion(en), die im Modus 
                        'Auto-Aktualisierung' auszufhren sind. Mehrere Namen 
                        knnen, durch das Pipe-Zeichen (|) getrennt, aneinander
                        gefgt werden.


   Abschnitt Filtersets
   --------------------

   Zweck:
   Filter werden auf jede Zeile einer Datei angewendet, um 
   - Hervorhebungen und
   - Aktionen, die im Modus Auto-Aktualisieren auszufhren sind,
   zu bestimmen.
   Die Filter eines Filterset werden auf die Zeilen derjenigen Dateien angewen-
   det, auf deren Namen das Muster filterset_regex zutrifft. Nur das erste 
   zutreffende Filterset wird angewendet.

   Syntax:
   $filterset = array (
      array ('filterset_regex',
         array ('filter_regex','foreground','background','actions'),
         array (),
      ),
      array ('filterset_regex',
         array ('filter_regex','foreground','background','actions'),
         array (),
      ),
   );

   Wobei:
   filterset_regex	ist das Filter-Muster, als regulrer Ausdruck (Regex) 
                        ausgedrckt, das fr die Selektion der Dateien verwen-
                        det wird, auf die die Filter-Regeln anzuwenden sind.
                        Meta-Zeichen mssen durch einen Back-Slash (\) einge-
                        leitet werden, damit sie buchstblich verwendet werden.
                        Die Meta-Zeichen: ^ $ * + ? {} [ ] \ | ( )
                        Mehrere Muster knnen durch das Pipe-Zeichen (|) an-
                        einander gefgt werden.
                        Anstelle eines Musters kann auch der Name einer defi-
                        nierten Konstante, die als Wert das Muster enthlt, 
                        angegeben werden.
   filter_regex         Filter-Regel wie oben beschrieben, siehe 'Filters'.
   actions              Der Name einer oder mehrerer Aktion(en), die im Modus 
                        'Auto-Aktualisierung' auszufhren sind. Mehrere Namen 
                        knnen, durch das Pipe-Zeichen (|) getrennt, aneinander
                        gefgt werden.


   Abschnitt Actions
   -----------------
   
   Zweck:
   Aktionen werden ausgefhrt, wenn der Modus Auto-Aktualisieren EIN ist und 
   das entsprechende Muster filter_regex (siehe Filters and Filtersets) mit dem
   Inhalt einer Datei-Zeile bereinstimmt.
   Eine Aktion sendet eine Meldung an unterschiedliche Adressaten entsprechend 
   einem dieser drei Aktions-Typen:
   - SYSLOG:   Sendet eine Meldung an einen Syslog-Daemon im Intranet oder 
               Internet.
   - SMTPMAIL: Sendet eine Meldung an eine e-Mail-Box ber einen SMTP-Server,
   - SMSCLICK: Sendet eine Kurzmeldung (SMS) an ein Mobil-Telefon ber den SMS-
               Dienst von Clickatell. (Hinweis: Sie mssen bei Clickatell 
               (http://www.clickatell.com) ein Konto eingerichtet und eine HTTP 
               API-Nummer beantragt haben, um diesen Dienst zu nutzen).
   
   Aktions-Typen sind als einfache Add-on-Module implementiert und lassen sich 
   dadurch recht einfach erweitern.

   Syntax:
   $actions = array (
      array ('action_name','action_type',
         'action_parameters',
         'message_regex,
         'message_text
      ),
      Array(),
   );

   Wobei:
   action_name          ist der Name Ihrer Wahl der Aktion. Er wird in Filter-
                        Definitionen als Verweis verwendet.
   action_type          ist einer der drei Typen SYSLOG, SMTPMAIL oder SMSCLICK
                        wie oben beschrieben.
                        Ein dem action_type entsprechendes Add-on-Modul nach 
                        dem Namens-Muster addon_{action_type}.php wird er-
                        wartet.
   action_parameters    sind Parameter zuhanden der verschiedenen Add-on-Module 
                        und sind deshalb jeweils je action_type unterschied-
                        lich. Sie werden immer mittels des Pipe-Zeichens (|) 
                        aneinander gereiht.

      SYSLOG:           Format:
                        'facility|level|host|process|daemon_ip|daemon_port'
         facility:      Facility code. Z.B. 23 (= local 7).
         level:         Log level. Z.B.: 5 (= notice).
         host:          Host-Name oder IP-Adresse.
         process:       Prozess-Name.
         daemon_ip:     IP-Addresse des empfangenden Syslog-Daemon.
         Daemon_port:   Port-Nummer des empfangenden Syslog-Daemon.
         (Als Protokoll wird immer UDP verwendet.)

         
         Facilities:    Facility-Name   Alternativer Name Wert
                        --------------- ----------------- ------------
                        Kernel 	Kern                        0
                        User                                1 
                        Mail                                2 
                        Daemon                              3 
                        Auth                                4 
                        Syslog                              5 
                        Lpr                                 6 
                        News                                7 
                        UUCP                                8 
                        Cron                                9 
                        System0         Security           10 
                        System1         FTP                11 
                        System2         NTP                12 
                        System3         Logaudit           13 
                        System4         Logalert           14 
                        System5         Clock              15 
                        Local0                             16 
                        Local1                             17 
                        Local2                             18 
                        Local3                             19 
                        Local4                             20 
                        Local5                             21 
                        Local6                             22 
                        Local7                             23 
         
         Levels         Level-Name      Alternativer Name Wert
                        --------------- ----------------- ------------         
                        Emergency       Emerg               0 
                        Alert                               1 
                        Critical        Crit                2 
                        Error           Err                 3 
                        Warning         Warn                4 
                        Notice                              5 
                        Information     Info                6 
                        Debug                               7 

      SMTPMAIL:         Format:
                        'from_name|from_address|to_name|to_address|subject'
         from_name:     Name des Absenders im Klartext.
                        Z.B. 'Log Monitor'.
	 from_address:  Mailbox-Adresse des Absenders.
                        Z.B.: logzmon@yourhost.com
	 to_name:       Name des Empfngers im Klartext.
	 to_address:    Mailbox-Adresse des Empfngers.
	 subject:       Betreffzeile der e-Mail.
                        Z.B.: [LogzMon] Warnung


      SMSCLICK:         Format:
                        'sender|recipient'
	 sender:        Absender-Kennung.
                        Z.B. 'LogzMon Ihrhost.com'.
	 recipient:     Mobil-Telefon-Nummer des Empfngers.
                        Z.B.: +491079999999.
      message_regex:    Regex-pattern to match the line string.
                        ZB.: 
                        '\A([\d]{1,3}\.[\d]{1,3}\.[\d]{1,3}\.[\d]{1,3}) (.*) 
                           401 401'
                        wrde mit einer IP-Adresse, gefolgt von beliebigem 
                        Text und den Return-Codes 401 401, bereinstimmen. 
                        Zwei Text-Partikel, $1 und $2 (festgelegt durch die 
                        beiden Ausdrcke in Klammern), knnen anschliessend 
                        referenziert werden, wobei $1 fr die IP-Adresse und $2
                        fr den Text zwischen der IP-Adresse und den Return-
                        Codes steht.
			Falls keine Text-Partikel referenziert werden sollen, 
			verwenden Sie als Regex-Muster am besten '.*', was 
			'beliebigen Text' bedeutet.
			Meta-Zeichen mssen durch einen Back-Slash (\) 
			eingeleitet werde, damit sie buchstblich verwendet 
			werden.
			Die Meta-Zeichen: ^ $ * + ? {} [ ] \ | ( )
			Mehrere Muster knnen durch das Pipe-Zeichen (|) 
			aneinander gefgt werden.
			Anstelle eines Musters kann auch der Name einer 
			definierten Konstante, die als Wert das Muster enthlt,
			angegeben werden.
      message_text:     Meldungstext. Kann optional Referenzen auf Text-
                        Partikel (wie $1,$2$n) des Regex-Musters, wie oben 
                        beschrieben, enthalten.
                        Z.B.:
                        'Zugriffsversuch auf geschtzten Bereich von 
                            IP=$1.\n\n$line'
                        Hinweis: 
                        Diese Standard Text-Partikel stehen jeweils ebenfalls
                        zur Verfgung:
                          - $0:    Der gesamte String, der mit dem Suchmuster 
                                   bereinstimmt,
                          - $line: Der gesamte Zeilen-Inhalt,
                          - $file: Der Name der aktuellen Datei.

   Abschnitt Defines
   -----------------

   Zweck:
   Konstanten festlegen.
   Praktisch alle der unten aufgefhrten Konstanten sind obligatorisch; die 
   Werte sind whlbar.

   Syntax:
   Define ('constant_name', 'constant_value');

   Wobei:
   'constant_name' einer der folgenden ist:
      logext            Namenserweiterung(en) der (aktuellen) Log-Dateien, 
                        begrenzt durch Unterstriche (_).
                        Sollen Dateien ohne Erweiterungen einbezogen werden,
                        kann dies durch zwei Unterstriche(__) angegeben werden.
                        Verwendet zusammen mit den Definitionen des Abschnitts 
                        'Logdirs'.
                        Z.B.: define('logext', '_log_lg_');
                        Obligatorisch.
      arcext            Namenserweiterung(en) der Archiv-Dateien, begrenzt 
                        durch Unterstriche (_).
                        Sollen Dateien ohne Erweiterungen einbezogen werden, 
                        kann dies durch zwei Unterstriche(__) angegeben werden.
                        Verwendet zusammen mit den Definitionen des Abschnitts 
                        'Archivedirs'.
                        Z.B.: define('arcext', '_gz_'); 
                        Obligatorisch.
      language          Sprachcode (2-stellig).
                        Momentan gltig sind: 'en'=English, 'de'=Deutsch
                        Obligatorisch.
      refresh_interval_seconds
                        Im Modus Auto-Aktualisierung das Intervall in 
                        Sekunden zwischen zwei Aktualisierungen. 
                        (Z.B. 720 = 12 Minuten). 
			Obligatorisch.
      refresh_test_milliseonds
                        Im Modus Auto-Aktualisierung das Intervall in Milli-
                        sekunden zwischen zwei Prfungen, ob eine Aktualisier-
                        ung ntig ist. 
                        (Z.B. 30000 = 1/2 Minute).
			Obligatorisch.
      size              Bevorzugte (Client-) Fenstergrsse.
			Mgliche Werte sind: small, medium=standard, large
			Der Benutzer kann diese Fenstergrssen im Browser 
			abweichend von diesem Wert whlen. 
			Obligatorisch.
      host_name         Name des Host, den Sie mit LogzMon berwachen.
			Obligatorisch.
      host_name_url     Hyperlink zur Web-Site des Host, der verwendet wird,
                        wenn der Benutzer den Hostnamen anklickt.
			Obligatorisch.
      SuppressIpLookups Wenn eine Zeile einer Log-Datei eine IP-Adresse 
                        enthlt, wird diese mit einem Hyperlink zum Nach-
                        schlagen versehen. Dies kann dadurch unterdrckt 
                        werden, dass dieser Konstanten der Wert true (ohne 
                        Hochapostrophes) zugewiesen wird.
			Obligatorisch.
      SuppressHttpLookups
                        Wenn eine Zeile einen (aufgelsten) Hostnamen enthlt, 
                        wird dieser mit einem Hyperlink zum Nachschlagen 
                        versehen. Dies kann dadurch unterdrckt werden, dass 
                        dieser Konstanten der Wert true (ohne Hochapostrophes) 
                        zugewiesen wird.
			Obligatorisch.
      any other         Zur Verwendung mit z.B. filter-, filtersets- 
                        Definitionen, oder beliebigen anderen Konfigurations-
                        Definitionen nach Ihrer Wahl. Achten Sie darauf, dass 
                        Sie Referenzen auf solche Konstanten immer ohne 
                        Hochapostrophes angeben
			Fakultativ.


5. Security
   --------
   
   Vielleicht verwenden Sie Ihren Web-Server fr die Verarbeitung vertraulicher
   Transaktionen und vertraulicher Daten. Bitte denken Sie daran, dass die
   in den Log-Dateien enthaltenen Daten ebenfalls vertraulichen Charakter
   haben und dass diese Daten mit LogzMon gegebenenfalls ber das ffentliche 
   Internet transportiert werden.

   Zum Schutz Ihrer Log-Daten knnen Sie eine oder mehrere der folgenden
   Massnahmen ergreifen:
   
   - Bentzen Sie das HTTP-ber-SSL (https) Protokoll.
     Installieren Sie LogzMon in einem Pfad, auf den Sie ber den Web-Browser
     mittels HTTPS zugreifen knnen und erzwingen Sie dieses Protokoll wenn
     mglich. Dadurch werden alle Daten zwischen den Client und dem Server
     verschlsselt ausgetauscht und sind damit fr wertlos fr jemanden, der
     die Verbindung belauscht.

   - Erzwingen Sie Benutzer-Authentisierung.
     Schtzen Sie den Pfad, in dem LogzMon installiert ist mit mindestens
     Basic (User-ID und Passwort) Benutzer-Authentisierung. Wenn mglich,
     wenden Sie starke Authentisierung (user-ID, Passwort, Zertifikat oder
     Einmal-Passwort / TAN, usw.).
     
   - Schrnken Sie den Zugang zu LogzMon auf einen Bereich vertrauenswrdiger
     IP-Adressen (z.B. Ihr Intranet) ein.
     Sie knnen den Zugriff mittels des .htaccess-Mechanismus oder durch
     die Web-Server-Konfiuguration einschrnken. Wenn mglich konfigurieren Sie
     einen virtuellen Administrations-Server, den Sie strker schtzen knnen,
     als Sie dies vielleicht bei einem ffentlichen Server tun mchten.

     
6. Rechtliches
   -----------
   
     LogzMon 1.4, Log Viewer und Monitor
     Copyright (C) 2007 methodica, Hans E. Herger
   
     Dieses Programm ist freie Software: Sie knnen es unverndert und / oder
     verndert weiter verbreiten unter den Bedingungen der "GNU General Public 
     License", Version 3, wie sie durch die "Free Software Foundation" publi-
     ziert worden ist. Es gilt die englisch-sprachige Ausgabe.
   
     Dieses Programm wird in der Hoffnung ausgeliefert, dass es Ihnen ntzen
     wird, jedoch OHNE JEGLICHE GARANTIE -  auch ohne die implizite Garantie 
     der VERMARKTBARKEIT oder der EIGNUNG FR EINEN BESTIMMTEN ANWENDUNGSZWECK.
     Der Autor kann UNTER KEINEN UMSTNDEN FR IRGENDWELCHE FOLGEN AUS DER
     ANWENDUNG DES PROGRAMMES HAFTBAR GEMACHT WERDEN. WENN EIN SOLCHER 
     ABSOLUTER AUSSCHLUSS JEGLICHER PRODUKTE-HAFTUNG DEN GESETZEN WIDERSPRICHT,
     WO SIE DAS PROGRAMM EINZUSETZEN BEABSICHTIGEN, IST DER GEBRAUCH DES 
     PROGRAMMES VERBOTEN.
     
     Fr Details siehe die "GNU General Public License".
     
     Sie sollten zusammen mit dem Programm eine Kopie der "GNU General Public 
     License" erhalten haben. Andernfalls siehe <http://www.gnu.org/licenses/>.

