Pandora FMS のインストール

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

Pandora FMS はサーバとコンソールに Linux を必要とします。 MS Windows® や他の OS は公式にはサポートしていません。

この表に示している要件は、さまざまなインストールのための最小推奨要件です。これらの推奨値は、80% のモジュールでデータ保存し、平均監視時間が 5分であると仮定して計算しています。これらの推奨要件では、データベースサーバ、Pandoraサーバ、および Pandora コンソールが同一マシンにインストールする環境を想定しています。

これらは、通常のストレージで、デフォルトの監視間隔が 5 分の異なる監視手法の組み合わせ (ソフトウェアエージェントとリモート) の環境を想定しています。 この条件が変わると、要件が変わる可能性があります。

* * 8万メトリックを超える環境では、複数のノードを使用する分散監視システムを選択する必要があります。

(*) ノードごとにより高いパフォーマンスが必要な場合は、データベースを別のインスタンスにデプロイしたり、xtradb データベースクラスタに接続するようにノードを構成したりすることもできます。

すべてのテストと検証は、Percona Server for MySQL® 8 (推奨オプション) を使用して実行しています。Percona Server for MySQL® 8 と MySQL® 8 は類似しているため、両方のソリューションは完全に互換性があります。

Pandora FMS は、Linux® OS に大きく依存しています。多くの場合、デフォルトではインストールされない追加のパッケージも必要です。

Pandora FMS をインストールする前に、動作する MySQL サーバが必要です。 MySQL サーバーと同時に Pandora FMS をインストールする場合は、MySQL を起動して root でアクセスできる設定をする必要があります。

1. systemd での起動: systemctl start mysql (/etc/init.d/mysql start でも可能です)
2. 管理者ユーザ root のパスワードを設定: mysqladmin password < password > このパスワードは、インストールプロセス全体を通じて必要です。

1. Web コンソールのインストール
2. Pandora FMS サーバのインストール

理由は、サーバで使用される MySQL データベースはコンソールの初期設定プロセスで作成されるため、サーバが適切に機能することを保証するために、最初にコンソールの完全なインストールプロセスを実行する必要があるためです。

コンソールとサーバを同じマシン上にインストールする必要はありません。 対応する設定ファイルを通じて MySQL データベースの場所をそれぞれに示すことができます。ただし、 Enterprise 環境で分散インストールを実行する場合は、インストールに関してより多くの要素を考慮する必要があります。

サーバへのソフトウェアエージェントのインストールは、サーバおよびコンソールとは独立しているため、それらのインストールの前後どちらでも問題なく実行できます。

Enterprise 版の正しいインストール手順は次の通りです。

• オープンソース版のコンソールをインストール
• Enterprise 版のコンソールをインストール
• Enterprise 版のサーバをインストール
• コンソールへアクセスし、Enterprise ライセンスを入力する画面が表示される

インターネットにアクセスできる場合は、この便利なツールを使用してオンラインでインストールを実行することをお勧めします。

このインストール方法は、環境がクラウドプロバイダーによってホストされている場合に特に役立ちますが、クラウド環境に限定されるものではありません。

“クラウドプロバイダー” (または単に “クラウド”) という用語は、設定と管理のためのハードウェア、ハイパーバイザー、およびカスタマーサポート Web システムを備えた専用プロバイダーでの仮想マシンの専用または共有のホスティングを表すために使用されます。

オペレーティングシステムとしては Red Hat (RHEL) を推奨しますが、Rocky Linux、AlmaLinux、Ubuntu も公式にサポートされています (最低ソフトウエア要件を参照)。

インストールの最小ハードウェア要件は、1コア、2ギガバイトの RAM、および 20ギガバイトの空きディスクで、できれば SSD です。

これらの要件は最小インストール要件です。監視環境のサイズを適切に設定するには、必要最低ハードウエアスペック を確認することをお勧めします。

