Documentazione dell'infrastruttura Oracle Cloud

Aggiornamento della ricerca con il software del cluster OpenSearch

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

La ricerca con OpenSearch supporta diverse versioni concorrenti di OpenSearch. Per i cluster esistenti che utilizzano versioni precedenti, è possibile eseguire l'upgrade del cluster per utilizzare le funzionalità disponibili nella versione più recente di OpenSearch.

Il processo di aggiornamento dipende dal fatto che si stia eseguendo un aggiornamento della versione principale o di una versione secondaria. Un aggiornamento della versione principale è indicato da una modifica del primo numero nel numero di build, ad esempio da 2.19.1 a 3.2.0. Un aggiornamento di versione minore è indicato da una modifica del secondo numero nel numero di build, ad esempio da 2.11.0 a 2.15.0.

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

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

Nota

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.
  • 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 l'instradamento dello snapshot e del ripristino per l'upgrade. La RAG è tuttavia pienamente supportata sul cluster 3.2.0 aggiornato. Sono in corso lavori per affrontare entrambi questi problemi.

Percorsi di aggiornamento consigliati

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

Le versioni 1.2.4 e 2.3.0 non sono più valide, pertanto è possibile aggiornarle entrambe direttamente alla versione 2.11.0. Per ulteriori informazioni, vedere Ricerca con le versioni supportate di OpenSearch.

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 Ricerca nella lista con cluster OpenSearch.

Aggiornamento del software

    1. Nella pagina elenco Cluster individuare il cluster OpenSearch da utilizzare. Se è necessaria assistenza per trovare la pagina della lista o il cluster, vedere Ricerca nella lista con 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.

    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.

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