Instalar no Linux

Leva poucos minutos por servidor. Em geral, a equipe Heewa faz a instalação com você; esta página é para quando a sua equipe de TI preferir instalar.

Antes de começar

Os arquivos de instalação, enviados pela equipe Heewa: o programa keep-agent e um segundo arquivo que vem junto com ele. Os dois precisam ficar na mesma pasta.
O código de ativação do servidor, no formato XXXX-XXXX-XXXX. Ele vale por 24 horas e ativa uma única máquina. Peça à equipe Heewa.
Acesso de root (sudo).
O servidor ligado e com internet.
O endereço do servidor de ativação: https://api.keep.heewa.com.br.

Funciona em Linux de 64 bits (x86_64) com systemd, o padrão das distribuições atuais.

Passo a passo

Copie os arquivos de instalação para uma pasta vazia no servidor, por exemplo /tmp/keep.
Entre na pasta, deixe os arquivos executáveis e instale:
Janela do terminal
```
cd /tmp/keep
chmod +x ./*
sudo ./keep-agent install
```

Ative o agente:

sudo /opt/keep/keep-agent activate --server https://api.keep.heewa.com.br

Quando aparecer Activation code:, cole o código e aperte Enter. Nada aparece na tela enquanto você digita ou cola: é de propósito.
A saída termina dizendo que o serviço foi reiniciado (restarted).
Confira o agente:
Janela do terminal
```
sudo /opt/keep/keep-agent status
systemctl status keep-agent
```
A linha service: precisa mostrar running, a linha activation: precisa trazer o endereço https://api.keep.heewa.com.br, e o systemd precisa mostrar o serviço ativo.
Os arquivos em /tmp/keep já podem ser apagados.
Avise a equipe Heewa que o servidor foi instalado. Ela confere o primeiro contato e pode iniciar o primeiro backup na hora, sem esperar o horário da política.

O código de ativação nunca vai num argumento da linha de comando: assim ele não aparece na lista de processos nem no histórico do shell.

Depois de instalar

O primeiro backup é o mais demorado, porque envia tudo; os seguintes enviam só o que mudou. Uma interrupção (servidor reiniciado, internet que caiu) não perde nada: o backup continua de onde parou. Quanto tempo leva depende do volume e da velocidade de upload da internet; a tabela em Instalar no Windows dá uma ideia.

Numa máquina nova, a saúde que a equipe Heewa acompanha vai de Aguardando para Atenção (backup feito, ainda não testado) e, depois do primeiro teste automático de restauração, para Protegido. Isso pode levar cerca de uma semana, e é normal.

Atualizar ou desinstalar

Atualizar: com os arquivos novos numa pasta, rode sudo ./keep-agent install de dentro dela. O servidor continua ativado.
Desinstalar: sudo /opt/keep/keep-agent uninstall. A identidade do servidor fica guardada: reinstalar depois não pede um código novo.

Se der errado

O código não vale, venceu ou já foi usado: peça um código novo à equipe Heewa. Uma ativação recusada não gasta o código.
O install falha reclamando de um arquivo que falta ou que não confere: os dois arquivos de instalação não estão na mesma pasta, ou um deles não é o que a equipe Heewa enviou. Copie os dois juntos, de novo.
“device already activated”: esse servidor já está ativado no Keep. Não tente forçar uma nova ativação por conta própria; fale com a equipe Heewa.
“the server’s certificate is not trusted”: confira se o endereço foi digitado certo. Se estiver, algo na rede pode estar interceptando a conexão, como um proxy que inspeciona HTTPS. Fale com a equipe Heewa.
O serviço não aparece como running: mande à equipe Heewa a saída de sudo /opt/keep/keep-agent status e de systemctl status keep-agent.

Detalhes para a TI


Programa	`/opt/keep/`
Dados do agente	`/var/lib/keep/`, só root
Registros (JSON)	`/var/log/keep/`, só root
Serviço	`keep-agent.service` (systemd), reinicia sozinho depois de uma falha
Rede	só conexões de saída por HTTPS; nenhuma porta de entrada
Proxy	o agente respeita a variável `HTTPS_PROXY` do ambiente do serviço
Prioridade	o backup roda com prioridade baixa de processador e de disco

status sem root: mostra só o estado do serviço. Código de saída: 0 rodando, 3 parado, 4 não instalado.
Remoção completa: sudo /opt/keep/keep-agent uninstall --purge apaga também a identidade do servidor. Depois disso, ele só volta ao Keep com um código novo, como uma máquina nova. Combine com a equipe Heewa antes.