ファイルコレクション

Pandora FMS ドキュメント一覧に戻る

The file collections are resources used to massively deploy the scripts or plugins to later be used in Software Agents, Policy s of monitoring on agents and in the Satellite servers. It is accessed from the menu Configuration → Collections (Configuration → Collections).

これらは通常、ソフトウエアエージェント、エージェントの監視ポリシー、および、サテライトサーバで、スクリプトまたはプラグインを一括展開するために使用されます。設定(Configuration) → コレクション(Collections) メニューからアクセスします。

To create a new file collection, click on Create:

新しいファイルコレクションを作成するには、作成(Create) ボタンをクリックします。

Fill in the name, group, short name and description and click Create.

名前、グループ、短い名前、および説明を入力し、作成(Create) をクリックします。

To add resources to a collection, go back to the collection list and click on the name of the collection resources will be added to.

リソースをコレクションに追加するには、コレクション一覧に戻り、リソースを追加するコレクションの名前をクリックします。

In the three icons highlighted in the image above, from left to right you may create a directory, create a text (which you may then edit) or store a new file.

上の画像で強調表示されている 3 つのアイコンでは、左から右に、ディレクトリの作成、テキストの作成 (後で編集可能)、または新しいファイルの保存を行うことができます。

Once the resources have been added, return to the collection list of and an icon with a yellow triangle will appear, where you may click to synchronize the changes with the different Pandora FMS elements (agents, Software Agents, monitoring policies and Satellite servers).

リソースが追加されたら、コレクションのリストと黄色の三角形のアイコンに戻ります。ここをクリックすると、変更を Pandora FMS のさまざまな要素 (エージェント、ソフトウェアエージェント、監視ポリシー、サテライトサーバ) と同期できます。

Each collection has its own base directory. In the Web Console these are stored in the directory /pandora_console/attachment/collection with a name like fc_XXX, where XXX is the numeric ID of the collection. File collections can contain subdirectories. File collections are transferred as ZIP (compressed) files to the Agent through Tentacle. File collections are only supported with Tentacle transfer mode.

各コレクションには独自のベースディレクトリがあります。 Web コンソールでは、これらはディレクトリ /pandora_console/attachment/collection に fc_XXX のような名前で保存されます。ここで、XXX はコレクションの数値 ID です。ファイルコレクションには、サブディレクトリを含めることができます。ファイルコレクションは、Tentacle 経由で ZIP (圧縮) ファイルとしてエージェントに転送されます。ファイルコレクションは、Tentacle 転送モードでのみサポートされます。

Go to Resources → Manage agents and click on a Software Agent name. Click the Collection (Collection) tab. You will have a list of available collections similar to this:

リソース(Resources) → エージェント管理(Manage agents) へ行き、ソフトウエアエージェントの名前をクリックします。コレクション(Collection) タブをクリックします。次のような定義済のコレクション一覧が表示されます。

If a Software Agent has remote configuration disabled, it will show the following warning:

ソフトウエアエージェントのリモート設定が無効化されている場合は、次の警告が表示されます。

To add a collection click on the plus icon in the Add column:

コレクションを追加するには、追加(Add) 列の合計アイコンをクリックします:

If you see an icon with a yellow warning triangle in the Status column, either the collection is empty or the collection has not been synchronized. If the collection contains files or directories, click on the yellow icon. Once you have applied the changes, the status of the collection will indicate the success of the synchronization.

状態(Status) 列に黄色の警告三角形のアイコンが表示される場合は、コレクションが空であるか、コレクションが同期されていません。コレクションにファイルまたはディレクトリが含まれている場合は、黄色のアイコンをクリックします。変更を適用すると、コレクションのステータスが同期の成功を示します。

After a few minutes you may go to Configuration → Collections and click on the name of the added collection. The newly added Software Agent will be displayed in the Agents tab.

数分後、設定(Configuration) → コレクション(Collections) に移動し、追加したコレクションの名前をクリックします。新しく追加されたソフトウェアエージェントがエージェントタブに表示されます。

Each collection of files has a short name. This means that the utilities, scripts or executables that are inside the collection will be in:

それぞれのファイルコレクションは、短い名前を持っています。ユーティリティ、スクリプトや、実行ファイルなどを含んだコレクションは以下に置かれます。

MS Windows®

%ProgramFiles%\pandora_agent\collections\short-name

GNU/Linux®

/usr/share/pandora_agent/collections/short-name

