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

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

次のコマンドを実行して、すべてのインデックスとそのステータスを一覧表示します。

GET _cat/indices?v

health status index
green  open   .monitoring-es-6-2020.10.29
green  open   .monitoring-logstash-6-2020.10.31
green  open   filebeat-6.7.0-2020.10.31
green  open   .monitoring-kibana-6-2020.10.27
       close  test

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

POST test/_open

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

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

[バージョン] 行で、現在のインスタンスのバージョン (例: 7.10.0) を確認します。バージョン番号の後に [アップグレード可能なカーネルパッチあり] リンクが表示されている場合、カーネルパッチアップデートが利用可能です。

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

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

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

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

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