View a markdown version of this page

Amazon OpenSearch Service-Domains aktualisieren - OpenSearch Amazon-Dienst
Unterstützte Upgrade-PfadeBeheben von ValidierungsfehlernFehlerbehebung bei einem Upgrade

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Amazon OpenSearch Service-Domains aktualisieren

Anmerkung

OpenSearch und Elasticsearch-Versionsupgrades unterscheiden sich von Servicesoftwareupdates. Informationen zur Aktualisierung der Servicesoftware für Ihre OpenSearch Service-Domain finden Sie unterServicesoftwareupdates in Amazon OpenSearch Service.

Amazon OpenSearch Service bietet direkte Upgrades für Domains an, auf denen OpenSearch 1.0 oder höher oder Elasticsearch 5.1 oder höher ausgeführt wird. Wenn Sie Dienste wie Amazon Data Firehose oder Amazon CloudWatch Logs verwenden, um Daten an OpenSearch Service zu streamen, überprüfen Sie vor der Migration, ob diese Dienste die neuere Version von OpenSearch unterstützen.

Unterstützte Upgrade-Pfade

Derzeit unterstützt OpenSearch Service die folgenden Upgrade-Pfade:

Von Version Auf Version
OpenSearch 1.3, 2. x oder 3. x

OpenSearch 3. x

Wenn Sie OpenSearch 1.3 oder 2.x verwenden, müssen Sie zuerst ein Upgrade auf OpenSearch 2.19 durchführen, bevor Sie ein Upgrade auf 3.x durchführen. OpenSearch

Beim Upgrade von OpenSearch 2.19 auf OpenSearch 3.x müssen Sie möglicherweise die folgenden inkompatiblen Indexeinstellungen beheben. Diese waren früher in 2.x veraltet und führen zu einem Fehler bei der Validierung der Upgrade-Überprüfung, wenn sie nicht entfernt werden.

  • index.knn.algo_param.ef_construction

  • index.knn.algo_param.m

  • index.knn.space_type

  • index.store.hybrid.mmap.extensions

Weitere Informationen zu veralteten Indexeinstellungen und Maßnahmen zu deren Behebung finden Sie unter Indexeinstellungen. https://docs.opensearch.org/2.6/search-plugins/knn/knn-index/#index-settings Eine vollständige Liste der wichtigsten Änderungen für OpenSearch 3.x finden Sie unter 3.0.0. https://docs.opensearch.org/latest/breaking-changes/#300

Wenn Ihre Domain Indizes enthält, die in OpenSearch 1.3, Elasticsearch 7.10 oder früheren Versionen erstellt wurden, müssen Sie diese vor dem Upgrade auf 3.x neu indizieren. OpenSearch OpenSearch 3.x unterstützt diese älteren Indizes nicht, unabhängig davon, ob sie sich im Hot- oder Cold-Storage befinden. UltraWarm Um inkompatible UltraWarm oder kalte Indizes neu zu indizieren:

  1. Migrieren Sie die Indizes in den Hot-Storage.

  2. Indizieren Sie die Daten erneut.

  3. Migrieren Sie die Indizes zurück in den warmen oder kalten Speicher.

Sie können die Indizes auch löschen, wenn Sie sie nicht mehr benötigen.

Schnappschüsse aufgenommen am 1. OpenSearch x und auf Elasticsearch 7.10 und früheren Versionen sind nicht mit 3.x kompatibel. OpenSearch

Löschen Sie bei manuellen Snapshot-Repositorys diese inkompatiblen Snapshots, bevor Sie ein Upgrade auf 3.x durchführen. OpenSearch

OpenSearch 1.3 oder 2. x

OpenSearch 2. x

OpenSearch 2.17 aktiviert standardmäßig die gleichzeitige Segmentsuche im automatischen Modus, wenn die Domain die folgenden Bedingungen erfüllt:

  • Es wurden keine vorherigen Einstellungen für die gleichzeitige Suche explizit festgelegt.

  • Alle Dateninstanzen (heiß und warm) sind vom Instanztyp .2xl oder höher.

  • Die durchschnittliche p90-CPU-Auslastung auf Dateninstanzen (heiß und warm) für mehr als eine Woche liegt unter 45%.

    Weitere Informationen zu den Einstellungen für die gleichzeitige Segmentsuche finden Sie hier unter Gleichzeitige Segmentsuche.

