Dieser Abschnitt beinhaltet Informationen zum Thema Server und Servereinstellungen.

Der Server übernimmt zwei Hauptaufgaben:

  1. Im Config-Verzeichnis gespeicherte Extraktionen ausführen
  2. 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.

  1. XtractRun.exe prüft die Authentisierung und Autorisierung der Anfrage.
  2. Die Zielumgebung wird für das Schreiben der extrahierten Daten vorbereitet (z.B. Datenbakverbindung herstellen, Datei anlegen).
  3. Die Lizenz wird geprüft.
  4. Eine Verbindung zum in der Source definierten SAP-System wird hergestellt.
  5. Die Daten des definierten Extraktionstyps werden angefordert.
  6. Jedes extrahierte Datenpaket wird in die Zielumgebung geschrieben.
  7. Nachdem alle Pakete empfangen wurden, trennt XtractRun.exe die Verbindung zum SAP-System und informiert die Zielumgebung wird über den Abschluss der Extraktion.

Tipp: Die XtractRun.exe protokolliert ihre Aktionen in Log-Dateien. Die Log-Dateien befinden sich im Logs-Unterverzeichnis des Programmverzeichnisses:C:Program Files\XtractUniversal\logs\server\run (standartmäßig). Die Logs kann man sich auch im Designer unter [Server]>[Logs (Run)] anzeigen lassen.

Auf die Einstellungen mit dem Designer zugreifen #

  1. Theobald.Xu.Rpc.Worker.exe prüft die Authentisierung und Autorisierung der Anfrage.
  2. Designer fragt eine bestimmte Einstellung an, z.B. Liste aller Extraktionen.
  3. Theobald.Xu.Rpc.Worker.exe liest die angefragten Einstellungen aus dem Config-Verzeichnis und sendet diese Einstellungen an den Designer.
  4. Der Benutzer ändert die die Einstellungen im Designer (z.B. Destinationseinstellungen).
  5. 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:

  • XtractWebServer.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).

XtractWebServer.exe

XtractWebServer.exe wartet auf HTTP-Anfragen.
Für jede TCP-Verbindung startet die XtractWebServer.exe eine neue Instanz der XtractRun.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 XtractWebServer.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:

Server starten

Ports

Server Einstellungen