オンプレミスロボット エージェントのインストールまたはアップグレード

ロボット エージェントは、ロボット アプリでスケジュールされたタスクを実行します。エージェントは、会社のセキュアなローカル Windows サーバー上でデータ ソースの近くにあるネットワークの保護された境界内でタスクを実行します。

メモ

このトピックの情報は、オンプレミスのロボットエージェントを使用して、ACL ロボットで ACLスクリプトを実行する組織にのみ適用されます。

ACL Robotics Professional Edition を有する個人および組織にはオンプレミスロボット エージェントがありません。HighBond ロボットとワークフロー ロボットの Python/HCL スクリプトはロボット エージェントを使用しません。

一般情報

ロボットエージェントのインストールパッケージをダウンロードし、それを使って Windows サーバーにロボットエージェントをインストールします。また、このインストールパッケージを利用して、既存のロボットエージェントをアップグレードすることもできます。

キーファイル

インストール時に、登録キーファイル(registration.key)を用いてロボット エージェントを登録します。ロボット アプリでキーファイルを生成し、ロボット エージェントがインストールされている Windows サーバーにダウンロードします。

登録キーファイルは、ロボット エージェントとロボット アプリの間の初回接続時の認証に使用されます。以降の接続やデータの流れは、暗号化キー(RSA 公開キーと秘密キーのペア)で保護されます。RSA キーペアは、ロボット エージェントサービスの起動時に自動生成されます。

登録キーファイルと暗号化キーは、登録と接続の異なる段階で使用される別のオブジェクトです。

ロボット エージェントをアップグレードする場合、登録キーファイルは関係ないので、registration.key の新しいインスタンスを生成する必要はありません。

複数のエージェント

アナリティクスの処理能力を向上させ、負荷分散を実装するために、追加の Woindows サーバー上にロボットエージェントの追加インスタンスをインストールするオプションが用意されています。

ロボット エージェントの Windows サービスとアカウント

ロボット エージェントは、インストールされると、サーバーに 2 つの Windows サービスを展開します。

  • ロボット エージェントは、スケジュールされたタスクと臨時のロボットのタスクを実行します
  • ロボット データ サービスは、ユーザーが Analytics でロボット エージェント テーブルを開けるようにする接続を提供します

これらのサービスのいずれかが実行されない場合、提供される機能を利用できません。

ヒント

ロボットでタスクが長時間キューに残っていて、スキップされたか失敗した場合は、ロボット エージェント サービスが実行していることを確認してください。

Analytics でロボット エージェント テーブルを開こうとすると接続エラーが発生した場合は、ロボット データ サービスが実行していることを確認します。

サービス アカウントとポート

サービス アカウントを使用して、2 つのロボット エージェントの Windows サービスを実行します。アカウントに必要なログオン権限とアクセス権の詳細については、オンプレミス ロボット エージェントのセキュリティを参照してください。

メモ

ロボット エージェント をインストール後に Windows サービスのいずれかのプロパティを変更した場合は、その変更が反映されるようサービスを再起動する必要があります。

Windows サービス サービスを実行するアカウント ポート
ロボット エージェント サービス

インストール中、またはインストール後に指定されるドメインアカウント

443 アウトバウンド通信のみ
ロボットデータサービス ローカル システム 既定では 10000 ですが、インストール中とその後に設定可能

ロボットエージェントが認証局に接続できることを確認する

ロボットエージェントは、その真正性と完全性を検証するためにデジタル証明書を使用します。証明書は、検証できるように、サードパーティの認証局である DigiCert へのインターネット接続が必要です。ネットワークファイアウォールの背後にロボットエージェントをインストールする場合、ファイアウォールが DigiCert への証明書の接続を許可するように設定されている必要があります。必要な接続がない場合、ロボットエージェントは動作しません。

必要な場合は、組織の IT 部門と協力して、証明書と DigiCert の接続を許可するネットワークファイアウォールまたはプロキシサーバーを設定してください。ロボットエージェントの電子証明書は、以下の URL で DigiCert の証明書取り消しリストと OCSP サーバーに接続します。

  • http://cacerts.digicert.com
  • http://crl3.digicert.com
  • http://crl4.digicert.com
  • http://ocsp.digicert.com

より詳細な URL 情報については、インストール済みの証明書を検査できます。

インストール済みの証明書を確認する

