注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

Agent 設定リファレンス

以下のセクションでは、ネットワーク内で Agent を作成、監視、管理する際に利用可能な各種設定について説明します。次のワークフローを説明します。

Agent の権限
プロキシ設定
Agent のメトリクスと健全性の監視
- メトリクス
  - 「次回の有効期限までの時間」メトリクス
- 健全性の監視
自動アップグレードウィンドウ
Agent を再インストールする
Agent を新しいディレクトリに移動する
Agent を新しいホストに移動する
Windows ホストにインストールする
バックアップとキャッシュ
ホストのオーバーライドを設定する

Data Connection アプリケーションの Agent とそのセットアップ方法について、詳しくはこちらをご覧ください。

Agent の権限

2023年5月27日より前にプロビジョニングされたエンロールメントでは、権限の管理方法が異なる場合があります。これらのエンロールメントでの Agent 管理についてご質問がある場合は、Palantir サポートにお問い合わせください。

Control Panel で Agent 作成の管理を開始するには、組織管理者の権限を持つユーザーに、Agent 作成の認証方法を変更という追加のワークフローを付与する必要があります。このワークフロー権限により、管理者はロールベースの Agent 作成管理の厳格な適用を有効にできます。上記の日付より後にプロビジョニングされたエンロールメントには、これが自動的に適用されます。

Agent を作成する権限は、Control Panel で管理されます。Agent を作成するには、組織管理者またはデータフロー管理者のいずれかのロールが割り当てられている必要があります。カスタムロールを作成し、そのロールに Agent を作成ワークフローを割り当てることもできます。組織のロールは、Control Panel の組織権限ページで管理されます。

Control Panel でのロール管理について詳しくはこちら。

組織レベルのロールに加えて、新しく作成した Agent を保存するプロジェクトの編集者または所有者である必要があります。

作成後は、プロジェクトベースのロールを使用して、Agent を閲覧、変更、削除できるユーザーや、特定のソースのワーカーとして Agent を割り当てられるユーザーを制御します。そのため、Agent の作成者は、Agent が保存されるプロジェクトに適切なロールが設定されていることを確認してください。

証明書

Agent は Foundry と内部ネットワークの両方と通信します。そのため、これらの接続を確立するには、Agent のトラストストアに適切な証明書が必要です。

Agent に追加の証明書を設定する必要がある状況は、次の2つです。

Agent と Foundry 間の通信を可能にする証明書
Agent とシステム間の通信を可能にする証明書（Agent ワーカーのみ）

いずれの場合も、Data Connection アプリケーションの Agent 管理ページから証明書を追加できます。

Agent に証明書を追加する

Agent に証明書を追加するには、Data Connection で対象の Agent の詳細ページに移動し、Agent 証明書を管理を選択します。

Data Connection で Agent 証明書を管理する。

ここで、追加する証明書を選択し、必要に応じてエイリアスを指定します。次に、証明書の内容を追加します。証明書は、以下の例のような文字列として、改行を含め、末尾の改行文字は含めずに追加してください。以下に示す証明書は、https://palantir.com の公開証明書です。

証明書チェーンは入力できません。証明書はそれぞれ個別に入力する必要があります。

証明書を変更した後、変更を有効にするには Agent を再起動する必要があります。初期セットアップ前に証明書を追加した場合、Data Connection で追加した後に、ダウンロードリンクに含まれます。

クライアント証明書については、秘密鍵のセットアップのドキュメントを参照してください。

Agent と Foundry 間の通信を可能にする証明書

Foundry インスタンスに接続するための証明書は、デフォルトの Agent インストールバンドルに含まれています。そのため、通常、Agent ホストが Foundry と通信するために追加の証明書は必要ありません。

Agent から Foundry へのトラフィックが明示的プロキシまたは透過プロキシを経由する場合、初期セットアップの一環としてプロキシの証明書を Agent に追加する必要がある場合があります。この状況で証明書が不足していると Foundry から Agent を管理できなくなるため、初回のインストールバンドルをダウンロードする前に、これらの証明書を Agent に追加する必要があります。

Agent の起動時に、Foundry との通信を妨げる証明書関連のエラーが発生した場合、そのエラーは <bootvisor_directory>/var/service.log というログファイルに表示されます。

