Documentazione dell'infrastruttura Oracle Cloud

OpenSearch Aggiornamenti del software cluster

Eseguire l'upgrade della versione del software di un cluster con un upgrade del software in linea.

È possibile aggiornare la versione software del cluster OpenSearch utilizzando i metodi riportati di seguito.

  • Snapshot e ripristino: effettuare le seguenti operazioni:
    1. Creare uno snapshot dal cluster corrente. Per istruzioni, vedere Creazione di un backup del cluster OpenSearch.
    2. Creare un nuovo cluster della versione software richiesta.
    3. Ripristinare lo snapshot nel nuovo cluster. Per istruzioni, vedere Ripristino di un backup in un nuovo cluster OpenSearch.
  • Aggiornamento diretto: aggiorna il cluster stesso alla versione richiesta.
  • Duplica ed esegui upgrade: crea una copia del cluster ed esegui l'upgrade alla versione richiesta.

I metodi Aggiornamento diretto e Duplica e aggiorna vengono descritti più avanti in questo argomento.

Tenere presenti le limitazioni e le considerazioni riportate di seguito relative agli aggiornamenti in linea.

  • Dopo l'avvio del processo di aggiornamento in linea, non è possibile arrestare o annullare il processo. Si consiglia di creare un backup del cluster.
  • È possibile eseguire l'upgrade di un cluster solo a una versione più recente del software OpenSearch. Non è possibile eseguire il downgrade a una versione precedente del software OpenSearch.
  • I nodi e gli indici OpenSearch sono compatibili all'indietro con la versione principale precedente.

Percorsi di aggiornamento supportati per l'aggiornamento in linea

Versione precedente all'aggiornamento Versione successiva all'aggiornamento
1,2 2,3
2,3 2,11
2,11 2,15
2,15 2,18
2,18 2,19
2,19 3,2

Accedere alla lista Cluster nella console per verificare se un cluster è idoneo per un upgrade del software. I cluster idonei all'aggiornamento includono il testo Upgrade nella colonna Versione software. Per istruzioni sull'accesso alla lista Cluster, vedere Elenco dei cluster OpenSearch.

    1. Nella pagina elenco Cluster individuare il cluster OpenSearch da utilizzare. Se è necessaria assistenza per trovare la pagina della lista o il cluster, vedere Elenca cluster OpenSearch.
    2. Nel menu Azioni per il cluster OpenSearch, selezionare Aggiorna.
    3. Nel pannello Aggiorna, selezionare una delle seguenti opzioni:
      • Aggiorna cluster corrente: esegue l'upgrade della versione di questo cluster. Gli aggiornamenti di versione principali potrebbero avere tempi di inattività.
      • Creare una copia e applicare l'aggiornamento alla copia: utilizzare questa funzione per applicare l'aggiornamento a una copia in modo da poter eseguire i test. Si consiglia di selezionare questa opzione per gli aggiornamenti principali per evitare tempi di inattività del traffico di produzione a causa di eventuali problemi con l'upgrade.
    4. Selezionare la versione del software dalla lista Versioni software disponibili. Viene visualizzata inizialmente la versione corrente.
    5. Selezionare Upgrade.

  • Utilizzare il comando oci opensearch cluster upgrade e i parametri necessari per eseguire un upgrade in linea (versione di build precedente) per un cluster. Configurare il parametro is-clone come false o true per specificare se si sta eseguendo l'upgrade del cluster corrente o se si sta creando una copia del cluster e se si sta applicando l'upgrade alla copia.

    Eseguire il comando seguente per aggiornare il cluster corrente:

    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]

    Eseguire il comando seguente per creare un clone e applicare l'aggiornamento al 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]

    Il parametro original_cluster_display_name è necessario per verificare che l'ID cluster abbia lo stesso nome visualizzato.

    Il valore di upgrade-type deve essere MINOR.

    Per un elenco completo dei flag e delle opzioni delle variabili per i comandi CLI, vedere Riferimento per la riga di comando.

  • Eseguire l'operazione UpgradeOpenSearchCluster per eseguire un upgrade del software in linea per un cluster. Configurare upgradeType come secondario.

Esecuzione di un aggiornamento importante

Seguire i passi precedenti di questo argomento per eseguire l'upgrade della versione del software del cluster. Selezionare la versione 3.2.0 o successiva dall'elenco Versioni software disponibili.

Nota

L'aggiornamento alla versione 3.2.0 non riesce se nel cluster è presente un indice con pipeline RAG, la soluzione alternativa corrente consiste nell'utilizzare lo snapshot e ripristinare l'instradamento per l'aggiornamento. La RAG è tuttavia pienamente supportata sul cluster 3.2.0 aggiornato.

Sono in corso lavori per affrontare entrambi questi problemi.

Impostazioni archivio

Le versioni 3.x di OpenSearch rinominano le impostazioni non più valide con il prefisso archived. Tutte le impostazioni archiviate vengono rimosse durante l'aggiornamento. Ecco l'elenco delle impostazioni non più valide:

  • 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