Aggiornamento della ricerca con il software del cluster OpenSearch

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

Metodi di aggiornamento

È possibile eseguire l'upgrade del cluster OpenSearch a una versione software più recente per accedere a nuove funzioni e funzionalità. OpenSearch supporta diverse versioni concorrenti, in modo da poter mantenere aggiornato il cluster OpenSearch con i miglioramenti più recenti. Questo argomento descrive i metodi di aggiornamento, le considerazioni e i percorsi di aggiornamento supportati.

Scegliere uno dei metodi seguenti per eseguire l'upgrade del cluster OpenSearch:

Duplica e aggiorna: (consigliato) creare una copia del cluster OpenSearch ed eseguire l'upgrade del cluster duplicato alla versione richiesta. Utilizza questo approccio per ridurre al minimo i rischi e i tempi di inattività e per testare l'upgrade prima di passare il traffico di produzione al nuovo cluster.
Aggiornamento diretto: eseguire l'upgrade del cluster OpenSearch esistente alla versione richiesta in vigore. Utilizzare questo metodo per cluster piccoli o non critici in cui è accettabile un breve periodo di inattività. Questa opzione è nota anche come "upgrade in loco".
Snapshot e ripristino: utilizzare questo metodo per eseguire una migrazione pulita a una nuova versione del cluster OpenSearch, in particolare quando è necessario modificare configurazioni quali il tipo di istanza, l'area o l'architettura durante l'upgrade. Per utilizzare questo metodo di aggiornamento, effettuare le operazioni riportate di seguito.
1. Creare uno snapshot del cluster OpenSearch corrente. Per istruzioni, vedere Creazione di un backup cluster.
2. Creare un nuovo cluster OpenSearch con la versione software richiesta.
3. Ripristinare lo snapshot nel nuovo cluster OpenSearch. Per istruzioni, vedere Ripristino di un backup da un cluster.

Limitazioni e considerazioni per gli upgrade

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

Dopo aver avviato un aggiornamento diretto, non è possibile arrestare o annullare il processo. Si consiglia di creare un backup prima di avviare l'aggiornamento.
È possibile eseguire l'aggiornamento solo a una versione più recente del software OpenSearch. Impossibile eseguire il downgrade a una versione precedente.
Se un indice del cluster utilizza la pipeline RAG, l'aggiornamento direttamente alla versione 3.2.0 non riesce. Utilizzare il metodo di snapshot e ripristino come soluzione alternativa. RAG è completamente supportato su OpenSearch versione 3.2.0.

Percorsi di aggiornamento software

È possibile eseguire l'upgrade di un cluster OpenSearch a una versione più recente, ma solo a una versione principale alla volta. Il percorso di aggiornamento consigliato è descritto nella tabella seguente:


Versione corrente	Versione aggiornata
1.x	2,19
2.x	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 a una versione elencata nella tabella precedente. Per ulteriori informazioni, vedere Search with OpenSearch Supported Versions.

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.
Aggiornamento del cluster corrente
Per aggiornare il cluster corrente, impostare il parametro is-clone come false:
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]
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.
Duplicazione del cluster e applicazione dell'aggiornamento
Per creare una copia del cluster e applicare l'upgrade alla copia, impostare il parametro is-clone come true:
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]
Eseguire l'operazione UpgradeOpenSearchCluster per eseguire un aggiornamento in linea (versione build precedente) per un cluster.
Aggiornamento del cluster corrente
Impostare il parametro .isClone() su false. Ad esempio:
```
.isClone(false)
```
Duplicazione del cluster e applicazione dell'aggiornamento
Impostare il parametro .isClone() su true. Ad esempio:
```
.isClone(true)
```

Modifiche interruzione OpenSearch

Per informazioni sulle deprecazioni di OpenSearch associate alla versione 3.x, inclusi aggiornamenti e deprecazioni, vedere il seguente sito OpenSearch:

https://docs.opensearch.org/latest/breaking-changes/n. 300

Anche le informazioni relative ad altre versioni di OpenSearch sono elencate nel sito.

Impostazioni archivio

Le versioni di OpenSearch 3.x rinominano le impostazioni non più valide con il prefisso archived. Tutte le impostazioni dell'archivio 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

Documentazione dell'infrastruttura Oracle Cloud