Version 2.3 enthält die folgenden grundlegenden Änderungen:

  • Der type Parameter wurde in Version 2.0 von allen OpenSearch API-Endpunkten entfernt. Weitere Informationen finden Sie unter grundlegende Änderungen.

  • Wenn Ihre Domain Indizes (heiß oder kalt) enthält UltraWarm, die ursprünglich in Elasticsearch 6.8 erstellt wurden, sind diese Indizes nicht mit 2.3 kompatibel. OpenSearch

    Bevor Sie auf Version 2.3 aktualisieren, müssen Sie die nicht kompatiblen Indizes neu indizieren. Migrieren Sie inkompatible UltraWarm oder kalte Indizes in den Hot-Storage, indizieren Sie die Daten erneut und migrieren Sie sie dann zurück in den Warm- oder Cold-Storage. Alternativ können Sie die Indizes auch löschen, wenn Sie sie nicht mehr benötigen.

    Wenn Sie Ihre Domain versehentlich auf Version 2.3 aktualisieren, ohne diese Schritte vorher auszuführen, können Sie die nicht kompatiblen Indizes nicht aus ihrer aktuellen Speicherebene migrieren. Ihre einzige Möglichkeit besteht darin, sie zu löschen.
OpenSearch 1. x OpenSearch 1. x
Elasticsearch 7.x

Elastische Suche 7. x oder OpenSearch 1. x

Wichtig

OpenSearch 1. x führt zahlreiche wichtige Änderungen ein. Details hierzu finden Sie unter Umbenennung von Amazon OpenSearch Service — Zusammenfassung der Änderungen.

Elasticsearch 6.8

Elasticsearch 7. x oder OpenSearch 1. x

Wichtig

Elasticsearch 7.0 und OpenSearch 1.0 enthalten zahlreiche wichtige Änderungen. Bevor Sie ein direktes Upgrade einleiten, empfehlen wir, einen manuellen Snapshot der 6 zu erstellen. x-Domäne, Wiederherstellung auf einem Test 7. x oder OpenSearch 1. x-Domäne und Verwendung dieser Testdomäne zur Identifizierung potenzieller Upgrade-Probleme. Wichtige Änderungen in OpenSearch 1.0 finden Sie unterUmbenennung von Amazon OpenSearch Service — Zusammenfassung der Änderungen.

Wie in Elasticsearch 6.x können Indizes nur einen Mapping-Typ enthalten, aber dieser Typ muss jetzt den Namen _doc haben. Daher benötigen bestimmte APIs keinen Mapping-Typ mehr im Anforderungstext (z. B. die _bulk-API).

Für neue Indizes selbst gehostetes Elasticsearch 7. x und 1. OpenSearch x haben eine Standard-Shard-Anzahl von eins. OpenSearch Service-Domänen auf Elasticsearch 7. x und spätere Versionen behalten den vorherigen Standardwert von fünf bei.

Elasticsearch 6.x

Elasticsearch 6.x
Elasticsearch 5.6

Elasticsearch 6.x

Wichtig

Indizes, die in Version 6.x erstellt wurden, unterstützen keine mehrfachen Mapping-Typen mehr. Indizes, die in Version 5.x erstellt wurden, unterstützen noch mehrfache Mapping-Typen, wenn sie in einem 6.x Cluster wiederhergestellt werden. Sehen Sie nach, ob Ihr Code nur einen einzigen Mapping-Typ pro Index erstellt.

Um Ausfallzeiten während des Upgrades von Elasticsearch 5.6 auf 6 zu minimieren. x, OpenSearch Service indexiert den .kibana Index erneut auf.kibana-6, löscht ihn.kibana, erstellt einen Alias mit dem Namen .kibana und ordnet den neuen Index dem neuen Alias zu.
Elasticsearch 5.x Elasticsearch 5.x

