Voraussetzungen #

Hinweis: Administratorberechtigungen sind notwendig, um Xtract Universal zu installieren.

Produktversion #

Wenn Sie ein Produkt von Theobald Software installieren, wird Ihnen während der Installation angezeigt, um welche Produktversion es sich handelt. Wir empfehlen, immer die aktuellste Version zu installieren.

Um einzusehen, welche Version bereits bei Ihnen installiert ist, rufen Sie unter Windows Einstellungen > Apps auf und prüfen Sie die Version.

Setup #

Die XtractUniversalSetup.exe ist ein branchenübliches Setup. Führen Sie die Datei XtractUniversalSetup.exe aus und folgen Sie den Anweisungen des Setups.

Beim Starten des Setups können die optionalen Komponenten (1) für die Installation ausgewählt werden. Bei der Auswahl der Komponenten werden die Optionsdetails im “Description” Feld angezeigt (2).

XU-Setup

Komponente Subkomponente Beschreibung
Main Product Files - Installiert alle notwendigen Dateien, die zum Verwenden von Xtract Universal notwendig sind.
Designer - Installiert die Designer-Anwendung, entfernen Sie die Markierung bei dieser Option, wenn Sie Xtract Universal ohne die grafische Schnittstelle verwenden wollen.
Server   Installiert Xtract Universal Server.
Install Service Installiert die Serverkomponente als Windows-Service. Mehr Details im Abschnitt Server Starten
Convert config files Konvertiert Extraktionen, Sources (Quellen), Destinationen usw. vom Format der vorherigen Version in das neue Format. Diese Komponente ist entscheidend bei der Installation von Major Releases und Upgrades von z.B. Version 3.x auf 4.x.
XtractUniversal Report Server Plugin - Plugin für die Power BI Report Server Destination.
Start Menu Shortcuts - Komponente, die dem Startmenü Verknüpfungen hinzufügt.

Hinweis: Markieren Sie bei der Installation die Option “Server > Install Service”. Eine Installation des Servers ohne Service dient nur Entwicklungszwecken.

Die Installationsschritte werden im Abschnitt Lizenz beschrieben.

Dateien des Programmverzeichnisses #

Die folgende Liste zeigt einige der wichtigsten Dateien, die nach der Installation in das Standardverzeichnis C:\Program Files\XtractUniversal abgelegt werden:

Dateiname Beschreibung
ABAP Verzeichnis Verzeichnis mit den SAP-Funktionsbausteinen. Die readme.txt innerhalb des Verzeichnisses beinhaltet weitere Informationen. Mehr Details dazu finden Sie auch in SAP Customizing.
Alteryx Verzeichnis Verzeichnis mit dem Plugin-Setup für die Alteryx Destination.
logs Verzeichnis Verzeichnis mit Server- und Extraktionsprotokollen etc. Mehr Details dazu finden Sie in Logging.
config Verzeichnis Verzeichnis mit allen SAP-Verbindungen, Extraktionen, Destinationen und anderen Einstellungen. Mehr Details dazu finden Sie auch Backup und Migration.
powerbi Verzeichnis Verzeichnis mit Dateien, die mit der Power BI Connector Destination in Zusammenhang stehen.
result-cache Verzeichnis Verzeichnis mit Extraktions-Cache-Dateien, anwendbar nur für Pull-Destinationen. Mehr Details dazu finden Sie auch in Abschnitten Pull-Destinationen und Allgemeine Einstellungen: General Settings > Misc. Tab > Cache Result Setting.
xu.exe Kommandozeilentool zum Ausführen von Extraktionen. Mehr Details dazu finden Sie auch im Abschnitt Extraktion einplanen.
xu-config.exe Kommandozeilentool zum Erstellen von Extraktionen. Mehr Details dazu finden im Knowledge Base Artikel Creating extractions without using the Xtract Universal designer GUI.
XtractCleanup.exe Anwendung, die alle Ergebnisse im Cache und Log-Dateien entsprechend der Web Server Einstellungen von Xtract Universal löscht.
XtractDesigner.exe Xtract Universal Designer Anwendung zum Erstellen, Testen und Überwachen von Extraktionen.
ConfigConverter.exe Anwendung, die Extraktionen, Quellen (Sources), Destinationen usw. vom Format der vorherigen Version in das neue Format konvertiert. Diese Anwendung ist entscheidend bei der Installation von Major Releases und Upgrades von z.B. Version 3.x auf 4.x.
uninstall.exe Tool zum Deinstallieren und Entfernen von Xtract Universal mit allen dazugehörigen Komponenten von Ihrer Maschine.
XtractUniversalSetup.exe Setup der aktuell installierten Version. Mehr Details dazu finden Sie auch in Migration auf eine andere Maschine.
XtractUniversal Report Server Plugin Plugin für die Power BI Report Server Destination.
Eula_XtractUniversal.rtf Dokument mit der Lizenzvereinbarung zur Nutzung der Software Xtract Universal.
XtractUniversalLicense.json Lizenzdatei mit Server-, Komponenten- und Laufzeitinformationen.

Hinweis: Mehr Details zum Starten von Xtract Universal Server als Konsolenprogramm, finden Sie im Knowledge-Base-Artikel How to use target principal field.

Unbeaufsichtigte Installation #

Die Installation kann über die Eingabeaufforderung von Windows nicht interaktiv und ohne GUI durchgeführt werden.

Um die Installation im Silent-Modus zu starten, verwenden Sie den Switch --unattended.
Verwenden Sie den start-Befehlt mit dem Switch /wait, um zu warten bis die Installation abgeschlossen ist.

Beispiel:

start /wait XtractUniversalSetup.exe --unattended

