<<

Inhaltsverzeichnis

Suchen

>>

 

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.

 

 

Start des Ebus-2T-Servers

 

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.

 

 

 

Start der Client-Programme

 

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.

 

 

Automatisches Beenden des Ebus-2T-Servers

 

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 als Dienst unter Windows einrichten

 

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.

 

 

Client-Programm als Dienst unter Windows einrichten

 

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.