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à.
# Gestisci il pacchetto di componenti VSS per gli snapshot EBS basati su Windows VSS
Prima di creare snapshot EBS basati su VSS, assicurati di avere installata la versione più recente del pacchetto di componenti VSS sull'istanza Windows. È possibile installare il pacchetto `AwsVssComponents` su un'istanza esistente in diversi modi:
+ (Consigliato) [Esegui il documento di VssInstallAndSnapshot comando AWSEC2 - (consigliato)](create-vss-snapshots-ssm.md#create-with-AWSEC2-VssInstallAndSnapshot). In questo modo il componente si installa o si aggiorna automaticamente a ogni esecuzione.
+ [Installazione manuale dei componenti VSS su un'istanza di Windows EC2](#install-vss-comps).
+ [Aggiorna il pacchetto di componenti VSS sull'istanza di Windows EC2](#update-vss-comps).
È anche possibile creare un'AMI con EC2 Image Builder che utilizzi il componente gestito `aws-vss-components-windows` per installare il pacchetto `AwsVssComponents` per l'immagine. Il componente gestito utilizza AWS Systems Manager Distributor per installare il pacchetto. Dopo la creazione dell'immagine con Image Builder, ogni istanza avviata dall'AMI associata avrà il pacchetto VSS installato. Per ulteriori informazioni su come creare un'AMI con installato il pacchetto VSS, consulta [Distributor package managed components for Windows](https://docs.aws.amazon.com/imagebuilder/latest/userguide/mgdcomponent-distributor-win.html) nella *Guida per l'utente di EC2 Image Builder*.
**Topics**
+ [Installazione manuale](#install-vss-comps)
+ [Aggiornamento dei componenti](#update-vss-comps)
## Installazione manuale dei componenti VSS su un'istanza di Windows EC2
L'istanza Windows di EC2 deve avere installati i componenti VSS prima di poter creare snapshot coerenti a livello di applicazione con Systems Manager. Se non si esegue il documento di comando `AWSEC2-VssInstallAndSnapshot` per installare o aggiornare il pacchetto ogni volta che si creano snapshot coerenti a livello di applicazione, è necessario installare manualmente il pacchetto.
È necessario eseguire l'installazione manuale anche se si prevede di utilizzare uno dei seguenti metodi per creare snapshot coerenti a livello di applicazione dall'istanza EC2.
+ Crea istantanee VSS utilizzando AWS Backup
+ Creazione di snapshot VSS mediante Amazon Data Lifecycle Manager
Se è necessario eseguire un'installazione manuale, si consiglia di utilizzare il pacchetto di componenti AWS VSS più recente per migliorare l'affidabilità e le prestazioni delle istantanee coerenti con le applicazioni sulle istanze EC2 Windows.
**Nota**
Per installare o aggiornare automaticamente il pacchetto `AwsVssComponents` ogni volta che si creano snapshot coerenti con l'applicazione, si consiglia di utilizzare Systems Manager per eseguire il documento `AWSEC2-VssInstallAndSnapshot`. Per ulteriori informazioni, consulta [Esegui il documento di VssInstallAndSnapshot comando AWSEC2 - (consigliato)](create-vss-snapshots-ssm.md#create-with-AWSEC2-VssInstallAndSnapshot).
Per installare i componenti VSS su un'istanza Windows di Amazon EC2, segui i passaggi per il tuo ambiente preferito.
------
#### [ Console ]
**Installazione dei componenti VSS utilizzando SSM Distributor**
1. Apri la console all'indirizzo. AWS Systems Manager [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)
1. Nel riquadro di navigazione selezionare **Run Command**.
1. Selezionare **Run command**.
1. Per **il documento Command**, scegli il pulsante accanto a **AWS-Configure AWSPackage**.
1. In **Command parameters (Parametri di comando)**, effettuare le seguenti operazioni:
1. Verificare che **Action (Operazione)** sia impostata su **Install (Installa)**.
1. In **Name (Nome)**, immettere `AwsVssComponents`.
1. In **Versione**, lascia vuoto il campo per consentire a Systems Manager di installare l'ultima versione.
1. In **Targets (Destinazioni)**, identificare le istanze in cui si desidera eseguire questa operazione specificando i tag o selezionando le istanze manualmente.
**Nota**
Se scegli di selezionare manualmente le istanze e l'istanza prevista non è inclusa nell'elenco, consulta [Dove sono le mie istanze?](https://docs.aws.amazon.com/systems-manager/latest/userguide/troubleshooting-remote-commands.html#where-are-instances) nella *Guida per l'utente di AWS Systems Manager * per suggerimenti sulla risoluzione dei problemi.
1. In **Other parameters (Altri parametri)**:
+ (Opzionale) In **Comment (Commento)** digitare le informazioni su questo comando.
+ In **Timeout (seconds) (Timeout [secondi])**, specificare il numero di secondi che il sistema dovrà aspettare prima di generare un errore per l'intera esecuzione del comando.
1. (Facoltativo) In **Rate control (Controllo velocità)**:
+ In **Concurrency (Simultaneità)**, specificare un numero o una percentuale di istanze su cui eseguire contemporaneamente il comando.
**Nota**
Se le destinazioni sono state selezionate scegliendo i tag Amazon EC2 e non si conosce il numero di istanze utilizzate dai tag selezionati, limitare il numero di istanze che possono eseguire il documento contemporaneamente specificando una percentuale.
+ In **Error threshold (Soglia di errore)** specificare quando interrompere l'esecuzione del comando sulle altre istanze dopo un errore su un numero o una percentuale di istanze. Se ad esempio si specificano 3 errori, Systems Manager interrompe l'invio del comando quando riceve il quarto errore. Anche le istanze che elaborano ancora il comando potrebbero inviare errori.
1. (Opzionale) Nella sezione **Output options (Opzioni di output)**, se si desidera salvare l'output del comando in un file, selezionare la casella accanto a **Enable writing to an S3 bucket (Abilita la scrittura in un bucket S3)**. Specificare i nomi del bucket e (opzionale) del prefisso (cartella).
**Nota**
Le autorizzazioni S3 che assegnano la possibilità di scrivere dati in un bucket S3 sono quelle del profilo dell'istanza e non quelle dell'utente che esegue questa attività. Per ulteriori informazioni, consulta [Configure EC2 instance permissions](https://docs.aws.amazon.com/systems-manager/latest/userguide/setup-instance-permissions.html#instance-profile-add-permissions) nella *Guida per l’utente AWS Systems Manager *.
1. (Opzionale) Specificare le opzioni per **SNS notifications (Notifiche SNS)**.
Per informazioni sulla configurazione di notifiche Amazon SNS per Run Command, consultare [Configurazione delle notifiche Amazon SNS per AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/monitoring-sns-notifications.html).
1. Scegli **Esegui**.
------
#### [ AWS CLI ]
La seguente procedura consente di scaricare e installare il pacchetto `AwsVssComponents` sulle istanze utilizzando Run Command da AWS CLI. Il pacchetto installa due componenti: un richiedente VSS e un provider VSS. Il sistema copia questi componenti su una directory dell'istanza, poi registra il DLL del provider come provider VSS.
**Per installare il pacchetto VSS**
Esegui il comando seguente per scaricare e installare i componenti VSS necessari per Systems Manager.
```
aws ssm send-command \
--document-name "AWS-ConfigureAWSPackage" \
--instance-ids "i-1234567890abcdef0" \
--parameters '{"action":["Install"],"name":["AwsVssComponents"]}'
```
------
#### [ PowerShell ]
Usa la seguente procedura per scaricare e installare il `AwsVssComponents` pacchetto sulle tue istanze utilizzando Run Command dagli Strumenti per Windows. PowerShell Il pacchetto installa due componenti: un richiedente VSS e un provider VSS. Il sistema copia questi componenti su una directory dell'istanza, poi registra il DLL del provider come provider VSS.
**Per installare il pacchetto VSS**
Esegui il comando seguente per scaricare e installare i componenti VSS necessari per Systems Manager.
```
Send-SSMCommand `
-DocumentName "AWS-ConfigureAWSPackage" `
-InstanceId "i-1234567890abcdef0" `
-Parameter @{'action'='Install';'name'='AwsVssComponents'}
```
------
### Verifica la firma sui componenti AWS VSS
Utilizza la procedura seguente per verificare la firma sul pacchetto `AwsVssComponents`.
1. Connettersi all'istanza Windows. Per ulteriori informazioni, consulta [Connessione all’istanza Windows con il protocollo RDP](connecting_to_windows_instance.md).
1. Vai a C:\$1Program Files\$1 Amazon\$1AwsVssComponents.
1. Apri il menu contestuale (tasto destro del mouse) di `ec2-vss-agent.exe`, quindi seleziona **Proprietà**.
1. Vai alla scheda **Firme digitali** e verifica che il nome del firmatario sia Amazon Web Services Inc.
1. Utilizza i passaggi precedenti per verificare la firma su `Ec2VssInstaller` e `Ec2VssProvider.dll`.
## Aggiorna il pacchetto di componenti VSS sull'istanza di Windows EC2
Ti consigliamo di mantenere sempre aggiornato il componente VSS all'ultima versione consigliata. Quando viene rilasciata una nuova versione del pacchetto `AwsVssComponents`, è possibile aggiornare i componenti in diversi modi.
**Metodi di aggiornamento**
+ È possibile ripetere i passaggi descritti in [Installazione manuale dei componenti VSS su un'istanza di Windows EC2](#install-vss-comps) Quando viene rilasciata una nuova versione dei componenti AWS VSS.
+ È possibile configurare un'associazione State Manager di Systems Manager per scaricare e installare automaticamente nuovi componenti VSS quando il pacchetto `AwsVssComponents` diventa disponibile.
+ Quando si utilizza Systems Manager per eseguire il documento `AWSEC2-VssInstallAndSnapshot`, è possibile installare o aggiornare automaticamente il pacchetto `AwsVssComponents` ogni volta che si creano snapshot coerenti con l'applicazione.
**Nota**
Consigliamo di utilizzare Systems Manager per eseguire il documento del comando `AWSEC2-VssInstallAndSnapshot` che installa o aggiorna automaticamente il pacchetto `AwsVssComponents` prima di creare gli snapshot coerenti con l'applicazione. Per ulteriori informazioni, consulta [Esegui il documento di VssInstallAndSnapshot comando AWSEC2 - (consigliato)](create-vss-snapshots-ssm.md#create-with-AWSEC2-VssInstallAndSnapshot).
Per creare un'associazione Systems Manager State Manager, completa le operazioni per il tuo ambiente preferito.
------
#### [ Console ]
Quando crei un’associazione State Manager di Systems Manager, sono disponibili due opzioni per aggiornare il pacchetto `AwsVssComponents`, come segue:
**Disinstalla e reinstalla**
Questo metodo scarica e installa il pacchetto senza prerequisiti aggiuntivi.
**Aggiornamento sul posto**
Questa opzione esegue un aggiornamento sul posto del pacchetto e presenta i seguenti prerequisiti:
+ La versione dell’agente SSM installata sull’istanza deve essere la versione `3.3.808.0` o successiva. Per ulteriori informazioni, consulta [Installazione e configurazione di SSM Agent sulle istanze EC2 per Windows Server](https://docs.aws.amazon.com/systems-manager/latest/userguide/ssm-agent-windows.html) nella *Guida per l'utente di AWS Systems Manager *.
+ Se specificata, la versione del pacchetto `AwsVssComponents` deve essere la versione `2.5.0` o successiva. Le versioni precedenti non supportano l’aggiornamento sul posto.
se l’istanza non soddisfa questi prerequisiti, l’aggiornamento sul posto avrà esito negativo. Utilizza, invece, l’opzione **Disinstalla e reinstalla**.
**Per creare un’associazione di State Manager**
1. Apri la AWS Systems Manager console all'indirizzo [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Nel riquadro di navigazione, seleziona **State Manager**.
Oppure, se la home page di Systems Manager si apre per prima, apri il riquadro di navigazione e scegli **State Manager**.
1. Selezionare **Create association (Crea associazione)**.
1. Nel campo **Name (Nome)**, immettere un nome descrittivo.
1. Nell'elenco **Documento**, scegli **AWS-Configure AWSPackage**.
1. Nella sezione **Parameters (Parametri)**, scegliere **Install (Installa)** dall'elenco di **operazioni**.
1. Per il **tipo di installazione**, scegli **Disinstalla e reinstalla** o **Aggiornamento sul posto**.
1. Nel campo **Name (Nome)**, inserire `AwsVssComponents`. Puoi mantenere vuoti i campi **Version (Versione)** e **Additional Arguments (Argomenti aggiuntivi)**.
1. Nella sezione **Targets (Destinazioni)**, scegliere un'opzione.
**Nota**
Se si sceglie di definire come target le istanze mediante i tag e si specificano tag che mappano per istanze di Linux, l'associazione va a buon fine sull'istanza di Windows, ma non sulle istanze di Linux. Lo stato globale dell'associazione mostra **Failed (Non riuscito)**.
1. Scegliere una tra le opzioni disponibili in **Specify schedule (Specifica la pianificazione)**.
1. Nella sezione **Opzioni avanzate**, per **Gravità conformità**, scegliere un livello di gravità per l'associazione. Per ulteriori informazioni, consulta [Learn about association compliance](https://docs.aws.amazon.com/systems-manager/latest/userguide/compliance-about.html). In **Calendari di modifica**, seleziona un calendario di modifica preconfigurato. Per ulteriori informazioni, consulta la pagina [AWS Systems Manager Change Calendar](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-change-calendar.html).
1. In **Controllo della velocità**, procedi come segue:
+ In **Simultaneità**, specifica un numero o una percentuale di nodi gestiti su cui eseguire contemporaneamente il comando.
+ Per **Soglia di errore**, specificare quando interrompere l'esecuzione del comando sulle altri nodi gestiti dopo un errore su un numero o una percentuale di nodi.
1. (Facoltativo) In **Opzioni di output**, per salvare l'output del comando in un file, seleziona la casella **Abilita scrittura dell'output in S3**. Digita i nomi del bucket e del prefisso (cartella) nelle caselle.
1. Selezionare **Create association (Crea associazione)**, poi **Close (Chiudi)**. Il sistema tenta di creare l'associazione sulle istanze e di applicare immediatamente lo stato.
**Nota**
Se le istanze EC2 per Windows Server mostrano lo stato **Failed**, verifica che l'agente SSM sia in esecuzione sull'istanza e verifica che l'istanza sia configurata con un ruolo AWS Identity and Access Management (IAM) per Systems Manager. [Per ulteriori informazioni, consulta Configurazione. AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-ec2.html)
------
#### [ AWS CLI ]
Utilizza il comando [create-association](https://docs.aws.amazon.com/cli/latest/reference/ssm/create-association.html) per aggiornare un pacchetto Distributore in base a una pianificazione senza disconnettere l’applicazione associata. Vengono sostituiti solo i file nuovi o aggiornati nel pacchetto.
**Per creare un’associazione di State Manager**
Esegui il comando seguente per creare un'associazione. Il valore `--name`, ossia il nome del documento, è sempre `AWS-ConfigureAWSPackage`. Il comando seguente utilizza la chiave `InstanceIds` per specificare le istanze di destinazione.
```
aws ssm create-association \
--name "AWS-ConfigureAWSPackage" \
--parameters action=Install,installationType="Uninstall and reinstall",name=AwsVssComponents \
--targets Key=InstanceIds,Values=i-1234567890abcdef0,i-000011112222abcde
```
------
#### [ PowerShell ]
**Per creare un’associazione di State Manager**
Utilizzare il SSMAssociation cmdlet [New-](https://docs.aws.amazon.com/powershell/latest/reference/items/New-SSMAssociation.html).
```
New-SSMAssociation `
-Name "AWS-ConfigureAWSPackage" `
-Parameter @{
"action" = "Install"
"installationType" = "Uninstall and reinstall"
"name" = "AwsVssComponents"
} `
-Target @{
"Key" = "InstanceIds"
"Values" = @("i-1234567890abcdef0", "i-000011112222abcde")
}
```
------