Come posso risolvere i problemi di un'istanza Amazon DocumentDB che si trova in uno stato incompatible-network?

Breve descrizione

Uno stato incompatible-network si verifica a causa di uno o più dei seguenti problemi con l'istanza Amazon DocumentDB:

• Non ci sono indirizzi IP disponibili nella sottorete in cui è stata avviata l'istanza Amazon DocumentDB.
• La sottorete elencata nel gruppo di sottoreti DB di Amazon DocumentDB non esiste in Amazon Virtual Private Cloud (Amazon VPC).
• Hai raggiunto la quota di servizio per le interfacce di rete elastiche nella regione AWS che stai utilizzando.

Se riscontri uno di questi problemi, la tua istanza Amazon DocumentDB potrebbe entrare nello stato incompatible-network quando esegui una delle seguenti azioni:

• Modifica della classe dell'istanza Amazon DocumentDB.
• Aggiunta di una nuova istanza Amazon DocumentDB al cluster.
• Sostituzione di un host a causa di un evento di manutenzione.
• Creazione di una nuova istanza Amazon DocumentDB dopo che le interfacce di rete elastiche hanno raggiunto la loro quota.
• Ripristino da un backup istantaneo di Amazon DocumentDB.
• Avvio di un cluster Amazon DocumentDB che è stato interrotto.

Risoluzione

Lo stato incompatible-network indica che l'istanza Amazon DocumentDB potrebbe essere ancora accessibile a livello di database, ma non è possibile modificarla o riavviarla. È consigliabile disporre sempre di un backup in modo da poter ripristinare i dati su un'altra istanza se l'istanza entra in uno stato incompatible-network.

Per risolvere i problemi di un'istanza Amazon DocumentDB in uno stato incompatible-network, scegli una delle seguenti soluzioni:

• Usa il runbook AWSSupport-ValidateRdsNetworkConfiguration.
• Usa la Console di gestione AWS.

Uso del runbook AWSSupport-ValidateRdsNetworkConfiguration

Per identificare il motivo per cui l'istanza Amazon DocumentDB è in uno stato incompatible-network, usa il runbook AWSSupport-ValidateRdsNetworkConfiguration. Per evitare lo stato incompatible-network, usa questo runbook quando esegui modifiche o avvii un'istanza interrotta.

Nota: prima di avviare il runbook AWSSupport-ValidateRdsNetworkConfiguration, assicurati che il tuo utente o ruolo AWS Identity and Access Management (IAM) disponga delle autorizzazioni richieste. Per ulteriori informazioni, consulta la sezione sulle autorizzazioni IAM richieste di AWSSupport-ValidateRdsNetworkConfiguration.

Per risolvere i problemi dal runbook AWSSupport-ValidateRdsNetworkConfiguration, completa i seguenti passaggi:

1. Connettiti alla console AWS Systems Manager e accedi al runbook AWSSupport-ValidateRdsNetworkConfiguration.
2. Scegli Esegui automazione.
3. Inserisci i seguenti valori:
   In AutomationAssumeRole, inserisci l'ARN del ruolo IAM che consente all'automazione di eseguire le azioni per tuo conto. Se non specifichi alcun ruolo, verranno utilizzate le autorizzazioni dell'utente che avvia il runbook.
   In DBInstanceIdentifier, inserisci l'identificatore della tua istanza Amazon DocumentDB.
4. Scegli Esegui.
5. Una volta completata l'automazione, esamina i risultati dettagliati nella sezione Output. Il parametro generateReport.Report mostrerà un report consolidato di tutti i controlli eseguiti nell'ambito di questo runbook.
6. (Facoltativo) Controlla la sezione ###\ [Next Steps] del report di output per ulteriori informazioni sulla risoluzione dei problemi.

Uso della Console di gestione AWS

Per risolvere i problemi dalla Console di gestione AWS, completa i seguenti passaggi:

1. Apri la console Amazon DocumentDB, quindi scegli Istanze nel riquadro di navigazione.
2. Scegli l'istanza Amazon DocumentDB che si trova in uno stato incompatible-network. Quindi, annota l'ID VPC nei dettagli dell'istanza.
3. Apri la console Amazon VPC, quindi scegli Sottoreti dal riquadro di navigazione. Verifica che tutti i gruppi di sottorete nel VPC utilizzato dal cluster Amazon DocumentDB esistano e siano disponibili.
4. Verifica che tutte le sottoreti del gruppo di sottoreti utilizzato dal cluster Amazon DocumentDB abbiano indirizzi IP disponibili.
5. Apri la console Amazon Elastic Compute Cloud (Amazon EC2) e verifica se hai raggiunto la quota prevista per le interfacce di rete elastiche. Se hai raggiunto la quota, richiedi un aumento della quota di servizio. Per ulteriori informazioni, consulta Network interfaces.

Se l'istanza Amazon DocumentDB è già in uno stato incompatible-network, scegli uno dei seguenti metodi per il cluster Amazon DocumentDB:

• Crea una nuova istanza Amazon DocumentDB nel cluster dopo avere risolto il problema che ha causato lo stato incompatible-network. Dopo avere creato un cluster in esecuzione con una nuova istanza Amazon DocumentDB attiva, elimina l'istanza che si trovava in uno stato incompatible-network.
  Importante: non eliminare l'intero cluster. Elimina invece solo l'istanza nello stato incompatible-network. Inoltre, assicurati che la nuova istanza Amazon DocumentDB attiva si trovi nello stesso cluster della vecchia istanza con stato incompatible-network.
• Interrompi temporaneamente qualsiasi scrittura sull'istanza Amazon DocumentDB, quindi esegui un ripristino point-in-time (PITR) per creare un nuovo cluster.

Informazioni correlate

Monitoring an Amazon DocumentDB instance's status