Actualización de los dominios de Amazon OpenSearch Service - Amazon OpenSearch Service
Rutas de actualización admitidasSolución de errores de validaciónSolución de problemas de una actualización

Actualización de los dominios de Amazon OpenSearch Service

nota

Las actualizaciones de la versión de Elasticsearch se diferencian de las actualizaciones del software de servicio. Para obtener información acerca de cómo actualizar el software del servicio de su dominio de OpenSearch Service, consulte Actualizaciones del software de servicio en Amazon OpenSearch Service.

Amazon OpenSearch Service ofrece actualizaciones de locales para los dominios que ejecutan OpenSearch 1.0 o posterior, o Elasticsearch 5.1 o posterior. Si utiliza servicios como Amazon Data Firehose o Registros de Amazon CloudWatch para transmitir datos a OpenSearch Service, compruebe que estos servicios admitan la versión más reciente de OpenSearch antes de la migración.

Rutas de actualización admitidas

OpenSearch Service admite actualmente las siguientes rutas de actualización:

Desde la versión Hasta la versión
OpenSearch 1.3 o 2.x

OpenSearch 3.1

Si está ejecutando OpenSearch 1.3 o 2.x, primero debe actualizar a OpenSearch 2.19 antes de actualizar a OpenSearch 3.1. Posteriormente, cuando actualice de OpenSearch 2.19 a OpenSearch 3.1, es posible que tenga que corregir las siguientes configuraciones de índice incompatibles. Quedaron en desuso a principios de la versión 2.x y, si no se eliminan, provocarán un error en la validación de la comprobación de la actualización.

  • index.knn.algo_param.ef_construction

  • index.knn.algo_param.m

  • index.knn.space_type

  • index.store.hybrid.mmap.extensions

Para obtener más información sobre la configuración de índice obsoleta y los pasos para corregirla, consulte Configuración de índices. Para obtener una lista completa de los cambios más importantes de OpenSearch 3.1, consulte la sección 3.0.0.
OpenSearch 1.3 o 2.x

OpenSearch 2.x

OpenSearch 2.17 habilitará la búsqueda simultánea de segmentos de forma predeterminada con el modo automático si el dominio cumple las siguientes condiciones:

  • No se ha establecido explícitamente ninguna configuración de búsqueda simultánea previa.

  • Todas las instancias de datos (calientes y cálidos) son del tipo 2.xl o superior.

  • El uso medio de la CPU p90 en las instancias de datos (calientes y cálidos) durante más de una semana es inferior al 45 %.

    Para obtener más información sobre la configuración de búsqueda de segmentos simultáneos aquí, consulte Búsqueda de segmentos simultáneos.

El control de versiones 2.3 incluye los siguientes cambios importantes:

  • Este parámetro type se eliminó de todos los puntos de conexión de la API OpenSearch en el control de versiones 2.0. Para más información, consulte Cambios bruscos.

  • Si su dominio contiene algún índice (almacenado en caliente, UltraWarm o frío) que se haya creado originalmente en Elasticsearch 6.8, esos índices no son compatibles con OpenSearch 2.3.

    Antes de actualizar a la versión 2.3, debe volver a indexar los índices incompatibles. En el caso de índices UltraWarm o frío incompatibles, migre a un almacenamiento en caliente, vuelva a indexar los datos y, a continuación, vuelva a migrarlos a un almacenamiento en caliente o frío. También puede quitar índices si ya no los necesita.

    Si actualiza accidentalmente su dominio al control de versiones 2.3 sin realizar primero estos pasos, no podrá migrar los índices incompatibles fuera de su nivel de almacenamiento actual. La única opción es eliminarlos.
OpenSearch 1.x OpenSearch 1.x
Elasticsearch 7.x

Elasticsearch 7.x u OpenSearch 1.x

importante

OpenSearch 1.x presenta muchos cambios importantes. Para más información, consulte Cambio de nombre de Amazon OpenSearch Service: resumen de cambios.

Elasticsearch 6.8

Elasticsearch 7.x u OpenSearch 1.x

importante

