本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
升級 Amazon OpenSearch 服務域
注意
OpenSearch 和彈性搜尋版本升級與服務軟體更新不同。如需更新 Service 網域之服務軟體的 OpenSearch 資訊,請參閱Amazon 服務中的服 OpenSearch 務軟件更新。
Amazon OpenSearch 服務為執行 OpenSearch 1.0 或更新版本的網域或彈性搜尋 5.1 或更新版本的網域提供就地升級。如果您使用 Amazon Data Firehose 或 Amazon CloudWatch 日誌等服務將資料串流至 OpenSearch 服務,請 OpenSearch 在遷移之前檢查這些服務是否支援較新版本的。
支援的升級路徑
目前, OpenSearch 服務支援下列升級路徑:
原始版本 | 目標版本 |
---|---|
OpenSearch 一點三或二. x |
OpenSearch 2. x 2.3 版具有以下突破性變更:
|
OpenSearch 1. x | OpenSearch 1. x |
Elasticsearch 7.x |
彈性搜索 7. x 或 OpenSearch 1. x 重要OpenSearch 1. x 引入了許多突破性變化。如需詳細資訊,請參閱 Amazon OpenSearch Service 重新命名:變更摘要。 |
Elasticsearch 6.8 |
彈性搜索 7. x 或 OpenSearch 1. x 重要彈性搜索 7.0 和 OpenSearch 1.0 包括許多突破性更改。在啟動就地升級之前,建議您先擷取 6 的手動快照。 x 域,在測試 7 上恢復它。 x 或 OpenSearch 1. x 網域,並使用該測試網域來識別潛在的升級問題。如需中斷 OpenSearch 1.0 中的變更,請參閱Amazon OpenSearch Service 重新命名:變更摘要。 如同 Elasticsearch 6.x,索引只能包含一個映射類型,但該類型現在必須名為 對於新索引,自託管彈性搜索 7. x 和 OpenSearch 1. x 的預設碎片計數為 1。 OpenSearch 彈性搜索上的服務域 7. x 及更新版本保留先前的預設值 5。 |
Elasticsearch 6.x |
Elasticsearch 6.x |
Elasticsearch 5.6 |
Elasticsearch 6.x 重要在 6.x 版建立的索引不再支援多個映射類型。在 5.x 版中建立的索引,在恢復為 6.x 叢集時仍支援多個映射類型。請檢查您的用戶端程式碼是否每個索引只建立單一映射類型。 最大限度地減少從彈性搜索 5.6 升級到 6 期間的停機時間。 x, OpenSearch Service 會將索引重新編製索引 |
Elasticsearch 5.x | Elasticsearch 5.x |
升級程序包含三個步驟:
-
升級前檢查 — OpenSearch 服務會檢查是否有可能阻止升級的問題,除非這些檢查成功,否則不會繼續進行下一個步驟。
-
快照 — OpenSearch 服務會擷取 OpenSearch 或 Elasticsearch 叢集的快照,除非快照成功,否則不會繼續執行下一個步驟。如果升級失敗, OpenSearch Service 會使用此快照將叢集還原至其原始狀態。如需更多資訊,請參閱 升級後無法降級。
-
升級 — OpenSearch 服務開始升級,可能需要 15 分鐘到數小時才能完成。 OpenSearch 在部分或全部升級期間,儀表板可能無法使用。
開始升級 (主控台)
升級程序無法復原,且無法暫停或取消。升級時,您無法對網域做出組態變更。開始升級前,重複確認您是否要繼續。您可以使用這些相同的步驟,來執行預先升級的檢查,而不用實際開始升級。
如果叢集具有專用的主節點,則 OpenSearch 升級完成而不會停機。否則叢集在選擇主節點時,可能會在升級後數秒沒有回應。
若要將網域升級至較新版本的 OpenSearch 或彈性搜尋
-
建立您網域的手動快照。此快照可做為備份,如果您想要返回使用舊 OpenSearch 版,您可以在新網域上還原該備份。
-
前往 https://aws.amazon.com
並選擇 Sign In to the Console (登入主控台)。 -
在分析下,選擇 Amazon OpenSearch 服務。
-
在導覽窗格中,於 Domains (網域) 下,選擇您想要升級的網域。
-
選擇 Actions (動作) 和 Upgrade (升級)。
-
選取要升級到的版本。如果您要升級至某個 OpenSearch 版本,則會出現「啟用相容模式」選項。如果啟用此設定,請將其版本 OpenSearch 報告為 7.10,以允許 Elasticsearch OSS 用戶端和外掛程式 (例如 Logstash) 繼續使用 Amazon 服務。 OpenSearch 您可以稍後停用此設定
-
選擇 Upgrade (升級)。
-
請檢查網域儀表板上的 Status (狀態) 來監控升級狀態。
開始升級 (CLI)
您可以使用下列作業來識別網域的正確版本 OpenSearch 或 Elasticsearch、啟動就地升級、執行升級前檢查,以及檢視進度:
-
get-compatible-versions
(GetCompatibleVersions
) -
upgrade-domain
(UpgradeDomain
) -
get-upgrade-status
(GetUpgradeStatus
) -
get-upgrade-history
(GetUpgradeHistory
)
如需詳細資訊,請參閱 AWS CLI 命令參考
開始升級 (SDK)
此範例使用中的OpenSearchService
import boto3 from botocore.config import Config import time # Build the client using the default credential configuration. # You can use the CLI and run 'aws configure' to set access key, secret # key, and default Region. DOMAIN_NAME = '' # The name of the domain to upgrade TARGET_VERSION = '' # The version you want to upgrade the domain to. For example, OpenSearch_1.1 my_config = Config( # Optionally lets you specify a Region other than your default. region_name='us-east-1' ) client = boto3.client('opensearch', config=my_config) def check_versions(): """Determine whether domain is eligible for upgrade""" response = client.get_compatible_versions( DomainName=DOMAIN_NAME ) compatible_versions = response['CompatibleVersions'] for i in range(len(compatible_versions)): if TARGET_VERSION in compatible_versions[i]["TargetVersions"]: print('Domain is eligible for upgrade to ' + TARGET_VERSION) upgrade_domain() print(response) else: print('Domain not eligible for upgrade to ' + TARGET_VERSION) def upgrade_domain(): """Upgrades the domain""" response = client.upgrade_domain( DomainName=DOMAIN_NAME, TargetVersion=TARGET_VERSION ) print('Upgrading domain to ' + TARGET_VERSION + '...' + response) time.sleep(5) wait_for_upgrade() def wait_for_upgrade(): """Get the status of the upgrade""" response = client.get_upgrade_status( DomainName=DOMAIN_NAME ) if (response['UpgradeStep']) == 'UPGRADE' and (response['StepStatus']) == 'SUCCEEDED': print('Domain successfully upgraded to ' + TARGET_VERSION) elif (response['StepStatus']) == 'FAILED': print('Upgrade failed. Please try again.') elif (response['StepStatus']) == 'SUCCEEDED_WITH_ISSUES': print('Upgrade succeeded with issues') elif (response['StepStatus']) == 'IN_PROGRESS': time.sleep(30) wait_for_upgrade() def main(): check_versions() if __name__ == "__main__": main()
對驗證失敗進行故障排除
當您啟動 OpenSearch 或 Elasticsearch 版本升級時, OpenSearch 服務會先執行一系列驗證檢查,以確保您的網域符合升級資格。如果其中任何一項檢查失敗,您會收到通知,其中包含您必須在更新網域之前解決的特定問題。如需潛在問題的清單以及解決問題的步驟,請參閱 對驗證錯誤進行疑難排解。
升級疑難排解
就地 升級需要運作狀態良好的網域。您的網域可能不符合升級的資格,或因各種原因而無法升級。下表顯示最常見的問題。
問題 | 描述 |
---|---|
不支持可選插件 |
當您使用可選外掛程式升級網域時, OpenSearch Service 也會自動升級外掛程式。因此,您網域的目標版本也必須支援這些選用的外掛程式。如果網域安裝的選用外掛程式不適用於目標版本,則升級要求會失敗。 |
每個節點有太多碎片 | OpenSearch,以及 7. x 個版本的彈性搜索,每個節點的碎片不超過 1,000 個的默認設置。如果目前叢集中的節點超過此設定, OpenSearch Service 將不允許您升級。如需疑難排解選項,請參閱超出最大碎片限制。 |
處理中的網域 | 組態變更中的網域 在操作完成後檢查升級資格。 |
紅色叢集狀態 | 叢集中一或多個索引是紅色的。如需疑難排解步驟,請參閱紅色叢集狀態。 |
高錯誤率 | 在嘗試處理請求時,叢集傳回大量的 5xx 錯誤。此問題通常是因為太多同時讀寫請求造成。請考慮降低叢集流量或擴展網域。 |
分割大腦 | 分割大腦表示叢集有不只一個主節點,且已分為兩個叢集,這兩個叢集將不會自行重新連結。您也可以使用建議數量的專用主節點來避免大腦分割。如需從大腦分割中恢復的協助,請聯絡 AWS Support |
找不到主節點 | OpenSearch 服務找不到叢集的主節點。如果您的網域使用的是多個可用區,則可用區域故障可能會導致叢集遺失仲裁,且無法選擇新的主節點。如果問題無法自主解決,請聯絡AWS Support |
待處理任務過多 | 主節點負載太重且待處理任務過多。請考慮降低叢集流量或擴展網域。 |
儲存磁碟區受損 | 一或多個節點的磁碟區無法正常運作。此問題通常與其他問題 (例如高錯誤率或待處理任務過多) 一起發生。如果此問題單獨發生且無法自主解決,請聯絡AWS Support |
KMS 金鑰問題 | 用於加密網域的 KMS 金鑰無法存取或遺失。如需詳細資訊,請參閱 監控靜態加密資料的網域。 |
快照處理中 | 網域正在拍攝快照。在快照完成後檢查升級資格。也確認您是否列出手動快照儲存庫、列出這些儲存庫中的快照與手動拍攝快照。如果 OpenSearch 服務無法檢查快照是否正在進行中,升級可能會失敗。 |
快照逾時或故障 | 預先升級快照耗時太久,無法完成或失敗。請檢查叢集的運作狀態並再試一次。如果問題仍存在,請聯絡 AWS Support |
索引不相容 | 一或多個索引與目標版本不相容。如果您從舊版 OpenSearch 或彈性搜尋移轉索引,就可能會發生這個問題。重新編製索引,然後重試。 |
高磁碟使用量 | 叢集的磁碟使用量超過 90%。篩除資料或擴展網域,然後重試。 |
高 JVM 用量 | JVM 記憶體壓力超過 75%。 降低叢集的流量或擴展網域,然後重試。 |
OpenSearch 儀表板別名問題 | .dashboards 已設定為別名,並對映至不相容的索引,可能是來自舊版 OpenSearch 儀表板的索引。重新建立索引並再試一次。 |
紅色 Dashboards 狀態 | OpenSearch 儀表板狀態為紅色。在升級完成時嘗試使用 Dashboards。如果紅色狀態仍持續,手動解決它,然後重試。 |
跨叢集相容性 |
只有在可維持升級後來源和目的地網域之間的跨叢集相容性的情況下,才能進行升級。在升級程序期間,系統會識別任何不相容的連線。若要繼續進行,請升級遠端網域或刪除不相容的連線。請注意,如果複寫在網域上處於啟用狀態,一旦刪除連線,就無法繼續複寫。 |
其他 OpenSearch 服務服務問題 | OpenSearch 服務本身的問題可能會導致您的網域顯示為不符合升級資格。如果上述問題都不適用於您的網域,且問題持續超過一天,請聯絡AWS Support |
使用快照來遷移資料
就地升級是將網域升級至更新版本 OpenSearch 或 Elasticsearch 版本的更簡單、更快速且更可靠的方式。如果您需要從 Elasticsearch 5.1 之前的版本中遷移或想要遷移至全新的叢集,快照會是一個好選擇。
下表顯示如何使用快照將資料移轉至使用其他版本 OpenSearch 或 Elasticsearch 版本的網域。如需有關拍攝和恢復快照的資訊,請參閱在 Amazon OpenSearch 服務中創建索引快照。
原始版本 | 目標版本 | 遷移程序 |
---|---|---|
OpenSearch 一點三或二. x | OpenSearch 2. x |
|
OpenSearch 1. x | OpenSearch 1. x |
|
Elasticsearch 6.x 或 7.x | OpenSearch 1. x |
|
Elasticsearch 6.x | Elasticsearch 7.x |
|
Elasticsearch 6.x | Elasticsearch 6.8 |
|
Elasticsearch 5.x | Elasticsearch 6.x |
|
Elasticsearch 5.x | Elasticsearch 5.6 |
|
Elasticsearch 2.3 | Elasticsearch 6.x |
Elasticsearch 2.3 快照與 6.x 不相容。若要直接將您的資料從 2.3 遷移至 6.x,您必須在新網域手動重新建立索引。 或者,您可以遵照此表中的 2.3 到 5.x 步驟,在全新 5.x 網域中執行 |
Elasticsearch 2.3 | Elasticsearch 5.x |
|
Elasticsearch 1.5 | Elasticsearch 5.x |
Elasticsearch 1.5 快照與 5.x 不相容。若要將您資料從 1.5 遷移至 5.x,您必須在新網域手動重新建立索引。 重要1.5 快照與 2.3 相容,但 OpenSearch 服務 2.3 網域不支援此 |
Elasticsearch 1.5 | Elasticsearch 2.3 |
|