Der Upgrade-Prozess besteht aus drei Schritten:

  1. Pre-upgrade Prüfungen — OpenSearch Der Service sucht nach Problemen, die ein Upgrade blockieren könnten, und fährt erst dann mit dem nächsten Schritt fort, wenn diese Prüfungen erfolgreich sind.

  2. Snapshot — Der OpenSearch Service erstellt einen Snapshot des OpenSearch oder des Elasticsearch-Clusters und fährt erst dann mit dem nächsten Schritt fort, wenn der Snapshot erfolgreich ist. Schlägt das Upgrade fehl, verwendet der OpenSearch Service diesen Snapshot, um den Cluster in seinen ursprünglichen Zustand zurückzuversetzen. Weitere Informationen finden Sie unter Nach einem Upgrade ist kein Downgrade möglich.

  3. Upgrade — Der OpenSearch Service startet das Upgrade. Es kann zwischen 15 Minuten und mehreren Stunden dauern, bis es abgeschlossen ist. OpenSearch Dashboards sind möglicherweise während eines Teils oder des gesamten Upgrades nicht verfügbar.

Beheben von Validierungsfehlern

Wenn Sie ein OpenSearch Upgrade der Elasticsearch-Version initiieren, führt OpenSearch Service zunächst eine Reihe von Validierungsprüfungen durch, um sicherzustellen, dass Ihre Domain für ein Upgrade in Frage kommt. Wenn eine dieser Prüfungen fehlschlägt, erhalten Sie eine Benachrichtigung mit den spezifischen Problemen, die Sie beheben müssen, bevor Sie Ihre Domain aktualisieren. Eine Liste potenzieller Probleme und Schritte zu deren Behebung finden Sie unter Beheben von Validierungsfehlern.

Fehlerbehebung bei einem Upgrade

In-place Für Upgrades sind funktionsfähige Domains erforderlich. Ihre Domain ist womöglich nicht für ein Upgrade berechtigt oder kann aus einer Vielzahl von Gründen nicht upgegradet werden. Die folgende Tabelle zeigt die gängigsten Probleme.

Problem Description
Optionales Plugin wird nicht unterstützt

