アップグレード中は、2 つの SSH セッションを並行して使用することを検討してください。1 つはアップグレード手順の実行用、もう 1 つはサーバー/プロキシのログ監視用です。たとえば、2 つ目のセッションで tail -f zabbix_server.log または tail -f zabbix_proxy.log を実行すると、最新のログエントリや発生した可能性のあるエラーをリアルタイムで確認できます。これは本番環境では特に重要です。

Zabbix 7.4.x のマイナーバージョン間でアップグレードする手順（たとえば 7.4.1 から 7.4.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/
cp /etc/apache2/conf-enabled/zabbix.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 12 では、次を実行します。

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

古い Debian バージョンでは、上記のリンクを Zabbix repository の正しいものに置き換えてください。ただし、これらのバージョン向けのパッケージにはすべての Zabbix コンポーネントが含まれていない場合があり、パッケージからそれらのコンポーネントをアップグレードするには、OS のアップグレードを検討してください。含まれているコンポーネントの一覧については、Zabbix packages を参照してください。

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

wget https://repo.zabbix.com/zabbix/7.4/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/7.4/release/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu22.04_all.deb
dpkg -i zabbix-release_latest+ubuntu22.04_all.deb

古い Ubuntu バージョンでは、上記のリンクを Zabbix repository の正しいものに置き換えてください。ただし、これらのバージョン向けのパッケージにはすべての Zabbix コンポーネントが含まれていない場合があり、パッケージからそれらのコンポーネントをアップグレードするには、OS のアップグレードを検討してください。含まれているコンポーネントの一覧については、Zabbix packages を参照してください。

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] ?

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

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

apt update

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

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

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

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

'apt install zabbix-agent2'コマンドを使用して Zabbixエージェント2をアップグレードすると、エラーが発生する可能性があります。詳細については既知の問題点を参照してください。

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) をインストールするかどうかを決定します。

次に、Apacheを使用したZabbixフロントエンドをアップグレードし、再起動するには、次のコマンドを実行します。

apt install zabbix-apache-conf
systemctl restart apache2

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

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

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

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 7.4.x のマイナーバージョン間ではアップグレードが可能です（たとえば、7.4.1 から 7.4.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*' に置き換えます。

What’s next?

3 コンテナからのアップグレード

Docs

2 Debian/Ubuntu

概要