Migration automatique d'une installation complète de Talend Runtime (recommandé)

Un outil spécifique de migration est fourni pour migrer automatiquement la configuration et les fonctionnalités installées depuis un Runtime existant vers sa nouvelle version LTS.

Avant de commencer

La version de votre Runtime est au moins la 7.3 et la version cible reste basée sur la 7.3.
Appliquer un patch de mise à niveau, l'approche recommandée, est trop compliqué pour être faisable. Vous avez donc reçu un installeur complet de Talend.
Vous avez installé la nouvelle version de Talend Runtime. Notez que la nouvelle version doit être installée de la même manière que la version à mettre à niveau. En d'autres termes, soit la nouvelle et l'ancienne versions sont installées en tant que services, soit elles sont dézippées dans des répertoires donnés en tant que programmes standalones.

Pourquoi et quand exécuter cette tâche

Effectuez d'abord cette migration dans un environnement hors production, pour vous assurer que la sortie contient toutes les ressources importantes personnalisées de l'ancienne version, particulièrement celles installées manuellement et qu'elle soit pleinement fonctionnelle.
Dans cet article, l'outil de migration est stocké dans un dossier nommé migration. Vous pouvez le stocker dans un dossier différent, celui de votre choix.

Procédure

Assurez-vous que le Talend Runtime à mettre à niveau est en cours d'exécution.

Exécutez l'outil de migration fourni à l'aide d'une des commandes suivantes, selon le système d'exploitation que vous utilisez et la manière dont votre Runtime a été installé.

Talend Runtime installé en tant que service :

Sous Windows, démarrez PowerShell avec les droits Administrator (Administrateur) dans le répertoire de migration et exécutez la commande suivante :

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

Voici un exemple de sortie attendue :

PS C:\Users\IEUser\Desktop\TalendRuntime\migration> .\talendRuntimeMigration.ps1 talend-runtime-7.3.1 talend-runtime-7.3.1-R2022-09-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 7.3.1 (talend-runtime-7.3.1)' to stop...
WARNING: Waiting for service 'Talend Runtime 7.3.1 (talend-runtime-7.3.1)' to stop...
WARNING: Waiting for service 'Talend Runtime 7.3.1 (talend-runtime-7.3.1)' to stop...
WARNING: Waiting for service 'Talend Runtime 7.3.1 (talend-runtime-7.3.1)' to stop...
WARNING: Waiting for service 'Talend Runtime 7.3.1 (talend-runtime-7.3.1)' 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

Sous Linux, exécutez la commande suivante :

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

Voici un exemple de sortie attendue :

root@talend-VirtualBox:/home/talend/Downloads/migration# ./talendRuntimeMigration.sh talend-runtime-7.3.1 talend-runtime-7.3.1-R2022-09-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 installé manuellement (en mode standalone) :
- Sous Windows, exécutez la commande suivante :
```
./talendRuntimeMigration.ps1 "path_to_current_karaf"  "path_to_new_karaf"
```
- Sous Linux, exécutez la commande suivante :
```
./talendRuntimeMigration.sh "path_to_current_karaf"  "path_to_new_karaf"
```

Le script de l'outil de migration orchestre ensuite les étapes suivantes :

installation du bundle d'import,
arrêt du Talend Runtime courant,
démarrage du nouveau Talend Runtime,
installation du bundle d'import.

Résultats

Testez le nouveau Talend Runtime pour vous assurer qu'il fonctionne correctement et qu'il comprend bien toutes les ressources personnalisées de l'ancienne version. Répétez ensuite la procédure ci-dessus pour migrer votre Talend Runtime dans l'environnement de production.

Résolution de problèmes : Si vous avez rencontré des problèmes au cours de la migration ou après celle-ci, vous pouvez effectuer les étapes suivantes.

Vérifier le log d'erreur dans log/tesb.log des deux versions de Talend Runtime.
Sous Windows, vous pouvez ajouter $DebugPreference = 'Continue' dans PowerShell avant la ligne de script afin de générer les logs spécifiques de débogage.
Si des erreurs surviennent au cours de la migration, procédez comme suit pour effectuer un rollback :
1. Arrêtez le nouveau moteur de Talend Runtime.
2. Démarrez l'ancien.

Lorsque vous souhaitez reprendre la migration, procédez comme suit :

Arrêtez l'ancienne instance et la nouvelle instance de Talend Runtime.
Supprimez et réinstallez la nouvelle version de Talend Runtime.
Nettoyez le fichier log/tesb.log.
Redémarrez l'ancienne instance de Talend Runtime et exécutez le script de migration comme expliqué ci-dessus.

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – faites-le-nous savoir.

Laissez vos commentaires ici