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

完整 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 迁移到生产环境。然后，您可以按照补丁说明中描述的过程，使用最新补丁修补此新安装。

在该部分中

本页面有帮助吗？

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

在此处留下您的反馈