オンプレミスのロボット エージェントを手動で登録する

ロボット エージェントはキーファイル（registration.key）を使用して登録する必要があります。通常は、インストールプロセスの一環としてロボット エージェントを登録します。ただし、状況によっては、インストールとは別にエージェントを手動で登録するか、エージェントを再登録する必要があります。

ロボット エージェントを手動で登録するには、次の 2 つの別個の手順が必要です。

1. 登録キーファイルを生成してダウンロードする。
2. ロボット エージェントディレクトリ構造に登録キーファイルを手動でインストールして起動するか、ロボット エージェントサービスを再起動する。

手動登録が必要な状況

以下の状況では、ロボット エージェントの手動登録または再登録が必要です。

• インストール後にサービス アカウントを変更ロボット エージェントのインストール中に、［登録ファイルをコピー］を選択解除したままにします。インストールの完了後、ロボット エージェントサービスの実行に使用するアカウントを直ちに更新する。
• サーバー IP を変更済みロボット エージェントが実行されている Windows サーバーの IP アドレスが変更された。
• キーファイルの問題既存の登録キーファイルに何らかの問題がある。

手動登録が必要でない状況

以下の場合、既存のロボット エージェントを手動で再登録したり、新しい登録キーファイルを生成したりするべきではありません。

• 本番サービス アカウントを変更インストール済みのロボット エージェントを稼働しているサービス アカウントを変更する必要があります。詳細については、「ロボット エージェントのサービスアカウントを変更する」を参照してください。
• ロボット エージェントをアップグレードするロボット エージェントをアップグレードする場合、登録キーファイルは関係ありません。

このような状況では、新しい登録キーファイルを生成する必要はなく、生成すると組織のロボット インスタンスの設定を混乱させる可能性があります（以下に説明します）。

登録キーを再生成する場合の影響

既に使用されているロボット エージェントの登録キーを再生成すると、以下のような影響があります。

• ロボット タスクに保存されたすべてのパスワードが削除され、再入力する必要がある。
• ［エージェント管理］画面のエージェントの一覧からすべてのエージェントが削除される。
• 複数エージェントのインストールでは、サーバー間でのロボット エージェント RSA 鍵の移行を含め、すべてのエージェントを再登録する必要がある。

ロボット エージェント登録キーファイルを生成する

1. プラットフォーム ホームページ (www.diligentoneplatform.com) から、ロボット アプリを選択して開きます。

   すでに Diligent One を使用している場合は、左側のナビゲーション メニューを使用してロボット アプリに切り替えることができます。

2. ダッシュボードの右上隅で［設定］をクリックします。

3. 左側のペインで、［エージェント管理］が選択されていることを確認します。

4. ロボットのインスタンスが現在クラウドベースのロボットエージェントを使用している場合は、以下を実行します。

   1. ［クラウド エージェントを交換する］をクリックします。

   2. ［エージェントを登録し、キーを生成する］をクリックします。

5. ロボットのインスタンスが現在オンプレミスのロボットエージェントを使用している場合、またはロボットエージェントが指定されていない場合は、以下を実行します。

   1. ［新しい登録キーを生成する］をクリックします。

      表示される警告ダイアログボックスは、1 つ以上の既存のオンプレミスエージェントがすでにインストールされている場合に適用されます。

   2. ［新しい登録キーを生成する］をクリックします。

6. ［キーファイルをダウンロードして、閉じる］をクリックします。

   注意

   鍵ファイルをダウンロードするまで、ブラウザー ウィンドウを閉じないでください。

7. ダウンロードしたキーファイルを、ロボット エージェントがインストールされている Windows サーバーの安全な場所に保存してください。

   メモ

   キーファイルの生成は、ロボットエージェントを登録する最初の部分です。ロボット エージェントのディレクトリ構成の適切な場所にキーファイルを格納して、ロボット エージェント サービスを起動または再起動し、ロボット アプリに正常に接続すると、登録プロセスは完了となります。

登録キーファイルを手動でインストールする

1. ロボットエージェントが動作している Windows サーバー上で、登録キーファイルを保存した場所からコピーします。
2. ロボット エージェントのインストール ディレクトリに移動し、agent サブフォルダに登録用キー ファイルを貼り付けます。

   デフォルトのインストール ディレクトリーは C:\Program File (x86)\ACL Software\Robots Agent\agent です。

   必要に応じて、既存のキーファイルを削除または上書きします。

3. Windows サービス マネージャーで、ロボット エージェント サービスを再起動します。

   メモ

   サービスを再起動しない場合は、アナリティクス スクリプトが実行しません。

4. アプリケーション ログ ファイルを確認し、ロボット エージェントがロボット アプリに正常に接続されていることを確認します。

   ログファイルの末尾に、ロボット エージェント サービスの開始日時と一致する INFO|Connected エントリがあるかどうかを確認します。

   ログ ファイルのデフォルト ロケーションは、C:\acl\robots\logs\application.log です。

5. ロボットアプリで［エージェント管理］画面に進み、［F5］を押してページを再読み込みします。

   ロボット エージェントが［オンライン］状態でが表示されていれば、正常に登録されています。