

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Instalar atualizações em dispositivos Snowball Edge
<a name="install-updates"></a>

Depois de obter as atualizações por download, você precisa instalá-las e reiniciar o dispositivo para que as atualizações entrem em vigor. O procedimento a seguir fornece instruções para instalar atualizações manualmente.

Em clusters de dispositivos Snowball Edge, a atualização deverá ser baixada e instalada em cada dispositivo no cluster.

**nota**  
Suspenda todas as atividades no dispositivo antes de instalar as atualizações de software. A instalação de atualizações para as instâncias em execução e interrompe todas as gravações em buckets do Amazon S3 no dispositivo. Isso pode resultar em perda de dados

**Para instalar atualizações de software que já foram baixadas para o Snowball Edge autônomo**

1. Abra uma janela de terminal e verifique se o dispositivo do Snowball Edge está desbloqueado com o comando `describe-device`. Se o dispositivo estiver bloqueado, use o comando `unlock-device` para desbloqueá-lo. Para ter mais informações, consulte [Unlocking the Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/unlockdevice.html).

1. Execute o comando `list-services` para ver os serviços disponíveis no dispositivo. O comando retorna o serviço IDs de cada serviço disponível no dispositivo.

   ```
   snowballEdge list-services                    
   ```  
**Example da saída do comando `list-services`**  

   ```
   {
     "ServiceIds" : [ "greengrass", "fileinterface", "s3", "ec2", "s3-snow" ]
   }
   ```

1. Em relação a cada ID de serviço identificado pelo comando `list-services`, execute o comando `describe-service` para ver o status. Use essas informações para identificar os serviços a serem interrompidos.

   ```
   snowballEdge describe-service --service-id service-id                    
   ```  
**Example da saída do comando `describe-service`**  

   ```
   {
   "ServiceId" : "s3",
     "Status" : {
       "State" : "ACTIVE"
     },
   "Storage" : {
   "TotalSpaceBytes" : 99608745492480,
   "FreeSpaceBytes" : 99608744468480
   },
   "Endpoints" : [ {
   "Protocol" : "http",
   "Port" : 8080,
   "Host" : "192.0.2.0"
   }, {
   "Protocol" : "https",
   "Port" : 8443,
   "Host" : "192.0.2.0",
   "CertificateAssociation" : {
   "CertificateArn" : "arn:aws:snowball-device:::certificate/6d955EXAMPLEdb71798146EXAMPLE3f0"
     }
    } ]
   }
   ```

   Essa saída mostra que o serviço `s3` está ativo e deve ser interrompido usando o comando `stop-service`.

1. Use o comando `stop-service` para interromper cada serviço em que o valor do nome `State` esteja `ACTIVE` na saída do comando `list-services`. Se mais de um serviço estiver em execução, interrompa cada um antes de continuar.
**nota**  
Os serviços do adaptador Amazon S3 EC2 AWS STS, Amazon e IAM não podem ser interrompidos. Se o armazenamento compatível com o Amazon S3 no Snowball Edge estiver em execução, pare-o antes de instalar as atualizações. O armazenamento compatível com Amazon S3 no Snowball Edge tem como o. `s3-snow` `serviceId`

   ```
   snowballEdge stop-service --service-id service-id --device-ip-addresses snow-device-1-ip-address snow-device-device-2-ip-address snow-device-3-ip-address --manifest-file path/to/manifest/file.bin --unlock-code 29-character-unlock-code --endpoint https://snow-device-ip-address
   ```  
**Example da saída do comando `stop-service`**  

   ```
   Stopping the AWS service on your Snowball Edge. You can determine the status of the AWS service using the describe-service command.                    
   ```

1. Execute o comando `snowballEdge install-updates`.

1. Você pode verificar o status dessa instalação com o comando `snowballEdge describe-device-software`. Enquanto uma atualização estiver sendo instalada, o status será exibido com esse comando.

**Exemplo de saída**  
`Install State: Installing //Possible values[NA, Installing, Requires Reboot]`

   Você instalou uma atualização de software com êxito em seu dispositivo do Snowball Edge. A instalação de uma atualização não a aplica automaticamente ao dispositivo. Para concluir a instalação da atualização, o dispositivo deve ser reiniciado.
**Atenção**  
A reinicialização do dispositivo do Snowball Edge sem interromper todas as atividades no dispositivo pode resultar em perda de dados.

