アップグレード
アップグレードする前に、関連するすべてのアップグレードノートを確認することを強く推奨します。
また、どのコンポーネントをアップグレードする必要があるかを把握しておくと役立ちます。
概要
以下の環境向けに、段階的なアップグレード手順が用意されています::
- Red Hat Enterprise Linux(パッケージを使用)
- Debian/Ubuntu(パッケージを使用)
- コンテナを使用したアップグレード
- ソースコードを使用したアップグレード
- コンテナを使用
関連する手順:
- 高可用性(HA)クラスター内のサーバーについては、HAクラスターのアップグレードを参照してください
- TimescaleDBデータベースについては、TimescaleDBスキーマのアップグレードを参照してください
アップグレードするコンポーネント
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 |
1.6より前のバージョンのZabbix エージェントはサポートされなくなりました。 必要なデータベースの最小バージョンが引き上げられました。 必要なPHPの最小バージョンが8.0.0から8.2.0に引き上げられました。 %文字が、Zabbix エージェントおよびZabbix エージェント 2のUnsafeUserParametersリストに追加されました。 |
| 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互換正規表現(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データベースが必要です。Zabbix サーバーがMySQLデータベースで正常に動作するには、文字セットutf8およびutf8_bin照合順序が必要です。データベース作成スクリプトを参照してください。 mysqlの代わりにmysqli PHP拡張機能が必要です。 |