Solução de Problemas

Este guia ajuda a diagnosticar e resolver os problemas mais comuns do Ello Backup.

Como verificar o que está acontecendo

O primeiro passo é sempre verificar o Painel Web:

Acesse a tela Comunicação e veja quando o agente se comunicou pela última vez.
Se estiver vermelho (sem comunicação há mais de 3 dias), o agente provavelmente está parado ou com problema de conexão.
Verifique também se o cliente está ativo na tela Clientes.

O agente registra tudo o que faz em arquivos de registro diários, salvos dentro da pasta de instalação. Para ler:

Siga esta ordem antes de investigar um problema específico:

[ ] O agente está aparecendo no painel com comunicação recente (verde)?
[ ] O cliente está marcado como ativo no painel?
[ ] A pasta de dados tem bases de dados com o tipo de arquivo correto (ex: extensão .ello)?
[ ] Os arquivos de dados não têm espaços no nome nem a palavra “copia” no nome?
[ ] O arquivo de configuração (.env) foi preenchido corretamente?
[ ] O computador tem acesso à internet e ao servidor de armazenamento?
[ ] O Firebird está instalado no computador do cliente?

Sintoma	Causa provável	Solução
Instalador não abre ou fecha imediatamente	Não foi executado como administrador	Clique com botão direito → “Executar como administrador”
Erro de campo em branco ou configuração inválida	Arquivo de configuração (.env) incompleto	Abrir o arquivo .env e preencher todos os campos
Instalação trava por muito tempo na etapa do PHP	Problema de rede ou instalador de pacotes não disponível	Aguardar; o instalador tentará um método alternativo. Se continuar travado, instalar o PHP manualmente
Agente não aparece no painel após instalação	Endereço do servidor incorreto no arquivo de configuração	Revisar o endereço do servidor no arquivo .env
PHP instalado mas o agente não inicia	Extensões do PHP não foram ativadas corretamente	Localizar o arquivo de configuração do PHP e habilitar manualmente as extensões: openssl, curl, zip e ftp

Sintoma	Causa provável	Solução
Agente não faz backup de nenhuma base	Pasta de dados incorreta no arquivo de configuração	Verificar se o caminho da pasta está correto e que as bases estão lá
Agente ignora alguns arquivos de banco	Nome do arquivo tem espaço ou contém a palavra “copia”	Renomear o arquivo removendo espaços e a palavra “copia”
Agente ignora alguns arquivos de banco	Tipo de arquivo não corresponde ao configurado	Verificar a extensão dos arquivos e ajustar no arquivo de configuração
Nenhuma empresa identificada	Firebird não está instalado no computador	Instalar o Firebird no computador do cliente
Nenhuma empresa identificada	Usuário ou senha do banco de dados incorretos	Verificar as credenciais do Firebird no arquivo de configuração

Sintoma	Causa provável	Solução
Cliente registrado mas sem backups	Cliente não foi ativado no painel	Acessar o painel → Clientes → Editar → marcar como Ativo
Cliente ativo mas backup nunca roda	Nenhuma configuração de backup atribuída	Atribuir uma configuração de backup ao cliente no painel
Backup começa mas falha	Problema ao acessar a base de dados	Verificar se a base está sendo usada normalmente pelo sistema Ello e se as credenciais estão corretas
Backup cria arquivo mas não valida	Arquivo de backup pode estar corrompido	Verificar se há espaço suficiente no disco local

Sintoma	Causa provável	Solução
Erro “Falha ao conectar ao armazenamento”	Credenciais do servidor de armazenamento incorretas	Verificar endereço, usuário e senha do armazenamento no arquivo de configuração
Arquivo enviado mas não aparece no destino	Pasta de destino no armazenamento incorreta	Verificar o diretório configurado para o armazenamento
Erro ao criar pasta no armazenamento	Usuário do armazenamento não tem permissão de criar pastas	Verificar as permissões do usuário no servidor de armazenamento
Envio demora muito ou trava	Arquivo muito grande ou conexão lenta	Verificar a velocidade de conexão do cliente com o servidor

Sintoma	Causa provável	Solução
Painel mostra cliente em amarelo (1-3 dias sem comunicação)	Agente pode ter sido interrompido	Reiniciar o agente (ver abaixo)
Painel mostra cliente em vermelho (mais de 3 dias)	Agente parado, computador desligado ou problema de rede	Verificar se o computador está ligado e o agente rodando
Agente não consegue se conectar ao servidor	Endereço do servidor incorreto ou servidor fora do ar	Verificar o endereço no arquivo de configuração e se o servidor está acessível

Sintoma	Causa provável	Solução
Não consegue fazer login	Senha alterada ou esquecida	Solicitar redefinição de senha ao administrador do sistema
Cliente não aparece na lista	Agente nunca se comunicou com o servidor	Verificar a instalação do agente e o endereço do servidor configurado
Comunicação sempre vermelha mesmo com agente rodando	Agente configurado com endereço de servidor errado	Verificar o endereço do servidor no arquivo de configuração do agente
Não é possível excluir uma configuração de backup	Existem clientes usando esta configuração	Reatribuir todos os clientes para outra configuração antes de excluir

Se o agente parou ou está se comportando de forma estranha, reiniciá-lo resolve a maioria dos casos:

Acesse o computador do cliente
Navegue até a pasta de instalação do agente
Dentro da subpasta bin, execute o arquivo stop.bat (isso para o agente)
Em seguida, execute o arquivo start.vbs clicando com botão direito → “Executar como administrador”
Aguarde alguns minutos e verifique o painel