Table of Contents

2 Debian/Ubuntu

2 Debian/Ubuntu

概要

このセクションでは、Debian/Ubuntu用の公式Zabbixパッケージを使用して、Zabbix 5.4.xからZabbix 6.0.xの最新バージョンへのアップグレードを成功させるために必要な手順を説明します。

Zabbixエージェントのアップグレードは必須ではありません(推奨)が、Zabbixサーバーとプロキシは同じメジャーバージョンである必要があります。したがってサーバープロキシ構成では、Zabbixサーバーとすべてのプロキシを停止してアップグレードする必要があります。サーバーのアップグレード中にプロキシを実行し続けても、プロキシのアップグレード中に古いデータが破棄され、プロキシ設定がサーバーと同期されるまで新しいデータが収集されないため、メリットがありません。

プロキシ上のSQLiteデータベースは、データベースのアップグレードがサポートされておらず、データベースファイルを手動で削除する必要があるため、アップグレード前のプロキシからのヒストリデータは失われることに注意してください。プロキシが初めて起動され、SQLiteデータベースファイルが見つからない場合、プロキシは自動的に作成します。

データベースのサイズによっては、バージョン6.0へのデータベースアップグレードに時間がかかる場合があります。

アップグレードする前にアップグレード時の注意点を必ずお読みください！

アップグレード時の注意点は以下のようにまとめられています。

アップグレード元	全ての注意点を読む	バージョン間の重要な変更点
5.4.x	Zabbix 6.0	データベースの必須バージョンの上昇。古いデータベースの場合、サーバー/プロキシは起動不能に。データベースの構造変更のため監査ログレコードが失効。
5.2.x	Zabbix 5.4 Zabbix 6.0	データベースの必須バージョンの上昇。集計アイテムが個別のタイプから削除。
5.0.x LTS	Zabbix 5.2 Zabbix 5.4 Zabbix 6.0	PHPの必須バージョンが7.2.0から7.2.5へ変更。
4.4.x	Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0	IBM DB2のサポート終了。 PHPの必須バージョンが5.4.0から7.2.0へ変更。データベースの必須バージョンの上昇。 ZabbixのPHPファイルディレクトリの変更。
4.2.x	Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0	Jabber、EZ Textingメディアタイプの削除。
4.0.x LTS	Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0	古いプロキシからアップグレードされたサーバーへのにデータ報告が不可能に。新しいエージェントは古いZabbixサーバーと連携不可能に。
3.4.x	Zabbix 4.0 Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0	'libpthread'および'zlib'ライブラリが必須に。プレーンテキストプロトコルのサポートが削除されヘッダーが必須に。バージョン1.4以前のZabbixエージェントのサポート終了。パッシブプロキシの設定にサーバーパラメーターが必須に。
3.2.x	Zabbix 3.4 Zabbix 4.0 Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0	ZabbixサーバーとWebインターフェースのバックエンドデータベースとしてのSQLiteサポートが削除。 POSIX拡張の代わりにPerl互換正規表現(PCRE)をサポート。 Zabbixサーバーに'libpcre'および'libevent'ライブラリが必須に。 'nowait'フラグが設定されていないユーザーパラメーター、リモートコマンド、およびsystem.run[]アイテムに対して、Zabbixサーバーが実行したスクリプト同様に終了コードのチェックが追加。 Zabbix Javaゲートウェイは新しい機能をサポートするためにアップグレードが必須。
3.0.x LTS	Zabbix 3.2 Zabbix 3.4 Zabbix 4.0 Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0	ヒストリテーブルのサイズによっては、データベースのアップグレードに時間がかかる。
2.4.x	Zabbix 3.0 Zabbix 3.2 Zabbix 3.4 Zabbix 4.0 Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0	PHPの必須バージョンが5.3.0から5.4.0へ変更。 LogFileエージェントパラメーターの指定が必須に。
2.2.x LTS	Zabbix 2.4 Zabbix 3.0 Zabbix 3.2 Zabbix 3.4 Zabbix 4.0 Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0	ノードベースの分散監視の削除。
2.0.x	Zabbix 2.2 Zabbix 2.4 Zabbix 3.0 Zabbix 3.2 Zabbix 3.4 Zabbix 4.0 Zabbix 4.2 Zabbix 4.4 Zabbix 5.0 Zabbix 5.2 Zabbix 5.4 Zabbix 6.0	PHPの必須バージョンが5.1.6から5.3.0へ変更。 ZabbixサーバーとMySQLデータベースが適切に動作するには、大文字と小文字を区別するデータベースおよび文字セットutf8とutf8_binの照合順序が必須に。参照: データベース作成スクリプト。 PHP拡張機能の'mysql'の代わりに'mysqli'が必須に。

