ja:documentation:pandorafms:technical_annexes:28_pfms_file_collections

差分

このページの2つのバージョン間の差分を表示します。

この比較画面へのリンク

両方とも前のリビジョン 前のリビジョン
次のリビジョン		 前のリビジョン
ja:documentation:pandorafms:technical_annexes:28_pfms_file_collections [2025/02/01 13:15] – [ファイルコレクション] junichija:documentation:pandorafms:technical_annexes:28_pfms_file_collections [2025/08/02 07:52] (現在) – [ソフトウエアエージェントにおけるファイルコレクションの場所] junichi
行 9: 行 9:
 ===== ファイルコレクション ===== ===== ファイルコレクション =====
  
-The file collections are resources used to massively deploy the scripts or plugins to later be [[:en:documentation:pandorafms:complex_environments_and_optimization:02_policy#collection_of_files_and_software_agents|used in Software Agents]], [[:en:documentation:pandorafms:complex_environments_and_optimization:02_policy#collection_of_files_and_monitoring_policy|Policy s of monitoring]] on agents and in the [[:en:documentation:pandorafms:complex_environments_and_optimization:02_policy#collection_of_files_in_satellite_server|Satellite servers]]. It is accessed from the menu **Configuration** → **Collections** (**Configuration** → **Collections**).+The file collections are resources used to massively deploy the scripts or plugins to later be [[:en:documentation:pandorafms:complex_environments_and_optimization:02_policy#ks5|used in EndPoints, Policies of monitoring on agents and Satellite servers]]. It is accessed from the menu <wrap :en>**Configuration → Collections**</wrap>.
  
-これらは通常、[[:ja:documentation:pandorafms:complex_environments_and_optimization:02_policy#ファイルコレクションとソフトウエアエージェント|ソフトウエアエージェント]]、エージェントの[[:ja:documentation:pandorafms:complex_environments_and_optimization:02_policy#ファイルコレクションと監視ポリシー|監視ポリシー]]、および、[[:ja:documentation:pandorafms:complex_environments_and_optimization:02_policy#サテライトサーバファイルコレクション|サテライトサーバ]] で、スクリプトまたはプラグインを一括展開するために使用されます。**設定(Configuration)** → **コレクション(Collections)** メニューからアクセスします。+ファイルコレクションは、[[:ja:documentation:pandorafms:complex_environments_and_optimization:02_policy#ks5|エンドポイント、エージェントとサテライトサーバの監視ポリシーで使用される]] スクリプトまたはプラグインを後から大量に展開するために使用されるリソースです。メニュー <wrap :ja>**設定(Configuration) → コレクション(Collections)**</wrap> からアクセスできます。
  
 {{  :wiki:pfms-configuration-collection-manage_collection.png  }} {{  :wiki:pfms-configuration-collection-manage_collection.png  }}
行 35: 行 35:
 上の画像で強調表示されている 3 つのアイコンでは、左から右に、ディレクトリの作成、テキストの作成 (後で編集可能)、または新しいファイルの保存を行うことができます。 上の画像で強調表示されている 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).+Once the resources have been added, return to the list of collections and an icon with a yellow triangle where you can click to synchronise the changes with the different elements of Pandora FMS (agents, EndPoints, monitoring policies and Satellite servers).
  
-リソースが追加されたら、コレクションのリストと黄色の三角形のアイコンに戻ります。ここをクリックすると、変更を Pandora FMS のさまざまな要素 (エージェント、ソフトウェアエージェント、監視ポリシー、サテライトサーバ) と同期できます。+リソースが追加されたら、コレクションのリストと黄色の三角形のアイコンに戻ります。ここをクリックすると、変更を Pandora FMS のさまざまな要素 (エージェント、エンドポイント、監視ポリシー、サテライトサーバ) と同期できます。
  
 {{  :wiki:pfms-configuration-collection-manage_collection-apply_changes.png  }} {{  :wiki:pfms-configuration-collection-manage_collection-apply_changes.png  }}
  
-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 [[:en:documentation:08_technical_reference:09_tentacle|Tentacle]]. File collections are only supported with Tentacle transfer mode.+Each collection has its own base directory. In the Web Console these are stored in the ''/pandora_console/attachment/collection'' directory with a name like ''fc_XXX'', where XXX is the numerical ID of the collection. File collections can contain subdirectories. File collections are transferred as ZIP (compressed) files to the Agent, using [[:en:documentation:pandorafms:technical_reference:09_tentacle|Tentacle]]. At least one file must be in the collection and the ZIP utility must be installed for compression. File collections are only supported with Tentacle's transfer mode.
  
-各コレクションには独自のベースディレクトリがあります。 Web コンソールでは、これらはディレクトリ ''/pandora_console/attachment/collection'' に ''fc_XXX'' のような名前で保存されます。ここで、XXX はコレクションの数値 ID です。 ファイルコレクションには、サブディレクトリを含めることができます。 ファイルコレクションは、[[:ja:documentation:08_technical_reference:09_tentacle|Tentacle]] 経由で ZIP (圧縮) ファイルとしてエージェントに転送されます。 ファイルコレクションは、Tentacle 転送モードでのみサポートされます。+各コレクションには独自のベースディレクトリがあります。 Web コンソールでは、これらはディレクトリ ''/pandora_console/attachment/collection'' に ''fc_XXX'' のような名前で保存されます。ここで、XXX はコレクションの数値 ID です。 ファイルコレクションには、サブディレクトリを含めることができます。 ファイルコレクションは、[[:ja:documentation:pandorafms:technical_reference:09_tentacle|Tentacle]] 経由で ZIP (圧縮) ファイルとしてエージェントに転送されます。 コレクションには少なくとも1つのファイルが含まれており、圧縮にはZIPユーティリティがインストールされている必要があります。ファイルコレクションは、Tentacle 転送モードでのみサポートされます。
  
-==== ファイルコレクションとソフトウエアエージェント ====+<wrap #ks1_1 />
  
-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)** タブをクリックします。次のような定義済のコレクション一覧が表示されます。+Go to <wrap :en>**Resources → Manage agents**</wrap> and click on a EndPoint name. Click the <wrap :en>**Collection**</wrap> tab. You will have a list of available collections similar to this:
  
-{{  :wiki:pfms-software_agent-collection-01.png  }}+**リソース(Resources)** → **エージェント管理(Manage agents)** へ行き、エンドポイントの名前をクリックします。**コレクション(Collection)** タブをクリックします。次のような定義済のコレクション一覧が表示されます。 
 + 
 +{{ :wiki:pfms-endpoint-collection-01.png }}
  
 <WRAP center round info 90%> <WRAP center round info 90%>
  
-If a Software Agent has [[:es:documentation:03_monitoring:02_operations#remote_configuration|remote configuration]] disabled, it will show the following warning:{{ :wiki:pfms-software_agent-collection-02.png }}+If a EndPoint has [[:en:documentation:pandorafms:monitoring:02_operations#ks1_1_2|remote configuration]] disabled, it will show the following warning:
  
 +{{ :wiki:pfms-endpoint-collection-02.png }}
 +\\
 </WRAP> </WRAP>
  
 <WRAP center round info 90%> <WRAP center round info 90%>
  
-ソフトウエアエージェントの [[:ja:documentation:03_monitoring:02_operations#リモート設定|リモート設定]]が無効化されている場合は、次の警告が表示されます。{{  :wiki:pfms-software_agent-collection-02.png  }}+エンドポイントの [[:ja:documentation:pandorafms:monitoring:02_operations#リモート設定|リモート設定]]が無効化されている場合は、次の警告が表示されます。
  
 +{{ :wiki:pfms-endpoint-collection-02.png }}
 +\\
 </WRAP> </WRAP>
  
行 69: 行 75:
 コレクションを追加するには、**追加(Add)** 列の合計アイコンをクリックします:\\ コレクションを追加するには、**追加(Add)** 列の合計アイコンをクリックします:\\
  
-{{  :wiki:pfms-software_agent-collection-03.png  }}+{{ :wiki:pfms-endpoint-collection-03.png }}
  
 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. 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.
行 75: 行 81:
 **状態(Status)** 列に黄色の警告三角形のアイコンが表示される場合は、コレクションが空であるか、コレクションが同期されていません。 コレクションにファイルまたはディレクトリが含まれている場合は、黄色のアイコンをクリックします。 変更を適用すると、コレクションのステータスが同期の成功を示します。 **状態(Status)** 列に黄色の警告三角形のアイコンが表示される場合は、コレクションが空であるか、コレクションが同期されていません。 コレクションにファイルまたはディレクトリが含まれている場合は、黄色のアイコンをクリックします。 変更を適用すると、コレクションのステータスが同期の成功を示します。
  
-{{  :wiki:pfms-software_agent-collection-04.png  }}+{{ :wiki:pfms-endpoint-collection-04.png }}
  
-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.+After a few minutes you can go to <wrap :en>**Configuration → Collections**</wrap> and click the name of the added collection. The newly added EndPoint will be displayed in the agents tab.
  
-数分後、**設定(Configuration)** → **コレクション(Collections)** に移動し、追加したコレクションの名前をクリックします。 新しく追加されたソフトウェアエージェントがエージェントタブに表示されます。+数分後、**設定(Configuration)** → **コレクション(Collections)** に移動し、追加したコレクションの名前をクリックします。 新しく追加されたエンドポイントがエージェントタブに表示されます。
  
-{{  :wiki:pfms-software_agent-collection-05.png  }}+{{ :wiki:pfms-endpoint-collection-05.png }}
  
-==== ソフトウエアエージェントにおけるファイルコレクションの場所 ====+<wrap #ks1_2 /> 
 + 
 +==== エンドポイントにおけるファイルコレクションの場所 ====
  
 Each collection of files has a ''short name''. This means that the utilities, scripts or executables that are inside the collection will be in: Each collection of files has a ''short name''. This means that the utilities, scripts or executables that are inside the collection will be in:
行 102: 行 110:
 </file> </file>
  
-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:+It is important to know that the collection is compressed to be sent to the EndPoint, 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 では、このユーティリティは次の場所にインストールされています。+コレクションはエンドポイントへ圧縮して送信されるため、エンドポイントがファイルを解凍するためには **unzip.exe** ツールが必要です。 MS Windows® 用エンドポイント バージョン 3.2 では、このユーティリティは次の場所にインストールされています。
  
 <file> <file>
行 115: 行 123:
 完全な "実際の"パスを指定して、これらのファイルを利用してモジュールが動くようにする必要があることを理解してください。各コレクションファイルは異なる場所に保存され、異なるコレクションファイルが互いに上書きまたは競合するのを防ぎます。 完全な "実際の"パスを指定して、これらのファイルを利用してモジュールが動くようにする必要があることを理解してください。各コレクションファイルは異なる場所に保存され、異なるコレクションファイルが互いに上書きまたは競合するのを防ぎます。
  
-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.+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 EndPoint. This **MD5** will only be updated when changes occur in the collection on the Pandora FMS Web Console side, and not in the EndPoint. 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 ウェブコンソール側のコレクションに変更がある場合にのみ更新されます。 したがって、エージェントでローカルに行われたコレクションの変更は、コレクションがウェブコンソールで変更されない限りそのまま残ります。+コレクション制御システムは **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. 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.
行 123: 行 131:
 ウェブコンソール側でコレクションに変更が加えられると、md5 が再計算され、エージェント内の既存の設定と一致しない場合は、コレクションの最後の設定が適用され、以前の設定が上書きされ、コレクションに対してローカルで行った変更は破棄されます。 ウェブコンソール側でコレクションに変更が加えられると、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 [[:en:documentation:pandorafms:complex_environments_and_optimization:02_policy#agent_plugins|Plugin module]]:+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 the default PFMS collection:
  
-コレクションに含まれるファイルを使用するモジュールを使用する場合は、その固定識別子を使用して、コレクションを含むディレクトリのみを参照してください。 これは [[:ja:documentation:pandorafms:complex_environments_and_optimization:02_policy#エージェントプラグイン|プラグインモジュール]] を使用した例です:+コレクションに含まれるファイルを使用するモジュールを使用する場合は、コレクションを含むディレクトリのみを、その固定識別子を使用して参照します。以下は、デフォルトのPFMSコレクションを使用した例です。
  
-{{  :wiki:collection_module_usage_plugin.png  }}+{{  :wiki:pfms-endpoint-collection-04.png  }} 
 + 
 +<file> 
 +/usr/share/pandora_agent/collections/apache_plugin/pandora_apache_v1r1.pl 
 + 
 +</file> 
 + 
 +<wrap #ks1_3 />
  
 ==== ファイルコレクションと監視ポリシー ==== ==== ファイルコレクションと監視ポリシー ====
行 140: 行 155:
  
 コレクションを管理および同期するには、[[:ja:documentation:pandorafms:complex_environments_and_optimization:02_policy#ファイルコレクション|こちらを参照してください]]。 コレクションを管理および同期するには、[[:ja:documentation:pandorafms:complex_environments_and_optimization:02_policy#ファイルコレクション|こちらを参照してください]]。
 +
 +<wrap #ks1_4 />
  
 ==== サテライトサーバファイルコレクション ==== ==== サテライトサーバファイルコレクション ====
  
-Click on the **Servers** menu → **Manage servers** and then click on the remote configuration icon of the Satellite server to which the collection will be added. 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 +**. In the same way, you can delete the added collections by clicking the trash can icon.+<wrap :en>**Management → Servers → Manage Satellite server**</wrap> menu.
  
-**サーバ(Servers)** → **サーバ管理(Manage servers)** メニューをクリックし、コレクションが追加されるサテライトサーバのリモート設定アイコンをクリックします。 **コレクション(Collections)** タブをクリックし、使用可能なコレクションの一覧で、**アクション(Actions)** 列の + アイコンをクリックして、それぞれのコレクションを追加します。ごみ箱アイコンをクリックして、追加したコレクションを削除することもできます。+<wrap :ja>**管理(Management) → サーバ(Servers) → サテライトサーバ管理(Manage Satellite server)**</wrap> メニュー。
  
-{{  :wiki:pfms-servers-manage_servers-edit_satellite_remote_config-01.png  }}+{{  :wiki:pfms-servers-manage_servers-edit_satellite_collection-01.png  }}
  
-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.+Click on the <wrap :en>**Collections**</wrap> icon and in the list of available collections, in the <wrap :en>**Actions**</wrap> column add the respective collection by clicking on the icon **+**. In the same way, you can delete the added collections by clicking the trash can icon.
  
-変更を保存すると、数分後に、追加されたコレクションとそれぞれの短い名前で作成された新しいセクションが設定ファイルに表示されます。+<wrap :ja>**コレクション**</wrap>アイコンをクリックし、利用可能なコレクションのリストにある<wrap :ja>**アクション**</wrap>列で**+**アイコンをクリックして、該当するコレクションを追加します。同様に、ゴミ箱アイコンをクリックすると、追加したコレクションを削除できます。
  
-{{  :wiki:pfms-servers-manage_servers-edit_satellite_remote_config-02.png  }}+When saving the changes, after a few minutes, you will be able to see in the configuration file the new section created with the added collections and their respective short name.
  
-[[:en:documentation:pandorafms:complex_environments_and_optimization:02_policy#file_collections|See this section]] to manage and sync collections.+変更を保存すると、数分後に、追加されたコレクションとそれぞれの短縮名で作成された新しいセクションが設定ファイルに表示されます。 
 + 
 +{{  :wiki:pfms-servers-manage_servers-edit_satellite_collection-02.png  }} 
 + 
 +[[:en:documentation:pandorafms:complex_environments_and_optimization:02_policy#ks5|See this section]] to manage and sync collections.
  
 [[:ja:documentation:pandorafms:complex_environments_and_optimization:02_policy#ファイルコレクション|コレクションの管理と同期はこちらの章を参照してください。]] [[:ja:documentation:pandorafms:complex_environments_and_optimization:02_policy#ファイルコレクション|コレクションの管理と同期はこちらの章を参照してください。]]
  
-==== コマンドセンター(メタコンソール)でのファイルコレクション ====+<wrap #ks1_5 /> 
 + 
 +==== コマンドセンターでのファイルコレクション ====
  
 Starting with Pandora FMS 729, OUM can centralize collection management from [[:es:documentation:pandorafms:command_center:01_introduction|Command Center (Metaconsole)]]. To access it, go to the **Centralized management** menu → **Agent management** (**Centralized management** → **Agent management**) and click on the **Collections** tab. Starting with Pandora FMS 729, OUM can centralize collection management from [[:es:documentation:pandorafms:command_center:01_introduction|Command Center (Metaconsole)]]. To access it, go to the **Centralized management** menu → **Agent management** (**Centralized management** → **Agent management**) and click on the **Collections** tab.
  • ja/documentation/pandorafms/technical_annexes/28_pfms_file_collections.1738415723.txt.gz
  • 最終更新: 2025/02/01 13:15
  • by junichi