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 2022.3 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
You can only perform a pre-flight check on Server instances using a 64-character Controller Token.
If your Server is on version 2021.3 or earlier, you need to first upgrade to version 2022.1 before proceeding with the next steps.
Check the length of your Controller Token in Alteryx System Settings > Controller > General > Token > View.
If your token is 40 characters long, select Regenerate to create a new token. Then select OK to restart the AlteryxService and create the new token.
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 das Migration-Prep-Tool jetzt in einer Einrichtung mit mehreren Knoten ausführen können, indem Sie den Hostnamen/die IP-Adresse des Controllers und das Controller-Token angeben.
Beachten Sie, dass zwei Instanzen des Migration-Prep-Tools nicht gleichzeitig für denselben Controller ausgeführt werden können.