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の一部のサードパーティ製ソフトウェアとの連携に影響が出る可能性があることにご注意ください。

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

Upgrade from Read full upgrade notes Most important changes between versions
7.4.x For:
Zabbix 8.0
必要なデータベースの最小バージョンが引き上げられました。
必要な PHP の最小バージョンが 8.0.0 から 8.2.0 に引き上げられました。
UnsafeUserParameters リストに % 文字が追加されました。Zabbix エージェント および Zabbix agent 2 で有効です。
7.2.x For:
Zabbix 7.4
Zabbix 8.0
PCRE ライブラリのサポートが廃止されました。
7.0.x For:
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0
Oracle DB のサポートが廃止されました。
6.4.x For:
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 8.0
必要な PHP の最小バージョンが 7.4.0 から 8.0.0 に引き上げられました。
エージェント、HTTP agent、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
Zabbix 8.0
必要な 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
Zabbix 8.0
必要な 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
Zabbix 8.0
必要なデータベースの最小バージョンが引き上げられました。
古いデータベースの場合、サーバー/プロキシは起動しません。
データベース構造の変更により、監査ログの記録が失われます。
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
Zabbix 8.0
必要なデータベースの最小バージョンが引き上げられました。
集約アイテムは個別のタイプとしては廃止されました。
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
Zabbix 8.0
必要な 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
Zabbix 8.0
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
Zabbix 8.0
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 8.0
古いプロキシは、アップグレードされたサーバーにデータを報告できなくなります。
新しいエージェントは、古い 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
Zabbix 8.0
'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 8.0
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
Zabbix 8.0
履歴テーブルのサイズによっては、データベースのアップグレードに時間がかかる場合があります。
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
Zabbix 8.0
必要な 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
Zabbix 8.0
ノードベースの分散監視は廃止されました。
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
Zabbix 8.0
必要な PHP の最小バージョンが 5.1.6 から 5.3.0 に引き上げられました。
サーバーが正しく動作するには、大文字小文字を区別する MySQL データベースが必要です。Zabbix サーバーが MySQL データベースで正しく動作するには、文字セット utf8 と utf8_bin 照合順序が必要です。データベース作成スクリプト を参照してください。
'mysql' の代わりに 'mysqli' PHP 拡張が必要です。