Oracle Cloud Infrastructureドキュメント

OpenSearchクラスタ・ソフトウェアのアップグレード

インライン・ソフトウェア・アップグレードでクラスタのソフトウェア・バージョンをアップグレードします。

次の方法を使用して、OpenSearchクラスタのソフトウェア・バージョンをアップグレードできます。

  • スナップショットと復元: 次の手順に従います。
    1. 現在のクラスタからスナップショットを作成します。手順については、「OpenSearchクラスタ・バックアップの作成」を参照してください。
    2. 必要なソフトウェア・バージョンの新規クラスタを作成します。
    3. 新しいクラスタでスナップショットを復元します、手順については、「新しいOpenSearchクラスタへのバックアップのリストア」を参照してください。
  • 直接アップグレード: クラスタ自体を必要なバージョンにアップグレードします。
  • クローンおよびアップグレード: クラスタのクローンを作成し、必要なバージョンにアップグレードします。

直接アップグレードおよびクローンおよびアップグレードの方法については、このトピックで後述します。

インライン・アップグレードに関する次の制限事項および考慮事項に注意してください。

  • インライン・アップグレード・プロセスの開始後は、プロセスを停止または取り消すことはできません。クラスタのバックアップを作成することをお薦めします。
  • クラスタは、新しいOpenSearchソフトウェア・バージョンにのみアップグレードでき、古いOpenSearchソフトウェア・バージョンにダウングレードすることはできません。
  • OpenSearchノードおよび索引は、以前のメジャー・バージョンとの下位互換性があります。

インライン・アップグレードでサポートされるアップグレード・パス

アップグレード前のバージョン アップグレード後のバージョン
1.2.4 2.3
2.3 2.11
2.11 2.15
2.15 2.18
2.18 2.19.1
2.19.1 3.2.0

コンソールの「クラスタ」リストにアクセスして、クラスタがソフトウェア・アップグレードに適格かどうかを確認します。アップグレードの対象となるクラスタには、「ソフトウェア・バージョン」列に「アップグレード」というテキストが含まれます。「クラスタ」リストにアクセスする手順は、OpenSearchクラスタのリストを参照してください。

    1. 「クラスタ」リスト・ページで、操作するOpenSearchクラスタを検索します。リスト・ページまたはクラスタの検索に関するヘルプが必要な場合は、OpenSearchクラスタのリストを参照してください。
    2. OpenSearchクラスタの「アクション」メニューから、「アップグレード」を選択します。
    3. 「アップグレード」パネルで、次のいずれかのオプションを選択します。
      • 現在のクラスタのアップグレード: このクラスタのバージョンをアップグレードします。メジャー・バージョンのアップグレードには停止時間がある可能性があります。
      • クローンを作成し、クローンにアップグレードを適用: この機能を使用して、テストを実行できるようにクローンにアップグレードを適用します。アップグレードに問題があるため、本番トラフィックのダウンタイムを回避するために、メジャー・アップグレードにこのオプションを選択することをお薦めします。
    4. 「使用可能なソフトウェア・バージョン」リストからソフトウェア・バージョンを選択します。現在のバージョンが最初に表示されます。
    5. 「アップグレード」を選択します。

  • クラスタのインライン(マイナー・ビルド・バージョン)アップグレードを実行するには、oci opensearch cluster upgradeコマンドおよび必須パラメータを使用します。is-cloneパラメータをfalseまたはtrueとして構成し、現在のクラスタをアップグレードするか、クラスタのクローンを作成するかを指定し、クローンにアップグレードを適用するかを指定します。

    次のコマンドを実行して、現在のクラスタをアップグレードします。

    oci opensearch cluster upgrade --opensearch-cluster-id cluster_ocid --desired-software-version desired_OpenSearch_version 
--original_cluster_display_name original_cluster_display_name --upgrade-type [MAJOR | MINOR] --is-clone false [OPTIONS]

    次のコマンドを実行してクローンを作成し、クローンにアップグレードを適用します:

    oci opensearch cluster upgrade --opensearch-cluster-id cluster_ocid --desired-software-version desired_OpenSearch_version 
--original_cluster_display_name original_cluster_display_name --upgrade-type [MAJOR | MINOR] --is-clone true [OPTIONS]

    クラスタIDの表示名が同じであることを検証するには、original_cluster_display_nameパラメータが必要です。

    upgrade-typeの値はMINORである必要があります。

    CLIコマンドのフラグおよび変数オプションの完全なリストは、コマンドライン・リファレンスを参照してください。

  • UpgradeOpenSearchCluster操作を実行して、クラスタのインライン・ソフトウェア・アップグレードを実行します。upgradeTypeをマイナーとして構成します。

メジャー・アップグレードの実行

クラスタのソフトウェア・バージョンをアップグレードするには、このトピックの前のステップに従います。「使用可能なソフトウェア・バージョン」リストからバージョン3.2.0以上を選択します。

ノート

RAGパイプラインを含む索引がクラスタに存在する場合、バージョン3.2.0へのアップグレードが失敗します。現在の回避策は、アップグレードにスナップショットおよびリストア・ルートを使用することです。ただし、RAGはアップグレードされた3.2.0クラスタで完全にサポートされています。

これらの両方の問題に対処するための作業が進行中です。

アーカイブ設定

OpenSearch 3.xバージョンでは、非推奨の設定を接頭辞archived.で名前変更しますアーカイブされたすべての設定は、アップグレード中に削除されます。非推奨設定のリストを次に示します。

  • thread_pool.test.max_queue_size
  • thread_pool.test.min_queue_size
  • index.store.hybrid.mmap.extensions
  • knn.plugin.enabled
  • index.knn.algo_param.ef_construction
  • index.knn.algo_param.m
  • index.knn.space_type
  • plugins.sql.delete.enabled
  • opendistro*
  • plugins.sql.pagination.api