Instalar o Agente de Backup no Windows

Este guia mostra como instalar o agente de backup do Ello Backup no computador de um cliente.

Antes de começar

Confirme que os seguintes itens estão disponíveis antes de iniciar:

Computador com Windows 10 ou superior
Acesso à conta de administrador do Windows
Conexão com a internet
As informações de acesso fornecidas pela equipe Ello:
- Endereço do servidor de backup
- Credenciais de acesso ao armazenamento remoto
- Caminho da pasta onde estão os arquivos de dados do sistema Ello

Passo a passo da instalação

1. Baixar os arquivos

Obtenha o pacote de instalação com a equipe técnica da Ello.

2. Preencher as configurações

Antes de rodar o instalador, abra o arquivo de configuração (chamado de .env) com o Bloco de Notas e preencha as informações:

Endereço do servidor de backup — fornecido pela equipe Ello
Usuário e senha do banco de dados — geralmente SYSDBA / masterkey (padrão do Firebird)
Endereço, usuário e senha do armazenamento remoto — fornecidos pela equipe Ello
Pasta dos dados — caminho completo onde estão os arquivos de base de dados (ex: C:\Ello\Dados\)
Tipo de arquivo de banco — normalmente “ello”

Não deixe nenhum campo em branco. O instalador vai travar se alguma informação estiver faltando.

3. Executar o instalador

Clique com o botão direito no arquivo install.bat
Escolha “Executar como administrador”
Acompanhe o progresso na janela que abrirá
O instalador irá automaticamente:
- Instalar o PHP (se necessário)
- Instalar o Composer (gerenciador de dependências)
- Ativar as extensões necessárias do PHP
- Criar o atalho de inicialização automática
- Iniciar o agente pela primeira vez

4. Aguardar a conclusão

O processo leva entre 5 e 15 minutos dependendo da velocidade da internet. Quando terminar, o agente já estará rodando em segundo plano.

Verificar se o agente está funcionando

Após a instalação, verifique no Painel Web:

Acesse a tela Clientes
O novo cliente deve aparecer na lista (pode levar alguns minutos para aparecer)
Inicialmente, o cliente aparece como inativo — isso é normal. Um atendente precisa ativar o cliente no painel para que os backups comecem.

Problemas comuns na instalação

Problema	Causa provável	O que fazer
“Acesso negado” ao rodar o instalador	Não foi executado como administrador	Clique com botão direito → “Executar como administrador”
Instalador trava por muito tempo na etapa do PHP	Instalador de pacotes do Windows não disponível	Aguardar; o instalador tentará um método alternativo automaticamente
Erro de campo em branco ou configuração inválida	Arquivo de configuração não foi preenchido corretamente	Revisar o arquivo .env e preencher todos os campos
Agente não aparece no painel após instalação	Endereço do servidor de backup incorreto	Verificar o endereço do servidor no arquivo de configuração
PHP instalado mas o agente não inicia	Extensões necessárias não foram ativadas	Localizar o arquivo de configuração do PHP (php.ini) e habilitar manualmente as extensões: openssl, curl, zip e ftp

Iniciando e parando o agente manualmente

Iniciar: Execute o arquivo start.vbs na pasta bin do agente. O agente inicia em segundo plano, sem janela visível.
Parar: Execute o arquivo stop.bat na pasta bin. Todos os processos do agente serão encerrados.

O arquivo start.vbs encerra todos os processos PHP em execução no computador antes de iniciar o agente. Se o cliente usar outros programas baseados em PHP, eles também serão interrompidos.

Inicialização automática

O instalador cria um atalho na pasta de inicialização automática do Windows. Isso garante que o agente seja iniciado automaticamente sempre que o computador for ligado, sem necessidade de ação manual.