> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ecotrust.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Atualizar um sensor

> Coloque seus sensores na versão mais recente em poucos passos, sem baixar outra licença.

Use este guia para atualizar o Connect-AI ou um sensor, como o Infra ou o Network, que já está instalado. A atualização troca a imagem antiga pela versão mais recente e mantém a mesma licença.

## Quando atualizar

* Quando a plataforma avisar que existe uma atualização para o sensor.
* Quando você quiser usar a versão mais recente.
* Quando reiniciar o container não resolver um problema. A atualização corrige falhas do container.

## Pré-requisitos

* Acesso ao terminal da máquina onde o sensor está instalado.
* A pasta onde está a licença do sensor, com o arquivo `.key`: a mesma pasta em que você rodou o comando na instalação, como mostra [Instalar o Connect](https://docs.ecotrust.io/connect/instalar.md#passos).
* Saída liberada da máquina pela porta 443 (TCP) para o Docker Hub, para baixar a nova imagem. As outras liberações de rede estão em [Requisitos do Connect](https://docs.ecotrust.io/connect/requisitos.md#rede).

## Passos

**1. Encontrar o container e a imagem do sensor**

No terminal da máquina, liste os containers e anote o **CONTAINER ID** do sensor que você vai atualizar. A coluna **IMAGE** mostra qual sensor é cada container.

```bash theme={"dark"}
docker ps -a
```

```text Exemplo de saída theme={"dark"}
CONTAINER ID   IMAGE                      CREATED       STATUS       NAMES
3f9c2a7d1b4e   cyberapp/sensor-infra:mt   3 weeks ago   Up 3 weeks   quirky_hopper
a81e5c09d2f7   cyberapp/connect-ai:mt     3 weeks ago   Up 3 weeks   brave_turing
```

Depois, liste as imagens e anote o **IMAGE ID** do mesmo sensor:

```bash theme={"dark"}
docker images
```

```text Exemplo de saída theme={"dark"}
REPOSITORY              TAG   IMAGE ID       CREATED        SIZE
cyberapp/sensor-infra   mt    7b2d4f8e1c3a   2 months ago   9.4GB
cyberapp/connect-ai     mt    c5e1a9f04b72   2 months ago   1.1GB
```

Neste exemplo, para atualizar o sensor Infra, você anota o container `3f9c2a7d1b4e` e a imagem `7b2d4f8e1c3a`.

**2. Remover o container e a imagem antiga**

Remova o container e, depois, a imagem do sensor, usando os identificadores que você anotou:

```bash theme={"dark"}
docker rm -fv <id-do-container>
docker rmi <id-da-imagem>
```

No exemplo do passo anterior, os comandos ficam assim:

```bash theme={"dark"}
docker rm -fv 3f9c2a7d1b4e
docker rmi 7b2d4f8e1c3a
```

Se der certo, o terminal responde com o identificador que foi removido.

A licença continua na pasta. Não é preciso baixar outra.

**3. Copiar o comando atualizado**

No painel, em **Ativos** > **Todos os Ambientes**, clique em **Comandos para ativação de sensores**. Escolha a aba do sistema da máquina, **Windows PowerShell** ou **GNU/Linux**, e copie o comando do sensor, sem alterar nenhuma opção.

![Janela com os comandos de ativação de cada sensor, nas abas Windows PowerShell e GNU/Linux.](https://mintcdn.com/eco-trust/l-a9SBmIe14YlqVm/images/connect/sensores/03-comandos-ativacao-sensores.png?fit=max\&auto=format\&n=l-a9SBmIe14YlqVm\&q=85\&s=56554cce2b13ed5169690fd21a76acd0)

Janela Comandos para ativação dos sensores locais. O ícone ao lado de cada comando copia o texto.

**4. Subir o sensor de novo**

No terminal, entre na pasta da licença, cole e rode o comando. O Docker baixa a imagem nova, o que pode levar alguns minutos.

**5. Confirmar que a nova versão subiu**

Acompanhe o log com `docker logs` seguido do identificador do novo container, até aparecer a mensagem **Sensor iniciado, pronto para uso.**

```text Exemplo de saída theme={"dark"}
$ docker logs 9d4b6e2a7c15
...
Sensor iniciado, pronto para uso.
```

O sensor Infra pode levar de 60 a 120 minutos para concluir o provisionamento, por causa da carga inicial dos testes de vulnerabilidade.

## Verificar o resultado

No painel, em **Sensores** > **Sensores de Scan**, a coluna **Estado Operacional** do sensor volta para **On**.

![Lista Sensores de Scan, com as colunas Tipo, Nome, Status Funcional, Estado Operacional e Ambiente.](https://mintcdn.com/eco-trust/l-a9SBmIe14YlqVm/images/connect/sensores/04-sensores-de-scan.png?fit=max\&auto=format\&n=l-a9SBmIe14YlqVm\&q=85\&s=cab9446a703eeabfac0d5de6ed881134)

Ambiente de exemplo. Tela Sensores de Scan: o sensor pronto aparece com o Estado Operacional On.

## Problemas comuns

> [accordion] O comando docker rmi diz que a imagem está em uso
>
> O container do sensor ainda existe. Rode `docker ps -a`, remova o container com `docker rm -fv` e tente de novo.

> [accordion] O log mostra Missing key file
>
> O comando rodou fora da pasta da licença. Remova o container, entre na pasta onde está o arquivo `.key` e rode o comando de novo.

> [accordion] O sensor continua Off depois da atualização
>
> Confira se o firewall libera a saída pela porta 443 para o endereço da sua instância EcoTrust e se o EDR tem as exceções do Connect, listadas em [Requisitos do Connect](https://docs.ecotrust.io/connect/requisitos.md#soluções-de-segurança). Depois, leia o log com `docker logs` seguido do identificador do container. O que cada mensagem quer dizer está em [Problemas comuns da instalação](https://docs.ecotrust.io/connect/instalar.md#mensagens-no-log-do-sensor). Se não resolver, o problema pode estar na máquina ou no sensor: escreva para [suporte@ecotrust.io](mailto:suporte@ecotrust.io) com o log do container, a saída de `free -h`, `df -h` e `docker version` e o sistema operacional da máquina.

## Relacionados

* [Instalar o Connect](https://docs.ecotrust.io/connect/instalar.md)
* [Tipos de Connect](https://docs.ecotrust.io/connect/tipos.md)
* [Requisitos do Connect](https://docs.ecotrust.io/connect/requisitos.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.