Pandora FMS エンドポイントデプロイスクリプト

Linux 用エンドポイントインストーラ。常に tarball からインストールを行い（RPMは使用しません）、ダウンロードした tarball が正規の Pandora FMS EndPoint であることを検証した上で、Pandora FMS サーバへ報告を行うようにエージェントを設定します。

• スクリプト: `../pandora_agent_deploy.sh`
• 対象: `packages.pandorafms.com` から取得します。
• 対応OS: RHEL/Fedora (EL7/8/9/10)、SUSE/OpenSUSE、Debian/Ubuntu。
• 対応アーキテクチャ: `x86_64` (バイナリ形式のエージェント)。x86、armv7l、aarch64 は自動的に PERL_SOURCES (ソースからのビルド) に切り替わります。その他のアーキテクチャでは処理が中断されます。

最小構成のインストール (GO エージェント、安定版チャネル):

export PANDORA_SERVER_IP='10.0.0.1'
curl -sSL https://pfms.me/agent-deploy | bash

完全自動（プロンプトなし）：

export PANDORA_SERVER_IP='10.0.0.1' \
       PANDORA_AGENT_PACKAGE=GO \
       PANDORA_AGENT_RELEASE=STABLE \
       PANDORA_SKIP_CONFIRMATION=1
curl -sSL https://pfms.me/agent-deploy | bash

これらはすべて、インストール後に sed を使用して /etc/pandora/pandora_agent.conf に挿入されます。変数が設定されていない場合、対応する設定行は変更されずにそのまま残ります。

PANDORA_AGENT_PACKAGE は、タイプセレクター または 直接 URL の2種類の値を受け付けます。

• セレクターは大文字と小文字を区別しません（'go'、'Go'、'GO' のいずれも有効です）。
• 'PERL_SOURCES' は、エイリアスである PERLSOURCES、PERL_SRC、PERLSRC も受け付けます。

値が http:// または https:// で始まる場合、その値がそのまま使用され、デフォルトバージョンを決定するロジックはスキップされます。その際、黄色い警告が表示されます。

PANDORA_AGENT_PACKAGE is a direct URL,
default version logic (GO/PERL/PERL_SOURCES) is skipped.

インストール前には依然として tarball の検証が行われるため（Tarballの検証 を参照）、誤った URL を指定しても、不正なデータがインストールされることなく、即座に失敗します。

export PANDORA_SERVER_IP='10.0.0.1' \ 
PANDORA_AGENT_PACKAGE='https://my-ci.example.com/builds/agent-1234.tar.gz'

PANDORA_AGENT_PACKAGE にタイプセレクターでも URL でもない値が設定されている場合、スクリプトは赤色のエラーを表示して停止します。

バイナリ形式のエージェント（GO、PERL）は、x86_64 でのみ動作します。スクリプトが x86、armv7l、または aarch64 を検出すると、パッケージタイプを自動的にPERL_SOURCES（ソースビルド）に上書きし、黄色の警告メッセージを表示します。

Arch: armv7l is not supported by the binary agent,
switching to PERL_SOURCES (source build).
Overriding PANDORA_AGENT_PACKAGE from GO to
PERL_SOURCES for arch armv7l.

以下の場合は、この上書き設定は適用されません。

• ユーザが既に PERL_SOURCES を選択している場合（変更は不要です）。
• ユーザが直接 URL を指定した場合（その指定は尊重されますが、当該アーキテクチャではソースからのビルドが必要であることを示す黄色の警告が表示されます）。

PANDORA_AGENT_RELEASE は、安定版（stable）とベータ版（nightly）のビルドのいずれかを選択します。

したがって、PANDORA_AGENT_RELEASE=BETA PANDORA_AGENT_PACKAGE=GO を指定した場合、ダウンロードされる tarball は以下のようになります。

https://packages.pandorafms.com/pandorafms/nightlies/pandorafms_one_agent_linux-nightlies.go.tar.gz.

PANDORA_AGENT_RELEASE=BETA の場合、nightly 版の URL を示す黄色の警告が表示されます。
PANDORA_SKIP_CONFIRMATION の設定に応じて、スクリプトは確認を求めるか、あるいは自動的に処理を続行します（確認 を参照）。

confirm() 関数は、処理を続行するためにユーザに Y または y の入力を求めます。/dev/tty から読み取りを行うため、スクリプトがパイプ経由で実行される場合（curl … | bash など）でも動作します。

CI/CD / 自動化での利用: スクリプトが入力待ちで停止することがないよう、常に PANDORA_SKIP_CONFIRMATION=1 を設定してください。

export PANDORA_SERVER_IP='10.0.0.1' \
       PANDORA_AGENT_RELEASE=BETA \
       PANDORA_SKIP_CONFIRMATION=1

スクリプトはダウンロード後、インストール前に tarball を検証します。2つの層があります：

1. 構造（Structural） — tar tzf を使用して内容を一覧表示し、以下のエントリが存在することを確認します。
   • unix/pandora_agent_installer
   • unix/pandora_agent
   • unix/tentacle_client
2. フィンガープリント（Fingerprint） — unix/pandora_agent_installer を標準出力（STDOUT）に展開し、文字列 Pandora FMS Agent Installer for Unix が含まれているかを確認します。

