View a markdown version of this page

Mise à niveau des domaines Amazon OpenSearch Service - OpenSearch Service Amazon
Chemins de mise à niveau pris en chargeRésolution des problèmes liés aux échecs de validationDépannage d'une mise à niveau

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Mise à niveau des domaines Amazon OpenSearch Service

Note

OpenSearch et les mises à niveau des versions d'Elasticsearch sont différentes des mises à jour du logiciel de service. Pour plus d'informations sur la mise à jour du logiciel de OpenSearch service pour votre domaine de service, consultezMises à jour du logiciel de service dans Amazon OpenSearch Service.

Amazon OpenSearch Service propose des mises à niveau sur place pour les domaines qui exécutent la OpenSearch version 1.0 ou ultérieure, ou Elasticsearch 5.1 ou une version ultérieure. Si vous utilisez des services tels qu'Amazon Data Firehose ou Amazon CloudWatch Logs pour diffuser des données vers le OpenSearch Service, vérifiez que ces services prennent en charge la version la plus récente de OpenSearch avant de procéder à la migration.

Chemins de mise à niveau pris en charge

Le OpenSearch Service prend actuellement en charge les chemins de mise à niveau suivants :

De la version Vers la version
OpenSearch 1,3 et 2. x ou 3. x

OpenSearch 3. x

Si vous utilisez la version OpenSearch 1.3 ou 2.x, vous devez d'abord passer à la version OpenSearch 2.19 avant de passer à la version 3.x. OpenSearch

Lors de la mise à niveau de la version OpenSearch 2.19 vers la version OpenSearch 3.x, vous devrez peut-être corriger les paramètres d'index incompatibles suivants. Ils étaient obsolètes plus tôt dans la version 2.x et entraîneront un échec de validation du contrôle de mise à niveau s'ils ne sont pas supprimés.

  • index.knn.algo_param.ef_construction

  • index.knn.algo_param.m

  • index.knn.space_type

  • index.store.hybrid.mmap.extensions

Pour plus d'informations sur les paramètres d'index obsolètes et les étapes à suivre pour les corriger, consultez la section Paramètres d'index. Pour une liste complète des modifications majeures apportées à la version OpenSearch 3.x, consultez la version https://docs.opensearch.org/latest/breaking-changes/#300 3.0.0.

Si votre domaine contient des index créés dans les versions OpenSearch 1.3, Elasticsearch 7.10 ou antérieures, vous devez les réindexer avant de passer à la version 3.x. OpenSearch OpenSearch 3.x ne prend pas en charge ces anciens index, qu'ils soient stockés à chaud ou à froid. UltraWarm Pour réindexer des index incompatibles UltraWarm ou froids, procédez comme suit :

  1. Migrez les index vers le stockage à chaud.

  2. Réindexez les données.

  3. Faites migrer les index vers un stockage à chaud ou à froid.

Vous pouvez également supprimer les index si vous n'en avez plus besoin.

Instantanés pris le OpenSearch 1. x et Elasticsearch 7.10 et les versions antérieures ne sont pas compatibles avec la version 3.x. OpenSearch

Pour les référentiels de snapshots manuels, supprimez ces snapshots incompatibles avant de passer à OpenSearch la version 3.x.
OpenSearch 1.3 ou 2. x

OpenSearch 2. x

OpenSearch 2.17 activera la recherche de segments simultanés par défaut avec le mode automatique si le domaine répond aux conditions suivantes :

  • Aucun paramètre de recherche simultané précédent n'est défini explicitement.

  • Toutes les instances de données (chaudes et chaudes) sont du type d'instance .2xl ou supérieur.

  • L'utilisation moyenne du processeur p90 sur les instances de données (chaudes et chaudes) pendant plus d'une semaine est inférieure à 45 %.

    Pour plus de détails sur les paramètres de recherche de segments simultanés ici, voir Recherche de segments simultanés.

La version 2.3 comporte les modifications majeures suivantes :

  • Le type paramètre a été supprimé de tous les points de terminaison de OpenSearch l'API dans la version 2.0. Pour plus d'informations, veuillez consulter la rubrique Modifications majeures (langue française non garantie).

  • Si votre domaine contient des index (chauds ou froids) créés à l'origine dans Elasticsearch 6.8, ces index ne sont pas compatibles avec la version 2.3. UltraWarm OpenSearch

    Avant de passer à la version 2.3, vous devez réindexer les index incompatibles. Pour les index incompatibles UltraWarm ou froids, faites-les migrer vers un stockage chaud, réindexez les données, puis refaites-les migrer vers un stockage chaud ou froid. Vous pouvez également supprimer les index si vous n'en avez plus besoin.

    Si vous mettez accidentellement à niveau votre domaine vers la version 2.3 sans effectuer ces étapes au préalable, vous ne pourrez pas migrer les index incompatibles hors de leur niveau de stockage actuel. Votre seule option est de les supprimer.
