

# Instalar o driver do ENA em instâncias do Windows do EC2
<a name="ena-adapter-driver-install-upgrade-win"></a>

Se sua instância não for baseada em uma das mais recentes imagens de máquina da Amazon (AMIs) do Windows que a Amazon fornece, use o procedimento a seguir para instalar o driver ENA atual em sua instância. Execute esta atualização em um momento conveniente para reinicializar sua instância. Se o script de instalação não reinicializar automaticamente sua instância, recomendamos que você reinicie a instância como etapa final.

Se você usar um volume de armazenamento de instância para armazenar dados enquanto a instância estiver em execução, esses dados serão apagados quando você interromper a instância. Antes de interromper sua instância, verifique se você copiou todos os dados necessários dos volumes de armazenamento de instância para um armazenamento persistente, como o Amazon EBS ou o Amazon S3.

## Pré-requisitos
<a name="ena-driver-install-prereq-win"></a>

Para instalar ou atualizar o driver ENA, sua instância do Windows deve atender aos seguintes pré-requisitos:
+ A versão 3.0 ou posterior do PowerShell está instalada.
+ Os comandos descritos nesta seção devem ser executados na versão de 64 bits do PowerShell. Não use a versão `x86` do PowerShell. Essa é a versão de 32 bits do shell e não é compatível com esses comandos.

## Etapa 1: fazer backup de seus dados
<a name="ena-driver-install-step1-backup-win"></a>

Recomendamos que você crie uma AMI de backup caso não consiga reverter suas alterações por meio do **Gerenciador de dispositivos**. Para criar uma AMI de backup com o Console de gerenciamento da AWS, siga estas etapas:

1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. No painel de navegação, escolha **Instances (Instâncias)**.

1. Selecione a instância que requer a atualização do driver e escolha **Interromper instância** no menu **Estado da instância**.

1. Depois de interromper a instância, selecione a instância novamente. Para criar seu backup, escolha **Imagem e modelos** no menu **Ações** e escolha **Criar imagem**.

1. Para reiniciar sua instância, escolha **Iniciar instância** no menu **Estado da instância**.

## Etapa 2: instalar ou atualizar seu driver ENA
<a name="ena-driver-install-step2-install-win"></a>

É possível instalar ou atualizar seu driver ENA com o AWS Systems Manager Distributor ou com os cmdlets do PowerShell. Para obter mais instruções, selecione a guia que corresponde ao método que deseja utilizar.

------
#### [ Systems Manager Distributor ]

É possível usar o recurso do Systems Manager Distributor para implantar pacotes nos nós gerenciados do Systems Manager. Com o Systems Manager Distributor, você pode instalar o pacote de driver ENA uma vez ou com atualizações programadas. Para obter mais informações sobre como instalar o pacote de driver ENA (`AwsEnaNetworkDriver`) com o Systems Manager Distributor, consulte [Instalar ou atualizar pacotes](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor-working-with-packages-deploy.html) no *Guia do usuário do AWS Systems Manager*. 

------
#### [ PowerShell ]

Esta seção aborda como fazer o download e instalar pacotes de drivers ENA em sua instância com cmdlets do PowerShell.

**Opção 1: fazer o download e extrair a versão mais recente**

1. Conecte-se à instância e faça login como administrador local.

1. Use o cmdlet **invoke-webrequest** para fazer o download do pacote de driver mais recente:

   ```
   PS C:\> invoke-webrequest https://ec2-windows-drivers-downloads.s3.amazonaws.com/ENA/Latest/AwsEnaNetworkDriver.zip -outfile {{$env:USERPROFILE\AwsEnaNetworkDriver.zip}}
   ```
**nota**  
Se você receber um erro ao baixar o arquivo e estiver usando o Windows Server 2016 ou anterior, talvez seja necessário habilitar o TLS 1.2 para seu terminal PowerShell. É possível habilitar o TLS 1.2 para a sessão atual do PowerShell com o comando a seguir e tentar novamente:  

   ```
   [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
   ```
Como alternativa, você pode fazer o download do pacote de driver mais recente em uma janela do navegador em sua instância.

1. Use o cmdlet **expand-archive** para extrair o arquivo zip que você baixou para sua instância:

   ```
   PS C:\> expand-archive {{$env:userprofile\AwsEnaNetworkDriver.zip}} -DestinationPath {{$env:userprofile\AwsEnaNetworkDriver}}
   ```

**Opção 2: fazer o download e extrair uma versão específica**

