オンプレミスロボット エージェントの設定
ロボットエージェントのデフォルトの構成はインストール時に設定されます。ロボットエージェントを使用する前に、構成の設定をレビューし、これが組織に適していることを確認してください。特に、許可されたファイル アップロードが適切に設定されていることを確認します。
メモ
このトピックの情報は、オンプレミスのロボットエージェントを使用して、ACL ロボットで ACLスクリプトを実行する組織にのみ適用されます。
ACL Robotics Professional Edition を有する個人および組織にはオンプレミス ロボット エージェントがありません。HighBond ロボットとワークフロー ロボットの Python/HCL スクリプトはロボット エージェントを使用しません。
構成設定の指定場所
ロボットエージェントの構成設定は、2 つの場所で指定します。
ロボットのエージェント管理画面
Windows サーバー上のロボットエージェントのインストールディレクトリにある Agent.exe.config ファイル
エージェント管理画面の構成設定
メモ
エージェント管理画面の構成設定は、マルチエージェントクラスターのすべてのエージェントに適用されます。
プラットフォーム ホームページ (www.diligentoneplatform.com) から、ロボット アプリを選択して開きます。
すでに Diligent One を使用している場合は、左側のナビゲーション メニューを使用してロボット アプリに切り替えることができます。
ダッシュボードの右上隅で[設定]をクリックします。
左側のペインで、[エージェント管理]が選択されていることを確認します。
[構成]から、[許可されたファイル アップロード]に適切なオプションを選択します。
許可されたファイル アップロードは、クラウドのロボットエージェントからロボットアプリに対し、どの出力結果がアップロードされるかを制御します:
結果ファイルとログのみ
アナリティクスヘッダーで指定されている場合は、結果ファイル(Excel など)とログがアップロードされます。関連ファイルをロボットの[入力/出力]タブに手動でアップロードすることもできます。
結果テーブル、ファイル、ログ
アナリティクスヘッダーで指定された場合、Analytics の結果テーブル、結果ファイル(Excel など)、およびログがアップロードされます。関連ファイルをロボットの[入力/出力]タブに手動でアップロードすることもできます。
ファイル アップロードは許可されていません
どのファイルもスクリプトで、またはユーザーが手動でアップロードすることはできません。//RESULT FILE タグまたは //RESULT LOG タグを含むアナリティクス スクリプトが実行されません。
すべてのファイル タイプのアップロードも防ぐには、どのような状況でも、ロボット エージェントの AllowUploadsOnFailure 設定を false に設定する必要があります。
[構成]の下で、[パスの設定]に該当するディレクトリを指定し、[保存]をクリックします。
データ ストレージ
//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 | 基本フォルダ:
デフォルトのベース フォルダーは 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 |
| ResultsBasePath | //RESULT TABLE タグでアナリティクススクリプトによって出力される、Analytics の結果テーブル向け基本フォルダー。 デフォルトのベース フォルダーは C:\acl\robots\data\ です。 ユーザー設定のベース フォルダーを含む結果フォルダーのフル パスの例:C:\acl\robots\results\Production\Robot12\Task1\Run29\Results\Prohibited transactions |
| 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 ジョブフォルダーを保持するかどうかを指定します。
メモ ロボットのタスクが正常に実行された場合は、KeepJobFolder 設定による影響はありません。タスクが正常に実行されると、一時 Analytics ジョブフォルダーは自動的に削除されます。 注意 値を true に設定し、トラブルシューティングの目的でファイルを保持できます。値を永続的に true と設定したままにすると、サーバーのハードドライブ、すなわちソリッドステートドライブが容量不足になる場合があります。 |
| AllowExecuteCommand | EXECUTE と AICOMMAND の 2 つの ACLScript コマンドがアナリティクス スクリプトで発生した場合に、ロボット エージェントがコマンドをどのように処理するかを指定します。
|
| MaxLogSizeKB | ファイルがアーカイブされ、新しいログファイルが作成される前のロボットエージェントのログファイルの最大サイズ。 デフォルト値は 102400 (100 MB) です。 現在のログファイルは application.log です。アーカイブされたログファイルが現在のログファイルと同じフォルダーに保存され、増分の数値サフィックス:application.0.log、application.1.log など。 |
| SkipPathAccessCheck | ロボット エージェントがテーブルやファイルで読み取りまたは書き込みを行う際にアクセスできるフォルダーを制御します。
この値を true に設定し、フォルダーアクセスのチェックをスキップすることで、環境によってはロボット エージェントがスクリプトを実行する際のパフォーマンスが向上する可能性があります。また、ロボット全体で読み取りまたは書き込みの操作を実行できるようになります。 注意 スクリプトがアクセスできるフォルダーを制限することは、偶発的または意図的なデータアクセス違反を防止するロボットのセキュリティ機能です。ACL スクリプトが任意の ACL ロボットのテーブルやファイルでの読み取りまたは書き込みを許可しても、セキュリティ上のリスクを引き起こさないと確信できる場合のみ、値を true に設定します。 メモ SkipPathAccessCheck の設定は、ロボット間で特定の Analytics データテーブルを共有したりリンクしたりする機能には影響しません。詳細については、「ACL ロボットでのデータ テーブルの共有と関連付け」を参照してください。 |
| AllowUploadsOnFailure | ロボット タスクが失敗した場合に、アナリティクス結果ログをロボット エージェントからクラウド内のロボット アプリにアップロードするかどうかを指定します。
メモ AllowUploadsOnFailure プロパティが Agent.exe.config ファイルに存在しない場合は、手動で追加し、組織の要件に応じて値を true または false に設定します。 例: <add key="AllowUploadsOnFailure" value="true"></add> |
特定のプロキシ サーバーと動作するようにロボット エージェントを構成する
指定したプロキシ サーバーを使用して、ロボット アプリに接続するように、ロボット エージェントを手動で構成できます。手動構成を実行するには、次の手順を実行する必要があります。
Agent.exe.config ファイルに追加のセクションを追加する
AgentService.exe.config と Worker.exe.config という 2 つの追加の設定ファイルを更新します。
手順
ロボット エージェントがインストールされているサーバーで、ロボット エージェント インストール ディレクトリに移動します。
インストール ディレクトリのデフォルトの場所:
C:\Program Files (x86)\ACL Software\Robots Agent\agent\
以下のテーブルを参照して、\agent サブフォルダ内の構成ファイルを更新してください。
すべてのファイルを保存した後、ロボット エージェント Windows サービスを再起動し、指定したプロキシ サーバーを使用して、ロボット エージェントとロボット アプリの間の通信を開始します。
メモ
異なるプロキシ サーバー設定が可能です。次の構成情報の例は、お客様の要件と正確には一致しない場合があります。詳細については、Microsoft テクニカル ドキュメントを参照してください。
| ファイル名 | 構成情報 |
|---|---|
| Agent.exe.config | 例で示される場所に <system.net> セクションを追加して、このファイルを更新します。
<?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> セクションを更新します。
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<system.net>
<defaultProxy useDefaultCredentials="true">
<proxy proxyaddress="プロキシ サーバー アドレス:ポート" bypassonlocal="true" />
</defaultProxy>
</system.net>
</configuration> |