Usa i documenti di comando di Systems Manager per creare snapshot basati su VSS - Amazon Elastic Compute Cloud
Parametri per i documenti Systems Manager per snapshot VSSEsecuzione dei documenti di comando Systems Manager per snapshot VSS

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à.

Usa i documenti di comando di Systems Manager per creare snapshot basati su VSS

È possibile utilizzare i documenti di AWS Systems Manager comando per creare istantanee basate su VSS. Il seguente contenuto introduce i documenti di comando disponibili e i parametri di runtime utilizzati dai documenti per creare gli snapshot.

Prima di utilizzare uno dei documenti di comando di Systems Manager, assicurati di aver soddisfatto tutti i Prerequisiti per creare snapshot EBS basati su Windows VSS.

Parametri per i documenti Systems Manager per snapshot VSS

I documenti Systems Manager che creano snapshot VSS utilizzano tutti i seguenti parametri, eccetto dove segnalato:

AmiName(stringa, opzionale)

Se l'CreateAmiopzione è impostata suTrue, specifica il nome dell'AMI creato dal backup.

description (stringa, facoltativo)

Specifica una descrizione per gli snapshot o l'immagine creata da questo processo.

CollectDiagnosticLogs(stringa, opzionale)

Per raccogliere ulteriori informazioni durante le fasi di creazione di snapshot e AMI, imposta questo parametro su "True". Il valore predefinito per questo parametro è "False". I log di diagnostica consolidati vengono salvati come formato archivio .zip nella seguente posizione sull'istanza:

C:\ProgramData\Amazon\AwsVss\Logs\timestamp.zip

CopyOnly(stringa, opzionale)

Se si utilizza il backup nativo di SQL Server oltre a AWS VSS, l'esecuzione di un backup di sola copia impedisce a AWS VSS di interrompere la catena di backup differenziale nativa. Per eseguire un'operazione di backup di sola copia, imposta questo parametro su True.

Il valore predefinito per questo parametro èFalse, che fa sì che AWS VSS esegua un'operazione di backup completa.

CreateAmi(stringa, opzionale)

Per creare un'Amazon Machine Image (AMI) basata su VSS per il backup dell'istanza, imposta questo parametro su True. Il valore predefinito per questo parametro è False, che esegue invece il backup dell'istanza con uno snapshot EBS.

Per ulteriori informazioni sulla creazione di un'AMI da un'istanza, consulta la pagina Creare un'AMI supportata da Amazon EBS.

executionTimeout (stringa, facoltativo)

Specifica il tempo massimo in secondi per eseguire il processo di creazione degli snapshot sull'istanza o per creare un'AMI dall'istanza. L'aumento di questo timeout consente al comando di attendere più a lungo l'avvio del blocco da parte di VSS e di completare il tagging delle risorse create. Questo timeout si applica solo alle fasi di creazione degli snapshot o dell'AMI. Il passaggio iniziale per installare o aggiornare il pacchetto AwsVssComponents non è incluso nel timeout.

ExcludeBootVolume(stringa, opzionale)

Questa impostazione esclude i volumi di avvio dal processo di backup se si creano snapshot. Per escludere i volumi di avvio dalle istantanee, imposta ExcludeBootVolumesu True e CreateAmisuFalse.

Se si crea un'AMI per il backup, questo parametro deve essere impostato su False. Il valore predefinito per questo parametro è False.

NoWriters(stringa, opzionale)

Per escludere i writer VSS dell'applicazione dal processo di snapshot, imposta questo parametro suTrue. L'esclusione dei writer VSS dell'applicazione può aiutarti a risolvere i conflitti con componenti di backup VSS di terze parti. Il valore predefinito per questo parametro è False.

Se SaveVssMetadata è True, questo parametro deve essere impostato su False.

SaveVssMetadata(stringa, opzionale)

Per salvare i file di metadati VSS durante ogni snapshot, imposta questo parametro su True. Il valore predefinito è False. I file di metadati VSS aiutano a fornire informazioni dettagliate su quali componenti o scrittori sono stati inclusi in un'operazione di backup e sui file associati per ciascun componente.

I file di metadati hanno l'ID del set di snapshot associato nei loro nomi. Puoi trovarli nella seguente posizione sull'istanza:

C:\ProgramData\Amazon\AwsVss\VssMetadata\
avvertimento

  • Il salvataggio dei file di metadati VSS richiede AwsVssComponents la versione del pacchetto 2.4.0 o successive. Se nell'istanza è installata una versione precedente, l'impostazione di SaveVssMetadata su Truecompromette la creazione dello snapshot.

  • I parametri NoWriters e SaveVssMetadata si escludono a vicenda. Se entrambi sono impostati su True, la creazione dello snapshot non va a buon fine.