Agent を初めてセットアップする際にエラーが発生した場合、または追加の証明書が必要になることが事前にわかっている場合は、次の手順に従ってください。

Agent ホストへのダウンロードとインストールを試みずに、Agent のセットアップページをスキップして進みます。
上のセクションに記載されているとおり、Agent 管理ページから必要な証明書を追加し、その後ダウンロードして標準のインストール手順に従います。

追加する証明書が明示的プロキシ用の場合は、追加の設定が必要になる場合があります。

プロキシ証明書を含め、Foundry への接続用に管理する証明書は、有効期限が切れる前、またはローテーションされる前に更新して、最新の状態を保持してください。証明書の有効期限の監視を使用すると、事前通知を受け取れます。

証明書の変更によって Agent Manager が Foundry に接続できなくなった場合、Agent Manager が更新を取得できないため、Data Connection で証明書を更新するだけでは接続を復旧できません。証明書の復旧手順に従って、ローカルのトラストストアを更新するか、Agent を再インストールしてください。

Agent とシステム間の通信を可能にする証明書

Agent ワーカーとして使用する場合、Agent のプロセスが HTTPS などのセキュアなプロトコル、または TLS/SSL で保護されたプロトコルを使用するシステムと通信する必要があるときは、追加の証明書が必要になる場合があります。新しいソース接続ごとに新しい証明書の追加が必要になる場合があり、これらの証明書は有効期限が切れたり、ローテーションされたりした場合に更新する必要があります。

必要な証明書がない場合、探索などのソース機能を使用しようとすると、次のようなエラーが表示されます。

Wrapped by: javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException:
PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException:
unable to find valid certification path to requested target

TLS 検査環境の Agent

Agent がインストールされているホストのトラフィックに対して TLS 検査を行う場合、Agent Manager が初めて Foundry に接続する前に、ルート CA を Agent Manager のトラストストアに手動でインポートする必要があります。

これを行うには、以下の手順に従ってください。

検査対象のトラフィックに再署名するために使用されるルート CA の公開証明書を取得します。ネットワークチームから入手できるはずです。または、Agent のホストで OpenSSL を使用して証明書チェーンを調べ、ルート証明書を見つけることもできます：openssl s_client -showcerts -connect FOUNDRY_URL:443。
SSH を使用して Agent のホストにアクセスし、Agent Manager を実行するユーザーがアクセスできる場所に証明書を配置します。そのような場所の例として、<agent-manager-install-directory>/var/security があります。
Agent Manager の Java インストール先に移動します：cd <agent-manager-install-directory>/jdk/amazon-corretto*。
証明書を Agent Manager のトラストストアにインポートします：./bin/keytool -import -alias <CERT_NAME> -file /path/to/certificate.pem -keystore ../../var/security/truststore.jks（パスワードの入力が求められた場合は、truststore を入力します）。
Agent Manager を起動します。Data Connection の Agent 詳細ページに Connected to Agent Manager, but no connection from agent と表示されるはずです。これにより、Agent Manager が Foundry に正常に接続されたことを確認できます。
Agent が Foundry に接続できるようにするには、上記の手順に従って、同じ証明書を Agent に追加します。

プロキシ設定

Agent を初めて設定するとき、またはリモートソースに接続するときは、組織のネットワーク設定によってはプロキシの設定が必要になる場合があります。プロキシは、Agent から Foundry への通信を管理するために使用する場合もあれば、ネットワーク内のデータソースにアクセスするために必要になる場合もあります。

Agent でプロキシを使用するには、Data Connection 内の Agent 設定ページにある設定の管理ウィンドウの詳細タブで、Agent と Bootstrapper の両方の設定にプロキシを設定する必要があります。ホスト名の先頭には http:// を付けずに指定してください。

Agent Manager のプロキシ設定

Agent Manager のプロキシ設定は、Agent をインストールしたホスト上の <agent-manager-install-directory>/var/conf/runtime.yml ファイルに追加する必要があります。以下は、proxy-configuration ブロックを含む Agent Manager の設定スニペットの例です。

