パッケージからのインストールに関する注意
概要
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 エージェントバイナリも提供しています。以下を参照してください。
- MSI からの Windows エージェントのインストール
- PKG からの macOS エージェントのインストール
- IBM AIX 上の Zabbix エージェント
- レガシーバイナリ(HP-UX、NetBSD、Tru64、古いバージョンの SLES など、古いシステムやあまり一般的でないシステム向け)
パッケージのインストールに関する注意事項
以下の注意事項は、すべてのシステムに適用されます。
- 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 10およびその派生版 - ZabbixプロキシのAPMパッケージ(例:
以下の注意事項は、RHELおよびその派生版に適用されます。
- EPELリポジトリ(ZabbixプロキシのAPMパッケージなどで使用)を有効にしており、そこからZabbixパッケージも提供される場合は、公式のZabbixパッケージをインストールする前に、パッケージ解決の対象からEPELを除外する必要があります。EPELのZabbixパッケージが誤ってインストールされる場合を参照してください。
- Red Hat UBI環境にZabbixパッケージをインストールする場合は、Red Hat UBI環境向けのRHEL用Zabbixパッケージを参照してください。
- ICMP pingアイテムを使用する場合、
fpingのパッケージもZabbix公式リポジトリから入手できます。
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