• インターネット(必要な URL に)アクセスできること。これらの URL に加えて、利用するディストリビューション(RHEL / Rocky Linux / Ubuntu Server)の公式リポジトリにアクセスできる必要があります。
• curl がインストールされていること。 (多くのディストリビューションではデフォルトで入っています)
• 必要最低ハードウエア要件を満たすこと。
• 管理者ユーザ root 権限があること。
• 対応 OS であること。
• RHEL 8 を利用する場合は、事前にライセンスを有効化し、標準リポジトリにサブスクライブする必要があります。

上記の実行により完全なインストール環境が作成されますが、環境変数を使用してさまざまな設定を行い、インストールをカスタマイズすることができます。

• TZ: マシンの タイムゾーン を定義します。デフォルトは Europe/Madrid です。
• DBHOST: データベースホストです。デフォルトは、DBHOST=127.0.0.1 です。
• DBNAME: 作成されるデータベース名です。デフォルトは、DBNAME=pandora です。
• DBUSER: 作成されるデータベースユーザです。デフォルトは、DBUSER=pandora です。
• DBPASS: 作成されるユーザのパスワードです。デフォルトは、DBPASS=pandora です。
• DBPORT: データベースの接続ポート番号です。デフォルトは、DBPORT=3306 です。
• DBROOTPASS: データベースの root ユーザパスワードです。デフォルトは、DBROOTPASS=pandora です。
• SKIP_PRECHECK: 以前の pandora インストールがすでに存在するかどうかのチェックをスキップします。これは、新しいデータベースを作成し、インストール時にこのデータベースを指すようにするのに役立ちます。デフォルトでは、SKIP_PRECHECK=0 です。
• SKIP_DATABASE_INSTALL: データベースのインストールをスキップします。これは、ローカルまたはリモートのデータベースがすでにインストールされていて、そのデータベースの認証情報を使用して Pandora FMS データベースを作成する場合に役立ちます。 デフォルトでは、SKIP_DATABASE_INSTALL=0 です。
• SKIP_KERNEL_OPTIMIZATIONS: 推奨する kernel の最適化をスキップするオプションで、上級ユーザ向けです。デフォルトは、SKIP_KERNEL_OPTIMIZATIONS=0 です。
• MYVER: インストールする MySQL のバージョンを定義します。80 が定義されている場合、MySQL 8 がインストールされます。 デフォルトでは、MYVER=80 (MySQL 8.0 をデプロイします)。
• PHPVER: インストールする PHP のバージョンを定義します。デフォルトでは、PHPVER=8 です(PHP 8 をデプロイします)。
• PANDORA_SERVER_PACKAGE: インストールする Pandora FMS サーバーの RPM パッケージの URL を定義します。 デフォルトでは、最新のバージョンが定義されています。
• PANDORA_CONSOLE_PACKAGE: インストールする Pandora FMS Web コンソールの RPM の URL を定義します。 デフォルトでは、最新のバージョンが定義されています。
• PANDORA_AGENT_PACKAGE: インストールする Pandora FMS ソフトウェアエージェントの RPM の URL を定義します。 デフォルトでは、最新のバージョンが定義されています。
• PANDORA_BETA: 1 に設定すると、利用可能な最新のベータ版のパッケージがインストールされます(テスト環境のみ)。 デフォルトは、PANDORA_BETA=0 です(特定のパッケージが定義されている場合、このオプションは無視されます)。
• PANDORA_LTS: 主な不具合修正をした安定版である長期サポート版(LTS)をインストールします。デフォルトでは有効(PANDORA_LTS=1) です。ゼロに設定すると、最新の通常のローリングリリース版(RRR)をインストールします。

これらの環境変数の使用は、インストールスクリプトを実行する前にそれらを定義するだけです。たとえば、変数を定義しての RHEL 8 でインストールでは次のように実行します。

