Talend Runtimeのフルインストールの自動移行(推奨)

既存のRuntimeから新しいLTSバージョンに設定とインストール済み機能を自動的に移行できるよう、専用の移行ツールが提供されています。

始める前に

お使いのランタイムバージョンは7.3以降で、ターゲットバージョンは7.3ベースラインのままです。
推奨されるアプローチはアップグレードパッチの適用であるものの、あまりにも複雑で実行不可能であるため、Talendからフルインストーラーを受信済みであること。
Talend Runtimeの新しいバージョンをインストール済みであること。この新しいバージョンはアップグレード前のバージョンと同じ方法でインストールします。つまり、新バージョンと旧バージョンをサービスとしてインストールするか、両方をスタンドアロンプログラムとして所定のディレクトリーに解凍する必要があります。

このタスクについて

この移行はまず非本番環境で行い、出力に旧バージョンの重要なカスタムリソース(特に手動でインストールされたもの)がすべて含まれ、完全に機能することを確認しておきます。
この記事では、移行ツールはmigrationというフォルダーに保存されています。必要であれば他のディレクトリーに保存することもできます。

手順

アップグレードする Talend Runtimeが実行中であることを確認します。

使用しているオペレーティングシステムとRuntimeのインストール方法に応じて、次のいずれかのコマンドを使い、提供された移行ツールを実行します。

Talend Runtimeがサービスとしてインストールされている場合:

Windowsの場合は、移行ディレクトリーでAdministrator権限で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 Runtimeの両バージョンのlog/tesb.logにあるエラーログを確認します。
Windowsでは、スクリプト行の前にあるPowerShellに$DebugPreference = 'Continue'を追加すれば、特定のデバッギングログを生成できます。
移行中にエラーが発生した場合は、以下の手順でロールバックします。
1. 新しい Talend Runtimeエンジンを停止します。
2. 古いエンジンを開始します。

移行を再開する時は、次の操作を行います。

Talend Runtimeの古いインスタンスと新しいインスタンスを停止します。
Talend Runtimeの新しいバージョンをいちど削除して再インストールします。
log/tesb.logファイルをクリアします。
Talend Runtimeの古いインスタンスを再起動し、上記の説明に従って移行スクリプトを実行します。

このページは役に立ちましたか?

このページまたはコンテンツにタイポ、ステップの省略、技術的エラーなどの問題が見つかった場合はお知らせください。

こちらにフィードバックをお寄せください