Documentation Oracle Cloud Infrastructure

OpenSearch Mises à niveau du logiciel de cluster

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

Lorsque vous créez un cluster, il est basé par défaut sur la dernière version prise en charge de OpenSearch. Pour les clusters existants utilisant des versions antérieures, vous pouvez mettre à niveau le cluster afin d'utiliser la fonctionnalité disponible dans la dernière version de OpenSearch à l'aide de la fonctionnalité de mise à niveau logicielle en ligne.

Notez les 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 créer une sauvegarde à l'aide de l'API de cliché ou à l'aide du processus décrit dans Création d'une sauvegarde de cluster OpenSearch.
  • 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.
  • Les noeuds et les index OpenSearch sont rétrocompatibles avec la version principale précédente.
  • Pour passer de la recherche élastique 6.8 à la recherche 2.x, effectuez d'abord la mise à niveau vers OpenSearch 1.x. Recréez ensuite vos index à l'aide de l'API de réindexation. Enfin, passez à la version 2.x.

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

Version de pré-mise à niveau Version après mise à niveau
2,3 2,11
2,11 2,15

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

    1. Sur la page de liste Clusters, recherchez le cluster avec lequel vous voulez travailler. Si vous avez besoin d'aide pour trouver la page de liste ou le cluster, reportez-vous à Liste des clusters OpenSearch.
    2. Dans le menu Actions du cluster, 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.
    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 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 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.

    La valeur de upgrade-type doit être MINOR.

    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. Configurez upgradeType en tant que mineur.