env TZ='Europe/Madrid' \
  DBHOST='127.0.0.1' \
  DBNAME='pandora' \
  DBUSER='pandora' \
  DBPASS='Pandor4!' \
  DBPORT='3306' \
  DBROOTPASS='Pandor4!' \
  MYVER=80 \
  PHPVER=8 \
  SKIP_PRECHECK=0 \
  SKIP_DATABASE_INSTALL=0 \
  SKIP_KERNEL_OPTIMIZATIONS=0 \
  PANDORA_SERVER_PACKAGE="https://firefly.pandorafms.com/pandorafms/latest/RHEL_CentOS/pandorafms_server-7.0NG.noarch.rpm" \
  PANDORA_CONSOLE_PACKAGE="https://firefly.pandorafms.com/pandorafms/latest/RHEL_CentOS/pandorafms_console-7.0NG.noarch.rpm" \
  PANDORA_AGENT_PACKAGE="https://firefly.pandorafms.com/pandorafms/latest/RHEL_CentOS/pandorafms_agent_linux-7.0NG.noarch.rpm" \
  PANDORA_BETA=0 \
  PANDORA_LTS=1 \
  sh -c "$(curl -fsSL < your_link_for_trial >)"

• TZ: マシンのタイムゾーンを定義します。デフォルトは Europe/Madrid です。
• PHPVER: インストールする PHP のバージョンを定義します。デフォルトでは、PHPVER=8 です (PHP 8 をインストールします)。
• DBHOST: データベースホストです。デフォルトは、DBHOST=127.0.0.1 です。
• DBNAME: 作成されるデータベース名です。デフォルトは、DBNAME=pandora です。
• DBUSER: 作成されるデータベースユーザです。デフォルトは、DBUSER=pandora です。
• DBPASS: 作成されるユーザのパスワードです。デフォルトは、DBPASS=pandora です。
• DBPORT: データベースの接続ポート番号です。デフォルトは、DBPORT=3306 です。
• DBROOTPASS: データベースの root ユーザパスワードです。デフォルトは、DBROOTPASS=pandora です。
• SKIP_PRECHECK: 以前の pandora インストールがすでに存在するかどうかのチェックをスキップします。これは、新しいデータベースを作成し、インストール時にこのデータベースを指すようにするのに役立ちます。デフォルトでは、SKIP_PRECHECK=0 です。
• SKIP_DATABASE_INSTALL: データベースのインストールをスキップします。これは、ローカルまたはリモートのデータベースがすでにインストールされていて、そのデータベースの認証情報を使用して Pandora FMS データベースを作成する場合に役立ちます。 デフォルトでは、SKIP_DATABASE_INSTALL=0 です。
• SKIP_KERNEL_OPTIMIZATIONS: 推奨する kernel の最適化をスキップするオプションで、上級ユーザ向けです。デフォルトは、SKIP_KERNEL_OPTIMIZATIONS=0 です。
• POOL_SIZE: 使用するメモリ量を指定します。デフォルトでは自動的に行われます。
• PANDORA_BETA: 1 に設定すると、利用可能な最新のベータ版のパッケージがインストールされます(テスト環境のみ)。 デフォルトは、PANDORA_BETA=0 です(特定のパッケージが定義されている場合、このオプションは無視されます)。
• PANDORA_LTS: 主な不具合修正をした安定版である長期サポート版(LTS)をインストールします。デフォルトでは有効(PANDORA_LTS=1) です。ゼロに設定すると、最新の通常のローリングリリース版(RRR)をインストールします。

これらの環境変数の使用は、インストールスクリプトを実行する前にそれらを定義するだけです。たとえば、変数を定義しての Ubuntu Server 22.04 でのインストールでは次のように実行します。

env TZ='Europe/Madrid' \
  DBHOST='127.0.0.1' \
  DBNAME='pandora' \
  DBUSER='pandora' \
  DBPASS='Pandor4!' \
  DBPORT='3306' \
  DBROOTPASS='Pandor4!' \
  PHPVER='8.0' \
  SKIP_PRECHECK=0 \
  SKIP_DATABASE_INSTALL=0 \
  SKIP_KERNEL_OPTIMIZATIONS=0 \
  PANDORA_BETA=0 \
  PANDORA_LTS=1 \
  bash -c "$(curl -SsL < your_link_for_trial > )"

