Documentação do Oracle Cloud Infrastructure

OpenSearch Upgrades de Software do Cluster

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

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

  • Snapshot e restauração: Siga estas etapas:
    1. Crie um snapshot do seu cluster atual. Para obter instruções, consulte Criando um Backup do Cluster OpenSearch.
    2. Crie um novo cluster da versão de software necessária.
    3. Restaure o snapshot no novo cluster. Para obter instruções, consulte Restaurando um Backup para um Novo Cluster OpenSearch.
  • Upgrade direto: Faça upgrade do próprio cluster para a versão necessária.
  • Clonar e fazer upgrade: Crie um clone do seu cluster e faça upgrade para a versão necessária.

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

Observe as seguintes limitações e considerações sobre atualizações 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.
  • Os nós e os índices OpenSearch são compatíveis com a versão principal anterior.

Caminhos de Upgrade Suportados para Upgrade em Linha

Versão do Pré-upgrade Versão de Pós-Upgrade
1,2 2.3
2,3 2.11
2.11 2.15
2,15 2,18
2,18 2,19
2,19 3,2

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 Clusters OpenSearch.

    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 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.

    O valor do upgrade-type deve ser MINOR.

    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. Configure o upgradeType como Secundário.

Executando uma Atualização Principal

Siga as etapas anteriores deste tópico para fazer upgrade da versão de software do cluster. Selecione a versão 3.2.0 ou mais recente na lista Versões de software disponíveis.

Observação

O upgrade para a versão 3.2.0 falhará se um índice com o pipeline de RAG estiver presente no cluster, a solução alternativa atual será usar a rota de snapshot e restauração 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.

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