Oracle Cloud Infrastructure-Dokumentation

Suche mit OpenSearch-Clustersoftware upgraden

Aktualisieren Sie die Softwareversion eines Clusters mit einem Inline-Softwareupgrade.

Die Suche mit OpenSearch unterstützt mehrere nebenläufige Versionen von OpenSearch. Bei vorhandenen Clustern, die ältere Versionen verwenden, können Sie das Cluster upgraden, um die in der neuesten Version von OpenSearch verfügbare Funktionalität zu verwenden.

Der Upgrade-Prozess hängt davon ab, ob Sie ein Upgrade auf eine Hauptversion oder ein Upgrade auf eine Nebenversion durchführen. Ein Upgrade der Hauptversion wird durch eine Änderung der ersten Nummer in der Build-Nummer angezeigt, z. B. 2.19.1 auf 3.2.0. Eine geringfügige Versionsaktualisierung wird durch eine Änderung der zweiten Nummer in der Build-Nummer angezeigt, z. B. 2.11.0 auf 2.15.0.

Sie können die Softwareversion des Clusters OpenSearch mit den folgenden Methoden upgraden:

  • Snapshot und Wiederherstellung: Führen Sie die folgenden Schritte aus:
    1. Snapshot aus dem aktuellen Cluster erstellen Anweisungen finden Sie unter Suchen mit Clusterbackup OpenSearch erstellen.
    2. Erstellen Sie ein neues Cluster der erforderlichen Softwareversion.
    3. Stellen Sie den Snapshot im neuen Cluster wieder her. Anweisungen finden Sie unter Backup in einer neuen Suche mit dem Cluster OpenSearch wiederherstellen.
  • Direktes Upgrade: Führen Sie ein Upgrade des Clusters auf die erforderliche Version durch.
  • Klonen und upgraden: (Empfohlen) Erstellen Sie einen Klon des Clusters, und führen Sie ein Upgrade auf die erforderliche Version durch.

Die Methoden Direktes Upgrade und Klonen und Upgrade werden später in diesem Thema beschrieben.

Hinweis

Beachten Sie die folgenden Einschränkungen und Überlegungen zu Inlineupgrades:
  • Nachdem der Inlineupgradeprozess gestartet wurde, können Sie den Prozess weder stoppen noch abbrechen. Wir empfehlen, dass Sie ein Backup des Clusters erstellen.
  • Sie können ein Cluster nur auf eine neuere OpenSearch-Softwareversion upgraden. Ein Downgrade auf eine ältere OpenSearch-Softwareversion ist nicht möglich.
  • Das Upgrade auf Version 3.2.0 verläuft nicht erfolgreich, wenn ein Index mit RAG-Pipeline im Cluster vorhanden ist. Die aktuelle Problemumgehung besteht darin, die Snapshot- und Restore-Route für das Upgrade zu verwenden. RAG wird jedoch auf dem aktualisierten 3.2.0-Cluster vollständig unterstützt. Es wird daran gearbeitet, diese beiden Probleme anzugehen.

Empfohlene Upgradepfade

Vorabupgradeversion Version nach Upgrade
1,2 2,11
2,3 2,11
2,11 2,15
2,15 2,18
2,18 2,19
2,19 3,2
Hinweis

Versionen 1.2.4 und 2.3.0 sind veraltet, sodass Sie beide direkt auf Version 2.11.0 upgraden können. Weitere Informationen finden Sie unter Mit unterstützten OpenSearch-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. Konfigurieren Sie den Parameter is-clone als false oder true, um anzugeben, ob Sie das aktuelle Cluster upgraden oder einen Klon des Clusters erstellen und das Upgrade auf den Klon anwenden.

    Führen Sie den folgenden Befehl aus, um das aktuelle Cluster upzugraden:

    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]

    Führen Sie den folgenden Befehl aus, um einen Klon zu erstellen und das Upgrade auf den Klon anzuwenden:

    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]

    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.

  • Führen Sie den Vorgang UpgradeOpenSearchCluster aus, um ein Inline-Softwareupgrade für ein Cluster auszuführen.

Archiveinstellungen

OpenSearch 3.x-Versionen benennen die veralteten Einstellungen mit dem Präfix archived. um. Alle archivierten Einstellungen 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