Documentation sur Oracle Cloud Infrastructure

Mises à niveau du logiciel de grappe OpenSearch

Mettez à niveau la version logicielle d'un cluster avec une mise à niveau logicielle en ligne.

Vous pouvez mettre à niveau la version logicielle de la grappe OpenSearch à l'aide des méthodes suivantes :

  • Instantané et restauration : Suivez ces étapes :
    1. Créez un instantané à partir de la grappe courante. Pour obtenir des instructions, voir Création d'une sauvegarde de grappe OpenSearch.
    2. Créez un nouveau cluster de la version logicielle requise.
    3. Restaurez l'instantané dans la nouvelle grappe. Pour obtenir des instructions, voir Restauration d'une sauvegarde dans une nouvelle grappe OpenSearch.
  • Mise à niveau directe : Mettez à niveau votre grappe elle-même vers la version requise.
  • Cloner et mettre à niveau : Créez un clone de votre grappe et effectuez la mise à niveau vers la version requise.

Les méthodes Mise à niveau directe et Cloner et mettre à niveau sont décrites plus loin dans cette rubrique.

Notez les limitations et considérations suivantes concernant les mises à niveau en ligne :

  • Une fois le processus de mise à niveau en ligne démarré, vous ne pouvez pas arrêter ou annuler le processus. Nous vous recommandons de créer une sauvegarde de la grappe.
  • Vous ne pouvez mettre à niveau une grappe qu'à une version plus récente du logiciel OpenSearch. Vous ne pouvez pas passer à une version plus ancienne du logiciel OpenSearch.
  • Les noeuds et les index OpenSearch sont rétrocompatibles avec la version principale précédente.

Chemins de mise à niveau pris en charge pour la mise à niveau en ligne

Version avant mise à niveau Version après mise à niveau
1,2 2.3
2,3 2.11
2.11 2.15
2,15 2,18
2,18 2,19
2,19 3,2

Accédez à la liste Grappes de la console pour vérifier si une grappe est admissible à une mise à niveau logicielle. Toutes les grappes admissibles à la mise à niveau incluent le texte Mettre à niveau dans la colonne Version du logiciel. Pour obtenir des instructions sur l'accès à la liste Grappes, voir Liste des grappes OpenSearch.

    1. Dans la page de liste Grappes, recherchez la grappe OpenSearch avec laquelle vous voulez travailler. Si vous avez besoin d'aide pour trouver la page de liste ou la grappe, voir Liste des grappes OpenSearch.
    2. Dans le menu Actions de la grappe OpenSearch, sélectionnez Mettre à niveau.
    3. Dans le panneau Mettre à niveau, sélectionnez l'une des options suivantes :
      • Mettre à niveau la grappe courante : Met à niveau la version de cette grappe. Les mises à niveau de version majeures peuvent avoir un temps d'arrêt.
      • Créer un clone et appliquer la mise à niveau au clone : Utilisez cette fonction pour appliquer la mise à niveau à un clone afin de pouvoir exécuter des tests. Nous vous recommandons de sélectionner cette option pour les mises à niveau majeures afin d'éviter tout temps d'arrêt du trafic de production en raison de problèmes liés à la mise à niveau.
    4. Sélectionnez la version du logiciel dans la liste Versions logicielles disponibles. La version courante est initialement affichée.
    5. Sélectionnez Mettre à niveau.

  • Utilisez la commande oci opensearch cluster upgrade et les paramètres requis pour effectuer une mise à niveau en ligne (version de compilation mineure) pour une grappe. Configurez le paramètre is-clone en tant que false ou true pour spécifier si vous mettez à niveau la grappe courante ou si vous créez un clone de la grappe et appliquez la mise à niveau au clone.

    Exécutez la commande suivante pour mettre à niveau la grappe courante :

    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]

    Exécutez la commande suivante pour créer un clone et appliquer la mise à niveau au clone :

    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]

    Le paramètre original_cluster_display_name est requis pour valider que l'ID grappe a le même nom d'affichage.

    La valeur de upgrade-type doit être MINOR.

    Pour la liste complète des indicateurs et des options de variable pour les commandes de l'interface de ligne de commande, voir Informations de référence sur la ligne de commande.

  • Exécutez l'opération UpgradeOpenSearchCluster pour effectuer une mise à niveau logicielle en ligne pour une grappe. Configurez upgradeType en tant que mineur.

Exécution d'une mise à niveau majeure

Suivez les étapes précédentes de cette rubrique pour mettre à niveau la version logicielle de la grappe. Sélectionnez la version 3.2.0 ou une version supérieure dans la liste Versions logicielles disponibles.

Note

La mise à niveau vers la version 3.2.0 échoue si un index avec pipeline RAG est présent dans la grappe, la solution de rechange courante consiste à utiliser l'instantané et la route de restauration pour la mise à niveau. La RAG est toutefois entièrement prise en charge sur la grappe 3.2.0 mise à niveau.

Des travaux sont en cours pour résoudre ces deux problèmes.

Paramètres d'archivage

Les versions 3.x de OpenSearch renomment les paramètres obsolètes avec le préfixe archived. Tous les paramètres archivés sont supprimés lors de la mise à niveau. Voici la liste des paramètres obsolètes :

  • 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