# 専用のWebサービスを使用したリモートエンジンのペアリングまたは再ペアリング

ペアリングに使用する事前認証キーであるリモートエンジンキーを取得し、専用のウェブサービスを開いてエンジンのペアリングを行います。以前にペアリングされたエンジンを再ペアリングする場合、推奨される方法はエンジンを完全に再インストールすることです。

情報メモヒント: エンジンの再ペアリング時に、エンジンの再インストールが不可能な場合は、最終手段としてこの[Troubleshooting](https://help.qlik.com/talend/ja-JP/remote-engine-user-guide-linux/Cloud/pairing-remote-engines-using-web-service#repair-without-reinstall)を参照してください。

このセクションは以下の状況に適用されます:

* エンジンのインストール時にペアリングキーを提供しなかったため、Talend Management Consoleでエンジンを論理エンティティとペアリングするキーを手動で取得する必要がある。
* エンジンを再インストールする必要がある。
* Talend Management Consoleの論理エンティティとエンジンの物理エンティティ間で接続の問題が発生した。

インストーラーを使ってRemote Engineをインストールし、インストールプロセスでエンジンを既に定義している場合、このペアリングは既にセットアップされています。このセクションは無視して構いません。

## 始める前に

* Remote Engineをインストール済みであること。
* Talend Management ConsoleでRemote Engineの論理エンティティを作成済みであること。

## 手順

1. お使いのマシンでTalend Remote Engineコンソールを起動(trun )します。
2. Talend Management Consoleを開きます。
3. [Processing] (処理中)ページを開き、[Engines] (エンジン)タブをクリックします。
4. [Environment] (環境)ドロップダウンリストで、エンジンの環境を選択します。

   また、検索ボックスやフィルターオプションを使ってリストをフィルタリングすることもできます。
5. エンジンリストで、ペアリングをリセットしたいRemote Engineをクリックします。
6. 表示される[Engine details] (エンジンの詳細)ブレードで、[Manage] (管理)タブをクリックします。
7. ペアリングキーをコピーします。

   エンジンのペアリング状態に応じて、さまざまな情報が[Manage] (管理)タブに表示されます。
   * エンジンがペアリングされていない場合は、[Remote Engine key] (リモートエンジンキー)フィールドからキーをコピーします。 ![\[Engine details\] (エンジンの詳細)ウィンドウに表示されるRemote Engineキーのスクリーンショット。](https://help.qlik.com/talend/ja-JP/remote-engine-user-guide-linux/Resources/images/tmc-re-creation.png)
   * エンジンがペアリングされているものの、再インストールや接続問題の修復のためにキーをリセットしてエンジンを再ペアリングする必要がある場合は、次の手順を実行します:
     1. [Reset the connection] (接続をリセット)セクションで[Reset the key] (キーをリセット)をクリックし、対応するウィザードを開きます。 ![Remote Engineペアリングキーのリセットのスクリーンショット。](https://help.qlik.com/talend/ja-JP/remote-engine-user-guide-linux/Resources/images/tmc-managing-engine-tab.png)

     2. ウィザードの最初のウィンドウで、[Reset key] (キーをリセット)をクリックします。

        このウィンドウには、キーをリセットすることでタスクやプランに起こる影響に関する情報が表示されます。

        ![Remote Engineペアリングキーのリセットに関する情報ウィンドウのスクリーンショット。](https://help.qlik.com/talend/ja-JP/remote-engine-user-guide-linux/Resources/images/tmc-reset-pairing-key-information.png)

     3. ジョブデバッギング用のリモートサーバーとしてエンジンのIPアドレスを手動で入力した場合、そのIPは持続し、接続のリセット中に動的に取得されたIPアドレスを上書きする可能性があります。

        ジョブデバッギング用のIPを自動的にアップデートするためには、[Reset debug configuration] (デバッグ設定をリセット)を選択し、既存のデバッグ設定をクリアします。

        Talend Remote Engineのデバッグ実行設定の詳細は、[ジョブデバッギング用にリモート実行を有効化](https://help.qlik.com/talend/ja-JP/remote-engine-user-guide-linux/Cloud/enabling-remote-run-in-talend-studio)をご覧ください。

     4. 2番目のウィンドウで、新しいペアリングキーをコピーします。

        このペアリングキーは事前認証キーとも呼ばれ、Remote Engineの設定でそのエンジンへの接続を設定するために使用されます。
8. http://localhost:8043/configurationにアクセスします。
9. 対応するフィールドにキーを貼り付けます。
10. [Pair Remote Engine] (Remote Engineのペアリング)をクリックします。
11. listと入力してEnterキーを押します。

    すべてのバンドルは[Active] (アクティブ)ステータスになります。

## タスクの結果

Remote Engineがアカウントとペアリングされ、ステータスがTalend Management Console上の[Paired] (ペアリング済み)に変更されました。

Remote Engineによるタスクを実行ランタイムとして実行する場合は、エンジンが置かれているスペースにの右側にオペレーター(実行)があることをご確認ください。

エンジンで使用されているJavaバージョンを知る必要がある場合は、[Engine details] (エンジンの詳細)ブレードで[Configuration] (設定)タブをクリックします。そこで、起動に使用されるバージョンTalend Remote Engineと、タスクおよびプランの実行に使用されるJavaバージョンを確認できます。Talend Remote Engineはデフォルトで、起動時と同じJavaを使ってタスクやプランを実行します。

トラブルシューティング:

再インストールなしでのTalend Remote Engineの再ペアリング:

Remote Engineを再ペアリングする公式の推奨方法は、完全な再インストールを実行することです。完全な再インストールが実行不可能な場合にのみ、最終手段のトラブルシューティング手順として次の手順を使用してください。

1. エンジンを正常にシャットダウンします。手順は、[Remote Engineの安全なシャットダウンプロセスを実行](https://help.qlik.com/talend/ja-JP/remote-engine-user-guide-linux/Cloud/gracefull-remote-engine-shutdown "安全なシャットダウンコマンドを使えば、制御され秩序あるシャットダウン処理を確実に実行できます。")をご覧ください。
2. <engine\_installation>/etc/org.talend.ipaas.rt.pairing.agent.cfg内で、remote.engine.idプロパティの値をクリアします。
3. <engine\_installation>/etc/preauthorized.key.cfg内で、remote.engine.pre.authorized.keyプロパティの値として新しい事前認証キーを設定します。
4. <engine\_installation>/data/cacheディレクトリを削除します。
5. Remote Engineを起動し、このトピックの手順を使用してペアリングします。