パッケージからのインストールに関する注意

概要

Zabbix 8.2 の公式 プレリリース パッケージは近日中に Zabbix Webサイト で利用可能になります。ここでは、オペレーティングシステムと Zabbix コンポーネントを選択して、インストール手順とコマンドを生成できます。

以下のパッケージのインストールに関する注意事項に加えて、インストールとセットアップのページも参照してください。

パッケージは、以下の Linux ディストリビューションで利用できます。

  • Red Hat Enterprise Linux およびその派生ディストリビューション: AlmaLinux、Amazon Linux 2023、CentOS Stream、CentOS 7、Oracle Linux、Rocky Linux
  • Debian、Ubuntu、Raspberry Pi OS、Raspbian
  • SUSE Linux Enterprise Server、openSUSE Leap

一部の OS ディストリビューション(特に Debian ベースのディストリビューション)では、独自の Zabbix パッケージが提供されています。 これらのパッケージは Zabbix ではサポートされておらず、古い場合や、最新の機能およびバグ修正が含まれていない場合があります。 Zabbix 公式リポジトリの公式パッケージのみを使用することを推奨します。 以前にオペレーティングシステムのリポジトリから Zabbix をインストールした場合は、OS リポジトリから Zabbix パッケージをアップグレードする手順を参照してください。

パッケージは、MySQL/PostgreSQL データベースおよび Apache/Nginx Web サーバーをサポートしています。 Zabbix サーバーとプロキシは同じデータベースを共有できないため、同じホストに両方をインストールする場合は、異なるデータベース名を使用してください。

必要に応じて、Zabbix エージェント/エージェント 2、Zabbix get、および Zabbix sender 用の個別のパッケージをZabbix 公式リポジトリから利用できます。

Debian または Ubuntu ベースのシステムでは、apt を使用して追加の Zabbix パッケージをインストールすると、同じリポジトリからすでにインストールされている Zabbix パッケージのアップグレードも選択される場合があります。 インストール済みの Zabbix サーバーまたはプロキシのパッケージをアップグレードせずにパッケージをインストールするには、インストール前に一時的にそのパッケージを保留し、インストール後に保留を解除します。

apt-mark hold zabbix-server-mysql
apt install zabbix-sender
apt-mark unhold zabbix-server-mysql

Zabbix では、Linux 以外のオペレーティングシステム向けに、コンパイル済みの Zabbix エージェントバイナリも提供しています。以下を参照してください。

パッケージのインストールに関する注意事項

以下の注意事項は、すべてのシステムに適用されます。

  • PostgreSQLを使用する場合、Zabbix サーバー/プロキシの設定で DBHost=localhost(またはIPアドレス)を指定すると、PostgreSQLはローカルUNIXソケットではなくネットワークソケットを使用します。関連する設定手順については、SELinuxの設定を参照してください。
  • TimescaleDBを使用する場合は、追加のTimescaleDBの設定を参照してください。
  • Zabbix Javaゲートウェイ(JMXアプリケーションの監視用)をインストールする場合は、RHELベースのシステムおよびDebianベースのシステム向けの追加の設定手順を参照してください。
  • Zabbix MCPサーバーをインストールする場合は、zabbix-mcp-serverパッケージをインストールし、サービスを開始する前に設定ファイル(少なくとも FrontendURL と AllowedIP)を更新してください。
  • Zabbix エージェントをrootとして実行する場合は、エージェントをrootとして実行を参照してください。
  • Zabbixプロキシでのアプリケーションパフォーマンス監視(APM)は、以下のパッケージでサポートされています。
    • RHEL 10およびその派生版 - ZabbixプロキシのAPMパッケージ(例:zabbix-proxy-mysqlの代わりにzabbix-proxy-mysql-apm)をインストールします。また、EPELリポジトリをインストールし、CRB依存パッケージリポジトリを有効にする必要があります。
    • Debian 12以降、Raspberry Pi OS(Raspbian)12以降、Ubuntu 24.04以降 - APMはZabbixプロキシパッケージに含まれています。
    • その他のシステムでは、--with-apmオプションを指定して、ソースから Zabbixプロキシをインストールできます。

以下の注意事項は、RHELおよびその派生版に適用されます。

SELinuxの設定

Zabbixは、ソケットベースのプロセス間通信を使用します。 Security-Enhanced Linux(SELinux)が有効になっているシステムでは、ZabbixがSocketDirディレクトリ内にUNIXドメインソケットを作成および使用できるように、SELinuxルールを追加する必要がある場合があります。 ソケットファイルは、Zabbixサーバー(アラート、前処理、IPMI)およびZabbixプロキシ(IPMI)によって使用され、プロセスの実行中に存在します。

SELinuxをenforcingモードで有効にしている場合は、Zabbix Webインターフェースとサーバー間の通信を有効にするため、次のコマンドを実行します。

RHEL 7(およびそれ以降)、AlmaLinux、CentOS Stream、Oracle Linux、Rocky Linux 8(およびそれ以降)の場合:

setsebool -P httpd_can_connect_zabbix on

データベースにネットワーク経由でアクセスする場合(PostgreSQLのlocalhostを含む)は、Zabbix Webインターフェースがデータベースに接続できるようにする必要もあります。

setsebool -P httpd_can_network_connect_db on

RHEL 7より前のバージョンの場合:

setsebool -P httpd_can_network_connect on
setsebool -P zabbix_can_network on

SELinuxの設定を適用した後、Apacheを再起動します。

systemctl restart httpd

