As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Atualizando domínios do Amazon OpenSearch Service
<a name="version-migration"></a>

**nota**  
OpenSearch e as atualizações de versão do Elasticsearch diferem das atualizações do software de serviço. Para obter informações sobre como atualizar o software de serviço para seu domínio OpenSearch de serviço, consulte[Atualizações do software de serviço no Amazon OpenSearch Service](service-software.md).

O Amazon OpenSearch Service oferece atualizações no local para domínios que executam OpenSearch 1.0 ou posterior, ou Elasticsearch 5.1 ou posterior. Se você usa serviços como Amazon Data Firehose ou Amazon CloudWatch Logs para transmitir dados para o OpenSearch Service, verifique se esses serviços são compatíveis com a versão mais recente do antes de OpenSearch migrar.

## Caminhos de atualização com suporte
<a name="supported-upgrade-paths"></a>

Atualmente, o OpenSearch Service oferece suporte aos seguintes caminhos de atualização:


| Da versão | Para a versão | 
| --- | --- | 
| OpenSearch 1.3, 2. x ou 3. x |  OpenSearch 3. *x* Se você estiver executando OpenSearch 1.3 ou 2.x, você deve primeiro atualizar para OpenSearch 2.19 *antes* de atualizar para 3.x. OpenSearch Ao atualizar da versão OpenSearch 2.19 para a OpenSearch 3.x, talvez seja necessário resolver as seguintes configurações de índice incompatíveis. Elas se tornaram obsoletas na versão 2.x e causarão uma falha na validação da verificação de atualização se não forem removidas. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/opensearch-service/latest/developerguide/version-migration.html) Para saber mais sobre configurações de índice obsoletas e etapas para corrigi-las, consulte [Configurações de índice](https://docs.opensearch.org/2.6/search-plugins/knn/knn-index/#index-settings). Para obter uma lista completa das alterações mais importantes da OpenSearch versão 3.x, consulte [3.0.0](https://docs.opensearch.org/latest/breaking-changes/#300). Se o seu domínio contém índices criados em OpenSearch 1.3, Elasticsearch 7.10 ou versões anteriores, você deve reindexá-los antes de atualizar para 3.x. OpenSearch OpenSearch O 3.x não é compatível com esses índices mais antigos, independentemente de estarem em armazenamento quente ou frio. UltraWarm Para reindexar índices incompatíveis UltraWarm ou frios: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/opensearch-service/latest/developerguide/version-migration.html) Como alternativa, exclua os índices se você não precisar mais deles.  | 
| OpenSearch 1.3 ou 2. x |  OpenSearch 2. *x* OpenSearch 2.17 habilitará a pesquisa simultânea de segmentos por padrão com o modo automático se o domínio atender às seguintes condições: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/opensearch-service/latest/developerguide/version-migration.html) A versão 2.3 tem as seguintes alterações importantes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/opensearch-service/latest/developerguide/version-migration.html)  | 
| OpenSearch 1. x | OpenSearch 1. x | 
| Elasticsearch 7.x |  Elasticsearch 7. *x* ou OpenSearch 1. *x*  OpenSearch 1. *x* introduz várias mudanças significativas. Para obter detalhes, consulte [Renomeação do Amazon OpenSearch Service - Resumo das alterações](rename.md).   | 
|  Elasticsearch 6.8  |  Elasticsearch 7. *x* ou OpenSearch 1. *x*  O Elasticsearch 7.0 e OpenSearch 1.0 incluem várias mudanças importantes. Antes de iniciar uma atualização no local, recomendamos [tirar um instantâneo manual do 6](managedomains-snapshots.md). domínio *x*, restaurando-o em um teste 7. *x* ou OpenSearch 1. domínio *x* e usando esse domínio de teste para identificar possíveis problemas de atualização. Para alterações significativas na OpenSearch versão 1.0, consulte[Renomeação do Amazon OpenSearch Service - Resumo das alterações](rename.md). Assim como o Elasticsearch 6.*x*, os índices só podem conter um tipo de mapeamento, mas esse tipo agora deve ser chamado de `_doc`. Como resultado, alguns APIs não exigem mais um tipo de mapeamento no corpo da solicitação (como a `_bulk` API). Para novos índices, o Elasticsearch 7 auto-hospedado. *x* e OpenSearch 1. *x* têm uma contagem de fragmentos padrão de um. OpenSearch Domínios de serviço no Elasticsearch 7. *x* e posteriores mantêm o padrão anterior de cinco.   | 
| Elasticsearch 6.*x* | Elasticsearch 6.*x* | 
| Elasticsearch 5.6 |  Elasticsearch 6.*x*  Os índices criados na versão 6.*x* não são mais compatíveis com vários tipos de mapeamento. Índices criados na versão 5.*x* ainda são compatíveis com vários tipos de mapeamento quando restaurados em um cluster 6.*x*. Verifique se o seu código de cliente cria apenas um único tipo de mapeamento por índice. Para minimizar o tempo de inatividade durante a atualização do Elasticsearch 5.6 para 6. *x*, o OpenSearch serviço reindexa o `.kibana` índice`.kibana-6`, exclui`.kibana`, cria um alias chamado `.kibana` e mapeia o novo índice para o novo alias.   | 
| Elasticsearch 5.x | Elasticsearch 5.x | 

