7 アップグレード手順

概要

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

関連手順:

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

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.4.x への直接アップグレードは、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 から可能です。 それ以前のバージョンからアップグレードする場合は、2.0 以前の Zabbix ドキュメントを参照してください。

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

利用可能なアップグレードノートは次のとおりです:

Upgrade from Read full upgrade notes Most important changes between versions
7.2.x For:
Zabbix 7.4
PCREライブラリのサポートが廃止されました。
7.0.x LTS For:
Zabbix 7.2
Zabbix 7.4
Oracle DBのサポートが廃止されました。
6.4.x For:
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
必要最小PHPバージョンが 7.4.0 から 8.0.0 に引き上げられました。
エージェント、HTTPエージェント、SNMP walk[OID]、SNMP get[OID] チェック用の非同期ポーラーが追加されました。
プロキシ用のデータベーステーブルが分離されました。
Windowsエージェントの設定ファイルの既定の場所が変更されました。
Oracle DBは非推奨になりました。
旧来の数値(float)値タイプが廃止されました。
6.2.x For:
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 For:
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 For:
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
必要最小データベースバージョンが引き上げられました。
古いデータベースではサーバー/プロキシは起動しません。
データベース構造の変更により監査ログの記録が失われます。
5.2.x For:
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 For:
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 For:
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 For:
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 For:
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 For:
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 For:
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 For:
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 For:
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 For:
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 For:
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 拡張が必要です。