[comment]: # translation:outdated

[comment]: # ({02c50527-2ef2416e})
# 10 7.2.0へアップグレード時の注意点

Zabbix 7.0.xからZabbix 7.2.0へのアップグレードに関する注意点です。

すべての注意点は以下のように分類されています。

- **重大な変更** - 既存の環境を壊す可能性のある変更、およびアップグレードプロセスに関連する重要な情報
- **その他** - Zabbixの機能の変更に関する残りのすべての情報

参照 :

- Zabbix 7.0.0より前のバージョンからのアップグレードに関する情報は、[アップグレード手順](/manual/installation/upgrade)を参照してください。
- **高可用性**(HA)クラスター内のサーバーのアップグレード手順は、[HAクラスターのアップグレード](/manual/concepts/server/ha#upgrading-ha-cluster)を参照してください。

[comment]: # ({/02c50527-2ef2416e})

[comment]: # ({5f77a7e6-6f14cd5e})

#### アップグレードプロセス

MySQL/MariaDBでZabbixサーバーのアップグレードを正常に完了するには、バイナリロギングが有効で、スーパーユーザー権限がなく、MySQL構成ファイルに`log_bin_trust_function_creators = 1`が設定されていない場合、MySQLで`GLOBAL log_bin_trust_function_creators = 1`を設定する必要がある場合があります。

MySQLコンソールを使用して変数を設定するには、次を実行します。

    mysql> SET GLOBAL log_bin_trust_function_creators = 1;

アップグレードが正常に完了したら、このオプションを無効にすることができます。

    mysql> SET GLOBAL log_bin_trust_function_creators = 0;

[comment]: # ({/5f77a7e6-6f14cd5e})

[comment]: # ({b7a15027-2a68033f})
## 重大な変更

[comment]: # ({/b7a15027-2a68033f})

[comment]: # ({11499d1a-770c50b6})
#### Oracle DBが廃止されました

Zabbix 7.0以降で非推奨となったバックエンドデータベースとしてのOracleのサポートが削除されました。

[comment]: # ({/11499d1a-770c50b6})

[comment]: # ({7b8e63e3-a4d795de})
#### ヒストリ関数パラメーターのバックスラッシュのエスケープ

Zabbix 7.0.0からヒストリ関数の文字列パラメーターに、バックスラッシュの適切なエスケープが追加されました。

7.0より前のZabbixバージョンからのアップグレード中にバックスラッシュが追加されると、パラメーターが長くなり、パラメーターの長さが最大データサイズの255文字を超えるとトリガー関数が壊れる可能性があります。

この問題を回避するには、アップグレード前に長いパラメーターを手動でユーザーマクロに移動することをお勧めします。

Zabbix 7.2.5以降、7.0より前のZabbixバージョンからのアップグレードでは、結果のパラメーターの長さに対する追加のチェックが追加されていることに注意してください。結果の長さが最大サイズを超える場合、そのようなパラメーターは**アップグレードされません**が、リストされているパラメーターを手動で修正するようにユーザーに求める警告がログに出力されます。

[エスケープ関連のアップグレードの問題](/manual/installation/known_issues/db_upgrade_escaping)も参照してください。

[comment]: # ({/7b8e63e3-a4d795de})

[comment]: # ({7628cd01-6214183d})
#### パッケージインストールのフロントエンドファイルディレクトリが変更されました

フロントエンドファイル ディレクトリは、/usr/share/zabbixから**/usr/share/zabbix/ui**に移動されました。

**注意**: アップグレード中に、Webサーバー設定ファイルにカスタム変更(通常はNginxによる)が含まれている場合、新しいパスを含む更新されたファイルで自動的に上書きされることはありません。古い設定ファイルをバックアップしてから、新しい設定ファイルで上書きする必要があります。たとえば、RedHatベースのシステムでは次のようになります:

    cp /etc/nginx/conf.d/zabbix.conf.rpmnew /etc/nginx/conf.d/zabbix.conf

その後、更新された設定ファイル(`/etc/nginx/conf.d/zabbix.conf`)を手動で編集して、古い設定を復元します。

[comment]: # ({/7628cd01-6214183d})

[comment]: # ({dbc852b8-3b19d74e})
#### リポジトリ構造

[Zabbixリポジトリ](https://repo.zabbix.com/)には、不安定なバージョンの`.../7.1/`や安定バージョンの`.../7.2/`ではなく、`.../7.2/stable/`(リリースバージョン)および`.../7.2/unstable/`(アルファ、ベータ、リリース候補バージョンのプレリリースパッケージ)フォルダーにZabbixパッケージファイルが含まれるようになりました。

安定リリースと不安定リリースの両方に使用できる*zabbix-release*パッケージは、`7.2/release`フォルダーに個別に提供されています。

7.2以降のバージョンでは、`non-supported`フォルダーのパッケージは`third-party`フォルダーに移動され、RHELとその派生ディストリビューション用にカスタマイズされたパッケージが含まれるようになりました。

新しいキー[B5333005](../../../assets/en/manual/installation/RPM-GPG-KEY-ZABBIX-B5333005)は、独自の専用キー[zabbix-tools](../../../assets/en/manual/installation/RPM-GPG-KEY-ZABBIX-TOOLS)を持つ[zabbix-tools](https://repo.zabbix.com/zabbix-tools/)リポジトリを除くすべての署名に使用されます。

[comment]: # ({/dbc852b8-3b19d74e})

[comment]: # ({842ebf0c-83630f75})
#### ロード可能なプラグイン実行可能ファイルの再配置

Zabbixエージェント2をパッケージからアップグレードすると、[ロード可能なプラグイン](/manual/extensions/plugins#loadable)実行可能ファイルが新しい場所、`/usr/sbin/zabbix-agent2-plugin`から`/usr/libexec/zabbix`(SLESの場合は`/usr/lib/zabbix`)へ移動されます。

アップグレード後、新しい場所を反映するために、以前に変更したプラグイン設定ファイルを更新する必要がある場合があります。
たとえば、[MSSQLプラグイン](/manual/appendix/config/zabbix_agent2_plugins/mssql_plugin)の`Plugins.MSSQL.System.Path`パラメーターを`/usr/libexec/zabbix/zabbix-agent2-plugin-mssql`に更新します。

[comment]: # ({/842ebf0c-83630f75})

[comment]: # ({2a0635ca-9f9104c8})
#### `auth` APIプロパティが削除されました

Zabbix 6.4以降で非推奨となった`auth` APIプロパティのサポートが削除されました。
代替API認証方法については、[Authentication](/manual/api#authentication)を参照してください。
その他のAPIの変更については、[付録2. 7.0から7.2での変更点](/manual/api/changes)を参照してください。

[comment]: # ({/2a0635ca-9f9104c8})

[comment]: # ({51abda0f-75aac093})
#### ポーラーが設定されていないアイテムはサポート対象外となる

アイテムが設定キャッシュに追加された際、およびアイテムタイプが変更された際に、ポーラーのチェックが追加されました。このチェックは、エージェント、SNMPエージェント、HTTPエージェント、ブラウザ、スクリプト、JMX監視、ODBC監視、およびIPMIアイテムに対して追加されました。

ポーラーが設定されていない場合、アイテムは単に無視されるのではなく、サポート対象外となります。この変更は、手動で実行された場合("Test item")またはスクリプト実行時のアイテムの動作には影響しません。

[comment]: # ({/51abda0f-75aac093})

[comment]: # ({d336b73c-57e1557d})
## その他

[comment]: # ({/d336b73c-57e1557d})

[comment]: # ({f986ad42-31553f4a})

#### 命名

[アイテムヒストリ](/manual/web_interface/frontend_sections/dashboards/widgets/item_history#configuration)ウィジェットを設定する場合:

- *列*パラメーターの名前が*アイテム*に変更されました。
- 選択アイテムリストの*データ*列の名前が*アイテム*に変更されました。

[comment]: # ({/f986ad42-31553f4a})

[comment]: # ({db5a25ae-ecda75c3})

#### データ概要ウィジェットが上位アイテムに移行

廃止された*データ概要*ウィジェットの機能を置き換える新しい[上位アイテム](/manual/web_interface/frontend_sections/dashboards/widgets/top_items)ウィジェットが追加されました。既存の*データ概要*ウィジェットは*上位アイテム*に移行されます。

*管理 -> 一般 -> GUI*で*概要テーブルの最大列数と最大行数*の値が100を超える値に設定されていた場合、ホスト/アイテム値レコードは100に制限されますのでご注意ください。

[comment]: # ({/db5a25ae-ecda75c3})

[comment]: # ({fa403f3b-d846b152})
#### ローレベルディスカバリ

ローレベルディスカバリのパフォーマンスが向上し、マスターアイテムあたり29999個の[依存アイテム](/manual/config/items/itemtypes/dependent_items#limitations)と3つの依存関係レベルという従来の制限が撤廃されました。

[comment]: # ({/fa403f3b-d846b152})