Debian/Ubuntu

概要

このセクションでは、Debian/Ubuntu用の公式Zabbixパッケージを使用して、Zabbix 7.4.x から最新バージョンのZabbix 8.0.x へのアップグレード手順を説明します。

Zabbix 8.0.x のマイナーバージョン間（例：8.0.1 から 8.0.3 へのアップグレード）のアップグレード手順については、マイナーバージョン間のアップグレードを参照してください。

アップグレード手順

1 Zabbixプロセスの停止

Zabbixサーバーを停止して、データベースに新しいデータが挿入されていないことを確認します。

systemctl stop zabbix-server

Zabbixプロキシやエージェント、エージェント2もアップグレードする場合は、同様に停止します。

systemctl stop zabbix-proxy
systemctl stop zabbix-agent
systemctl stop zabbix-agent2

2 Zabbixデータベースのバックアップ

既存のZabbixデータベースをバックアップして、アップグレードの失敗 (ディスク容量の問題、電源喪失、予期せぬ問題など) から保護します。

3 Zabbixの設定ファイル、PHPファイル、およびZabbixバイナリをバックアップする

既存のZabbixの設定ファイル、PHPファイル、およびZabbixバイナリをバックアップします。

設定ファイルについては、次を実行します。

mkdir /opt/zabbix-backup/
cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/
# Apacheの場合:
cp /etc/apache2/conf-enabled/zabbix.conf /opt/zabbix-backup/
# Nginxの場合:
cp /etc/nginx/conf.d/zabbix.conf /opt/zabbix-backup/
cp /etc/zabbix/nginx.conf /opt/zabbix-backup/

PHPファイルとZabbixバイナリについては、次を実行します。

cp -R /usr/share/zabbix/ /opt/zabbix-backup/
cp -R /usr/share/zabbix-* /opt/zabbix-backup/

4 リポジトリ設定パッケージを更新する

アップグレードを続行する前に、現在の Zabbix リポジトリパッケージをアンインストールします。

rm -Rf /etc/apt/sources.list.d/zabbix.list

また、アップグレード中にパッケージマネージャーが古いバージョンを再利用しないように、新しいパッケージをダウンロードする前に、作業ディレクトリ内の古い Zabbix パッケージを手動で削除する必要がある場合があります（例: rm zabbix-release_latest+debian12_all.deb）。

その後、最新のリポジトリ設定パッケージをインストールして、最新のパッケージとの互換性を確保し、最近のセキュリティパッチやバグ修正を含めます。

Debian 13 では、次を実行します。

wget https://repo.zabbix.com/zabbix/8.0/release/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian13_all.deb
dpkg -i zabbix-release_latest+debian13_all.deb

Debian 12 では、次を実行します。

wget https://repo.zabbix.com/zabbix/8.0/release/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian12_all.deb
dpkg -i zabbix-release_latest+debian12_all.deb

Ubuntu 26.04 では、次を実行します。

wget https://repo.zabbix.com/zabbix/8.0/release/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu26.04_all.deb
dpkg -i zabbix-release_latest+ubuntu26.04_all.deb

Ubuntu 24.04 では、次を実行します。

wget https://repo.zabbix.com/zabbix/8.0/release/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu24.04_all.deb
dpkg -i zabbix-release_latest+ubuntu24.04_all.deb

Ubuntu 22.04 では、次を実行します。

wget https://repo.zabbix.com/zabbix/8.0/release/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu22.04_all.deb
dpkg -i zabbix-release_latest+ubuntu22.04_all.deb

Zabbix リポジトリ設定に関するプロンプトが表示される場合があります。

Configuration file '/etc/apt/sources.list.d/zabbix.list'
==> Deleted (by you or by a script) since installation.
==> Package distributor has shipped an updated version.
What would you like to do about it ?  Your options are:
Y or I  : install the package maintainer's version
N or O  : keep your currently-installed version
D       : show the differences between the versions
Z       : start a shell to examine the situation
The default action is to keep your current version.
*** zabbix.list (Y/I/N/O/D/Z) [default=N] ?

Y（または I）を入力して、Zabbix リポジトリ設定のパッケージメンテナー版をインストールします。