Hinweis: Achten Sie auf die Groß- und Kleinschreibung der Parameter.

Verwendung des Standalone-Designers #

Wenn Sie Xtract Universal aus dem Kundenportal - My Theobald Software beziehen, haben Sie die Option eine Standalone-Version des Designers für Windows herunterzuladen. Der Standalone-Designer kann genutzt werden, um sich auf ein zentrales Xtract Universal Repository zu verbinden ohne die Software installiert zu haben.

Voraussetzungen

Der Xtract Universal Service muss auf einer zentralen Serverinstanz, z.B. einem firmenweiten Anwendungsserver, installiert sein.
Dadurch ist der Zugriff auf ein gemeinsames Xtract Universal Repository (C:\Program Files\XtractUniversal\config) möglich, das von mehreren Xtract Universal Anwendern genutzt werden kann.

Den Standalone-Designer starten

Wenn Sie den Standalone-Designer heruntergeladen haben, entpacken Sie die Dateien aus dem .zip Ordner in ein beliebiges Verzeichnis.
Der Ordner enthält zwei ausführbare Dateien:

  • XtractDesigner.exe startet den Designer.
  • xu.exe ist ein Kommandozeilentool zum Ausführen von Extraktionen siehe Aufruf via Kommandozeile.

Verwenden Sie XtractDesigner.exe, um den Designer zu starten. Bevor Sie sich mit einem XU-Server verbinden, stellen Sie sicher, dass Sie Zugriffsrechte auf Server und Repository haben, siehe Zugriffssteuerung.

Hinweis: Bei einem Softwareupdate laden Sie die aktuelle Version des Standalone-Designers manuell aus dem Kundenportal - My Theobald Software herunter und ersetzen Sie das bisher verwendete Verzeichnis des Standalone-Designers.

Hinweis: Der Standalone-Designer kann ggf. von Antivirensoftware als ‘gefährlich’ eingestuft werden. Stellen Sie sicher, dass der Designer nicht von Antivirensoftware blockiert wird.

Neuinstallation und Update #

Warnung! Datenverlust: Systemänderungen oder Updates können die Funktionalität der Software einschränken, dabei können Daten verloren gehen. Erstellen Sie ein Backup des Verzeichnis: C:\Program Files\XtractUniversal\config in regelmäßigen Abständen.

Eine regelmäßige Aktualisierung der Software ist entscheidend für eine stabile Performance, insbesondere bei größeren Änderungen und Updates hoher ([H])-Priorität. Prüfen Sie die Versionshistorie auf Updates. Eine neuere Version kann über die ältere Version installiert werden.

Alle Einstellungen und angelegten Objekte bleiben erhalten. Beim Migrieren von Daten und Einstellungen auf einen anderen Server, folgen Sie den Anweisungen, die im Abschnitt Backup und Migration.

Update-Vorbereitung

Tipp: Abonnieren Sie per E-Mail den technischen Newsletter von Theobald Software, der Sie über neue Software Features, Knowledge Base Artikel und Veröffentlichungshinweise (Release Notes) informiert.

  1. Prüfen Sie, ob Sie über eine funktionierende Testumgebung mit einer gültigen Lizenz und Wartung verfügen.
  2. Stellen Sie sicher, dass die Testumgebung eine Kopie der aktuellen Produktivumgebung ist.
  3. Prüfen Sie die Versionshistorie und die Veröffentlichungshinweise (Release Notes) in der Knowledge-Base, um eine Update-Notwendigkeit auszuschließen.
  4. Erstellen Sie ein Backup der aktuellen Installation.
  5. Führen Sie alle notwendigen Vorbereitungen und Änderungen durch, die in den Veröffentlichungshinweisen (Release Notes) / Versionshistorie beschrieben sind. Bei größeren Änderungen verwenden Sie den ConfigConverter.

Hinweis: Wenn Sie Ihre Testumgebung aktualisieren und einzelne config Ordner aus der Produktionsumgebung in die Testumgebung kopieren, stellen Sie sicher, dass Sie die version.txt Datei mit kopieren. Die version.txt Datei befindet sich im config Ordner.

Aktualisieren von Hauptversionen (Major Releases) - ConfigConverter #

Es gibt zwei Möglichkeiten Produktversion zu aktualisieren:

  • Upgrade während der Installation
  • Manuelles Upgrade

Upgrade während der Installation

  1. Starten Sie das Xtract Universal Setup.
  2. Markieren Sie die Checkbox Convert config files.
    Die Option Convert config files startet die ConfigConverter-Anwendung, die sicherstellt, dass alle Extraktionen, Quellsysteme (Source Systems), Destinationen sowie Server- und Benutzereinstellungen in der neuen Version verfügbar sind.
    XU-Setup
  3. Bestätigen Sie den Konvertierungsprozess im Pop-up-Fenster der Kommandozeile. XU3_Migration_2

Hinweis: Wenn der ConfigConverter ausgeführt wird, wird automatisch ein Backup-Ordner im Installationsverzeichnis erstellt, z.B. C:\Program Files\XtractUniversal\backup-[alte Versionsnummer]. Diese Ordner enthält die Extraktionen, die vom ConfigConverter geändert wurden.

Manuelles Upgrade

Wird der ConfigConverter nicht automatisch bei der Installation ausgeführt, kann dieser auch nachträglich manuell aus dem Installationsverzeichnis C:\Program Files\XtractUniversal gestartet werden.

XU3_Migration_3

Hinweis: Alle Probleme, die während des Konvertierungsprozesses auftreten können, werden im Befehlszeilenfenster angezeigt. Kopieren Sie den Befehlszeilenkontext und senden Sie ihn bei Bedarf an das Support-Team.