Table of Contents
Debian/Ubuntu
概要
このセクションでは、Debian/Ubuntu用の公式Zabbixパッケージを使用して、Zabbix 7.4.x から最新バージョンのZabbix 8.0.x へのアップグレード手順を説明します。
アップグレードの前に、関連するアップグレードノートを確認し、システムがZabbix 8.0の要件を満たしていることを確認してください。
アップグレード中は、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サーバーを停止して、データベースに新しいデータが挿入されていないことを確認します。
Zabbixプロキシやエージェント、エージェント2もアップグレードする場合は、同様に停止します。
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バイナリの場合は、次を実行します。
4 リポジトリ設定パッケージの更新
アップグレードを進める前に、現在のZabbixリポジトリパッケージをアンインストールしてください:
また、作業ディレクトリから古い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.debUbuntu 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）を入力してください。
その後、リポジトリ情報を更新します:
5 Zabbixコンポーネントのアップグレード
Zabbixコンポーネントをアップグレードするには、次を実行します。
- 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フロントエンドをアップグレードし、再起動するには、次のコマンドを実行します。
6 コンポーネントの設定パラメータの確認
関連するアップグレードノートを確認し、設定パラメータに変更が必要かどうかを確認してください。
新しいオプションパラメータについては、新機能ページを参照してください。
7 Zabbixプロセスの起動
アップグレードされたZabbixコンポーネントを起動します。
systemctl start zabbix-server
systemctl start zabbix-proxy
systemctl start zabbix-agent
systemctl start zabbix-agent28 Webブラウザのクッキーとキャッシュのクリア
アップグレード後、Zabbix Webインターフェースが正しく動作するために、Webブラウザのクッキーとキャッシュのクリアが必要になる場合があります。
マイナーバージョン間のアップグレード
Zabbix 8.0.x のマイナーバージョン間（例: 8.0.1 から 8.0.3 へのアップグレード）が可能です。
まず、リポジトリ情報を更新します:
次に、すべてのZabbixコンポーネントをアップグレードするには、以下を実行します:
- Zabbixサーバーのみをアップグレードする場合は、コマンド内の
'zabbix*'を'zabbix-server*'に置き換えてください。 - Zabbixプロキシのみをアップグレードする場合は、コマンド内の
'zabbix*'を'zabbix-proxy*'に置き換えてください。 - Zabbixエージェントのみをアップグレードする場合は、コマンド内の
'zabbix*'を'zabbix-agent*'に置き換えてください。 - Zabbixエージェント2のみをアップグレードする場合は、コマンド内の
'zabbix*'を'zabbix-agent2*'に置き換えてください。