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

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

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

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

手動登録が必要な状況

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

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

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

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

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

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

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

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

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

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

1. Diligent One（www.highbond.com） にサインインします。
2. Launchpad ホームページの［監査とアナリティクス］の下で、ロボット アプリをクリックします。
3. ダッシュボードの右上隅で［設定］をクリックします。
4. 左側のペインで、［エージェント管理］が選択されていることを確認します。
5. ロボットのインスタンスが現在クラウドベースのロボットエージェントを使用している場合は、以下を実行します。
   1. ［クラウド エージェントを交換する］をクリックします。
   2. ［エージェントを登録し、キーを生成する］をクリックします。
6. ロボットのインスタンスが現在オンプレミスのロボットエージェントを使用している場合、またはロボットエージェントが指定されていない場合は、以下を実行します。
   1. ［新しい登録キーを生成する］をクリックします。

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

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

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

   注意

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

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

   メモ

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

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

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

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

   です。

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

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

   メモ

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

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

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

   ログファイルのデフォルトの場所は、次のとおりです。C:\acl\robots\logs\application.log

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

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