Automatische Migration einer kompletten Talend Runtime-Installation (empfohlen)

Die meisten Versionen von Talend Runtime, die nicht über einen Patch verfügbar sind, wie z. B. 7.3.1-R2022-09-RT und 8.0.1-R2022-10-RT, können automatisch mithilfe des Migrationstools migriert werden. Dieses Tool führt automatisch eine Migration der Konfiguration und der installierten Funktionen von der bestehenden Version von Talend Runtime zur neuen Version mit Langzeitsupport durch.

Vorbereitungen

Sie planen eine Aktualisierung von Talend Runtime von einer Version 7.3 auf eine Version 7.3 bzw. von einer Version 8.0 auf eine Version 8.0.
Die Version, zu der die Migration durchgeführt werden soll, ist eine andere Version als 8.0.1-R2023-08-RT. Für Informationen zur Migration dieser Version siehe „Manuelle Migration einer kompletten Talend Runtime-Installation“.
Die Anwendung eines Aktualisierungs-Patches - die empfohlene Vorgehensweise - ist zu kompliziert und somit nicht durchführbar. Aus diesem Grund haben Sie gemeinsam mit dem Patch ein vollständiges Installationsprogramm von Talend erhalten.
Sie haben die neue Version von Talend Runtime installiert. Beachten Sie, dass die neue Version auf dieselbe Weise installiert werden muss wie die zu aktualisierende Version. Das bedeutet, dass beide Versionen, d. h. sowohl die neue als auch die alte Version, entweder als Dienst installiert oder in bestimmten Verzeichnissen als Standalone-Programm entpackt werden müssen.

Warum und wann dieser Vorgang ausgeführt wird

Führen Sie diese Migration zunächst in einer Nicht-Produktionsumgebung durch, um sicherzustellen, dass die Ausgabe alle wichtigen benutzerdefinierten Ressourcen der alten Version enthält, insbesondere diejenigen, die Sie manuell installiert haben, damit uneingeschränkte Funktionsfähigkeit gewährleistet ist.
Standardmäßig ist das Migrationstool in einem Ordner namens migration in den Patch-Dateien gespeichert. In diesem Artikel wird deshalb dieser Speicherort verwendet. Sie können es jedoch nach Bedarf in einem anderen Verzeichnis Ihrer Wahl unterbringen.

Prozedur

Vergewissern Sie sich, dass die zu aktualisierende Version von Talend Runtime ausgeführt wird.

Führen Sie das Migrationstool mithilfe der nachstehend aufgeführten Befehle aus, je nach Ihrem Betriebssystem und der Art der Installation von Runtime.

Talend Runtime wurde als Dienst installiert:

Starten Sie unter Windows eine PowerShell mit Administrator-Privilegien im Migrationsverzeichnis und führen Sie folgenden Befehl aus:

./talendRuntimeMigration.ps1 talend-runtime-8.0.1-XXXX talend-runtime-8.0.1-YYYY

Ein Beispiel für die erwartete Ausgabe:

PS C:\Users\IEUser\Desktop\TalendRuntime\migration> .\talendRuntimeMigration.ps1 talend-runtime-8.0.1-R2022-07-RT talend-runtime-8.0.1-R2022-10-RT
2023-01-19 22:17:19.651 Exporting data from current Talend Runtime
2023-01-19 22:17:44.666 Copying exported data to the new Talend Runtime
2023-01-19 22:17:44.995 Stopping current Talend Runtime
WARNING: Waiting for service 'Talend Runtime 8.0.1-R2022-07-RT (talend-runtime-8.0.1-R2022-07-RT)' to stop...
WARNING: Waiting for service 'Talend Runtime 8.0.1-R2022-07-RT (talend-runtime-8.0.1-R2022-07-RT)' to stop...
WARNING: Waiting for service 'Talend Runtime 8.0.1-R2022-07-RT (talend-runtime-8.0.1-R2022-07-RT)' to stop...
WARNING: Waiting for service 'Talend Runtime 8.0.1-R2022-07-RT (talend-runtime-8.0.1-R2022-07-RT)' to stop...
WARNING: Waiting for service 'Talend Runtime 8.0.1-R2022-07-RT (talend-runtime-8.0.1-R2022-07-RT)' to stop...
2023-01-19 22:17:57.620 Starting new Talend Runtime
2023-01-19 22:18:22.073 Importing data into the new Talend Runtime
2023-01-19 22:18:23.088 Migration completed successful

