Mise à niveau de la recherche avec le logiciel de grappe OpenSearch

Mettre à niveau la version logicielle d'une grappe avec une mise à niveau logicielle.

Méthodes de mise à niveau

Vous pouvez mettre à niveau votre grappe OpenSearch vers une version logicielle plus récente pour accéder aux nouvelles fonctions et fonctionnalités. OpenSearch prend en charge plusieurs versions concurrentes, de sorte que vous pouvez garder votre grappe OpenSearch à jour avec les dernières améliorations. Cette rubrique décrit les méthodes de mise à niveau, les considérations et les chemins de mise à niveau pris en charge.

Sélectionnez l'une des méthodes suivantes pour mettre à niveau votre grappe OpenSearch :

Cloner et mettre à niveau : (Recommandé) Créez un clone de votre grappe OpenSearch et mettez à niveau la grappe clonée 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 la nouvelle grappe.
Mise à niveau directe : Mettez à niveau votre grappe OpenSearch existante vers la version requise en place. Utilisez cette méthode pour les grappes petites 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 une migration propre vers une nouvelle version de grappe 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 instantané de votre grappe OpenSearch courante. Pour obtenir des instructions, voir Création d'une sauvegarde de grappe.
2. Créez une grappe OpenSearch avec la version logicielle requise.
3. Restaurez l'instantané dans la nouvelle grappe OpenSearch. Pour obtenir des instructions, voir Restauration d'une sauvegarde à partir d'une grappe.

Limites et points à considérer pour les mises à niveau

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

Après avoir 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 ne pouvez effectuer une mise à niveau qu'à une version plus récente du logiciel OpenSearch. Vous ne pouvez pas passer à une version antérieure.
Si un index de votre grappe utilise le pipeline RAG, la mise à niveau directe vers la version 3.2.0 échoue. Utilisez l'instantané et la méthode de restauration comme solution de rechange. La RAG est entièrement prise en charge sur OpenSearch version 3.2.0.

Chemins de mise à niveau du logiciel

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


Version courante	Version mise à niveau
1.x	2,19
2.x	2,19
2,19	3,2

Note

Les versions 1.2.4 et 2.3.0 sont obsolètes. Vous pouvez donc les mettre à niveau directement vers une version répertoriée dans le tableau précédent. Pour plus d'informations, voir Rechercher avec des versions prises en charge par OpenSearch.

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 Recherche dans la liste avec les grappes OpenSearch.

Mise à niveau du logiciel

1. Dans la page de liste Grappes, recherchez la grappe OpenSearch avec laquelle vous voulez travailler. Si vous avez besoin d'aide pour trouver la page de liste ou la grappe, voir Recherche de liste avec les grappes OpenSearch.
2. Dans le menu Actions de la grappe OpenSearch, 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. Nous vous recommandons de sélectionner cette option pour les mises à niveau majeures afin d'éviter tout temps d'arrêt du trafic de production en raison de problèmes liés à la mise à niveau.
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.
Mise à niveau de la grappe courante
Pour mettre à niveau la grappe courante, réglez le paramètre is-clone à 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 valider que l'ID grappe a le même nom d'affichage.

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.
Clonage de la grappe et application de la mise à niveau
Pour créer un clone de la grappe et appliquer la mise à niveau au clone, réglez le paramètre is-clone à 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 compilation mineure) pour une grappe.
Mise à niveau de la grappe courante
Réglez le paramètre .isClone() à false. Par exemple :
```
.isClone(false)
```
Clonage de la grappe et application de la mise à niveau
Réglez le paramètre .isClone() à true. Par exemple :
```
.isClone(true)
```

Changements révolutionnaires 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, consultez le site OpenSearch suivant :

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

Les informations concernant les 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 obsolètes 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

Documentation sur Oracle Cloud Infrastructure