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 der xu-Kommandozeilen-Tool (xu.exe /xu.elf) gestartet werden.
Tipp: Der Server-Prozess kann im Extraktions-Log nachvollzogen werden.
- XtractRun.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, wird die Verbindung zum SAP-System getrennt und die Zielumgebung wird über den Abschluss der Extraktion informiert.
Auf die Einstellungen mit dem Designer zugreifen #
- XtractConfigServer.exe prüft die Authentisierung und Autorisierung der Anfrage.
- Designer fragt eine bestimmte Einstellung an, z.B. Liste aller Extraktionen.
- XtractConfigServer.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 XtractConfigServer.exe zurück. XtractConfigServer.exe speichert die geänderten Einstellungen im Config-Verzeichnis.
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
- XtractConfigServer.exe
Tipp: Die XtractService.exe protokolliert ihre Aktionen in ServiceLog.txt.
Die Log-Datei befindet sich im Logs-Unterverzeichnis des Programmverzeichnisses: C:ProgramFiles\XtractUniversal\logs
(standartmäßig).
Die beiden Listener-Prozesse lauschen auf den Ports, die in den Server-Einstellungen definiert sind.
XtractConfigServer.exe wartet auf neue Verbindungsanfragen vom Designer.
Tipp: Die XtractConfigServer.exe protokolliert ihre Aktionen in Log-Dateien.
Die Log-Dateien befinden sich im Logs-Unterverzeichnis des Programmverzeichnisses: C:ProgramFiles\XtractUniversal\logs\server\config
(standartmäßig).
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.
Tipp: Die XtractRun.exe protokolliert ihre Aktionen in dem Log-Unterverzeichnis.
Die Log-Dateien befinden sich im Logs-Unterverzeichnis des Programmverzeichnisses:C:ProgramFiles\XtractUniversal\logs\server\run
(standartmäßig).
Das sind auch die Logs, die man sich im Designer unter [Server]>[Logs (Run)] anzeigen lassen kann.
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: