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 に引き上げられました。
% 文字が、Zabbix エージェント および Zabbix エージェント 2UnsafeUserParameters リストに追加されました。
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]、および SNMP get[oid] チェック用の非同期ポーラー。
プロキシ用の個別のデータベーステーブル。
Windowsエージェント設定ファイルのデフォルトの場所が変更されました。
Oracle DBは非推奨になりました。
古い数値(浮動小数点)値タイプが廃止されました。
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 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
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 が必要です。database creation scripts を参照してください。
mysql の代わりに mysqli PHP 拡張が必要です。