检索分析服务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": {}
     }