オンプレミスロボット エージェントの設定

ロボットエージェントのデフォルトの構成はインストール時に設定されます。ロボットエージェントを使用する前に、構成の設定をレビューし、これが組織に適していることを確認してください。特に、許可されたファイル アップロードが適切に設定されていることを確認します。

メモ

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

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

構成設定の指定場所

ロボットエージェントの構成設定は、2 つの場所で指定します。

  • ロボットのエージェント管理画面

  • Windows サーバー上のロボットエージェントのインストールディレクトリにある Agent.exe.config ファイル

エージェント管理画面の構成設定

メモ

エージェント管理画面の構成設定は、マルチエージェントクラスターのすべてのエージェントに適用されます。

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

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

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

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

  4. 構成]から、[許可されたファイル アップロード]に適切なオプションを選択します。

    許可されたファイル アップロードは、クラウドのロボットエージェントからロボットアプリに対し、どの出力結果がアップロードされるかを制御します:

    • 結果ファイルとログのみ

      アナリティクスヘッダーで指定されている場合は、結果ファイル(Excel など)とログがアップロードされます。関連ファイルをロボットの[入力/出力]タブに手動でアップロードすることもできます。

    • 結果テーブル、ファイル、ログ

      アナリティクスヘッダーで指定された場合、Analytics の結果テーブル、結果ファイル(Excel など)、およびログがアップロードされます。関連ファイルをロボットの[入力/出力]タブに手動でアップロードすることもできます。

    • ファイル アップロードは許可されていません

      どのファイルもスクリプトで、またはユーザーが手動でアップロードすることはできません。//RESULT FILE タグまたは //RESULT LOG タグを含むアナリティクス スクリプトが実行されません。

      すべてのファイル タイプのアップロードも防ぐには、どのような状況でも、ロボット エージェントの AllowUploadsOnFailure 設定を false に設定する必要があります。

    メモ

    許可されたファイル アップロード]でどのオプションを選択したかにかかわらず、ロボット タスクの失敗後のログ ファイルのアップロードは、ロボット エージェントの AllowUploadsOnFailure 構成設定によって制御されます。詳細については、「 」参照してください。

  5. 構成]の下で、[パスの設定]に該当するディレクトリを指定し、[保存]をクリックします。

    • データ ストレージ

      //DATA タグでアナリティクススクリプトによって出力される、Analytics データテーブルの永続ストレージ用 Windows サーバーまたはネットワークディレクトリ。

      データテーブル のディレクトリが別々になっていることにより、定期的にのみアクセスする大規模ファイルに対し、もっと経済的なコールドストレージロケーションを指定できます。

    • 結果パス

      //RESULT TABLE タグでアナリティクス スクリプトによって出力される、Analytics の結果テーブル向け Windows サーバーまたはネットワーク ディレクトリ。

    重要

    構成]の下で指定したディレクトリにはロボット エージェントまたはすべてのエージェント(マルチエージェント クラスターを使用している場合)からアクセスできる必要があります。指定したディレクトリごとに、エージェントを実行するサービス アカウントに対して読み取り/書き込み/リスト権限を付与する必要があります。詳細については、オンプレミス ロボット エージェントのセキュリティを参照してください。

Agent.exe.config ファイルで設定を構成

構成の設定を更新するには、ロボットエージェントのインストールディレクトリにある Agent.exe.config ファイルを編集し、次にロボットエージェント Windows サービスを再起動します。

構成ファイルのデフォルトロケーション:

C:\Program Files (x86)\ACL Software\Robots Agent\agent\Agent.exe.config.

メモ

変更が有効になるように、ロボット エージェント サービスを再起動する必要があります。

マルチエージェントのインストールでは、Agent.exe.config ファイルを更新し、ロボットエージェントサービスを各Windows サーバーで再起動する必要があります。各エージェントの構成設定は、お客様の特定のニーズに応じて、同一または異なることができます。

Agent.exe.config における構成プロパティ

キー
RuntimeBasePath

基本フォルダ:

  • 一時的なアナリティクスジョブフォルダー

  • //RESULT FILE タグでアナリティクススクリプトによって出力される Analytics 以外の結果ファイル

  • //RESULT LOG タグでアナリティクススクリプトによって出力される Analytics のログファイル

  • 失敗したアナリティクススクリプトによって出力される Analytics のログファイル

デフォルトのベース フォルダーは C:\acl\robots\data\ です。

ランタイム基本フォルダーが別々になっているため、ソリッドステートドライブ (SSD) のような高速の高パフォーマンスドライブ上で処理するアナリティクスジョブを探すことができます。

ユーザー設定のベース フォルダーを含むアナリティクス ジョブ フォルダーのフル パスの例:E:\acl\robots\runtime\Production\Robot12\Task1\Run29\Temp

DataBasePath

//DATA タグでアナリティクススクリプトによって出力される、Analytics データテーブルの永続ストレージ用基本フォルダー。

デフォルトのベース フォルダーは C:\acl\robots\data\ です。

Analytics データテーブルの基本フォルダーが別々になっていることにより、定期的にのみアクセスする大規模ファイルに対し、もっと経済的なコールドストレージロケーションを指定できます。

ユーザー設定のベース フォルダーを含むデータ ファイル フォルダーのフル パスの例:D:\acl\robots\data\Production\Robot12\Data

メモ

ロボットのエージェント管理画面の DataBasePath と[データ ストレージ]設定で異なる値を指定した場合は、エージェント管理画面の値が優先されます。

詳細については、「 」を参照してください。

ResultsBasePath

//RESULT TABLE タグでアナリティクススクリプトによって出力される、Analytics の結果テーブル向け基本フォルダー。

デフォルトのベース フォルダーは C:\acl\robots\data\ です。

ユーザー設定のベース フォルダーを含む結果フォルダーのフル パスの例:C:\acl\robots\results\Production\Robot12\Task1\Run29\Results\Prohibited transactions

メモ

ロボットのエージェント管理画面の ResultsBasePath と[結果パス]設定で異なる値を指定した場合は、エージェント管理画面の値が優先されます。

詳細については、「 」を参照してください。

AclSEProfileBase

ロボットデータサービスを使用して、Analytics からロボットエージェントに接続する際のテーブル作業用の基本フォルダー。

デフォルトのベース フォルダーは C:\acl\robots\aclse\ です。

LogFile

ロボットエージェントのログファイルのファイルパスと名前。

デフォルトのパスと名前は C:\acl\robots\logs\application.log です。

EnginePath

タスクを実行する実行可能ファイルのファイル パス。

デフォルトの場所は C:\Program Files (x86)\ACL Software\Robots Agent\AclScript.exe です。

KeepJobFolder

ロボットのタスクが失敗した場合は、一時 Analytics ジョブフォルダーを保持するかどうかを指定します。

  • タスクの失敗後も一時 Analytics ジョブフォルダーは保持されます。

  • タスクの失敗後に一時 Analytic ジョブフォルダーは削除されます

    デフォルト値は false です。

メモ

ロボットのタスクが正常に実行された場合は、KeepJobFolder 設定による影響はありません。タスクが正常に実行されると、一時 Analytics ジョブフォルダーは自動的に削除されます。

注意

値を true に設定し、トラブルシューティングの目的でファイルを保持できます。値を永続的に true と設定したままにすると、サーバーのハードドライブ、すなわちソリッドステートドライブが容量不足になる場合があります。

AllowExecuteCommand

EXECUTE と AICOMMAND の 2 つの ACLScript コマンドがアナリティクス スクリプトで発生した場合に、ロボット エージェントがコマンドをどのように処理するかを指定します。

  • コマンドが処理されます

  • コマンドが処理されず、いずれかのコマンドを含むスクリプトが失敗します

    デフォルト値は false です。

    失敗の理由を説明したメッセージがログに書き込まれます。

MaxLogSizeKB

ファイルがアーカイブされ、新しいログファイルが作成される前のロボットエージェントのログファイルの最大サイズ。

デフォルト値は 102400 (100 MB) です。

現在のログファイルは application.log です。アーカイブされたログファイルが現在のログファイルと同じフォルダーに保存され、増分の数値サフィックス:application.0.logapplication.1.log など。

SkipPathAccessCheck

