Oracle Cloud Infrastructure-Dokumentation

OpenSearch Cluster-Softwareupgrades

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

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 OpenSearch-Clusterbackup 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 einem neuen OpenSearch-Cluster wiederherstellen.
  • Direktes Upgrade: Führen Sie ein Upgrade des Clusters auf die erforderliche Version durch.
  • Klonen und upgraden: 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.

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

  • 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.
  • OpenSearch-Knoten und -Indizes sind abwärtskompatibel mit der vorherigen Hauptversion.

Unterstützte Upgradepfade für Inline Upgrade

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

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 OpenSearch-Cluster auflisten.

    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 OpenSearch-Cluster 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.

    Der Wert für upgrade-type muss MINOR sein.

    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. Konfigurieren Sie upgradeType als "Minor".

Hauptupgrade ausführen

Führen Sie die vorherigen Schritte in diesem Thema aus, um die Softwareversion des Clusters zu aktualisieren. Wählen Sie Version 3.2.0 oder höher aus der Liste Verfügbare Softwareversionen.

Hinweis

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.

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