跳到主要内容 跳到补充内容

完整 Talend Runtime 安装的自动迁移 (推荐)

大多数无法通过补丁获取的 Talend Runtime 版本（例如 7.3.1-R2022-09-RT 和 8.0.1-R2022-10-RT）可以使用迁移工具自动迁移。该工具会自动将配置和已安装的特性功能从现有的 Talend Runtime 迁移到其新的长期支持版本。

开始之前

  • 您的运行时版本为 8.0 或更高。
  • 您想要迁移到的版本不是 8.0.1-R2023-08-RT。要前移此版本，请参阅 完整 Talend Runtime 的手动迁移。
  • 应用升级补丁（推荐的方法）过于复杂而不可行，因此您收到了 Talend 提供的完整安装程序。
  • 您已经安装了 Talend Runtime 的新版本。请注意，新版本的安装方式应与要升级的版本相同。换言之，新版本和旧版本要么作为服务安装，要么将它们都作为独立程序解压缩到给定目录中。

关于此任务

  • 首先在非生产环境中执行此迁移，以确保输出包含旧版本的所有重要定制资源，尤其是手动安装的资源，完全正常工作。
  • 默认情况下，迁移工具存储在补丁文件中名为 migration 的文件夹中，因此本文使用的也正是此位置。您也可以将其保存在其它目录。

步骤

  1. 请确保需要升级的 Talend Runtime 正在运行。
  2. 根据您的操作系统以及运行时的安装方式，使用以下命令之一运行迁移工具。
    • Talend Runtime 作为服务安装:
      • 在 Windows 中，使用管理员权限在迁移目录中启动 PowerShell 并运行以下命令：
        ./talendRuntimeMigration.ps1 talend-runtime-8.0.1-XXXX talend-runtime-8.0.1-YYYY
        命令输出举例如下: 
        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
      • 在 Linux 中，运行以下命令：
        ./talendRuntimeMigration.sh talend-runtime-8.0.1-XXXX talend-runtime-8.0.1-YYYY
        命令输出举例如下: 
        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 以手动方式安装 (独立模式)：
      • 在 Windows 中，运行以下命令：
        ./talendRuntimeMigration.ps1 "path_to_current_karaf"  "path_to_new_karaf"
      • 在 Linux 中，运行以下命令：
        ./talendRuntimeMigration.sh "path_to_current_karaf"  "path_to_new_karaf"
    然后，迁移工具的脚本会协调以下步骤：
    • 安装导出捆绑包
    • 停止当前 Talend Runtime
    • 启动新Talend Runtime
    • 安装导入捆绑包
排错： 如果在迁移过程中或迁移之后遇到问题，请执行如下操作。
  • 检查两个版本的 Talend Runtime 的 log/tesb.log 下的错误日志。

    对于 Windows 系统，您可以在 PowerShell 的生成具体调试日志的脚本行前添加 $DebugPreference = 'Continue'。

  • 如果错误发生在迁移过程中，按下述步骤进行回滚操作:
    1. 停止新的 Talend Runtime 引擎。
    2. 启动老的运行时。
需要回复迁移时，按如下步骤进行:
  1. 停止老的和新的 Talend Runtime 实例的运行。
  2. 删除并重新安装新的 Talend Runtime 版本。
  3. 清除 log/tesb.log 文件。
  4. 重启老的 Talend Runtime 实例并按前述步骤运行迁移脚本。

下一步做什么

参阅 被迁移的配置 以查看该工具迁移的配置列表并手动迁移任何剩余项目。然后测试新的 Talend Runtime 以确保其正常工作。此后，重复上述过程以将 Talend Runtime 迁移到生产环境。然后，您可以按照补丁说明中描述的过程，使用最新补丁修补此新安装。

在该部分中

本页面有帮助吗？

如果您发现此页面或其内容有任何问题 – 打字错误、遗漏步骤或技术错误 – 请告诉我们如何改进！

在此处留下您的反馈