SKIP_KERNEL_OPTIMIZATIONS=0 パラメータで、以下の変更が行われます。

#default=5
net.ipv4.tcp_syn_retries = 3

この設定では、TCP 接続要求パケットを送信するときに、接続が失敗したとみなされるまでにオペレーティングシステムカーネルが行う再試行の回数を指定します。デフォルト値は 5 ですが、設定では 3 に変更されます。

#default=5
net.ipv4.tcp_synack_retries = 3

上記の設定と同様に、このオプションは、TCP 接続を受信したときにカーネルが(ACK を受信するまでに)確認応答パケット(SYN/ACK)を送信する再試行の回数を設定します。 デフォルト値は 5 ですが、設定では 3 に変更されます。

#default=1024
net.ipv4.tcp_max_syn_backlog = 65536

この設定は、受け入れを保留している TCP 接続のキューの最大サイズを設定します。 言い換えれば、オペレーティングシステムが同時に処理できる接続要求の最大数を決定します。デフォルト値は 1024 ですが、設定では 65536 に変更されます。

#default=124928
net.core.wmem_max = 8388608

このオプションは、ネットワーク接続経由でデータを送信するためのメモリ バッファの最大サイズを設定します。 データを送信する前にデータを保存するために割り当てることができるメモリの最大量を制御します。デフォルト値は 124928 ですが、設定では 8388608 に変更されます。

#default=131071
net.core.rmem_max = 8388608

上記の設定と同様ですが、データを送信するのではなく受信するために、このオプションはネットワーク接続経由でデータを受信するための最大メモリバッファサイズを設定します。 受信したデータを保存するために割り当てることができるメモリの最大量を制御します。デフォルト値は 131071 ですが、設定では 8388608 に変更されます。

#default = 128
net.core.somaxconn = 1024

このオプションは、オペレーティングシステムのソケットリスニングキュー内で保留中の接続の最大数を指定します。 受け入れられるまで待機状態にできる受信接続の最大数を制御します。 デフォルト値は 128 ですが、設定では 1024 に変更されます。

#default = 20480
net.core.optmem_max = 81920

この設定は、ソケットオプションの最大メモリバッファサイズを設定します。使用前に設定を保存するための options.socket に割り当てることができるメモリの最大量を制御します。 デフォルト値は 20480 ですが、設定では 81920 に変更されます。

Pandora FMS 用のデータベース(DB)をホストする強力な専用サーバがある場合、オンラインインストールのための別のカスタマイズがあります。

最初に、大まかに、Pandora FMS サーバと Web コンソール (PANDORA FMS SERVER+CONSOLE) の両方がリモートデータベース (DB) に接続できるようにインストール計画を検討する必要があります。

• データベースエンジンをホストするサーバに接続するための URL または IP アドレス (DBHOST) を正確に把握します。
• デフォルトのポート番号 (DBPORT) は 3306 です。別のものを使用する場合は注意してください。
• データベースを作成し、作成した名前を正確に書き留める必要があります (DBNAME として pandora を使用することをお勧めします)。
• データベースへの接続に使用するユーザを作成する必要があります (pandora を DBUSER として使用することをお勧めします)。
• 上記の手順で作成したユーザにパスワードを割り当てます (DBPASS)。

• 作成したデータベースに対するすべての権限を、作成したユーザに割り当てます。

• これらすべてができたら、シェル によって、このあと Pandora FMS サーバにて作成されたデータベースへのテスト接続を行います。これにより、通信を検証でき、すぐに使用できるようになります。
• オンラインインストール中にリモートデータベースへの接続を許可するインストールパラメータは SKIP_DATABASE_INSTALL で、その値を 1 に設定する必要があります。
• オンラインインストールツールで実際のインストールに進みます。 以下に、デフォルト値を使用した簡単な例を示します (常にデフォルトとは異なるユーザパスワードを使用することを忘れないでください)。

