Der Datenaustausch zwischen Webplattform und Unternehmensdatenbank erfolgt über ein Schnittstellenmodul, das einmalig im Unternehmen installiert wird, die sogenannte Bridge (RATIOserver Anwendung).
Zur Installation der RATIOserver Anwendung muss zunächst die Setup-Datei heruntergeladen werden.
Diese ist als ausführbare Datei (ratioserver-setup.exe) und als Archiv (ratioserver-setup.zip) verfügbar.
https://www.ratioapp.de/webplattform/apps/ratioserver/settings
Der Benutzer, der die RATIOserver Anwendung ausführt, benötigt Schreibrechte für das Installationsverzeichnis. Dies ist notwendig, da Konfigurationsdatei (ratioserver.ini), Logdatei (ratioserver.log) und Setup-Datei (ratioserver-setup.exe; notwendig für Updates) im Installationsverzeichnis gespeichert werden. |
Nach erfolgreicher Installation kann die RATIOserver Anwendung gestartet werden.
Ab der Version 3.4 ist es möglich einen Überwachungsdienst zu installieren. Dieser prüft, in einem einstellbaren Intervall und Versuche, ob die RATIOserver Anwendung läuft. Wenn dieser nach X Versuchen nicht erreicht, so wird die RATIOserver Anwendung automatisch neu gestartet. |
Um die RATIOserver Anwendung als Dienst zu starten, wird der Haken "Windows-Dienst" gesetzt.
Anschließend muss der Überwachungsdienst mit Ja bestätigt werden.
Danach gibt man die Mandantenkennung, Prüfintervall und Versuche ein.
Bei der Mandantenkennung immer als erstes ein Unterstrich (_) eingeben und keine Leerzeichen verwenden. |
Mit dem Button "Übernehmen" wird der Dienst erstellt.
Zum Schluss muss noch die Windows Dienste aufgerufen werden und den neu erstellten Dienst starten.
(Oder im Task Manager unter Dienste den neu erstellten Dienst starten)
Der Dienst muss beendet werden, wenn:
|
Um den Dienst zu beenden müssen folgende Schritte gemacht werden:
Im Windows Task Manager den Reiter Dienste öffnen.
Die RATIOserver Anwendung anhalten.
Im Reiter Prozesse den TASK RATIOserver Anwendung beenden.
Um den Dienst wieder zu starten müssen folgende Schritte gemacht werden:
Den Windows Task Manager öffnen.
Den Reiter Dienste öffnen.
Die RATIOserver Anwendung Starten.
Um die RATIOserver Anwendung beim Systemstart sofort auszuführen, kann eine Windows-Aufgabe angelegt werden.
Button “Neu...” drücken. |
Button “Neu...” drücken. |
Haken bei “Aufgabe nur starten falls Computer im Netzbetrieb ausgeführt wird” entfernen. |
Folgende Haken müssen gesetzt werden:
Ausführung der Aufgabe bei Bedarf zulassen
Aufgabe so schnell wie möglich nach einem verpassten Start ausführen
Falls Aufgabe scheitert, neu starten alle: 1 Minute
Neustartversuche bis maximal: 3 Mal
Beenden der aktiven Aufgabe erzwingen, falls sie auf Aufforderung nicht beendet wird
Folgende Haken dürfen nicht gesetzt sein:
Aufgabe beenden, falls Ausführung länger als:
Falls keine weitere Ausführung geplant ist, Aufgabe löschen nach:
Zusätzlich muss folgende Regel angewendet werden:
Folgende Regel anwenden, falls die Aufgabe bereits ausgeführt wird: Keine neue Instanz starten
Damit automatische Updates auch dann funktionieren, wenn die RATIOserver Anwendung im Hintergrund (also ohne angemeldeten Benutzer) ausgeführt wird, müssen eine separate Windows-Aufgabe und eine Verknüpfung angelegt werden. |
Aktionen
Button “Neu...” drücken. |
Haken bei “Aufgabe nur starten falls Computer im Netzbetrieb ausgeführt wird” entfernen. |
Folgende Haken müssen gesetzt werden:
Ausführung der Aufgabe bei Bedarf zulassen
Beenden der aktiven Aufgabe erzwingen, falls sie auf Aufforderung nicht beendet wird
Folgende Haken dürfen nicht gesetzt sein:
Aufgabe so schnell wie möglich nach einem verpassten Start ausführen
Falls Aufgabe scheitert, neu starten alle:
Aufgabe beenden, falls Ausführung länger als:
Falls keine weitere Ausführung geplant ist, Aufgabe löschen nach:
Zusätzlich muss folgende Regel angewendet werden:
Folgende Regel anwenden, falls die Aufgabe bereits ausgeführt wird: Keine neue Instanz starten
Die Verknüpfung muss im Installationsverzeichnis der RATIOserver Anwendung erstellt werden:
%Windir%\System32\schtasks.exe /run /TN "RATIOserver-Update (Instanz 1)"
/TN = Name der Update-Aufgabe
Die Verknüpfung muss ratioserver-update.exe heißen, damit sie vom Updatemechanismus erkannt wird.
Beim automatischen Update lauern einige Fallstricke wie Benutzerkontensteuerung, Benutzerberechtigungen, Virenscanner oder Firewalls. Deshalb sollte der Updatemechanismus ausführlich getestet werden.
Während der Tests kann über die Checkbox Update-Test ein Update erzwungen werden, auch wenn tatsächlich kein solches vorliegt. Nach Abschluss der Tests muss die Option jedoch wieder deaktiviert werden!
Grundlage für das automatische Update ist die Funktionsfähigkeit des manuellen Updates. Das manuelle Update kann über den Button Auf Update prüfen gestartet werden.
Wird ein Haken bei Auto-Update gesetzt, kann die Tageszeit eingegeben werden, zu der ein automatisches Update durchgeführt werden soll. Ab der eingestellten Uhrzeit wird innerhalb der folgenden 10 Minuten jede Minute auf ein Update geprüft. Wird als Uhrzeit beispielsweise 03:00 Uhr definiert, so prüft das Programm im Zeitraum von 03:00 bis 03:10 Uhr einmal pro Minute auf Updates. Bei gesetzter Option Update-Test werden also bis zu 10 Updates in Folge durchgeführt.
Um das automatische Update zu prüfen, wenn der RATIOserver Anwendung im Hintergrund läuft, d.h. wenn dieser beim Systemstart durch die Auto-Start-Aufgabe ausgeführt wird, kann ein Doppelklick auf die Verknüpfung ratioserver-update.exe erfolgen. Davor ist allerdings sicherzustellen, dass der RATIOserver Anwendung beendet wurde und sich die Datei ratioserver-setup.exe im Installationsverzeichnis befindet. Die Verknüpfung sorgt dafür, dass die RATIOserver Anwendung im Hintergrund (d.h. ohne Oberfläche) gestartet wird.
Im Taskmanager muss ein neuer Prozess ratioserver.exe erscheinen, der die Sitzungskennung 0 (Null) besitzt. Die Spalte Sitzungskennung muss ggf. erst eingeblendet werden. Jetzt am besten die Datei ratioserver-setup.exe löschen. Sobald das automatische Update anläuft, wird im Idealfall die Setup-Datei heruntergeladen und ausgeführt. Funktioniert dies nicht, muss die Systemkonfiguration geprüft werden (Berechtigungen, Virenscanner, Firewall etc.).
Soll die Konfiguration der RATIOserver Anwendung geändert werden, muss der Prozess zunächst über den Taskmanager beendet werden. Danach kann er durch Doppelklick auf die ratioserver.exe mit Oberfläche neu gestartet werden. Zur Fehleranalyse bietet es sich an das Log-Level entweder auf ERROR oder TRACE zu setzen. Im Produktivbetrieb sollte das Log-Level jedoch auf ERROR stehen, damit die Logdatei nicht zu groß wird.