Führen Sie unter Linux folgenden Befehl aus:

./talendRuntimeMigration.sh talend-runtime-8.0.1-XXXX talend-runtime-8.0.1-YYYY

Ein Beispiel für die erwartete Ausgabe:

root@talend-VirtualBox:/home/talend/Downloads/migration# ./talendRuntimeMigration.sh talend-runtime-8.0.1-R2022-07-RT talend-runtime-8.0.1-R2022-10-RT
2023-01-23 15:51:27.464 Exporting data from current Talend Runtime
2023-01-23 15:51:29.472 Copying exported data to the new Talend Runtime
2023-01-23 15:51:29.475 Stopping current Talend Runtime
2023-01-23 15:51:57.709 Starting new Talend Runtime
2023-01-23 15:52:14.405 Importing data into the new Talend Runtime
2023-01-23 15:52:16.425 Migration completed successfully

Talend Runtime wurde manuell (im Standalone-Modus) installiert:
- Führen Sie unter Windows folgenden Befehl aus:
```
./talendRuntimeMigration.ps1 "path_to_current_karaf"  "path_to_new_karaf"
```
- Führen Sie unter Linux folgenden Befehl aus:
```
./talendRuntimeMigration.sh "path_to_current_karaf"  "path_to_new_karaf"
```

Das Skript des Migrationstools orchestriert dann die folgenden Schritte:

Installation des Export-Pakets
Stopp der aktuellen Version von Talend Runtime
Start der neuen Version von Talend Runtime
Installation des Import-Pakets

Troubleshooting: Sollten während oder nach der Migration Probleme auftreten, dann versuchen Sie, diese anhand der folgenden Schritte zu beheben.

Prüfen Sie das Fehlerlog in log/tesb.log für beide Versionen von Talend Runtime.
Unter Windows können Sie $DebugPreference = 'Continue' in der PowerShell vor der Skriptzeile hinzufügen, um spezifische Debugging-Logs zu generieren.
Sollten Fehler während der Migration auftreten, dann führen Sie folgenden Rollback durch:
1. Halten Sie die neue Talend Runtime-Engine an.
2. Starten Sie die alte Engine.

Wenn Sie den Migrationsprozess wiederaufnehmen müssen, gehen Sie vor wie folgt:

Halten Sie die alte und die neue Instanz von Talend Runtime an.
Löschen Sie die neue Version von Talend Runtime und installieren Sie sie dann neu.
Leeren Sie die Datei log/tesb.log.
Starten Sie die alte Instanz von Talend Runtime neu und führen Sie das Migrationsskript aus wie oben beschrieben.

Nächste Maßnahme

Unter „Migrierte Konfigurationen“ finden Sie Informationen zur Prüfung der Liste der vom Tool migrierten Konfigurationen und zur manuellen Migration aller verbleibenden Elemente. Testen Sie dann die neue Version von Talend Runtime, um sicherzustellen, dass alles ordnungsgemäß funktioniert. Wiederholen Sie anschließend das oben beschriebene Verfahren, um Talend Runtime in die Produktionsumgebung zu migrieren. Sie können die neue Installation dann mit dem neuesten Patch ausstatten. Halten Sie sich dazu an das in den entsprechenden Patch-Hinweisen beschriebene Verfahren.

Hat diese Seite Ihnen geholfen?

Wenn Sie Probleme mit dieser Seite oder ihren Inhalten feststellen – einen Tippfehler, einen fehlenden Schritt oder einen technischen Fehler –, teilen Sie uns bitte mit, wie wir uns verbessern können!

Geben Sie hier Ihr Feedback ab