env \
 DBHOST='192.168.1.107' \
 DBNAME='pandora' \
 DBUSER='pandora' \
 DBPASS='pandora' \
 DBPORT='3306' \
 SKIP_DATABASE_INSTALL=1 \
 sh -c "$(curl -fsSL https://pfms.me/deploy-pandora-el8)"

エージェントのみをインストールするための BASH コマンドによるオンラインインストールツールもあります。

• これは、RedHat ベース OS (Fedora、Centos など) および Debian ベース OS (Ubuntu, Devuan, Lubuntu など) に対応しています。
• PowerShell® 技術を用いた MS Windows® 用もあります。

オンラインインストールツール利用の必要条件

• インターネットアクセス
• curl がインストールされていること(ほとんどのディストリビューションでデフォルトで提供されます)
• 管理者ユーザ root 権限
• 対応 OS であること

スクリプトは、インストールをカスタマイズするための一連の環境変数をサポートしており、そのうちの '$PANDORA_SERVER_IP' の 1つだけが必須です。そのため、標準のインストールを 1行で実行するには次のコマンドを実行します。

export PANDORA_SERVER_IP=<PandoraServer IP or FQDN> && curl -Ls https://pfms.me/agent-deploy | bash

オプションで利用できるその他の環境変数は次の通りです。

• $PANDORA_REMOTE_CONFIG: リモート設定の指定です。0 (無効)がデフォルトです。
• $PANDORA_AGENT_NAME: エージェント名の設定です。自動生成がデフォルトです。
• $PANDORA_AGENT_ALIAS: エージェントの別名設定です。ホスト名がデフォルトです。
• $PANDORA_GROUP: エージェントグループの設定です。Servers がデフォルトです。
• $PANDORA_SECONDARY_GROUPS: エージェントのセカンダリグループの設定です。空がデフォルトです。
• $PANDORA_DEBUG: デバッグ設定です。0 (無効)がデフォルトです。
• $TIMEZONE : システムのタイムゾーンの設定です。
• $PANDORA_AGENT_SSL: これにより、ソフトウェアエージェントと対応する Pandora FMS サーバ間の通信を暗号化するように設定できます。 デフォルトでは無効 (no) です。有効にするには yes を設定します (これにより、通信を暗号化するための依存ソフトウエアもインストールされます)。 シングルクォートを使用して値を区切ります。以下の例を参照してください。

env \
 PANDORA_SERVER_IP='192.168.10.245' \
 PANDORA_REMOTE_CONFIG=1 \
 PANDORA_AGENT_NAME='pandora_agent_name' \
 PANDORA_AGENT_ALIAS='pandora_AGENT_ALIAS' \
 PANDORA_GROUP='Servers' \
 PANDORA_SECONDARY_GROUPS='VMware,Web' \
 PANDORA_AGENT_SSL='yes' \
 curl -Ls https://pfms.me/agent-deploy | bash

オンラインインストールツール利用の必要条件

• インターネットアクセス
• powershell がインストールされている

Powershell と administrator 権限を使用して、ターミナルウィンドウで次のコマンドを実行します。

Invoke-WebRequest -Uri https://firefly.pandorafms.com/pandorafms/latest/Windows/Pandora%20FMS%20Windows%20Agent%20v7.0NG.x86_64.exe -OutFile ${env:tmp}\pandora-agent-windows.exe; & ${env:tmp}\pandora-agent-windows.exe /S --ip [PANDORASERVER IP or NAME] --group [GROUPNAME] --remote_config 1

その後、以下を実行します。

NET START PandoraFMSAgent

• Ubuntu server への Pandora FMS Enterprise インストールガイド
• Rocky Linux への Pandora FMS Enterprise インストールガイド
• Ubuntu への Pandora FMS オープンソース版のインストール
• Rockey Linux への Pandora FMS オープンソース版のインストール

以下のコマンドを実行するだけです。

dnf remove pandorafms_console pandorafms_server

If you uninstall version 761 or later:

バージョン 761 以降をアンインストールする場合:

dnf remove pandorawmic