その後、リポジトリ情報を更新します。

apt update

5 Zabbixコンポーネントのアップグレード

Zabbixコンポーネントをアップグレードするには、次を実行します。

apt install --only-upgrade zabbix-server-mysql zabbix-frontend-php zabbix-agent

• PostgreSQLを使用している場合は、コマンド内のmysqlをpgsqlに置き換えてください。
• プロキシをアップグレードする場合は、コマンド内のserverをproxyに置き換えてください。
• Zabbix agent 2をアップグレードする場合は、コマンド内のzabbix-agentをzabbix-agent2 zabbix-agent2-plugin-*に置き換えてください。

Zabbixサーバー（またはプロキシ）の設定に関するプロンプトが表示される場合があります。

Configuration file '/etc/zabbix/zabbix_server.conf'
==> Modified (by you or by a script) since installation.
==> Package distributor has shipped an updated version.
What would you like to do about it ?  Your options are:
Y or I  : install the package maintainer's version
N or O  : keep your currently-installed version
D       : show the differences between the versions
Z       : start a shell to examine the situation
The default action is to keep your current version.
*** zabbix_server.conf (Y/I/N/O/D/Z) [default=N] ?

状況に最も適したオプションを入力してください。 たとえば、Dを入力して現在の設定と新しい設定を比較し、その後、パッケージ保守担当者のバージョンをインストールするかどうか（YまたはI）を判断します。

次に、Zabbix Webインターフェースをアップグレードし、Webサーバーを再起動します。

Apacheの場合は、次を実行します。

apt install zabbix-apache-conf
systemctl restart apache2

Nginxの場合は、次を実行します。

apt install zabbix-nginx-conf
systemctl restart nginx

Nginxでは、nginx.conf設定ファイルに関するプロンプトが表示される場合があります。状況に最も適したオプションを入力してください。

Configuration file '/etc/zabbix/nginx.conf'
 ==> Modified (by you or by a script) since installation.
 ==> Package distributor has shipped an updated version.
   What would you like to do about it ?  Your options are:
    Y or I  : install the package maintainer's version
    N or O  : keep your currently-installed version
      D     : show the differences between the versions
      Z     : start a shell to examine the situation
 The default action is to keep your current version.
*** nginx.conf (Y/I/N/O/D/Z) [default=N] ?

6 コンポーネントの設定パラメータを確認する

関連するアップグレードノートを確認し、設定パラメータに変更が必要かどうかを確認してください。

新しいオプションパラメータについては、What's newページを参照してください。

Webサーバーとして Nginx を使用しており、アップグレード中に /etc/zabbix/nginx.conf 設定ファイルが再インストールされた場合は、ファイルを確認し、listen および server_name ディレクティブを Zabbix Webインターフェースの設定に合わせて更新してください。

7 Zabbixプロセスの起動

アップグレードされたZabbixコンポーネントを起動します。

systemctl start zabbix-server
systemctl start zabbix-proxy
systemctl start zabbix-agent
systemctl start zabbix-agent2

8 Webブラウザのクッキーとキャッシュのクリア

アップグレード後、Zabbix Webインターフェースが正しく動作するために、Webブラウザのクッキーとキャッシュのクリアが必要になる場合があります。

マイナーバージョン間のアップグレード

Zabbix 8.0.x のマイナーバージョン間（例: 8.0.1 から 8.0.3 へのアップグレード）が可能です。

まず、リポジトリ情報を更新します:

apt update

次に、すべてのZabbixコンポーネントをアップグレードするには、以下を実行します:

apt install --only-upgrade 'zabbix*'

• Zabbixサーバーのみをアップグレードする場合は、コマンド内の 'zabbix*' を 'zabbix-server*' に置き換えてください。
• Zabbixプロキシのみをアップグレードする場合は、コマンド内の 'zabbix*' を 'zabbix-proxy*' に置き換えてください。
• Zabbixエージェントのみをアップグレードする場合は、コマンド内の 'zabbix*' を 'zabbix-agent*' に置き換えてください。
• Zabbixエージェント2のみをアップグレードする場合は、コマンド内の 'zabbix*' を 'zabbix-agent2*' に置き換えてください。