Documentation sur Oracle Cloud Infrastructure

Mise à niveau de la recherche avec le logiciel de grappe OpenSearch

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

La recherche avec OpenSearch prend en charge plusieurs versions concurrentes de OpenSearch. Pour les grappes existantes utilisant des versions plus anciennes, vous pouvez mettre à niveau la grappe pour utiliser la fonctionnalité disponible dans la dernière version de OpenSearch.

Le processus de mise à niveau dépend de la mise à niveau d'une version majeure ou d'une version mineure. Une mise à niveau de version majeure est indiquée par une modification du premier numéro du numéro de version, par exemple, 2.19.1 à 3.2.0. Une mise à niveau de version mineure est indiquée par une modification du deuxième numéro dans le numéro de version, par exemple, 2.11.0 à 2.15.0.

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

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

Note

Tenez compte des 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.
  • 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 la route d'instantané et 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.

Chemins de mise à niveau recommandés

Version avant mise à niveau Version après mise à niveau
1,2 2,11
2,3 2,11
2,11 2,15
2,15 2,18
2,18 2,19
2,19 3,2
Note

Les versions 1.2.4 et 2.3.0 sont obsolètes. Vous pouvez donc les mettre à niveau directement vers la version 2.11.0. Pour plus d'informations, voir Rechercher avec les versions prises en charge par OpenSearch.

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 Recherche dans la liste avec les grappes OpenSearch.

Mise à niveau du logiciel

    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 Recherche de liste avec les 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.

    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.

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