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à.
# Gestione degli aggiornamenti del motore per il cluster di database Neptune
**Nota**
Gli aggiornamenti vengono applicati contemporaneamente a tutte le istanze in un cluster di database. Un aggiornamento richiede un riavvio del database per tutte le istanze, quindi è necessario prevedere un tempo di inattività compreso tra 20 o 30 secondi e alcuni minuti, al termine del quale sarà possibile riprendere l'utilizzo del cluster database. In rari casi, potrebbe essere necessario un failover Multi-AZ affinché un aggiornamento di manutenzione su un'istanza venga completato.
Per gli aggiornamenti della versione principale che possono richiedere più tempo per essere applicati, puoi utilizzare una [strategia di implementazione blu/verde](neptune-BG-deployments.md) per ridurre al minimo i tempi di inattività.
## Determinazione della versione del motore attualmente in uso
Puoi usare il AWS CLI [`get-engine-status`](access-graph-status.md)comando per verificare quale versione di rilascio del motore sta attualmente utilizzando il tuo cluster DB:
```
aws neptunedata get-engine-status
```
L'[output JSON](access-graph-status.md#access-graph-status-sample-output) include un campo `"dbEngineVersion"` simile a:
```
"dbEngineVersion": "1.3.0.0",
```
## Verifica degli aggiornamenti in sospeso e disponibili
Puoi verificare la presenza di aggiornamenti in sospeso al cluster di database utilizzando la console Neptune. Seleziona **Database** nella colonna di sinistra, quindi seleziona il cluster di database nel riquadro Database. Gli aggiornamenti in sospeso sono elencati nella colonna **Manutenzione**. Se si seleziona **Azioni** e quindi **Manutenzione**, sono disponibili tre soluzioni:
+ Aggiornare ora.
+ Aggiornare alla finestra successiva.
+ Rinviare l'aggiornamento.
È possibile elencare gli aggiornamenti del motore in sospeso utilizzando AWS CLI quanto segue:
```
aws neptune describe-pending-maintenance-actions \
--resource-identifier (ARN of your DB cluster)
--region (your region) \
--engine neptune
```
È inoltre possibile elencare gli aggiornamenti del motore disponibili utilizzando AWS CLI quanto segue:
```
aws neptune describe-db-engine-versions \
--region (your region) \
--engine neptune
```
L'elenco delle release del motore disponibili include solo quelle che dispongono di un numero di versione superiore a quello corrente e per cui è definito un percorso di aggiornamento.
## Eseguire sempre un test prima dell'aggiornamento
Quando viene rilasciata una nuova versione principale o secondaria del motore Neptune, testa sempre le applicazioni Neptune su di essa prima di procedere all'aggiornamento. Un aggiornamento secondario può introdurre nuove funzionalità o comportamenti che possono influenzare il codice senza alcuna modifica speciale.
Inizia confrontando le pagine delle note di rilascio della versione corrente con quelle della versione di destinazione per valutare se verranno modificate le versioni del linguaggio di query o verranno introdotte altre modifiche che causano interruzioni.
Il modo migliore per testare una nuova versione prima di eseguire l'aggiornamento del cluster di database di produzione è utilizzare la [soluzione di implementazione blu/verde Neptune](neptune-BG-deployments.md). In questo modo è possibile eseguire applicazioni e query sulla nuova versione senza influenzare il cluster di database di produzione.
## Creare sempre uno snapshot manuale prima dell'aggiornamento
Prima di procedere a un aggiornamento, è consigliabile creare sempre uno snapshot manuale del cluster database. Uno snapshot automatico offre solo una protezione a breve termine, mentre uno snapshot manuale rimane disponibile fino a quando non lo elimini esplicitamente.
In alcuni casi Neptune crea automaticamente uno snapshot manuale come parte del processo di aggiornamento, ma non è consigliabile farvi affidamento ed è comunque opportuno creare sempre il proprio snapshot manuale.
Quando hai la certezza che non sarà necessario ripristinare lo stato precedente all'aggiornamento del cluster di database, puoi eliminare in modo esplicito lo snapshot manuale che hai creato, così come lo snapshot manuale eventualmente creato da Neptune. Se Neptune crea uno snapshot manuale, questo avrà un nome che inizia con `preupgrade`, seguito dal nome del cluster database, dalla versione del motore di origine, dalla versione del motore di destinazione e dalla data.
## Finestra di manutenzione Neptune
La finestra di manutenzione settimanale è un periodo di 30 minuti durante il quale vengono applicati aggiornamenti del motore pianificati e altre modifiche di sistema. La maggior parte degli eventi di manutenzione viene completata durante la finestra di manutenzione di 30 minuti, sebbene eventi di manutenzione di dimensioni maggiori potrebbe richiedere a volte più tempo per il completamento.
Ogni cluster di database dispone di una finestra di manutenzione settimanale di 30 minuti. Se non si specifica un orario preferito per la finestra di manutenzione quando si crea il cluster di database, Neptune seleziona in modo casuale un giorno della settimana e quindi assegna in modo casuale un periodo di 30 minuti al suo interno da un blocco temporale di 8 ore che varia in base alla regione.
Di seguito sono riportati, ad esempio, i blocchi temporali di 8 ore per le finestre di manutenzione utilizzate in diverse regioni AWS :
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/neptune/latest/userguide/engine-maintenance-management.html)
La finestra di manutenzione determina l'ora di inizio delle operazioni in sospeso e la maggior parte delle operazioni di manutenzione viene completata all'interno della finestra, ma attività di manutenzione di dimensioni maggiori possono continuare oltre l'ora di fine della finestra.
### Spostamento della finestra di manutenzione del cluster di database
Idealmente, la finestra di manutenzione deve essere eseguita nel momento di utilizzo più basso del cluster. Se ciò non si verifica, è possibile spostarla in un orario migliore, come riportato di seguito:
**Per modificare a finestra di manutenzione del cluster di database**
1. [Accedi alla console di AWS gestione e apri la console Amazon Neptune da casa. https://console.aws.amazon.com/neptune/](https://console.aws.amazon.com/neptune/home)
1. Nel riquadro di navigazione, scegli **Database**.
1. Scegliere il cluster database per cui si desidera modificare la finestra di manutenzione.
1. Scegliere **Modify (Modifica)**.
1. Scegli **Mostra altro** nella parte inferiore della pagina **Modifica cluster**.
1. Nella sezione **Finestra di manutenzione preferita**, imposta il giorno, l'ora e la durata della finestra di manutenzione come preferisci.
1. Scegli **Next (Successivo)**.
Nella pagina di conferma esaminare le modifiche.
1. Per applicare immediatamente le modifiche alla finestra di manutenzione, selezionare **Apply immediately (Applica immediatamente)**.
1. Scegli **Invia** per applicare le modifiche.
Per cambiare le modifiche, scegli **Precedente** oppure, per annullare le modifiche, scegli **Annulla**.
## Utilizzo AutoMinorVersionUpgrade per controllare gli aggiornamenti automatici delle versioni secondarie
**Importante**
`AutoMinorVersionUpgrade` è efficace solo per gli aggiornamenti della versione secondaria successivi alla [release del motore 1.3.0.0](engine-releases-1.3.0.0.md).
Se il campo `AutoMinorVersionUpgrade` è impostato su `true` nell'istanza writer (primaria) del cluster di database, gli aggiornamenti della versione secondaria vengono applicati automaticamente a tutte le istanze del cluster di database durante la finestra di manutenzione successiva dopo che vengono rilasciati.
Se il campo `AutoMinorVersionUpgrade` è stato impostato su `false` nell'istanza writer del cluster di database, vengono applicati solo se [installi in maniera esplicita](engine-updates-manually.md#engine-minor-updates-using-console).
**Nota**
Le release delle patch (`*.*.*.1`, `*.*.*.2` e così via) vengono sempre installate automaticamente durante la successiva finestra di manutenzione, a prescindere dall'impostazione del parametro `AutoMinorVersionUpgrade`.
È possibile impostare `AutoMinorVersionUpgrade` utilizzando Console di gestione AWS quanto segue:
**Per impostare `AutoMinorVersionUpgrade` mediante la console Neptune**
1. [Accedi alla console di AWS gestione e apri la console Amazon Neptune da casa. https://console.aws.amazon.com/neptune/](https://console.aws.amazon.com/neptune/home)
1. Nel pannello di navigazione, seleziona **Database**.
1. Scegli l'istanza (writer) primaria del cluster di database per cui desideri impostare `AutoMinorVersionUpgrade`.
1. Scegli **Modifica**.
1. Scegli **Mostra altro** nella parte inferiore della pagina **Modifica cluster**.
1. Nella parte inferiore della pagina espansa, scegli **Attiva l'aggiornamento automatico della versione secondaria** o **Disattiva l'aggiornamento automatico della versione secondaria**.
1. Scegli **Next (Successivo)**.
Nella pagina di conferma esaminare le modifiche.
1. Per applicare le modifiche all'aggiornamento automatico della versione secondaria, seleziona **Applica immediatamente**.
1. Scegli **Invia** per applicare le modifiche.
Per cambiare le modifiche, scegli **Precedente** oppure, per annullare le modifiche, scegli **Annulla**.
Puoi anche usare il AWS CLI per impostare il `AutoMinorVersionUpgrade` campo. Ad esempio, per impostarlo su `true`, puoi utilizzare un comando come il seguente:
```
1. aws neptune modify-db-instance \
2. --db-instance-identifier (the ID of your cluster's writer instance) \
3. --auto-minor-version-upgrade \
4. --apply-immediately
```
Allo stesso modo, per impostarlo su `false`, utilizza un comando come il seguente:
```
1. aws neptune modify-db-instance \
2. --db-instance-identifier (the ID of your cluster's writer instance) \
3. --no-auto-minor-version-upgrade \
4. --apply-immediately
```