Das Migration-Prep-Tool ausführen
Wichtig
Verwenden Sie dieses Tool nur für die Migration von Server-Version 2022.2 oder früher. Der Verschlüsselungsmechanismus wurde in Version 2022.3 aktualisiert.
Bevor Sie beginnen
Das Migration-Prep-Tool erstellt eine gestaffelte Kopie der Workflow-Daten, die in Ihrer Datenbank gespeichert sind. Während dieses Vorgangs zeigt das Migration-Prep-Tool eine Schätzung des Speicherplatzes an, der zum Fortfahren erforderlich ist. Setzen Sie den Prozess erst fort, wenn Sie ausreichend Speicherplatz zur Verfügung haben.
Warnung
Ob das der Fall ist, müssen Sie manuell überprüfen. Eine Überprüfung des verfügbaren Speicherplatzes durch das Migration-Prep-Tool ist nicht möglich.
Schritt 1: Das Migrationstool installieren
Laden Sie das Installationsprogramm von downloads.alteryx.com herunter und führen Sie es aus.
Akzeptieren Sie die EULA. Wählen Sie Weiter aus.
Um den Installationsort zu ändern, wählen Sie Ändern aus. Oder wählen Sie Weiter aus, um den Standardinstallationsort zu übernehmen.
Folgen Sie den Aufforderungen, um die Installation abzuschließen.
Schritt 2: Das Migrationstool starten
Öffnen Sie eine Eingabeaufforderung oder PowerShell.
Navigieren Sie zum ausgewählten Installationspfad (Standard:
C:\Programme\Alteryx Migration Tool\).Führen Sie einen der Befehle aus, um das Migration-Prep-Tool zu starten. Hinweis: Wenn Sie PowerShell verwenden, ergänzen Sie
.\am Anfang jedes Befehls. Sie können diesen Vorgang auf jedem Host ausführen, der Zugriff auf den MongoDB-Server hat. Sie können ihn ohne Ausfallzeiten mehrere Male sicher ausführen.Bei einer Multi-Node-Einrichtung müssen IP-Adresse/Hostname, Controller-Token und NON_ADMIN_MONGO_PASSWORD dem Rechner entsprechen, auf dem der Controller-Knoten entsprechend der Konfiguration ausgeführt wird, die während der Multi-Node-Einrichtung vorgenommen wurde.
Bei einem einzigen Knoten müssen die Details von demselben Rechner stammen, auf dem Alteryx Server installiert ist.
So verwenden Sie die Beispiele:
Ersetzen Sie diese Variablen in der Verbindungszeichenfolge durch die Werte, die für Ihre Umgebung geeignet sind. Dies sind dieselben Anmeldedaten, die Sie auch zur Konfiguration Ihrer Server-Datenbank verwenden. Sie finden sie in den Alteryx-Systemeinstellungen.
{authenticationDB} = die Datenbank, die die angegebenen Benutzeranmeldedaten authentifiziert.
Wenn Ihr Server für die Verwendung der eingebetteten MongoDB konfiguriert ist, verwenden Sie das MongoDB-Kennwort für Nicht-Admins. In der Verbindungszeichenfolge sollte die authSource „AlteryxService“ sein.
Wenden Sie sich für eine benutzerverwaltete MongoDB bitte an Ihre:n MongoDB-Administrator:in, um die Benutzeranmeldedaten und authSource zu bestätigen.
{port} = der Dienst-Port, den MongoDB nutzt, um Zugriff auf die Datenbank zu ermöglichen.
{host.domain.tld} = der vollständig qualifizierte Domänenname Ihres MongoDB-Servers.
{password} = Anmeldedaten für den/die Benutzer:in.
{user} = Benutzername für den Zugriff auf die Datenbank.
{atlasCluster.cloudProvider.mongodb.net} = die MongoDB Atlas-Clusteradresse.
Database (Datenbank) | Beispiel |
|---|---|
Eingebettete MongoDB Hinweis: „NON_ADMIN_MONGO_PASSWORD“, „CONTROLLER_TOKEN“ und „localhost“ sollten basierend auf Ihrer aktuellen Einrichtung geändert werden. | Migration von App-Block und RunAS_Credentials AlteryxServiceMigrator22_2.exe -p -c "mongodb://user:NON_ADMIN_MONGO_PASSWORD@localhost:27018/AlteryxService?authSource=AlteryxService" -i <host/IP_Address> -t <Controller_Token> |
Migration nur von App-Block AlteryxServiceMigrator22_2.exe --appsonly -c "mongodb://user:NON_ADMIN_MONGO_PASSWORD@localhost:27018/AlteryxService?authSource=AlteryxService" -i <host/IP_Address> -t <Controller_Token> | |
Migration nur von RunAs_Credential AlteryxServiceMigrator22_2.exe --credonly -c "mongodb://user:NON_ADMIN_MONGO_PASSWORD@localhost:27018/AlteryxService?authSource=AlteryxService" -i <host/IP_Address> -t <Controller_Token> | |
Benutzerverwaltete MongoDB Hinweis: „Password“, „port“, „host.domain.tld“ und „authenticationDB“ sollten basierend auf Ihrer aktuellen MongoDB-Instanz geändert werden. | Migration von App-Block und RunAS_Credentials AlteryxServiceMigrator22_2.exe -p -c "mongodb://user:password@{host.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Controller_Token> |
Migration nur von App-Block AlteryxServiceMigrator22_2.exe --appsonly -c "mongodb://user:password@{host.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Controller_Token> | |
Migration nur von RunAs_Credential AlteryxServiceMigrator22_2.exe --credonly -c "mongodb://user:password@{host.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Controller_Token> | |
MongoDB-Replikatsätze | Migration von App-Block und RunAS_Credentials AlteryxServiceMigrator22_2.exe -p -c "mongodb://{user}:{password}@{host1.domain.tld}:{port},{host2.domain.tld}:{port},{host3.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Controller_Token> |
Migration nur von App-Block AlteryxServiceMigrator22_2.exe –-appsonly -c "mongodb://{user}:{password}@{host1.domain.tld}:{port},{host2.domain.tld}:{port},{host3.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Controller_Token> | |
Migration nur von RunAs_Credential AlteryxServiceMigrator22_2.exe --credonly -c "mongodb://{user}:{password}@{host1.domain.tld}:{port},{host2.domain.tld}:{port},{host3.domain.tld}:{port}/AlteryxService?authSource={authenticationDB}" -i <host/IP_Address> -t <Controller_Token> | |
MongoDB Atlas | Migration von App-Block und RunAS_Credentials AlteryxServiceMigrator22_2.exe -p -c "mongodb+srv://{user}:{password}@{atlasCluster.cloudProvider.mongodb.net}/AlteryxService?retryWrites=true&w=majority" -i <host/IP_Address> -t <Controller_Token> |
Migration nur von App-Block AlteryxServiceMigrator22_2.exe –-appsonly -c "mongodb+srv://{user}:{password}@{atlasCluster.cloudProvider.mongodb.net}/AlteryxService?retryWrites=true&w=majority" -i <host/IP_Address> -t <Controller_Token> | |
Migration nur von RunAs_Credential AlteryxServiceMigrator22_2.exe --credonly -c "mongodb+srv://{user}:{password}@{atlasCluster.cloudProvider.mongodb.net}/AlteryxService?retryWrites=true&w=majority" -i <host/IP_Address> -t <Controller_Token> |
-h [ --help ]: zeigt Hilfeinformationen an
-q [ --quiet ]: gibt Protokollmeldungen an die Befehlszeile aus (Fortschrittsmeldungen ignorieren diese Einstellung)
-s [ --severity ] arg (=7): Konsole protokolliert Dringlichkeitsstufe (Migrationsfortschrittsberichte werden auf Ebene 5 gesendet)
-p [ --perform ]: Migration durchführen
--appsonly führt nur Block-Migration ohne Vorabprüfung durch
--credonly führt Vorabprüfung ohne Block-Migration durch
-u [ --forcenoprogressupdates ]: deaktiviert das Schreiben der Meldungen zu Fortschrittsaktualisierungen auf die Konsole (sie werden weiterhin in die Protokolldatei geschrieben)
-c [ --connection ] arg: Verbindungszeichenfolge (AlteryxService-Datenbank muss angegeben sein)
-i [ --hostname ] arg: Hostname|IP-Adresse des Controllers
-t [ --controllertoken ] arg: Controller-Token zum Abrufen der Schlüssel
-l [ --loggingpath ] arg (=C:\ProgramData\Alteryx): Protokoll-Dateipfad muss %N für die Protokollrotation enthalten
--loggingmaxfilesize arg (=64): maximale Größe in MB für eine Protokolldatei, bevor sie rotiert wird
-d [ --stagingdirectory ] arg: Verzeichnis, in dem entschlüsselte Workflows vorübergehend gespeichert werden, bevor sie erneut verschlüsselt werden
Beim Start der Migration werden Sie aufgefordert zu bestätigen, dass Sie eine Sicherungskopie der Datenbank und der Laufzeiteinstellungsdatei erstellt haben.
Sobald Sie die Sicherungskopien bestätigen, überprüft das Hilfsprogramm die aktuelle Speicherplatznutzung. Ihnen wird dann eine Schätzung des zusätzlichen Speicherplatzes angezeigt, der für die Migration benötigt wird. Anschließend müssen Sie Ihr System überprüfen. Fahren Sie nur dann fort, wenn Sie sicher sind, dass genügend freier Speicherplatz verfügbar ist.
Nachdem Sie bestätigt haben, dass genügend Speicherplatz verfügbar ist, beginnt das Hilfsprogramm mit der Migration der Workflow-Daten. Ihnen werden Meldungen zur Start- und Abschlusszeit sowie Fortschrittsmeldungen angezeigt.
Problembehandlung
Wenn während der Migration ein Fehler auftritt, wird er in der Konsole angezeigt und auch in der Protokolldatei erfasst.
Wenn ein Fehler auftritt, gehen Sie wie folgt vor:
Machen Sie einen Screenshot der Eingabeaufforderung.
Machen Sie vertrauliche Daten unkenntlich oder entfernen Sie sie.
Erfassen Sie das Protokoll (siehe Validierungsschritte für Speicherort und Benennung).
Führen Sie die Migration erneut aus.
Wenn die Migration erneut fehlschlägt, wenden Sie sich an den Alteryx Support und fügen Sie den Screenshot und die Protokolldatei in Ihre Nachricht ein.
Anmerkung
Wenn der Fehler Fehler bei der Schlüsselinitialisierung <Fehler beim Importieren von Schlüsseln in das Verzeichnis Microsoft\Crypto\RSA\MachineKeys\ in ProgramData: Zugriff verweigert. (5)> RunAS-Migration ist fehlgeschlagen beim Ausführen des Migrationsbefehls auftritt, navigieren Sie zu C:\ProgramData\Microsoft\Crypto\RSA\MachineKeys. Klicken Sie dann mit der rechten Maustaste auf den Ordner „MachineKeys“ und wählen Sie Weitere Optionen anzeigen > Zugriff gewähren für > Bestimmte Personen aus. Wählen Sie Alle mit Lese-/Schreibzugriff aus. Wählen Sie dann Freigeben aus.
Schritt 3: Upgrade auf Server 2024.1 durchführen
Wichtig
Erstellen Sie vor dem Upgrade eine Sicherungskopie Ihrer Mongo-Datenbank und der Datei RuntimeSettings.xml. Die während des Wartungsfensters durchgeführte Verschlüsselung kann nicht rückgängig gemacht werden. Die Sicherungskopie schützt Ihre Installation vor Datenverlust oder zusätzlichen Ausfallzeiten.
Während des Upgrades auf 2024.1 wird der Migrationsfortschritt nicht angezeigt.
Weitere Informationen zum Upgrade finden Sie unter Server installieren oder aktualisieren.
Laden Sie Server 2024.1 von downloads.alteryx.com herunter.
Führen Sie das Installationsprogramm aus. Wählen Sie Ja aus, um mit dem Upgrade fortzufahren.
Nehmen Sie die Lizenzvereinbarung an.
Wählen Sie einen Installationspfad aus oder akzeptieren Sie den Standardpfad. Wählen Sie dann Weiter aus.
Wählen Sie Installieren aus, um die Installation zu starten (Upgrade).
Wenn die Installation abgeschlossen ist, wählen Sie Server jetzt konfigurieren und dann Abschließen.
Nachdem die Installation von Server 2024.1 abgeschlossen ist, wählen Sie die Option Sicherung und Migration starten aus.
Wählen Sie nach erfolgreicher Migration OK aus.
Hinweis: Nach der Installation kann es zu einer Verzögerung beim Starten des Dienstes kommen.
Alteryx-Systemeinstellungen öffnen sich. Navigieren Sie durch die Systemeinstellungen, um zu überprüfen, ob Ihre Einstellungen korrekt sind. Wählen Sie dann Fertigstellen und Fertig, um den Dienst zu starten.
Beim Starten des Dienstes wechselt Server in den Wartungsmodus, um RuntimeSettings und die Datenbankwerte zu migrieren, die zuvor nicht migriert werden konnten. Während des Wartungsmodus ist Ihre Server-Instanz nicht verfügbar.
Das Migration-Prep-Tool führt eine abschließende Prüfung auf Datenbankänderungen seit der letzten Ausführung durch. Anschließend führt es die Migration (einschließlich aller neu gefundenen Änderungen) aus und setzt die gestaffelte Migration in Kraft.
Diese endgültige Migration kann mehrere Stunden dauern. Die Dauer hängt davon ab, wie groß Ihre Konfiguration ist und ob vor dem Upgrade das Migration-Prep-Tool ausgeführt wurde. Sobald dieser Prozess abgeschlossen ist, beendet Server den Wartungsmodus und wechselt in einen funktionsfähigen Zustand.
Problembehandlung
Wenn der Dienst nach einer gewissen Zeit herunterfährt, überprüfen Sie bitte die folgenden Protokolle auf Migrationsfehler:
LastStartupError.txt
AlteryxServiceMigrator_#.log erstellt vom Migration-Prep-Tool
AlteryxServiceMigrator_#.log erstellt während des Dienststarts
Wenn Migrationsfehler auftreten, versuchen Sie, den AlteryxService neu zu starten. Dadurch wird das Problem möglicherweise behoben, da unvollständige Migrationsschritte in einem erneuten Versuch durchgeführt werden. Wenn das Problem dennoch weiterhin besteht, sammeln Sie die Protokolle und wenden Sie sich an den Kundensupport. Abhängig von den Fehlern kann der Versuch, den AlteryxService neu zu starten, das Problem beheben. Denn so werden unvollständige Migrationsschritte in einem erneuten Versuch durchgeführt.
Schritt 4: Erfolgreiche Migration validieren
Um zu überprüfen, ob das Migration-Prep-Tool erfolgreich ausgeführt wurde, können Sie die folgenden Optionen nutzen.
Migration-Prep-Tool-Protokoll validieren
Navigieren Sie zu
C:\ProgramData\Alteryx\Service\.Öffnen Sie AlteryxServiceMigrator_#.log.
Prüfen Sie das Protokoll auf Fehlermeldungen oder Meldungen über ein Fehlschlagen. Suchen Sie nach Status 3, der im Protokoll als „;3;“ angezeigt wird.
Dienststart-Protokoll validieren
Navigieren Sie zum Protokollordner, der von Alteryx Systemeinstellungen > Controller > Allgemein > Protokollierung festgelegt wurde.
Öffnen Sie AlteryxServiceMigrator_#.log.
Prüfen Sie das Protokoll auf Fehlermeldungen oder Meldungen über ein Fehlschlagen. Suchen Sie nach Status 3, der im Protokoll als „;3;“ angezeigt wird.
Validierung nach Upgrade auf 2024.1 (nach der endgültigen Migration)
Melden Sie sich über die Web-URL bei Server an.
Überprüfen Sie Folgendes:
Sie können Workflows und Apps manuell ausführen.
Zeitpläne sind aktiv und werden mit den erwarteten Ergebnissen ausgeführt.
Sie können Workflow-Anmeldedaten anzeigen, bearbeiten, erstellen und verwenden.
Sie können Server-Datenverbindungen anzeigen, bearbeiten, erstellen und verwenden.
Rufen Sie ein Workflow-Paket von der API ab, importieren Sie dieses Paket in Designer und führen Sie den Workflow in Designer aus.