tags (stringa, facoltativo)

Si consiglia di assegnare tag agli snapshot e alle immagini per facilitare l'individuazione e la gestione delle risorse, ad esempio per ripristinare i volumi da un elenco di snapshot. Il sistema aggiunge la chiave Name, con un valore vuoto in cui è possibile specificare il nome che si desidera applicare agli snapshot o alle immagini di output.

Ulteriori tag possono essere elencati separandoli con un punto e virgola. Ad esempio Key=Environment,Value=Test;Key=User,Value=TestUser1.

Nota

Le chiavi e i valori dei tag devono contenere solo caratteri alfanumerici e i seguenti caratteri speciali:. () ./\-"'@_+:={}

Per impostazione predefinita, il sistema aggiunge i seguenti tag riservati per snapshot e immagini basate su VSS.

  • Dispositivo: per snapshot basati su VSS, questo è il nome del dispositivo del volume EBS acquisito dallo snapshot.

  • AppConsistent— Questo tag indica la corretta creazione di un'istantanea o di un AMI basato su VSS.

  • AwsVssConfig— Identifica le istantanee create con AMIs VSS abilitato. Il tag include meta informazioni come la versione AwsVssComponents e l'ID del set di snapshot nei loro nomi.

avvertimento

Specificare uno di questi tag riservati nell'elenco dei parametri causerà un errore.

VssVersion(stringa, opzionale)

Solo per il documento AWSEC2-VssInstallAndSnapshot, puoi specificare il parametro VssVersion per installare una versione specifica del pacchetto AwsVssComponents sull'istanza. Lascia vuoto questo parametro per installare la versione predefinita consigliata.

Se la versione specificata del pacchetto AwsVssComponents è già installata, lo script salta la fase di installazione e passa alla fase di backup. Per un elenco delle versioni del pacchetto AwsVssComponents e del supporto operativo, consulta AWS Cronologia delle versioni della soluzione VSS.

Esecuzione dei documenti di comando Systems Manager per snapshot VSS

È possibile creare istantanee EBS basate su VSS con documenti di AWS Systems Manager comando come segue.

Quando si utilizza AWS Systems Manager per eseguire il AWSEC2-VssInstallAndSnapshot documento, lo script esegue i seguenti passaggi.

  1. Lo script installa o aggiorna innanzitutto il pacchetto AwsVssComponents sull'istanza, a seconda che sia già installato.

  2. Lo script crea snapshot coerenti con l'applicazione dopo il completamento del primo passaggio.

Per eseguire il documento AWSEC2-VssInstallAndSnapshot, segui i passaggi relativi al tuo ambiente preferito.

Console
Creazione di snapshot EBS basatu su VSS dalla console

  1. Aprire la AWS Systems Manager console all'indirizzo https://console.aws.amazon.com/systems-manager/.

  2. Nel riquadro di navigazione, seleziona Esegui comando. Questo mostra un elenco di comandi correntemente in esecuzione nel tuo account, se applicabile.

  3. Seleziona Run command (Esegui comando). Si apre un elenco di documenti di comando a cui si ha accesso.

  4. Seleziona AWSEC2-VssInstallAndSnapshot dall'elenco dei documenti di comando. Per semplificare i risultati, puoi inserire tutto o parte del nome del documento. Puoi anche filtrare per proprietario, per tipo di piattaforma o per tag.

    Quando si seleziona un documento di comando, i dettagli vengono inseriti sotto l'elenco.

  5. Seleziona Default version at runtime dall'elenco delle versioni del documento.

  6. Configura i parametri del comando per definire come AWSEC2-VssInstallAndSnapshot installerà il pacchetto AwsVssComponents ed eseguire il backup con snapshot VSS o un'AMI. Per i dettagli dei parametri, consulta Parametri per i documenti Systems Manager per snapshot VSS.

  7. In Selezione della destinazione, specifica i tag o seleziona manualmente le istanze per identificare le istanze su cui eseguire questa operazione.

    Nota

    Se selezioni manualmente le istanze e l'istanza prevista non è inclusa nell'elenco, consulta Dove sono le mie istanze? per suggerimenti sulla risoluzione dei problemi.

  8. Per i parametri aggiuntivi per la definizione del comportamento dei comandi di esecuzione di Systems Manager, ad esempio il controllo della velocità, immetti i valori come descritto in Esecuzione di comandi dalla console.

  9. Selezionare Run (Esegui).

    In caso di esito positivo, il comando compila l'elenco degli snapshot EBS con i nuovi snapshot. È possibile trovare questi snapshot nell'elenco degli snapshot EBS cercando i tag specificati o AppConsistent. I motivi dettagliati di un eventuale errore nell'esecuzione del comando sono disponibili nell'output del comando di Systems Manager. Nel caso in cui l'esecuzione del comando risulti completata con successo, ma non sia riuscito il backup di un determinato volume, è possibile risolvere il problema dall'elenco dei volumi EBS.

