自動エージェントデプロイ
概要
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
or5986
(WinRM® or Secure WinRM®, respectively) on a private local area network. For configuration details, please refer to “Enabling WinRM in MS Windows”. - For both previous cases allow the connection from the 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: 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 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®) を介してアクセスします。設定の詳細については、“MS Windows で WinRM を有効にする” を参照してください。 - 上記両方のケースで、デプロイを実行するマシンから Pandora FMS の Tentacle サーバ への接続を許可し、パスワードや通信の暗号化なしで、デフォルトのポート
41121
でアクセスできるようにします (次のポイントを参照)。 - 認証情報マネージャでターゲットに接続するために使用する認証情報を登録します: 見つかったターゲットまたは指定されたターゲットへの 認証情報 (タイプ カスタム(custom)) を指定する必要があります。
- エージェントリポジトリに展開するソフトウェアエージェントのバージョンをダウンロードして登録します: エージェントインストーラを登録し、PFMS サーバの
data_in
ディレクトリと同期する必要があります。
- 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 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 thetentacle_serverd
service.
- このシステムは PUSH 処理は実行しません。すべてのデプロイはソフトウェアを提供し、ターゲットにインストールするように指示することにより送信されます。
- Tentacle サーバ に
agent
ディレクトリのフィルタが設定され、エージェント リポジトリのインストーラがダウンロードできるようになっている必要があります。バージョン 777 にアップグレードする場合は、フィルタが設定されていることを確認し、tentacle_serverd
サービスを再起動する必要があります。
対象の検索
Once the described steps have been verified, you will be able to access the menu Management → Discovery → Host & Devices → Agent deployment.
説明した手順を確認したら、メニュー 管理(Management) → 自動検出(Discovery) → Host & Devices → エージェントデプロイ(Agent deployment) にアクセスできます。
Any of the following options can be used to define targets for deployment:
次のオプションのいずれかを使用して対象を定義できます。
- Scan for targets.
- Add target.
- Load targets.
- 対象のスキャン(Scan for targets)
- 対象の追加(Add target)
- 対象の読み込み(Load targets)
Finally, the agents will be displayed by clicking Deploy agent to targets.
最後に、エージェントをターゲットにデプロイ(Deploy agent to targets) ボタンをクリックすると、エージェントが表示されます。
対象検出のための 1 つ以上のネットワークスキャン
Clicking on Scan for targets will display a pop-up box, some of the parameters to be configured are as follows:
ターゲットをスキャン(Scan for targes) をクリックするとポップアップボックスが表示されます。設定するパラメータの一部は次のとおりです。
- Network/mask: The network or networks (separated by commas) and their mask(s) to be scanned.
- Scan from: The Discovery PFMS server that will perform the scan.
- Desired agent version: The version of the Software Agent to be deployed.
- Credentials to try with: One (or more) credentials that will be used to try to connect to the discovered targets.
- Tentacle server IP and Tentacle server PORT: 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 Scan, a new entry to be executed will appear in the task list.
スキャン(Scan) をクリックすると、実行する新しいエントリがタスク リストに表示されます。
対象の手動定義
Clicking Add target will display a pop-up box, some of the parameters to be configured are as follows:
ターゲットの追加(Add target) をクリックするとポップアップボックスが表示されます。設定するパラメータの一部は次のとおりです。
- Target IP: IP address to deploy to.
- Deploy port: Port of connection to the target for agent deployment (according to the deployment method).
- Deploy method: SSH, WinRM or Secure WinRM.
- Desired agent version: The version of the Software Agent to be deployed.
- Credentials: Credentials that will be used to try to connect with the discovered targets.
- Tentacle server IP and Tentacle server PORT: 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 Deploy temp folder or simply use the default directory according to the corresponding operating system.
- 対象 IP(Target IP): デプロイする IP アドレス。
- デプロイポート(Deploy port): エージェントを展開するターゲットへの接続ポート (展開方法によって異なります)。
- デプロイ方法(Deploy method): SSH, WinRM または Secure WinRM。
- 希望エージェントバージョン(Desired agent version): 展開するソフトウェアエージェントのバージョン。
- 認証(Credentials): 検出されたターゲットに接続するために使用する認証情報。
- Tentacle サーバ IP(Tentacle server IP) および、Tentacle サーバポート(Tentacle server PORT): ソフトウェアエージェントのインストール時に指定する対象サーバの IP アドレス (エージェント設定ファイルの
server_ip
フィールドに対応します) とポート番号。 - 必要に応じて、デプロイ一時フォルダ(Deploy temp folder) に一時ディレクトリを指定するか、対応するオペレーティングシステムに応じてデフォルトのディレクトリを使用します。
対象情報を CSV ファイルでアップロード
If you want to record targets in bulk, you may upload a CSV file with the following format:
対象を一括登録したい場合は、次の形式の CSV ファイルをアップロードできます。
IP; Protocol; Target port; Target agent version; Credential identifier; Tentacle server ip; Tentacle server port; Temp folder
See each of the parameters in the section “Manually define a target”.
各パラメータについては、“対象の手動定義” を参照してください。
ソフトウエアのデプロイ
You may only schedule deployment against targets whose information is complete, specifying both credentials and software versions to be deployed.
認証情報とデプロイするソフトウェアバージョンの両方が指定され情報が揃っている対象に対してのみデプロイメントをスケジュールできます。
As soon as you have possible targets in the list, the 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.
リストに対象候補があれば、すぐにエージェントの展開を開始できます。 リストから対象の 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.
検出タスクはバックグラウンドでの展開用に自動的に作成され、目的の対象にエージェントをインストールします。 展開センターのターゲットリストからエージェントが正常にインストールされたことを確認したり (概要を参照)、これらのタスクを強制、有効化/無効化、削除、編集したりすることができます。
(OBSOLETE) デバイスリストを CSV でインポートする
A list of devices can be imported to represent them as agents using the agent import wizard via CSV.
CSV 経由でエージェントインポートウィザードを使用すると、デバイスのリストをエージェントとしてインポートすることができます。
This utility only creates agents in Pandora FMS for remote monitoring.
このユーティリティは、Pandora FMS にリモート監視用のエージェントを作成するだけです。
You must select the separator used, the server where you want to import and the file that contains the data, then click Go.
使用する区切り記号、インポートするサーバおよびデータを含むファイルを選択し、Go をクリックする必要があります。