Instalar no Windows

Leva poucos minutos por máquina. 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

• O instalador keep-agent.msi, enviado pela equipe Heewa. Use sempre o arquivo mais recente que ela mandou.
• O código de ativação da máquina, no formato XXXX-XXXX-XXXX. Ele vale por 24 horas e ativa uma única máquina. Peça à equipe Heewa.
• Acesso de administrador na máquina.
• A máquina ligada e com internet.
• O endereço do servidor de ativação: https://api.keep.heewa.com.br.

Funciona no Windows 10 e 11 e no Windows Server 2016 em diante, 64 bits (x64).

Passo a passo

1. Copie o keep-agent.msi para a máquina, por exemplo para a pasta Downloads.

2. Abra o Prompt de Comando como administrador: clique em Iniciar, digite cmd, clique com o botão direito em Prompt de Comando e escolha Executar como administrador.

3. Entre na pasta do instalador:

   cd %USERPROFILE%\Downloads

4. Rode a instalação, trocando XXXX-XXXX-XXXX pelo seu código de ativação:

   start /wait msiexec /i keep-agent.msi /qn ACTIVATION_CODE=XXXX-XXXX-XXXX SERVER_URL=https://api.keep.heewa.com.br

5. Espere o Prompt de Comando voltar, em 1 ou 2 minutos. Nenhuma janela aparece: a instalação roda em silêncio (/qn), e o start /wait faz o comando esperar até ela terminar.

6. Confira o resultado:

   echo %ERRORLEVEL%

   0 quer dizer que deu certo. Qualquer outro número, veja Se der errado.

7. Confira o agente:

   "C:\Program Files\Keep\keep-agent.exe" status

   A linha service: precisa mostrar running, e a linha activation: precisa trazer o endereço https://api.keep.heewa.com.br.

8. Avise a equipe Heewa que a máquina foi instalada. Ela confere o primeiro contato da máquina e pode iniciar o primeiro backup na hora, sem esperar o horário da política.

Nota

O Windows pode avisar que o programa é de um “editor desconhecido”: o instalador ainda não tem assinatura digital. Confirme só se o arquivo veio diretamente da equipe Heewa.

Sem o código na linha de comando

O comando acima deixa o código no histórico do Prompt de Comando. Como o código vale uma vez só e é gasto na própria instalação, o risco é pequeno. Se preferir que ele não apareça em lugar nenhum, instale sem o código e ative em seguida:

start /wait msiexec /i keep-agent.msi /qn
"C:\Program Files\Keep\keep-agent.exe" 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.

Depois de instalar

O primeiro backup é o mais demorado, porque envia tudo; os seguintes enviam só o que mudou. Dá para usar o computador normalmente enquanto isso, e uma interrupção (máquina desligada, internet que caiu) não perde nada: o backup continua de onde parou.

Quanto tempo leva depende do volume de dados e da velocidade de upload da internet. Uma ideia, antes da compressão:

Dados	20 Mbps	50 Mbps	100 Mbps
500 GB	cerca de 2,3 dias	cerca de 22 horas	cerca de 11 horas
1 TB	cerca de 4,6 dias	cerca de 1,9 dia	cerca de 22 horas

Numa máquina nova, a saúde que a equipe Heewa acompanha vai de Aguardando (primeiro backup em andamento) 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: rode o MSI novo, sem o código, num Prompt de Comando como administrador: start /wait msiexec /i keep-agent.msi /qn. A máquina continua ativada.
• Desinstalar: em Configurações, Aplicativos, procure Keep Agent e clique em Desinstalar. Reinstalar depois não pede um código novo.

Cuidado

Desinstalar o agente não avisa o Keep. Sem ele, a máquina para de ter backup, e depois de dois dias sem sinal você e a equipe Heewa passam a receber alertas. Avise a equipe antes de desinstalar, formatar ou aposentar uma máquina: ela a desliga do sistema, e os backups antigos continuam guardados.

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 echo %ERRORLEVEL% mostra 1603: a instalação falhou e foi desfeita inteira, sem deixar nada pela metade. Rode de novo gravando um registro da instalação e envie o arquivo instalar.log à equipe Heewa. O código de ativação não aparece nesse registro.

  start /wait msiexec /i keep-agent.msi /qn /l*v instalar.log ACTIVATION_CODE=XXXX-XXXX-XXXX SERVER_URL=https://api.keep.heewa.com.br

• “SERVER_URL is required with ACTIVATION_CODE.”: faltou o SERVER_URL=https://api.keep.heewa.com.br no comando.

• “device already activated”: essa máquina já está ativada 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 ou um antivírus que inspeciona HTTPS. Fale com a equipe Heewa.

Detalhes para a TI

Programa	C:\Program Files\Keep\
Dados do agente e registros	C:\ProgramData\Keep\, acessível só por SYSTEM e Administradores
Serviço	KeepAgent (“Keep Agent”), conta LocalSystem, início automático atrasado, cerca de 2 minutos depois de o Windows ligar
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

• Instalação remota: o MSI aceita a instalação silenciosa, então o mesmo comando pode ser rodado por uma ferramenta de acesso remoto, como administrador.
• Remoção completa: start /wait msiexec /x keep-agent.msi /qn PURGE=1 apaga também a identidade da máquina. Depois disso, ela só volta ao Keep com um código novo, como uma máquina nova. Combine com a equipe Heewa antes.