Perché il mio dominio del Servizio OpenSearch è bloccato nello stato "Modifica in corso"?

Risoluzione

Per risolvere il problema di un dominio bloccato nello stato Modifica in corso, intraprendi le seguenti azioni di risoluzione in base al problema riscontrato.

Un controllo di convalida ha dato esito negativo e ha restituito errori

Quando avvi una modifica della configurazione, il Servizio OpenSearch esegue controlli di convalida per assicurarsi che il dominio sia idoneo per un aggiornamento. Se la convalida ha esito negativo, il dominio rimane nello stato Modifica in corso. Per risolvere il problema, completa la procedura di risoluzione corrispondente all'errore che ricevi. Quindi riprova a modificare la configurazione.

Hai avviato diverse modifiche della configurazione

Non puoi applicare una nuova modifica della configurazione quando è in corso una modifica della configurazione esistente. Per effettuare più aggiornamenti della configurazione, includi tutte le modifiche in un'unica richiesta. Se invii modifiche simultanee, ricevi il messaggio di errore "A change is already in progress".

I controlli di convalida rimangono validi per tutta la durata della modifica della configurazione. Se la configurazione supera la fase Convalida, non modificare le risorse richieste dal dominio fino al completamento della modifica iniziale. Ad esempio, non disattivare la chiave del Servizio AWS di gestione delle chiavi (AWS KMS) utilizzata per la crittografia.

Non sono disponibili indirizzi IP nelle sottoreti del VPC

Se non sono disponibili abbastanza indirizzi IP, libera o aggiungi nuovi indirizzi IP nei blocchi CIDR della sottorete del cloud privato virtuale (VPC).

La migrazione degli shard al nuovo set di nodi di dati non viene completata

Controlla l'avanzamento della migrazione degli shard

Dopo che il Servizio OpenSearch ha creato le nuove risorse, inizia a eseguire la migrazione degli shard verso i nuovi nodi di dati. Questo processo può richiedere da alcuni minuti a diverse ore, a seconda del carico e delle dimensioni del cluster.

Per monitorare lo stato della migrazione degli shard, esegui questo comando:

GET /DOMAIN_ENDPOINT/_cat/recovery?active_only=true&v

Nota: sostituisci DOMAIN_ENDPOINT con l'endpoint del tuo dominio. Se utilizzi OpenSearch Dashboards per eseguire il comando precedente, rimuovi /DOMAIN_ENDPOINT/.

Se il cluster del Servizio OpenSearch è nello stato cluster rosso, la migrazione degli shard ha esito negativo. Per risolvere il problema, consulta Perché il mio cluster Servizio OpenSearch di Amazon è rosso o giallo?

Per visualizzare le dimensioni degli shard, esegui questo comando:

GET /_cat/shards?v

Quindi esegui questo comando per visualizzare il numero di shard assegnati a ogni nodo:

GET /_cat/allocation?v

Se i nuovi nodi non hanno tutti gli shard richiesti, esegui questo comando per identificare la causa:

GET /_cluster/allocation/explain?pretty

Per ulteriori informazioni, consulta CAT shards API (API CAT shards), CAT allocation API (API CAT allocation) e Cluster allocation explain API (API cluster allocation explain) sul sito web OpenSearch.

Utilizza le best practice per il Servizio OpenSearch

Per accelerare la migrazione degli shard, applica le seguenti best practice:

• Utilizza una strategia di sharding in linea con le esigenze del caso d'uso.
• Pianifica la crescita e il tipo di carico di lavoro quando scegli il numero di shard per l'indice.
• Assicurati che i valori per laCPU e la pressione della memoria Java Virtual Machine (JVM) del cluster non siano troppo elevati.
• Assicurati che lo spazio di archiviazione libero nel nuovo set di nodi sia sufficiente. Per liberare spazio di archiviazione, elimina gli indici che non ti servono più. Per istruzioni, consulta Delete index API (API Delete index) sul sito web OpenSearch.
  Nota: se aggiungi nuovi dati al cluster durante il processo di implementazione blu/verde, possono verificarsi problemi di spazio di archiviazione, così come possono verificarsi se i nodi precedenti hanno shard di grandi dimensioni che il Servizio OpenSearch non può allocare ai nuovi nodi.

Aggiornare il valore per il numero di tentativi di allocazione

Se lo shard supera il numero massimo di tentativi e rimane non assegnato a un nodo, ritenta l'allocazione. Per impostazione predefinita, il cluster ritenta l'allocazione di uno shard al massimo per 5 volte consecutive.

Per incrementare il numero di tentativi per lo shard, esegui questo comando:

PUT INDEX_NAME/_settings  {
    "index.allocation.max_retries" : 10
}

Nota: sostituisci INDEX_NAME con il nome del tuo indice e 10 con il numero di tentativi.

Verifica la presenza di problemi nelle impostazioni dell'indice

Problemi hardware interni possono causare il blocco degli shard sui nodi di dati esistenti durante la migrazione. In base al tipo di problema, il Servizio OpenSearch esegue script per riportare automaticamente i nodi a uno stato integro. Se associ esplicitamente uno shard a un set di nodi esistente, la migrazione degli shard può bloccarsi.

Per assicurarti di non avere shard associati esplicitamente a un nodo, controlla le impostazioni dell'indice eseguendo questi comandi:

GET /DOMAIN_ENDPOINT/_cluster/allocation/explain?pretty
GET /DOMAIN_ENDPOINT/INDEX_NAME/_settings?pretty

Nota: sostituisci DOMAIN_ENDPOINT con l'endpoint del tuo dominio e INDEX_NAME con il tuo indice. Se utilizzi OpenSearch Dashboards per eseguire il comando precedente, rimuovi /DOMAIN_ENDPOINT/.

Nell'output, controlla le seguenti impostazioni per identificare gli shard associati esplicitamente ai nodi:

"index.routing.allocation.require._name": "NODE_NAME"
"index.blocks.write": true

Nota: sostituisci NODE_NAME con il nome del tuo nodo.

Se vedi "index.routing.allocation.require._name": "NODE_NAME" nelle impostazioni dell'indice, esegui questo comando per ripristinare l'impostazione:

PUT INDEX_NAME/_settings  {
    "index.routing.allocation.require._name": null
}

Nota: sostituisci DOMAIN_ENDPOINT con l'endpoint del tuo dominio e INDEX_NAME con il tuo indice.

Per ulteriori informazioni sulle impostazioni degli shard nell'indice, consulta Index-level shard allocation (Allocazione di shard a livello di indice) sul sito web Elastic.

Se vedi "index.blocks.write": true nelle impostazioni dell'indice, ciò significa che l'indice ha un blocco di scrittura. Il problema del blocco di scrittura può verificarsi a causa di un errore ClusterBlockException. Per risolverlo, consulta Come faccio a risolvere l'errore 403 "index_create_block_exception" o "cluster_block_exception" nel Servizio OpenSearch?

Per monitorare l'avanzamento della modifica della configurazione, esegui l'API DescribeDomainChangeProgress. Per cluster bloccati nello stato Modifica in corso o domini bloccati nello stato Eliminazione di risorse più vecchie per oltre 24 ore, crea una richiesta di assistenza al Supporto AWS.