


                            JaBaSE 1.5 final release




               CopyRight 1997 Axel Irriger <Silvan@Technologist.com>



1. Einfhrung

        Erstmal vielen Dank fuer die Benutzung von JaBaSE.
        Ich hab es bei diesem Server darauf angelegt, dass er mglichst
        klein ist und wenig Ressourcen verbraucht.
        Ich hoffe, da es mir geglueckt ist, dieses Ziel zu erreichen.

        Fuer Anregungen aller Art, die den Server betreffen, bin ich jeder-
        zeit zu erreichen ;-)
        Mein naechstes Projekt wird ein Offline-Browser sein.
        Das heisst aber nicht, dass ich Entwicklung an JaBaSE nicht fortge-
        fuehrt wird. Aber dazu benoetige ich Hilfe. Ich kann schliesslich
        nicht wissen, was als Erweiterung gewuenscht wird.
        Wer daher Anregungen fuer zukuenfitge Versionen hat, soll sich mit einer
        Beschreibung des Vorschlages bei mir unter "Silvan@Technologist.com"
        melden. Er/Sie erhaelt dann Rueckmeldungen ob so etwas realisierbar ist.

2. Installation

        Um JaBaSE zu installieren ist nicht viel noetig. Man entpackt das Archiv
        in ein Verzeichnis der Wahl.
        Anschliessend muss man den Server konfigurieren.
        Ich habe zwar versucht, die benoetigten Informationen zu einfach wie
        moeglich zu gestalten, aber trotzdem hier einige Erlaeuterungen.

3. erstmalige Konfiguration

        Das Konfigurationsprogramm heisst "SetConfig.class". Diese ruft man mit
        dem Java-Interpreter auf. Bei mir heisst die Zeile demnach "java SetConfig"
        Nun werden einige Werte abgefragt:

        "Please enter WWW-Port : "                      Hierbei wird der Port
                                                        erwartet, auf dem der Server
                                                        initialisiert werden soll.
                                                        Im Normalfall sollte man hier
                                                        "80" eintragen.
                                                        Wenn man den Server in einem IntraNet
                                                        betreibt und auf "80" der "normale"
                                                        InterNet Zugriff ablaeuft, kann man
                                                        den Server auf einem Port der Wahl
                                                        initialisieren.

        "Please enter WWW-root-Directory : "            Hier wird ein Verzeichnisname
                                                        erwartet. In diesem Verzeichnis
                                                        sucht der Server dann nach den
                                                        geforderten Dateien.
                                                        Befindet sich das Verzeichnis im
                                                        selben Verzeichnis wie der Server
                                                        reicht die Angabe des Verzeichnisses.
                                                        Ist der Server im Verzeichnis
                                                        "d:\Server\" installiert und die HTML-
                                                        Dateien liegen in "d:\Server\files\"
 							so genuegt es "files" als Verzeichnis
							anzugeben.
                                                        Liegen die Dateien aber in
 							"d:\HTTPFiles\" so muss auch
  						        "d:\HTTPFiles" angeben. Dem
							Verzeichnisnamen oder Pfad darf kein
							"\" folgen.

        "Please enter WWW-standard-file : "             Der Server sendet immer eine
                                                        Datei, wenn vom Client keine Datei
                                                        angegeben wurde. Wenn man z.B.
                                                        in Netscape tippt
							"http://www.myServer.com/myFile.htm"
                                                        so fordert der Client die Datei
							"myFile.htm" an.
                                                        Gibt man aber
							"http://www.myServer.com/" an, so wird
                                                        keine Datei angefordert. In diesem
							Falle gibt es ein Standard-File, was
							vom Server geschickt wird.
                                                        Dieses File lautet meistens
							"index.htm" oder "index.html".
                                                        Hier kann man aber auch eine Datei der
							Wahl angeben...

        "Please enter the complete path to the perl-interpreter
        with file name! : "
                                                        Diese Angabe ist fuer die Verarbeitung
                                                        von Perl-CGI-Scripten notwendig.
                                                        Ist der Perl-Interpreter nicht ueber
							Eingabe von "perl" zu erreichen, muss
							man hier den gesamten Pfad angeben, in
							dem sich der Interpreter befindet.
                                                        Ansonsten nur den Dateinamen...

        "Please enter relative CGI-directory : "        Befinden sich die HTML-Dateien
                                                        im Verzeichnis "d:\HTMLFiles", so ist
							es zwingend erforderlich, dass die CGI-
							Programme in einem Unterordner dieses
							Verzeichnisses liegen.
                                                        Diesen muss man hier angeben.
							Normalerweise lautet das Verzeichnis
							"cgi-bin" (ohne Slash). Es kann aber
                                                        auch anders lauten....ist alles dem
							Benutzer ueberlassen ;)
	"Should be Error-Window be merged to the Main-
	Window [true, false] : "
							Hier muss man entweder "true" oder
							"false"	eingeben. Bei "true" werden
							eventuell auftretende Fehlermeldungen
							in das Haupt-Fenster des Servers um-
							geleitet.
							Mchte man sich die Fehlermeldungen
							aber lieber separat ansehen, sollte
							man "false" eingeben.
							Daduch wird ein extra Fenster ge-
							ffnet, in dem *ausschliesslich*
							Fehlermeldungen angezeigt werden.

        Nach Eingabe dieser kleinen Dinge wird die Datei "server.cfg" geschrieben.
        Diese ist ein ganz normales Text-File. Man kann die Datei auch aendern, ohne
        immer "java SetConfig" aufzurufen.