ロボット エージェントがテーブルやファイルで読み取りまたは書き込みを行う際にアクセスできるフォルダーを制御します。

  • フォルダー アクセスはチェックされません。ロボット エージェントが実行するスクリプトは、任意の ACL ロボットのテーブルまたはファイルで読み取りまたは書き込みができます。

  • フォルダー アクセスはチェックされます。ロボット エージェントが実行するスクリプトは、スクリプトと同じロボット内のテーブルまたはファイルのみで読み取りまたは書き込みができます。

    デフォルト値は false です。

この値を true に設定し、フォルダーアクセスのチェックをスキップすることで、環境によってはロボット エージェントがスクリプトを実行する際のパフォーマンスが向上する可能性があります。また、ロボット全体で読み取りまたは書き込みの操作を実行できるようになります。

注意

スクリプトがアクセスできるフォルダーを制限することは、偶発的または意図的なデータアクセス違反を防止するロボットのセキュリティ機能です。ACL スクリプトが任意の ACL ロボットのテーブルやファイルでの読み取りまたは書き込みを許可しても、セキュリティ上のリスクを引き起こさないと確信できる場合のみ、値を true に設定します。

メモ

SkipPathAccessCheck の設定は、ロボット間で特定の Analytics データテーブルを共有したりリンクしたりする機能には影響しません。詳細については、「ACL ロボットでのデータ テーブルの共有と関連付け」を参照してください。

AllowUploadsOnFailure

ロボット タスクが失敗した場合に、アナリティクス結果ログをロボット エージェントからクラウド内のロボット アプリにアップロードするかどうかを指定します。

  • タスクの失敗後にログ ファイルがアップロードされます。

  • タスクの失敗後にログ ファイルがアップロードされません。

    デフォルト値は trueです。

メモ

AllowUploadsOnFailure プロパティが Agent.exe.config ファイルに存在しない場合は、手動で追加し、組織の要件に応じて値を true または false に設定します。

例:

<add key="AllowUploadsOnFailure" value="true"></add>

特定のプロキシ サーバーと動作するようにロボット エージェントを構成する

指定したプロキシ サーバーを使用して、ロボット アプリに接続するように、ロボット エージェントを手動で構成できます。手動構成を実行するには、次の手順を実行する必要があります。

  • Agent.exe.config ファイルに追加のセクションを追加する

  • AgentService.exe.configWorker.exe.config という 2 つの追加の設定ファイルを更新します。

手順

  1. ロボット エージェントがインストールされているサーバーで、ロボット エージェント インストール ディレクトリに移動します。

    インストール ディレクトリのデフォルトの場所:

    C:\Program Files (x86)\ACL Software\Robots Agent\agent\

  2. 以下のテーブルを参照して、\agent サブフォルダ内の構成ファイルを更新してください。

  3. すべてのファイルを保存した後、ロボット エージェント Windows サービスを再起動し、指定したプロキシ サーバーを使用して、ロボット エージェントとロボット アプリの間の通信を開始します。

メモ

異なるプロキシ サーバー設定が可能です。次の構成情報の例は、お客様の要件と正確には一致しない場合があります。詳細については、Microsoft テクニカル ドキュメントを参照してください。

ファイル名構成情報
Agent.exe.config

例で示される場所に <system.net> セクションを追加して、このファイルを更新します。

  • 組織の適切なプロキシ サーバー アドレスとポートを入力します。

  • useDefaultCredentials="true" は、Robots Agent Windows サービスを実行するアカウントの資格情報がプロキシ サーバーにアクセスするために使用されることを指定します。

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <appSettings>
        <other configuration settings>
    </appSettings>
    <system.net>
        <defaultProxy useDefaultCredentials="true">
            <proxy proxyaddress="プロキシ サーバー アドレス:ポート" bypassonlocal="true" />
        </defaultProxy>
    </system.net>
</configuration>

AgentService.exe.config

Worker.exe.config

これらのファイルの両方で、以下に示す例に基づいて <defaultProxy> セクションを更新します。

  • 組織の適切なプロキシ サーバー アドレスとポートを入力します。

  • useDefaultCredentials="true" は、Robots Agent Windows サービスを実行するアカウントの資格情報がプロキシ サーバーにアクセスするために使用されることを指定します。

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <system.net>
        <defaultProxy useDefaultCredentials="true">
            <proxy proxyaddress="プロキシ サーバー アドレス:ポート" bypassonlocal="true" />
        </defaultProxy>
    </system.net>
</configuration>