7 アップグレード手順

概要

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

高可用性(HA)クラスター内のサーバーのアップグレード手順も参照してください。

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

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

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

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

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

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

Zabbix6.0.xへの直接アップグレードはZabbix6.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 1.8以前のバージョンからのアップグレードについては、各バージョンのZabbixのドキュメントを参照してください。

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

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

アップグレード元 全ての注意点を読む バージョン間の重要な変更点
6.2.x For:
Zabbix 6.4
MySQL必要最小バージョンが8.0.0から8.0.30へ変更
Zabbixサーバー/プロキシに'libevent_pthreads'ライブラリが必須に
アップグレード後の最初の起動時に、SQLite3を使用したZabbixプロキシは、古いバージョンのデータベース (すべての履歴を含む) を自動的に削除し、新しいデータベースを作成
6.0.x LTS For:
Zabbix 6.2
Zabbix 6.4
PHP必要最小バージョンが7.2.5から7.4.0へ変更
Deterministic トリガーはアップグレード中に作成する必要があります。MySQL/MariaDB でバイナリロギングが有効になっている場合、スーパーユーザー権限、または変数/構成パラメータ log_bin_trust_function_creators = 1 の設定が必要です。変数の設定方法については、Database creation scriptsを参照してください。
5.4.x For:
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
データベースの必要最小バージョンの上昇
古いデータベースの場合、サーバー/プロキシは起動不能に
データベース構造の変更により監査ログレコードが失効
5.2.x For:
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
データベースの必要最小バージョンの上昇
累計アイテムが個別のタイプから削除
5.0.x LTS For:
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.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
IBMDB2のサポート終了
PHP必要最小バージョンが5.4.0から7.2.0へ変更
データベースの必要最小バージョンの上昇
ZabbixPHPファイルディレクトリの変更
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
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サーバーと連携不能に
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
'libpthread'および'zlib'ライブラリが必須に
プレーンテキストプロトコルのサポートが削除されヘッダーが必須に
バージョン1.4以前のZabbixエージェントのサポート終了
パッシブプロキシ構成のサーバーパラメータが必須に
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サーバー/フロントエンドのバックエンドデータベースとしてのSQLiteサポートが削除
POSIX拡張の代わりにPerl互換正規表現(PCRE)をサポート
'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
ヒストリテーブルのサイズによっては、データベースのアップグレードに時間がかかる場合があります。
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
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
ノードベースの分散監視削除
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
PHP必要最小バージョンが5.1.6から5.3.0へ変更
ZabbixサーバーがMySQLデータベースと正しく連携するために、大文字と小文字を区別するデータベースおよび文字セットutf8とutf8_binの照合が必要に。 詳細はデータベース作成スクリプトを参照してください。
PHP拡張機能'mysql'の代わりに'mysqli'が必須に