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.

Lorsque vous créez une grappe, par défaut, elle est basée sur la dernière version prise en charge 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 à l'aide de la fonction de mise à niveau logicielle intégrée.

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 pouvez créer une sauvegarde à l'aide de l'API d'instantané ou à l'aide du processus décrit dans Création d'une sauvegarde de grappe OpenSearch.
  • 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.
  • Pour passer de la recherche élastique 6.8 à 2.x, effectuez d'abord une mise à niveau vers OpenSearch 1.x. Ensuite, recréez 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 avant mise à niveau Version après mise à niveau
2.3 2.11
2.11 2.15

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 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, 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.
    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 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 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.