AWS CLI

È possibile eseguire i seguenti comandi in AWS CLI per creare istantanee EBS basate su VSS e visualizzare lo stato della creazione delle istantanee.

Creazione di snapshot basati su VSS

Esegui il comando seguente per creare snapshot EBS basati su VSS. Per creare gli snapshot, devi identificare le istanze con il parametro --instance-ids. Per ulteriori informazioni sugli altri parametri che è possibile utilizzare, consulta Parametri per i documenti Systems Manager per snapshot VSS.

aws ssm send-command \
	--document-name "AWSEC2-VssInstallAndSnapshot" \
	--instance-ids "i-01234567890abcdef" \
	--parameters '{"ExcludeBootVolume":["False"],"description":["Description"],"tags":["Key=key_name,Value=tag_value"],"VssVersion":[""]}'

In caso di esito positivo, il documento di comando compila l'elenco degli snapshot EBS con i nuovi snapshot. È possibile trovare questi snapshot nell'elenco degli snapshot EBS cercando i tag specificati o AppConsistent. I motivi dettagliati di un eventuale errore nell'esecuzione del comando sono disponibili nell'output del comando.

Ottenere lo stato del comando

Per ottenere lo stato corrente degli snapshot, esegui il comando riportato utilizzando l'ID del comando restituito da send-command.

aws ssm get-command-invocation
	--instance-ids "i-01234567890abcdef" \
	--command-id "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" \
	--plugin-name "CreateVssSnapshot"
PowerShell

Esegui i seguenti comandi con AWS Tools for Windows PowerShell per creare istantanee EBS basate su VSS e ottenere lo stato di runtime corrente per la creazione dell'output. Specifica i parametri descritti nell'elenco precedente per modificare il comportamento del processo di snapshot.

Crea istantanee EBS basate su VSS con Tools for Windows PowerShell

Esegui il comando seguente per creare istantanee EBS basate su VSS o. AMIs

Send-SSMCommand -DocumentName "AWSEC2-VssInstallAndSnapshot" -InstanceId "i-01234567890abcdef" -Parameter @{'ExcludeBootVolume'='False';'description'='a_description'
	;'tags'='Key=key_name,Value=tag_value';'VssVersion'=''}
Ottenere lo stato del comando

Per ottenere lo stato corrente degli snapshot, esegui il comando riportato utilizzando l'ID del comando restituito da Send-SSMCommand.

Get-SSMCommandInvocationDetail -InstanceId "i-01234567890abcdef" -CommandId "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" -PluginName "CreateVssSnapshot"

In caso di esito positivo, il comando compila l'elenco degli snapshot EBS con i nuovi snapshot. È possibile trovare questi snapshot nell'elenco degli snapshot EBS cercando i tag specificati o AppConsistent. I motivi dettagliati di un eventuale errore nell'esecuzione del comando sono disponibili nell'output del comando.

Per eseguire il documento AWSEC2-CreateVssSnapshot, segui i passaggi relativi al tuo ambiente preferito.

