Elasticsearch:アップグレードチェック

クローズされたインデックスのチェック

すべてのインデックスとそのステータスをリストするには、次のコマンドを実行します。

GET _cat/indices?v

出力には、各インデックスが status 列にそのステータスとともにリストされます。いずれかのインデックスが close ステータスを示している場合は、アップグレード前に開いてください。

POST test/_open

カーネルバージョンの可用性のチェック

スペックアップの一環としてクラスターのカーネルを更新する予定がある場合は、クラスターの[基本情報]ページで、より新しいカーネルバージョンが利用可能であることを確認してください。

カーネルは、より新しいバージョンがリストされている場合にのみ更新できます。

クライアントの互換性のチェック

クライアントがクラスターに接続する場合は、そのバージョンがターゲットクラスターバージョンと互換性があることを確認してください。バージョンの互換性の詳細については、「Compatibility」をご参照ください。バージョンが互換性がない場合は、続行する前にクライアントをアップグレードしてください。

マルチタイプインデックスの分割

V6.X 以降はマルチタイプインデックスをサポートしていません。クラスターにマルチタイプインデックスがある場合、アップグレード後もそれらのインデックスへの書き込みは機能しますが、V6.X で新しいマルチタイプインデックスを作成するとエラーが発生します。アップグレード前に、各マルチタイプインデックスをシングルタイプインデックスに分割してください。

クラスター間検索の無効化

クラスター間検索が有効になっているかどうかを確認するには、次のコマンドを実行します。

GET _cluster/settings

結果に search.remote が null 以外の値で表示される場合、クラスター間検索が有効になっています。アップグレード前に無効にしてください。

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

アップグレード後、クラスター間検索を再度有効にすることができます。

クラスターレベルの構成

クラスターレベルの互換性のない構成は、その値を null に設定することで無効にしてください。

スナップショット設定:

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
  }
}

インデックスレベルの構成

インデックスレベルの互換性のない構成は、その値を null に設定することで無効にしてください。test_index をご利用のインデックス名に置き換えてください。

類似性設定では、最初にインデックスをクローズする必要があります。クローズされたインデックスは読み取りまたは書き込みができません。変更を加えた後、インデックスを再度開いてください。

インデックスをクローズします。

POST test_index/_close

設定を更新します。

PUT test_index/_settings
{
  "index.similarity.base.*": null
}

インデックスを開きます。

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
  }
}

インデックステンプレートレベルの構成

以下の例は、test_template という名前のインデックステンプレート内の互換性のない構成を修正する方法を示しています。

1. 現在のテンプレートを取得します。

   GET _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": {}
   }