7 アップグレード手順

概要

このセクションでは、Zabbix 7.4 のアップグレード情報を提供します。

関連する手順:

Zabbixエージェントのアップグレードは推奨されますが、必須ではありません。

Zabbixプロキシはアップグレードすることを強くお勧めします。 Zabbixサーバーは、サーバーと同じメジャーバージョンのプロキシを完全にサポートします。 Zabbixサーバーは、一つ前のLTSリリースバージョンより古いプロキシもサポートしますが、機能が制限されています (データ収集、リモートコマンドの実行、即時のアイテム値のチェック)。 設定の更新も無効になり、旧式のプロキシは古い設定でのみ機能します。

Zabbixサーバーの一つ前のLTSリリースバージョンより古いプロキシ、またはZabbixサーバーのメジャーバージョンより新しいプロキシはサポートされていません。 Zabbixサーバーは、サポートされていないプロキシからのデータを無視し、Zabbixサーバーとのすべての通信は失敗し、警告が表示されます。 詳細については、Version compatibilityを参照してください。

アップグレード中のダウンタイムとデータ損失を最小限に抑えるには、Zabbix サーバーを停止、アップグレード、起動してから、Zabbixプロキシを順番に停止、アップグレード、起動することをお勧めします。 サーバーのダウンタイム中も、実行中のプロキシはデータ収集を継続します。 サーバーが稼働すると、旧式のプロキシはデータを新しいサーバーに送信し (ただし、プロキシ設定は更新されません)、部分的には機能し続けます。 Zabbixサーバーのダウンタイム中に発生した障害に関する通知は、アップグレードされたサーバーが起動した後にのみ生成されます。

Zabbixプロキシが初めて起動され、SQLiteデータベースファイルが存在しない場合、プロキシは自動的にそれを作成します。

ZabbixプロキシがSQLite3を使用しており、起動時に既存のデータベースファイルのバージョンが必要なバージョンより古いことを検出した場合、データベースファイルは自動的に削除され、新しいファイルが作成されることに注意してください。したがって、 SQLiteデータベースファイルに保存されていた履歴データは失われます。Zabbixプロキシのバージョンがデータベースファイルの バージョンより古い場合、Zabbixはエラーをログに記録して終了します。

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

Zabbix 7.2.x、7.0.x、6.4.x、6.2.x、6.0.x、5.4.x、
5.2.x、5.0.x、4.4.x、4.2.x、4.0.x、3.4.x、3.2.x、
3.0.x、2.4.x、2.2.x、および 2.0.x からは、Zabbix 7.4.x への直接アップグレードが可能です。
それ以前のバージョンからアップグレードする場合は、Zabbix 2.0 およびそれ以前のドキュメントを参照してください。

アップグレード後、アップグレードした Zabbix バージョンに外部ソフトウェアが対応していない場合、Zabbix の一部のサードパーティ製ソフトウェア連携に影響が生じる可能性があることにご注意ください。

以下のアップグレードに関する注意事項を利用できます。

アップグレード元 完全なアップグレード注意事項を読む バージョン間の最も重要な変更点
7.2.x 対象:
Zabbix 7.4
PCREライブラリのサポートが廃止されました。
7.0.x LTS 対象:
Zabbix 7.2
Zabbix 7.4
Oracle DBのサポートが廃止されました。
6.4.x 対象:
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
必要な最小PHPバージョンが7.4.0から8.0.0に引き上げられました。
エージェント、HTTPエージェント、およびSNMP walk[oid]チェック用の非同期ポーラー。
プロキシ用の個別のデータベーステーブル。
Windowsエージェント設定ファイルのデフォルトの場所が変更されました。
Oracle DBは非推奨になりました。
古い数値(float)値タイプが廃止されました。
6.2.x 対象:
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
必要な最小MySQLバージョンが8.0.0から8.0.30に引き上げられました。
Zabbixサーバー/プロキシには 'libevent_pthreads' ライブラリが必要です。
アップグレード後の初回起動時に、SQLite3を使用するZabbixプロキシは古いバージョンのデータベース(すべての履歴を含む)を自動的に削除し、新しいデータベースを作成します。
6.0.x LTS 対象:
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
必要な最小PHPバージョンが7.2.5から7.4.0に引き上げられました。
サービス監視が大幅に再設計されました。
決定論的トリガーはアップグレード中に作成する必要があります。MySQL/MariaDBでバイナリログが有効な場合、これにはスーパーユーザー権限、または変数/設定パラメータ log_bin_trust_function_creators = 1 の設定が必要です。変数の設定方法については、データベース作成スクリプトを参照してください。
5.4.x 対象:
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
必要な最小データベースバージョンが引き上げられました。
データベースが古い場合、サーバー/プロキシは起動しません。
データベース構造の変更により監査ログレコードが失われます。
5.2.x 対象:
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
必要な最小データベースバージョンが引き上げられました。
集計アイテムは独立したタイプとして削除されました。
5.0.x LTS 対象:
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
必要な最小PHPバージョンが7.2.0から7.2.5に引き上げられました。
パスワードのハッシュアルゴリズムがMD5からbcryptに変更されました。
4.4.x 対象:
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
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
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
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 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
古いプロキシは、アップグレードされたサーバーにデータを報告できなくなりました。
新しいエージェントは、古い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
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
'libpthread' および 'zlib' ライブラリが必須になりました。
プレーンテキストプロトコルのサポートが廃止され、ヘッダーが必須になりました。
1.4より前のバージョンのZabbixエージェントはサポートされなくなりました。
パッシブプロキシ設定のServerパラメータが必須になりました。
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 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbixサーバー/WebインターフェースのバックエンドデータベースとしてのSQLiteサポートが廃止されました。
POSIX拡張の代わりにPerl Compatible Regular Expressions (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
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
履歴テーブルのサイズによっては、データベースのアップグレードに時間がかかる場合があります。
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
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
必要な最小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
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
ノードベースの分散監視が削除されました。
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
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
必要な最小PHPバージョンが5.1.6から5.3.0に引き上げられました。
サーバーが正しく動作するには大文字小文字を区別するMySQLデータベースが必要です。ZabbixサーバーがMySQLデータベースで正しく動作するには、文字セット utf8 および照合順序 utf8_bin が必要です。データベース作成スクリプトを参照してください。
'mysql' の代わりに 'mysqli' PHP拡張が必要です。