Console
Creazione di snapshot EBS basatu su VSS dalla console

  1. Apri la AWS Systems Manager console all'indirizzo https://console.aws.amazon.com/systems-manager/.

  2. Nel riquadro di navigazione, seleziona Esegui comando. Questo mostra un elenco di comandi correntemente in esecuzione nel tuo account, se applicabile.

  3. Seleziona Run command (Esegui comando). Si apre un elenco di documenti di comando a cui si ha accesso.

  4. Seleziona AWSEC2-CreateVssSnapshot dall'elenco dei documenti di comando. Per semplificare i risultati, puoi inserire tutto o parte del nome del documento. Puoi anche filtrare per proprietario, per tipo di piattaforma o per tag.

    Quando si seleziona un documento di comando, i dettagli vengono inseriti sotto l'elenco.

  5. Seleziona Default version at runtime dall'elenco delle versioni del documento.

  6. Configura i parametri del comando per definire come AWSEC2-CreateVssSnapshot eseguirà il backup con snapshot VSS o un'AMI. Per i dettagli dei parametri, consulta Parametri per i documenti Systems Manager per snapshot VSS.

  7. In Selezione della destinazione, specifica i tag o seleziona manualmente le istanze per identificare le istanze su cui eseguire questa operazione.

    Nota

    Se selezioni manualmente le istanze e l'istanza prevista non è inclusa nell'elenco, consulta Dove sono le mie istanze? per suggerimenti sulla risoluzione dei problemi.

  8. Per i parametri aggiuntivi per la definizione del comportamento dei comandi di esecuzione di Systems Manager, ad esempio il controllo della velocità, immetti i valori come descritto in Esecuzione di comandi dalla console.

  9. Selezionare Run (Esegui).

    In caso di esito positivo, il comando compila l'elenco degli snapshot EBS con i nuovi snapshot. È possibile trovare questi snapshot nell'elenco degli snapshot EBS cercando i tag specificati o AppConsistent. I motivi dettagliati di un eventuale errore nell'esecuzione del comando sono disponibili nell'output del comando di Systems Manager. Nel caso in cui l'esecuzione del comando risulti completata con successo, ma non sia riuscito il backup di un determinato volume, è possibile risolvere il problema dall'elenco dei volumi EBS.

AWS CLI

È possibile eseguire il seguente comando in AWS CLI per creare istantanee EBS basate su VSS.

Creazione di snapshot basati su VSS

Esegui il comando seguente per creare snapshot EBS basati su VSS. Per creare gli snapshot, devi identificare le istanze con il parametro --instance-ids. Per ulteriori informazioni sugli altri parametri che è possibile utilizzare, consulta Parametri per i documenti Systems Manager per snapshot VSS.

aws ssm send-command \
	--document-name "AWSEC2-CreateVssSnapshot" \
	--instance-ids "i-01234567890abcdef" \
	--parameters '{"ExcludeBootVolume":["False"],"description":["Description"],"tags":["Key=key_name,Value=tag_value"]}'

In caso di esito positivo, il documento di comando compila l'elenco degli snapshot EBS con i nuovi snapshot. È possibile trovare questi snapshot nell'elenco degli snapshot EBS cercando i tag specificati o AppConsistent. I motivi dettagliati di un eventuale errore nell'esecuzione del comando sono disponibili nell'output del comando.

PowerShell

Esegui il comando seguente con AWS Tools for Windows PowerShell per creare istantanee EBS basate su VSS.

Crea istantanee EBS basate su VSS con Tools for Windows PowerShell

Esegui il comando seguente per creare snapshot EBS basati su VSS. Per creare gli snapshot, devi identificare le istanze con il parametro InstanceId. È possibile specificare più di un'istanza per cui creare snapshot. Per ulteriori informazioni sugli altri parametri che è possibile utilizzare, consulta Parametri per i documenti Systems Manager per snapshot VSS.

Send-SSMCommand -DocumentName AWSEC2-CreateVssSnapshot -InstanceId "i-01234567890abcdef" -Parameter @{'ExcludeBootVolume'='False';'description'='a_description'
	;'tags'='Key=key_name,Value=tag_value'}

In caso di esito positivo, il comando compila l'elenco degli snapshot EBS con i nuovi snapshot. È possibile trovare questi snapshot nell'elenco degli snapshot EBS cercando i tag specificati o AppConsistent. I motivi dettagliati di un eventuale errore nell'esecuzione del comando sono disponibili nell'output del comando. Nel caso in cui l'esecuzione del comando risulti completata con successo, ma non sia riuscito il backup di un determinato volume, è possibile risolvere il problema dall'elenco degli snapshot EBS.

È possibile utilizzare una qualsiasi delle procedure della linea di comando descritte nella sezione precedente per creare uno snapshot basato su VSS. Il documento del comando (AWSEC2-VssInstallAndSnapshot o AWSEC2-CreateVssSnapshot) deve essere eseguito sul nodo primario del cluster. Il documento avrà esito negativo sui nodi secondari in quanto non hanno accesso ai dischi condivisi. Se il primario e il secondario cambiano dinamicamente, puoi AWS Systems Manager eseguire il documento Run Command su più nodi con l'aspettativa che il comando abbia esito positivo sul nodo primario e abbia esito negativo sui nodi secondari.

Nota

Per automatizzare i backup, è possibile creare un'operazione della finestra di AWS Systems Manager manutenzione che utilizzi il documento. AWSEC2-VssInstallAndSnapshot Per ulteriori informazioni, consulta Utilizzo delle finestre di manutenzione (console) nella Guida per l'utente di AWS Systems Manager .