====== Solução de Problemas ======

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

===== Como verificar o que está acontecendo =====

==== Verificar pelo Painel Web ====

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**.

==== Verificar os registros do agente ====

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

  - Acesse o computador do cliente
  - Navegue até a pasta de instalação do agente
  - Abra a subpasta de **registros** (logs)
  - O nome do arquivo inclui o processo e a data do dia (ex: "backup-2026-06-25")
  - Abra o arquivo com o Bloco de Notas
  - Procure por linhas com a palavra "ERRO" ou "AVISO"

===== Checklist geral de diagnóstico =====

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?

===== Problemas por categoria =====

==== Instalação ====

^ 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 |

==== Bases de dados não encontradas ====

^ 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 |

==== Backup não está sendo executado ====

^ 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 |

==== Envio para o armazenamento remoto falha ====

^ 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 |

==== Agente parou de comunicar 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 |

==== Problemas no Painel Web ====

^ 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 |

===== Reiniciar o agente =====

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

===== Páginas relacionadas =====

  * [[ello_backup:visao_geral|Visão Geral do Sistema]]
  * [[ello_backup:instalacao_cliente|Instalar o Agente no Windows]]
  * [[ello_backup:configuracao_cliente|Configurar o Agente]]
  * [[ello_backup:painel_web|Usar o Painel Web]]
  * [[ello_backup:notificacoes_telegram|Notificações por Telegram]]