升级 Amazon OpenSearch Service 域 - Amazon OpenSearch Service
支持的升级途径对验证失败进行故障排除排查升级问题
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

升级 Amazon OpenSearch Service 域

注意

服务软件更新不同于 OpenSearch 和 Elasticsearch 版本升级。有关为您的 OpenSearch Service 域更新服务软件的信息，请参阅 Amazon OpenSearch Service 中的服务软件更新。

Amazon OpenSearch Service 为运行 OpenSearch 1.0 或更高版本或 Elasticsearch 5.1 或更高版本的域提供了就地升级。如果您使用 Amazon Data Firehose 或 Amazon CloudWatch Logs 等服务将数据流式传输至 OpenSearch Service，请在迁移前检查这些服务是否支持较新版本的 OpenSearch。

支持的升级途径

当前，OpenSearch Service 支持以下升级路径。

之前版本 目标版本
OpenSearch 1.3 或 2.x

OpenSearch 3.1

如果运行的是 OpenSearch 1.3 或 2.x，在升级到 OpenSearch 3.1 之前，必须先升级到 OpenSearch 2.19。之后，当从 OpenSearch 2.19 升级到 OpenSearch 3.1 时，可能需要处理以下不兼容的索引设置。这些索引设置在 2.x 之前的版本中就已弃用，如果不移除，会导致升级检查验证失败。

  • index.knn.algo_param.ef_construction

  • index.knn.algo_param.m

  • index.knn.space_type

  • index.store.hybrid.mmap.extensions

有关已弃用的索引设置以及修复这些设置的步骤的更多信息，请参阅索引设置。有关 OpenSearch 3.1 重大变更的完整列表，请参阅 3.0.0。
OpenSearch 1.3 或 2.x

OpenSearch 2.x

如果域满足以下条件，OpenSearch 2.17 将默认启用在自动模式下运行的并发分段搜索功能：

  • 未明确设置任何之前的并发搜索设置。

  • 所有数据实例（热实例和温实例）的实例类型均为 2.xl 或更高版本。

  • 超过 1 周的数据实例（热实例和温实例）的平均 p90 CPU 利用率低于 45%。

    有关此处并发分段搜索设置的更多详细信息，请参阅并发分段搜索。

版本 2.3 具有以下重大更改：

  • 在版本 2.0 中，从所有 OpenSearch API 端点中移除了 type 参数。有关更多信息，请参阅 breaking changes（重大更改）。

  • 如果您的域包含最初在 Elasticsearch 6.8 中创建的任何索引（热索引、UltraWarm 索引或冷索引），则这些索引与 OpenSearch 2.3 不兼容。

    在升级到版本 2.3 之前，必须为不兼容的索引重新编制索引。对于不兼容的 UltraWarm 索引或冷索引，请将它们迁移到热存储，重新索引数据，然后再将它们迁移回暖存储或冷存储。或者，如果您不再需要索引，可以删除它们。

    如果您意外将域升级到版本 2.3，而没有先执行这些步骤，则无法将不兼容的索引从其当前存储层迁移出去。您唯一的选择是删除它们。
OpenSearch 1.x OpenSearch 1.x
Elasticsearch 7.x

Elasticsearch 7.x或 OpenSearch 1.x

重要

OpenSearch 1.x 引入了许多突破性的变更。有关更多信息，请参阅 Amazon OpenSearch Service 重命名：更改摘要。

Elasticsearch 6.8

Elasticsearch 7.x或 OpenSearch 1.x

重要

Elasticsearch 7.0 和 OpenSearch 1.0 包含许多突发性更改。启动就地升级之前，我们建议制作 6.x 域的手动快照并在测试 7.x 域或 OpenSearch 1.x 中还原，然后使用该测试域以识别潜在的升级问题。有关 OpenSearch 1.0 中的突破性变更，请参阅 Amazon OpenSearch Service 重命名：更改摘要。

与 Elasticsearch 6.x 相似，索引只能包含一种映射类型，但该类型现在必须名为 _doc。因此，特定 API 在请求正文中不再需要映射类型（例如 _bulk API）。

对于新索引，自托管 Elasticsearch 7.x 和 OpenSearch 1.x 具有默认分片计数 1。在 Elasticsearch 7.x上的 OpenSearch Service 域和更高版本后保留之前的原定设置值 5。

Elasticsearch 6.x

Elasticsearch 6.x
Elasticsearch 5.6

Elasticsearch 6.x

重要

在版本 6.x 中创建的索引不再支持多个映射类型。在版本 5.x 中创建的索引在还原到 6.x 集群后仍然支持多个映射类型。请检查您的代码是否仅为每个索引创建一个映射类型。

为了在从 Elasticsearch 5.6 到 6.x 的升级过程中最大程度地减少停机时间，OpenSearch Service 将 .kibana 索引重建为 .kibana-6，删除了 .kibana，创建了一个名为 .kibana 的别名，并将新索引映射到新别名。
Elasticsearch 5.x Elasticsearch 5.x

