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.

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

  • Instantané et restauration : procédez comme suit :
    1. Créez un cliché à partir du cluster en cours. Pour obtenir des instructions, reportez-vous à Création d'une sauvegarde de cluster OpenSearch.
    2. Créez un cluster de la version logicielle requise.
    3. Restaurez l'instantané dans le nouveau cluster. Pour obtenir des instructions, reportez-vous à Restauration d'une sauvegarde vers un nouveau cluster OpenSearch.
  • Mise à niveau directe : mettez à niveau le cluster lui-même vers la version requise.
  • Cloner et mettre à niveau : créez un clone de votre cluster et effectuez une mise à niveau vers la version requise.

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

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

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

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

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

    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.

Effectuer une mise à niveau majeure

Suivez les étapes précédentes de cette rubrique pour mettre à niveau la version logicielle du cluster. Sélectionnez la version 3.2.0 ou une version ultérieure dans la liste Versions logicielles disponibles.

Remarque

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 le routage de cliché et 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.

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