必要に応じて、Zabbix公式リポジトリから事前定義済みのzabbix-selinux-policyパッケージをインストールできます。 このパッケージは、Zabbixのデプロイを簡素化し、設定が複雑であることを理由にユーザーがSELinuxを無効にするのを防ぐため、サポート対象のすべてのOSバージョン向けに提供されています。
AlmaLinux、CentOS Stream、RHEL、Rocky Linux、Oracle Linuxのバージョン10では、SELinuxポリシーはzabbix-selinux-policy-mainパッケージによって提供されます。zabbix-selinux-policyパッケージは、zabbix-selinux-policy-mainまたはselinux-policy-targeted-extraのいずれかに依存します。 zabbix-selinux-policy-mainパッケージはselinux-policy-targeted-extraと競合するため、両方のパッケージを同時にインストールすることはできません。

最大限のセキュリティを確保するため、カスタムSELinux設定を行うことを推奨します。

zabbix-selinux-policyパッケージ(AlmaLinux、CentOS Stream、RHEL、Rocky Linux、Oracle Linuxのバージョン10ではzabbix-selinux-policy-main)には、Zabbixによるソケットの作成および使用を許可し、HTTPdからPostgreSQL(Webインターフェースで使用)への接続を有効にする基本的なSELinuxポリシーが含まれています。

ソースのzabbix_policy.teファイルには、次のルールが含まれています。

module zabbix_policy 1.2;

require {
    type zabbix_t;
    type zabbix_port_t;
    type zabbix_var_run_t;
    type postgresql_port_t;
    type httpd_t;
    class tcp_socket name_connect;
    class sock_file { create unlink };
    class unix_stream_socket connectto;
}

#============= zabbix_t ==============
allow zabbix_t self:unix_stream_socket connectto;
allow zabbix_t zabbix_port_t:tcp_socket name_connect;
allow zabbix_t zabbix_var_run_t:sock_file create;
allow zabbix_t zabbix_var_run_t:sock_file unlink;
allow httpd_t zabbix_port_t:tcp_socket name_connect;

#============= httpd_t ==============
allow httpd_t postgresql_port_t:tcp_socket name_connect;

Debuginfoパッケージ

Debuginfoパッケージには、Zabbixバイナリのデバッグシンボルが含まれています。 通常のインストールや運用には必要ありませんが、高度なトラブルシューティングに役立ちます。

Debuginfoパッケージは、以下のバージョンで利用できます。Red Hat Enterprise Linux 7以前(派生ディストリビューションを含む)、およびSUSE Linux Enterprise Server 15以前(派生ディストリビューションを含む)。

zabbix-debuginfoリポジトリを有効にするには、次の手順を実行します。

  • RHEL 7では、/etc/yum.repos.d/zabbix.repoを編集し、zabbix-debuginfoセクションのenabled=1を設定します。
[zabbix-debuginfo]
name=Zabbix Official Repository debuginfo - $basearch
baseurl=http://repo.zabbix.com/zabbix/8.2/stable/rhel/7/$basearch/debuginfo/
enabled=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-ZABBIX-A14FE591
gpgcheck=1
  • SUSEでは、/etc/zypp/repos.d/zabbix.repoを編集し、zabbix-debuginfoセクションのenabled=1を設定します。
[zabbix-debuginfo]
name=Zabbix Official Repository debuginfo
type=rpm-md
baseurl=https://repo.zabbix.com/zabbix/8.2/unstable/sles/15/$basearch/debuginfo/
gpgcheck=1
gpgkey=https://repo.zabbix.com/zabbix/8.2/unstable/sles/15/$basearch/debuginfo/repodata/repomd.xml.key
enabled=0
update=1

有効にしたら、パッケージをインストールします。

  • RHELでは、すべてのZabbixコンポーネントのデバッグ情報を含む単一のパッケージをインストールします。
dnf install zabbix-debuginfo
  • SUSEでは、コンポーネント固有のdebuginfoパッケージをインストールします。
zypper install zabbix-<component>-debuginfo

不安定リリースリポジトリの有効化

以下の手順は、マイナーな Zabbix バージョンのリリース候補で使用される、安定版ではない Zabbix リリースリポジトリ(デフォルトでは無効)を有効にするためのものです。

まず、最新の zabbix-release パッケージをインストールするか、更新してください。 システムで rc パッケージを有効にするには、次の操作を行います:

Red Hat Enterprise Linux

/etc/yum.repos.d/zabbix.repo ファイルを開き、zabbix-unstable リポジトリの enabled=1 を設定します。

[zabbix-unstable]
name=Zabbix Official Repository (unstable) - $basearch
baseurl=https://repo.zabbix.com/zabbix/8.2/unstable/rhel/8/$basearch/
enabled=1
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-ZABBIX-A14FE591
Debian/Ubuntu

/etc/apt/sources.list.d/zabbix.list を開き、「Zabbix unstable repository」のコメントを解除します。

# Zabbix unstable repository
deb https://repo.zabbix.com/zabbix/8.2/unstable/debian bullseye main
deb-src https://repo.zabbix.com/zabbix/8.2/unstable/debian bullseye main
SUSE

/etc/zypp/repos.d/zabbix.repo ファイルを開き、zabbix-unstable リポジトリの enable=1 を設定します。

[zabbix-unstable]
name=Zabbix Official Repository
type=rpm-md
baseurl=https://repo.zabbix.com/zabbix/8.2/unstable/sles/15/x86_64/
gpgcheck=1
gpgkey=https://repo.zabbix.com/zabbix/8.2/unstable/sles/15/x86_64/repodata/repomd.xml.key
enabled=1
update=1