いずれかの層で処理に失敗した場合、スクリプトはダウンロードした URL を含むエラーを赤色で表示し、一時ディレクトリをクリーンアップして終了します。これにより、Pandora FMS エージェントではない tarball（例：コンソールやサーバのパッケージを指す誤った URL など）がインストールされるのを防ぎます。

1. PANDORA_SERVER_IP が設定されているか確認します。
2. grep、sed、curl が利用可能か確認します。
3. /etc/os-release (ID_LIKE / ID) から OS を検出します。RHEL/Fedora/SUSE/Debian 以外の場合は処理を中断します。
4. root 権限を確認します。
5. packages.pandorafms.com への接続性を確認します。
6. アーキテクチャを確認します。x86_64 の場合は選択されたパッケージで処理を続行します。x86、armv7l、aarch64 の場合は自動的に PERL_SOURCES に切り替わります（これらのアーキテクチャではバイナリエージェントは動作しないため）。その他のアーキテクチャでは処理を中断します。
7. PANDORA_AGENT_PACKAGE（タイプ選択または直接 URL）および PANDORA_AGENT_RELEASE（stable/beta）を決定します。BETA の場合は確認を求められることがあります。
8. 一時作業ディレクトリ $HOME/pandora_deploy_tmp を作成します。
9. 依存関係をインストールします（PANDORA_SKIP_DEPENDENCIES=1 の場合はスキップ）。依存関係はエージェントタイプによって異なります：
   • GO: perl tar (+ Debian では procps)。
   • PERL: perl perl-Sys-Syslog unzip tar (+ RHEL: libnsl/libxcrypt, SUSE: なし, Debian: procps)。
   • PERL_SOURCES: 完全なセット（perl-Scalar-List-Utils、perl-IO-Socket-SSL、perl-Digest-MD5、perl-threads、perl-Thread-Semaphore、libnsl (RHEL)；perl-YAML-Tiny、perl-IO-Socket-SSL、libnsl3 (SUSE)；libsys-syslog-perl、libyaml-tiny-perl、libio-socket-ssl-perl、libscalar-list-utils-perl (Debian) を含む）。
10. curl を使用して tarball をダウンロードします。
11. tarball を検証します（構造およびフィンガープリント）。 - install_tarball を使用してインストールします: tar xvzf + cd unix && ./pandora_agent_installer –install。
12. PANDORA_* 変数を使用して /etc/pandora/pandora_agent.conf を設定します。
13. Docker/systemd への対応: systemctl status が失敗した場合は、pandora_agent_daemon を /etc/init.d/ にコピーし、そこで再起動します。
14. pandora_agent_daemon を再起動し、プロセスが実行中であることを確認します（1秒間隔で最大5回再試行）。
15. $HOME/pandora_deploy_tmp を削除（クリーンアップ）します。
16. 緑色で成功メッセージを表示します。

すべてのコマンド出力は /tmp/pandora-agent-deploy-YYYY-MM-DD.log に書き込まれます。失敗した場合は、スクリプトがログのパスを表示します。

export PANDORA_SERVER_IP='10.0.0.1' \
       PANDORA_AGENT_PACKAGE=GO \
       PANDORA_AGENT_NAME='web-01' \
       PANDORA_GROUP='Web'
curl -sSL https://pfms.me/agent-deploy | bash

export PANDORA_SERVER_IP='10.0.0.1' \
       PANDORA_AGENT_PACKAGE=PERL_SOURCES \
       PANDORA_AGENT_RELEASE=BETA \
       PANDORA_SKIP_CONFIRMATION=1
curl -sSL https://pfms.me/agent-deploy | bash

export PANDORA_SERVER_IP='10.0.0.1' \
 PANDORA_AGENT_PACKAGE=\
'https://ci.internal/builds/pandorafms_one_agent_linux-999.go.tar.gz' \
 PANDORA_SKIP_CONFIRMATION=1 \
curl -sSL https://pfms.me/agent-deploy | bash

export PANDORA_SERVER_IP='10.0.0.1' \
       RHEL_CHECK_SUBSCRIPTION=0
curl -sSL https://pfms.me/agent-deploy | bash

export PANDORA_SERVER_IP='10.0.0.1' \
       PANDORA_AGENT_PACKAGE=GO
curl -sSL https://pfms.me/agent-deploy | bash

export PANDORA_SERVER_IP='10.0.0.1' \
       PANDORA_SKIP_DEPENDENCIES=1
curl -sSL https://pfms.me/agent-deploy | bash

以下の結果は、BETA チャネル（PANDORA_AGENT_RELEASE=BETA）を使用したコンテナ化テストによるものです。

• BETA チャネルを非 TTY 環境（コンテナや CI/CD など）で使用する場合、PANDORA_SKIP_CONFIRMATION=1 の設定が必要です。
• PANDORA_SKIP_DEPENDENCIES=1 を指定すると、OS パッケージのインストールがスキップされます。このオプションは、必要な依存関係が既に導入されている場合にのみ使用してください（スクリプトおよび Go エージェントの pandora_agent_installer は、いずれも perl と tar を必要とします）。
• Oracle Linux はサポート対象外です。これは、同 OS のベースリポジトリに perl が含まれていないためです。ol8_codeready_builder や EPEL を有効にすることで解決できる可能性がありますが、それらの設定は本スクリプトの対象範囲外となります。
• Alpine Linuxには bash が含まれておらず、代わりに busybox ash が使用されていますが、これは本スクリプトで使用されている bash 構文をサポートしていません。

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