Documentation
Table of Contents
10 7.2.0へアップグレード時の注意点
Zabbix 7.0.xからZabbix 7.2.0へのアップグレードに関する注意点です。
すべての注意点は以下のように分類されています。
- 重大な変更 - 既存の環境を壊す可能性のある変更、およびアップグレードプロセスに関連する重要な情報
- その他 - Zabbixの機能の変更に関する残りのすべての情報
参照 :
- Zabbix 7.0.0より前のバージョンからのアップグレードに関する情報は、アップグレード手順を参照してください。
- 高可用性(HA)クラスター内のサーバーのアップグレード手順は、HAクラスターのアップグレードを参照してください。
アップグレードプロセス
MySQL/MariaDBでZabbixサーバーのアップグレードを正常に完了するには、バイナリロギングが有効で、スーパーユーザー権限がなく、MySQL構成ファイルにlog_bin_trust_function_creators = 1が設定されていない場合、MySQLでGLOBAL log_bin_trust_function_creators = 1を設定する必要がある場合があります。
MySQLコンソールを使用して変数を設定するには、次を実行します。
アップグレードが正常に完了したら、このオプションを無効にすることができます。
重大な変更
Oracle DBが廃止されました
Zabbix 7.0以降で非推奨となったバックエンドデータベースとしてのOracleのサポートが削除されました。
ヒストリ関数パラメーターのバックスラッシュのエスケープ
Zabbix 7.0.0からヒストリ関数の文字列パラメーターに、バックスラッシュの適切なエスケープが追加されました。
7.0より前のZabbixバージョンからのアップグレード中にバックスラッシュが追加されると、パラメーターが長くなり、パラメーターの長さが最大データサイズの255文字を超えるとトリガー関数が壊れる可能性があります。
この問題を回避するには、アップグレード前に長いパラメーターを手動でユーザーマクロに移動することをお勧めします。
Zabbix 7.2.5以降、7.0より前のZabbixバージョンからのアップグレードでは、結果のパラメーターの長さに対する追加のチェックが追加されていることに注意してください。結果の長さが最大サイズを超える場合、そのようなパラメーターはアップグレードされませんが、リストされているパラメーターを手動で修正するようにユーザーに求める警告がログに出力されます。
エスケープ関連のアップグレードの問題も参照してください。
パッケージインストールのフロントエンドファイルディレクトリが変更されました
フロントエンドファイル ディレクトリは、/usr/share/zabbixから/usr/share/zabbix/uiに移動されました。
注意: アップグレード中に、Webサーバー設定ファイルにカスタム変更(通常はNginxによる)が含まれている場合、新しいパスを含む更新されたファイルで自動的に上書きされることはありません。古い設定ファイルをバックアップしてから、新しい設定ファイルで上書きする必要があります。たとえば、RedHatベースのシステムでは次のようになります:
その後、更新された設定ファイル(/etc/nginx/conf.d/zabbix.conf)を手動で編集して、古い設定を復元します。
リポジトリ構造
Zabbixリポジトリには、不安定なバージョンの.../7.1/や安定バージョンの.../7.2/ではなく、.../7.2/stable/(リリースバージョン)および.../7.2/unstable/(アルファ、ベータ、リリース候補バージョンのプレリリースパッケージ)フォルダーにZabbixパッケージファイルが含まれるようになりました。
安定リリースと不安定リリースの両方に使用できるzabbix-releaseパッケージは、7.2/releaseフォルダーに個別に提供されています。
7.2以降のバージョンでは、non-supportedフォルダーのパッケージはthird-partyフォルダーに移動され、RHELとその派生ディストリビューション用にカスタマイズされたパッケージが含まれるようになりました。
新しいキーB5333005は、独自の専用キーzabbix-toolsを持つzabbix-toolsリポジトリを除くすべての署名に使用されます。
ロード可能なプラグイン実行可能ファイルの再配置
Zabbixエージェント2をパッケージからアップグレードすると、ロード可能なプラグイン実行可能ファイルが新しい場所、/usr/sbin/zabbix-agent2-pluginから/usr/libexec/zabbix(SLESの場合は/usr/lib/zabbix)へ移動されます。
アップグレード後、新しい場所を反映するために、以前に変更したプラグイン設定ファイルを更新する必要がある場合があります。 たとえば、MSSQLプラグインのPlugins.MSSQL.System.Pathパラメーターを/usr/libexec/zabbix/zabbix-agent2-plugin-mssqlに更新します。
auth APIプロパティが削除されました
Zabbix 6.4以降で非推奨となったauth APIプロパティのサポートが削除されました。 代替API認証方法については、Authenticationを参照してください。 その他のAPIの変更については、付録2. 7.0から7.2での変更点を参照してください。
ポーラーが設定されていないアイテムはサポート対象外となる
アイテムが設定キャッシュに追加された際、およびアイテムタイプが変更された際に、ポーラーのチェックが追加されました。このチェックは、エージェント、SNMPエージェント、HTTPエージェント、ブラウザ、スクリプト、JMX監視、ODBC監視、およびIPMIアイテムに対して追加されました。
ポーラーが設定されていない場合、アイテムは単に無視されるのではなく、サポート対象外となります。この変更は、手動で実行された場合("Test item")またはスクリプト実行時のアイテムの動作には影響しません。
その他
命名
アイテムヒストリウィジェットを設定する場合:
- 列パラメーターの名前がアイテムに変更されました。
- 選択アイテムリストのデータ列の名前がアイテムに変更されました。
データ概要ウィジェットが上位アイテムに移行
廃止されたデータ概要ウィジェットの機能を置き換える新しい上位アイテムウィジェットが追加されました。既存のデータ概要ウィジェットは上位アイテムに移行されます。
管理 -> 一般 -> GUIで概要テーブルの最大列数と最大行数の値が100を超える値に設定されていた場合、ホスト/アイテム値レコードは100に制限されますのでご注意ください。
ローレベルディスカバリ
ローレベルディスカバリのパフォーマンスが向上し、マスターアイテムあたり29999個の依存アイテムと3つの依存関係レベルという従来の制限が撤廃されました。