Documentation Oracle Cloud Infrastructure

Mise à niveau de Search avec le logiciel de cluster 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 simultanées de OpenSearch. Pour les clusters existants utilisant des versions antérieures, vous pouvez mettre à niveau le cluster afin d'utiliser les fonctionnalités disponibles dans la dernière version de OpenSearch.

Le processus de mise à niveau dépend du fait que vous effectuez une mise à niveau de version majeure ou mineure. Une mise à niveau de version majeure est indiquée par une modification du premier numéro du numéro de build, 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 du numéro de build, par exemple, 2.11.0 à 2.15.0.

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

Les méthodes de mise à niveau directe et de clonage et mise à niveau sont décrites plus loin dans cette rubrique.

Remarque

Tenez compte des limites 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 l'arrêter ni l'annuler. Nous vous recommandons de créer une sauvegarde du cluster.
  • Vous pouvez uniquement mettre à niveau un cluster vers une version plus récente du logiciel OpenSearch. Vous ne pouvez pas revenir à une version antérieure du logiciel OpenSearch.
  • La mise à niveau vers la version 3.2.0 échoue si un index avec pipeline RAG est présent dans le cluster, la solution de contournement actuelle consiste à utiliser l'instantané et le routage de restauration pour la mise à niveau. La RAG est toutefois entièrement prise en charge sur le cluster 3.2.0 mis à niveau. Des travaux sont en cours pour régler ces deux questions.

Chemins de mise à niveau recommandés

Version de pré-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
Remarque

Les versions 1.2.4 et 2.3.0 sont en phase d'abandon. Vous pouvez donc les mettre à niveau directement vers la version 2.11.0. Pour plus d'informations, reportez-vous à Recherche avec les versions prises en charge par OpenSearch.

Accédez à la liste Clusters de la console pour vérifier si un cluster est éligible à une mise à niveau logicielle. Tous les clusters éligibles à la mise à niveau incluent le texte Mise à niveau dans la colonne Version du logiciel. Pour obtenir des instructions sur l'accès à la liste des clusters, reportez-vous à Liste des recherches avec les clusters OpenSearch.

Mettre à niveau le logiciel

    1. Sur la page de liste Clusters, recherchez le cluster OpenSearch avec lequel vous voulez travailler. Si vous avez besoin d'aide pour trouver la page de liste ou le cluster, reportez-vous à Liste des recherches avec les clusters OpenSearch.
    2. Dans le menu Actions du cluster OpenSearch, sélectionnez Mettre à niveau.
    3. Dans le panneau Mettre à niveau, sélectionnez l'une des options suivantes :
      • Mettre à niveau le cluster en cours : met à niveau la version de ce cluster. Les mises à niveau de version majeures peuvent présenter un temps d'arrêt.
      • Création d'un clone et application d'une mise à niveau au clone : utilisez cette fonctionnalité 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'inactivité du trafic de production en raison de problèmes liés à la mise à niveau.
    4. Sélectionnez la version logicielle dans la liste Versions logicielles disponibles. La version actuelle 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 build mineure) pour un cluster. Configurez le paramètre is-clone en tant que false ou true pour indiquer si vous mettez à niveau le cluster en cours ou si vous créez un clone du cluster et que vous appliquez la mise à niveau au clone.

    Exécutez la commande suivante pour mettre à niveau le cluster en cours :

    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 vérifier que l'ID de cluster a le même nom d'affichage.

    Afin d'obtenir la liste complète des indicateurs et des options de variable pour les commandes d'interface de ligne de commande, reportez-vous à Référence de ligne de commande.

  • Exécutez l'opération UpgradeOpenSearchCluster pour effectuer une mise à niveau logicielle en ligne pour un cluster.

Paramètres d'archivage

Les versions OpenSearch 3.x renomment les paramètres en phase d'abandon 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