Skip to main content

Migration-Prep-Tool

Das Migration-Prep-Tool für Server ist ein Hilfsprogramm, das die Vorabmigration einer Datenbank mit Workflows und Apps ermöglicht, um die Migration auf den neuen AES256-Standard zu beschleunigen.

Das Migration-Prep-Tool ist optional und ein separates Befehlszeilen-Hilfsprogramm. Sie müssen es nur einmal ausführen, bevor Sie ein Upgrade von Server 2022.1 (oder früheren Versionen) auf 2022.3.x oder höher vornehmen.

Wichtig

  • Falls Sie ein Upgrade von 2022.1 oder früher durchführen, führen Sie vor der Aktualisierung auf 2022.3+ bitte das Migration-Prep-Tool aus.

  • Wenn Sie ein Upgrade von 2022.3+ durchführen, wurde Ihre Datenbank bereits kryptomigriert und Sie müssen das Migration-Prep-Tool nicht ausführen.

Anmerkung

Warum haben wir dieses Tool erstellt?

Server aktualisiert seine Kryptografie auf AES256 für Data-at-Rest (DAR). Alle vorhandenen kryptografisch gespeicherten Daten müssen von der aktuellen Verschlüsselungsmethode auf die neue migriert werden. Manche dieser Daten können vor dem Upgrade auf 2022.3 migriert werden, während Ihr Server in der Produktion genutzt wird.

Die zeitaufwändigsten Daten, die migriert werden müssen, sind die in Server gespeicherten Apps und Workflows. Um beim Upgrade auf Server 2022.3 Zeit zu sparen, können diese Daten im Voraus migriert werden.

Alteryx hat das Migration-Prep-Tool entwickelt, um Sie bei der Migration dieser Daten vor dem Upgrade zu unterstützen.

Wann sollte ich das Migrationstool verwenden?

Wir empfehlen Ihnen, das Migrationstool in folgenden Fällen auszuführen:

  • Wenn es sich bei der Server-Installation, für die Sie ein Upgrade durchführen, um ein Produktionssystem oder ein Entwicklungssystem handelt, das nicht länger als ein paar Stunden ausfallen darf, und

  • Sie mehr als ein paar Hundert Workflows haben und

  • Sie führen MongoDB Atlas oder eine benutzerverwaltete MongoDB aus.

Auch wenn diese Szenarien nicht auf Sie zutreffen, ist es empfehlenswert, vor einem Upgrade das Migration-Prep-Tool auszuführen, um den Erfolg sicherzustellen.

Darüber hinaus sollten Sie auch die Größe von db.AS_App_Chunks.dataSize() und AS_PackageDefinitions berücksichtigen. Wir haben derzeit für den Zeitpunkt, zu dem Sie das Migration-Prep-Tool im Vorbereitungsmodus ausführen sollten, keine Empfehlungen im Hinblick auf die Datenbankgröße.

Wenn Sie nur wenige Workflows haben oder es Ihnen nichts ausmacht, wenn das Upgrade von Server mehrere Stunden oder Tage dauert, können Sie den Einsatz des Migration-Prep-Tools überspringen und das standardmäßige Installationsprogramm für Server ausführen, um auf 2022.3 zu aktualisieren. Die Ausfallzeit ist länger als üblich, da das Upgrade auch die Krypto-Migration umfasst.

Anmerkung

Wenn Sie sich entscheiden, das Migration-Prep-Tool nicht vor dem Upgrade auszuführen, wird das Tool im Rahmen der Installation des Upgrades auf 2024.1 installiert und ausgeführt.

Vorabprüfung

Um voraussichtliche Probleme abzuschätzen, die Sie vor dem Upgrade auf 2022.3 oder höher möglicherweise beheben müssen, führen Sie die Vorabprüfung als Teil des Migration-Prep-Tools aus.

Wichtig

Sie können eine Vorabprüfung nur auf Server-Instanzen mit einem 64-stelligen Controller-Token durchführen.

  • Wenn Ihre Server-Version 2021.3 oder älter ist, müssen Sie zunächst ein Upgrade auf Version 2022.1 durchführen, bevor Sie mit den nächsten Schritten fortfahren können.

  • Überprüfen Sie die Länge des Controller-Tokens unter Alteryx Systemeinstellungen > Controller > Allgemein > Token > Ansicht.

    Wenn Ihr Token 40 Zeichen lang ist, wählen Sie Erneut generieren aus, um ein neues Token zu erstellen. Wählen Sie dann OK, um den AlteryxService neu zu starten und ein neues Token zu erstellen.

Während der Vorabmigration oder der vollständigen Migration können Sie Fehlerprotokolle einsehen, mit denen Sie die Probleme selbst lösen können. Auf diese Weise können Sie die empfohlenen Maßnahmen ergreifen, um sicherzustellen, dass die vollständige Migration trotz eventueller Fehler erfolgreich abgeschlossen wird.

Beim Ausführen des Migration-Prep-Tools wurden drei neue Ausführungsoptionen hinzugefügt:

  • Standard: Die Vorabmigration und die Vorabprüfung zur Migration gleichzeitig ausführen (-p)

  • Nur die Vorabmigration (Apps) ausführen (--appsonly)

  • Nur den Schritt zur Validierung der Anmeldedaten ausführen (--credonly)

Während Sie das Migration-Prep-Tool ausführen, müssen Sie das Controller-Token (-t) und den Hostnamen/die IP-Adresse (-i) des Controllers angeben. Dies bedeutet auch, dass Sie jetzt das Migration-Prep-Tool bei einer Multi-Node-Einrichtung ausführen können, indem Sie den Hostnamen/die IP-Adresse des Controllers und das Controller-Token angeben.

Beachten Sie, dass nicht zwei Instanzen des Migration-Prep-Tools für denselben Controller gleichzeitig ausgeführt werden können.