1. Quando todos os serviços do dispositivo tiverem parado, reinicie-o, desbloqueie-o e reinicie-o novamente. Isso conclui a instalação das atualizações de software baixadas. Para obter mais informações sobre a reinicialização do dispositivo, consulte Reinicializando o Snowball Edge [Reinicializando o Snowball](https://docs.aws.amazon.com/snowball/latest/developer-guide/reboot.html) . Para obter mais informações sobre como desbloquear o dispositivo, consulte Desbloqueando o Snowball Edge [Desbloqueando o Snowball](https://docs.aws.amazon.com/snowball/latest/developer-guide/unlockdevice.html) .

1. Quando o dispositivo for ligado após a segunda reinicialização, desbloqueie-o.

1. Execute o comando `check-for-updates`. Esse comando retorna a versão mais recente disponível do software Snowball Edge, além da versão atual instalada no dispositivo.

**Como instalar atualizações de software já baixadas para um cluster de dispositivos Snowball Edge**

1. Em relação a cada dispositivo no cluster, execute o comando `describe-device` para saber se os dispositivos estão desbloqueados. Se os dispositivos estiverem bloqueados, use o comando `unlock-cluster` para desbloqueá-los. Para ter mais informações, consulte [Unlocking the Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/unlockdevice.html).

1. Em relação a cada dispositivo no cluster, execute o comando `list-services` para ver os serviços disponíveis no dispositivo. O comando retorna o serviço IDs de cada serviço disponível no dispositivo.

   ```
   snowballEdge list-services                    
   ```  
**Example da saída do comando `list-services`**  

   ```
   {
     "ServiceIds" : [ "greengrass", "fileinterface", "s3", "ec2", "s3-snow" ]
   }
   ```

1. Em relação a cada ID de serviço identificado pelo comando `list-services`, execute o comando `describe-service` para ver o status. Use essas informações para identificar os serviços a serem interrompidos.

   ```
   snowballEdge describe-service --service-id service-id                    
   ```  
**Example da saída do comando `describe-service`**  

   ```
   {
   "ServiceId" : "s3",
     "Status" : {
       "State" : "ACTIVE"
     },
   "Storage" : {
   "TotalSpaceBytes" : 99608745492480,
   "FreeSpaceBytes" : 99608744468480
   },
   "Endpoints" : [ {
   "Protocol" : "http",
   "Port" : 8080,
   "Host" : "192.0.2.0"
   }, {
   "Protocol" : "https",
   "Port" : 8443,
   "Host" : "192.0.2.0",
   "CertificateAssociation" : {
   "CertificateArn" : "arn:aws:snowball-device:::certificate/6d955EXAMPLEdb71798146EXAMPLE3f0"
     }
    } ]
   }
   ```

   Essa saída mostra que o serviço `s3` está ativo e deve ser interrompido usando o comando `stop-service`.

1. Em relação a cada dispositivo no cluster, use o comando `stop-service` para interromper cada serviço em que o valor do nome `State` esteja `ACTIVE` na saída do comando `list-services`. Se mais de um serviço estiver em execução, interrompa cada um antes de continuar. 
**nota**  
Os serviços do adaptador Amazon S3 EC2 AWS STS, Amazon e IAM não podem ser interrompidos. Se o armazenamento compatível com o Amazon S3 no Snowball Edge estiver em execução, pare-o antes de instalar as atualizações. O armazenamento compatível com Amazon S3 no Snowball Edge tem como o. `s3-snow` `serviceId`

   ```
   snowballEdge stop-service --service-id service-id --device-ip-addresses snow-device-1-ip-address snow-device-device-2-ip-address snow-device-3-ip-address --manifest-file path/to/manifest/file.bin --unlock-code 29-character-unlock-code --endpoint https://snow-device-ip-address
   ```  
**Example da saída do comando `stop-service`**  

   ```
   Stopping the AWS service on your Snowball Edge. You can determine the status of the AWS service using the describe-service command.                    
   ```

1. Em relação a cada dispositivo no cluster, execute o comando `install-updates`.

   ```
   snowballEdge install-updates                    
   ```

1. Você pode verificar o status dessa instalação com o comando `describe-device-software`.

   ```
   snowballEdge describe-device-software                    
   ```  
**Example da saída do comando `describe-device-service`**  

   ```
   Install State: Installing //Possible values[NA, Installing, Requires Reboot]
   ```

   Quando o `Install State` for `Requires Reboot`, você instalou a atualização de software com êxito no dispositivo Snowball Edge. A instalação de uma atualização não a aplica automaticamente ao dispositivo. Para concluir a instalação da atualização, o dispositivo deve ser reiniciado.
**Atenção**  
A reinicialização do dispositivo Snowball Edge sem interromper todas as atividades no dispositivo pode ocasionar a perda de dados.

1. Reinicialize todos os dispositivos no cluster, desbloqueie o cluster e reinicialize todos os dispositivos novamente. Isso conclui a instalação das atualizações de software baixadas. Para obter mais informações sobre a reinicialização dos dispositivos, consulte [Reinicializando o Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/reboot.html). Para ter mais informações sobre como desbloquear o cluster de dispositivos, consulte [Unlocking the Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/unlockdevice.html).

1. Depois que cada dispositivo no cluster for reinicializado duas vezes, desbloqueie o cluster e use o comando `check-for-updates` para verificar se o dispositivo foi atualizado. Esse comando retorna a versão mais recente disponível do software Snowball Edge, além da versão atual instalada no dispositivo. Se a versão atual e a versão mais recente disponível forem iguais, o dispositivo foi atualizado com êxito. 

Agora você atualizou com êxito o Snowball Edge ou o cluster de dispositivos e confirmou a atualização para o software Snowball Edge mais recente.