Copied!1
2
3
4
5
6
7
8
9
service-discovery:
    services:
    magritte-coordinator:
        ...
        proxy-configuration:
            hostAndPort: proxy-host.com:3128
            credentials: # これらは任意です
                username: USERNAME
                password: PASSWORD

このプロキシは、Agent Manager が Foundry の magritte-coordinator に接続するために使用します。Agent からソースへの接続には使用されません。

Bootstrapper のプロキシ設定

Agent Manager のプロキシを設定したら、Bootstrapper のプロキシを設定できます。設定するには、Data Connection 内の Agent 設定ページに移動し、設定の管理セクションで詳細オプションを切り替えて、最後に Bootstrapper タブを選択します。以下は、proxyConfiguration ブロックを含む Bootstrapper の設定スニペットの例です。

Copied!1
2
3
4
5
6
7
coordinator:
    proxyConfiguration:
        host: HOST
        port: PORT
        credentials: # これらは任意です
            username: USERNAME
            password: PASSWORD

設定を更新したら、変更を反映するために、変更を保存して Agent を再起動する必要があります。

このプロキシは、Bootstrapper が Foundry の magritte-coordinator に接続するために使用します。Agent からソースへの接続には使用されません。

ソースのプロキシ設定

Agent からプロキシ経由でデータソースに接続するには、設定の管理ページの詳細セクションにある Bootstrapper タブで、Bootstrapper に Agent の JVM レベルのプロキシを設定します。

次の JVM フラグを使用します。

Copied!1
2
3
4
agent:
  jvmArguments: >-
    -Dhttp.proxyHost=<PROXY URL> -Dhttp.proxyPort=<PROXY PORT>
    -Dhttps.proxyHost=<PROXY URL> -Dhttps.proxyPort=<PROXY PORT>

特定のホストに対して設定済みのプロキシを使用しない場合は、JVM フラグ http.nonProxyHosts を追加します。完全なプロキシ設定の例は以下のとおりです。

Copied!1
2
3
4
5
6
agent:
  jvmArguments: >-
    -Dhttp.nonProxyHosts=host1.com|*.host2.com
    -Dhttp.proxyHost=proxyhost.com -Dhttp.proxyPort=8000
    -Dhttps.proxyHost=proxyhost.com -Dhttps.proxyPort=8001
    ...

これらの設定値を引用符で囲まないでください。

この設定は、Agent からのすべての外向きネットワークリクエストに影響します。ソース固有のプロキシ設定が利用可能な場合は、その設定を使用することを推奨します。

Agent のメトリクスと健全性監視

Data Connection で Agent を設定すると、メトリクスを表示し、健全性を監視してパフォーマンスを維持できます。

メトリクス

Data Connection の Agent ページに移動し、メトリクスタブを選択します。Agent で利用可能なメトリクスには次のものが含まれますが、これらに限らない場合があります。

OS の物理メモリー
ディスク容量
使用可能なディスク容量
コア数で正規化した OS 負荷
CPU 使用率
Agent キーストア内の次の有効期限までの時間
Agent トラストストア内の次の有効期限までの時間
Agent のヒープメモリー
ヒープ使用率
Agent の稼働時間
Agent のスレッド
Agent の前回の再起動以降の同期/タスクのアップロード数
実行中の同期/タスク
Agent でキューに登録されている同期/タスク
同期/タスクの所要時間
Agent の最終ハートビート時刻
Agent Manager のバージョンが古くなってからの経過時間
Agent のバージョンが古くなってからの経過時間

ストリーミング Agent のメトリクスページ。メモリー、ディスク容量、オペレーティングシステムの負荷を測定するメトリクスが表示されています。

メトリックカードにカーソルを合わせると、タイムスタンプ付きの詳細が表示されます。カードの右上隅を選択すると、詳細表示を展開できます。

「次の有効期限までの時間」メトリクス

Agent キーストア内の次の有効期限までの時間メトリクスは、Agent キーストア内の証明書のうち、最も早い有効期限までの時間を示します。Agent トラストストア内の次の有効期限までの時間メトリクスは、Agent トラストストア内の証明書について同じ時間を示します。たとえば、Agent のキーストアに2個の証明書があり、一方の有効期限が1週間後、もう一方の有効期限が1か月後の場合、最も近い有効期限に基づき、値は 1w になります。

