4 アップグレード

アップグレードする前に、関連するすべてのアップグレードノートを参照することを強くお勧めします。

また、どのコンポーネントをアップグレードする必要があるかを知っておくと便利です。

概要

段階的なアップグレード手順は以下の通りです::

関連手順:

アップグレードするコンポーネント

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

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

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

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

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

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

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

アップグレードに関する注意事項

Zabbix 8.0.xへの直接アップグレードは、バージョン2.0.x以降からサポートされています。それ以前のバージョンからアップグレードする場合は、Zabbix 2.0以前のドキュメントを参照してください。

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

以下のアップグレードノートがあります:

アップグレード元 アップグレードノート全文 バージョン間の主な変更点
7.4.x 対象:
Zabbix 8.0
必要なデータベースの最小バージョンを引き上げ。
必要なPHPの最小バージョンを8.0.0から8.2.0に引き上げ。
UnsafeUserParametersリストに%文字をZabbixエージェントおよびZabbixエージェント2で追加。
7.2.x 対象:
Zabbix 7.4
Zabbix 8.0
PCREライブラリのサポートを廃止。
7.0.x 対象:
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0
Oracle DBのサポートを廃止。
6.4.x 対象:
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0
必要な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
Zabbix 8.0
必要な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
Zabbix 8.0
必要な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
Zabbix 8.0
必要なデータベースの最小バージョンを引き上げ。
古いデータベースの場合、サーバー/プロキシは起動しません。
データベース構造の変更により監査ログ記録が失われます。
5.2.x 対象:
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0
必要なデータベースの最小バージョンを引き上げ。
集計アイテムを個別のタイプとして廃止。
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
Zabbix 8.0
必要な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
Zabbix 8.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
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.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 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.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
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0
'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 8.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
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.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
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.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
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.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
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0
必要なPHPの最小バージョンを5.1.6から5.3.0に引き上げ。
サーバーの正常な動作には大文字小文字を区別するMySQLデータベースが必要です。MySQLデータベースでZabbixサーバーが正常に動作するには、文字セットutf8およびutf8_bin照合順序が必要です。データベース作成スクリプトを参照してください。
'mysql'の代わりに'mysqli' PHP拡張が必要。