6.0の要件も確認してください。

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

Zabbix 6.0.xのマイナーバージョン間 (たとえば、6.0.1から6.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データベースのバックアップ

これは非常に重要なステップです。データベースのバックアップがあることを確認してください。アップグレード手順が失敗（ディスク容量の不足、電源オフ、予期しない問題）した場合に役立ちます。

3 設定ファイル、PHPファイル、Zabbixバイナリのバックアップ

Zabbixバイナリ、設定ファイル、PHPファイルディレクトリのバックアップコピーを作成します。

設定ファイル:

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 リポジトリ構成パッケージ更新

アップグレードを続行するには、現在のリポジトリパッケージをアンインストールする必要があります。

rm -Rf /etc/apt/sources.list.d/zabbix.list

次に、最新のリポジトリ構成パッケージをインストールして、最新のパッケージとの互換性を確保し、最新のセキュリティパッチやバグ修正を含めます。

Debian 12では次を実行します。

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

Debian 11では次を実行します。

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

Debian 10では次を実行します。

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

古いDebianバージョンの場合は、上記のリンクをZabbixリポジトリの正しいリンクに置き換えてください。ただし、これらのバージョンのパッケージには、Zabbixコンポーネントが何か含まれていない可能性があることに注意してください。含まれるコンポーネントのリストについては、Zabbixパッケージを参照してください。

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

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

Ubuntu 20.04では次を実行します。

wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu20.04_all.deb
       dpkg -i zabbix-release_latest+ubuntu20.04_all.deb

Ubuntu 18.04では次を実行します。

wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu18.04_all.deb
       dpkg -i zabbix-release_latest+ubuntu18.04_all.deb

古いUbuntuバージョンの場合は、上記のリンクをZabbixリポジトリの正しいリンクに置き換えてください。ただし、これらのバージョンのパッケージには、Zabbixコンポーネントが何か含まれていない可能性があることに注意してください。含まれるコンポーネントのリストについては、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] ?

Y (またはI)を入力して、パッケージ管理者のバージョンのZabbixリポジトリ設定をインストールします。

次に、リポジトリ情報を更新します。

apt update

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

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

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

PostgreSQLを使用している場合は、コマンドのmysqlをpgsqlに置き換えます。
プロキシをアップグレードする場合は、コマンドのserverをproxyに置き換えてください。
エージェント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を使用したWebフロントエンドを正しくアップグレードするには、次を実行します

apt install zabbix-apache-conf

ディストリビューションDebian10 (buster)/Ubuntu 18.04 (bionic)/Raspbian 10(buster)より前のバージョンは、Zabbixフロントエンド6.0に必要なPHP7.2以降を提供していません。古いディストリビューションへのZabbixフロントエンドのインストールについては、情報を参照してください。

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 6.0.xはマイナーバージョン間の、たとえば6.0.1から6.0.3のアップグレードが可能です。

まず、リポジトリ情報を更新します。

apt update

次に、Zabbixマイナーバージョンをアップグレードするために、次を実行してください。

apt install --only-upgrade 'zabbix*'

Zabbixサーバーのみのマイナーバージョンをアップグレードするには、次を実行してください。

apt install --only-upgrade 'zabbix-server*'

Zabbixエージェントのみのマイナーバージョンアップグレードをするには、次を実行してください。

apt install --only-upgrade 'zabbix-agent*'

また、Zabbixエージェント2の場合は

apt install --only-upgrade 'zabbix-agent2*'

Documentation