升級 Amazon OpenSearch Service 網域 - Amazon OpenSearch Service
支援的升級路徑對驗證失敗進行故障排除升級疑難排解

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

升級 Amazon OpenSearch Service 網域

注意

OpenSearch 和 Elasticsearch 版本升級與服務軟體更新不同。如需更新 OpenSearch 服務網域的服務軟體的資訊，請參閱 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 2.x

2.3 版具有以下突破性變更：

  • OpenSearch 2.17 將預設使用自動模式啟用並行區段搜尋；前提是網域滿足以下條件：

    • 不會明確設定先前的並行搜尋設定。

    • 所有資料執行個體 （熱和暖） 都屬於執行個體類型 2.xl 或更高。

    • 資料執行個體 （熱和暖） 超過 1 週的平均 p90 cpu 使用率低於 45%。

      如需此處並行區段搜尋設定的詳細資訊，請參閱並行區段搜尋 。

  • 參數type已從 2.0 版的所有 OpenSearch API端點移除。如需詳細資訊，請參閱 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。因此，某些 APIs 不再需要請求內文中的映射類型 （例如 _bulk API）。

對於新索引，自我託管的 Elasticsearch 7.x 和 OpenSearch 1.x 預設碎片計數為 1。Elasticsearch 7.x 和更新版本上的 OpenSearch 服務網域保留先前的預設值為 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 服務檢查是否有可能封鎖升級的問題，除非這些檢查成功，否則不會繼續進行下一個步驟。

  2. 快照 – OpenSearch 服務會擷取 OpenSearch 或 Elasticsearch 叢集的快照，除非快照成功，否則不會繼續進行下一個步驟。如果升級失敗， OpenSearch Service 會使用此快照將叢集還原為其原始狀態。如需詳細資訊，請參閱 升級後無法降級。

  3. 升級 – OpenSearch 服務會啟動升級，這可能需要 15 分鐘到幾個小時才能完成。在部分或全部升級期間 OpenSearch ，儀表板可能無法使用。

對驗證失敗進行故障排除

當您啟動 OpenSearch 或 Elasticsearch 版本升級時， OpenSearch Service 會先執行一系列驗證檢查，以確保您的網域符合升級資格。如果其中任何一項檢查失敗，您會收到通知，其中包含您必須在更新網域之前解決的特定問題。如需潛在問題的清單以及解決問題的步驟，請參閱 對驗證錯誤進行疑難排解。

升級疑難排解

就地 ​ 升級需要運作狀態良好的網域。您的網域可能不符合升級的資格，或因各種原因而無法升級。下表顯示最常見的問題。

問題 描述
不支援選用外掛程式

當您使用選用外掛程式升級網域時， OpenSearch Service 也會自動升級外掛程式。因此，您網域的目標版本也必須支援這些選用的外掛程式。如果網域已安裝不適用於目標版本的選用外掛程式，則升級請求會失敗。
每個節點有太多碎片 OpenSearch以及 Elasticsearch 的 7.x 版本，每個節點的預設設定不超過 1，000 個碎片。如果目前叢集中的節點超過此設定， OpenSearch Service 不允許您升級。如需疑難排解選項，請參閱超出最大碎片限制。
處理中的網域 組態變更中的網域 在操作完成後檢查升級資格。
紅色叢集狀態 叢集中一或多個索引是紅色的。如需疑難排解步驟，請參閱紅色叢集狀態。
高錯誤率 在嘗試處理請求時，叢集傳回大量的 5xx 錯誤。此問題通常是因為太多同時讀寫請求造成。請考慮降低叢集流量或擴展網域。
分割大腦 分割大腦表示叢集有不只一個主節點，且已分為兩個叢集，這兩個叢集將不會自行重新連結。您也可以使用建議數量的專用主節點來避免大腦分割。如需從大腦分割中恢復的協助，請聯絡 AWS Support。
找不到主節點 OpenSearch 服務找不到叢集的主節點。如果您的網域使用的是多個可用區，則可用區域故障可能會導致叢集遺失仲裁，且無法選擇新的主節點。如果問題無法自主解決，請聯絡AWS Support。
待處理任務過多 主節點負載太重且待處理任務過多。請考慮降低叢集流量或擴展網域。
儲存磁碟區受損 一或多個節點的磁碟區無法正常運作。此問題通常與其他問題 (例如高錯誤率或待處理任務過多) 一起發生。如果此問題單獨發生且無法自主解決，請聯絡AWS Support。
KMS 金鑰問題 用於加密網域的KMS金鑰無法存取或遺失。如需詳細資訊，請參閱監控靜態加密資料的網域。
快照處理中 網域正在拍攝快照。在快照完成後檢查升級資格。也確認您是否列出手動快照儲存庫、列出這些儲存庫中的快照與手動拍攝快照。如果 OpenSearch Service 無法檢查快照是否正在進行中，升級可能會失敗。
快照逾時或故障 預先升級快照耗時太久，無法完成或失敗。請檢查叢集的運作狀態並再試一次。如果問題仍存在，請聯絡 AWS Support。
索引不相容 一或多個索引與目標版本不相容。如果您從舊版的 OpenSearch 或 Elasticsearch 遷移索引，可能會發生此問題。重新編製索引，然後重試。
高磁碟使用量 叢集的磁碟使用量超過 90%。篩除資料或擴展網域，然後重試。
高JVM用量 JVM 記憶體壓力高於 75%。降低叢集的流量或擴展網域，然後重試。
OpenSearch 儀表板別名問題 .dashboards 已設定為別名，並映射至不相容的索引，可能是來自舊版 OpenSearch 儀表板的索引。重新索引，然後再試一次。
紅色 Dashboards 狀態 OpenSearch 儀表板狀態為紅色。在升級完成時嘗試使用 Dashboards。如果紅色狀態仍持續，手動解決它，然後重試。
跨叢集相容性

只有在可維持升級後來源和目的地網域之間的跨叢集相容性的情況下，才能進行升級。在升級程序期間，系統會識別任何不相容的連線。若要繼續進行，請升級遠端網域或刪除不相容的連線。請注意，如果複寫在網域上處於啟用狀態，一旦刪除連線，就無法繼續複寫。
OpenSearch 其他服務問題 OpenSearch 服務本身的問題可能會導致您的網域顯示為不符合升級的資格。如果上述問題都不適用於您的網域，且問題持續超過一天，請聯絡AWS Support。