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