Este guia ajuda a diagnosticar e resolver os problemas mais comuns do Ello Backup.
O primeiro passo é sempre verificar o Painel Web:
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:
| 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: