Der
Ebus-2T-Server
Der
Ebus-2T-Server wird für den Ablauf von Programmen benötigt, die im 2-Schichten-Modell
erstellt wurden (2-Tier-Programme, 2-Tier-Applets).
Das
2-Schichten-Modell (2-Tier)
Das
2-Schichten-Modell ist ein Client-Server-Modell, bei dem der Client nur für die
Bildschirmanzeige und der Server für die Programmverarbeitung zuständig ist.
Client- und Serverprogramm laufen i.a. auf verschiedenen Rechnern im Netzwerk
oder über das Internet. Auch DFÜ-Verbindungen sind möglich.
Bei
der Generierung eines Java-2T-Programmes oder eines Java-2T-Applets werden zwei
Programme erzeugt:
1. Das Client-Programm <Programmname>_Client
.java bzw. <Programmname>_Applet.java
2. Das
Server-Programm <Programmname>_2T.java bzw. <Programmname>_2T_Applet.java
Die
Server-Programme <Programmname>_2T.jar und
<Programmname>_2T_Applet.jar benötigen zur Ausführung den Ebus-2T-Server.
Dieser lädt das Programm und führt es aus, wenn der zugehörige Client sich beim
Ebus-2T-Server anmeldet.
Das
2-Schichten-Modell bietet folgende Vorteile:
|
1. |
Alle
Makros von allen ausgeführten Programmen werden zentral auf einem Rechner
ausgeführt. Wenn sich die Indexdateien auch auf diesem Rechner befinden,
erfolgt keine Übertragung von Dateidaten über das Netzwerk, da der
Ebus-2T-Server für alle Clients den Zugriff auf die Daten übernimmt. Und aus
der Sicht des Ebus-2T-Servers sind die Daten lokal. Der Ebus-2T-Server kann
auf jedem beliebigen Rechner im Netz laufen, es muss kein spezieller Server
sein. |
|
2. |
Der
Client ist ein eigenständiges Programm, das nur für den Bildschirmaufbau zuständig
ist. Es kommuniziert dazu mit dem Serverprogramm. Das Serverprogramm teilt
dem Client mit, welche Windows geöffnet oder geschlossen werden sollen und
welche Felder angezeigt werden sollen. Den Aufbau der Masken wird vom Client
durchgeführt, der Server übergibt lediglich die notwendigen Daten (z.B. den
Text für die Beschriftung der Buttons). Aufgrund dieser Technik werden nur
geringe Datenmengen zwischen Client und Server übertragen. Dies ist auch der
Grund dafür, dass auch bei DFÜ-Verbindungen in der Programmverarbeitung
annähernd dieselbe Geschwindigkeit erreicht wird wie auf einem lokalen
Rechner. |
|
3. |
Datenschutz:
Auf die Indexdateidaten muss nur der Ebus-2T-Server zugreifen, für alle
anderen Rechner im Netz kann der Zugriff auf die Indexdateien gesperrt
werden. |
|
4. |
Vielfältige
Verbindungsmöglichkeiten: Zum Ebus-2T-Server kann über das Netzwerk, über
eine DFÜ-Verbindung oder über das Internet eine Vebindung aufgebaut werden. |
Der
Ebus_2T_Server wird mit folgendem Kommando gestartet:
run_Ebus_2T_Server
<Verzeichnis>
<Servername>[:<Port>]
[quiet]
<Verzeichnis> ist das Arbeitsverzeichnis des
Ebus_2T_Servers.
<Servername> ist der Name oder die
IP-Adresse des Rechners, auf dem der Ebus_2T_Server gestartet wird.
quiet kann optional angegeben
werden. Der Ebus_2T_Server läuft dann ohne Dialogoberfläche.
<Port> legt fest, an welchem Port
der Ebus-2T-Server läuft. Wird kein <Port> angegeben, gilt der
Standardport 1099.

Button
"Server beenden": Der Ebus-2T-Server wird beendet. Sind noch Programme
mit dem Ebus-2T-Server verbunden, so erfolgt eine Abfrage, ob die noch
laufenden Programme beendet werden sollen.
Button
"Einstellungen":

|
|
Dateien exklusiv öffnen: Ist diese Checkbox
gesetzt, so werden vom Ebus-2T-Server alle Indexdateien exklusiv geöffnet.
Die Dateizugriffe laufen dann erheblich schneller ab, da kein Recordlocking
notwendig ist. Ist diese Checkbox nicht gesetzt, so können neben dem
Ebus-2T-Server auch andere Programme auf die Indexdateien zugreifen. Client-Timeout: Damit wird festgelegt,
nach wie viel Minuten eine Clientverbindung getrennt wird, wenn ein Client
innerhalb der angegebenen Zeitspanne kein Lebenszeichen mehr gesendet hat. Server-Restart-Timeout: Unter Windows gibt es
manchmal Memoryprobleme, wenn der Ebus-2T-Server über einen längeren Zeitraum
ohne Unterbrechung läuft. Windows gibt das nicht mehr benötigte Memory nicht
immer frei, was irgendwann dazu führt, dass der Rechner nur noch mit Swapping
- dem Aus- und Einlagern der Hauptspeicherseiten – beschäftigt ist. Wird ein Server-Restart-Timeout
(z.B. 30 Minuten) angegeben, so bewirkt dies folgendes: Wenn 30 Minuten lang
kein User am Ebus-2T-Server angemeldet ist, startet sich der Ebus-2T-Server
neu. Dazu muss unter Restart-Kommando der Befehl, mit dem der
Ebus-2T-Server gestartet wurde, mit vollständiger Pfadangabe angegeben
werden, z.B. C:\Server\run_server.bat
D:\Daten Server1 Nach einem Restart erfolgt der nächste Restart
erst dann, wenn wieder wenigstens einmal ein User angemeldet war und nach dem
Abmelden des letzten Users die angegebene Zeitspanne vergangen ist. |
Button
"Sprache": Die Sprache kann festgelegt werden. Möglich sind Deutsch und Englisch.

Button
"Passwort": Es kann ein Passwort festgelegt werden, das angegeben werden muss,
wenn der Ebus-2T-Server beendet werden soll. Wird ein Passwort festgelegt, so
kann der Ebus-2T-Server nicht beendet werden, wenn das richtige Passwort nicht
angegeben wird. Das Passwort gilt nur für den aktuellen Programmlauf. Nach
einem Neustart des Ebus-2T-Servers muss das Passwort erneut festgelegt werden.

Button
"User": Es werden die Programme angezeigt, die aktuell mit dem Ebus-2T-Server
verbunden sind. Für jedes laufende Programm werden folgende Daten angezeigt:
Laufende
Nummer Rechnername Username
Programmname
Button
"Log-Datei": In der Log-Datei wird protokolliert, wann der Ebus-2T-Server gestartet
oder beendet wurde. Zusätzlich werden alle Laufzeitfehler protokolliert.
Button
"Logon-Protokoll": Im
Logon-Protokoll wird protokolliert, wann der Ebus-2T-Server gestartet
oder beendet wurde und wann sich User an- bzw. abgemeldet haben.
Button
"Memory": Die aktuelle Speicherbelegung wird angezeigt:
total
memory
zeigt die Größe des aktuell vom Ebus-2T-Server verwendeten Speichers an.
free
memory
zeigt an, wie viel Speicherplatz von total memory nicht verwendet wird.
max
memory
zeigt an, wie viel Speicherplatz der Ebus-2T-Server maximal verwenden darf.

2T-Applets
werden über eine Html-Datei oder eine php-Datei gestartet (siehe Applet).
2T-Client-Programme
werden über die Kommandoprozedur
run_<Programmname>_client.bat <Serveradresse> <Clientadresse> (Windows)
bzw.
run_<Programmname>_client.sh <Serveradresse>
<Clientadresse> (Unix/Linux).
gestartet.
<Serveradresse> ist der Name oder die
IP-Adresse des Rechners, auf dem der Ebus-2T-Server läuft.
Wenn
der Ebus-2T-Server nicht am Standardport 1099 läuft, muss bei der
<Serveradresse> der Port des Ebus-2T-Servers angeben werden.
Beispiel:
run_Prog1_Client Server1:2001
Zusätzlich
kann in eckigen Klammern [:<Port>] der Port angegeben werden, über den
die Verbindung zum Ebus-2T-Server aufgebaut werden soll. Wird kein Port
angegeben, wird ein zufälliger freier Port verwendet. Achtung: Vor der
eckigen Klammer [ darf kein Leerzeichen stehen.
Beispiel:
run_Prog1_Client Server1:2001[:5000]
Der
Server läuft am Port 2001 und für die Verbindung wird Port 5000 verwendet.
Beispiel:
run_Prog1_Client Server1[:7500]
Der
Server läuft am Standardport 1099 und für die Verbindung wird Port7500
verwendet.
<Clientadresse> ist der Name oder die IP-Adresse
des Clientrechners. Dieser Parameter kann fehlen, er muss normalerweise nur
angegeben werden, wenn der Zugriff auf den Ebus-2T-Server über das Internet
erfolgt.
Der
Ebus-2T-Server prüft alle 20 Sekunden, ob die Datei ebus_server_stop.dat
im aktuellen Verzeichnis des Ebus-2T-Servers existiert. Falls ja, wird der
Ebus-2T-Server beendet, falls keine User mehr angemeldet sind.
Enthält
die erste Zeile der Datei ebus_server_stop.dat eine 1, so wird der Ebus-2T-Server
auch dann beendet, wenn User angemeldet sind.
Über
die Datei ebus_server_stop.dat kann der Ebus-2T-Server auch dann
definiert beendet werden, wenn er mit quiet gestartet wurde.
Beim
Starten des Ebus-2T-Servers wird die Datei ebus_server_stop.dat jeweils
gelöscht, falls sie existiert.
Ebus_2T_Server_Service.bat
installiert den Ebus-2T-Server als Dienst unter Windows.
Der
Aufruf erfolgt wie beim Start des Ebus-2T-Servers über einen Kommandozeilenaufruf
mit den Parametern <Verzeichnis>
und <Servername>:
Ebus_2T_Server_Service.bat <Verzeichnis> <Servername>[:<Port>]
Achtung: Das Eingabeaufforderungsfenster muss Administratorrechte
besitzen! Dazu muss die Eingabeaufforderung mit der rechten Maustaste und der
Auswahl 'Als Administrator ausführen' gestartet werden.
Der
Parameter --JvmMx=256 legt das Memory für den Ebus-2T-Server in Megabytes fest.
Nach
dem Aufruf von Ebus_2T_Server_Service.bat wird ein Dialog angezeigt, auf dem
der Dienst gestartet werden kann:

Der
Ebus-2T-Server wird im Quiet-Modus gestartet, da bei einem Dienst keine
graphische Oberfläche verfügbar ist. Alle Informationen werden in die folgenden
Log-Dateien geschrieben:
|
Name der Log-Datei |
Inhalt |
|
Ebus_2T_Server.logon |
Logon-/Logoff-Informationen |
|
Ebus_2T_Server.log |
Start-,
Ende- und Fehlermeldungen des Ebus-2T-Servers |
|
jakarta_service_<Datum>.log |
Protokoll
über Start und Ende des Dienstes |
|
stdout_<Datum>.log |
Ausgaben
und Meldungen des Ebus-2T-Servers |
Der
obige Dialog zum Starten und Stoppen des Dienstes kann über folgendes Kommando
oder über Systemsteuerung/Dienste aufgerufen werden:
prunmgr
//ES//Ebus2TServer
Folgendes
Kommando deinstalliert den Dienst:
prunsrv
//DS//Ebus2TServer
Achtung: Damit der
Ebus-2T-Server-Dienst auch von anderen Rechnern im Netzwerk erreichbar ist,
muss prunsrv.exe als zulässiges Programm im Windows-Firewall festgelegt
werden.
Dazu
Systemsteuerung/Windows-Firewall aufrufen und 'Ein Programm oder Feature durch
die Windows-Firewall zulassen' (Windows 7) bzw. die Registerkarte 'Ausnahmen'
(Windows XP) anklicken. Unter Windows 7 klicken Sie auf den Button
'Einstellungen ändern' und dann auf den Button 'Anderes Programm zulassen'. Unter
Windows XP klicken Sie auf den Button 'Programm'. Anschließend klicken Sie auf
den Button 'Durchsuchen' und wählen das Programm prunsrv.exe in dem Verzeichnis
aus, in dem sich Ebus-2T-Server.jar befindet. Klicken Sie dann auf den Button
'Hinzufügen' bzw. 'OK' um die Ausnahme zu speichern.
start_client_service.bat installiert ein
Client-Programm als Dienst unter Windows.
Der
Aufruf von start_client_service.bat muss mit folgenden Parametern erfolgen:
start_client_service
<Client-Programm-Name> <Client-Pfad> [<Serveradresse>
[<Clientadresse>]]
<Client-Programm-Name> ist der Name des
Client-Programms, z.B. Faktura_Client
<Client-Pfad> muss das Verzeichnis
enthalten, in dem das Client-Programm <Client-Programm-Name> als Dienst
gestartet werden soll. In diesem Verzeichnis müssen auch die Dateien policy.txt,
prunmgr.exe und prunsrv.exe liegen.
<Serveradresse> ist der Name oder die
IP-Adresse des Rechners, auf dem der Ebus-2T-Server läuft.
<Clientadresse> ist der Name oder die
IP-Adresse des Clientrechners. Dieser Parameter kann fehlen, er muss
normalerweise nur angegeben werden, wenn der Zugriff auf den Ebus-2T-Server
über das Internet erfolgt.
Folgendes
Kommando startet den Dialog zum Starten und Beenden des Dienstes:
prunmgr
//ES//<Client-Programm-Name>
Folgendes
Kommando deinstalliert den Dienst:
prunsrv
//DS//<Client-Programm-Name>
Zum
Starten eines Java-Programmes als Dienst unter Windows siehe Ablauf eines Ebus-Programms.