2 Debian/Ubuntu

概要

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

アップグレードする前に、関連するアップグレード時の注意点を確認し、システムがZabbix 7.0の要件を満たしていることを確認してください。

アップグレード中に並行してSSHのセッションを実行することを検討してください。一方はアップグレード手順の実行用で、もう一方はサーバー/プロキシのログを監視用です。例えば、tail -f zabbix_server.logまたはtail -f zabbix_proxy.logを実行すると、最新のログとエラー発生をリアルタイムで把握することができます。これは本番環境のインスタンスにとって重要です。

Zabbix 7.0.xのマイナーバージョン間 (たとえば、7.0.1から7.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/7.0/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 repository を参照してください。

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/7.0/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.0/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 agent 2をアップグレードする場合は、コマンド内のzabbix-agentをzabbix-agent2 zabbix-agent2-plugin-*に置き換えてください。

apt install zabbix-agent2コマンドでZabbix agent 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）をインストールするかどうかを判断します。

次に、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 コンポーネントの設定パラメータを確認する

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

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

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 7.0.xはマイナーバージョン間の、たとえば7.0.1から7.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-*'に置き換えます。