ファイルコレクション

These are resources used to mass deploy scripts or plugins to be used in Software Agents, monitoring policies on agents and Satellite servers. It is accessed from the menu 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 the name of a Software Agent. Click on the Collection tab. You will have a list of available collections similar to this one:

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

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 file collection has a short name; for this example fc_13830334393. This means that the utilities, scripts or executables that are inside the collection will be in:

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

%ProgramFiles%\pandora_agent\collections\fc_13830334393

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 in order to decompress the file. As of version 3.2 of the Agent, this utility is installed inside:

コレクションは圧縮された形式でソフトウエアエージェントに送信されるため、ソフトウエアエージェントには、ファイルを解凍するための unzip.exe ツールが含まれている必要があることに注意してください。 エージェントバージョン 3.2 以降、このツールは以下にインストールされています。

%ProgramFiles%\pandora_agent\utils

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

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

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

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

If any change is made in the collection in the Web Console side, the md5 will be recalculated, and when it does not match the existing one in the Agents, it will apply the last colelction configuration, overwriting the previous one and deleting possible local modifications on the collections.

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

If you want to use a Module that uses a file included in the collection, reference only 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) タブをクリックします。

Refer to this section to manage and synchronize collections, as they work similarly as those of the Web Console.

ウェブコンソールと同じようにコレクションを管理および同期するには、こちらの章を参照してください。

The Configuration duplication option allows copying pandora_agent.conf file from a Software Agent with remote configuration enabled to another Software Agent.

設定の複製オプションは、リモート設定が有効なソフトウエアエージェントから pandora_agent.conf ファイルを別のソフトウエアエージェントへコピーできます。

• Use Source Group to filter agents by the group they belong to.
• Select the agent that contains the configuration to be copied to the Source Agent.
• Select one or more agents in Destination agent(s).
• Press the button Replicate configuration to apply the changes.

• エージェントを所属グループでフィルタするために、ソースグループ を利用します。
• 設定をコピーしたいエージェントを ソースエージェント(Source Agent) で選択します。
• 一つ以上のコピー先エージェントを 対象エージェント(Destination agent(s) で選択します。
• 設定の複製(Replicate configuration) をクリックして変更を反映します。

In the Servers → Manage Satellite Server menu you may manage the Satellite servers that you pointed to your Web Console. By clicking on the name you may manage the corresponding Credential boxes.

サーバ(Servers) → サテライトサーバ管理(Manage Satellite Server) メニューにて、ウェブコンソールに設定されたサテライトサーバを管理できます。名前をクリックすると、対応する 認証情報ボックス を管理できます。