Upgrade von Amazon OpenSearch Service-Domains - 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.

Upgrade von Amazon OpenSearch Service-Domains

Anmerkung

OpenSearch und Elasticsearch-Versions-Upgrades unterscheiden sich von Service-Software-Updates. 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, die OpenSearch 1.0 oder höher oder Elasticsearch 5.1 oder höher ausführen. Wenn Sie Dienste wie Amazon Data Firehose oder Amazon CloudWatch Logs verwenden, um Daten an OpenSearch Service zu streamen, überprüfen Sie OpenSearch vor der Migration, ob diese Dienste die neuere Version von unterstützen.

Unterstützte Upgrade-Pfade

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

Von Version Auf Version
OpenSearch 1.3 oder 2. x

OpenSearch 2. x

OpenSearch 2.17 aktiviert standardmäßig die gleichzeitige Segmentsuche im auto 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) haben den Instanztyp 2.xl 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ße oder kalte) 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 bei inkompatiblen UltraWarm oder kalten Indizes diese in den heißen Speicher, indizieren Sie die Daten erneut und migrieren Sie sie dann zurück in den warmen oder kalten Speicher. 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

Elasticsearch 7. x oder OpenSearch 1. x

Wichtig

OpenSearch 1 x führt zahlreiche bahnbrechende Ä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 beinhalten zahlreiche grundlegende Änderungen. Bevor Sie ein direktes Upgrade starten, empfehlen wir, einen manuellen Snapshot der Version 6 zu erstellen. x-Domain, Wiederherstellung auf einem Test 7. x oder OpenSearch 1. x-Domäne und Verwendung dieser Testdomäne, um potenzielle Upgrade-Probleme zu identifizieren. Informationen zu den wichtigsten Ä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. Das hat zur Folge, dass für bestimmte APIs Anwendungen kein Zuordnungstyp mehr im Anfragetext (z. B. in der _bulk API) erforderlich ist.

Elasticsearch 7 wurde für neue Indizes selbst gehostet. x und 1. OpenSearch x haben eine Standardanzahl von Shards von eins. OpenSearch Service-Domains 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 die Ausfallzeiten während des Upgrades von Elasticsearch 5.6 auf 6 zu minimieren. x, OpenSearch Service indexiert den .kibana Index neu, löscht ihn .kibana-6.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. Prüfungen vor dem Upgrade — OpenSearch Der Service sucht nach Problemen, die ein Upgrade blockieren könnten, und fährt erst mit dem nächsten Schritt fort, wenn diese Prüfungen erfolgreich sind.

  2. Snapshot — Der OpenSearch Service erstellt einen Snapshot des OpenSearch oder Elasticsearch-Clusters und fährt erst mit dem nächsten Schritt fort, wenn der Snapshot erfolgreich ist. Wenn das Upgrade fehlschlägt, verwendet 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, dessen Abschluss zwischen 15 Minuten und mehreren Stunden dauern kann. OpenSearch Dashboards sind möglicherweise während eines Teils oder des gesamten Upgrades nicht verfügbar.

Beheben von Validierungsfehlern

Wenn Sie ein Versionsupgrade OpenSearch oder ein Elasticsearch-Versionsupgrade 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

Direkte -Upgrades erfordern gesunde Domains. 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 Beschreibung
Optionales Plugin wird nicht unterstützt

Wenn Sie eine Domain mit optionalen Plug-ins aktualisieren, aktualisiert OpenSearch Service automatisch auch die Plug-ins. 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 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 aus einer älteren Version von OpenSearch 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 einem inkompatiblen Index zugeordnet, wahrscheinlich einem aus einer früheren Version von OpenSearch Dashboards. Indizieren Sie erneut und versuchen Sie es erneut.
Roter Dashboard-Status OpenSearch Der Status der 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.
Cluster-übergreifende 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 Service Probleme mit dem OpenSearch Service selbst können dazu führen, dass Ihre 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.