O processo de atualização consiste em três etapas:

1. **Verificações de pré-atualização** — O OpenSearch serviço verifica se há problemas que podem bloquear uma atualização e não prossegue para a próxima etapa, a menos que essas verificações sejam bem-sucedidas.

1. **Snapshot** — O OpenSearch serviço tira um snapshot do cluster OpenSearch ou do Elasticsearch e não passa para a próxima etapa, a menos que o snapshot seja bem-sucedido. Se a atualização falhar, o OpenSearch Service usará esse snapshot para restaurar o cluster ao estado original. Para obter mais informações, consulte [Não é possível reverter para a versão anterior após a atualização.](handling-errors.md#troubleshooting-upgrade-snapshot).

1. **Atualização** — O OpenSearch serviço inicia a atualização, que pode levar de 15 minutos a várias horas para ser concluída. OpenSearch Os painéis podem estar indisponíveis durante parte ou toda a atualização.

# Atualizar um domínio (console)
<a name="starting-upgrades"></a>

O processo de atualização é irreversível e não pode ser pausado nem cancelado. Durante uma atualização, não é possível fazer alterações de configuração no domínio. Antes de iniciar uma atualização, verifique novamente se deseja prosseguir. Você pode usar essas mesmas etapas para executar a verificação de pré-atualização sem realmente iniciar uma atualização.

Se o cluster tiver nós principais dedicados, as OpenSearch atualizações serão concluídas sem tempo de inatividade. Caso contrário, o cluster poderá não responder durante vários segundos após a atualização enquanto elege um nó principal.

**Para atualizar um domínio para uma versão posterior do OpenSearch ou Elasticsearch**

1. [Crie um snapshot manual](managedomains-snapshots.md) do seu domínio. Esse instantâneo serve como um backup que você pode [restaurar em um novo domínio](managedomains-snapshot-restore.md) se quiser voltar a usar a OpenSearch versão anterior.

1. Acesse [https://aws.amazon.com](https://console.aws.amazon.com/)e escolha **Entrar no console**.

1. Em **Analytics**, escolha **Amazon OpenSearch Service**.

1. No painel de navegação, em **Domínios**, escolha o domínio que deseja atualizar.

1. Escolha **Ações** e **Atualizar**.

1. Selecione a versão para a qual deseja atualizar. Se você estiver atualizando para uma OpenSearch versão, a opção **Ativar modo de compatibilidade** será exibida. Se você habilitar essa configuração, OpenSearch reporta sua versão como 7.10 para permitir que clientes e plug-ins do Elasticsearch OSS, como o Logstash, continuem trabalhando com o Amazon Service. OpenSearch Você poderá desabilitar essa configuração posteriormente.

1. Escolha **Atualizar**.

1. Marque **Status** no painel do domínio para monitorar o status da atualização.

# Atualizar um domínio (CLI)
<a name="starting-upgrades-cli"></a>

Você pode usar as seguintes operações para identificar a versão correta do OpenSearch ou do Elasticsearch para seu domínio, iniciar uma atualização no local, realizar a verificação de pré-atualização e ver o progresso:
+ `get-compatible-versions` (`GetCompatibleVersions`)
+ `upgrade-domain` (`UpgradeDomain`)
+ `get-upgrade-status` (`GetUpgradeStatus`)
+ `get-upgrade-history` (`GetUpgradeHistory`)

Para obter mais informações, consulte a referência de [comandos da AWS CLI e a Referência](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/opensearch/index.html) da [API do Amazon OpenSearch Service](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/Welcome.html).

# Atualizar um domínio (SDK)
<a name="starting-upgrades-sdk"></a>

Este exemplo usa o cliente Python de [OpenSearchService](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/opensearch.html)baixo nível AWS SDK para Python (Boto) do para verificar se um domínio está qualificado para atualização para uma versão específica, atualizá-lo e verificar continuamente o status do upgrade.

```
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()
```

## Solução de problemas de falha de validação
<a name="upgrade-validation"></a>

Quando você inicia uma atualização da versão OpenSearch ou do Elasticsearch, o OpenSearch Service primeiro executa uma série de verificações de validação para garantir que seu domínio esteja qualificado para uma atualização. Se alguma dessas verificações falhar, você receberá uma notificação no console contendo os problemas específicos que deverão ser corrigidos antes da atualização do domínio. Para obter uma lista de possíveis problemas e as etapas para resolvê-los, consulte [Solução de problemas de erros de validação](managedomains-configuration-changes.md#validation).

## Solução de problemas em uma atualização
<a name="upgrade-failures"></a>

As atualizações do no local exigem domínios íntegros. Seu domínio pode não estar qualificado para uma atualização ou não ser atualizado por vários motivos. A tabela a seguir mostra os problemas mais comuns.


| Problema | Description | 
| --- | --- | 
| Plug-in opcional não compatível |  Quando você atualiza um domínio com plug-ins opcionais, o OpenSearch Service também atualiza automaticamente os plug-ins. Portanto, a versão de destino do seu domínio também deve oferecer suporte a esses plug-ins opcionais. Se o domínio tiver um plug-in opcional instalado que não esteja disponível para a versão de destino, a solicitação de upgrade falhará.  | 
| Muitos fragmentos por nó | OpenSearch, bem como 7. As versões x do Elasticsearch têm uma configuração padrão de no máximo 1.000 fragmentos por nó. Se um nó em seu cluster atual exceder essa configuração, o OpenSearch Serviço não permitirá que você faça o upgrade. Consulte [Limite máximo de fragmentos excedido](handling-errors.md#troubleshooting-shard-limit) para obter opções de solução de problemas. | 
| Domínio no processamento | O domínio está no meio de uma mudança de configuração. Verifique a qualificação da atualização após a conclusão da operação. | 
| Status de cluster vermelho | Um ou mais índices no cluster estão vermelhos. Para obter etapas sobre a solução de problemas, consulte [Status de cluster vermelho](handling-errors.md#handling-errors-red-cluster-status). | 
| Alta taxa de erros | O cluster está retornando um grande número de erros 5xx ao tentar processar solicitações. Geralmente, esse problema é resultado de muitas solicitações de leitura ou gravação simultâneas. Considere reduzir o tráfego para o cluster ou dimensionar seu domínio. | 
| Cérebro dividido | Cérebro dividido significa que o cluster tem mais de um nó principal e foi dividido em dois clusters que nunca se juntarão por conta própria. Você pode evitar dividir o cérebro usando o número recomendado de [nós principais dedicados](managedomains-dedicatedmasternodes.md). Para ajudar na recuperação do cérebro dividido, entre em contato com [Suporte](https://console.aws.amazon.com/support/home). | 
| Nó principal não encontrado | OpenSearch O serviço não consegue encontrar o nó principal do cluster. Se o domínio usa [multi-AZ](managedomains-multiaz.md), uma falha da zona de disponibilidade pode ter causado a perda de quorum do cluster e a incapacidade de escolher um novo [nó principal](managedomains-dedicatedmasternodes.md). Se o problema não se resolver, entre em contato com [Suporte](https://console.aws.amazon.com/support/home). | 
| Muitas tarefas pendentes | O nó principal está sob carga pesada e tem muitas tarefas pendentes. Considere reduzir o tráfego para o cluster ou dimensionar seu domínio. | 
| Volume de armazenamento prejudicado | O volume de disco de um ou mais nós não está funcionando corretamente. Esse problema geralmente ocorre junto com outros problemas, como uma alta taxa de erros ou muitas tarefas pendentes. Se o problema ocorrer isoladamente e não se resolver, entre em contato com [Suporte](https://console.aws.amazon.com/support/home). | 
| Problema de chave do KMS | A chave do KMS usada para criptografar o domínio está inacessível ou ausente. Para saber mais, consulte [Monitoramento de domínios que criptografam dados em repouso](encryption-at-rest.md#monitoring-ear). | 
| Snapshot em andamento | O domínio está tirando um snapshot no momento. Verifique a qualificação da atualização após a conclusão do snapshot. Além disso, verifique se é possível listar repositórios de snapshots manuais, listar snapshots nesses repositórios e obter snapshots manuais. Se o OpenSearch Serviço não conseguir verificar se um snapshot está em andamento, as atualizações podem falhar. | 
| Tempo limite ou falha de snapshot | O snapshot de pré-atualização demorou muito para ser concluído ou falhou. Verifique o status do cluster e tente novamente. Se o problema continuar, entre em contato com o [Suporte](https://console.aws.amazon.com/support/home). | 
| Índices incompatíveis | Um ou mais índices são incompatíveis com a versão de destino. Esse problema pode ocorrer se você migrou os índices de uma versão mais antiga do Elasticsearch OpenSearch . Reindexe os índices e tente novamente. | 
| Uso elevado do disco | O uso de disco para o cluster está acima de 90%. Exclua os dados ou dimensione o domínio e tente novamente. | 
| Uso elevado do JVM | A pressão de memória JVM está acima de 75%. Reduza o tráfego para o cluster ou dimensione o domínio e tente novamente. | 
| OpenSearch Problema de alias de painéis | .dashboardsjá está configurado como um alias e mapeia para um índice incompatível, provavelmente de uma versão anterior do Dashboards. OpenSearch Reindexe e tente novamente. | 
| Status de painéis vermelhos | OpenSearch O status dos painéis é vermelho. Tente usar o Dashboards quando a atualização for concluída. Se o status vermelho persistir, resolva-o manualmente e tente novamente. | 
| Compatibilidade entre clusters |  Você só pode atualizar se a compatibilidade entre clusters for mantida entre os domínios de origem e de destino após a atualização. Durante o processo de atualização, todas as conexões incompatíveis são identificadas. Para prosseguir, atualize o domínio remoto ou excluir as conexões incompatíveis. Observe que, se a replicação estiver ativa no domínio, você não poderá retomá-la depois de excluir a conexão.   | 
| Outro problema de OpenSearch serviço | Problemas com o OpenSearch serviço em si podem fazer com que seu domínio seja exibido como inelegível para um upgrade. Se nenhuma das condições anteriores se aplicar ao seu domínio e o problema persistir por mais de um dia, entre em contato com [Suporte](https://console.aws.amazon.com/support/home). | 

# Como usar um snapshot para migrar dados
<a name="snapshot-based-migration"></a>

As atualizações no local são a maneira mais fácil, rápida e confiável de atualizar um domínio para uma versão posterior OpenSearch ou do Elasticsearch. Os snapshots são uma boa opção se você precisa migrar de uma versão anterior a 5.1 do Elasticsearch ou deseja migrar para um cluster totalmente novo.

A tabela a seguir mostra como usar snapshots para migrar dados para um domínio que usa uma versão diferente OpenSearch ou uma versão do Elasticsearch. Para saber mais sobre a criação e a restauração de snapshots, consulte [Criação de instantâneos de índice no Amazon Service OpenSearch](managedomains-snapshots.md).


| Da versão | Para a versão | Processo de migração | 
| --- | --- | --- | 
| OpenSearch 1.3 ou 2. x | OpenSearch 2. x |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/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/pt_br/opensearch-service/latest/developerguide/snapshot-based-migration.html)  | 
| Elasticsearch 6.x ou 7.x | OpenSearch 1. x |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/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/pt_br/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/pt_br/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/pt_br/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/pt_br/opensearch-service/latest/developerguide/snapshot-based-migration.html)  | 
| Elasticsearch 2.3 | Elasticsearch 6.x |  Os snapshots do Elasticsearch 2.3 não são compatíveis com o 6.*x*. Para migrar os dados diretamente da versão 2.3 para a 6.*x*, você terá que recriar manualmente os índices no novo domínio. Como alternativa, você pode seguir as etapas da atualização da versão 2.3 para a 5.*x* nesta tabela, realizar as operações de `_reindex` no novo domínio 5.*x* para converter os índices 2.3 em índices 5.*x* e depois seguir as etapas da atualização da versão 5.*x* para a 6.*x*.  | 
| Elasticsearch 2.3 | Elasticsearch 5.x |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/opensearch-service/latest/developerguide/snapshot-based-migration.html)  | 
| Elasticsearch 1.5 | Elasticsearch 5.x |  Os snapshots do Elasticsearch 1.5 não são compatíveis com o 5.*x*. Para migrar os dados da versão 1.5 para a 5.*x*, você terá que recriar manualmente os índices no novo domínio.  Os instantâneos 1.5 *são* compatíveis com 2.3, mas os domínios do OpenSearch Service 2.3 não suportam a `_reindex` operação. Como você não pode reindexá-los, os índices originados em um domínio da versão 1.5 ainda não podem ser restaurados de snapshots da 2.3 para domínios da 5.*x*.   | 
| Elasticsearch 1.5 | Elasticsearch 2.3 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/opensearch-service/latest/developerguide/snapshot-based-migration.html)  |