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

Guide de migration et de mise à niveau de Talend
Version
7.3
Language
Français
Product
Talend Big Data
Talend Big Data Platform
Talend Data Fabric
Talend Data Integration
Talend Data Management Platform
Talend Data Services Platform
Talend ESB
Talend MDM Platform
Talend Real-Time Big Data Platform
Module
Studio Talend
Talend Activity Monitoring Console
Talend Administration Center
Talend Artifact Repository
Talend CommandLine
Talend Data Preparation
Talend Data Stewardship
Talend ESB
Talend Identity and Access Management
Talend JobServer
Talend Log Server
Talend MDM Server
Talend MDM Web UI
Talend Runtime
Talend SAP RFC Server
Content
Installation et mise à niveau
Last publication date
2023-05-22
Disponible dans...

Data Fabric

Data Services Platform

ESB

MDM Platform

Real-Time Big Data Platform

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

  1. 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.
  2. 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

  1. Assurez-vous que le Talend Runtime à mettre à niveau est en cours d'exécution.
  2. 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 :
  1. Arrêtez l'ancienne instance et la nouvelle instance de Talend Runtime.
  2. Supprimez et réinstallez la nouvelle version de Talend Runtime.
  3. Nettoyez le fichier log/tesb.log.
  4. Redémarrez l'ancienne instance de Talend Runtime et exécutez le script de migration comme expliqué ci-dessus.