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.

Méthodes de mise à niveau

Vous pouvez mettre à niveau votre cluster OpenSearch vers une version logicielle plus récente pour accéder aux nouvelles fonctionnalités. OpenSearch prend en charge plusieurs versions simultanées, de sorte que vous puissiez maintenir votre cluster OpenSearch à jour avec les dernières améliorations. Cette rubrique décrit les méthodes de mise à niveau, les points à prendre en compte et les chemins de mise à niveau pris en charge.

Choisissez l'une des méthodes suivantes pour mettre à niveau le cluster OpenSearch :

  • Cloner et mettre à niveau : (recommandé) créez un clone de votre cluster OpenSearch et mettez à niveau le cluster cloné vers la version requise. Utilisez cette approche pour minimiser les risques et les temps d'arrêt, et pour tester la mise à niveau avant de basculer le trafic de production vers le nouveau cluster.
  • Mise à niveau directe : mettez à niveau le cluster OpenSearch existant vers la version requise en place. Utilisez cette méthode pour les clusters petits ou non critiques où un court temps d'arrêt est acceptable. Cette option est également appelée "mise à niveau sur place".
  • Instantané et restauration : utilisez cette méthode pour effectuer une migration propre vers une nouvelle version de cluster OpenSearch, en particulier lorsque vous devez modifier des configurations telles que le type d'instance, la région ou l'architecture lors de la mise à niveau. Pour utiliser cette méthode de mise à niveau, procédez comme suit :
    1. Créez un cliché du cluster OpenSearch en cours. Pour obtenir des instructions, reportez-vous à la section Creating a Cluster Backup.
    2. Créez un cluster OpenSearch avec la version logicielle requise.
    3. Restaurez le cliché dans le nouveau cluster OpenSearch. Pour obtenir des instructions, reportez-vous à Restauration d'une sauvegarde à partir d'un cluster.

Limites et remarques relatives aux mises à niveau

Tenez compte des limitations et considérations suivantes concernant les mises à niveau en ligne :

  • Une fois que vous avez lancé une mise à niveau directe, vous ne pouvez pas arrêter ou annuler le processus. Nous vous recommandons de créer une sauvegarde avant de commencer la mise à niveau.
  • Vous pouvez uniquement effectuer une mise à niveau vers une version plus récente du logiciel OpenSearch. Vous ne pouvez pas revenir à une version antérieure.
  • Si un index de votre cluster utilise le pipeline RAG, la mise à niveau directe vers la version 3.2.0 échoue. Utilisez la méthode d'instantané et de restauration comme solution de contournement. La RAG est entièrement prise en charge sur OpenSearch version 3.2.0.

Chemins de mise à niveau logicielle

Vous pouvez mettre à niveau un cluster OpenSearch vers une version plus récente, mais une seule version majeure à la fois. Le chemin de mise à niveau recommandé est décrit dans le tableau suivant :

Version actuelle Version mise à niveau
1.x 2,19
2.x 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 une version répertoriée dans le tableau précédent. 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.

    Mise à niveau du cluster en cours

    Pour mettre à niveau le cluster en cours, définissez le paramètre is-clone sur false :

    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]

    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.

    Clonage du cluster et application de la mise à niveau

    Pour créer un clone du cluster et appliquer la mise à niveau au clone, définissez le paramètre is-clone sur true :

    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]

  • Exécutez l'opération UpgradeOpenSearchCluster pour effectuer une mise à niveau en ligne (version de build mineure) pour un cluster.

    Mise à niveau du cluster en cours

    Définissez le paramètre .isClone() sur false. Par exemple :

    .isClone(false)

    Clonage du cluster et application de la mise à niveau

    Définissez le paramètre .isClone() sur true. Par exemple :

    .isClone(true)

Modifications de rupture dans OpenSearch

Pour plus d'informations sur les dépréciations d'OpenSearch associées à la version 3.x, y compris les mises à niveau et les dépréciations, reportez-vous au site OpenSearch suivant :

https://docs.opensearch.org/latest/breaking-changes/#300

Les informations concernant d'autres versions d'OpenSearch sont également répertoriées sur le site.

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 d'archive 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