OpenSearch 1. x OpenSearch 1. x
Elasticsearch 7.x

Elasticsearch 7. x ou OpenSearch 1. x

Important

OpenSearch 1. x introduit de nombreux changements majeurs. Pour en savoir plus, consultez Changement de nom d'Amazon OpenSearch Service - Résumé des modifications.

Elasticsearch 6.8

Elasticsearch 7. x ou OpenSearch 1. x

Important

Elasticsearch 7.0 et OpenSearch 1.0 incluent de nombreuses modifications majeures. Avant de lancer une mise à niveau sur place, nous vous recommandons de prendre un instantané manuel du 6. domaine x, en le restaurant lors d'un test 7. x ou OpenSearch 1. domaine x, et utilisation de ce domaine de test pour identifier les problèmes de mise à niveau potentiels. Pour connaître les modifications apportées à la OpenSearch version 1.0, consultezChangement de nom d'Amazon OpenSearch Service - Résumé des modifications.

Comme Elasticsearch 6.x, les index ne peuvent contenir qu'un seul type de mappage, mais celui-ci doit désormais être nommé _doc. Par conséquent, certaines API n'ont plus besoin d'un type de mappage dans le corps de la demande (comme l'API _bulk).

Pour les nouveaux index, Elasticsearch 7 auto-hébergé. x et OpenSearch 1. x ont un nombre de partitions par défaut de un. OpenSearch Domaines de service sur Elasticsearch 7. x et versions ultérieures conservent la valeur par défaut précédente de cinq.

Elasticsearch 6.x

Elasticsearch 6.x
Elasticsearch 5.6

Elasticsearch 6.x

Important

Les index créés dans la version 6.x ne prennent plus en charge plusieurs types de mappages. Les index créés dans la version 5.x prennent toujours en charge plusieurs types de mappages lors de leur restauration dans un cluster 6.x. Vérifiez que votre code client ne crée qu'un seul type de mappage par index.

Pour minimiser les temps d'arrêt lors de la mise à niveau d'Elasticsearch 5.6 vers la version 6. x, OpenSearch Service réindexe l'.kibanaindex.kibana-6, le supprime.kibana, crée un alias nommé .kibana et mappe le nouvel index au nouvel alias.
Elasticsearch 5.x Elasticsearch 5.x

Le processus de mise à niveau comporte trois étapes :

  1. Pre-upgrade vérifications  : le OpenSearch service recherche les problèmes susceptibles de bloquer une mise à niveau et ne passe pas à l'étape suivante tant que ces vérifications n'aboutissent pas.

  2. Instantané  : le OpenSearch service prend un instantané du cluster Elasticsearch OpenSearch ou du cluster Elasticsearch et ne passe pas à l'étape suivante tant que l'instantané n'est pas réussi. Si la mise à niveau échoue, le OpenSearch Service utilise cet instantané pour restaurer l'état d'origine du cluster. Pour de plus amples informations, veuillez consulter Impossible de revenir à une version plus ancienne après la mise à niveau.

  3. Mise à niveau  : le OpenSearch service lance la mise à niveau, qui peut prendre de 15 minutes à plusieurs heures. OpenSearch Les tableaux de bord peuvent ne pas être disponibles pendant une partie ou la totalité de la mise à niveau.

Résolution des problèmes liés aux échecs de validation

Lorsque vous lancez une mise à niveau OpenSearch ou une mise à niveau de la version d'Elasticsearch, OpenSearch Service effectue d'abord une série de contrôles de validation pour s'assurer que votre domaine est éligible à une mise à niveau. Si l'un de ces contrôles échoue, vous recevez une notification contenant les problèmes spécifiques que vous devez résoudre avant de mettre à niveau votre domaine. Pour obtenir la liste des problèmes potentiels et les étapes à suivre pour les résoudre, consultez Résolution des erreurs de validation.

Dépannage d'une mise à niveau

In-place les mises à niveau nécessitent des domaines sains. Votre domaine peut être inéligible pour une mise à niveau ou peut échouer à effectuer une mise à niveau pour une multitude de raisons. Le tableau suivant indique les problèmes les plus courants.

Problème Description
Plugin optionnel non pris en charge

