Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Actualización de los dominios OpenSearch de Amazon Service
<a name="version-migration"></a>

**nota**  
OpenSearch y las actualizaciones de la versión de Elasticsearch son diferentes de las actualizaciones del software del servicio. Para obtener información sobre cómo actualizar el software de servicio para su dominio OpenSearch de servicio, consulte. [Actualizaciones de software de servicio en Amazon OpenSearch Service](service-software.md)

Amazon OpenSearch Service ofrece actualizaciones locales para dominios que ejecutan la OpenSearch versión 1.0 o una versión posterior, o Elasticsearch 5.1 o una versión posterior. Si utilizas servicios como Amazon Data Firehose o Amazon CloudWatch Logs para transmitir datos a OpenSearch Service, comprueba que estos servicios sean compatibles con la versión más reciente de OpenSearch antes de realizar la migración.

## Rutas de actualización admitidas
<a name="supported-upgrade-paths"></a>

Actualmente, el OpenSearch servicio admite las siguientes rutas de actualización:


| Desde la versión | Hasta la versión | 
| --- | --- | 
| OpenSearch 1.3, 2. x o 3. x |  OpenSearch 3. *x* Si está ejecutando OpenSearch 1.3 o 2.x, primero debe actualizar a la OpenSearch 2.19 *antes* de actualizar a la 3.x. OpenSearch Al actualizar de la versión OpenSearch 2.19 a la OpenSearch 3.x, es posible que tengas 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. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/opensearch-service/latest/developerguide/version-migration.html) Para obtener más información sobre la configuración de índice obsoleta y los pasos para corregirla, consulte [Configuración de índices.](https://docs.opensearch.org/2.6/search-plugins/knn/knn-index/#index-settings) [Para ver una lista completa de los cambios más importantes de la versión OpenSearch 3.x, consulte la sección 3.0.0.](https://docs.opensearch.org/latest/breaking-changes/#300) Si tu dominio contiene índices creados en OpenSearch 1.3, Elasticsearch 7.10 o versiones anteriores, debes volver a indexarlos antes de actualizar a la versión 3.x. OpenSearch OpenSearch La versión 3.x no admite estos índices antiguos, independientemente de si están almacenados en caliente o en frío. UltraWarm Para volver a indexar índices incompatibles UltraWarm o inactivos: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/opensearch-service/latest/developerguide/version-migration.html) Como alternativa, elimine los índices si ya no los necesita.  | 
| 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: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/opensearch-service/latest/developerguide/version-migration.html) El control de versiones 2.3 incluye los siguientes cambios importantes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/opensearch-service/latest/developerguide/version-migration.html)  | 
| OpenSearch 1. x | OpenSearch 1. x | 
| Elasticsearch 7.x |  Elasticsearch 7. *x o 1*. OpenSearch *x*  OpenSearch 1. *x* introduce numerosos cambios importantes. Para obtener más información, consulte [Cambio OpenSearch de nombre de Amazon Service: resumen de los cambios](rename.md).   | 
|  Elasticsearch 6.8  |  Elasticsearch 7. *x o 1*. OpenSearch *x*  Elasticsearch 7.0 y OpenSearch 1.0 incluyen numerosos cambios importantes. Antes de iniciar una actualización local, recomendamos [realizar una instantánea manual](managedomains-snapshots.md) de la versión 6. *x* dominio, restaurándolo en una prueba 7. *x* o OpenSearch 1. dominio *x* y usar ese dominio de prueba para identificar posibles problemas de actualización. Para ver los cambios más importantes en la OpenSearch versión 1.0, consulte[Cambio OpenSearch de nombre de Amazon Service: resumen de los cambios](rename.md). Al igual que Elasticsearch 6.*x*, los índices solo pueden contener un tipo de mapeo, pero ese tipo debe denominarse `_doc`. Como resultado, algunos ya APIs no requieren un tipo de mapeo en el cuerpo de la solicitud (como la `_bulk` API). Para los índices nuevos, Elasticsearch 7 se hospedó automáticamente. *x y 1.* OpenSearch *x* tienen un recuento de fragmentos predeterminado de uno. OpenSearch Dominios de servicio en Elasticsearch 7. *x* y las versiones posteriores conservan el valor predeterminado anterior de cinco.   | 
| Elasticsearch 6.*x* | Elasticsearch 6.*x* | 
| Elasticsearch 5.6 |  Elasticsearch 6.*x*  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 la actualización de Elasticsearch 5.6 a 6. *x*, OpenSearch Service vuelve a indexar el `.kibana` índice, lo elimina `.kibana-6``.kibana`, crea un nombre `.kibana` de alias 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 previas a la actualización**: el OpenSearch servicio comprueba si hay problemas que puedan bloquear una actualización y no pasa al siguiente paso a menos que estas comprobaciones se realicen correctamente.

