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

ロボット エージェントはキーファイル（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］を押してページを再読み込みします。

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