1. Conecte-se à instância e faça login como administrador local.

1. Faça o download do pacote do driver ENA para a versão específica desejada no link da versão na tabela [Histórico da versão do driver do ENA do Windows](ena-driver-releases-windows.md#ena-win-driver-release-history).

1. Extraia o arquivo zip para sua instância.

**Instalar o driver ENA com o PowerShell**  
As etapas de instalação são as mesmas, independentemente de você ter feito o download do driver mais recente ou de uma versão específica. Para instalar o driver ENA, siga estas etapas:

1. Instale o driver, execute o script `install.ps1` do PowerShell do diretório do `AwsEnaNetworkDriver` em sua instância. Se você receber um erro, verifique se está usando o PowerShell 3.0 ou posterior.

1. Se o instalador não reinicializar automaticamente sua instância, execute o cmdlet **Restart-Computer** do PowerShell.

   ```
   PS C:\> Restart-Computer
   ```

------

## Etapa 3 (opcional): verificar a versão do driver ENA após a instalação
<a name="ena-driver-install-step3-verify-win"></a>

Para garantir que o pacote do driver ENA tenha sido instalado com êxito em sua instância, você pode verificar a nova versão da seguinte forma:

1. Conecte-se à instância e faça login como administrador local.

1. Para abrir o Gerenciador de dispositivos do Windows, insira `devmgmt.msc` na caixa **Run** (Executar).

1. Escolha **OK**. Isso abre a janela Gerenciador de dispositivos.

1. Selecione a seta à esquerda de **Network adapters** (Adaptadores de rede) para expandir a lista.

1. Escolha o nome ou abra o menu de contexto para **Amazon Elastic Network Adapter** (Adaptador do Amazon Elastic Network) e, depois, escolha **Properties** (Propriedades). Isso abre a caixa de diálogo **Propriedades do Adaptador de Rede Elástica da Amazon**.
**nota**  
Todos os adaptadores ENA usam o mesmo driver. Caso tenha vários adaptadores ENA, será possível selecionar qualquer um deles para atualizar o driver de todos os adaptadores ENA.

1. Para verificar a versão atual instalada, abra a guia **Driver** e verifique a **Versão do driver**. Se a versão atual não corresponder à sua versão de destino, consulte [Solução de problemas do driver do Adaptador de Rede Elástica do Windows](troubleshoot-ena-driver.md).

## Reverter a instalação de um driver ENA
<a name="ena-driver-install-roll-back-win"></a>

Se algo der errado com a instalação, talvez seja necessário reverter o driver. Siga estas etapas para reverter para a versão anterior do driver ENA que estava instalada em sua instância.

1. Conecte-se à instância e faça login como administrador local.

1. Para abrir o Gerenciador de dispositivos do Windows, insira `devmgmt.msc` na caixa **Run** (Executar).

1. Escolha **OK**. Isso abre a janela Gerenciador de dispositivos.

1. Selecione a seta à esquerda de **Network adapters** (Adaptadores de rede) para expandir a lista.

1. Escolha o nome ou abra o menu de contexto para **Amazon Elastic Network Adapter** (Adaptador do Amazon Elastic Network) e, depois, escolha **Properties** (Propriedades). Isso abre a caixa de diálogo **Propriedades do Adaptador de Rede Elástica da Amazon**.
**nota**  
Todos os adaptadores ENA usam o mesmo driver. Caso tenha vários adaptadores ENA, será possível selecionar qualquer um deles para atualizar o driver de todos os adaptadores ENA.

1. Para reverter o driver, abra a guia **Driver** e escolha **Reverter driver**. Isso abre a janela de **Reversão do pacote de driver**.
**nota**  
Se a guia **Driver** não mostrar a ação **Reverter driver** ou se a ação não estiver disponível, isso significa que o [armazenamento de drivers](https://learn.microsoft.com/en-us/windows-hardware/drivers/install/driver-store) em sua instância não contém o pacote de driver instalado anteriormente. Para solucionar esse problema, consulte [Cenários de solução de problemas](troubleshoot-ena-driver.md#ts-ena-drv-scenarios) e expanda a seção **Versão inesperada do driver ENA instalada**. Para obter mais informações sobre o processo de seleção do pacote de driver de dispositivo, consulte [Como o Windows seleciona um pacote de driver para um dispositivo](https://learn.microsoft.com/en-us/windows-hardware/drivers/install/how-windows-selects-a-driver-for-a-device) no *site de documentação da Microsoft*.