Elasticsearch 7.0 y OpenSearch 1.0 incluyen numerosos cambios de ruptura. Antes de iniciar una actualización in situ, se recomienda tomar una instantánea manual del dominio 6.x, restaurarla en un dominio 7.x de prueba o de OpenSearch 1.x y utilizar ese dominio de prueba para identificar posibles problemas de actualización. Para ver los cambios importantes en OpenSearch 1.0, consulte Cambio de nombre de Amazon OpenSearch Service: resumen de cambios.

Al igual que Elasticsearch 6.x, los índices solo pueden contener un tipo de mapeo, pero ese tipo debe denominarse _doc. Como resultado, determinadas API ya no requieren un tipo de mapeo en el cuerpo de la solicitud (como, por ejemplo, la API _bulk).

Para nuevos índices, Elasticsearch 7.x y OpenSearch 1.x de alojamiento propio tienen un recuento de particiones predeterminado de uno. Los dominios de OpenSearch Service en Elasticsearch 7.x y posteriores conservan el valor predeterminado anterior de cinco.

Elasticsearch 6.x

Elasticsearch 6.x
Elasticsearch 5.6

Elasticsearch 6.x

importante

Los índices creados en la versión 6.x ya no admiten varios tipos de mapeo. Los índices creados en la versión 5.x siguen admitiendo varios tipos de mapeo cuando se restauran en un clúster 6.x. Compruebe que el código de cliente solo cree un único tipo de mapeo por índice.

Para minimizar el tiempo de inactividad durante el actualización de Elasticsearch 5.6 a 6.x, OpenSearch Service reindexa el índice .kibana a .kibana-6, elimina .kibana, crea un alias denominado .kibana y asigna el nuevo índice al nuevo alias.
Elasticsearch 5.x Elasticsearch 5.x

El proceso de actualización consta de tres pasos:

  1. Comprobaciones de preactualizuación: OpenSearch Service realiza comprobaciones para detectar problemas que puedan bloquear una actualización y evitar continuar con el siguiente paso a menos que estas comprobaciones sean satisfactorias.

  2. Instantánea: OpenSearch Service toma una instantánea del clúster de OpenSearch o Elasticsearch y no continúa con el siguiente paso a menos que la instantánea se realice satisfactoriamente. Si se produce un error en la actualización, OpenSearch Service utiliza esta instantánea para restaurar el clúster a su estado original. Para más información, consulte No se puede cambiar a una versión anterior después de una actualización.

  3. Actualización: OpenSearch Service comienza la actualización, lo cual puede tardar en completarse de 15 minutos a varias horas. OpenSearch Dashboards podría no estar disponible durante parte o la totalidad de la actualización.

Solución de errores de validación

Al iniciar una de versión de OpenSearch o Elasticsearch, OpenSearch Service primero lleva a cabo una serie de comprobaciones de validación para garantizar que el dominio es apto para una actualización. Si se produce un error en alguna de estas comprobaciones, recibirá una notificación con los problemas específicos que debe corregir antes de actualizar su dominio. Para obtener una lista de posibles problemas y los pasos para resolverlos, consulte Solución de errores de validación.

Solución de problemas de una actualización

Las actualizaciones locales requieren dominios en buen estado. Es posible que su dominio no pueda optar por una actualización o que no se actualice por diversas razones. La siguiente tabla muestra los problemas más comunes.

Problema Descripción
No se admite el complemento opcional