Agent のキーストアとトラストストアには、ユーザーが追加した証明書と、Agent Manager が自動的に追加した証明書が含まれます。Agent Manager の証明書は自動的にアップグレードされます。

証明書の有効期限がすでに切れている場合、メトリクスには 000ms と表示されます。Agent に証明書が保存されていない場合、グラフは空になります。

「バージョンが古くなってからの経過時間」メトリクス

Agent Manager のバージョンが古くなってからの経過時間およびAgent のバージョンが古くなってからの経過時間メトリクスは、環境で利用可能なバージョンと比べて、Agent と Agent Manager がどの程度古くなっているかを示します。

バージョンの古さを示すメトリクスは、Agent または Agent Manager の最終更新日と、利用可能な最新バージョンのリリース日との間の日数として計算されます。次の例は、これらのメトリクスと関連するモニターに期待される動作を示しています。

日	最新のリリース済みバージョン	Agent / Agent Manager の現在のバージョン	バージョンが古くなってからの経過時間のメトリクス値	注記
0	v1.0	v1.0	`0`	Agent が現在の最新バージョンに更新されます。
1	v1.0	v1.0	`0`
2	v0.1 -> v2.0	v1.0	`0` -> `2`	Palantir が新しいバージョンをリリースすると、メトリクスは `2` に跳ね上がります。
3	v2.0	v1.0	`3`
4	v2.0	v1.0 -> v2.0	`4` -> `0`	メンテナンスウィンドウ中に更新が成功すると、メトリクスは `0` に戻ります。

この例では、最初の2日間、Agent のバージョンが古くなってからの経過時間メトリクスは 0 です。新しいバージョンが利用可能になるとメトリクスは 2 に跳ね上がり、次の Agent のメンテナンスウィンドウまで増加し続けます。メンテナンスウィンドウ中に更新が正常に完了すると、最終的に 0 に戻ります。

ソフトウェアのバージョンが古くなりすぎたときにアラートを送信するようにモニターが設定されており、Palantir の新しいバージョンのリリース間隔が許容日数を超えている場合、特定の Agent に更新の機会がまだなくても、新しいバージョンが利用可能になるとすぐにモニターがアラートの送信を開始します。これらのアラートは、次のメンテナンスウィンドウ中に更新が成功すると自動的に解消されます。

上の例で、バージョンが古くなってからの経過日数が >2 の場合にアラートを送信するようにモニターが設定されていると、Agent が最新バージョンにアップグレードする機会がまだなくても、3日目にアラートが発生します。4日目に更新が成功すると、アラートは自動的に解消されます。

健全性監視

健全性モニターでは、特定の条件やしきい値が満たされたときに、任意のメトリクスに対してさまざまな重大度（高、中、低）のアラートを設定できます。

Data Health アプリケーションで監視ビューを作成すると、Agent の健全性を監視できます。監視ビューは、そのビューをフォローしているユーザーグループにとって特に重要な監視ルールをまとめたものです。

監視ビュータブを選択すると、既存の監視ビューを表示できます。

Data Health アプリの監視ビューページ。「Test View」という名前の監視ビューが1個表示されています。

特定の監視ビューを選択した後、監視管理を選択すると、Agent の健全性モニターを設定できます。このページから新しい監視ルールを作成できます。

Data Health アプリの監視管理タブ。新しい監視ルールを作成するためのボタンが表示されています。

監視ルールの作成ページでは、具体的なルールと、さまざまな重大度のアラートを設定できます。

監視ルールの作成タブ。テスト用ソースに対して、CPU 使用率、キューサイズ、ディスク容量不足のアラートが適用されています。

モニターを使用したデータの健全性の追跡とモニターと PagerDuty の統合について、詳しくはこちらをご覧ください。

自動アップグレードウィンドウ

Data Connection の Agent サービスは、セキュリティ、安定性、パフォーマンスの改善のために定期的に更新されます。Agent がこれらの重要な改善を適時に受けられるようにする最善の方法は、使用中の各 Agent にアップグレードウィンドウを設定することです。以下のセクションでは、アップグレードウィンドウ中に何が起こるかを説明し、ベストプラクティスのガイドラインを示します。

アップグレードウィンドウ