Wenn Sie eine Domain mit optionalen Plugins aktualisieren, aktualisiert OpenSearch Service automatisch auch die Plugins. Daher muss die Zielversion für Ihre Domain auch diese optionalen Plugins unterstützen. Wenn auf der Domain ein optionales Plugin installiert ist, das für die Zielversion nicht verfügbar ist, schlägt die Upgrade-Anfrage fehl.
Zu viele Shards pro Knoten OpenSearch, sowie 7. x Versionen von Elasticsearch haben eine Standardeinstellung von nicht mehr als 1.000 Shards pro Knoten. Wenn ein Knoten in Ihrem aktuellen Cluster diese Einstellung überschreitet, erlaubt Ihnen OpenSearch Service kein Upgrade. Informationen zu den Optionen für die Fehlerbehebung finden Sie unter Maximales Shard-Limit überschritten.
Domain in Verarbeitung Die Domain befindet sich in der Mitte einer Konfigurationsänderung. Überprüfen Sie die Upgrade-Berechtigung, nachdem die Operation abgeschlossen ist.
Roter Cluster-Status Ein oder mehrere Indizes im Cluster sind rot. Fehlerbehandlungsschritte finden Sie unter Roter Cluster-Status.
Hohe Fehlerrate Der Cluster gibt beim Versuch, Anfragen zu verarbeiten, eine große Anzahl von 5xx-Fehlern zurück. Dieses Problem ist in der Regel das Ergebnis zu vieler gleichzeitiger Lese- oder Schreibanforderungen. Erwägen Sie, den Datenverkehr zu dem Cluster zu reduzieren oder Ihre Domain zu skalieren.
Split brain Split brain bedeutet, dass Ihr Cluster über mehr als einen Master-Knoten verfügt und sich in zwei Cluster aufgeteilt hat, die sich nicht von selbst wieder hinzufügen. Sie können split brain vermeiden, indem Sie die empfohlene Anzahl der dedizierten Hauptknoten verwenden. Für Hilfe zur Wiederherstellung von split brain wenden Sie sich an Support.
Master-Knoten wurde nicht gefunden. OpenSearch Der Service kann den Master-Knoten des Clusters nicht finden. Wenn Ihre Domain Multi-AZ verwendet, kann ein Ausfall einer Availability Zone dazu geführt haben, dass der Cluster das Quorum verliert und keinen neuen Hauptknoten wählen kann. Wenn sich das Problem nicht von selbst löst, wenden Sie sich bitte an Support.
Zu viele ausstehende Aufgaben Der Master-Knoten ist stark ausgelastet und hat viele ausstehende Aufgaben. Erwägen Sie, den Datenverkehr zu dem Cluster zu reduzieren oder Ihre Domain zu skalieren.
Beeinträchtigtes Speicher-Volume Das Datenträger-Volume eines oder mehrerer Knoten funktioniert nicht ordnungsgemäß. Dieses Problem tritt oft zusammen mit anderen Problemen, wie z. B. eine hohe Fehlerrate oder zu viele ausstehende Aufgaben, auf. Wenn es isoliert auftritt und sich nicht von selbst löst, wenden Sie sich bitte an Support.
Problem mit KMS-Schlüssel Der KMS-Schlüssel für die Verschlüsselung der Domain ist entweder nicht zugänglich oder fehlt. Weitere Informationen finden Sie unter Überwachen von Domains, die Daten im Ruhezustand verschlüsseln.
Snapshot in Arbeit Die Domain erstellt derzeit einen Snapshot. Überprüfen Sie die Upgrade-Berechtigung, nachdem der Snapshot abgeschlossen ist. Überprüfen Sie auch, ob Sie manuelle Snapshot-Repositorys auflisten, Snapshots innerhalb dieser Repositorys auflisten und manuelle Snapshots erstellen können. Wenn der OpenSearch Dienst nicht überprüfen kann, ob ein Snapshot gerade ausgeführt wird, können Upgrades fehlschlagen.
Snapshot-Timeout oder -Fehler Der Pre-Upgrade-Snapshot hat zu lange gedauert oder ist fehlgeschlagen. Überprüfen Sie die Cluster-Gesundheit und versuchen Sie es erneut. Wenn das Problem weiterhin besteht, wenden Sie sich bitte an Support.
Inkompatible Indizes Ein oder mehrere Indizes sind nicht kompatibel mit der Zielversion. Dieses Problem kann auftreten, wenn Sie die Indizes von einer älteren Version von OpenSearch oder Elasticsearch migriert haben. Indizieren Sie die Indizes neu und versuchen Sie es erneut.
Hohe Festplattennutzung Die Festplattennutzung für den Cluster übersteigt 90 %. Löschen Sie Daten oder skalieren Sie die Domain und versuchen Sie es erneut.
Hohe JVM-Nutzung Die JVM-Speicherbelastung übersteigt 75 %. Reduzieren Sie den Datenverkehr an den Cluster oder skalieren Sie die Domain und versuchen Sie es erneut.
OpenSearch Problem mit dem Alias der Dashboards .dashboardsist bereits als Alias konfiguriert und wird einem inkompatiblen Index zugeordnet, wahrscheinlich einem Index aus einer früheren Version von OpenSearch Dashboards. Indizieren Sie erneut und versuchen Sie es erneut.
Roter Dashboard-Status OpenSearch Der Status des Dashboards ist rot. Verwenden Sie Dashboards, wenn das Upgrade abgeschlossen ist. Wenn der rote Status weiterhin besteht, beheben Sie den Fehler manuell und versuchen Sie es erneut.
Cross-cluster Kompatibilität

Sie können ein Upgrade nur dann durchführen, wenn die Cluster-übergreifende Kompatibilität zwischen der Quell- und Ziel-Domain nach dem Upgrade aufrechterhalten wird. Während des Upgrade-Vorgangs werden alle inkompatiblen Verbindungen identifiziert. Um fortzufahren, aktualisieren Sie entweder die Remote-Domain oder löschen Sie die inkompatiblen Verbindungen. Beachten Sie, dass Sie, wenn die Replikation für die Domain aktiv ist, nicht fortsetzen können, nachdem Sie die Verbindung gelöscht haben.

Anderes Problem mit dem OpenSearch Servicedienst Probleme mit dem OpenSearch Service selbst können dazu führen, dass deine Domain als nicht für ein Upgrade geeignet angezeigt wird. Wenn keine der vorangehenden Bedingungen für Ihre Domain gelten und das Problem mehr als einen Tag bestehen bleibt, wenden Sie sich bitte an Support.