# Gerenciar pacote de componentes do VSS para snapshots do EBS baseados no VSS do Windows
Antes de criar snapshots do EBS baseados no VSS, verifique se você tem a versão mais recente do pacote de componentes do VSS instalada na sua instância do Windows. Existem várias maneiras possíveis de instalar o pacote `AwsVssComponents` em uma instância existente. Veja abaixo:
+ (Recomendado) [Execução do documento de comando AWSEC2-VssInstallAndSnapshot (recomendado)](create-vss-snapshots-ssm.md#create-with-AWSEC2-VssInstallAndSnapshot). Se necessário, isso faz a instalação ou a atualização automaticamente toda vez que for executado.
+ [Instalar manualmente os componentes do VSS em uma instância EC2 Windows](#install-vss-comps).
+ [Atualizar o pacote de componentes do VSS na instância EC2 Windows](#update-vss-comps).
Você também pode criar uma AMI com o EC2 Image Builder que usa o componente gerenciado `aws-vss-components-windows` para instalar o pacote `AwsVssComponents` da imagem. O componente gerenciado usa o AWS Systems Manager Distributor para instalar o pacote. Depois que o Image Builder criar a imagem, toda instância que você executar na AMI associada terá o pacote VSS instalado nela. Para obter mais informações sobre como criar uma AMI com o pacote VSS instalado, consulte [Componentes gerenciados do pacote do Distributor para Windows](https://docs.aws.amazon.com/imagebuilder/latest/userguide/mgdcomponent-distributor-win.html) no *Guia do usuário do EC2 Image Builder*.
**Topics**
+ [Instalação manual](#install-vss-comps)
+ [Atualizar componentes](#update-vss-comps)
## Instalar manualmente os componentes do VSS em uma instância EC2 Windows
Sua instância do EC2 para Windows deve ter componentes VSS instalados antes de criar snapshots consistentes com aplicações usando o Systems Manager. Se você não executar o documento do comando `AWSEC2-VssInstallAndSnapshot` para instalar ou atualizar automaticamente o pacote toda vez que criar snapshots consistentes com aplicações, deverá instalar o pacote manualmente.
Você também deve fazer a instalação manualmente se planeja usar um dos métodos a seguir para criar snapshots consistentes com aplicações usando a instância do EC2.
+ Criar snapshots do VSS usando o AWS Backup
+ Criar snapshots do VSS usando o Amazon Data Lifecycle Manager
Se precisar fazer uma instalação manual, recomendamos usar o pacote de componentes do AWS VSS mais recente para melhorar a confiabilidade e a performance de snapshots consistentes com aplicações nas suas instâncias do EC2 para Windows.
**nota**
Para instalar ou atualizar automaticamente o pacote `AwsVssComponents` sempre que você criar snapshots consistentes com a aplicação, recomendamos que use o Systems Manager para executar o documento `AWSEC2-VssInstallAndSnapshot`. Para obter mais informações, consulte [Execução do documento de comando AWSEC2-VssInstallAndSnapshot (recomendado)](create-vss-snapshots-ssm.md#create-with-AWSEC2-VssInstallAndSnapshot).
Para instalar os componentes do VSS em uma instância do Windows do Amazon EC2, siga as etapas para o ambiente de sua preferência.
------
#### [ Console ]
**Instalar os componentes do VSS usando o SSM Distributor**
1. Abra o console do AWS Systems Manager em [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. No painel de navegação, selecione **Executar comando**.
1. Selecione **Run command (Executar comando)**.
1. Em **Command document (Documento do comando)**, selecione o botão ao lado de **AWS-ConfigureAWSPackage**.
1. Em **Command parameters (Parâmetros do comando)**, faça o seguinte:
1. Verifique se **Action (Ação)** está definida como **Install (Instalar)**.
1. Em **Name (Nome)**, insira `AwsVssComponents`.
1. Em **Versão**, insira uma versão ou deixe o campo vazio para que o Systems Manager instale a versão mais recente.
1. Em **Targets (Destinos)**, identifique as instâncias nas quais você deseja executar essa operação especificando tags ou selecionando instâncias manualmente.
**nota**
Se você optar por selecionar manualmente as instâncias e uma instância que você espera visualizar não estiver incluída na lista, consulte [Algumas das minhas instâncias estão ausentes](https://docs.aws.amazon.com/systems-manager/latest/userguide/troubleshooting-remote-commands.html#where-are-instances) no *Manual do usuário do AWS Systems Manager* para obter dicas para solução de problemas.
1. Para **Other parameters (Outros parâmetros)**:
+ (Opcional) Em **Comment (Comentário)**, digite informações sobre esse comando.
+ Em **Timeout (seconds) (Tempo limite [segundos])**, especifique o número de segundos para o sistema aguardar até a falha de execução do comando total.
1. (Opcional) Em **Rate control (Controle de taxa)**:
+ Em **Concurrency (Concorrência)**, especifique um número ou uma porcentagem de instâncias nas quais executar o comando ao mesmo tempo.
**nota**
Se tiver selecionado destinos escolhendo tags do Amazon EC2 e não tiver certeza de quantas instâncias usam tags selecionadas, limite o número de instâncias que podem executar o documento ao mesmo tempo especificando uma porcentagem.
+ Em **Error threshold (Limite de erro)**, especifique quando parar de executar o comando em outras instâncias depois de falhar em alguns ou em uma porcentagem de instâncias. Por exemplo, se você especificar três erros, o Systems Manager deixará de enviar o comando quando o 4° erro for recebido. As instâncias que continuam processando o comando também podem enviar erros.
1. (Opcional) Na seção **Output options (Opções de saída)**, se você quiser salvar a saída de comando em um arquivo, selecione a caixa ao lado de **Enable writing to an S3 bucket (Habilitar a gravação em um bucket do S3)**. Especifique o bucket e os nomes (de pastas) de prefixo (opcional).
**nota**
As permissões do S3 que concedem a possibilidade de gravar os dados em um bucket do S3 são as do perfil de instância atribuído à instância, e não as do usuário que realiza essa tarefa. Para obter mais informações, consulte [Configurar permissões de instância do EC2](https://docs.aws.amazon.com/systems-manager/latest/userguide/setup-instance-permissions.html#instance-profile-add-permissions) no *Guia do usuário do AWS Systems Manager*.
1. (Opcional) Especifique opções para **SNS notifications (Notificações do SNS)**.
Para obter informações sobre como configurar notificações do Amazon SNS para o Run Command, consulte [Configuração das notificações do Amazon SNS para o AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/monitoring-sns-notifications.html).
1. Escolha **Run**.
------
#### [ AWS CLI ]
Use o procedimento a seguir para baixar e instalar o pacote `AwsVssComponents` em suas instâncias usando o Run Command por meio da AWS CLI. O pacote instala dois componentes: um solicitante de VSS e um fornecedor de VSS. O sistema copia esses componentes para um diretório na instância e, em seguida, registra a DLL do fornecedor como um fornecedor de VSS.
**Para instalar o pacote do VSS**
Execute o comando a seguir para fazer download e instalar os componentes do VSS necessários para o Systems Manager.
```
aws ssm send-command \
--document-name "AWS-ConfigureAWSPackage" \
--instance-ids "i-1234567890abcdef0" \
--parameters '{"action":["Install"],"name":["AwsVssComponents"]}'
```
------
#### [ PowerShell ]
Use o procedimento a seguir para fazer baixar e instalar o pacote `AwsVssComponents` em suas instâncias usando o Run Command por meio do Tools for Windows PowerShell. O pacote instala dois componentes: um solicitante de VSS e um fornecedor de VSS. O sistema copia esses componentes para um diretório na instância e, em seguida, registra a DLL do fornecedor como um fornecedor de VSS.
**Para instalar o pacote do VSS**
Execute o comando a seguir para fazer download e instalar os componentes do VSS necessários para o Systems Manager.
```
Send-SSMCommand `
-DocumentName "AWS-ConfigureAWSPackage" `
-InstanceId "i-1234567890abcdef0" `
-Parameter @{'action'='Install';'name'='AwsVssComponents'}
```
------
### Verifique a assinatura nos componentes do AWS VSS
Use o procedimento a seguir para verificar a assinatura no pacote `AwsVssComponents`.
1. Conecte-se à sua instância do Windows. Para obter mais informações, consulte [Conectar-se à instância do Windows no usando RDP](connecting_to_windows_instance.md).
1. Navegue até C:\$1Program Files\$1Amazon\$1AwsVssComponents.
1. Abra o menu de contexto de `ec2-vss-agent.exe` (clique com o botão direito do mouse) e escolha **Propriedades**.
1. Navegue até a guia **Assinaturas digitais** e verifique se o nome do signatário é Amazon Web Services Inc.
1. Use as etapas anteriores para verificar a assinatura em `Ec2VssInstaller` e `Ec2VssProvider.dll`.
## Atualizar o pacote de componentes do VSS na instância EC2 Windows
Recomendamos que você sempre mantenha os componentes do VSS atualizados com a versão mais recente recomendada. Existem diversas maneiras diferentes de atualizar componentes quando uma nova versão do pacote `AwsVssComponents` é lançada.
**Métodos de atualização**
+ É possível repetir as etapas descritas em [Instalar manualmente os componentes do VSS em uma instância EC2 Windows](#install-vss-comps) quando uma nova versão dos componentes do AWS VSS é lançada.
+ É possível configurar uma associação do State Manager do Systems Manager para baixar e instalar automaticamente os componentes novos ou atualizados do VSS quando o pacote `AwsVssComponents` ficar disponível.
+ Para instalar ou atualizar automaticamente o pacote `AwsVssComponents` sempre que você criar snapshots consistentes com a aplicação, ao usar o Systems Manager para executar o documento `AWSEC2-VssInstallAndSnapshot`.
**nota**
Recomendamos que você use o Systems Manager para executar o documento de comando `AWSEC2-VssInstallAndSnapshot`, que instala ou atualiza automaticamente o pacote `AwsVssComponents` antes de criar snapshots consistentes com a aplicação. Para obter mais informações, consulte [Execução do documento de comando AWSEC2-VssInstallAndSnapshot (recomendado)](create-vss-snapshots-ssm.md#create-with-AWSEC2-VssInstallAndSnapshot).
Para criar uma associação do State Manager do Systems Manager, siga as etapas do ambiente de sua preferência.
------
#### [ Console ]
Ao configurar uma associação no Gerenciador de Estados do Systems Manager, é possível atualizar o pacote `AwsVssComponents` de duas formas, conforme abaixo:
**Desinstalar e instalar novamente**
Esse método faz o download e instala o pacote sem necessidade de pré-requisitos adicionais.
**Atualizar no local**
Este método executa uma atualização no local para o pacote e requer os seguintes pré-requisitos:
+ A versão do SSM Agent instalada na instância deve ser a `3.3.808.0` ou posterior. Para obter mais informações, consulte [Trabalhar com o SSM Agent em instâncias do Amazon EC2 para Windows Server](https://docs.aws.amazon.com/systems-manager/latest/userguide/ssm-agent-windows.html) no *Guia do usuário do AWS Systems Manager*.
+ Caso seja especificado, o pacote `AwsVssComponents` deve estar na versão `2.5.0` ou posterior. As versões anteriores não são compatíveis com a atualização no local.
Caso sua instância não cumpra esses pré-requisitos, a atualização no local não será bem-sucedida. Use a opção **Desinstalar e instalar novamente** em vez disso.
**Para criar uma associação do State Manager**
1. Abra o console AWS Systems Manager em [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. No painel de navegação, escolha **State Manager**.
Ou, se a página inicial do Systems Manager abrir primeiro, abra o painel de navegação e escolha **Gerenciador de Estados**.
1. Selecione **Criar associação**.
1. No campo **Association Name (Nome da associação)**, insira um nome descritivo.
1. Na lista **Documento**, escolha **AWS-ConfigureAWSPackage**.
1. Na seção **Parameters Parâmetros)**, escolha **Install (Instalar)** na lista **Action (Ação)**.
1. Em **Tipo de instalação**, escolha **Desinstalar e instalar novamente** ou **Atualização no local**.
1. No campo **Name** (Nome), insira `AwsVssComponents`. É possível manter os campos **Version** (Versão) e **Additional Arguments** (Argumentos adicionais) vazios.
1. Na seção **Select Targets by**, escolha uma opção.
**nota**
Se você optar por especificar instâncias de destino usando tags e especificar tags que são mapeadas para instâncias do Linux, a associação será bem-sucedida na instância do Windows, mas falhará nas instâncias do Linux. O status geral da associação mostra **Failed**.
1. Na seção **Specify schedule**, escolha uma opção.
1. Na seção **Advanced options (Opções avançadas)**, em **Compliance severity (Severidade de conformidade)**, escolha um nível de gravidade para a associação. Para obter mais informações, consulte [Saiba mais sobre a conformidade de associações](https://docs.aws.amazon.com/systems-manager/latest/userguide/compliance-about.html). Em **Calendários de alteração**, selecione um calendário de alterações pré-configurado. Para obter mais informações, consulte [Calendário de alterações do AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-change-calendar.html).
1. Em **Controle de taxa**, faça o seguinte:
+ Em **Concurrency** (Concorrência), especifique um número ou uma porcentagem de nós gerenciados nos quais executar o comando ao mesmo tempo.
+ Em **Error threshold** (Limite de erro), especifique quando parar de executar o comando em outros nós depois de falhar em alguns ou em uma porcentagem de nós.
1. (Opcional) Em **Opções de saída**, para salvar a saída de comando em um arquivo, selecione a caixa **Habilitar gravação da saída no S3**. Digite os nomes de bucket e prefixo (pastas) nas caixas de texto.
1. Escolha **Create Association** (Criar associação) e, em seguida, **Close** (Fechar). O sistema tenta criar a associação nas instâncias e aplicar imediatamente o estado.
**nota**
Se as instâncias do EC2 para o Windows Server mostrarem o status **Com falha**, verifique se o SSM Agent está sendo executado na instância e se a instância está configurada com um perfil do AWS Identity and Access Management (IAM) para o Systems Manager. Para obter mais informações, consulte [Configurar o AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-ec2.html).
------
#### [ AWS CLI ]
Use o comando [create-association](https://docs.aws.amazon.com/cli/latest/reference/ssm/create-association.html) para atualizar um pacote do Distributor conforme uma programação sem deixar a aplicação associada offline. Somente arquivos novos ou atualizados no pacote são substituídos.
**Para criar uma associação do State Manager**
Execute o comando a seguir para criar uma associação. O valor de `--name`, o nome do documento, é sempre `AWS-ConfigureAWSPackage`. O comando a seguir usa a chave `InstanceIds` para especificar as instâncias de destino.
```
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 ]
**Para criar uma associação do State Manager**
Use o cmdlet [New-SSMAssociation](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")
}
```
------