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.