7 アップグレード手順

概要

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

高可用性(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 Zabbix 6.4 MySQLの必須バージョンが8.0.0から8.0.30へ変更。
Zabbixサーバー/プロキシに'libevent_pthreads'ライブラリが必須に。
アップグレード後の最初の起動時に、SQLite3を使用したZabbixプロキシは、古いバージョンのデータベース (すべてのヒストリを含む)を自動的に削除し、新しいデータベースを作成。
6.0.x LTS 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 Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
データベースの必須バージョンの上昇。
古いデータベースの場合、サーバー/プロキシは起動不能に。
データベースの構造変更のため監査ログレコードが失効。
5.2.x Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
データベースの必須バージョンの上昇。
集計アイテムが個別のタイプから削除。
5.0.x LTS 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 Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.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
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サーバーと連携不可能に。
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
'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 6.2
Zabbix 6.4
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
ヒストリテーブルのサイズによっては、データベースのアップグレードに時間がかかる。
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
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
ノードベースの分散監視の削除。
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
PHPの必須バージョンが5.1.6から5.3.0へ変更。
ZabbixサーバーとMySQLデータベースが適切に動作するには、大文字と小文字を区別するデータベースおよび文字セットutf8とutf8_binの照合順序が必須に。参照: データベース作成スクリプト
PHP拡張機能の'mysql'の代わりに'mysqli'が必須に。