View a markdown version of this page

Aggiornamento dei domini Amazon Service OpenSearch - OpenSearch Servizio Amazon
Percorsi di aggiornamento supportatiErrori nella risoluzione dei problemi di convalidaRisoluzione dei problemi relativi all'aggiornamento

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Aggiornamento dei domini Amazon Service OpenSearch

Nota

OpenSearch e gli aggiornamenti delle versioni di Elasticsearch sono diversi dagli aggiornamenti del software di servizio. Per informazioni sull'aggiornamento del software di servizio per il dominio del OpenSearch servizio, consulta. Aggiornamenti del software di servizio in Amazon OpenSearch Service

Amazon OpenSearch Service offre aggiornamenti sul posto per domini con esecuzione OpenSearch 1.0 o successiva o Elasticsearch 5.1 o versione successiva. Se utilizzi servizi come Amazon Data Firehose o Amazon CloudWatch Logs per lo streaming di dati verso OpenSearch Service, verifica che questi servizi supportino la versione più recente di prima di eseguire la migrazione. OpenSearch

Percorsi di aggiornamento supportati

Attualmente, il OpenSearch servizio supporta i seguenti percorsi di aggiornamento:

Dalla versione Alla versione
OpenSearch 1.3, 2. x o 3. x

OpenSearch 3. x

Se utilizzi OpenSearch 1.3 o 2.x, devi prima eseguire l'aggiornamento a OpenSearch 2.19 prima di eseguire l'aggiornamento a 3.x. OpenSearch

Quando si esegue l'aggiornamento da OpenSearch 2.19 a OpenSearch 3.x, potrebbe essere necessario modificare le seguenti impostazioni dell'indice incompatibili. Queste sono state rese obsolete in precedenza nella versione 2.x e, se non vengono rimosse, comporteranno un errore di convalida del controllo dell'aggiornamento.

  • index.knn.algo_param.ef_construction

  • index.knn.algo_param.m

  • index.knn.space_type

  • index.store.hybrid.mmap.extensions

Per ulteriori informazioni sulle impostazioni dell'indice obsolete e sui passaggi per correggerle, consulta Impostazioni dell'indice. https://docs.opensearch.org/2.6/search-plugins/knn/knn-index/#index-settings Per un elenco completo delle principali modifiche apportate a OpenSearch 3.x, vedi 3.0.0. https://docs.opensearch.org/latest/breaking-changes/#300

Se il tuo dominio contiene indici creati in OpenSearch 1.3, Elasticsearch 7.10 o versioni precedenti, devi reindicizzarli prima di eseguire l'aggiornamento a 3.x. OpenSearch OpenSearch 3.x non supporta questi vecchi indici, indipendentemente dal fatto che siano archiviati a caldo o a freddo. UltraWarm Per reindicizzare gli indici UltraWarm incompatibili o obsoleti:

  1. Migrare gli indici su hot storage.

  2. Reindicizza i dati.

  3. Migra nuovamente gli indici in una memoria calda o fredda.

In alternativa, elimina gli indici se non ti servono più.

Istantanee scattate il 1. OpenSearch x e su Elasticsearch 7.10 e versioni precedenti sono incompatibili con 3.x. OpenSearch

Per i repository di istantanee manuali, elimina queste istantanee incompatibili prima di eseguire l'aggiornamento a 3.x. OpenSearch

OpenSearch 1.3 o 2. x

OpenSearch 2. x

OpenSearch 2.17 abiliterà la ricerca simultanea di segmenti per impostazione predefinita con la modalità automatica se il dominio soddisfa le seguenti condizioni:

  • Nessuna impostazione di ricerca simultanea precedente è stata impostata in modo esplicito.

  • Tutte le istanze di dati (hot e warm) sono di tipo di istanza .2xl o superiore.

  • L'utilizzo medio della CPU p90 sulle istanze di dati (calde e calde) per più di 1 settimana è inferiore al 45%.

    Per maggiori dettagli sulle impostazioni di ricerca per segmenti simultanei, consulta Ricerca per segmenti simultanei.

La versione 2.3 presenta le seguenti modifiche importanti:

  • Il type parametro è stato rimosso da tutti gli endpoint OpenSearch API nella versione 2.0. Per ulteriori informazioni, consulta la sezione modifiche importanti.

  • Se il tuo dominio contiene indici (hot o cold) originariamente creati in Elasticsearch 6.8, tali indici non sono compatibili con 2.3. UltraWarm OpenSearch

    Prima di eseguire l'aggiornamento alla versione 2.3, è necessario reindicizzare gli indici incompatibili. Per gli indici incompatibili UltraWarm o obsoleti, esegui la migrazione su una memoria calda, reindicizza i dati e quindi migrateli nuovamente in una memoria calda o fredda. In alternativa, puoi eliminare questi indici se non sono più necessari.

    Se accidentalmente effettui l'upgrade del tuo dominio alla versione 2.3 senza aver prima eseguito questi passaggi, non sarai in grado di migrare gli indici incompatibili dal livello di archiviazione attuale. La tua unica opzione è quella di eliminarli.