Agent のアップグレードウィンドウは、Agent が一時的にオフラインになっても安全と見なされる時間帯をまとめたものです。これらの時間帯は毎週繰り返され、Data Connection アプリケーションで、対象の Agent の Agent 設定タブにあるメンテナンスウィンドウページから設定できます。

自動アップグレードの管理

Data Connection コーディネーターは、Agent と各 Agent のアップグレードウィンドウを監視します。新しいバージョンが利用可能な場合、これらのアップグレードウィンドウ中に Agent を自動的にアップグレードします。

アップグレードの一環として、Agent が再起動されます。これにより、実行中のジョブはすべて終了し、新しいジョブが Agent 上で実行されるまでに短時間の待機が発生します。

Agent のアップグレードウィンドウは、少なくとも60分に設定する必要があります。ただし、実際のアップグレードは比較的短時間で完了するはずで、所要時間は Agent の再起動とほぼ同じと考えられます。

アップグレードのタイミングをずらす

データパイプラインへの影響を最小限に抑えるため、すべての Data Connection ソースに少なくとも2個の Agent を割り当て、それらの Agent 上で実行されるソースに対して、アップグレードウィンドウのタイミングをずらすことを推奨します。たとえば、一方の Agent のアップグレードウィンドウを日曜日に設定し、もう一方の Agent のアップグレードウィンドウを水曜日に設定できます。これにより、どの Agent のアップグレードウィンドウ中でも、中断されたジョブをもう一方の Agent で再試行でき、アップグレード中の Agent が完全にオンラインに戻るまで、新しいジョブのキューへの登録と実行を継続できます。

データセットの同期をスケジュールする

アップグレードウィンドウのタイミングをずらせない場合は、アクティビティが少ない（理想的にはゼロの）時間帯にアップグレードウィンドウをスケジュールすることが重要です。この場合、データセットの同期は、アップグレードウィンドウの開始前に完了するか、ウィンドウの終了から数分後に開始するようにスケジュールする必要があります（ウィンドウの終わり近くに再起動が発生する可能性を考慮するためです）。

Agent を再インストールする

Agent がアップグレードされていない場合や、異常な状態が長く続いている場合、最も簡単な解決方法は、ホスト上で Agent を再インストールすることです。Agent の再インストールは安全な操作であり、初回インストールと同様の手順で行います。

再インストールのプロセスを開始するには、Agent の概要ページに移動し、Agent を再インストールを選択します。

再インストールを成功させるため、再インストールウィザードの指示と、以下の追加手順に従ってください。

再インストールする前に、Agent が実行されていないことを確認してください。確認するには、コンピューターのコマンドラインツールを使用して Agent ホストに SSH 接続し、Agent フォルダー（magritte-bootvisor-*）に移動して、次のコマンドを実行し、Agent を停止します。
```
Copied!1
2
./service/bin/init.sh stop
./service/bin/auto_restart.sh clear
```
既存のディレクトリに Agent を再インストールする場合は、古い Agent のバックアップを作成します。
```
Copied!1
mv magritte-bootvisor-* magritte-bootvisor-*-old
```
古い Agent から新しい Agent フォルダーに暗号化キーをコピーします。
```
Copied!1
cp $OLD_BOOTVISOR_DIR/var/data/source-encryption-key* $NEW_BOOTVISOR_DIR/var/data
```
すべてが期待どおりに動作することを確認し、バックアップした Agent magritte-bootvisor-*-old を削除して、ディスクの空き容量を確保します。
```
Copied!1
rm -r magritte-bootvisor-*-old
```

Agent を新しいディレクトリに移動する

同じマシン上で Agent を新しいインストールディレクトリに移動するには、以下の手順に従ってください。

