Oracle Cloud Infrastructure-Dokumentation

Suche mit OpenSearch-Clustersoftware upgraden

Aktualisieren Sie die Softwareversion eines Clusters mit einem Softwareupgrade.

Upgrademethoden

Sie können Ihr OpenSearch-Cluster auf eine neuere Softwareversion upgraden, um auf neue Features und Funktionen zuzugreifen. OpenSearch unterstützt mehrere nebenläufige Versionen, sodass Sie Ihr OpenSearch-Cluster mit den neuesten Verbesserungen auf dem neuesten Stand halten können. In diesem Thema werden die Upgrademethoden, Überlegungen und unterstützten Upgradepfade beschrieben.

Wählen Sie eine der folgenden Methoden, um Ihr OpenSearch-Cluster upzugraden:

  • Klonen und upgraden: (Empfohlen) Erstellen Sie einen Klon des OpenSearch-Clusters, und führen Sie ein Upgrade des geklonten Clusters auf die erforderliche Version durch. Mit diesem Ansatz können Sie Risiken und Ausfallzeiten minimieren und das Upgrade testen, bevor Sie den Produktionstraffic zum neuen Cluster wechseln.
  • Direktes Upgrade: Führen Sie ein Upgrade des vorhandenen OpenSearch-Clusters auf die erforderliche Version durch. Verwenden Sie diese Methode für kleine oder nicht kritische Cluster, bei denen kurze Ausfallzeiten akzeptabel sind. Diese Option wird auch als "In-Place-Upgrade" bezeichnet.
  • Snapshot und Wiederherstellung: Verwenden Sie diese Methode für eine saubere Migration zu einer neuen OpenSearch-Clusterversion, insbesondere wenn Sie während des Upgrades Konfigurationen wie Instanztyp, Region oder Architektur ändern müssen. Führen Sie die folgenden Schritte aus, um diese Upgrademethode zu verwenden:
    1. Erstellen Sie einen Snapshot des aktuellen OpenSearch-Clusters. Anweisungen finden Sie unter Clusterbackup erstellen.
    2. Erstellen Sie ein neues OpenSearch-Cluster mit der erforderlichen Softwareversion.
    3. Stellen Sie den Snapshot im neuen OpenSearch-Cluster wieder her. Anweisungen finden Sie unter Backup aus einem Cluster wiederherstellen.

Einschränkungen und Überlegungen für Upgrades

Beachten Sie die folgenden Einschränkungen und Überlegungen zu Inline-Upgrades:

  • Nachdem Sie ein direktes Upgrade gestartet haben, können Sie den Prozess weder stoppen noch abbrechen. Es wird empfohlen, vor dem Upgrade ein Backup zu erstellen.
  • Sie können nur ein Upgrade auf eine neuere OpenSearch-Softwareversion durchführen. Sie können kein Downgrade auf eine ältere Version durchführen.
  • Wenn ein Index in Ihrem Cluster die RAG-Pipeline verwendet, verläuft das direkte Upgrade auf Version 3.2.0 nicht erfolgreich. Verwenden Sie die Snapshot- und Restore-Methode als Workaround. RAG wird in OpenSearch Version 3.2.0 vollständig unterstützt.

Softwareupgradepfade

Sie können ein OpenSearch-Cluster auf eine neuere Version upgraden, jedoch jeweils nur eine Hauptversion. Der empfohlene Upgradepfad wird in der folgenden Tabelle beschrieben:

Aktuelle Version Upgradeversion
1.x 2,19
2.x 2,19
2,19 3,2
Hinweis

Die Versionen 1.2.4 und 2.3.0 sind veraltet, sodass Sie beide direkt auf eine in der obigen Tabelle aufgeführte Version upgraden können. Weitere Informationen finden Sie unter Mit OpenSearch unterstützte Versionen suchen.

Rufen Sie die Liste Cluster in der Konsole auf, um zu prüfen, ob ein Cluster für ein Softwareupgrade berechtigt ist. Alle Cluster, die für ein Upgrade berechtigt sind, enthalten den Text Upgrade in der Spalte Softwareversion. Anweisungen zum Zugriff auf die Liste Cluster finden Sie unter Suche mit OpenSearch-Clustern auflisten.

