差分
このページの2つのバージョン間の差分を表示します。
両方とも前のリビジョン 前のリビジョン 次のリビジョン | 前のリビジョン | ||
ja:documentation:02_installation:04_configuration [2021/05/01 19:24] admscopia |
ja:documentation:02_installation:04_configuration [2023/05/16 08:31] (現在) |
||
---|---|---|---|
行 1: | 行 1: | ||
- | ====== Pandora FMS の設定 ====== | + | ====== Pandora FMS の設定 ====== |
{{indexmenu_n> | {{indexmenu_n> | ||
- | [[ja: | + | [[:ja: |
Pandora FMS には、コンソール、サーバ、データベースの 3つの基本的なコンポーネントがあり、それぞれ正しく動作させるためには設定が必要です。 | Pandora FMS には、コンソール、サーバ、データベースの 3つの基本的なコンポーネントがあり、それぞれ正しく動作させるためには設定が必要です。 | ||
- | {{pandora: | + | <WRAP center round tip 60%> |
+ | Pandora FMS の最適化については、[[: | ||
この章では、これら 3つのコンポーネントの設定について説明します。また、パフォーマンスを維持するために重要な、その他のコンポーネントについても説明します。 | この章では、これら 3つのコンポーネントの設定について説明します。また、パフォーマンスを維持するために重要な、その他のコンポーネントについても説明します。 | ||
- | ====== サーバ ====== | + | {{ : |
- | Pandora FMS サーバのデフォルトの設定ファイルは、ディレクトリ < | + | |
- | Pandora FMS バージョン 7.0NG 752 以降では、グラフィカルインターフェイスを使用して、Pandora FMS サーバに関連するいくつかの変更を行うことができます。(端末からも Web コンソールからも)プレーンテキストで設定ファイルにアクセスする必要はありません。 | + | ===== サーバ |
- | **これを行うには、リモート設定を < | + | Pandora FMS サーバのデフォルトの設定ファイルは、ディレクトリ |
- | {{ wiki: | + | Pandora FMS バージョン 7.0NG 752 以降では、グラフィカルインターフェイスを使用して、Pandora FMS サーバに関連するいくつかの変更を行うことができます。(端末からも Web コンソールからも)プレーンテキストで設定ファイルにアクセスする必要はありません。 |
- | 最初のセクション | + | **これを行うには、リモート設定を '' |
- | {{ wiki:server_editor_formulario.png ?800}} | + | {{ :wiki:servers-manage-servers-pandora-fms-servers-remote-configuration-icon.png?300 |
- | 2番目の設定部分では、最適化設定を行う **最適化設定(Optimization settings)** もあります。このセクションでは、タイムアウト時間やサーバ専用のスレッドなどのパラメータを変更できます。 | + | 最初のセクション |
- | そして最後に、他の設定用に予約されたスペース **他のサーバ設定(Other server settings)** があります。このセクションには、Pandora FMS 環境に追加されるエージェントが、作成時に特に指定されていない場合にデフォルトで割り当てられるグループ ID を指定することができます。システムに存在しないエージェント ID のデータを受信した場合にエージェントを自動作成するには、エージェントの自動作成を有効にします。 | + | {{ : |
- | ===== 設定ファイルの項目 ===== | + | 2番目の設定部分では、最適化設定を行う **最適化設定(Optimization settings)** もあります。このセクションでは、タイムアウト時間やサーバ専用のスレッドなどのパラメータを変更できます。 |
- | Pandora FMS の設定ファイルは、UNIX の基本的なプレーンテキストファイルになっています。< | + | |
+ | そして最後に、他の設定用に予約されたスペース **他のサーバ設定(Other server settings)** があります。このセクションには、Pandora FMS 環境に追加されるエージェントが、作成時に特に指定されていない場合にデフォルトで割り当てられるグループ ID を指定することができます。システムに存在しないエージェント ID のデータを受信した場合にエージェントを自動作成するには、エージェントの自動作成を有効にします。 | ||
+ | ==== 設定ファイルの項目 ==== | ||
+ | |||
+ | Pandora FMS の設定ファイルは、UNIX の基本的なプレーンテキストファイルになっています。'' | ||
+ | |||
+ | <WRAP center round info 60%> | ||
+ | === servername === | ||
- | ====servername==== | ||
コンソールに表示される Pandora FMS のサーバ名を設定します。デフォルトではコメントアウトされており、ホスト名が使われます。 | コンソールに表示される Pandora FMS のサーバ名を設定します。デフォルトではコメントアウトされており、ホスト名が使われます。 | ||
- | {{pandora: | + | <WRAP center round important 60%> |
+ | |||
+ | === incomingdir === | ||
- | ====incomingdir==== | + | XML データを受け取るディレクトリを設定します。デフォルトは、/// |
- | XML データを受け取るディレクトリを設定します。デフォルトは、/// | + | === log_file === |
- | ====log_file==== | ||
Pandora FMS サーバのログファイルを設定します。デフォルトは、/// | Pandora FMS サーバのログファイルを設定します。デフォルトは、/// | ||
+ | === snmp_logfile === | ||
- | ====snmp_logfile==== | + | Pandora FMS の SNMP コンソールログを設定します。デフォルトは、/// |
- | Pandora FMS の SNMP コンソールログを設定します。デフォルトは、/// | + | |
+ | === errorlog_file === | ||
- | ====errorlog_file==== | ||
Pandora FMS のエラーログを設定します。デフォルトは、/// | Pandora FMS のエラーログを設定します。デフォルトは、/// | ||
+ | === daemon === | ||
- | ====daemon==== | + | Pandora サーバをデーモンとして動作させるかどうかです。 |
- | Pandora サーバをデーモンとして動作させるかどうかです。' | + | |
- | ==== dbengine | + | < |
- | 常に ' | + | --D |
+ | |||
+ | </ | ||
+ | |||
+ | オプション付きでサーバを起動すると、デーモンとして実行されます。 | ||
+ | |||
+ | === dbengine === | ||
+ | |||
+ | 常に ' | ||
+ | === dbname === | ||
- | ====dbname==== | ||
接続するデータベース名です。デフォルトの値は ' | 接続するデータベース名です。デフォルトの値は ' | ||
- | ====dbuser==== | + | === dbuser === |
Pandora データベースに接続するユーザを設定します。デフォルトは、// | Pandora データベースに接続するユーザを設定します。デフォルトは、// | ||
+ | === dbpass === | ||
- | ====dbpass==== | ||
Pandora FMS データベースに接続する時のパスワードを設定します。 | Pandora FMS データベースに接続する時のパスワードを設定します。 | ||
- | ====dbhost==== | + | === dbhost === |
Pandora FMS データベースが動作するホストの IPアドレスかまたはホスト名を設定します。サーバと同一のホストにデータベースをインストールした場合は、127.0.0.1 です。 | Pandora FMS データベースが動作するホストの IPアドレスかまたはホスト名を設定します。サーバと同一のホストにデータベースをインストールした場合は、127.0.0.1 です。 | ||
- | ==== dbport ==== | + | === dbport === |
(オプション) データベースの接続ポートを指定する場合に利用します。コメントアウトされている場合は、デフォルトで 3306 が設定されます。 | (オプション) データベースの接続ポートを指定する場合に利用します。コメントアウトされている場合は、デフォルトで 3306 が設定されます。 | ||
- | ====daemon==== | + | === daemon === |
Pandora サーバをデーモンで動作させるかどうかを指定します。-D オプションを付けてサーバを起動した場合も、デーモンとして実行されます。 | Pandora サーバをデーモンで動作させるかどうかを指定します。-D オプションを付けてサーバを起動した場合も、デーモンとして実行されます。 | ||
- | ====verbosity==== | + | === verbosity === |
サーバログの詳細レベルです。設定可能範囲は 0(オフ) から 10(詳細レベル最大) です。10に設定すると、モジュール、プラグイン、アラートを含め、サーバが実行するすべてのログを表示します。 | サーバログの詳細レベルです。設定可能範囲は 0(オフ) から 10(詳細レベル最大) です。10に設定すると、モジュール、プラグイン、アラートを含め、サーバが実行するすべてのログを表示します。 | ||
- | {{pandora: | + | <WRAP center round important 60%> |
- | ====master==== | + | === master === |
- | マスターサーバの優先順位です。稼働しているサーバで最も値(正の整数です)の大きいものがマスターになります。同じ値の場合はランダムです。0 に設定した場合は、そのサーバはマスターにはなりません。より詳細は、[[Pandora:Documentation_ja:HA|冗長化構成(HA)]]の章を参照してください。 | + | |
+ | マスターサーバの優先順位です。稼働しているサーバで最も値(正の整数です)の大きいものがマスターになります。同じ値の場合はランダムです。0 に設定した場合は、そのサーバはマスターにはなりません。より詳細は、[[: | ||
+ | |||
+ | === snmpconsole === | ||
- | ====snmpconsole==== | ||
SNMP トラップコンソールを有効にする場合は 1 に設定します。無効にする場合は 0 を設定します。SNMP コンソールは、UNIX の// | SNMP トラップコンソールを有効にする場合は 1 に設定します。無効にする場合は 0 を設定します。SNMP コンソールは、UNIX の// | ||
- | ==== snmpconsole_threads ==== | + | === snmpconsole_threads === |
SNMP コンソールのスレッド数です。それぞれのスレッドが SNMP トラップを処理します。デフォルトは ' | SNMP コンソールのスレッド数です。それぞれのスレッドが SNMP トラップを処理します。デフォルトは ' | ||
- | ==== translate_variable_bindings | + | === snmpconsole_lock |
- | {{ wiki: | + | |
- | ==== translate_enterprise_strings ==== | + | '' |
- | {{ wiki: | + | |
- | ==== snmp_ignore_authfailure ==== | ||
- | 有効化(1)している場合、snmptrapd は " | ||
- | ==== snmp_pdu_address ==== | ||
- | 有効化(1)している場合、snmptrapd はエージェントのアドレスの代わりに pdu アドレスを読み込みます。デフォルトの値は 0 です。 | ||
- | ==== snmp_trapd | + | === translate_variable_bindings |
+ | |||
+ | {{: | ||
+ | |||
+ | === translate_enterprise_strings === | ||
+ | |||
+ | {{: | ||
+ | |||
+ | === snmp_ignore_authfailure === | ||
+ | |||
+ | 有効化('' | ||
+ | |||
+ | === snmp_pdu_address === | ||
+ | |||
+ | 有効化('' | ||
+ | |||
+ | === snmp_trapd | ||
snmp_trapd バイナリのパスです。manual に設定すると、サーバは snmp_trapd を起動しません。デフォルトの値は manual です。 | snmp_trapd バイナリのパスです。manual に設定すると、サーバは snmp_trapd を起動しません。デフォルトの値は manual です。 | ||
- | ==== snmp_forward_trap | + | === snmp_forward_trap === |
- | [[#.28.3E.3D_5.X.29_snmp_forward_ip|snmp_forward_ip]] で指定されたホストへの SNMP trap 転送を有効化(1) または無効化 (0) します。 | + | |
+ | [[#e3d_5x29_snmp_forward_ip|snmp_forward_ip]] で指定されたホストへの SNMP trap 転送を有効化(1) または無効化 (0) します。 | ||
+ | |||
+ | === snmp_forward_ip === | ||
- | ==== snmp_forward_ip ==== | ||
SNMP トラップの転送先ホストの IP アドレスです。 | SNMP トラップの転送先ホストの IP アドレスです。 | ||
- | {{pandora: | + | <WRAP center round important 60%> |
+ | |||
+ | === snmp_forward_version === | ||
- | ==== snmp_forward_version ==== | ||
SNMP トラップ転送で利用する SNMP バージョンです。このトークンでは以下の値が指定できます。 | SNMP トラップ転送で利用する SNMP バージョンです。このトークンでは以下の値が指定できます。 | ||
+ | |||
* 1 | * 1 | ||
* 2c | * 2c | ||
* 3 | * 3 | ||
- | ==== snmp_forward_secName ==== | + | === snmp_forward_secName === |
SNMP バージョン 3 用です。認証セキュリティ名を定義します。より詳細は、[[http:// | SNMP バージョン 3 用です。認証セキュリティ名を定義します。より詳細は、[[http:// | ||
- | ==== snmp_forward_engineid ==== | + | === snmp_forward_engineid === |
SNMP バージョン 3 用です。認証(セキュリティ)エンジン ID を定義します。より詳細は、[[http:// | SNMP バージョン 3 用です。認証(セキュリティ)エンジン ID を定義します。より詳細は、[[http:// | ||
- | ==== snmp_forward_authProtocol ==== | + | === snmp_forward_authProtocol === |
SNMP バージョン 3 用です。認証プロトコルを定義します。このトークンには、以下の値を指定できます。 | SNMP バージョン 3 用です。認証プロトコルを定義します。このトークンには、以下の値を指定できます。 | ||
- | *MD5 | + | |
- | *SHA | + | * SHA |
より詳細は、[[http:// | より詳細は、[[http:// | ||
- | ==== snmp_forward_authPassword ==== | + | === snmp_forward_authPassword === |
SNMP バージョン 3 用です。認証パスワードを定義します。より詳細は、[[http:// | SNMP バージョン 3 用です。認証パスワードを定義します。より詳細は、[[http:// | ||
- | ==== snmp_forward_privProtocol ==== | + | === snmp_forward_privProtocol === |
SNMP バージョン 3 用です。暗号化プロトコルを定義します。このトークンでは以下の値を設定できます。 | SNMP バージョン 3 用です。暗号化プロトコルを定義します。このトークンでは以下の値を設定できます。 | ||
- | *DES | + | |
- | *AES | + | * AES |
より詳細は、[[http:// | より詳細は、[[http:// | ||
- | ==== snmp_forward_privPassword ==== | + | === snmp_forward_privPassword === |
SNMP バージョン 3 用です。暗号化パスフレーズを定義します。より詳細は、[[http:// | SNMP バージョン 3 用です。暗号化パスフレーズを定義します。より詳細は、[[http:// | ||
- | ==== snmp_forward_secLevel ==== | + | === snmp_forward_secLevel === |
SNMP バージョン 3 用です。セキュリティレベルを定義します。このトークンには以下の値を設定できます。 | SNMP バージョン 3 用です。セキュリティレベルを定義します。このトークンには以下の値を設定できます。 | ||
- | *noAuthNoPriv | + | |
- | *authNoPriv | + | * authNoPriv |
- | *authPriv | + | * authPriv |
- | ==== snmp_forward_community | + | === snmp_forward_community === |
- | [[https:// | + | |
+ | [[https:// | ||
+ | |||
+ | === networkserver === | ||
- | ====networkserver==== | ||
Pandora FMS ネットワークサーバを有効にする場合は 1 に設定します。// | Pandora FMS ネットワークサーバを有効にする場合は 1 に設定します。// | ||
- | ====dataserver==== | + | === dataserver === |
Pandora FMS データサーバを有効にする場合は 1 に設定します。無効にする場合は 0 に設定します。 | Pandora FMS データサーバを有効にする場合は 1 に設定します。無効にする場合は 0 に設定します。 | ||
- | {{pandora: | + | <WRAP center round important 60%> |
+ | [[:ja:documentation: | ||
+ | </ | ||
+ | |||
+ | === dataserver_smart_queue === | ||
+ | |||
+ | <WRAP center round info 60%> | ||
+ | |||
+ | バージョン NG 765 以降 | ||
+ | |||
+ | </ | ||
+ | |||
+ | < | ||
+ | # Enable (1) or disable (0) the Data Server smart queue, which gives priority | ||
+ | # to new data coming from agents at the expense of buffered XML files. | ||
+ | dataserver_smart_queue 1 | ||
+ | |||
+ | </ | ||
+ | |||
+ | 有効化('' | ||
+ | |||
+ | === reconserver === | ||
+ | |||
+ | Pandora FMS [[: | ||
- | ====reconserver==== | + | === pluginserver |
- | Pandora FMS [[Pandora: | + | |
- | ====pluginserver==== | ||
Pandora FMS プラグインサーバを有効にする場合は 1 に設定します。// | Pandora FMS プラグインサーバを有効にする場合は 1 に設定します。// | ||
- | ====plugin_exec==== | + | === plugin_exec === |
- | タイムアウトを制御しプラグインを実行するプログラムの絶対パスの設定です。デフォルトは、/// | + | |
+ | タイムアウトを制御しプラグインを実行するプログラムの絶対パスの設定です。デフォルトは、/// | ||
+ | |||
+ | === predictionserver === | ||
- | ====predictionserver==== | ||
Pandora FMS 予測サーバを有効にする場合は 1 に設定します。無効にする場合は 0 に設定します。 | Pandora FMS 予測サーバを有効にする場合は 1 に設定します。無効にする場合は 0 に設定します。 | ||
- | ====wmiserver==== | + | === wmiserver === |
Pandora FMS WMI サーバを有効にする場合は 1 に設定します。無効にする場合は 0 に設定します。 | Pandora FMS WMI サーバを有効にする場合は 1 に設定します。無効にする場合は 0 に設定します。 | ||
- | ====network_timeout==== | + | === wmi_client |
+ | |||
+ | < | ||
+ | # WMI client binary (wmic by default). | ||
+ | #wmi_client pandorawmic | ||
+ | |||
+ | </ | ||
+ | |||
+ | wmic のフルパスです。デフォルトは ''/ | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | === syncserver === | ||
+ | |||
+ | < | ||
+ | # Sync Server | ||
+ | # | ||
+ | |||
+ | </ | ||
+ | |||
+ | Pandora FMS の[[: | ||
+ | |||
+ | === network_timeout | ||
ICMP 監視のタイムアウト(秒単位)です。デフォルトの値は 2 です。WAN の監視をする場合は、いくつかの監視でより多くの時間が必要となるため、誤検出を避けるためにこの値を増やすことをお勧めします。 | ICMP 監視のタイムアウト(秒単位)です。デフォルトの値は 2 です。WAN の監視をする場合は、いくつかの監視でより多くの時間が必要となるため、誤検出を避けるためにこの値を増やすことをお勧めします。 | ||
- | {{pandora: | + | <WRAP center round tip 60%> |
- | ====server_keepalive==== | + | === server_keepalive === |
- | サーバダウンと認識する時間を秒で設定します。各サーバは、サーバの状態をチェックしており、最新の更新よりここに指定した時間を経過すると、ダウンしているものと認識されます。これは、複数のサーバーがある場合の [[Pandora: | + | |
- | {{pandora: | + | サーバダウンと認識する時間を秒で設定します。各サーバは、サーバの状態をチェックしており、最新の更新よりここに指定した時間を経過すると、ダウンしているものと認識されます。これは、複数のサーバーがある場合の [[: |
- | ====thread_log==== | + | <WRAP center round tip 60%> 複数のサーバがある場合の基本ですが、全サーバの時計は NTP で同期する必要があります。 </ |
- | {{pandora: | + | |
- | 通常は ' | + | === thread_log === |
- | | + | <WRAP center round tip 60%> バージョン NG 7 以上 </ |
- | | + | |
- | | + | 通常は ' |
- | | + | |
- | | + | < |
- | | + | |
- | | + | / |
- | | + | |
- | | + | </ |
- | | + | |
- | | + | 例: |
- | | + | |
- | | + | < |
- | | + | [root_pandorafms]# |
- | | + | |
- | | + | |
- | | + | |
- | | + | |
- | | + | |
- | | + | |
- | | + | |
- | | + | |
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | |||
+ | </ | ||
+ | |||
+ | === server_threshold === | ||
- | ====server_threshold==== | ||
メインループの実行間隔を秒で設定します。デフォルト値は 5秒です。 | メインループの実行間隔を秒で設定します。デフォルト値は 5秒です。 | ||
- | {{pandora: | + | <WRAP center round tip 60%> |
- | {{pandora: | + | <WRAP center round important 60%> |
この値は、server_thread および max_queue_files パラメータとともに、サーバのパフォーマンス調整に使います。 | この値は、server_thread および max_queue_files パラメータとともに、サーバのパフォーマンス調整に使います。 | ||
- | ====network_threads==== | + | === network_threads === |
ネットワークサーバのスレッド数を設定します。これは、同時にいくつのチェックを実行するかを意味します。数値を増やすと、その分の処理能力が必要になります。20以上のスレッドでは、多くの CPU およびコアが必要です。 | ネットワークサーバのスレッド数を設定します。これは、同時にいくつのチェックを実行するかを意味します。数値を増やすと、その分の処理能力が必要になります。20以上のスレッドでは、多くの CPU およびコアが必要です。 | ||
- | ====icmp_checks==== | + | === icmp_checks === |
icmp_proc モジュールにおいて、ping を実行する数を設定します。モジュールの状態を正しく認識するためには、少なくとも ' | icmp_proc モジュールにおいて、ping を実行する数を設定します。モジュールの状態を正しく認識するためには、少なくとも ' | ||
- | {{pandora: | + | <WRAP center round tip 60%> |
1回の ping 実行の中で何回パケットを投げるかを設定する " | 1回の ping 実行の中で何回パケットを投げるかを設定する " | ||
- | ==== icmp_packets==== | + | === icmp_packets === |
一度の ping 要求で送信する ICMP パケットの数を定義します。デフォルトは 1です。 | 一度の ping 要求で送信する ICMP パケットの数を定義します。デフォルトは 1です。 | ||
- | ====tcp_checks==== | + | === tcp_checks === |
TCP の接続リトライ数を設定します。デフォルト値は 1です。 | TCP の接続リトライ数を設定します。デフォルト値は 1です。 | ||
- | ====tcp_timeout==== | + | === tcp_timeout === |
TCP 接続のタイムアウト値を設定します。デフォルト値は 30 です。 | TCP 接続のタイムアウト値を設定します。デフォルト値は 30 です。 | ||
- | {{pandora: | + | <WRAP center round tip 60%> |
+ | |||
+ | === snmp_checks === | ||
- | ====snmp_checks==== | ||
SNMP 接続のリトライ数を設定します。デフォルト値は 1 です。 | SNMP 接続のリトライ数を設定します。デフォルト値は 1 です。 | ||
- | ====snmp_timeout==== | + | === snmp_timeout === |
SNMP 接続のタイムアウト値を設定します。デフォルトは 3 です。 | SNMP 接続のタイムアウト値を設定します。デフォルトは 3 です。 | ||
- | {{pandora: | + | <WRAP center round tip 60%> |
+ | |||
+ | === snmp_proc_deadresponse === | ||
- | ====snmp_proc_deadresponse==== | ||
通常、(proc) などの SNMP ブーリアンデータの取得に失敗した場合や、NULL が返ってきた場合は、該当モジュールはダウンと認識しますが、このパラメータを 0 に設定することによりそれを無視します。 | 通常、(proc) などの SNMP ブーリアンデータの取得に失敗した場合や、NULL が返ってきた場合は、該当モジュールはダウンと認識しますが、このパラメータを 0 に設定することによりそれを無視します。 | ||
- | ====plugin_threads==== | + | === plugin_threads === |
サーバで実行するプラグインのスレッド数を設定します。同時にいくつのチェックを実行するかを示します。 | サーバで実行するプラグインのスレッド数を設定します。同時にいくつのチェックを実行するかを示します。 | ||
- | ====plugin_timeout==== | + | === plugin_timeout === |
プラグインのタイムアウト値です。この時間を超えると、モジュールは不明状態になります。デフォルトは 5 です。プラグインの実行に数秒かかるような場合は、この値を大きくする必要があります。 | プラグインのタイムアウト値です。この時間を超えると、モジュールは不明状態になります。デフォルトは 5 です。プラグインの実行に数秒かかるような場合は、この値を大きくする必要があります。 | ||
- | ====wmi_timeout==== | + | === wmi_timeout === |
WMI のタイムアウトを設定します。ここで設定した時間を越えると、モジュールは不明状態になります。デフォルトは 10 です。 | WMI のタイムアウトを設定します。ここで設定した時間を越えると、モジュールは不明状態になります。デフォルトは 10 です。 | ||
- | ====wmi_threads==== | + | === wmi_threads === |
- | [[Pandora: | + | |
- | ====recon_threads==== | + | [[:ja:documentation: |
- | [[Pandora:Documentation_ja:Architecture#.E8.87.AA.E5.8B.95.E6.A4.9C.E5.87.BA.28Recognition.29.E3.82.B5.E3.83.BC.E3.83.90|自動検出サーバ]] のスレッド数を設定します。同時にいくつのチェックを実行するかを示します。 | + | |
- | ====dataserver_threads==== | + | === recon_threads |
- | データサーバのスレッド数を指定します。同時にいくつの XML ファイルの処理を実行するかを示します。// | + | |
- | {{pandora:documentation_ja:tip|// | + | [[:ja:documentation: |
+ | |||
+ | === dataserver_threads === | ||
+ | |||
+ | データサーバのスレッド数を指定します。同時にいくつの XML ファイルの処理を実行するかを示します。// | ||
+ | |||
+ | <WRAP center round tip 60%> | ||
+ | |||
+ | サーバが処理する XML の数に応じて、通常は '' | ||
+ | |||
+ | </ | ||
+ | |||
+ | === mta_address === | ||
- | ====mta_address==== | ||
メールサーバ (MTA) の IP アドレスを設定します。 | メールサーバ (MTA) の IP アドレスを設定します。 | ||
- | {{pandora: | + | <WRAP center round important 60%> |
+ | |||
+ | < | ||
+ | nslookup -type = mx my.domain | ||
+ | </ | ||
- | //< | + | また、Pandora サーバからリダイレクトされるメールをメールサーバが受け取るかも確認してください。 |
- | また、Pandora | + | <WRAP center round important 60%> |
+ | 設定しない場合、[[: | ||
+ | </ | ||
- | {{pandora: | + | === mta_port === |
- | ====mta_port==== | ||
メールサーバのポート番号を設定します。 | メールサーバのポート番号を設定します。 | ||
- | ====mta_user==== | + | === mta_user === |
メールサーバのユーザを設定します。(認証に必要な場合) | メールサーバのユーザを設定します。(認証に必要な場合) | ||
- | ====mta_pass==== | + | === mta_pass === |
メールサーバのパスワードを設定します。(認証に必要な場合) | メールサーバのパスワードを設定します。(認証に必要な場合) | ||
- | ====mta_auth==== | + | === mta_auth === |
メールサーバの認証の仕組みを設定します。設定可能な値は、LOGIN PLAIN CRAM_MD5 DIGEST-MD です。(必要な場合) | メールサーバの認証の仕組みを設定します。設定可能な値は、LOGIN PLAIN CRAM_MD5 DIGEST-MD です。(必要な場合) | ||
- | ====mta_from==== | + | === mta_from === |
- | メールの発信元アドレスを設定します。デフォルトは、// | + | |
- | ====mail_in_separate==== | + | メールの発信元アドレスを設定します。デフォルトは、// |
- | デフォルトは 1です。1 に設定すると、メールは宛先毎に別便で送信されます。 | + | |
- | 0 に設定すると、すべての宛先を含む形で1通のメールを送信します。 | + | |
- | ====mta_encryption==== | + | === mail_in_separate |
- | {{pandora: | + | |
+ | デフォルトは 1です。1 に設定すると、メールは宛先毎に別便で送信されます。 0 に設定すると、すべての宛先を含む形で1通のメールを送信します。 | ||
+ | |||
+ | === mta_encryption === | ||
+ | |||
+ | <WRAP center round tip 60%> | ||
SMTP 接続の暗号化タイプです。(none, | SMTP 接続の暗号化タイプです。(none, | ||
- | ====xprobe2==== | + | === xprobe2 === |
- | これを定義すると、自動検出処理でのエージェント検出時にオペレーティングシステム情報検出に利用されます。デフォルトは、/// | + | |
+ | これを定義すると、自動検出処理でのエージェント検出時にオペレーティングシステム情報検出に利用されます。デフォルトは、/// | ||
+ | |||
+ | === nmap === | ||
+ | |||
+ | [[: | ||
+ | |||
+ | === fping === | ||
- | ====nmap==== | + | ICMP サーバに必要なプログラムの指定で、デフォルトは、'' |
- | [[Pandora: | + | |
- | ====fping==== | + | === nmap_timing_template |
- | ICMP サーバに必要なプログラムの指定で、デフォルトは、/// | + | |
- | ==== nmap_timing_template ==== | ||
1 から 5 の間で nmap がどの程度アグレッシブに動作するかを指定します。1 はゆっくりですが信頼性があります。5は早いですが信頼性は低くなります。デフォルトは 2です。 | 1 から 5 の間で nmap がどの程度アグレッシブに動作するかを指定します。1 はゆっくりですが信頼性があります。5は早いですが信頼性は低くなります。デフォルトは 2です。 | ||
- | ==== recon_timing_template ==== | + | === recon_timing_template === |
nmap_timing_template と同じですが、サテライトサーバおよび自動検出サーバのネットワークスキャンが対象となります。 | nmap_timing_template と同じですが、サテライトサーバおよび自動検出サーバのネットワークスキャンが対象となります。 | ||
- | ====snmpget==== | + | === snmpget === |
- | SNMP のチェックに必要なプログラムの指定で、デフォルトは、/// | + | |
- | ====braa==== | + | SNMP のチェックに必要なプログラムの指定で、デフォルトは、/// |
- | {{ wiki: | + | |
- | Enterprise SNMP サーバが必要とする | + | === braa === |
- | ====braa_retries==== | + | {{:wiki: |
- | {{ wiki: | + | |
- | モジュールがエラーだった場合に、braa にてモジュールを処理する前に、通常のネットワークサーバでリトライする回数を指定します。< | + | Enterprise SNMP サーバが必要とする |
- | ====fsnmp==== | + | === braa_retries |
- | {{pandora: | + | |
- | {{ wiki: | + | {{:wiki: |
- | Enterprise SNMP サーバが SNMPv3 リクエストで利用する pandorafsnmp バイナリのパスです。(/ | + | |
+ | モジュールがエラーだった場合に、braa にてモジュールを処理する前に、通常のネットワークサーバでリトライする回数を指定します。 | ||
+ | |||
+ | === fsnmp === | ||
+ | |||
+ | <WRAP center round tip 60%> バージョン NG 7 以上 </ | ||
+ | |||
+ | {{: | ||
+ | |||
+ | === autocreate_group === | ||
- | ====autocreate_group==== | ||
データファイル受信により新たなエージェントが作られた場合のデフォルトグループの設定です。ここでのグループの定義が無い場合は、エージェントは XML に含まれるグループで作成されます。 | データファイル受信により新たなエージェントが作られた場合のデフォルトグループの設定です。ここでのグループの定義が無い場合は、エージェントは XML に含まれるグループで作成されます。 | ||
- | ====autocreate_group_force==== | + | === autocreate_group_name |
+ | |||
+ | データファイルの受信を通じてデータサーバで作成された、新しいエージェントのデフォルトグループの名前。ここでグループを定義しない場合、エージェントは XML に含むグループに作成されます。 | ||
+ | |||
+ | < | ||
+ | # Works like autocreate_group, | ||
+ | # | ||
+ | |||
+ | </ | ||
+ | |||
+ | [[: | ||
+ | |||
+ | === autocreate_group_force | ||
1 に設定すると、新規エージェントは autocreate_group で指定されたグループに追加されます。(エージェントにより指定されたグループは、フォールバックとして利用されます) | 1 に設定すると、新規エージェントは autocreate_group で指定されたグループに追加されます。(エージェントにより指定されたグループは、フォールバックとして利用されます) | ||
行 352: | 行 514: | ||
例えば、次の設定の場合、可能な場合は XML データファイル内で指定されたグループに、そうでない場合は ID 10 のグループに新しいエージェントが所属します。 | 例えば、次の設定の場合、可能な場合は XML データファイル内で指定されたグループに、そうでない場合は ID 10 のグループに新しいエージェントが所属します。 | ||
+ | < | ||
| | ||
| | ||
- | ====autocreate==== | + | </ |
+ | |||
+ | === autocreate === | ||
この値を 1 に設定すると、システムに存在しないエージェントから XML ファイルを受信したときに、そのエージェントを自動作成します。 | この値を 1 に設定すると、システムに存在しないエージェントから XML ファイルを受信したときに、そのエージェントを自動作成します。 | ||
- | {{pandora: | + | <WRAP center round tip 60%> |
- | ====max_log_size==== | + | === max_log_size === |
- | Pandora FMS のログファイルの最大サイズをバイトで設定します。設定されたサイズに達すると、既存のファイルは // | + | |
+ | Pandora FMS のログファイルの最大サイズをバイトで設定します。設定されたサイズに達すると、既存のファイルは // | ||
+ | |||
+ | === max_queue_files === | ||
- | ====max_queue_files==== | ||
入力ディレクトリで指定したディレクトリから Pandora FMS データサーバが読み込む、XML ファイルの最大数です。これにより、データサーバが多くのファイルを読み込みサーバのパフォーマンスに影響を与えることを避けることができます。デフォルト値は 5000 です。 | 入力ディレクトリで指定したディレクトリから Pandora FMS データサーバが読み込む、XML ファイルの最大数です。これにより、データサーバが多くのファイルを読み込みサーバのパフォーマンスに影響を与えることを避けることができます。デフォルト値は 5000 です。 | ||
- | {{pandora: | + | <WRAP center round important 60%> |
- | ====use_xml_timestamp==== | + | === use_xml_timestamp === |
- | デフォルトは有効(1)で、日時(タイムスタンプ)に **XML 内**(.data) で定義されたものを利用します。つまり、タイプスタンプは、エージェントで生成されたものを利用します。 | + | |
- | 無効化(0)すると、XML ファイルのタイムスタンプ、つまり | + | デフォルトは有効(1)で、日時(タイムスタンプ)に **XML 内** (.data) で定義されたものを利用します。つまり、タイプスタンプは、エージェントで生成されたものを利用します。 |
- | {{pandora: | + | 無効化(0)すると、XML ファイルのタイムスタンプ、つまり **サーバのタイムスタンプ** を利用します。これは、エージェントによって生成された日付を **全体的に** |
- | {{pandora: | + | |
- | ====auto_restart==== | + | <WRAP center round important 60%> この処理は Pandora FMS バージョン 747 から変更されました。以前のバージョンでは、これはデフォルトで無効となっていました。 </ |
- | デフォルトでは 0 で、無効になっています。有効化すると(秒単位の値)、サーバは N秒ごとに内部的に再起動します(1日= 86400)。このオプションは、一部のスレッドまたは特定の Pandora FMS サーバの制御不能な障害が原因の問題が見られる場合に役立ちます。 | + | |
+ | <WRAP center round tip 60%> エージェントには、エージェントデータをファイルの受信日時で評価する似た機能があります。 </ | ||
+ | |||
+ | === auto_restart === | ||
+ | |||
+ | デフォルトでは 0 で、無効になっています。有効化すると(秒単位の値)、サーバは N秒ごとに内部的に再起動します(1日 = 86400)。このオプションは、一部のスレッドまたは特定の Pandora FMS サーバの制御不能な障害が原因の問題が見られる場合に役立ちます。 | ||
+ | |||
+ | === restart === | ||
- | ====restart==== | ||
デフォルトは 0 です。1 に設定すると、サーバにクリティカルなエラーが発生した場合に、設定した秒数後にサーバを再起動します。 | デフォルトは 0 です。1 に設定すると、サーバにクリティカルなエラーが発生した場合に、設定した秒数後にサーバを再起動します。 | ||
- | ====restart_delay==== | + | === restart_delay === |
- | デフォルトは 60 です。**restart** が有効に設定されているときに、サーバにクリティカルなエラーが発生したあとに再起動するまでの秒数を設定します。 | + | |
+ | デフォルトは 60 です。**restart** | ||
+ | |||
+ | === activate_gis === | ||
+ | |||
+ | [[: | ||
- | ==== activate_gis | + | === location_error |
- | [[Pandora: | + | |
- | ==== location_error ==== | ||
2つの GIS 位置情報を同一の位置と見なすマージン(メートル)です。 | 2つの GIS 位置情報を同一の位置と見なすマージン(メートル)です。 | ||
- | ==== recon_reverse_geolocation_file ==== | + | === recon_reverse_geolocation_file === |
- | 自動検出における逆ジオロケーションファイルです。これは、MaxMind GPL GeoLiteCity.dat フォーマットを用いた、逆ジオロケーション情報データベースファイルです。設定ファイルでこれが有効な場合は、自動検出およびソフトウエアエージェントを用いた場合のエージェント作成時の IP によるジオロケーションは無効化されます。ジオロケーションは、GIS 機能が全体で無効化されている場合(// | + | |
+ | 自動検出における逆ジオロケーションファイルです。これは、MaxMind GPL GeoLiteCity.dat フォーマットを用いた、逆ジオロケーション情報データベースファイルです。設定ファイルでこれが有効な場合は、自動検出およびソフトウエアエージェントを用いた場合のエージェント作成時の IP によるジオロケーションは無効化されます。ジオロケーションは、GIS 機能が全体で無効化されている場合(// | ||
+ | |||
+ | === recon_location_scatter_radius === | ||
- | ==== recon_location_scatter_radius ==== | ||
自動検出タスクで見つかったエージェントをランダムに配置する範囲の半径(メートル)です。円の中心は、IP の位置情報検出によって決まります。 | 自動検出タスクで見つかったエージェントをランダムに配置する範囲の半径(メートル)です。円の中心は、IP の位置情報検出によって決まります。 | ||
- | ====self_monitoring==== | + | === self_monitoring === |
- | サーバには、セルフモニタリングフラグがあります。これは、サーバ内に Pandora FMS サーバの重要なパラメータをモニタリングする仮想エージェントを作成します。これを有効化するには、// | + | |
- | ==== self_monitoring_interval ==== | + | サーバには、セルフモニタリングフラグがあります。これは、サーバ内に Pandora FMS サーバの重要なパラメータをモニタリングする仮想エージェントを作成します。これを有効化するには、// |
- | self_monitoring の時間間隔を秒単位で指定します。 | + | |
+ | === self_monitoring_interval === | ||
+ | |||
+ | [[: | ||
+ | |||
+ | === update_parent === | ||
- | ====update_parent==== | ||
XML で親の名前を送信してエージェントが親を更新できるかどうかを定義します。パラメータが設定されていないか 0 である場合はエージェント情報は無視されます。そうでない場合、サーバーが parent_name 属性を持つ XML を受信すると、サーバーはこの名前のエージェントを検索し、見つかった場合は XML エージェントの親を更新します。 | XML で親の名前を送信してエージェントが親を更新できるかどうかを定義します。パラメータが設定されていないか 0 である場合はエージェント情報は無視されます。そうでない場合、サーバーが parent_name 属性を持つ XML を受信すると、サーバーはこの名前のエージェントを検索し、見つかった場合は XML エージェントの親を更新します。 | ||
- | ==== wmi_client ==== | + | === wmi_client === |
デフォルトで利用する wmi クライアントです。 | デフォルトで利用する wmi クライアントです。 | ||
- | ==== google_maps_description ==== | + | === google_maps_description === |
GPS 座標をテキストの位置情報に変換します(逆ジオロケーション)。これには、Google マップの API を使います。この機能を使えるようにするためには、インターネットアクセスが必要です。また、Pandora FMS サーバから Google API への接続速度により GIS 情報処理のパフォーマンスに影響します。 | GPS 座標をテキストの位置情報に変換します(逆ジオロケーション)。これには、Google マップの API を使います。この機能を使えるようにするためには、インターネットアクセスが必要です。また、Pandora FMS サーバから Google API への接続速度により GIS 情報処理のパフォーマンスに影響します。 | ||
- | {{pandora: | + | <WRAP center round important 60%> |
+ | |||
+ | === openstreetmaps_description === | ||
- | ==== openstreetmaps_description ==== | ||
GPS 座標をテキストの位置情報に変換します(逆ジオロケーション)。これには、[[https:// | GPS 座標をテキストの位置情報に変換します(逆ジオロケーション)。これには、[[https:// | ||
- | {{pandora: | + | <WRAP center round tip 60%> |
- | ====webserver==== | + | === webserver === |
- | {{ wiki: | + | |
- | ウェブのチェック([[Pandora:Documentation_ja:Architecture# | + | {{:wiki:icono-modulo-enterprise.png |
- | ====web_threads==== | + | ウェブのチェック([[: |
- | {{ wiki: | + | |
+ | === web_threads === | ||
+ | |||
+ | {{:wiki: | ||
ウェブテストサーバ(Goliat)のスレッド数を設定します。このコンポーネントにいくつのスレッドを割り当てるかを示します。 | ウェブテストサーバ(Goliat)のスレッド数を設定します。このコンポーネントにいくつのスレッドを割り当てるかを示します。 | ||
- | ====web_timeout==== | + | === web_timeout === |
- | {{ wiki: | + | |
- | ウェブ監視モジュール(Goliat)のデフォルトタイムアウトを秒単位で指定します。< | + | {{: |
- | ====web_engine==== | + | ウェブ監視モジュール(Goliat)のデフォルトタイムアウトを秒単位で指定します。 |
- | {{ wiki: | + | |
- | バージョン 747 以降では、デフォルトで **curl** が利用されます。このパラメータを " | + | === web_engine === |
- | ====inventoryserver==== | + | {{:wiki: |
- | {{ wiki: | + | |
- | Pandora FMS リモートインベントリサーバを有効にする場合は 1 に設定します。//無効にする場合は 0 に設定します。// | + | バージョン 747 以降では、デフォルトで **curl** |
- | インベントリデータがエージェントからデータサーバに送信される場合は、リモートインベントリサーバを有効にする必要はありません。 | + | |
- | ====inventory_threads==== | + | === inventoryserver |
- | {{ wiki: | + | |
- | リモートインベントリサーバのスレッド数を設定します。< | + | {{: |
- | ====exportserver==== | + | Pandora FMS リモートインベントリサーバを有効にする場合は 1 に設定します。// |
- | {{ wiki: | + | |
- | Pandora FMS エクスポートサーバを有効にする場合は 1 に設定します。無効にする場合は 0 に設定します。< | + | === inventory_threads === |
- | ====export_threads==== | + | {{: |
- | {{ wiki: | + | |
+ | リモートインベントリサーバのスレッド数を設定します。 | ||
+ | |||
+ | === exportserver | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Pandora FMS エクスポートサーバを有効にする場合は 1 に設定します。無効にする場合は 0 に設定します。 | ||
+ | |||
+ | === export_threads === | ||
+ | |||
+ | {{:wiki: | ||
エクスポートサーバのスレッド数を設定します。このコンポーネントにいくつのスレッドを割り当てるかを示します。 | エクスポートサーバのスレッド数を設定します。このコンポーネントにいくつのスレッドを割り当てるかを示します。 | ||
- | ==== eventserver ==== | + | === eventserver === |
- | {{ wiki: | + | |
- | イベント収集サーバを有効(1)または無効(0)にします。(1がデフォルトです)< | + | {{: |
- | ====event_window | + | '' |
- | {{ wiki: | + | |
+ | === event_window === | ||
+ | |||
+ | {{:wiki: | ||
イベントサーバがイベントを探す時間範囲(秒)です。例えば、3600 に設定すると、イベントサーバは最新の 1時間以内に生成されたイベントをチェックします。時間範囲が長いルールがある場合は、この値を変更する必要があります。 非常に大きな値を設定すると、システムのパフォーマンスが低下し、操作に必要なリソース(CPU、RAM)が増えます。 | イベントサーバがイベントを探す時間範囲(秒)です。例えば、3600 に設定すると、イベントサーバは最新の 1時間以内に生成されたイベントをチェックします。時間範囲が長いルールがある場合は、この値を変更する必要があります。 非常に大きな値を設定すると、システムのパフォーマンスが低下し、操作に必要なリソース(CPU、RAM)が増えます。 | ||
- | ==== event_inhibit_alerts ==== | + | === event_inhibit_alerts === |
- | {{pandora: | + | |
+ | <WRAP center round tip 60%> | ||
1 に設定すると、最後に生成されたイベントが ' | 1 に設定すると、最後に生成されたイベントが ' | ||
- | ==== icmpserver | + | === icmpserver === |
- | {{ wiki: | + | |
+ | {{:wiki: | ||
Enterprise ICMP サーバを有効(1)または無効(0)にします。 | Enterprise ICMP サーバを有効(1)または無効(0)にします。 | ||
- | {{pandora: | + | <WRAP center round tip 60%> |
- | ====icmp_threads==== | + | === icmp_threads === |
- | {{ wiki: | + | |
- | ICMP Enterprise | + | {{: |
- | ==== snmpserver | + | ICMP Enterprise サーバのスレッド数を設定します。(3がデフォルトです) |
- | {{ wiki: | + | |
+ | === snmpserver === | ||
+ | |||
+ | {{:wiki: | ||
Pandora FMS SNMP サーバを有効(1)または無効(0)にします。 | Pandora FMS SNMP サーバを有効(1)または無効(0)にします。 | ||
- | {{pandora: | + | <WRAP center round tip 60%> |
+ | |||
+ | === snmp_threads === | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Enterprise SNMP サーバのスレッド数を設定します。(3がデフォルトです) | ||
+ | |||
+ | === transactionalserver === | ||
+ | |||
+ | <WRAP center round info 60%> | ||
+ | |||
+ | **バージョン NG 767 以前** | ||
- | ====snmp_threads==== | + | </ |
- | {{ wiki: | + | |
- | Enterprise | + | {{: |
- | ====transactionalserver==== | + | Pandora FMS トランザクションサーバを有効(1)または無効(0)にします。 |
- | {{ wiki: | + | |
- | Pandora FMS トランザクションサーバを有効(1)または無効(0)にします。< | + | === transactional_threads === |
- | ====transactional_threads==== | ||
デフォルトは 1です。このパラメータは単なるトランザクションの有無であり、値の変更によってトランザクションサーバの動作が変更されることはありません。 | デフォルトは 1です。このパラメータは単なるトランザクションの有無であり、値の変更によってトランザクションサーバの動作が変更されることはありません。 | ||
- | ====transactional_threshold==== | + | === transactional_threshold === |
トランザクションサーバがトランザクションにかける最大の秒数。 | トランザクションサーバがトランザクションにかける最大の秒数。 | ||
- | ====prediction_threads==== | + | === prediction_threads === |
予測サーバのスレッド数を設定します。 | 予測サーバのスレッド数を設定します。 | ||
- | ====block_size==== | + | === block_size === |
- | {{ wiki: | + | |
+ | {{:wiki: | ||
producer/ | producer/ | ||
- | ====dataserver_lifo==== | + | === dataserver_lifo === |
有効化(1)すると、XML データファイルはキューではなくスタックで処理され、古いデータ(モジュールの現在のタイムスタンプよりも古いタイムスタンプを持つデータ)は、イベントやアラートを発報しません。デフォルトの値は 0 です。 | 有効化(1)すると、XML データファイルはキューではなくスタックで処理され、古いデータ(モジュールの現在のタイムスタンプよりも古いタイムスタンプを持つデータ)は、イベントやアラートを発報しません。デフォルトの値は 0 です。 | ||
- | {{pandora: | + | <WRAP center round important 60%> |
+ | |||
+ | === policy_manager === | ||
- | ====policy_manager==== | ||
有効化(1)すると、サーバはポリシーキューを確認します。デフォルトの値は 1 です。 | 有効化(1)すると、サーバはポリシーキューを確認します。デフォルトの値は 1 です。 | ||
- | ====event_replication==== | ||
- | 有効化(1)した場合、イベントをメタコンソールへ複製する処理が実行されます。この処理は、コンソールで正しく設定されていない場合は有効化されません。デフォルトの値は 0 です。 | ||
- | ====event_auto_validation==== | + | |
+ | === event_auto_validation === | ||
有効化(1)した場合、同一モジュールで新たなイベントが発生すると以前のイベントを自動承諾します。デフォルトの値は 1 です。 | 有効化(1)した場合、同一モジュールで新たなイベントが発生すると以前のイベントを自動承諾します。デフォルトの値は 1 です。 | ||
- | ==== event_file ==== | + | === event_file === |
この設定により、Pandora FMS が生成するイベントを CSV フォーマットのテキストファイルに落とすことができます。このオプションを有効化すると、Pandora FMS のパフォーマンスが低下します。 | この設定により、Pandora FMS が生成するイベントを CSV フォーマットのテキストファイルに落とすことができます。このオプションを有効化すると、Pandora FMS のパフォーマンスが低下します。 | ||
例: | 例: | ||
+ | < | ||
- | event_file / | + | event_file / |
- | {{pandora: | + | </ |
+ | |||
+ | <WRAP center round important 60%> | ||
+ | |||
+ | === snmp_storm_protection === | ||
+ | |||
+ | < | ||
+ | # Set the maximum number of traps that will be processed | ||
+ | # from a single source in a configured time interval. | ||
+ | snmp_storm_protection 25 | ||
+ | |||
+ | </ | ||
- | ==== snmp_storm_protection ==== | ||
Pandora FMS の SNMP コンソールは、指定した時間間隔内では、ここで指定した数以上の同一発信元からのトラップを処理しません。この数に達した場合はイベントが生成されます。 | Pandora FMS の SNMP コンソールは、指定した時間間隔内では、ここで指定した数以上の同一発信元からのトラップを処理しません。この数に達した場合はイベントが生成されます。 | ||
- | ==== snmp_storm_timeout | + | === snmp_storm_silence_period |
+ | |||
+ | < | ||
+ | # Silenced time period in seconds, when trap storm is detected | ||
+ | snmp_storm_silence_period 300 | ||
+ | |||
+ | </ | ||
+ | |||
+ | このパラメータで、[[: | ||
+ | |||
+ | === snmp_storm_timeout | ||
snmp_storm_protection の時間間隔を秒単位で指定します。 | snmp_storm_protection の時間間隔を秒単位で指定します。 | ||
例えば、同一発信元からのトラップを 10分で 1000件までに制限する場合は次の通りです。 | 例えば、同一発信元からのトラップを 10分で 1000件までに制限する場合は次の通りです。 | ||
+ | < | ||
| | ||
| | ||
- | ==== text_going_down_normal ==== | + | </ |
+ | |||
+ | === text_going_down_normal === | ||
モジュールが正常状態になったときに生成されるイベントのテキスト。_module_ および _data_ マクロをサポートしています。 | モジュールが正常状態になったときに生成されるイベントのテキスト。_module_ および _data_ マクロをサポートしています。 | ||
- | ==== text_going_up_critical ==== | + | === text_going_up_critical === |
モジュールが障害状態になったときに生成されるイベントのテキスト。_module_ および _data_ マクロをサポートしています。 | モジュールが障害状態になったときに生成されるイベントのテキスト。_module_ および _data_ マクロをサポートしています。 | ||
- | ==== text_going_up_warning ==== | + | === text_going_up_warning === |
モジュールが正常状態から警告状態になったときに生成されるイベントのテキスト。_module_ および _data_ マクロをサポートしています。 | モジュールが正常状態から警告状態になったときに生成されるイベントのテキスト。_module_ および _data_ マクロをサポートしています。 | ||
- | ==== text_going_down_warning ==== | + | === text_going_down_warning === |
モジュールが障害状態から警告状態になったときに生成されるイベントのテキスト。_module_ および _data_ マクロをサポートしています。 | モジュールが障害状態から警告状態になったときに生成されるイベントのテキスト。_module_ および _data_ マクロをサポートしています。 | ||
- | ==== text_going_unknown ==== | + | === text_going_unknown === |
モジュールが不明状態になったときに生成されるイベントのテキスト。_module_ および _data_ マクロをサポートしています。 | モジュールが不明状態になったときに生成されるイベントのテキスト。_module_ および _data_ マクロをサポートしています。 | ||
- | ==== event_expiry_time ==== | + | === event_expiry_time === |
これに指定した時間(秒)より古いイベントが自動承諾されます。0 に設定するとこの機能は無効になります。 | これに指定した時間(秒)より古いイベントが自動承諾されます。0 に設定するとこの機能は無効になります。 | ||
例えば、生成後 10時間たった時点でイベントを自動承諾するには次のようにします。 | 例えば、生成後 10時間たった時点でイベントを自動承諾するには次のようにします。 | ||
- | event_expiry_time 36000 | + | < |
+ | event_expiry_time 36000 | ||
+ | |||
+ | </ | ||
+ | |||
+ | === event_expiry_window === | ||
- | ==== event_expiry_window ==== | ||
このパラメータは、event_expiry_time の影響を軽減するために利用します。イベントテーブル全体の検索をしなくなります。指定した期間(秒)の最近のイベントのみが自動的に承諾されます。この値は、event_expiry_time より大きい値である必要があります。 | このパラメータは、event_expiry_time の影響を軽減するために利用します。イベントテーブル全体の検索をしなくなります。指定した期間(秒)の最近のイベントのみが自動的に承諾されます。この値は、event_expiry_time より大きい値である必要があります。 | ||
デフォルト値は、1日です。 | デフォルト値は、1日です。 | ||
- | event_expiry_window 86400 | + | < |
+ | event_expiry_window 86400 | ||
- | ==== snmp_forward_ip ==== | + | </ |
- | SNMP trap の転送先ホストの IP アドレスです。 | + | |
- | {{pandora: | ||
- | ==== snmp_forward_community ==== | ||
- | 転送する時のコミュニティです。 | ||
- | ==== snmp_forward_version ==== | ||
- | SNMP trap を転送するときに使う SNMP のバージョンです。このトークンには次の値を指定できます。 | ||
- | * 1 | ||
- | * 2c | ||
- | * 3 | ||
- | ==== snmp_forward_secName ==== | ||
- | SNMP バージョン 3 の場合のみです。セキュリティ名を定義します。より詳細は、[[http:// | ||
- | ==== snmp_forward_engineid ==== | ||
- | SNMP バージョン 3 の場合のみです。認証(セキュリティ)エンジンIDを定義します。より詳細は、[[http:// | ||
- | ==== snmp_forward_authProtocol ==== | ||
- | SNMP バージョン 3 の場合のみです。認証プロトコルを定義します。このトークンには次の値を設定できます。 | ||
- | *MD5 | ||
- | *SHA | ||
- | より詳細は、[[http:// | ||
- | ==== snmp_forward_authPassword ==== | ||
- | SNMP バージョン 3 の場合のみです。認証パスフレーズを定義します。より詳細は、[[http:// | ||
- | ==== snmp_forward_privProtocol ==== | ||
- | SNMP バージョン 3 の場合のみです。暗号化プロトコルを定義します。このトークンには次の値を設定できます。 | ||
- | *DES | ||
- | *AES | ||
- | より詳細は、[[http:// | ||
- | ==== snmp_forward_privPassword ==== | ||
- | SNMP バージョン 3 の場合のみです。暗号化パスフレーズを定義します。より詳細は、[[http:// | ||
- | ==== snmp_forward_secLevel ==== | ||
- | SNMP バージョン 3 の場合のみです。セキュリティレベルを定義します。このトークンには次の値を設定できます。 | ||
- | *noAuthNoPriv | ||
- | *authNoPriv | ||
- | *authPriv | ||
- | より詳細は、[[http:// | ||
- | ==== claim_back_snmp_modules | + | |
- | {{ wiki: | + | |
+ | === claim_back_snmp_modules === | ||
+ | |||
+ | {{:wiki: | ||
1 に設定すると、データベースメンテナンススクリプト (pandora_db) 実行時に、ネットワークサーバで実行される SNMP モジュールが、Enterprise SNMP サーバへ渡されます。 | 1 に設定すると、データベースメンテナンススクリプト (pandora_db) 実行時に、ネットワークサーバで実行される SNMP モジュールが、Enterprise SNMP サーバへ渡されます。 | ||
- | ==== async_recovery ==== | + | === async_recovery === |
1 に設定すると、非同期モジュールがその実行間隔の 2倍の時間データを受信しなかったら正常状態になります。0 に設定するとその動作が無効にになります。 | 1 に設定すると、非同期モジュールがその実行間隔の 2倍の時間データを受信しなかったら正常状態になります。0 に設定するとその動作が無効にになります。 | ||
- | ==== console_api_url | + | === console_api_url === |
- | コンソールの API の URL です。通常は /// | + | |
+ | コンソールの API の URL です。通常は /// | ||
+ | |||
+ | === console_api_pass === | ||
- | ==== console_api_pass ==== | ||
コンソール API のパスワードです。パスワードは全体の設定セクションにあります。空の設定もできます。 | コンソール API のパスワードです。パスワードは全体の設定セクションにあります。空の設定もできます。 | ||
- | ==== console_user ==== | + | === console_user === |
要求されたアクションを実行する権限を持ったコンソールのユーザです。モジュールグラフイメージをアラートメールに挿入することができる必要があります。 | 要求されたアクションを実行する権限を持ったコンソールのユーザです。モジュールグラフイメージをアラートメールに挿入することができる必要があります。 | ||
- | {{pandora: | + | <WRAP center round tip 60%> |
- | ==== console_pass ==== | + | === console_pass === |
- | 前述のユーザのパスワードです。 | + | |
- | ====encryption_passphrase==== | + | [[: |
- | [[Pandora:Documentation_ja:Password_Encryption|暗号化パスワードの鍵を生成]]するために利用する暗号化フレーズです。デフォルトではコメントアウトされています。 | + | |
+ | === encryption_passphrase === | ||
+ | |||
+ | [[:ja: | ||
+ | |||
+ | === unknown_events === | ||
+ | |||
+ | 有効化('' | ||
+ | |||
+ | === unknown_interval === | ||
- | ==== unknown_interval ==== | ||
モジュールが不明状態になるまでの時間間隔(モジュール実行間隔の倍数)。デフォルトでは、モジュール実行間隔の 2倍です。 | モジュールが不明状態になるまでの時間間隔(モジュール実行間隔の倍数)。デフォルトでは、モジュール実行間隔の 2倍です。 | ||
- | ==== global_alert_timeout ==== | + | === global_alert_timeout === |
アラートの最大処理時間を秒単位で定義します。この時間を超えると実行が中断されます。デフォルトでは 15秒です。この値を 0 に設定すると、Pandora サーバはアラートの実行を中断しません。 | アラートの最大処理時間を秒単位で定義します。この時間を超えると実行が中断されます。デフォルトでは 15秒です。この値を 0 に設定すると、Pandora サーバはアラートの実行を中断しません。 | ||
- | ==== remote_config ==== | + | === remote_config === |
- | {{ wiki: | + | |
- | このパラメータで、コンソールの管理画面からリモートでのサーバの設定可否を設定します。Tentacle によって、エージェントのリモート設定のように動きます。 | + | {{: |
+ | |||
+ | このパラメータで、コンソールの管理画面からリモートでのサーバの設定可否を設定します。'' | ||
+ | |||
+ | === remote_config_address === | ||
- | ==== remote_config_address ==== | ||
リモート設定ファイルを送信する IP アドレスです。デフォルトでは localhost です。 | リモート設定ファイルを送信する IP アドレスです。デフォルトでは localhost です。 | ||
- | ==== remote_config_port ==== | + | === remote_config_port === |
リモート設定のための tentacle ポートです。デフォルトは 41121 です。 | リモート設定のための tentacle ポートです。デフォルトは 41121 です。 | ||
- | ==== remote_config_opts | + | === tentacle_service_watchdog |
- | 拡張設定のための tentacle クライアントに与える追加パラメータです。"" | + | |
+ | <WRAP center round info 60%> | ||
+ | |||
+ | [[: | ||
+ | |||
+ | < | ||
+ | |||
+ | # Enable (1) or disable (0) the Tentacle Server watchdog (enabled by default). | ||
+ | tentacle_service_watchdog 1 | ||
+ | |||
+ | </ | ||
+ | |||
+ | === remote_config_opts === | ||
+ | |||
+ | 拡張設定のための tentacle クライアントに与える追加パラメータです。" | ||
+ | |||
+ | === warmup_event_interval === | ||
- | ==== warmup_event_interval ==== | ||
サーバ起動後から指定した秒数の間、モジュールの状態変化イベントを発生させないようにし、かつモジュールアラートを実行しないようにします。 | サーバ起動後から指定した秒数の間、モジュールの状態変化イベントを発生させないようにし、かつモジュールアラートを実行しないようにします。 | ||
- | ==== warmup_unknown_interval ==== | + | === warmup_unknown_interval === |
サーバ起動後から指定した秒数の間、モジュールが不明状態にならないようにします。 | サーバ起動後から指定した秒数の間、モジュールが不明状態にならないようにします。 | ||
- | ==== enc_dir ==== | + | === enc_dir === |
- | XML parser 用の追加の [[http:// | + | |
- | ==== dynamic_updates | + | XML parser 用の追加の [[http:// |
- | {{pandora: | + | === dynamic_updates === |
+ | |||
+ | <WRAP center round tip 60%> | ||
動的間隔の間に動的しきい値を何回再計算するかです。 | 動的間隔の間に動的しきい値を何回再計算するかです。 | ||
- | ==== dynamic_warning ==== | + | === dynamic_warning === |
- | {{pandora: | + | |
+ | <WRAP center round tip 60%> | ||
動的な警告しきい値の計算に利用される障害間隔の長さに対するパーセンテージです。値が小さいと、障害と警告のしきい値は近くなります。 | 動的な警告しきい値の計算に利用される障害間隔の長さに対するパーセンテージです。値が小さいと、障害と警告のしきい値は近くなります。 | ||
- | ==== dynamic_constant ==== | + | === dynamic_constant === |
- | {{pandora: | + | |
+ | <WRAP center round tip 60%> | ||
変わらないデータに対するモジュールの標準偏差を調整するために使用されるモジュールの平均に対する割合。大きい値にすると、動的しきい値の間隔が広くなります。 | 変わらないデータに対するモジュールの標準偏差を調整するために使用されるモジュールの平均に対する割合。大きい値にすると、動的しきい値の間隔が広くなります。 | ||
- | ====unknown_updates==== | + | === unknown_updates === |
- | {{pandora: | + | |
+ | <WRAP center round tip 60%> | ||
デフォルトは 0です。1に設定すると、不明モジュールが不明になった時一度だけでなく定期的に更新されます。不明モジュールに関連付けられたアラートも定期的に評価されます。 | デフォルトは 0です。1に設定すると、不明モジュールが不明になった時一度だけでなく定期的に更新されます。不明モジュールに関連付けられたアラートも定期的に評価されます。 | ||
- | {{pandora: | + | <WRAP center round important 60%> |
- | ==== wuxserver ==== | + | === wuxserver === |
- | {{pandora: | + | |
- | {{ wiki: | + | <WRAP center round tip 60%> バージョン NG 7 以上 </ |
+ | |||
+ | {{:wiki: | ||
ウェブユーザエクスペリエンス分析(WUX)サーバを有効化します。wux_host および wux_port の設定が必要です。 | ウェブユーザエクスペリエンス分析(WUX)サーバを有効化します。wux_host および wux_port の設定が必要です。 | ||
- | ====wux_host==== | + | === wux_host === |
- | {{pandora:documentation_ja:tip|バージョン NG 7 以上}} | + | |
+ | <WRAP center round tip 60%> バージョン NG 7 以上 </ | ||
+ | |||
+ | {{:wiki:icono-modulo-enterprise.png | ||
+ | |||
+ | Pandora ウェブロボットデーモンサービス(PWRD)を動かすサーバの IP アドレス/ | ||
+ | |||
+ | === wux_port === | ||
+ | |||
+ | <WRAP center round tip 60%> | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Pandora ウェブロボットデーモンサービス(PWRD)のポート番号を指定します。デフォルトは 4444 です。 | ||
+ | |||
+ | === wux_webagent_timeout === | ||
+ | |||
+ | <WRAP center round tip 60%> バージョン NG 7 以上 </ | ||
+ | |||
+ | 宛先 Web アドレスと Selenium サーバに接続するための最大時間。デフォルトでは、値 '' | ||
+ | |||
+ | === wux_timeout === | ||
+ | |||
+ | <WRAP center round tip 60%> | ||
- | {{ wiki: | + | 最大 WUX トランザクション時間。デフォルト値は、'' |
- | Pandora ウェブロボットデーモンサービス(PWRD)を動かすサーバの IP アドレス/ | + | === clean_wux_sessions === |
- | ====wux_port==== | + | < |
- | {{pandora: | + | # Force closing previous sessions on remote wux_host, |
+ | # only for Selenium Grid server 3. | ||
+ | # | ||
- | {{ wiki: | + | </ |
- | Pandora ウェブロボットデーモンサービス(PWRD)のポート番号を指定します。デフォルトは 4444 です。< | + | このパラメータを有効化('' |
- | ==== wux_webagent_timeout==== | + | === syslogserver |
- | {{pandora: | + | |
- | 宛先 Web アドレスと Selenium サーバに接続するための最大時間。デフォルトでは、値 | + | <WRAP center round tip 60%> バージョン NG 7 以上 |
- | ====syslogserver==== | + | {{:wiki:icono-modulo-enterprise.png |
- | {{pandora:documentation_ja:tip|バージョン NG 7 以上}} | + | |
- | {{ wiki: | + | ' |
- | ' | + | === syslog_file === |
- | ====syslog_file==== | + | {{:wiki: |
- | {{ wiki: | + | |
syslog 出力ファイルのフルパスです。例: | syslog 出力ファイルのフルパスです。例: | ||
- | | + | < |
- | ====syslog_threads==== | + | syslog_file / |
- | {{pandora: | + | |
- | {{ wiki: | + | </ |
- | Syslog サーバのスレッド数です。< | + | === syslog_threads === |
- | ====syslog_max==== | + | <WRAP center round tip 60%> |
- | {{pandora: | + | |
- | {{ wiki: | + | {{:wiki: |
- | Syslog サーバが一度に読むファイルの最大行数です。< | + | Syslog サーバのスレッド数です。 |
- | ====sync_port | + | === syslog_max |
- | [[Pandora: | + | |
- | ==== sync_ca ==== | + | <WRAP center round tip 60%> バージョン NG 7 以上 |
- | [[Pandora: | + | |
- | ==== sync_cert ==== | + | {{:wiki:icono-modulo-enterprise.png |Enterprise 版}} |
- | [[Pandora:Documentation_ja:syncserver_Monitoring|同期サーバ]]の SSI 通信設定のためのサーバ証明書のパスです。デフォルトでは、< | + | |
- | ==== sync_key ==== | + | Syslog |
- | [[Pandora: | + | |
- | ==== sync_retries | + | === sync_port |
- | [[Pandora: | + | |
- | ====sync_timeout ==== | + | [[:ja:documentation: |
- | [[Pandora:Documentation_ja:syncserver_Monitoring|同期サーバ]]の接続最大タイムアウトです。デフォルトでは、値 | + | |
- | ====sync_address==== | + | === sync_ca |
- | [[Pandora: | + | |
- | ====logstash_host==== | + | [[:ja: |
- | {{ wiki:icono-modulo-enterprise.png|Enterprise 版}} | + | |
- | logstash をインストールしたマシンの名前もしくは IP アドレス。< | + | === sync_cert === |
- | ====logstash_port==== | + | [[:ja: |
- | {{ wiki:icono-modulo-enterprise.png|Enterprise 版}} | + | |
- | logstash をインストールしたマシンのポート番号。< | + | === sync_key === |
+ | |||
+ | [[: | ||
+ | |||
+ | === sync_retries === | ||
+ | |||
+ | [[: | ||
+ | |||
+ | === sync_timeout === | ||
+ | |||
+ | [[: | ||
+ | |||
+ | === sync_address === | ||
+ | |||
+ | [[: | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | === ha_interval === | ||
- | ====ha_interval==== | ||
秒単位の Pandora FMS HA データベースツールの実行間隔。デフォルトでは 30 の記載でコメントアウトされています。 | 秒単位の Pandora FMS HA データベースツールの実行間隔。デフォルトでは 30 の記載でコメントアウトされています。 | ||
- | ====ha_monitoring_interval==== | + | === ha_monitoring_interval === |
秒単位の Pandora FMS HA データベースツールの監視間隔。デフォルトでは 60 の記載でコメントアウトされています。 | 秒単位の Pandora FMS HA データベースツールの監視間隔。デフォルトでは 60 の記載でコメントアウトされています。 | ||
- | ====provisioningserver==== | + | === provisioningserver === |
- | {{pandora: | + | |
- | {{ wiki: | + | <WRAP center round tip 60%> バージョン NG 7 以上 </ |
- | ' | + | {{: |
- | ====provisioningserver_threads==== | + | '' |
- | {{pandora:documentation_ja:tip|バージョン | + | |
- | {{ wiki: | + | === provisioningserver_threads === |
- | Pandora FMS プロビジョニングサーバのスレッド数です。< | + | <WRAP center round tip 60%> バージョン |
- | ====provisioning_cache_interval==== | + | {{:wiki:icono-modulo-enterprise.png |
- | {{pandora:documentation_ja:tip|バージョン NG 7 以上}} | + | |
- | {{ wiki:icono-modulo-enterprise.png|Enterprise 版}} | + | Pandora FMS [[:ja: |
- | プロビジョニングサーバのキャッシュリフレッシュ間隔を秒(デフォルトは 500)で指定します。キャッシュは、設定済の全 Pandora FMS ノードを含みます。 | + | === provisioning_cache_interval === |
- | ==== ssh_launcher ==== | + | <WRAP center round tip 60%> |
- | {{pandora: | + | |
- | リモート実行モジュールを実行するスクリプト < | + | {{: |
- | / | + | [[: |
- | <br> | + | === ssh_launcher === |
- | {{pandora: | + | <WRAP center round tip 60%> バージョン NG 743 以上 |
- | ==== rcmd_timeout ==== | + | リモート実行モジュールを実行するスクリプト **ssh_launcher.sh** |
- | {{pandora: | + | < |
+ | |||
+ | / | ||
+ | |||
+ | </ | ||
+ | |||
+ | <WRAP center round tip 60%> Linux システムの **el6** | ||
+ | |||
+ | === rcmd_timeout === | ||
+ | |||
+ | <WRAP center round tip 60%> | ||
秒単位でのリモート実行モジュールの最大実行時間です。デフォルトは 10 です。 | 秒単位でのリモート実行モジュールの最大実行時間です。デフォルトは 10 です。 | ||
- | {{pandora: | + | <WRAP center round important 60%> |
- | ==== rcmd_timeout_bin ==== | + | === rcmd_timeout_bin === |
- | {{pandora: | + | |
- | リモート実行モジュールのタイムアウト処理を実行するファイルへの絶対パスを示します。 これは、< | + | <WRAP center round tip 60%> バージョン NG 743 以上 |
- | * < | + | リモート実行モジュールのタイムアウト処理を実行するファイルへの絶対パスを示します。 これは、[[: |
- | | + | * **Windows** |
+ | < | ||
+ | C: | ||
- | * < | + | </code> |
- | / | + | * **Linux** |
+ | < | ||
+ | / | ||
- | ==== user および group ==== | + | </ |
- | {{pandora: | + | |
+ | === user および group === | ||
+ | |||
+ | <WRAP center round tip 60%> | ||
Pandora FMS バージョン 7 から、カスタムインストールでは、" | Pandora FMS バージョン 7 から、カスタムインストールでは、" | ||
- | ===== 環境変数 ===== | + | === alertserver |
- | Pandora FMS サーバは、設定ファイルでの設定以外にもいくつかのオプションがあります。特定のケースでは、マシン自体で設定を行うため環境変数が必要です。これには、サーバの起動スクリプトで //bash// の書式で書かれた変数のファイルを読み込みます。デフォルトでは、/// | + | |
+ | <WRAP center round tip 60%> | ||
+ | |||
+ | < | ||
+ | # Enable (1) or disable (0) Pandora FMS Alert Server. | ||
+ | alertserver 0 | ||
+ | |||
+ | </ | ||
+ | |||
+ | **Pandora FMS アラートサーバ** を有効化('' | ||
+ | |||
+ | === alertserver_threads === | ||
+ | |||
+ | <WRAP center round tip 60%> | ||
+ | |||
+ | < | ||
+ | # Pandora FMS Alert Server threads. | ||
+ | alertserver_threads 4 | ||
+ | |||
+ | </ | ||
+ | |||
+ | Pandora FMS **アラートサーバ** スレッドです。デフォルトは、4 です。 | ||
+ | |||
+ | === alertserver_warn === | ||
+ | |||
+ | <WRAP center round tip 60%> | ||
+ | |||
+ | < | ||
+ | # Generate an hourly warning event if alert execution is | ||
+ | # being delayed more than alertserver_warn seconds. | ||
+ | alertserver_warn 180 | ||
+ | |||
+ | </ | ||
+ | |||
+ | アラートの実行が '' | ||
+ | |||
+ | === dbssl === | ||
+ | |||
+ | < | ||
+ | dbssl 0 | ||
+ | |||
+ | </ | ||
+ | |||
+ | データベース接続における SSL の有効化('' | ||
+ | |||
+ | <WRAP center round info 60%> | ||
+ | |||
+ | === dbsslcafile === | ||
+ | |||
+ | < | ||
+ | # dbsslcafile | ||
+ | |||
+ | </ | ||
+ | |||
+ | 信頼できるSSL [[https:// | ||
+ | |||
+ | <WRAP center round info 60%> | ||
+ | |||
+ | === dbsslcapath === | ||
+ | |||
+ | < | ||
+ | # dbsslcapath | ||
+ | |||
+ | </ | ||
+ | |||
+ | [[https:// | ||
+ | |||
+ | <WRAP center round info 60%> | ||
+ | |||
+ | === verify_mysql_ssl_cert | ||
+ | |||
+ | <WRAP center round info 60%> | ||
+ | |||
+ | バージョン NG 766 以降 | ||
+ | |||
+ | </ | ||
+ | |||
+ | < | ||
+ | |||
+ | verify_mysql_ssl_cert 0 | ||
+ | |||
+ | </ | ||
+ | |||
+ | '' | ||
+ | |||
+ | === splitbrain_autofix === | ||
+ | |||
+ | < | ||
+ | # Pandora FMS HA MySQL cluster splitbrain auto-recovery (PANDORA FMS ENTERPRISE ONLY) | ||
+ | # IMPORTANT! Please understand and configure all settings from pandora_console/ | ||
+ | sec=gservers& | ||
+ | # before enable this feature. | ||
+ | # | ||
+ | |||
+ | </ | ||
+ | |||
+ | これは、両方のノードがメインまたは // | ||
+ | |||
+ | <WRAP center round info 60%>\\ | ||
+ | Pandora FMS HA の操作に関しては、[[: | ||
+ | </ | ||
+ | |||
+ | **サーバ(サーバ)** → **データベースHA管理(Manage database HA)** → **セットアップ(Setup)** の全値を理解し設定する必要があります: | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | <WRAP center round info 60%>\\ | ||
+ | 詳細については、[[: | ||
+ | </ | ||
+ | |||
+ | === ha_max_splitbrain_retries === | ||
+ | |||
+ | < | ||
+ | # Pandora FMS HA MySQL cluster splitbrain auto-recovery settings (PANDORA FMS ENTERPRISE ONLY) | ||
+ | # Maximum number of retries | ||
+ | # | ||
+ | |||
+ | </ | ||
+ | |||
+ | // | ||
+ | |||
+ | <WRAP center round info 60%>\\ | ||
+ | 詳細については、[[: | ||
+ | </ | ||
+ | |||
+ | === ha_max_resync_wait_retries === | ||
+ | |||
+ | < | ||
+ | # Pandora FMS HA MySQL cluster splitbrain auto-recovery settings (PANDORA FMS ENTERPRISE ONLY) | ||
+ | # Maximum number of retries to verify resync status. | ||
+ | # | ||
+ | |||
+ | </ | ||
+ | |||
+ | // | ||
+ | |||
+ | <WRAP center round info 60%>\\ | ||
+ | 詳細については、[[: | ||
+ | </ | ||
+ | |||
+ | === ha_resync_sleep === | ||
+ | |||
+ | < | ||
+ | # Pandora FMS HA MySQL cluster splitbrain auto-recovery settings (PANDORA FMS ENTERPRISE ONLY) | ||
+ | # Maximum number of seconds waiting while verifying resync status. | ||
+ | # | ||
+ | |||
+ | </ | ||
+ | |||
+ | 上記のトークンで設定されたリトライ間の秒数です。両方のパラメーターは // | ||
+ | |||
+ | <WRAP center round info 60%>\\ | ||
+ | 詳細については、[[: | ||
+ | </ | ||
+ | |||
+ | === ncmserver === | ||
+ | < | ||
+ | |||
+ | # Network manager configuration server (PANDORA FMS ENTERPRISE ONLY). | ||
+ | ncmserver 1 | ||
+ | |||
+ | </ | ||
+ | |||
+ | {{: | ||
+ | |||
+ | |||
+ | === ncmserver_threads === | ||
+ | < | ||
+ | |||
+ | # Threads for NCM server (PANDORA FMS ENTERPRISE ONLY). | ||
+ | ncmserver_threads 1 | ||
+ | |||
+ | </ | ||
+ | |||
+ | {{: | ||
+ | |||
+ | === ncm_ssh_utility === | ||
+ | < | ||
+ | |||
+ | # NCM utility to execute SSH and Telnet connections. | ||
+ | ncm_ssh_utility / | ||
+ | |||
+ | </ | ||
+ | |||
+ | {{: | ||
+ | ''/ | ||
+ | |||
+ | このバイナリは、NCM サーバの設定において Telnet または SSH でネットワークデバイスへ接続するために利用されます。 | ||
+ | |||
+ | === correlationserver === | ||
+ | < | ||
+ | |||
+ | # Enable (1) or disable (0) Pandora FMS Correlation Server | ||
+ | # (PANDORA FMS ENTERPRISE ONLY). | ||
+ | correlationserver 0 | ||
+ | |||
+ | </ | ||
+ | |||
+ | {{: | ||
+ | |||
+ | < | ||
+ | |||
+ | eventserver 0 | ||
+ | correlationserver 1 | ||
+ | |||
+ | </ | ||
+ | |||
+ | このサーバは、相関するアラートを時間間隔で評価し、多数の同時イベントが発生する環境でワークキューを最適化します。 | ||
+ | |||
+ | 有効化されている場合は、アラートの **pass** および **drop** は影響しません(常に **pass** として評価されます)。イベントプールおよびログの評価は、'' | ||
+ | |||
+ | このサーバには、**アラートルールのいずれかに準拠する**評価プールにイベントまたはログがなくなるたびに、相関アラート回復の仕組みが組み込まれています。アラートが取得されると、アクションで定義された '// | ||
+ | |||
+ | === correlation_threshold === | ||
+ | |||
+ | < | ||
+ | # Time in seconds to re-evaluate correlation alerts pool | ||
+ | # (PANDORA FMS ENTERPRISE ONLY). | ||
+ | correlation_threshold 30 | ||
+ | |||
+ | </ | ||
+ | |||
+ | {{: | ||
+ | |||
+ | === preload_windows === | ||
+ | |||
+ | < | ||
+ | # Pre-load windows on start with available information. | ||
+ | # (PANDORA FMS ENTERPRISE ONLY). | ||
+ | # | ||
+ | |||
+ | </ | ||
+ | |||
+ | {{: | ||
+ | Pandora FMS サーバを起動した際に、相関アラートを評価するために '' | ||
+ | これを無効にすると、'' | ||
+ | |||
+ | === discoveryserver === | ||
+ | |||
+ | < | ||
+ | # Activate (1) Pandora FMS Discovery server | ||
+ | discoveryserver 1 | ||
+ | |||
+ | </ | ||
+ | |||
+ | この設定パラメータは、[[: | ||
+ | |||
+ | === elastic_query_size === | ||
+ | |||
+ | < | ||
+ | # Log retrieving, items per request. | ||
+ | elastic_query_size 10 | ||
+ | |||
+ | </ | ||
+ | |||
+ | Elasticsearch を使用した[[: | ||
+ | |||
+ | === event_server_cache_ttl === | ||
+ | |||
+ | < | ||
+ | # Correlated Alerts, group cache ttl (in seconds). Set to 0 to disable. | ||
+ | # (PANDORA FMS ENTERPRISE ONLY). | ||
+ | # | ||
+ | |||
+ | </ | ||
+ | |||
+ | {{: | ||
+ | 有効化時のデフォルトは、'' | ||
+ | |||
+ | === log_window === | ||
+ | |||
+ | < | ||
+ | # Correlated Alerts, log window in seconds (3600 by default) | ||
+ | # (PANDORA FMS ENTERPRISE ONLY). | ||
+ | log_window 3600 | ||
+ | |||
+ | </ | ||
+ | |||
+ | {{: | ||
+ | |||
+ | === sample_agent === | ||
+ | < | ||
+ | |||
+ | # Pandora Sample Agent. If enabled, every 10 minutes, this embedded agent | ||
+ | # will make sample data. Disabled by default. | ||
+ | sample_agent 0 | ||
+ | |||
+ | </ | ||
+ | |||
+ | 有効化した場合('' | ||
+ | **テストが終わったら、このエージェントは無効化('' | ||
+ | |||
+ | Google Chrome® ウェブブラウザの Pandora FMS 拡張によるイベント表示: | ||
+ | |||
+ | \\ | ||
+ | {{ : | ||
+ | |||
+ | === sample_agent_interval === | ||
+ | |||
+ | < | ||
+ | # Pandora Sample Agent interval (in seconds). | ||
+ | sample_agent_interval 600 | ||
+ | |||
+ | </ | ||
+ | |||
+ | '' | ||
+ | |||
+ | === unknown_block_size === | ||
+ | |||
+ | <WRAP center round info 60%> | ||
+ | |||
+ | バージョン NG 769 以降 | ||
+ | |||
+ | </ | ||
+ | |||
+ | < | ||
+ | |||
+ | # Number of unknown modules that will be processed per iteration. | ||
+ | unknown_block_size 1000 | ||
+ | |||
+ | </ | ||
+ | |||
+ | 一度の実行で Pandora FMS データサーバによって処理される不明モジュールの数 (デフォルトは '' | ||
+ | |||
+ | === netflowserver | ||
+ | |||
+ | <WRAP center round info 60%> | ||
+ | |||
+ | バージョン NG 770 以降 | ||
+ | |||
+ | </ | ||
+ | |||
+ | [[https:// | ||
+ | |||
+ | < | ||
+ | |||
+ | # Enable (1) or disable (0) the Pandora FMS Netflow Server (PANDORA FMS ENTERPRISE ONLY). | ||
+ | netflowserver 0 | ||
+ | |||
+ | </ | ||
+ | |||
+ | === netflowserver_threads === | ||
+ | |||
+ | <WRAP center round info 60%> | ||
+ | |||
+ | バージョン NG 770 以降 | ||
+ | |||
+ | </ | ||
+ | |||
+ | [[https:// | ||
+ | |||
+ | < | ||
+ | |||
+ | # Number of threads for the Pandora FMS Netflow Server (PANDORA FMS ENTERPRISE ONLY). | ||
+ | netflowserver_threads 1 | ||
+ | |||
+ | </ | ||
+ | |||
+ | ==== 環境変数 ==== | ||
+ | |||
+ | Pandora FMS サーバは、設定ファイルでの設定以外にもいくつかのオプションがあります。特定のケースでは、マシン自体で設定を行うため環境変数が必要です。これには、サーバの起動スクリプトで // | ||
設定可能な変数は次の通りです。 | 設定可能な変数は次の通りです。 | ||
- | ====PANDORA_RB_PRODUCT_NAME==== | + | === PANDORA_RB_PRODUCT_NAME === |
この変数は、サーバによって表示される初期メッセージ内の製品名をカスタマイズするのに利用します。そうしないと、データベースがロードされるまではカスタム名にはなりません。 | この変数は、サーバによって表示される初期メッセージ内の製品名をカスタマイズするのに利用します。そうしないと、データベースがロードされるまではカスタム名にはなりません。 | ||
- | ====PANDORA_RB_COPYRIGHT_NOTICE==== | + | === PANDORA_RB_COPYRIGHT_NOTICE === |
この変数は、サーバによって表示される初期メッセージ内の製品作者名をカスタマイズするのに利用します。そうしないと、データベースがロードされるまではカスタム名にはなりません。 | この変数は、サーバによって表示される初期メッセージ内の製品作者名をカスタマイズするのに利用します。そうしないと、データベースがロードされるまではカスタム名にはなりません。 | ||
- | ====環境変数の例==== | + | === 環境変数の例 === |
+ | |||
+ | < | ||
# | # | ||
- | | + | |
- | | + | |
- | ===== SNMPTRAPD の設定 | + | </ |
- | Pandora FMS SNMP コンソールは、[[Pandora:Documentation_ja:SNMP_traps_Monitoring|SNMP トラップ]]を受信するために snmptrapd を利用します。snmptrapd は、トラップを受信してログファイルを出力する、ほとんどの UNIX システムにある基本的なツールです。Pandora FMS では、snmptrapd をカスタムログファイルを書くように設定し、それを定期的に読み込みます。また、アラートが定義されていれば、それの実行も行います。 | + | |
+ | ==== SNMPTRAPD の設定 ==== | ||
+ | |||
+ | Pandora FMS SNMP コンソールは、[[ja: | ||
以前は、snmptrapd は特に明示的な設定を行わなくてもトラップを受け取っていました。バージョン 5.3 より、受信するトラップを制限するアクセス制御が厳しくなっており、デフォルトではどこからもトラップを受け取りません。 | 以前は、snmptrapd は特に明示的な設定を行わなくてもトラップを受け取っていました。バージョン 5.3 より、受信するトラップを制限するアクセス制御が厳しくなっており、デフォルトではどこからもトラップを受け取りません。 | ||
行 880: | 行 1543: | ||
snmptrapd は、正しく設定しないとトラップを受け取れず、Pandora FMS コンソールにトラップを表示することができません。 | snmptrapd は、正しく設定しないとトラップを受け取れず、Pandora FMS コンソールにトラップを表示することができません。 | ||
- | /// | + | 次のファイルで |
- | 基本的な snmptrapd.conf は次のような設定になっています。 | + | < |
- | | + | / |
- | もし、あなたが利用している Linux ディストリビューションで動作しなければ、あなたが使っているバージョンの snmptrapd でトラップを受信するための設定方法を確認してください。 | + | </ |
- | man snmptrapd.conf | + | 存在しない場合は、ワーニングやエラーを次のファイルで確認してください。 |
- | ===== Tentacle の設定===== | + | < |
- | {{pandora: | + | /var/log/pandora/ |
- | デフォルトでは、Pandora FMS ソフトウエアエージェントは、データをサーバに送るのに Tentacle プロトコル (IANA [[http:// | + | </ |
+ | |||
+ | 基本的な '' | ||
+ | |||
+ | < | ||
+ | authCommunity log public | ||
+ | |||
+ | </ | ||
+ | |||
+ | もし、あなたが利用している Linux ディストリビューションで動作しなければ、次のコマンドを使用して利用している **snmptrapd** バージョンにおいてトラップ受信を有効にする構文を確認してください。 | ||
+ | |||
+ | < | ||
+ | man snmptrapd.conf | ||
+ | |||
+ | </ | ||
+ | |||
+ | ==== Tentacle の設定 ==== | ||
+ | |||
+ | <WRAP center round tip 60%> **Tentacle プロトコル** に関する詳細は、[[: | ||
+ | |||
+ | デフォルトでは、Pandora FMS ソフトウエアエージェントは、データをサーバに送るのに Tentacle プロトコル (IANA [[http:// | ||
Tentacle サーバの設定を調整したい場合は、Tentacle サーバデーモンの起動スクリプトを直接編集します。 | Tentacle サーバの設定を調整したい場合は、Tentacle サーバデーモンの起動スクリプトを直接編集します。 | ||
+ | < | ||
+ | |||
+ | / | ||
- | /etc/ | + | </code> |
以下に、Tentacle サーバの設定オプションを示します。 | 以下に、Tentacle サーバの設定オプションを示します。 | ||
行 927: | 行 1613: | ||
**TENTACLE_EXT_OPTS** | **TENTACLE_EXT_OPTS** | ||
- | Tentacle サーバを実行するときの追加オプションを設定します。cert (x509) | + | Tentacle サーバを実行するときの追加オプションを設定します。[[: |
**MAX_CONECTIONS** | **MAX_CONECTIONS** | ||
行 937: | 行 1623: | ||
サーバが受け取る最大ファイルサイズをバイトで指定します。デフォルトは、// | サーバが受け取る最大ファイルサイズをバイトで指定します。デフォルトは、// | ||
- | =====Pandora ウェブロボットデーモン (PWRD)===== | + | // |
+ | |||
+ | * [[: | ||
+ | * [[: | ||
+ | |||
+ | ==== Pandora ウェブロボットデーモン (PWRD) ==== | ||
Pandora ウェブロボットデーモンは、Enterprise 版のサービスで、ウェブの自動ブラウジングを行うために必要なものです。WUX 機能の一部で、[[https:// | Pandora ウェブロボットデーモンは、Enterprise 版のサービスで、ウェブの自動ブラウジングを行うために必要なものです。WUX 機能の一部で、[[https:// | ||
以下を含んでいます: | 以下を含んでいます: | ||
+ | |||
* バージョン 46 の Firefox ブラウザバイナリ | * バージョン 46 の Firefox ブラウザバイナリ | ||
* ウェブブラウジングセッションを記録・実行するための設定済のプロファイル | * ウェブブラウジングセッションを記録・実行するための設定済のプロファイル | ||
行 946: | 行 1639: | ||
* ウェブブラウジングセッションレコーダ (.xpi) | * ウェブブラウジングセッションレコーダ (.xpi) | ||
- | PWRD に関するより詳細は、[[Pandora:Documentation_ja:User_Monitorization|こちら]]を参照してください。 | + | PWRD に関するより詳細は、[[: |
- | ===== Phantomjs | + | ==== サーバ複数プロセス設定 |
- | Phantomjs は、動的に PDF グラフを生成するのに利用する特別なコンポーネントです。バージョン 7.0NG 724 から必要になり、以前の PDF グラフシステムを置き換えています。計画的な実行やインタラクティブな方法で PDF レポートを生成したり、埋め込みグラフィックスを含むアラート実行などのすべてのコンソールやサーバにおいて、インストールされている必要があります。 | + | |
- | バージョン 7.0NG 724 以降の ISO イメージを使っている場合は、すでにライブラリがインストールされているため追加のインストールは不要です。 | + | <WRAP center round info 60%> |
- | そうでなければ、以下の手順で Phantomjs をインストールします。 | + | バージョン 770 以降。 |
- | - Linux システムにインストールする場合は、依存パッケージ fontconfig freetype freetype-devel fontconfig-devel libstdc++ が必要です。Windows では必要ありません。 | + | ローカル ( '' |
- | - phantomjs をダウンロードします。この機能の開発・テスト時は、phantomjs 2.1.1 を利用していました。以下のリンクからこのバージョンを取得できます。 | + | |
- | - Linux [[https:// | + | |
- | - Windows: [[https:// | + | |
- | - 公式ページ: | + | |
- | - phantomjs をパスに追加したら、それ以上の設定は不要です。そうでなければ、Pandora FMS コンソールで phantomjs バイナリファイルへのパスを設定する必要があります。この場合は、設定(Setting) > 基本設定(General) > phantomjs バイナリパス へ行きます。Web サーバ実行ユーザ(デフォルトでは apache)が、指定した場所でこのファイルを実行できる必要があります。 | + | |
- | yum install -y fontconfig freetype freetype-devel fontconfig-devel libstdc++ | + | </WRAP> |
- | mkdir -p / | + | |
- | wget " | + | |
- | chmod +x phantomjs | + | |
- | ln -s / | + | |
- | ====== ウェブコンソール ====== | + | 多数のコアと RAM を備えたマシンを使用している場合、このオプションを使用して、最も要求の厳しいサーバ (データサーバやセカンダリサーバプロセスの使用など) のプロセスを分離すると便利です。 |
- | Pandora FMS ウェブコンソールには、インストール時に生成される設定ファイルがあります。場所は、/ | + | |
- | 例えば、CentOS であれば次の通りです。 | + | |
- | / | + | これにより、メインサーバのタスクに影響を与えることなく、リソースの最適な使用が可能になり、メインプロセスによって管理される残りのコンポーネントの動作に影響を与えることなく、最も積極的にワークロードをセカンダリプロセスに委任できます。 |
+ | |||
+ | **設定** | ||
+ | |||
+ | < | ||
+ | / | ||
+ | |||
+ | </ | ||
+ | |||
+ | バージョン 770 を初めてインストールすると、'' | ||
+ | |||
+ | '' | ||
+ | |||
+ | コピーしたファイルは、次の操作規則に準拠するように編集する必要があります。 | ||
+ | |||
+ | * 設定ファイルでは、一意のサーバ名 ([[: | ||
+ | * セカンダリサーバは常に '' | ||
+ | * 設定ファイルの拡張子は '' | ||
+ | * セカンダリサーバの設定ファイルが定義されると、[[: | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | <WRAP center round info 60%> | ||
+ | |||
+ | [[: | ||
+ | |||
+ | </ | ||
+ | |||
+ | ===== ウェブコンソール ===== | ||
+ | |||
+ | [[: | ||
+ | |||
+ | ==== Apache web サーバ ==== | ||
+ | |||
+ | === Apache 設定 === | ||
+ | |||
+ | Pandora FMS には、それが機能するために必要ないくつかのファイルを含む一連のフォルダがあります。これらのファイルへのアクセスを避けるために、コンソールの一部のフォルダーには、アクセスを制限する '' | ||
+ | |||
+ | < | ||
+ | |||
+ | AllowOverride All | ||
+ | |||
+ | </ | ||
+ | |||
+ | 以下を置き換える: | ||
+ | |||
+ | < | ||
+ | AllowOverride None | ||
+ | |||
+ | </ | ||
+ | |||
+ | |||
+ | === 設定ファイル config.php === | ||
+ | |||
+ | [[: | ||
+ | |||
+ | 例えば、CentOS のシステムであれば以下にあります。 | ||
+ | |||
+ | < | ||
+ | |||
+ | / | ||
+ | |||
+ | </ | ||
- | ===== 設定ファイル config.php ===== | ||
設定オプションはファイルの先頭部分にあり、次の通りです。 | 設定オプションはファイルの先頭部分にあり、次の通りです。 | ||
- | **$config[[pandora: | + | < |
+ | $config["dbtype"] | ||
+ | |||
+ | </ | ||
利用するデータベースのタイプです。デフォルトは MySQL です。 | 利用するデータベースのタイプです。デフォルトは MySQL です。 | ||
- | **$config[[pandora: | + | < |
+ | $config["dbname"] | ||
- | 接続するデータベース名を設定します。デフォルトは pandora です。 | + | </ |
- | **$config[[pandora: | + | 接続する Pandora FMS データベース名を設定します。デフォルトは '' |
+ | |||
+ | < | ||
+ | $config["dbuser"] | ||
+ | |||
+ | </ | ||
Pandora FMS データベースに接続するユーザ名を設定します。デフォルトは pandora です。 | Pandora FMS データベースに接続するユーザ名を設定します。デフォルトは pandora です。 | ||
- | **$config[[pandora: | + | < |
+ | $config["dbpass"] | ||
+ | |||
+ | </ | ||
Pandora FMS データベースに接続するユーザのパスワードを設定します。 | Pandora FMS データベースに接続するユーザのパスワードを設定します。 | ||
- | **$config[[pandora: | + | < |
+ | $config["dbhost"] | ||
- | Pandora FMS データベースのホスト名もしくは IP アドレスを設定します。サーバと同一ホストにインストールしているのであれば、localhost です。 | + | </ |
- | **$config[[pandora: | + | Pandora FMS データベースのホスト名もしくは IP アドレスを設定します。サーバと同一ホストにインストールしているのであれば、'' |
+ | |||
+ | < | ||
+ | $config["homedir"] | ||
+ | |||
+ | </ | ||
Pandora FMS ウェブコンソールのディレクトリを設定します。通常は、/ | Pandora FMS ウェブコンソールのディレクトリを設定します。通常は、/ | ||
- | **$config[[pandora: | + | < |
+ | $config["homeurl"] | ||
+ | |||
+ | </ | ||
Pandora FMS コンソールの URL のベースディレクトリを設定します。通常は / | Pandora FMS コンソールの URL のベースディレクトリを設定します。通常は / | ||
- | **$config[[pandora: | + | < |
+ | $config["public_url"] | ||
- | Pandora FMS サーバが apache の mod_proxy などを使ったリバースプロキシ配下にある場合に、URL を文字列で指定します。 | + | </ |
- | ==== / から / | + | Pandora FMS サーバが |
- | もし、Apache | + | |
- | <code> | + | <WRAP center round info 60%> |
- | ===== Apache | + | バージョン 770 以降 |
- | Pandora | + | |
+ | </ | ||
+ | |||
+ | < | ||
+ | $config[" | ||
+ | $config[" | ||
+ | |||
+ | </ | ||
+ | |||
+ | '' | ||
+ | |||
+ | これら 2 つの変数を使用すると、自動検出タスクの実行における負荷を複数のコンソールで分散できます。 | ||
+ | |||
+ | * [[: | ||
+ | * [[: | ||
+ | * [[: | ||
+ | |||
+ | === Apache | ||
+ | |||
+ | Apache サーバに Pandora FMS しかない場合は、ユーザがサーバの ''/'' | ||
+ | |||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | </ | ||
+ | |||
+ | |||
+ | |||
+ | === php.conf 設定ファイル | ||
+ | |||
+ | <WRAP center round info 60%> | ||
+ | |||
+ | **バージョン 768 以降**: 各ユーザで生成する個別の目的に応じた [[https:// | ||
+ | |||
+ | </WRAP> | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | bearer トークンを使用したヘッダー認証が正しく機能するには、'' | ||
+ | |||
+ | < | ||
+ | |||
+ | # Redirect to local php-fpm if mod_php (5 or 7) is not available | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | # Enable http authorization headers | ||
+ | SetEnvIfNoCase ^Authorization$ " | ||
+ | <Proxy " | ||
+ | ProxySet timeout=1200 | ||
+ | </ | ||
+ | |||
+ | < | ||
+ | SetHandler " | ||
+ | </ | ||
+ | |||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | </ | ||
+ | |||
+ | [[ja: | ||
- | [[Category: Pandora FMS]] | ||
- | [[Category: | ||
- | [[Category: |