Data Connection で同期ページに移動し、現在実行中の同期がないことを確認してください。
- ページ左側のフィルターを使用して、現在のステータスが実行中の同期のみを表示し、実行中の同期があるかどうかを確認します。
- 実行中の同期がある場合は、完了するまで待つか、ステータスのリンク（たとえば、14分前から実行中）を選択し、ビルドページでビルドをキャンセルを選択してキャンセルします。同期をキャンセルする必要がある場合は、その同期の所有者に適切に通知してください。
Agent ページに移動します。移動する Agent の名前を選択します。
設定パネルで詳細を選択します。詳細設定の各タブで、絶対パスを使用している参照をすべて変更します。/ で始まるものを探し、新しいパスに変更します。
- 注：Kerberos の設定には絶対パスが必要です。
Foundry で Agent を停止します。停止するには、画面右上の Agentを再起動の横にあるドロップダウン矢印を選択し、停止（安全ではありません）を選択します。
- 注：安全ではありませんというラベルは、Agent を停止すると実行中の同期が中断されることを警告するものです。そのため、ステップ1で詳述した予防措置を講じています。
マシンのターミナルから Agent に SSH 接続します。
Agent の管理ユーザーに切り替えます。設定によっては、-- sudo -su palantir または -- sudo -su admin の入力が必要になる場合があります。
ターミナルで、cd を使用して Agent のインストールディレクトリに移動します。
./service/bin/init.sh stop を実行して Agent を停止します。
Agent が以前に自動起動するよう設定されていた場合：
1. Linux では、./service/bin/auto_restart.sh clear を実行します。
2. Windows では、Windows ホストにインストールする手順に従って設定したスケジュール済みタスクをすべて削除します。
数分待ち、管理ユーザーが実行している Java プロセスがないことを確認します。ある場合は、手動で停止します。
必要に応じて、./var/data/binaries、./var/data/cache、./var/data/processes フォルダーの内容を削除し、転送するデータ量を減らします。
mv <source directory> <new installation directory> を入力して、Agent を新しいディレクトリフォルダーに移動します。
新しい Agent のインストールディレクトリに移動します。./service/bin/init.sh start を実行して Agent を再起動します。
Agent が以前に自動再起動するよう設定されていた場合は、自動再起動のセットアップ手順に従って再度有効にします。
5分待ってから Foundry の Agent ページを更新し、Agent が接続されており、同期が成功していることを確認します。

Agent を新しいホストに移動する

Agent を新しいホストに移動する際は、新しいホストがオペレーティングシステムの要件を満たし、以前の Agent と同じオペレーティングシステムおよびアーキテクチャを使用していることを確認してください。また、新しいホストには、古いホストと同じファイアウォールのネットワーク設定が必要です。たとえば、Agent が以前に x86_64 アーキテクチャ上の Linux ディストリビューションで実行されていた場合、新しいホストでは任意の Linux ディストリビューションを使用できますが、同じアーキテクチャ上で実行する必要があります。以下の手順では、Agent を Linux から Windows に、または ARM アーキテクチャに移動できません。このような場合は、UI から新しいダウンロードリンクを取得し、新規インストールを行います。

UI から取得した新しいダウンロードリンクを使用して Agent を再インストールすると、既存のソース資格情報を復号できなくなり、手動で再入力する必要があります。これらの資格情報を保持するには、以下の手順で古い Agent から新しい Agent にソースのシークレットを移行することを検討してください。

古い Agent 上のディレクトリ <bootvisor dir>/var/data に移動します。
ファイル source-encryption-key と source-encryption-key.private を、新しい Agent 上の同じディレクトリ（<bootvisor dir>/var/data）にコピーします。
- コピーする前に古い Agent 上のこれらのファイルが失われたり上書きされたりすると、すべてのソース資格情報が失われ、新しい Agent に手動で再度追加する必要があります。

Agent がファイルシステム内のほかのファイルに依存している場合は、正常な機能を維持するために、それらも新しい Agent のインストール先に移動してください。

Agent を新しいホストに移動するには、以下の手順に従ってください。

Agent を新しいディレクトリに移動する手順のステップ1から11に、ステップ3を除いて従います。これにより、Agent が停止し、新しいホストに転送する準備が整います。
rsync ↗ またはほかのファイル転送ツールを使用して、古いホストから新しいホスト上の場所に Agent フォルダーをコピーします。
Agent を新しいディレクトリに移動する手順で先ほど省略したステップ3に従います。絶対パスで参照されているファイルまたはフォルダーごとに、そのリソースを新しいホスト上の場所にコピーし、新しいパスを参照するように設定を更新します。
Agent を新しいディレクトリに移動するガイドのステップ13から16に従います。

Windows ホストにインストールする