Software aktualisieren

    1. Suchen Sie auf der Listenseite Cluster das Cluster OpenSearch, mit dem Sie arbeiten möchten. Wenn Sie Hilfe beim Suchen der Listenseite oder des Clusters benötigen, lesen Sie Suche mit OpenSearch-Clustern auflisten.
    2. Wählen Sie im Menü Aktionen für das Cluster OpenSearch die Option Upgrade aus.
    3. Wählen Sie im Bereich Upgrade eine der folgenden Optionen:
      • Aktuelles Cluster upgraden: Führt ein Upgrade der Version dieses Clusters durch. Bei Upgrades größerer Versionen kann es zu Ausfallzeiten kommen.
      • Klon erstellen und Upgrade zum Klonen anwenden: Mit dieser Funktion können Sie das Upgrade auf einen Klon anwenden, damit Sie Tests ausführen können. Wir empfehlen, diese Option für größere Upgrades zu wählen, um Ausfallzeiten des Produktionsdatenverkehrs aufgrund von Problemen mit dem Upgrade zu vermeiden.
    4. Wählen Sie die Softwareversion aus der Liste Verfügbare Softwareversionen aus. Die aktuelle Version wird zunächst angezeigt.
    5. Wählen Sie Upgrade aus.

  • Verwenden Sie den Befehl oci opensearch cluster upgrade und die erforderlichen Parameter, um ein Inlineupgrade (kleine Build-Version) für ein Cluster auszuführen.

    Aktuelles Cluster upgraden

    Um das aktuelle Cluster upzugraden, setzen Sie den Parameter is-clone auf false:

    oci opensearch cluster upgrade --opensearch-cluster-id cluster_ocid --desired-software-version desired_OpenSearch_version 
--original_cluster_display_name original_cluster_display_name --upgrade-type [MAJOR | MINOR] --is-clone false [OPTIONS]

    Der Parameter original_cluster_display_name ist erforderlich, um zu validieren, dass die Cluster-ID denselben Anzeigenamen aufweist.

    Eine vollständige Liste der Kennzeichen und Variablenoptionen für CLI-Befehle finden Sie in der Befehlszeilenreferenz.

    Cluster klonen und Upgrade anwenden

    Um einen Klon des Clusters zu erstellen und das Upgrade auf den Klon anzuwenden, setzen Sie den Parameter is-clone auf true:

    oci opensearch cluster upgrade --opensearch-cluster-id cluster_ocid --desired-software-version desired_OpenSearch_version 
--original_cluster_display_name original_cluster_display_name --upgrade-type [MAJOR | MINOR] --is-clone true [OPTIONS]

  • Führen Sie den Vorgang UpgradeOpenSearchCluster aus, um ein Inline-(Minder-Build-)Upgrade für ein Cluster auszuführen.

    Aktuelles Cluster upgraden

    Setzen Sie den Parameter .isClone() auf false. Beispiel:

    .isClone(false)

    Cluster klonen und Upgrade anwenden

    Setzen Sie den Parameter .isClone() auf true. Beispiel:

    .isClone(true)

OpenSearch – Änderungen durchbrechen

Informationen zu den mit Version 3.x verknüpften OpenSearch-Verfallungen, einschließlich Upgrades und Abschreibungen, finden Sie auf der folgenden OpenSearch-Website:

https://docs.opensearch.org/latest/breaking-changes/#300

Informationen zu anderen OpenSearch-Versionen sind ebenfalls auf der Website aufgelistet.

Archiveinstellungen

OpenSearch 3.x-Versionen benennen die veralteten Einstellungen mit dem Präfix archived. um Alle Archivierungseinstellungen werden während des Upgrades entfernt. Hier ist die Liste der veralteten Einstellungen:

  • thread_pool.test.max_queue_size
  • thread_pool.test.min_queue_size
  • index.store.hybrid.mmap.extensions
  • knn.plugin.enabled
  • index.knn.algo_param.ef_construction
  • index.knn.algo_param.m
  • index.knn.space_type
  • plugins.sql.delete.enabled
  • opendistro*
  • plugins.sql.pagination.api