升级过程包括三个步骤：

  1. 升级前检查 – OpenSearch Service 检查可能阻碍升级的问题，除非这些检查成功，否则不会继续下一步。

  2. 快照 - OpenSearch Service 拍摄 OpenSearch 或 Elasticsearch 集群的快照，除非快照拍摄成功，否则不会继续下一步。如果升级失败，OpenSearch Service 将使用此快照将集群还原到其原始状态。有关更多信息，请参阅升级后无法降级。

  3. 升级 - OpenSearch Service 开始升级，这可能需要 15 分钟到几个小时才能完成。OpenSearch 控制面板可能在部分或全部升级中不可用。

对验证失败进行故障排除

启动 OpenSearch 或 Elasticsearch 版本升级时，OpenSearch Service 首先执行一系列验证检查，以确保您的域符合升级条件。如果其中任何一项检查失败，您将收到通知，其中包含在升级域之前必须修复的特定问题。有关潜在问题及其解决步骤的列表，请参阅 对验证错误进行故障排除。

排查升级问题

就地 升级需要正常运行的域。您的域可能不符合升级条件或出于各种原因无法升级。下表显示了最常见的问题。

问题 描述
不支持可选插件

当您使用可选插件升级域时，OpenSearch Service 也会自动升级插件。因此，您的域的目标版本还必须支持这些可选插件。如果域安装了目标版本不可用的可选插件，则升级请求将失败。
一个节点的分片过多 OpenSearch 和 Elasticsearch 7.x 版本的 的原定设置为每个节点不超过 1,000 个分片。如果当前集群中的节点超过了此设置，OpenSearch Service 不允许您升级。有关问题排查选项，请参阅超过最大分片限制。
域正在处理中 域正在接受配置更改。在操作完成后检查升级资格。
红色集群状态 集群中的一个或多个索引为红色。有关问题排查步骤，请参阅红色集群状态。
高错误率 在尝试处理请求时，集群返回大量 5xx 错误。此问题通常是因为同时读取或写入了过多的请求。请考虑减少流向集群的流量或扩展您的域。
裂脑 脑裂意味着您的集群有多个主节点并且已拆分成两个绝不会自行重新联接的集群。您可以通过使用推荐数量的专用主节点避免裂脑。为了帮助您从裂脑恢复，请联系 Amazon Web Services 支持。
找不到主节点 OpenSearch Service 无法找到集群的主节点。如果您的域使用了多 AZ，一个可用区故障可能已导致集群失去仲裁节点数且无法选择新的主节点。如果该问题无法自行解决，请联系 Amazon Web Services 支持。
待处理任务过多 主节点处于高负载状态，且具有很多待处理任务。请考虑减少流向集群的流量或扩展您的域。
存储卷受损 一个或多个节点的磁盘卷无法正常运行。此问题通常与其他问题一起发生，例如高错误率或待处理任务过多。如果它是独立发生的且无法自行解决，请联系 Amazon Web Services 支持。
KMS 密钥问题 用于加密域的 KMS 密钥无法访问或丢失。有关更多信息，请参阅 监控对静态数据进行加密的域。
快照拍摄正在进行中 域当前正在拍摄快照。在快照拍摄完成后检查升级资格。还要检查您是否可以列出手动快照存储库，在这些存储库中列出快照，并拍摄手动快照。如果 OpenSearch Service 无法检查快照拍摄是否正在进行中，升级可能会失败。
快照拍摄超时或失败 升级前快照拍摄所需的时间过长或失败。检查集群运行状况并重试。如果问题仍存在，请联系 Amazon Web Services 支持。
索引不兼容 一个或多个索引与目标版本不兼容。如果您从较旧版本的 OpenSearch 或 Elasticsearch 迁移索引，则可能出现此问题。重建索引并重试。
高磁盘使用率 集群的磁盘使用率高于 90%。删除数据或扩展域，然后重试。
高 JVM 使用率 JVM 内存压力高于 75%。减少流向集群的流量或扩展域，然后重试。
Open Ssearch 控制面板别名问题 .dashboards 已被配置为一个别名并映射到不兼容的索引，可能是来自早期版本的 OpenSearch 控制面板的索引。重建索引，然后重试。
红色控制面板状态 OpenSearch 控制面板状态为红色。尝试在升级完成时使用控制面板。如果红色状态仍然存在，请手动解决该问题，然后重试。
跨集群兼容性

仅当升级之后源域与目标域之间保持跨集群兼容性时，才能升级。在升级过程中，会识别任何不兼容的连接。要继续，请删除远程域或删除不兼容的连接。请注意，如果域上的复制处于活动状态，则在删除连接后无法恢复复制。
其他 OpenSearch Service 服务问题 OpenSearch Service 本身的问题可能会导致您的域显示没有升级资格。如果上述情况都不适用于您的域且该问题持续超过一天，请联系 Amazon Web Services 支持。