Agent のセットアップには Linux ホストを推奨します。Linux ホストを調達する方法がなく、Windows ホスト上の VM で Linux を実行することもできない場合を除き、Windows ホストは使用しないでください。

Windows Agent では、特に Agent ワーカーとして使用する場合、一部の機能が動作しない可能性があります。具体的には、Windows Agent はテーブルエクスポートに対応しておらず、実行に失敗します。

Agent のセットアップガイドの手順に沿って進めます。ただし、Agent をダウンロードして設定するステップでは、オペレーティングシステムとして Windows を選択します。Agent をインストールした後、クラッシュ時やマシンの再起動時に Agent Manager を再起動する Windows のスケジュールタスクを、次のように設定する必要があります。

Windows タスクスケジューラーを管理者として開きます。
新しいスケジュールタスクを作成します。
全般タブで、次の操作を行います。
1. タスクの実行時に使うユーザーアカウントを SYSTEM に設定します。
2. ユーザーがログオンしているかどうかにかかわらず実行するが選択されていることを確認してください。
3. パスワードを保存しない... が選択されていないことを確認してください。
4. 構成を Windows 仮想マシンの適切なオペレーティングシステムに更新します。
5. 最上位の特権で実行するを選択します。
トリガータブで、2個のトリガーを作成します。
1. 1個のトリガーをイベント時に設定し、スタートアップ時を選択します。
  - 起動時に Windows のアップグレードプロセスと競合しないように、遅延時間を指定するを3分間に設定します。
  - タスクが有効になっていることを確認してください。
2. もう1個のトリガーをスケジュールに基づいて設定します。
  - タスクが毎日実行されるように設定します。
  - 繰り返し間隔のボックスにチェックを入れ、5分間を選択し、継続時間を1日間に設定します。
操作タブで、次の操作を行います。
1. 新しいプログラムの開始アクションを追加します。
2. magritte-bootvisor-win バッチファイルへのフルパスをプログラム/スクリプトのボックスにコピーします。
  - フルパスは C:\example\path\to\folder\containing\magritte\agentmagritte-bootvisor-win-{version}\service\bin\magritte-bootvisor-win.bat のようになります。
3. バッチスクリプトが格納されているフォルダーへのフルパスを開始（オプション） のボックスにコピーします。
  - フルパスは C:\example\path\to\folder\containing\magritte\agent\magritte-bootvisor-win-{version} のようになります。
  - Windows では任意とされていますが、Agent は相対パスを使用してコマンドを実行するため、このステップは必須です。
4. 引数はないため、引数の追加（オプション） は空欄のままにします。
OK を選択してタスクを保存します。
タスクを右クリックして実行を選択し、手動での実行を試みます。
- このタスクは実行中のステータスになり、そのまま継続するはずです。これは Agent Manager が実行されていることを示します。
Agent が正常に起動したことを確認できるはずです。Foundry のインターフェースに反映されるまでに1～2分かかることがあります。Agent が正常に起動しない場合は、スケジュールタスクの履歴タブでエラーを確認します。Windows のコマンドプロンプトを使用して該当するフォルダーに移動し、関連する .bat ファイルを実行することでも、操作の成功を確認できます。

バックアップとキャッシュ

Agent は、インストール、バージョンのアップグレード、バージョンのダウングレード、および継続的な使用の一環として、ファイルをバックアップまたはキャッシュする場合があります。これには、Agent ソフトウェアおよびコネクタープラグインの以前のバージョンが含まれます。セキュリティと安定性の修正は、最新バージョンで提供されます。Agent がアップグレードされると、置き換えられたバージョンはホスト上に保持されますが、読み込まれたり実行されたりすることはなくなります。通常、バックアップやキャッシュされたファイルは無視しても問題なく、30日後に自動的に削除されます。Agent ホスト上で想定以上のディスク容量を使用している場合は、安全に削除できます。削除はメンテナンスウィンドウ外に行ってください。

バックアップファイルとキャッシュファイルは、Agent のインストールディレクトリ内の次のサブディレクトリにあります。

