Elasticsearch：升級檢查

對於將5.x版本執行個體升級至6.x版本的情況，除了以上檢查外，您還需要再完成以下檢查：

• 將5.x版本中的多type索引拆分為單type索引。

  Elasticsearch從6.x版本開始，不再支援一個索引多個type。而升級後，在5.x版本中建立的多type索引，在6.x版本中依然可以正常寫入，但是在6.x版本中建立多type索引時會報錯。因此，建議在升級前，按照官方標準，將5.x版本中的多type索引拆分為單type索引後，再進行升級。

• 執行以下命令，檢查叢集中是否配置了跨叢集訪問。開啟時，您可以在返回結果中看到search.remote屬性的配置，且不為null。

  GET _cluster/settings

  如果配置了跨叢集訪問，需要執行以下指令碼，在升級前取消該項配置，待升級後重新設定。

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

  重要

  升級後重新設定跨叢集訪問時需要注意：Elasticsearch 5.x版本中使用的配置參數是search.remote，而6.x版本中使用的是cluster.remote。

在進行升級操作時，Elasticsearch會自動檢查叢集是否處於正常狀態，以及負載是否處於正常水位。只有當兩者都正常時，才可以對執行個體進行升級。您也可以在進行升級操作前，參考以下列表人工檢查叢集狀態，確保操作可以順利進行。

如果升級的目標版本為6.x，在進行升級操作時，Elasticsearch會自動檢查叢集不同版本之間是否存在不相容的配置。如果您使用了這些配置，升級後，叢集服務可能會受到影響。您也可以在進行升級操作前，使用GET _cluster/settings和GET*/_settings?flat_settings=true命令查看叢集中是否存在下表中的配置，確保升級操作可以順利進行。

如果相容性檢查不通過，您可以通過以下方式調整叢集：

• 叢集層級

  當以下配置不相容時，您可以取消對應配置進行調整。

  配置資訊	取消配置命令
  叢集快照設定（Snapshot settings）	PUT _cluster/settings { "persistent": { "cluster.routing.allocation.snapshot.relocation_enabled": null }, "transient": { "cluster.routing.allocation.snapshot.relocation_enabled": null } }
  叢集儲存限流設定（Store throttling settings）	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 } }

• 索引層級

  當以下配置不相容時，您可以取消對應配置進行調整。

  配置資訊	取消配置命令	相關說明
  索引相似性設定（Similarity settings）	PUT test_index/_settings { "index.similarity.base.*": null }	這些配置需要關閉索引後修改，關閉後，您將無法對索引進行讀寫操作。修改完成後，您可以再次開啟對應索引。以test_index索引為例，關閉和開啟索引的命令如下： 關閉索引 POST test_index/_close 開啟索引 POST test_index/_open
  索引陰影複製設定（Shadow Replicas settings）	PUT test_index/_settings { "index.shared_filesystem": null, "index.shadow_replicas": null }
  索引儲存設定（Index Store settings）	PUT test_index/_settings { "index.store.type": null }
  索引儲存限流設定（Index Store throttling settings）	PUT test_index/_settings { "settings": { "index.store.throttle.type": null, "index.store.throttle.max_bytes_per_sec": null } }	無

  說明

  對於已建立的包含索引Mapping參數include_in_all的索引，升級後可以相容，無需修複。

• 索引模板層級

  以下以test_template索引模板為例，介紹處理索引模板類型的檢查項未通過檢查的調整方法：

  1. 使用GET _template/test_template命令擷取不相容的模板test_template。

     根據以下結果發現test_template中存在的不相容配置包括：索引模板儲存設定（Index store settings）、索引模板Mapping元欄位_all和索引模板Mapping參數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": {}
     }