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

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

升級 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 3.x

OpenSearch 3.3

OpenSearch 3.3 維持與 OpenSearch 3.1 的完整相容性，這些版本之間沒有重大變更。如果您是從 3.1 之前的 OpenSearch 版本或從 Elasticsearch 升級，請遵循 OpenSearch 3.1 中記錄的升級程序，這也適用於 OpenSearch 3.3。

在升級至 OpenSearch 3.3 之前重新索引不相容的索引。

如果您的網域包含 OpenSearch 1.3、Elasticsearch 7.10 或舊版中建立的索引，您必須先重新建立索引，才能升級至 3.3 版。OpenSearch 3.x 不支援這些較舊的索引，無論它們是處於熱儲存、UltraWarm 儲存還是冷儲存中。若要重新索引不相容的 UltraWarm 或冷索引：

  1. 將索引遷移至熱儲存。

  2. 重新索引資料。

  3. 將索引遷移回暖儲存或冷儲存。

或者，如果您不再需要索引，請刪除索引。
OpenSearch 1.3 或 2.x

OpenSearch 3.1

如果您正在執行 OpenSearch 1.3 或 2.x，您必須先升級至 OpenSearch 2.19，才能升級至 OpenSearch 3.1。之後，當您從 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 版中，type 參數已從所有 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。因此，特定 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 Dashboards 在升級的部分或所有期間可能會無法使用。

對驗證失敗進行故障排除

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

升級疑難排解

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

問題 Description
不支援選用外掛程式

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

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