It is important to know that the collection is compressed to be sent to the Software Agent, so the latter must have the unzip.exe tool to be able to decompress the file. As of Agent version 3.2 for MS Windows®, this utility is installed inside:

コレクションはソフトウェアエージェントへ圧縮して送信されるため、ソフトウェアエージェントがファイルを解凍するためには unzip.exe ツールが必要です。 MS Windows® 用エージェントバージョン 3.2 では、このユーティリティは次の場所にインストールされています。

%ProgramFiles%\pandora_agent\utils

You need to know this to be able to use Modules that work when working with those files, to be able to specify the full “real” path. Each file collection is stored at a different address, to prevent different file collections from overwriting or conflicting with each other.

完全な “実際の”パスを指定して、これらのファイルを利用してモジュールが動くようにする必要があることを理解してください。各コレクションファイルは異なる場所に保存され、異なるコレクションファイルが互いに上書きまたは競合するのを防ぎます。

The collection control system is based on md5 hashes, similar to the management of configuration files of the Agents. When creating the collection in the Pandora FMS Web Console, an md5 hash is created that is sent to the Software Agent. This md5 will only be updated when changes occur in the collection on the Pandora FMS Web Console side, and not in the Software Agent. Therefore, changes to collections made locally on agents will remain as long as the collection is not changed in the Web Console.

コレクション制御システムは md5 ハッシュに基づいており、エージェント設定ファイルの管理と同様です。 Pandora FMS ウェブコンソールでコレクションを作成すると、md5 ハッシュが作成され、ソフトウェアエージェントに送信されます。この md5 は、ソフトウェアエージェントではなく、Pandora FMS ウェブコンソール側のコレクションに変更がある場合にのみ更新されます。したがって、エージェントでローカルに行われたコレクションの変更は、コレクションがウェブコンソールで変更されない限りそのまま残ります。

If any change is made to the collection on the Web Console side, the md5 will be recalculated, and when it disagrees with the existing one in the Agents, it will apply the last configuration of the collection, overwriting the previous one and eliminating possible local modifications about the collections.

ウェブコンソール側でコレクションに変更が加えられると、md5 が再計算され、エージェント内の既存の設定と一致しない場合は、コレクションの最後の設定が適用され、以前の設定が上書きされ、コレクションに対してローカルで行った変更は破棄されます。

If you want to use a Module that uses a file included in the collection, refer only to the directory that contains the collection, using its fixed identifier. This is an example using a Plugin module:

コレクションに含まれるファイルを使用するモジュールを使用する場合は、その固定識別子を使用して、コレクションを含むディレクトリのみを参照してください。これはプラグインモジュールを使用した例です:

It works much like individual Agent collections, but instead of applying a collection to a specific Agent, it is applied to a policy:

個々のエージェントコレクションと同じように機能しますが、コレクションを特定のエージェントに適用する代わりに、ポリシーに適用します。

Refer to this section to manage and synchronize collections.

コレクションを管理および同期するには、こちらを参照してください。

Click on the Servers → Manage servers menu and then click on the remote configuration icon of the Satellite server the collection will be added to. Click on the Collections tab and in the list of available collections, in the Actions column, add the respective collection by clicking on the + icon. You may also delete the collections added by clicking on the trash can icon.

サーバ(Servers) → サーバ管理(Manage servers) メニューをクリックし、コレクションが追加されるサテライトサーバのリモート設定アイコンをクリックします。 コレクション(Collections) タブをクリックし、使用可能なコレクションの一覧で、アクション(Actions) 列の + アイコンをクリックして、それぞれのコレクションを追加します。ごみ箱アイコンをクリックして、追加したコレクションを削除することもできます。

When you save the changes, after a few minutes, you will see in the configuration file the new section created with the collections added and their respective short name.

変更を保存すると、数分後に、追加されたコレクションとそれぞれの短い名前で作成された新しいセクションが設定ファイルに表示されます。

Refer to this section to manage and synchronize collections.

コレクションの管理と同期はこちらの章を参照してください。

From Pandora FMS 729 OUM you may centralize collection management from the Metaconsole. To access it go to the Centralised management → Agent management menu and click on the Collections tab.

Pandora FMS 729 OUM からは、[:ja:documentation:06_metaconsole:01_introduction|メタコンソール]]からコレクションの中央管理ができます。それには、中央管理(Centralized management) → エージェント管理(Agent management) メニューに移動し、コレクション(Collections) タブをクリックします。