Table of Contents |
---|
Einführung
Der Datenaustausch zwischen Webplattform und Unternehmensdatenbank erfolgt über ein Schnittstellenmodul, das einmalig im Unternehmen installiert wird, die sogenannte Bridge (RATIO Server RATIOserver Anwendung).
Installation
Zur Installation der Ratio Server 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
Info |
---|
Der Benutzer, unter dem der RATIO Server Anwendung ausgeführt wirddie 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 der RATIO Server die RATIOserver Anwendung gestartet werden.
Konfiguration
Windows Dienst einrichten (ab Version 3.4)
Info |
---|
Ab der Version 3.4 ist es möglich einen Überwachungsdienst zu installieren. Dieser prüft, in einem einstellbaren Intervall und Versuche, ob die RATIO Server RATIOserver Anwendung läuft. Wenn dieser nach X Versuchen nicht erreicht, so wird die RATIO Server RATIOserver Anwendung automatisch neugestartetneu gestartet. |
Um die RATIO Server 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.
Info |
---|
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 aufrufen aufgerufen werden und den neu erstellten Dienst starten.
(Oder im Task Manager unter Dienste den neu erstellten Dienst starten)
Windows Ereignisanzeige
RATIOserver Anwendung - Dienst beenden
Info |
---|
Der Dienst muss beendet werden, wenn zum Beispiel die Ratio Server :
|
Um den Dienst zu beenden müssen folgende Schritte gemacht werden:
Den Im Windows Task Manager den Reiter Dienste öffnen.Den
Reiter Dienste öffnen und die Ratio Server Die RATIOserver Anwendung anhalten.
Im Reiter Prozesse die Ratio Server 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 und die Ratio Server .
Die RATIOserver Anwendung Starten.
Windows Aufgabe einrichten (nur für Versionen die älter sind als 3.4)
Um die RATIO Server RATIOserver Anwendung beim Systemstart sofort auszuführen, kann eine Windows-Aufgabe angelegt werden.
Allgemein
Trigger
Info |
---|
Button “Neu...” drücken. |
Aktionen
Info |
---|
Button “Neu...” drücken. |
Bedingungen
Info |
---|
Haken bei “Aufgabe nur starten falls Computer im Netzbetrieb ausgeführt wird” entfernen. |
Einstellungen
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 MalBeenden 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
Auto-Update - Windows-Aufgabe
Info |
---|
Damit automatische Updates auch dann funktionieren, wenn der RATIO Server die RATIOserver Anwendung im Hintergrund (also ohne angemeldeten Benutzer) ausgeführt wird, müssen eine separate Windows-Aufgabe und eine Verknüpfung angelegt werden. |
Allgemein
Trigger
Aktionen
Info |
---|
Button “Neu...” drücken. |
Bedingungen
Info |
---|
Haken bei “Aufgabe nur starten falls Computer im Netzbetrieb ausgeführt wird” entfernen. |
Einstellungen
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
Verknüpfung
Die Verknüpfung muss im Installationsverzeichnis der RATIO Server 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.
Update Informationen
Update-Test
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!
Manuelles Update
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.
Automatisches Update MIT angemeldetem Benutzer
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.
Automatisches Update OHNE angemeldetem Benutzer
Um das automatische Update zu prüfen, wenn der RATIO Server 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 RATIO Server RATIOserver Anwendung beendet wurde und sich die Datei ratioserver-setup.exe im Installationsverzeichnis befindet. Die Verknüpfung sorgt dafür, dass der RATIO Server 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 des RATIO Server 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.