7 アップグレード手順
概要
このセクションでは、Zabbix 7.0 のアップグレード情報を提供します。
- Red Hat Enterprise Linux または Debian/Ubuntu 向けパッケージを使用する場合
- ソースを使用する場合
- コンテナを使用する場合
関連する手順:
- 高可用性(HA)クラスター内のサーバーについては、HAクラスターのアップグレードを参照してください
- TimescaleDB データベースについては、TimescaleDB スキーマのアップグレードを参照してください
Zabbixエージェントのアップグレードは推奨されますが、必須ではありません。
Zabbixプロキシはアップグレードすることを強くお勧めします。 Zabbixサーバーは、サーバーと同じメジャーバージョンのプロキシを完全にサポートします。 Zabbixサーバーは、一つ前のLTSリリースバージョンより古いプロキシもサポートしますが、機能が制限されています (データ収集、リモートコマンドの実行、即時のアイテム値のチェック)。 設定の更新も無効になり、旧式のプロキシは古い設定でのみ機能します。
Zabbixサーバーの一つ前のLTSリリースバージョンより古いプロキシ、またはZabbixサーバーのメジャーバージョンより新しいプロキシはサポートされていません。 Zabbixサーバーは、サポートされていないプロキシからのデータを無視し、Zabbixサーバーとのすべての通信は失敗し、警告が表示されます。 詳細については、Version compatibilityを参照してください。
アップグレード中のダウンタイムとデータ損失を最小限に抑えるには、Zabbix サーバーを停止、アップグレード、起動してから、Zabbixプロキシを順番に停止、アップグレード、起動することをお勧めします。 サーバーのダウンタイム中も、実行中のプロキシはデータ収集を継続します。 サーバーが稼働すると、旧式のプロキシはデータを新しいサーバーに送信し (ただし、プロキシ設定は更新されません)、部分的には機能し続けます。 Zabbixサーバーのダウンタイム中に発生した障害に関する通知は、アップグレードされたサーバーが起動した後にのみ生成されます。
Zabbixプロキシが初めて起動され、SQLiteデータベースファイルが見つからない場合、プロキシは自動的にそれを作成します。
注意 : ZabbixプロキシがSQLite3を使用しており、起動時に既存のデータベースファイルのバージョンが必要なバージョンより古いことが検出された場合、データベースファイルは自動的に削除され、新しいデータベースファイルが作成されます。 したがって、SQLite データベースファイルに保存されているヒストリデータは失われます。 Zabbixプロキシのバージョンがデータベースファイルのバージョンより古い場合、Zabbixはエラーをログに記録して終了します。
データベースのサイズによっては、データベースをバージョン7.0にアップグレードするのに時間がかかる場合があります。
Zabbix 7.0.xへの直接アップグレードはZabbix 6.4.x、6.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の一部のサードパーティソフトウェア統合が影響を受ける可能性があることに注意してください。
利用可能なアップグレードノートは次のとおりです:
| Upgrade from | Read full upgrade notes | Most important changes between versions |
|---|---|---|
| 6.4.x | For: Zabbix 7.0 |
必要最小PHPバージョンが 7.4.0 から 8.0.0 に引き上げられました。 エージェント、HTTPエージェント、SNMP walk[OID]、および新たに追加された SNMP get[OID] チェック向けの非同期ポーラー。 プロキシ用の個別のデータベーステーブル。 Windows エージェント設定ファイルの既定の配置場所が変更されました。 Oracle DB は非推奨です。 旧来の数値(float)値タイプは廃止されました。 |
| 6.2.x | For: Zabbix 6.4 Zabbix 7.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 |
必要最小PHPバージョンが 7.2.5 から 7.4.0 に引き上げられました。 サービス監視が大幅に再設計されました。 決定的トリガーはアップグレード中に作成する必要があります。MySQL/MariaDB でバイナリログが有効な場合、これにはスーパーユーザー権限、または変数/設定パラメータ log_bin_trust_function_creators = 1 の設定が必要です。変数の設定方法については、Database creation scripts を参照してください。 |
| 5.4.x | For: Zabbix 6.0 Zabbix 6.2 Zabbix 6.4 Zabbix 7.0 |
必要最小データベースバージョンが引き上げられました。 古いデータベースの場合、サーバー/プロキシは起動しません。 データベース構造の変更により、監査ログの記録が失われます。 |
| 5.2.x | For: Zabbix 5.4 Zabbix 6.0 Zabbix 6.2 Zabbix 6.4 Zabbix 7.0 |
必要最小データベースバージョンが引き上げられました。 集計アイテムは個別のタイプとしては削除されました。 |
| 5.0.x LTS | For: Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 Zabbix 6.2 Zabbix 6.4 Zabbix 7.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 |
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 |
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 サーバーでは動作できなくなります。 |
| 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 |
'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 サーバー/Webインターフェースのバックエンドデータベースとしての SQLite サポートは廃止されました。 POSIX 拡張の代わりに Perl Compatible Regular Expressions (PCRE) がサポートされます。 Zabbix サーバーには 'libpcre' および 'libevent' ライブラリが必須です。 user parameters、remote commands、'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 |
履歴テーブルのサイズによっては、データベースのアップグレードに時間がかかる場合があります。 |
| 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 |
必要最小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 |
ノードベースの分散監視は削除されました。 |
| 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 |
必要最小PHPバージョンが 5.1.6 から 5.3.0 に引き上げられました。 サーバーの正常な動作には大文字小文字を区別する MySQL データベースが必要です。Zabbix サーバーが MySQL データベースで正しく動作するには、文字セット utf8 と utf8_bin 照合順序が必要です。database creation scripts を参照してください。 'mysql' の代わりに 'mysqli' PHP 拡張が必要です。 |