Oracle Cloud Infrastructureドキュメント

OpenSearchクラスタ・ソフトウェアを使用した検索のアップグレード

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

OpenSearchを使用した検索では、複数の同時バージョンのOpenSearchがサポートされます。古いバージョンを使用している既存のクラスタの場合、クラスタをアップグレードして、最新バージョンのOpenSearchで使用可能な機能を使用できます。

アップグレード・プロセスは、メジャー・バージョン・アップグレードを実行しているかマイナー・バージョン・アップグレードを実行しているかによって異なります。メジャー・バージョン・アップグレードは、ビルド番号の最初の番号(2.19.1から3.2.0など)の変更によって示されます。マイナー・バージョン・アップグレードは、ビルド番号の2番目の番号(2.11.0から2.15.0など)の変更によって示されます。

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

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

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

ノート

インライン・アップグレードに関する次の制限および考慮事項を検討してください:
  • インライン・アップグレード・プロセスの開始後は、プロセスを停止または取り消すことはできません。クラスタのバックアップを作成することをお薦めします。
  • クラスタは、新しいOpenSearchソフトウェア・バージョンにのみアップグレードでき、古いOpenSearchソフトウェア・バージョンにダウングレードすることはできません。
  • RAGパイプラインを含む索引がクラスタに存在する場合、バージョン3.2.0へのアップグレードが失敗します。現在の回避策は、アップグレードにスナップショットおよびリストア・ルートを使用することです。ただし、RAGは、アップグレードされた3.2.0クラスタで完全にサポートされています。これらの両方の問題に対処するための作業が進行中です。

推奨されるアップグレード・パス

アップグレード前のバージョン アップグレード後のバージョン
1.2.4 2.11.0
2.3.0 2.11.0
2.11.0 2.15.0
2.15.0 2.18.0
2.18.0 2.19.1
2.19.1 3.2.0
ノート

バージョン1.2.4および2.3.0は非推奨であるため、両方をバージョン2.11.0に直接アップグレードできます。詳細は、「サポートされているバージョンOpenSearchで検索」を参照してください。

コンソールで「Clusters」リストにアクセスして、クラスタがソフトウェアアップグレードに適格かどうかを確認します。アップグレード可能なクラスタには、「ソフトウェア・バージョン」列に「アップグレード」というテキストが含まれます。「クラスタ」リストにアクセスする手順は、「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パラメータが必要です。

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

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

アーカイブ設定

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