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

EndPoint installer for Linux. Always installs from a tarball (never from an RPM), validates the downloaded tarball is a real Pandora FMS EndPoint and configures the agent to report to a Pandora FMS Server.

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

• Script: ../pandora_agent_deploy.sh
• Scope: Pulls from packages.pandorafms.com.
• Supported OS: RHEL/Fedora (EL7/8/9/10), SUSE/OpenSUSE, Debian/Ubuntu.
• Supported architectures: x86_64 (binary agents). x86, armv7l, aarch64 auto-switch to PERL_SOURCES (source build). Other architectures abort.

• スクリプト: `../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 (ソースからのビルド) に切り替わります。その他のアーキテクチャでは処理が中断されます。

Minimal install (GO agent, stable channel):

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

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

Fully automated (no prompts):

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

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

All of these are injected into /etc/pandora/pandora_agent.conf after install via sed. If a variable is not set, the corresponding config line is left untouched.

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

PANDORA_AGENT_PACKAGE accepts two kinds of values: a type selector or a direct URL.

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

• The selector is case-insensitive (go, Go, GO all work).
• PERL_SOURCES also accepts the aliases PERLSOURCES, PERL_SRC, PERLSRC.

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

If the value starts with http:// or https://, it is used as-is and the default-version logic is skipped. A yellow warning is printed:

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

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

The tarball is still validated before install (see Tarball validation), so a wrong URL fails fast instead of installing garbage.

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

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

If PANDORA_AGENT_PACKAGE is set to something that is neither a type selector nor a URL, the script aborts with a red error.

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

Binary agents (GO, PERL) only work on x86_64. If the script detects x86, armv7l, or aarch64, it automatically overrides the package type to PERL_SOURCES (source build) and prints a yellow warning:

バイナリ形式のエージェント（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.

This override does NOT apply if:

• The user already selected PERL_SOURCES (no change needed).
• The user provided a direct URL (respected, but a yellow warning is printed reminding that the arch requires a source build).

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

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

PANDORA_AGENT_RELEASE chooses between stable and beta (nightly) builds.

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

So with PANDORA_AGENT_RELEASE=BETA PANDORA_AGENT_PACKAGE=GO, the downloaded tarball is:

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

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

When PANDORA_AGENT_RELEASE=BETA, a yellow warning is printed showing the nightlies URL.
Depending on PANDORA_SKIP_CONFIRMATION, the script either asks for confirmation or continues automatically (see Confirmation).

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

The confirm() function asks the user to type Y or y to continue. It reads from /dev/tty so it works even when the script is piped (curl … | bash).

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

CICD / automated usage: always set PANDORA_SKIP_CONFIRMATION=1 so the script never blocks waiting for input.

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

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

After downloading, the script validates the tarball before installing. Two layers:

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

1. Structural — tar tzf lists the contents and verifies these entries exist:
   • unix/pandora_agent_installer
   • unix/pandora_agent
   • unix/tentacle_client
2. Fingerprint — extracts unix/pandora_agent_installer to STDOUT and checks for the string Pandora FMS Agent Installer for Unix.

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 が含まれているかを確認します。

If either layer fails, the script prints a red error showing the downloaded URL, cleans up the temp directory, and exits. This prevents installing a tarball that is not a Pandora FMS agent (e.g. a wrong URL pointing to a console or server package).

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

1. Check PANDORA_SERVER_IP is set.
2. Check grep, sed, and curl are available.
3. Detect OS from /etc/os-release (ID_LIKE / ID). Abort if not RHEL/Fedora/SUSE/Debian.
4. Check root permissions.
5. Check connectivity to packages.pandorafms.com.
6. Check architecture. x86_64 continues with the selected package. x86, armv7l, aarch64 auto-switch to PERL_SOURCES (binary agents won't run on these archs). Other archs abort.
7. Resolve PANDORA_AGENT_PACKAGE (type selector or direct URL) and PANDORA_AGENT_RELEASE (stable/beta). BETA may prompt for confirmation.
8. Create temp workspace $HOME/pandora_deploy_tmp.
9. Install dependencies (skipped if PANDORA_SKIP_DEPENDENCIES=1). Dependencies vary by agent type:
   • GO: perl tar (+ procps on Debian).
   • PERL: perl perl-Sys-Syslog unzip tar (+ RHEL: libnsl/libxcrypt, SUSE: none, Debian: procps).
   • PERL_SOURCES: full set including 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. Download the tarball with curl.
11. Validate the tarball (structural + fingerprint).
12. Install via install_tarball:
    tar xvzf + cd unix && ./pandora_agent_installer –install.
13. Configure /etc/pandora/pandora_agent.conf with the PANDORA_* variables.
14. Docker/systemd compatibility: if systemctl status fails, copy pandora_agent_daemon to /etc/init.d/ and restart it there.
15. Restart pandora_agent_daemon and verify the process is running (up to 5 retries, 1s apart).
16. Clean up $HOME/pandora_deploy_tmp.
17. Print green success message.

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. 緑色で成功メッセージを表示します。

All command output goes to /tmp/pandora-agent-deploy-YYYY-MM-DD.log. On failure the script prints the log path.

すべてのコマンド出力は /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

Results below are from containerized tests using the BETA channel (PANDORA_AGENT_RELEASE=BETA).

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

• BETA channel requires PANDORA_SKIP_CONFIRMATION=1 in non-TTY environments (containers, CICD).
• PANDORA_SKIP_DEPENDENCIES=1 skips OS package installation. Use it only when dependencies are already present — both the script and the GO agent's pandora_agent_installer need perl and tar.
• Oracle Linux is not supported because perl is absent from its base repositories. Enabling ol8_codeready_builder or EPEL may resolve it but is outside the script's scope.
• Alpine Linux lacks bash and uses busybox ash, which does not support the bash syntax used by the script.

• 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 構文をサポートしていません。

←Back to Pandora FMS documentation index