Dieser Abschnitt beinhaltet Informationen zum Thema Server und Servereinstellungen.
Der Server übernimmt zwei Hauptaufgaben:
- Im Config-Verzeichnis gespeicherte Extraktionen ausführen
- Im Config-Verzeichnis gespeicherte Einstellungen dem Designer zur Verfügung stellen
Extraktion auf dem Server ausführen #
Ausführung wird durch eine HTTP-Anfrage (Request) ausgelöst. Die HTTP-Anfrage kann bei Pull-Destinationen aus der Zielumgebung oder von dem xu-Kommandozeilen-Tool (xu.exe / xu.elf) gestartet werden, siehe Extraktionen Ausführen und Einplanen.
Der Server-Prozess kann im Extraktions-Log nachvollzogen werden.
- Theobald.Xu.Web.Worker.exe prüft die Authentisierung und Autorisierung der Anfrage.
- Die Zielumgebung wird für das Schreiben der extrahierten Daten vorbereitet (z.B. Datenbakverbindung herstellen, Datei anlegen).
- Die Lizenz wird geprüft.
- Eine Verbindung zum in der Source definierten SAP-System wird hergestellt.
- Die Daten des definierten Extraktionstyps werden angefordert.
- Jedes extrahierte Datenpaket wird in die Zielumgebung geschrieben.
- Nachdem alle Pakete empfangen wurden, trennt Theobald.Xu.Web.Worker.exe die Verbindung zum SAP-System und informiert die Zielumgebung wird über den Abschluss der Extraktion.
Tipp: Die Theobald.Xu.Web.Worker.exe protokolliert ihre Aktionen in Log-Dateien.
Die Log-Dateien befinden sich im Logs-Unterverzeichnis des Programmverzeichnisses:C:Program Files\XtractUniversal\logs\servers\web\worker
(standartmäßig).
Die Logs kann man sich auch im Designer unter [Server]>[Logs (Web Worker)] anzeigen lassen.
Auf die Einstellungen mit dem Designer zugreifen #
- Theobald.Xu.Rpc.Worker.exe prüft die Authentisierung und Autorisierung der Anfrage.
- Designer fragt eine bestimmte Einstellung an, z.B. Liste aller Extraktionen.
- Theobald.Xu.Rpc.Worker.exe liest die angefragten Einstellungen aus dem Config-Verzeichnis und sendet diese Einstellungen an den Designer.
- Der Benutzer ändert die die Einstellungen im Designer (z.B. Destinationseinstellungen).
- Der Designer sendet die geänderten Einstellungen an Theobald.Xu.Rpc.Worker.exe zurück. Theobald.Xu.Rpc.Worker.exe speichert die geänderten Einstellungen im Config-Verzeichnis.
Tipp: Die Theobald.Xu.Rpc.Worker.exe protokolliert ihre Aktionen in Log-Dateien.
Die Log-Dateien befinden sich im Logs-Unterverzeichnis des Programmverzeichnisses: C:\Program Files\XtractUniversal\logs\server\rpc\worker
(Standard).
Serverarchitektur #
Der Server läuft als Windows-Service und der Hauptprozess von diesem Service ist XtractService.exe. Der Windows-Service kann über die Windows-Diensteverwaltung oder den Taskmanager verwaltet werden.
XtractService.exe startet zwei Listener-Prozesse:
- Theobald.Xu.Web.Listener.exe
- Theobald.Xu.Rpc.Listener.exe
Die beiden Listener-Prozesse lauschen auf den Ports, die in den Server-Einstellungen definiert sind.
Tipp: Die XtractService.exe protokolliert ihre Aktionen in ServiceLog.txt.
Die Log-Datei befindet sich im Logs-Unterverzeichnis des Programmverzeichnisses: C:ProgramFiles\XtractUniversal\logs
(Standard).
Theobald.Xu.Rpc.Listener.exe
Theobald.Xu.Rpc.Listener.exe wartet auf neue Verbindungsanfragen vom Designer.
Für jede TCP-Verbindung startet die Theobald.Xu.Rpc.Listener.exe eine neue Instanz der Theobald.Xu.Rpc.Worker.exe, die alle über die TCP-Verbindung eingehenden Anfragen des Designers prozessiert, siehe Auf die Einstellungen mit dem Designer zugreifen.
Tipp: Die Theobald.Xu.Rpc.Listener.exe protokolliert ihre Aktionen in Log-Dateien.
Die Log-Dateien befinden sich im Logs-Unterverzeichnis des Programmverzeichnisses: C:\ProgramFiles\XtractUniversal\logs\server\rpc\listener
(Standard).
Theobald.Xu.Web.Listener.exe
Theobald.Xu.Web.Listener.exe wartet auf HTTP-Anfragen.
Für jede TCP-Verbindung startet die Theobald.Xu.Web.Listener.exe eine neue Instanz der Theobald.Xu.Web.Worker.exe, die alle über diese TCP-Verbindung eingehenden HTTP-Anfragen bearbeitet, siehe Extraktion auf dem Server ausführen.
Die folgenden HTTP-Anfragen sind möglich:
- Ausführen einer Extraktion
- Leeren des Result-Caches einer Extraktion
- Abbrechen aller Läufe einer Extraktion
- REST API-Anfragen z.B. Logs, Metadaten etc.
Tipp: Die Theobald.Xu.Web.Listener.exe protokolliert ihre Aktionen in Log-Dateien.
Die Log-Dateien befinden sich im Logs-Unterverzeichnis des Programmverzeichnisses: C:ProgramFiles\XtractUniversal\logs\server\web
(standartmäßig).
Weitere Informationen zum Server finden Sie in den folgenden Abschnitten: