アップグレード中は、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

概要