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

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

提供了一个特定的迁移工具,用于自动将配置和已安装的特性功能从现有的运行时迁移到其新的 LTS 版本。

开始之前

  • 您的运行时版本为 7.3 更高版本,目标版本仍是 7.3 基线版本。
  • 应用升级补丁(推荐的方法)过于复杂而不可行,因此您已经收到了来自 Talend 提供的完整安装程序。
  • 您已经安装了 Talend Runtime 的新版本。请注意,新版本的安装方式应与要升级的版本相同。换言之,新版本和旧版本要么作为服务安装,要么将它们都作为独立程序解压缩到给定目录中

关于此任务

  1. 首先在非生产环境中执行此迁移,以确保输出包含旧版本的所有重要定制资源,尤其是手动安装的资源,完全正常工作。
  2. 在本文中,迁移工具存储在名为 migration 的文件夹中。您也可以将其保存在其它目录。

步骤

  1. 请确保需要升级的 Talend Runtime 正在运行。
  2. 使用以下命令之一运行提供的迁移工具,具体取决于您使用的操作系统和运行时版本的安装方式。
    • Talend Runtime 作为服务安装:
      • 在 Windows 中,使用管理员权限在迁移目录中启动 PowerShell 并运行以下命令:
        ./talendRuntimeMigration.ps1 talend-runtime-7.3.1-XXXX talend-runtime-7.3.1-YYYY
        命令输出举例如下:
        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
      • 在 Linux 中,运行以下命令:
        ./talendRuntimeMigration.sh talend-runtime-7.3.1-XXXX talend-runtime-7.3.1-YYYY
        命令输出举例如下:
        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 以手动方式安装 (独立模式):
      • 在 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 以确保其正确运行并包含老版本的所有用户添加的重要定制资源。然后,重复上述步骤完成生产环境中的 Talend Runtime 迁移。
排错: 如果在迁移过程中或迁移之后遇到问题,请执行如下操作。
  • 检查两个版本的 Talend Runtimelog/tesb.log 下的错误日志。

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

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

本页面有帮助吗?

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