Accéder au contenu principal Passer au contenu complémentaire

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

La plupart des versions de Talend Runtime ne s'obtiennent pas par un patch, par exemple vous pouvez migrer automatiquement vers les versions 7.3.1-R2022-09-RT et 8.0.1-R2022-10-RT via l'outil de migration. Cet outil spécifique migre automatiquement la configuration et les fonctionnalités installées depuis le Talend Runtime existant vers sa nouvelle version avec support à long terme.

Avant de commencer

  • Vous souhaitez mettre à niveau Talend Runtime d'une version 7.3 à une version 7.3, ou d'une 8.0 vers une 8.0.
  • La version vers laquelle vous souhaitez migrer n'est pas 8.0.1-R2023-08-RT. Pour migrer vers cette version, consultez Migration manuelle d'une installation complète de Talend Runtime.
  • 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 avec le patch.
  • 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 (comme dans Installer manuellement Talend Runtime en tant que service), soit elles sont installées comme dans Installation de Talend Runtime.

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.
  • Par défaut, l'outil de migration est stocké dans un dossier nommé migration dans les fichiers de patchs, c'est donc l'emplacement utilisé dans cette section. 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 à l'aide d'une des commandes suivantes, selon votre système d'exploitation 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-8.0.1-XXXX talend-runtime-8.0.1-YYYY
        Voici un exemple de sortie attendue :
        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
      • Sous Linux, exécutez la commande suivante :
        ./talendRuntimeMigration.sh talend-runtime-8.0.1-XXXX talend-runtime-8.0.1-YYYY
        Voici un exemple de sortie attendue :
        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 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é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.

Que faire ensuite

Consultez Configurations migrées pour voir la liste des configurations migrées par l'outil et migrer manuellement les éventuels éléments restants. Testez ensuite le nouveau Talend Runtime pour vous assurer de son bon fonctionnement. Répétez ensuite la procédure ci-dessus pour migrer votre Talend Runtime dans l'environnement de production. Appliquez le patch le plus récent sur cette nouvelle installation en suivant la procédure décrite dans les notes de patch correspondantes.

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.