4. Der Start

        Wenn man die "erstmalige Konfiguration" durchgefuehrt hat, kann man den Server
        starten.
        Dieses macht man durch Eingabe von "java Server". Das Hauptprogramm lautet
        "Server.class".
        Nun wird der Server initialisiert. Wenn alles geklappt hat, sieht man im
        Statusfenster des Servers die Zeile "Server init successful" und die
        nochmalige Ausgabe des WWW-Portes, des WWW-Home-Directories und der Angabe wohin die
	Fehlermeldungen geleitet werden.
        Nun wartet der Server auf Anfragen....
        Im Fenster "JaBaSE - Errors" werden etwaige Fehlermeldungen ausgegeben, sofern dies
	bei der Konfiguration angegeben wurde...

        Alle anderen Fehlermeldungen sollten ernst genommen werden.
        Bei Problemen mit der Interpretation kann sich selbstverstaendlich
        jederzeit mit mir in Verbindung setzen. Darum wuerde ich sogar sehr bitten,
        da nur durch die Ruecksprache mit den Benutzern eine effektive Software-
        Pflege ermoeglicht werden kann.

5. Online Konfiguration
	
	Wesentliche, konfigurationsrelevante, Einstellungen kann man auch waehrend des
	Betriebs des Servers aendern. Aendern kann man :
		Das WWW-root-Directory
		das Standard-Send-File
		das relative CGI-Directory sowie
		die Angabe, wohin etwaige Fehlermeldungen gesandt werden.
	Den Menpunkt findet man unter "Administration" und lautet "Online configuration".
	Dort kann man dann durch Aenderung der aktuellen Werte neue Einstellungen festlegen.
	Mit "Apply changes" werden die neuen Werte gesetzt. Die geaenderten Werte sieht man 
	nochmal im Hauptfenster des Servers.
	Mit "Reset Values" kann man Fehleingaben korrigieren, wobei *alle* Werte auf die
	aktuellen gesetzt werden (die vor der Aenderung).
	Mit "Discard changes" teilt man dem Server mit, dass man die Konfiguration nun doch
	nicht aendern moechte. Das Fenster wird geschlossen, ohne die Werte zu aendern.
	
6. Zugriffsstatistiken

	Im Men "Administration" findet man auch den Punkt "Access statistics". Waehlt man
	diesen Punkt an, so wird ein Fenster geoeffnet, in dem alle bisher angeforderten
	Dateien, relativ zum WWW-root-directory, angezeigt werden. Die Zahlen daneben geben
	an, wie oft die Datei angefordert wurde.

7. Den Server beenden

	Der letzte Punkt im "Administration" Menue ist der Punkt "Shutdown server". Dadurch
	wird der Server beendet und alle laufenden Verbindungen beendet.


	Ich hoffe, diese Dokumentation war nicht zu lang und es wurde alles verstanden.
	Falls das nicht der Fall sein sollte, bitte bei mir melden und ich werde das
	Gewuenschte hinzufuegen oder umformulieren ;))


                                   1997 Axel Irriger <Silvan@Technologist.com>