Cuando actualiza un dominio con complementos opcionales, OpenSearch Service también actualiza automáticamente los complementos. Por lo tanto, la versión de destino de su dominio también debe admitir estos complementos opcionales. Si el dominio tiene instalado un complemento opcional que no está disponible para la versión de destino, se produce un error en la solicitud de actualización.
Demasiadas particiones por nodo OpenSearch y las versiones 7.x de Elasticsearch tienen una configuración predeterminada de no más de 1000 particiones por nodo. Si un nodo del clúster actual supera esta configuración, OpenSearch Service no le permite actualizar. Consulte Límite máximo de fragmentos superado para obtener opciones de solución de problemas.
Dominio en procesamiento El dominio está en medio de un cambio de configuración. Compruebe si es posible optar a la actualización una vez que se complete la operación.
Estado rojo del clúster Uno o varios índices en el clúster aparecen en rojo. Para ver los pasos de solución de problemas, consulte Estado rojo del clúster.
Tasa de errores alta El clúster devuelve un gran número de errores 5xx al intentar procesar solicitudes. Este problema suele ser el resultado de demasiadas solicitudes de lectura o escritura simultáneas. Considere la posibilidad de reducir el tráfico hacia el clúster o el escalado del dominio.
Cerebro dividido Cerebro dividido significa que el clúster tiene más de un nodo maestro y se ha dividido en dos clústeres que nunca se volverán a unir por sí mismos. Puede evitar un cerebro dividido con el número recomendado de nodos maestros dedicados. Para obtener ayuda a fin de recuperar un cerebro dividido, póngase en contacto con Soporte.
Nodo maestro no encontrado OpenSearch Service no puede encontrar el nodo maestro del clúster. Si el dominio utiliza Multi-AZ, es posible que un error de una zona de disponibilidad haya hecho que el clúster pierda el quorum y no pueda elegir un nuevo nodo maestro. Si el problema no se resuelve por sí solo, póngase en contacto con Soporte.
Demasiadas tareas pendientes El nodo maestro está bajo una gran carga y tiene muchas tareas pendientes. Considere la posibilidad de reducir el tráfico hacia el clúster o el escalado del dominio.
Volumen de almacenamiento dañado El volumen de disco de uno o más nodos no funciona correctamente. Este problema a menudo ocurre junto con otros problemas, como una alta tasa de error o demasiadas tareas pendientes. Si se produce aisladamente y no se resuelve por sí solo, póngase en contacto con Soporte.
Problema de clave de KMS La clave de KMS que se utiliza para cifrar el dominio está inaccesible o no está. Para más información, consulte Monitorear dominios que cifran los datos en reposo.
Snapshot en proceso de creación El dominio está tomando una instantánea en este momento. Compruebe si es posible optar a la actualización una vez que se complete la instantánea. Compruebe también si puede hacer una lista de los repositorios de instantáneas manuales, una lista de instantáneas dentro de dichos repositorios y tomar instantáneas manuales. Si OpenSearch Service no puede comprobar si se está realizando una instantánea, las actualizaciones puede generar errores.
Error en instantánea o tiempo de espera agotado La instantánea previa a la actualización ha tardado demasiado tiempo en completarse o ha generado un error. Compruebe el estado del clúster y vuelva a intentarlo. Si el problema sigue sin resolverse, póngase en contacto con Soporte.
Índices incompatibles Uno o varios índices son incompatibles con la versión de destino. Este problema puede ocurrir si migró los índices desde una versión anterior de OpenSearch o Elasticsearch. Reindexe los índices e inténtelo de nuevo.
Alto uso del disco El uso del disco para el clúster es superior al 90 %. Elimine los datos o escale el dominio, e inténtelo de nuevo.
Alto uso de JVM La presión de memoria de JVM es superior al 75 %. Reduzca el tráfico hacia el clúster o amplíe el dominio, e inténtelo de nuevo.
Problema de alias de OpenSearch Dashboards .dashboards ya está configurado como un alias y se asigna a un índice incompatible, probablemente uno de una versión anterior de OpenSearch Dashboards. Reindexe e inténtelo de nuevo.
Estado rojo de Dashboards El estado de OpenSearch Dashboards es rojo. Intente utilizar Dashboards cuando se complete la actualización. Si el estado rojo persiste, resuélvalo manualmente, e inténtelo de nuevo.
Compatibilidad entre clústeres

Solo puede actualizar si se mantiene la compatibilidad entre clústeres entre los dominios de origen y destino después de la actualización. Durante el proceso de actualización, se identifican las conexiones incompatibles. Para continuar, actualice el dominio remoto o elimine las conexiones incompatibles. Tenga en cuenta que si la replicación está activa en el dominio, no podrá reanudarla una vez que elimine la conexión.

Otro problema de servicio de OpenSearch Service Los problemas con OpenSearch Service en sí pueden hacer que el dominio no pueda optar a una actualización. Si a su dominio no se aplica ninguna de las condiciones anteriores y el problema persiste durante más de un día, póngase en contacto con Soporte.