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

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

アップグレード方法

OpenSearchクラスタを新しいソフトウェア・バージョンにアップグレードして、新しい機能にアクセスできます。OpenSearchは複数の同時バージョンをサポートしているため、最新の拡張機能を使用してOpenSearchクラスタを最新の状態に保つことができます。このトピックでは、アップグレード方法、考慮事項およびサポートされているアップグレード・パスについて説明します。

次のいずれかの方法を選択して、OpenSearchクラスタをアップグレードします:

  • クローンおよびアップグレード: (推奨) OpenSearchクラスタのクローンを作成し、クローン・クラスタを必要なバージョンにアップグレードします。このアプローチを使用して、リスクと停止時間を最小限に抑え、本番トラフィックを新しいクラスタに切り替える前にアップグレードをテストします。
  • 直接アップグレード: 既存のOpenSearchクラスタを必要なバージョンにアップグレードします。この方法は、短い停止時間を許容できる小規模または非クリティカルなクラスタに使用します。このオプションは、インプレース・アップグレードとも呼ばれます。
  • スナップショットおよびリストア: この方法は、特にアップグレード中にインスタンス・タイプ、リージョン、アーキテクチャなどの構成を変更する必要がある場合に、新しいOpenSearchクラスタ・バージョンへのクリーンな移行に使用します。このアップグレード方法を使用するには、次の手順に従います。
    1. 現在のOpenSearchクラスタのスナップショットを作成します。手順については、Creating a Cluster Backupを参照してください。
    2. 必要なソフトウェア・バージョンで新しいOpenSearchクラスタを作成します。
    3. 新しいOpenSearchクラスタでスナップショットをリストアします。手順については、Restoring a Backup from a Clusterを参照してください。

アップグレードに関する制限事項および考慮事項

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

  • 直接アップグレードを開始した後は、プロセスを停止または取り消すことはできません。アップグレードを開始する前に、バックアップを作成することをお薦めします。
  • 新しいOpenSearchソフトウェア・バージョンにのみアップグレードできます。古いバージョンにダウングレードすることはできません。
  • クラスタ内のいずれかの索引でRAGパイプラインが使用されている場合、バージョン3.2.0への直接アップグレードは失敗します。スナップショットおよびリストア方法を回避策として使用してください。RAGは、OpenSearchバージョン3.2.0で完全にサポートされています。

ソフトウェア・アップグレード・パス

OpenSearchクラスタを新しいバージョンにアップグレードできますが、メジャー・バージョンは一度に1つのみです。推奨されるアップグレード・パスの概要を次の表に示します。

現行バージョン アップグレード済バージョン
1.x 2.19.1
2.x 2.19.1
2.19.1 3.2.0
ノート

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

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

ソフトウェアのアップグレード

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

    現在のクラスタのアップグレード

    現在のクラスタをアップグレードするには、is-cloneパラメータをfalseに設定します。

    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]

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

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

    クラスタのクローニングとアップグレードの適用

    クラスタのクローンを作成し、アップグレードをクローンに適用するには、is-cloneパラメータを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 true [OPTIONS]
  • UpgradeOpenSearchCluster操作を実行して、クラスタのインライン(マイナー・ビルド・バージョン)アップグレードを実行します。

    現在のクラスタのアップグレード

    .isClone()パラメータをfalseに設定します。次に例を示します。

    .isClone(false)

    クラスタのクローニングとアップグレードの適用

    .isClone()パラメータをtrueに設定します。次に例を示します。

    .isClone(true)

OpenSearchの変更

アップグレードや非推奨を含む、バージョン3.xに関連付けられたOpenSearchの非推奨の詳細は、次のOpenSearchサイトを参照してください。

https://docs.opensearch.org/latest/breaking-changes/#300

他のOpenSearchバージョンに関する情報もサイトに表示されます。

アーカイブ設定

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