OpenSearch 1. x OpenSearch 1. x
Elasticsearch 7.x

Ricerca elastica 7. x o 1. OpenSearch x

Importante

OpenSearch 1. x introduce numerose modifiche sostanziali. Per informazioni dettagliate, vedi Amazon OpenSearch Service rename - Riepilogo delle modifiche.

Elasticsearch 6.8

Elasticsearch 7. x o 1. OpenSearch x

Importante

Elasticsearch 7.0 e OpenSearch 1.0 includono numerose modifiche sostanziali. Prima di iniziare un aggiornamento sul posto, ti consigliamo di scattare un'istantanea manuale del 6. dominio x, ripristinandolo su un test 7. x o OpenSearch 1. dominio x e utilizzo di quel dominio di test per identificare potenziali problemi di aggiornamento. Per le modifiche più importanti nella OpenSearch versione 1.0, vedereAmazon OpenSearch Service rename - Riepilogo delle modifiche.

Come Elasticsearch 6.x, gli indici possono contenere un solo tipo di mappatura, ma tale tipo ora deve essere denominato _doc. Di conseguenza, alcune API non richiedono più un tipo di mappatura nel corpo della richiesta (ad esempio l'API _bulk).

Per i nuovi indici, Elasticsearch 7, ospitato autonomamente. OpenSearch x e 1. x hanno un numero predefinito di frammenti pari a uno. OpenSearch Domini di servizio su Elasticsearch 7. x e versioni successive mantengono il valore predefinito precedente di cinque.

Elasticsearch 6.x

Elasticsearch 6.x
Elasticsearch 5.6

Elasticsearch 6.x

Importante

Gli indici creati nella versione 6.x non supportano più tipi di mappatura diversi. Gli indici creati nella versione 5.x supportano ancora tipi di mappatura diversi quando sono ripristinati in un cluster 6.x. Controllare che il codice cliente crei un solo tipo di mappatura per indice.

Per ridurre al minimo i tempi di inattività durante l'aggiornamento da Elasticsearch 5.6 a 6. x, il OpenSearch servizio reindicizza l'.kibanaindice in.kibana-6, elimina.kibana, crea un alias denominato .kibana e mappa il nuovo indice sul nuovo alias.
Elasticsearch 5.x Elasticsearch 5.x

Il processo di aggiornamento è costituito da tre fasi:

  1. Pre-upgrade controlli: il OpenSearch servizio verifica la presenza di problemi che possono bloccare un aggiornamento e non procede alla fase successiva a meno che questi controlli non abbiano esito positivo.

  2. Istantanea: il OpenSearch servizio scatta un'istantanea del cluster OpenSearch o di Elasticsearch e non procede al passaggio successivo a meno che l'istantanea non abbia esito positivo. Se l'aggiornamento non riesce, OpenSearch Service utilizza questa istantanea per ripristinare il cluster allo stato originale. Per ulteriori informazioni, consulta Impossibile eseguire il downgrade dopo l'aggiornamento.

  3. Aggiornamento: il OpenSearch servizio avvia l'aggiornamento, che può richiedere da 15 minuti a diverse ore per essere completato. OpenSearch Le dashboard potrebbero non essere disponibili durante alcuni o tutti gli aggiornamenti.

Errori nella risoluzione dei problemi di convalida

Quando avvii un aggiornamento di una OpenSearch versione di Elasticsearch, OpenSearch Service esegue innanzitutto una serie di controlli di convalida per garantire che il dominio sia idoneo per un aggiornamento. Se uno di questi controlli non riesce, si riceve una notifica contenente i problemi specifici che è necessario correggere prima di aggiornare il dominio. Per un elenco dei potenziali problemi e dei passaggi per risolverli, consulta Risoluzione degli errori di convalida.

Risoluzione dei problemi relativi all'aggiornamento

In-place gli aggiornamenti richiedono domini integri. Il dominio potrebbe essere non idoneo per un aggiornamento o non completare l'aggiornamento per diversi motivi. La tabella riportata di seguito mostra i problemi più comuni.

Problema Description
Plugin opzionale non supportato

Quando si aggiorna un dominio con plug-in opzionali, il OpenSearch Servizio aggiorna automaticamente anche i plug-in. Pertanto, la versione di destinazione del tuo dominio deve supportare anche questi plugin opzionali. Se nel dominio è installato un plug-in opzionale che non è disponibile per la versione di destinazione, la richiesta di aggiornamento ha esito negativo.
Troppe partizioni per nodo OpenSearch, oltre a 7. Le versioni x di Elasticsearch hanno un'impostazione predefinita di non più di 1.000 frammenti per nodo. Se un nodo del cluster corrente supera questa impostazione, il OpenSearch servizio non consente l'aggiornamento. Consulta Limite massimo di partizioni superato per le opzioni di risoluzione dei problemi.
Dominio in elaborazione Il dominio è nel mezzo di una modifica di configurazione. Controlla l'idoneità dell'aggiornamento al termine dell'operazione.
Cluster in stato rosso Uno o più indici nel cluster sono in stato rosso. Per la risoluzione dei problemi, consulta Cluster in stato rosso.
Elevata percentuale di errori Il cluster restituisce un numero elevato di errori 5xx durante il tentativo di elaborazione delle richieste. Questo problema è in genere il risultato di un numero eccessivo di richieste di lettura o scrittura simultanee. Valuta la possibilità di ridurre il traffico verso il cluster o di eseguire il dimensionamento del dominio.
Split brain Split brain significa che il cluster contiene più nodi principali ed è stato diviso in due cluster che non verranno mai riuniti in modo autonomo. Puoi evitare lo split brain utilizzando il numero consigliato di nodi master dedicati. Per risolvere un problema di split brain, contatta Supporto.
Impossibile trovare nodo master OpenSearch Il servizio non riesce a trovare il nodo principale del cluster. Se il dominio utilizza il Multi-AZ, un errore nella zona di disponibilità potrebbe aver causato la perdita del quorum da parte del cluster e la conseguente incapacità di eleggere un nuovo nodo master. Se il problema non si risolve automaticamente, contatta Supporto.
Troppe attività in sospeso Il nodo master si trova in condizioni di carico elevato e presenta numerose attività in sospeso. Valuta la possibilità di ridurre il traffico verso il cluster o di eseguire il dimensionamento del dominio.
Volume di archiviazione compromesso Il volume del disco di uno o più nodi non funziona correttamente. Questo problema si verifica spesso insieme ad altri problemi, come un'elevata percentuale di errori o troppe attività in sospeso. Se si verifica in isolamento e non si risolve automaticamente, contatta Supporto.
Problema chiave KMS La chiave KMS utilizzata per crittografare il dominio non è accessibile o manca. Per ulteriori informazioni, consultare Monitoraggio dei domini che crittografano dati a riposo.
Snapshot in corso Il dominio sta attualmente acquisendo una snapshot. Controlla l'idoneità dell'aggiornamento al termine della snapshot. Verifica anche che puoi elencare repository snapshot manuali, elencare snapshot all'interno di tali repository e acquisire snapshot manuali. Se OpenSearch il servizio non è in grado di verificare se è in corso un'istantanea, gli aggiornamenti possono fallire.
Timeout o errore snapshot Il pre-aggiornamento snapshot richiede troppo tempo o non è riuscito. Verifica l'integrità del cluster e riprova. Se il problema persiste, contatta Supporto.
Indici incompatibili Uno o più indici sono incompatibili con la versione di destinazione. Questo problema può verificarsi se hai migrato gli indici da una versione precedente di Elasticsearch. OpenSearch Reindicizzare gli indici e riprovare.
Elevato utilizzo del disco L'utilizzo del disco per il cluster supera il 90%. Elimina i dati o ricalibra il dominio e riprova.
Elevato utilizzo JVM L'utilizzo della memoria JVM è superiore al 75%. Riduci il traffico verso il cluster o ricalibra il dominio e riprova.
OpenSearch Problema con gli alias delle dashboard .dashboardsè già configurato come alias e fa riferimento a un indice incompatibile, probabilmente proveniente da una versione precedente di Dashboards. OpenSearch Reindicizza e riprova.
Stato rosso di Dashboards OpenSearch Lo stato delle dashboard è rosso. Provare a usare Dashboards al termine dell'aggiornamento. Se lo stato rosso persiste, risolvilo manualmente e riprova.
Cross-cluster compatibilità

È possibile eseguire l'aggiornamento solo se viene mantenuta la compatibilità tra cluster tra i domini di origine e di destinazione dopo l'aggiornamento. Durante il processo di aggiornamento, vengono identificate tutte le connessioni non compatibili. Per procedere, aggiornare il dominio remoto o eliminare le connessioni non compatibili. Tenere presente che se la replica è attiva sul dominio, non è possibile riprenderla dopo aver eliminato la connessione.

Altro problema relativo al OpenSearch servizio I problemi relativi OpenSearch al Servizio stesso potrebbero far sì che il tuo dominio venga visualizzato come non idoneo per un upgrade. Se nessuna delle condizioni precedenti si applica al dominio e il problema persiste per più di un giorno, contatta Supporto.