自動エージェントデプロイ [wiki.pandorafms.jp]

この文書は読取専用です。文書のソースを閲覧することは可能ですが、変更はできません。もし変更したい場合は管理者に連絡してください。
====== 自動エージェントデプロイ ======

{{indexmenu_n>17}}


===== 概要 =====

Steps to deploy Software Agents on the devices to be monitored from the Web Console:

Web コンソールから監視対象のデバイスにソフトウェア エージェントを展開する手順:

  * **Software agents for GNU/Linux®**: Access by **SSH**  on the default port ''22''.
  * **MS Windows® software agents**: **PowerShell®**  enabled and accessed through the default ports ''5985''  or ''5986''  (**WinRM®**  or **Secure WinRM®**, respectively) on a private local area network. For configuration details, please refer to "[[https://pandorafms.com/guides/public/books/guide-to-configuring-winrm-on-ms-windows|Enabling WinRM in MS Windows]]".
  * **For both previous cases** allow the connection from the [[:en:documentation:pandorafms:technical_reference:09_tentacle#filters|Tentacle server]] to Pandora FMS, which will perform the deployment, and with access to the default port ''41121''  without password or communication encryption (see next point).
  * **Register the credentials to be used to connect to the targets in the credentials manager**: [[:en:documentation:pandorafms:management_and_operation:11_managing_and_administration#ks3|The credentials]] (type //custom//) with which the accesses to the found or specified targets will be tested must be specified.
  * **Download and register the versions of Software Agents to be deployed in the agent repository**: You will need to [[:en:documentation:pandorafms:management_and_operation:11_managing_and_administration#ks16|store the agent installers]] and synchronize with the ''data_in''  directory of PFMS server:

  * **GNU/Linux® 用のソフトウエアエージェント**: デフォルトのポート ''22'' で**SSH** でアクセスします。
  * **MS Windows® 用のソフトウエアエージェント**: **PowerShell®** が有効になっており、プライベート ローカル エリア ネットワーク上のデフォルトポート ''5985'' または ''5986'' (それぞれ **WinRM®** または **Secure WinRM®**) を介してアクセスします。設定の詳細については、"[[https://pandorafms.com/guides/public/books/guide-to-configuring-winrm-on-ms-windows|MS Windows で WinRM を有効にする]]" を参照してください。
  * **上記両方のケースで**、デプロイを実行するマシンから Pandora FMS の [[:ja:documentation:pandorafms:technical_reference:09_tentacle|Tentacle サーバ]] への接続を許可し、パスワードや通信の暗号化なしで、デフォルトのポート ''41121'' でアクセスできるようにします (次のポイントを参照)。
  * **認証情報マネージャでターゲットに接続するために使用する認証情報を登録します**: 見つかったターゲットまたは指定されたターゲットへの [[:ja:documentation:pandorafms:management_and_operation:11_managing_and_administration#認証情報ストア|認証情報]] (タイプ //カスタム(custom)//) を指定する必要があります。
  * **エージェントリポジトリに展開するソフトウェアエージェントのバージョンをダウンロードして登録します**: [[:ja:documentation:pandorafms:management_and_operation:11_managing_and_administration#ソフトウエアエージェントリポジトリ|エージェントインストーラを登録]]し、PFMS サーバの ''data_in'' ディレクトリと同期する必要があります。

{{  :wiki:pfms-software_agents_repository_sync.png  }}

<WRAP center round important 90%>

  * This system does not perform PUSH operations; all deployments are transmitted offering the software and instructing the target to install it.
  * It will be necessary to have the [[:en:documentation:pandorafms:technical_reference:09_tentacle#filters|Tentacle server]] configured with the filters for the ''agent''  directory and that the installers of the agent repository can be downloaded. If you upgrade to version 777, you should check that the filters are configured and restart the ''tentacle_serverd''  service.

</WRAP>

<WRAP center round important 90%>

  * このシステムは PUSH 処理は実行しません。すべてのデプロイはソフトウェアを提供し、ターゲットにインストールするように指示することにより送信されます。
  * [[:ja:documentation:pandorafms:technical_reference:09_tentacle#filters|Tentacle サーバ]] に ''agent'' ディレクトリのフィルタが設定され、エージェント リポジトリのインストーラがダウンロードできるようになっている必要があります。バージョン 777 にアップグレードする場合は、フィルタが設定されていることを確認し、''tentacle_serverd'' サービスを再起動する必要があります。

</WRAP>

<wrap #ks2 />

===== 対象の検索 =====

Once [[#ks1|the described steps]] have been verified, you will be able to access the menu <wrap :en>**Management → Discovery → Host & Devices → Agent deployment**</wrap>.

[[#ks1|説明した手順]]を確認したら、メニュー <wrap :ja>**管理(Management) → 自動検出(Discovery) → Host & Devices → エージェントデプロイ(Agent deployment)**</wrap> にアクセスできます。

Any of the following options can be used to define targets for deployment:

次のオプションのいずれかを使用して対象を定義できます。

  * <wrap :en>**Scan for targets**</wrap>.
  * <wrap :en>**Add target**</wrap>.
  * <wrap :en>**Load targets**</wrap>.

   * **対象のスキャン(Scan for targets)**
   * **対象の追加(Add target)**
   * **対象の読み込み(Load targets)**

Finally, the agents will be displayed by clicking <wrap :en>**Deploy agent to targets**</wrap>.

最後に、<wrap :ja>**エージェントをターゲットにデプロイ(Deploy agent to targets)**</wrap> ボタンをクリックすると、エージェントが表示されます。

<wrap #ks2_1 />

==== 対象検出のための 1 つ以上のネットワークスキャン ====

Clicking on <wrap :en>**Scan for targets**</wrap> will display a pop-up box, some of the parameters to be configured are as follows:

<wrap :ja>**ターゲットをスキャン(Scan for targes)**</wrap> をクリックするとポップアップボックスが表示されます。設定するパラメータの一部は次のとおりです。

  * <wrap :en>**Network/mask**</wrap>: The network or networks (separated by commas) and their mask(s) to be scanned.
  * <wrap :en>**Scan from**</wrap>: The Discovery PFMS server that will perform the scan.
  * <wrap :en>**Desired agent version**</wrap>: The version of the Software Agent to be deployed.
  * <wrap :en>**Credentials to try with**</wrap>: One (or more) credentials that will be used to try to connect to the discovered targets.
  * <wrap :en>**Tentacle server IP**</wrap> and <wrap :en>**Tentacle server PORT**</wrap>: The IP address (corresponds to the ''server_ip''  field in the agent configuration file) and port number of the target server where these Software Agents will point to when installed.

   * **ネットワーク/マスク(Network/mask)**: 探索するネットワーク (カンマで区切られた複数のネットワーク)。
   * **スキャン元(Scan from)**: スキャンを実行する検出サーバ。
   * **試行する認証情報(Credentials to try with)**: 検出された対象への接続を試行するために使用される認証情報。
   * **必要なエージェントのバージョン(Desired agent version)**: 検出された対象に対して必要に応じて登録されるソフトウェアエージェントのバージョン。
   * **Tentacle サーバ IP(Tentacle server IP)** および、**Tentacle サーバポート(Tentacle server PORT)**: ソフトウェアエージェントのインストール時に指定する対象サーバの IP アドレス (エージェント設定ファイルの ''server_ip'' フィールドに対応します) とポート番号。

By clicking <wrap :en>**Scan**</wrap>, a new entry to be executed will appear in the task list.

<wrap :ja>**スキャン(Scan)**</wrap> をクリックすると、実行する新しいエントリがタスク リストに表示されます。

<wrap #ks2_2 />

==== 対象の手動定義 ====

Clicking <wrap :en>**Add target**</wrap> will display a pop-up box, some of the parameters to be configured are as follows:

<wrap :ja>**ターゲットの追加(Add target)**</wrap> をクリックするとポップアップボックスが表示されます。設定するパラメータの一部は次のとおりです。

  * <wrap :en>**Target IP**</wrap>: IP address to deploy to.
  * <wrap :en>**Deploy port**</wrap>: Port of connection to the target for agent deployment (according to the deployment method).
  * <wrap :en>**Deploy method**</wrap>: SSH, WinRM or Secure WinRM.
  * <wrap :en>**Desired agent version**</wrap>: The version of the Software Agent to be deployed.
  * <wrap :en>**Credentials**</wrap>: Credentials that will be used to try to connect with the discovered targets.
  * <wrap :en>**Tentacle server IP**</wrap> and <wrap :en>**Tentacle server PORT**</wrap>: The IP address (corresponds to the ''server_ip''  field in the agent configuration file) and port number of the target server where these Software Agents will point to when installed.
  * If necessary specify a temporary directory in <wrap :en>**Deploy temp folder**</wrap> or simply use the default directory according to the corresponding operating system.

   * <wrap :ja>**対象 IP(Target IP)**</wrap>: デプロイする IP アドレス。
   * <wrap :ja>**デプロイポート(Deploy port)**</wrap>: エージェントを展開するターゲットへの接続ポート (展開方法によって異なります)。
   * <wrap :ja>**デプロイ方法(Deploy method)**</wrap>: SSH, WinRM または Secure WinRM。
   * <wrap :ja>**希望エージェントバージョン(Desired agent version)**</wrap>: 展開するソフトウェアエージェントのバージョン。
   * <wrap :ja>**認証(Credentials)**</wrap>: 検出されたターゲットに接続するために使用する認証情報。
   * <wrap :en>**Tentacle サーバ IP(Tentacle server IP)** および、**Tentacle サーバポート(Tentacle server PORT)**</wrap>: ソフトウェアエージェントのインストール時に指定する対象サーバの IP アドレス (エージェント設定ファイルの ''server_ip'' フィールドに対応します) とポート番号。
   * 必要に応じて、<wrap :ja>**デプロイ一時フォルダ(Deploy temp folder)**</wrap> に一時ディレクトリを指定するか、対応するオペレーティングシステムに応じてデフォルトのディレクトリを使用します。

<wrap #ks2_3 />

==== 対象情報を CSV ファイルでアップロード ====

If you want to record targets in bulk, you may upload a CSV file with the following format:

対象を一括登録したい場合は、次の形式の CSV ファイルをアップロードできます。

<file>

IP; Protocol; Target port; Target agent version; Credential identifier; Tentacle server ip; Tentacle server port; Temp folder

</file>

See each of the parameters in the section "[[#ks2_2|Manually define a target]]".

各パラメータについては、"[[#ks2_2|対象の手動定義]]" を参照してください。

<wrap #ks3 />

===== ソフトウエアのデプロイ =====

<WRAP center round important 60%>

You may only schedule deployment against targets whose information is complete, specifying both credentials and software versions to be deployed.

</WRAP>

<WRAP center round important 60%>

認証情報とデプロイするソフトウェアバージョンの両方が指定され情報が揃っている対象に対してのみデプロイメントをスケジュールできます。

</WRAP>

As soon as you have possible targets in the list, the [[:en:documentation:pandorafms:installation:04_configuration#agent_deployer_utility|agent deployment]] can be launched. Select the IP addresses of the targets from the list (only valid targets will appear in **Available targets**) and with the **Deploy**  button, the agent deployment will start.

リストに対象候補があれば、すぐに[[:ja:documentation:pandorafms:installation:04_configuration#agent_deployer_utility|エージェントの展開]]を開始できます。 リストから対象の IP アドレスを選択し (**利用可能な対象** には有効な対象のみが表示されます)、**デプロイ(Deploy)** ボタンをクリックするとエージェントのデプロイが開始されます。

A Discovery task will be automatically created for background deployment, which will be in charge of installing the agent in the desired targets. It will be possible to confirm that the agent was successfully installed from the target list in the deployment center (see summary), as well as to force, enable/disable, delete and edit these tasks.

検出タスクはバックグラウンドでの展開用に自動的に作成され、目的の対象にエージェントをインストールします。 展開センターのターゲットリストからエージェントが正常にインストールされたことを確認したり (概要を参照)、これらのタスクを強制、有効化/無効化、削除、編集したりすることができます。


[[:ja:documentation:start|Pandora FMS ドキュメント一覧に戻る]]


===== (OBSOLETE) デバイスリストを CSV でインポートする =====

A list of devices can be imported to represent them as agents using the agent import wizard via CSV.

CSV 経由でエージェントインポートウィザードを使用すると、デバイスのリストをエージェントとしてインポートすることができます。

<WRAP center round tip 60%>

This utility only creates agents in Pandora FMS for remote monitoring.

</WRAP>

<WRAP center round tip 60%>

このユーティリティは、Pandora FMS にリモート監視用のエージェントを作成するだけです。

</WRAP>

You must select the separator used, the server where you want to import and the file that contains the data, then click **Go**.

使用する区切り記号、インポートするサーバおよびデータを含むファイルを選択し、**Go** をクリックする必要があります。