ロボットエージェントのインストール後、インストールされた証明書を検査し、認証局の URL を確認します。

  1. ロボット エージェント インストール ディレクトリで、Agent.exe を右クリックして、[プロパティ]を選択します。

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

  2. Agent.exe プロパティ]ダイアログボックスで[デジタル署名]タブを選択します。
  3. 署名リスト]リストで Diligent Corporation をダブルクリックし、[証明書の表示]をクリックします。
  4. 証明書]ダイアログボックスの[詳細]タブで、次の各フィールドを選択します。
    • CRL 配布ポイント
    • 認証局情報アクセス

    各フィールドで、URL は、ダイアログボックスの下部にある表示領域に表示されます。

  5. 証明書]ダイアログボックスの[証明書パス]タブで、以下を実行します。
    1. 次の証明書パスの各項目を選択します。
      • DigiCert Trusted Root G4
      • DigiCert Trusted G4 コードが署名中です...
    2. 各項目について、[証明書を表示]をクリックします。
    3. 詳細] タブで、これらの各フィールドを選択します。
      • 認証局情報アクセス
      • CRL 配布ポイント

      各フィールドで、URL は、ダイアログボックスの下部にある表示領域に表示されます。

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

新規ユーザーとして初めてロボット エージェントをインストールする場合には、登録キー(registration.key)を生成する必要があります。登録キーファイルは、ロボット エージェントとロボット アプリの間の初回接続時の認証に使用されます。

既存のユーザーで、既にロボット エージェントをインストールして使用しているのであれば、ほとんどの場合、新しい登録キーファイルを生成する必要はありません。新しいファイルを生成することは、たいていは不要であり、組織のロボットインスタンスの設定に影響を与える可能性があります。

ロボット エージェントのステータス 登録キーファイルの生成
ロボット エージェントのフレッシュインストール、シングルエージェントインストール はい
マルチエージェントクラスターでのロボット エージェントの追加インスタンスのフレッシュインストール

いいえ

既存の登録キーファイルのコピー

詳細については、ロボットエージェントの追加インスタンスをインストールを参照してください。

現在インストールされているロボット エージェントのアップグレード

いいえ

登録キーファイルはアップグレードに関係ない

既存の登録キーファイルに問題があり、ロボット エージェントがロボット アプリに接続できない はい
現在インストールされているロボット エージェントを実行している Windows アカウントの変更

いいえ

登録キーファイルはアカウントの変更に関係ない

詳細については、ロボット エージェントのサービスアカウントを変更するを参照してください。

メモ

ロボット エージェント登録キーファイルを生成するには、エージェントの管理アクセス権が必要です。詳細については、ロボット アプリのアクセス許可を参照してください。

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

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

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

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

    注意

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

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

    メモ

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

ロボット エージェントをインストールする

ロボット エージェントのインストール パッケージを使い、ロボット エージェントの最新のインストールを実行します。

メモ

インストールを完了するには、Windows サーバーのローカル管理者権限が必要です。

ロボット エージェントのインストールとロボット エージェントサービスの実行に異なる Windows アカウントを使用する場合、インストールを開始する前にロボット エージェントサービスのアカウントのパスワードを確認してください。

ロボットエージェントをテスト

ロボットエージェントをインストールしたら、シンプルなスクリプトをコミットして実行し、ロボットエージェントが適切に動作していることをテストできます。

メモ

このテストでは、ロボットへのファイルのアップロードが許可されている必要があります。必要に応じて、一時的にテスト用にファイルのアップロードを有効にします。詳細については、オンプレミスロボット エージェントの設定を参照してください。

ロボット エージェントをアップグレードする

ロボット エージェントのインストールパッケージを使用して、既存のロボット エージェントのインストールをバージョン 17.0 にアップグレードしてください。

アップグレードを実行する前に、ロボットのタスクが実行中である、キューに追加される、または間もなく実行するようスケジュールされていることがないようにしてください。

メモ

アップグレードを完了するには、Windows サーバーのローカル管理者権限が必要です。

ロボットエージェントの追加インスタンスをインストール

ロボットエージェントのインストールパッケージを使用し、追加のWindows サーバー上にロボットエージェントの追加インスタンスをインストールします。

複数のエージェントをインストールすると、アナリティクスの処理能力が向上し、エージェント全体に負荷分散を実装できます。複数のロボットのタスクを同時に実行する場合、アナリティクススクリプトの処理は、複数の Wiindows サーバー上の複数のエージェント間で自動的に分配されます。この機能により、より短期間により多くの数のタスクを実行できます。

メモ

複数のエージェント機能は、ロボットの開発モードと本稼働モードとは関係がありません。タスクを実行する際は、どちらのモードでもすべてのエージェントに同等にアクセスできます。