1. **Instantánea**: el OpenSearch servicio toma una instantánea del clúster OpenSearch o del clúster de Elasticsearch y no pasa al siguiente paso a menos que la instantánea se realice correctamente. Si se produce un error en la actualización, OpenSearch Service usa esta instantánea para restaurar el clúster a su estado original. Para obtener más información, consulte [No se puede cambiar a una versión anterior después de una actualización](handling-errors.md#troubleshooting-upgrade-snapshot).

1. **Actualización**: el OpenSearch servicio inicia la actualización, que puede tardar entre 15 minutos y varias horas en completarse. OpenSearch Es posible que los paneles no estén disponibles durante parte de la actualización o durante toda la actualización.

# Actualización de un dominio (consola)
<a name="starting-upgrades"></a>

El proceso de actualización es irreversible y no se puede pausar ni cancelar. Durante una actualización no puede realizar cambios de configuración en el dominio. Antes de comenzar una actualización, compruebe que desea continuar. Puede utilizar estos mismos pasos para realizar la verificación de actualización sin iniciar realmente una actualización.

Si el clúster tiene nodos maestros dedicados, OpenSearch las actualizaciones se completan sin tiempo de inactividad. De lo contrario, el clúster podría no responder durante varios segundos después de la actualización mientras elige un nodo maestro.

**Para actualizar un dominio a una versión posterior de OpenSearch Elasticsearch**

1. [Tome una instantánea manual](managedomains-snapshots.md) de su dominio. Esta instantánea sirve como copia de seguridad que puede [restaurar en un dominio nuevo](managedomains-snapshot-restore.md) si desea volver a usar la versión anterior OpenSearch .

1. Ve a **Iniciar sesión en la consola [https://aws.amazon.com](https://console.aws.amazon.com/)y selecciona Iniciar sesión**.

1. En **Analytics**, selecciona **Amazon OpenSearch Service**.

1. En el panel de navegación, en **Dominios**, seleccione el dominio que desea actualizar.

1. Seleccione **Acciones** y **Actualizar**.

1. Seleccione la version a la que actualizar. Si vas a actualizar a una OpenSearch versión, **aparecerá la opción Habilitar el modo de compatibilidad**. Si habilitas esta configuración, indicará que OpenSearch su versión es 7.10 para permitir que los clientes y complementos de Elasticsearch OSS, como Logstash, sigan funcionando con Amazon Service. OpenSearch Podrá desactivar esta configuración más tarde

1. Seleccione **Actualizar**.

1. Verifique el **Estado** en el panel del dominio para monitorear el estado de la actualización.

# Actualización de un dominio (CLI)
<a name="starting-upgrades-cli"></a>

Puedes usar las siguientes operaciones para identificar la versión correcta de OpenSearch Elasticsearch para tu dominio, iniciar una actualización inmediata, realizar la comprobación previa a la actualización y ver el progreso:
+ `get-compatible-versions` (`GetCompatibleVersions`)
+ `upgrade-domain` (`UpgradeDomain`)
+ `get-upgrade-status` (`GetUpgradeStatus`)
+ `get-upgrade-history` (`GetUpgradeHistory`)

Para obtener más información, consulta la referencia de [comandos de AWS CLI y la referencia](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/opensearch/index.html) de la [API de Amazon OpenSearch Service](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/Welcome.html).

# Actualización de un dominio (SDK)
<a name="starting-upgrades-sdk"></a>

En este ejemplo, se utiliza el cliente Python de [OpenSearchService](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/opensearch.html)bajo nivel del AWS SDK para Python (Boto) para comprobar si un dominio es apto para la actualización a una versión específica, lo actualiza y comprueba continuamente el estado de la actualización.

```
import boto3
from botocore.config import Config
import time

# Build the client using the default credential configuration.
# You can use the CLI and run 'aws configure' to set access key, secret
# key, and default Region.

DOMAIN_NAME = ''  # The name of the domain to upgrade
TARGET_VERSION = ''  # The version you want to upgrade the domain to. For example, OpenSearch_1.1

my_config = Config(
    # Optionally lets you specify a Region other than your default.
    region_name='us-east-1'
)
client = boto3.client('opensearch', config=my_config)


def check_versions():
    """Determine whether domain is eligible for upgrade"""
    response = client.get_compatible_versions(
        DomainName=DOMAIN_NAME
    )
    compatible_versions = response['CompatibleVersions']
    for i in range(len(compatible_versions)):
        if TARGET_VERSION in compatible_versions[i]["TargetVersions"]:
            print('Domain is eligible for upgrade to ' + TARGET_VERSION)
            upgrade_domain()
            print(response)
        else:
            print('Domain not eligible for upgrade to ' + TARGET_VERSION)


def upgrade_domain():
    """Upgrades the domain"""
    response = client.upgrade_domain(
        DomainName=DOMAIN_NAME,
        TargetVersion=TARGET_VERSION
    )
    print('Upgrading domain to ' + TARGET_VERSION + '...' + response)
    time.sleep(5)
    wait_for_upgrade()


def wait_for_upgrade():
    """Get the status of the upgrade"""
    response = client.get_upgrade_status(
        DomainName=DOMAIN_NAME
    )
    if (response['UpgradeStep']) == 'UPGRADE' and (response['StepStatus']) == 'SUCCEEDED':
        print('Domain successfully upgraded to ' + TARGET_VERSION)
    elif (response['StepStatus']) == 'FAILED':
        print('Upgrade failed. Please try again.')
    elif (response['StepStatus']) == 'SUCCEEDED_WITH_ISSUES':
        print('Upgrade succeeded with issues')
    elif (response['StepStatus']) == 'IN_PROGRESS':
        time.sleep(30)
        wait_for_upgrade()


def main():
    check_versions()


if __name__ == "__main__":
    main()
```

## Solución de errores de validación
<a name="upgrade-validation"></a>

Cuando inicias una actualización de una versión OpenSearch o de Elasticsearch, OpenSearch Service primero realiza una serie de comprobaciones de validación para garantizar que tu dominio sea 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](managedomains-configuration-changes.md#validation).

## Solución de problemas de una actualización
<a name="upgrade-failures"></a>

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 | Description (Descripción) | 
| --- | --- | 
| No se admite el complemento opcional |  Cuando actualizas 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, así como 7. x versiones de Elasticsearch, tienen una configuración predeterminada de no más de 1000 particiones por nodo. Si un nodo de tu clúster actual supera esta configuración, el OpenSearch servicio no te permite realizar la actualización. Consulte [Límite máximo de fragmentos superado](handling-errors.md#troubleshooting-shard-limit) 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](handling-errors.md#handling-errors-red-cluster-status). | 
| 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](managedomains-dedicatedmasternodes.md). Para obtener ayuda a fin de recuperar un cerebro dividido, póngase en contacto con [Soporte](https://console.aws.amazon.com/support/home). | 
| Nodo maestro no encontrado | OpenSearch El servicio no encuentra el nodo principal del clúster. Si el dominio utiliza [Multi-AZ](managedomains-multiaz.md), 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](managedomains-dedicatedmasternodes.md). Si el problema no se resuelve por sí solo, póngase en contacto con [Soporte](https://console.aws.amazon.com/support/home). | 
| 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](https://console.aws.amazon.com/support/home). | 
| 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](encryption-at-rest.md#monitoring-ear). | 
| 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 el OpenSearch servicio no puede comprobar si una instantánea está en curso, las actualizaciones pueden fallar. | 
| 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](https://console.aws.amazon.com/support/home). | 
| Índices incompatibles | Uno o varios índices son incompatibles con la versión de destino. Este problema puede producirse si migraste los índices desde una versión anterior de OpenSearch 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. | 
| OpenSearch Problema con el alias de los paneles | .dashboardsya 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 | OpenSearch El estado del panel 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 con OpenSearch el servicio | Los problemas con el propio OpenSearch Servicio pueden hacer que tu dominio aparezca como no apto para 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](https://console.aws.amazon.com/support/home). | 

# Uso de una instantánea para migrar datos
<a name="snapshot-based-migration"></a>

Las actualizaciones locales son la forma más fácil, rápida y confiable de actualizar un dominio a una versión posterior OpenSearch o a una versión de Elasticsearch. Las instantáneas son una buena opción si tiene que migrar de una versión previa a la 5.1 de Elasticsearch o si desea migrar a un clúster totalmente nuevo.

La siguiente tabla muestra cómo usar las instantáneas para migrar datos a un dominio que usa una versión diferente OpenSearch o de Elasticsearch. Para obtener información sobre cómo tomar instantáneas y restaurarlas, consulte [Creación de instantáneas de índices en Amazon Service OpenSearch](managedomains-snapshots.md).


| Desde la versión | Hasta la versión | Proceso de migración | 
| --- | --- | --- | 
| OpenSearch 1.3 o 2. x | OpenSearch 2. x |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/opensearch-service/latest/developerguide/snapshot-based-migration.html)  | 
| OpenSearch 1. x | OpenSearch 1. x |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/opensearch-service/latest/developerguide/snapshot-based-migration.html)  | 
| Elasticsearch 6.x o 7.x | OpenSearch 1. x |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/opensearch-service/latest/developerguide/snapshot-based-migration.html)  | 
| Elasticsearch 6.x | Elasticsearch 7.x |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/opensearch-service/latest/developerguide/snapshot-based-migration.html)  | 
| Elasticsearch 6.x | Elasticsearch 6.8 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/opensearch-service/latest/developerguide/snapshot-based-migration.html)  | 
| Elasticsearch 5.x | Elasticsearch 6.x |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/opensearch-service/latest/developerguide/snapshot-based-migration.html)  | 
| Elasticsearch 5.x | Elasticsearch 5.6 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/opensearch-service/latest/developerguide/snapshot-based-migration.html)  | 
| Elasticsearch 2.3 | Elasticsearch 6.x |  Las instantáneas de Elasticsearch 2.3 no son compatibles con la versión 6.*x*. Para migrar sus datos directamente de la versión 2.3 a 6.*x*, debe volver a crear manualmente sus índices en el nuevo dominio. Como alternativa, puede seguir los pasos del cambio de la versión 2.3 a 5.*x* de esta tabla, realizar las operaciones de `_reindex` en el nuevo dominio 5.*x* para convertir sus índices 2.3 en índices 5.*x* y después seguir los pasos del cambio de la versión 5.*x* a 6.*x*.  | 
| Elasticsearch 2.3 | Elasticsearch 5.x |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/opensearch-service/latest/developerguide/snapshot-based-migration.html)  | 
| Elasticsearch 1.5 | Elasticsearch 5.x |  Las instantáneas de Elasticsearch 1.5 no son compatibles con la versión 5.*x*. Para migrar sus datos de la versión 1.5 a 5.*x*, debe volver a crear manualmente sus índices en el nuevo dominio.  *Las instantáneas de la versión 1.5 son* compatibles con la versión 2.3, pero los dominios del OpenSearch Servicio 2.3 no admiten esta operación. `_reindex` Dado que no puede reindexarlos, los índices que se originaron en un dominio 1.5 siguen sin restaurar instantáneas de 2.3 a dominios 5*x*.   | 
| Elasticsearch 1.5 | Elasticsearch 2.3 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/opensearch-service/latest/developerguide/snapshot-based-migration.html)  |