サブディレクトリ	用途
`/backups`	アップグレードの実行時に、Agent の設定のバックアップを保存するために使用されます。
`/var/data/cache`	Agent の通常の動作中にデータをキャッシュするために使用されます。
`/var/data/maven`	インストールやアップグレード時に Agent がダウンロードしたコネクタープラグインとアーティファクトのバージョンを、バージョン別に保存するローカルキャッシュです。Agent に現在割り当てられているバージョンのみが読み込まれます。置き換えられたバージョンはキャッシュに残りますが、実行されないため、削除できます。
`/var/data/processes`	Agent の各プロセスの作業ディレクトリを保持します。これには、そのプロセスが使用したコネクタープラグインが含まれます。現在実行中のプロセスのみが使用されています。非アクティブなディレクトリのうち最新のもの（デフォルトでは最新の10個）のみを保持するため、保持期間（デフォルトでは30日）を過ぎるか、ホストのディスク空き容量が少なくなると、非アクティブなディレクトリは自動的に削除されます。手動で削除することもできます。
`/var/data/processes/<bootstrapper>/var/conf/agent/managed-plugins`	Foundry によって提供されるコネクタープラグインで、コネクターごとに1個の `.jar` があります。存在する最も高いバージョンが使用されます。置き換えられたバージョンは隣接する `archive` ディレクトリに移動され、削除できます。

/var/data/processes 配下で現在実行中のプロセスのディレクトリを特定するには、各ディレクトリ内で service/bin/init.sh status を実行します。実行中と報告されるディレクトリが使用中のディレクトリです。それ以外は非アクティブであり、削除できます。

ホストオーバーライドを設定する

Agent には、Unix システムの /etc/hosts のエントリと同様に、標準の DNS 名前解決をオーバーライドするカスタムのホスト名と IP アドレスのマッピングを設定できます。このホストオーバーライドにより、Agent は特定のホスト名を、標準の DNS 参照とは異なる IP アドレスに解決できます。

Agent のホストオーバーライドを設定する方法

Data Connection アプリケーションから直接 Agent にホストオーバーライドを追加するには、次の手順に従います。

Data Connection の Agent ページに移動し、設定する Agent を選択します。
Agent 設定ページに移動し、目的のホスト名と IP アドレスのマッピングを指定してホストオーバーライドを追加します。
変更を保存し、Agent を再起動して設定を有効にします。

Data Connection の Agent 設定ページからホストオーバーライドを追加します。

たとえば、プライベートネットワーク内でデータソースに 10.0.0.1 でのみアクセスできる場合は、次のようにします。

任意のドメイン（my-private-internal-database.local など）を 10.0.0.1 にマッピングするホストオーバーライドを設定します。ドメイン名は任意ですが、その IP アドレスでホストされているシステムを表す分かりやすい名前を推奨します。
ソースとエグレスポリシーの設定で、10.0.0.1 の代わりにこのドメインを使用します。

ソース設定でホストオーバーライドを使用します

Foundry 内からのネットワーク接続はドメイン名を使用して開始され、Agent がネットワークエッジでそのドメイン名を正しいプライベート IP アドレスに解決します。

ホストオーバーライドの設定は Agent レベルの DNS 名前解決に影響し、その Agent が行うすべての接続に適用されます。これらのマッピングは、標準の DNS 参照より優先されます。

ホストオーバーライドを使用する場面

次のシナリオでは、ホストオーバーライドを設定する必要があります。

IP アドレスでのみ参照できるプライベートネットワーク内のソースシステム： Foundry 内から開始されるネットワークリクエストでは、インフラストラクチャの競合を避けるために、プライベート IP アドレス以外の IP アドレスを使用する必要があります。そのため、Agent プロキシのエグレスポリシーを使用して、名前解決可能なドメイン名がなく、プライベート IP アドレスでのみアクセスできるソースに接続する場合は、ホストオーバーライドを使用して、プレースホルダーのドメインをプライベートネットワーク内の正しいプライベート IP アドレスに解決します。
ローカルテスト： 開発中に localhost やほかのローカルサービスへの接続をテストする場合です。

ホストオーバーライドには Agent バージョン 9.2446.0 以降が必要です。Agent のバージョンは、Data Connection の Agent の概要ページで確認できます。

←

PREVIOUSエージェントのセットアップ

NEXTエージェントワーカー設定リファレンス

→