If you have installed MySQL and no longer need it, you can delete it in a similar way:

MySQL が不要な場合は、以下のコマンドで削除できます。

dnf remove Percona-Server*

OS に応じてすべての依存ファイルをインストールしてから、tarball 形式のファイル(.tar.gz、tgz、または .tar.bz2)をダウンロードして解凍する必要があります。 それには、以下から Pandora FMS の最新バージョンを見つけてダウンロードします。

コンソールのアーカイブファイルで以下の手順を行います。

1. root 権限を取得します。

su -

2. '/tmp' へコピーし、実行します。

tar xvzf pandorafms_console-X.Y.tar.gz
cd pandora_console
./pandora_console_install --install

pandorafms_server-7.0NG.7xx.tar.gz

上記のような名前のファイルを用いて次のようにします。

1. root 権限を取得します。

su -

2. '/tmp' へコピーし、実行します。

 tar xvzf pandorafms_server-X.Y.tar.gz
 cd pandora_server
 ./pandora_server_installer --install

依存関係に関連する問題が発生した場合は、インストールを試みる前にそれらを修正してください。インストールを強制して依存関係の問題を無視することは可能かもしれませんが、その場合、Pandora FMS は正しく機能しません。

Pandora FMS の Enterprise 版をインストールするには、オープンソース版のコンソールとサーバをインストールする必要があります。その後、それぞれの Enterprise パッケージを追加します。 コンソール の場合は、インストール先のディストリビューションごとのパッケージを利用します。

ソースコードを利用して Enterprise コンソールをインストールするには、

pandorafms_console_enterprise-X.X.tar.gz などの名前のアーカイブファイルを入手し、次の手順に従います。

1. root 権限を取得します。

su -

2. '/tmp' へコピーし、以下を実行します。

tar xvzf pandorafms_console-X.Xtar.gz

3. その後、Pandora FMS オープンソースコンソールがインストールされているディレクトリにコピーします。

cp -R enterprise /var/www/html/pandora_console

4. ファイルの owner が Web サーバユーザになるように、権限を変更します。例:

chown -R apache /var/www/html/pandora_console/enterprise

Enterprise サーバをインストールするには、まず サーバのオープンソース版がインストールされていることを確認 してから、Enterprise 版のインストールに進む必要があります。

pandorafms_server_enterprise-X.X.tar.gz という名前のアーカイブを入手したら、以下の手順に従います。

1. root 権限を取得します。

su -

2. '/tmp' 以下に展開し、実行します。

tar xvzf pandorafms_server_enterprise-X.X.tar.gz
cd pandora_server/
# ./pandora_server_installer --install

Pandora FMS サーババイナリをデフォルトのディレクトリ '/usr/bin' 以外に置く場合は、ディレクトリを次のように指定します。

# PREFIX =/usr/local ./pandora_server_installer --install

インストール後、サーバを再起動します。

/etc/init.d/pandora_server restart

Enterprise サーバが有効化されます。

Pandora FMS サーバを異なるパスへインストールするには、destdir オプションを指定します。

./pandora_server_installer --install --destdir <path>

インストール後、Pandora FMS サーバが自動起動するように手動で調整する必要があります。また、データベースメンテナンススクリプト pandora_db が定期的に動作するようにする調整する必要があります。以下は Linux の例です。(<destdir> を destdir で指定した実際のパスに置き換えます)

ln -s <destdir>/etc/init.d/pandora_server /etc/init.d/
echo "\"<destdir>/usr/share/pandora_server/util/pandora_db\" \
  \"<destdir>/etc/pandora/pandora_server.conf\">/dev/null 2>&1"> /etc/cron.hourly/pandora_db

非特権ユーザで Pandora FMS サーバをインストールするには、インストールするユーザで次のコマンドを起動します。

./pandora_server_installer --install --no-root --destdir /opt/pandora

このユーザは、 destdir に渡されるパスに対する書き込み権限を持っている必要があります。

• 詳細は、Pandora FMS ソフトウエアエージェントのインストール を参照してください。

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