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

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/
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/8.0/release/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian12_all.deb
dpkg -i zabbix-release_latest+debian12_all.deb

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

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

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

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 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*' に置き換えてください。

What’s next?

Red Hat Enterprise Linux

Docs

Debian/Ubuntu

概要