Lorsque vous mettez à niveau un domaine avec des plugins facultatifs, le OpenSearch Service met également automatiquement à niveau les plugins. Par conséquent, la version cible de votre domaine doit également prendre en charge ces plugins facultatifs. Si un plug-in optionnel installé sur le domaine n'est pas disponible pour la version cible, la demande de mise à niveau échoue.
Trop de partitions par nœud OpenSearch, ainsi que 7. Les versions x d'Elasticsearch ont un paramètre par défaut ne dépassant pas 1 000 partitions par nœud. Si un nœud de votre cluster actuel dépasse ce paramètre, OpenSearch Service ne vous autorise pas à effectuer la mise à niveau. Consultez Limite maximale de partitions dépassée pour les options de dépannage.
Domaine en cours de traitement Un changement de configuration est actuellement en cours pour le domaine. Une fois l'opération terminée, vérifiez l'éligibilité pour la mise à niveau.
Statut de cluster rouge Un ou plusieurs index dans le cluster sont rouges. Pour obtenir les étapes de dépannage, consultez Statut de cluster rouge.
Taux d'erreur élevé Le cluster renvoie un grand nombre d'erreurs 5xx lors de sa tentative de traitement des demandes. Ce problème est généralement dû à un trop grand nombre de demandes simultanées de lecture ou d'écriture. Envisagez de réduire le trafic vers le cluster ou de redimensionner votre domaine.
Split-Brain Split-Brain signifie que votre cluster possède plusieurs nœuds principaux et s'est scindé en deux clusters qui ne refusionneront jamais d'eux-mêmes. Vous pouvez éviter le problème Split-Brain en utilisant le nombre recommandé de nœuds principaux dédiés. Pour obtenir de l'aide afin de résoudre le problème Split-Brain, contactez Support.
Nœud principal introuvable OpenSearch Le service ne trouve pas le nœud principal du cluster. Si votre domaine utilise multi-AZ, il se peut qu'un échec de zones de disponibilité ait entraîné la perte du quorum par le cluster, empêchant ainsi ce dernier de choisir un nouveau nœud principal. Si le problème ne se résout pas automatiquement, contactez Support.
Trop de tâches en attente Le nœud principal est soumis à une charge importante et a de nombreuses tâches en attente. Envisagez de réduire le trafic vers le cluster ou de redimensionner votre domaine.
Volume de stockage défaillant Le volume de disque d'un ou plusieurs nœuds ne fonctionne pas correctement. Ce problème se produit souvent parallèlement à d'autres problèmes, comme un taux d'erreur élevé ou un trop grand nombre de tâches en attente. Si ce problème est isolé et ne se résout pas automatiquement, contactez Support.
Problème lié à la clé KMS La clé KMS utilisée pour chiffrer le domaine est inaccessible ou manquante. Pour plus d'informations, consultez Surveillance des domaines qui chiffrent les données au repos.
Instantané en cours Le domaine prend actuellement un instantané. Une fois l'instantané pris, vérifiez l'éligibilité pour la mise à niveau. Vérifiez également que vous pouvez lister les référentiels d'instantanés manuels, lister les instantanés dans ces référentiels et prendre des instantanés manuels. Si le OpenSearch Service n'est pas en mesure de vérifier si un snapshot est en cours, les mises à niveau peuvent échouer.
Délai d'expiration ou échec de l'instantané La création de l'instantané avant la mise à niveau a été trop longue ou a échoué. Vérifiez l'état du cluster et réessayez. Si le problème persiste, contactez Support.
Index incompatibles Une ou plusieurs index sont incompatibles avec la version cible. Ce problème peut survenir si vous avez migré les index depuis une ancienne version d' OpenSearch Elasticsearch. Réindexez les index et réessayez.
Utilisation du disque élevée L'utilisation du disque pour le cluster est supérieure à 90 %. Supprimez des données ou redimensionnez le domaine, puis réessayez.
Utilisation JVM élevée La sollicitation de mémoire JVM est supérieure à 75 %. Réduisez le trafic vers le cluster ou redimensionnez le domaine, puis réessayez.
OpenSearch Problème d'alias dans les tableaux de bord .dashboardsest déjà configuré en tant qu'alias et correspond à un index incompatible, probablement issu d'une version antérieure de OpenSearch Dashboards. Réindexez et réessayez.
Statut de Dashboards rouge OpenSearch L'état des tableaux de bord est rouge. Essayez d'utiliser Dashboards une fois la mise à niveau terminée. Si le statut rouge persiste, résolvez-le manuellement, puis réessayez.
Cross-cluster compatibilité

Vous pouvez uniquement effectuer la mise à niveau si, après cette dernière, la compatibilité inter-clusters est maintenue entre les domaines source et destination. Au cours du processus de mise à niveau, toutes les connexions incompatibles sont identifiées. Ensuite, mettez à niveau le domaine distant ou supprimez les connexions incompatibles. Notez que si la réplication est active sur le domaine, vous ne pouvez pas la reprendre une fois la connexion supprimée.

Autre problème de OpenSearch service Des problèmes liés OpenSearch au service lui-même peuvent entraîner l'affichage de votre domaine comme non éligible à une mise à niveau. Si aucune des conditions précédentes ne s'applique à votre domaine et que le problème persiste pendant plus d'une journée, contactez Support.