Elasticsearch:バージョンアップグレード前のチェックの実行

クラスターのバージョンを V5.X から V6.X にアップグレードする場合は、次の操作も実行する必要があります。

• V5.X クラスターに格納されている各マルチタイプインデックスを複数のシングタイプインデックスに分割します。

  V6.X 以降のクラスターは、マルチタイプインデックスをサポートしていません。 V5.X クラスターがマルチタイプインデックスを格納している場合、クラスターバージョンが V6.X にアップグレードされた後、インデックスにデータを書き込むことができます。ただし、V6.X でマルチタイプインデックスを作成すると、エラーが報告されます。アップグレード前に、各マルチタイプインデックスをシングタイプインデックスに分割することをお勧めします。

• 次のコマンドを実行して、クラスターでクロス クラスター検索機能が有効になっているかどうかを確認します。この機能がクラスターで有効になっている場合、search.remote パラメーターが戻り結果に表示され、このパラメーターの値は null ではありません。

  GET _cluster/settings

  この機能がクラスターで有効になっている場合は、次のコマンドを実行してこの機能を無効にします。クラスターのバージョンをアップグレードした後、この機能を再度有効にすることができます。

  PUT _cluster/settings
  {
    "persistent": {
      "search.remote.*": null
    },
    "transient": {
      "search.remote.*": null
    }
  }

  重要

  search.remote パラメーターは V5.X でクロス クラスター検索機能を構成するために使用されますが、cluster.remote パラメーターは V6.X で使用されます。

クラスターのバージョンをアップグレードする場合は、[事前チェック] をクリックして、システムがクラスターの状態とクラスターの負荷が正常かどうかを確認できるようにする必要があります。クラスターのバージョンは、クラスターが正常な状態であり、負荷が正常な場合にのみアップグレードできます。クラスターのバージョンをアップグレードする前に、次の表にリストされている項目を参照して手動チェックを実行することもできます。

クラスターのバージョンを V6.X にアップグレードすると、システムはバージョン間に互換性のない構成が存在するかどうかを自動的にチェックします。互換性のない構成を変更しないと、アップグレード後にクラスター サービスに影響を与える可能性があります。クラスターバージョンをアップグレードできることを確認するために、アップグレードを実行する前に GET _cluster/settings コマンドと GET*/_settings?flat_settings=true コマンドを実行して、次の表にリストされている構成がクラスターに構成されているかどうかを確認できます。

このセクションでは、互換性のない構成を変更するために使用される方法について説明します。

• クラスターレベルの互換性のない構成

  クラスターレベルの互換性のない構成の場合は、構成を無効にすることができます。

  構成カテゴリ	構成を無効にするコマンド
  スナップショット設定	PUT _cluster/settings { "persistent": { "cluster.routing.allocation.snapshot.relocation_enabled": null }, "transient": { "cluster.routing.allocation.snapshot.relocation_enabled": null } }
  ストレージ スロットリング設定	PUT _cluster/settings { "persistent": { "indices.store.throttle.type": null, "indices.store.throttle.max_bytes_per_sec": null }, "transient": { "indices.store.throttle.type": null, "indices.store.throttle.max_bytes_per_sec": null } }

• インデックスレベルの互換性のない構成

  インデックスレベルの互換性のない構成の場合は、構成を無効にすることができます。

  構成カテゴリ	構成を無効にするコマンド	追加情報
  類似度設定	PUT test_index/_settings { "index.similarity.base.*": null }	これらの構成は、インデックスが閉じられた後にのみ変更できます。閉じられたインデックスからデータを読み込んだり、書き込んだりすることはできません。変更後、インデックスを開くことができます。次の例は、test_index インデックスを開いたり閉じたりする方法を示しています。 インデックスを閉じる POST test_index/_close インデックスを開く POST test_index/_open
  シャドウ レプリカ設定	PUT test_index/_settings { "index.shared_filesystem": null, "index.shadow_replicas": null }
  インデックス ストレージ設定	PUT test_index/_settings { "index.store.type": null }
  ストレージ スロットリング設定	PUT test_index/_settings { "settings": { "index.store.throttle.type": null, "index.store.throttle.max_bytes_per_sec": null } }	なし。

  説明

  include_in_all パラメーターが構成されているインデックスは、新しいバージョンでも引き続き使用できます。このパラメーターを変更する必要はありません。

• インデックステンプレートレベルの互換性のない構成

  次の例は、test_template インデックステンプレートの構成を変更する方法を示しています。

  1. GET _template/test_template コマンドを実行して、test_template インデックステンプレートをクエリします。

     クエリ結果には、インデックステンプレートに次の互換性のない構成が含まれていることが示されています。インデックス ストレージ設定、_all、および include_in_all。

     {
      "test_template": {
        "order": 0,
        "template": "test_*",
        "settings": {
          "index": {
            "store": {
              "throttle": {
                "max_bytes_per_sec": "100m"
              }
            }
          }
        },
        "mappings": {
          "test_type": {
            "_all": {
              "enabled": true
            },
            "properties": {
              "test_field": {
                "type": "text",
                "include_in_all": true
              }
            }
          }
        },
        "aliases": {}
      }
     }

  2. 次のコマンドを実行して、互換性のない構成を削除し、インデックステンプレートを更新します。

     PUT _template/test_template
     {
        "order": 0,
        "template": "test_*",
        "settings": {
        },
        "mappings": {
          "test_type": {
            "properties": {
              "test_field": {
                "type": "text"
              }
            }
          }
        },
        "aliases": {}
     }