Documentação do Oracle Cloud Infrastructure

Fazendo Upgrade da Pesquisa com o Software de Cluster OpenSearch

Faça upgrade da versão de software de um cluster com um upgrade de software em linha.

A pesquisa com OpenSearch suporta várias versões simultâneas do OpenSearch. Para clusters existentes que usam versões mais antigas, você pode fazer upgrade do cluster para usar a funcionalidade disponível na versão mais recente do OpenSearch.

O processo de atualização depende se você está fazendo uma atualização de versão principal ou uma atualização de versão secundária. Uma atualização de versão principal é indicada por uma alteração no primeiro número do número de compilação, por exemplo, 2.19.1 para 3.2.0. Uma atualização de versão secundária é indicada por uma alteração no segundo número no número da compilação, por exemplo, 2.11.0 para 2.15.0.

Você pode fazer upgrade da versão de software do cluster OpenSearch usando os seguintes métodos:

Os métodos Upgrade direto e Clonar e fazer upgrade são descritos mais adiante neste tópico.

Observação

Considere as seguintes limitações e considerações sobre upgrades em linha:
  • Depois que o processo de upgrade em linha for iniciado, não será possível interromper ou cancelar o processo. Recomendamos que você crie um backup do cluster.
  • Você só pode fazer upgrade de um cluster para uma versão mais recente do software OpenSearch. Não é possível fazer downgrade para uma versão mais antiga do software OpenSearch.
  • O upgrade para a versão 3.2.0 falhará se um índice com o pipeline RAG estiver presente no cluster, a solução alternativa atual é usar o snapshot e restaurar a rota para upgrade. No entanto, o RAG é totalmente suportado no cluster 3.2.0 atualizado. Estão em curso trabalhos para abordar estas duas questões.

Caminhos de Upgrade Recomendados

Versão do Pré-upgrade Versão de Pós-Upgrade
1,2 2,11
2,3 2,11
2,11 2,15
2,15 2,18
2,18 2,19
2,19 3,2
Observação

As versões 1.2.4 e 2.3.0 estão obsoletas, para que você possa fazer upgrade das duas diretamente para a versão 2.11.0. Para obter mais informações, consulte Pesquisar com Versões Suportadas do OpenSearch.

Acesse a lista Clusters na Console para verificar se um cluster é elegível para um upgrade de software. Todos os clusters elegíveis para upgrade incluem o texto Upgrade na coluna Versão do software. Para obter instruções sobre como acessar a lista Clusters, consulte Listando a Pesquisa com Clusters OpenSearch.

Atualizando o Software

    1. Na página de lista Clusters, localize o cluster OpenSearch com o qual você deseja trabalhar. Se precisar de ajuda para localizar a página de lista ou o cluster, consulte Listando a Pesquisa com Clusters OpenSearch.
    2. No menu Ações do cluster OpenSearch, selecione Fazer Upgrade.
    3. No painel Fazer Upgrade, selecione uma das seguintes opções:
      • Fazer upgrade do cluster atual: Faz upgrade da versão deste cluster. Os upgrades de versão principal podem ter tempo de inatividade.
      • Criar um clone e aplicar upgrade ao clone: Use esse recurso para aplicar o upgrade a um clone para que você possa executar testes. Recomendamos selecionar essa opção para atualizações principais a fim de evitar qualquer tempo de inatividade do tráfego de produção devido a qualquer problema com o upgrade.
    4. Selecione a versão do software na lista Versões de software disponíveis. A versão atual é exibida inicialmente.
    5. Selecione Upgrade.

  • Use o comando oci opensearch cluster upgrade e os parâmetros necessários para executar um upgrade em linha (versão de build menor) para um cluster. Configure o parâmetro is-clone como false ou true para especificar se você está fazendo upgrade do cluster atual ou se está criando um clone do cluster e se está aplicando o upgrade ao clone.

    Execute o seguinte comando para fazer upgrade do cluster atual:

    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]

    Execute o seguinte comando para criar um clone e aplicar o upgrade ao clone:

    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]

    O parâmetro original_cluster_display_name é necessário para validar se o ID do cluster tem o mesmo nome para exibição.

    Para obter uma lista completa de flags e opções de variáveis para comandos da CLI, consulte a Referência de Linha de Comando.

  • Execute a operação UpgradeOpenSearchCluster para executar um upgrade de software em linha para um cluster.

Configurações de Arquivamento

As versões do OpenSearch 3.x renomeiam as definições obsoletas com o prefixo archived. Todas as configurações arquivadas são removidas durante a atualização. Aqui está a lista de configurações obsoletas:

  • 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