====== Configurar o Agente de Backup ======

Esta página explica as configurações do agente de backup e como verificar se estão corretas.

===== Arquivo de configuração principal =====

O agente usa um **arquivo de configuração** (chamado de **.env**) que deve ser preenchido antes da instalação. Cada linha deste arquivo define uma informação necessária para o funcionamento do agente.

==== Configurações necessárias ====

^ Configuração ^ O que é ^
| Endereço do servidor de backup | Endereço web do painel de controle da Ello onde o agente envia suas informações |
| Usuário do banco de dados | Login para acessar as bases de dados Firebird (normalmente SYSDBA) |
| Senha do banco de dados | Senha do Firebird (normalmente masterkey) |
| Endereço do armazenamento remoto | Servidor onde os arquivos de backup ficam guardados |
| Usuário do armazenamento remoto | Login no servidor de armazenamento |
| Senha do armazenamento remoto | Senha do servidor de armazenamento |
| Pasta de destino no armazenamento | Diretório raiz no servidor de armazenamento (normalmente /) |
| Pasta dos dados | Caminho completo da pasta onde estão as bases de dados no computador (ex: C:\Ello\Dados\) |
| Tipo de arquivo de banco | Extensão dos arquivos de banco a serem copiados (normalmente "ello") |

===== Configuração de horários e limites =====

As configurações de **horários de backup** e **quantidade máxima de cópias** são definidas no servidor pelo painel web e enviadas automaticamente para o agente. O atendente não precisa editá-las diretamente no computador do cliente — basta ajustar no painel.

Para saber como ajustar essas configurações, veja [[ello_backup:painel_web#configuracoes_de_backup|como usar as Configurações de Backup no painel]].

===== Como o agente descobre as bases de dados =====

Ao iniciar pela primeira vez, o agente varre automaticamente a pasta de dados e identifica os arquivos de base de dados com a extensão configurada. Em seguida, consulta o servidor para buscar os horários e limites de backup, e começa a trabalhar.

Esse processo de identificação se repete automaticamente. Se uma nova base de dados for criada na pasta de dados, o agente a incluirá nos próximos backups sem necessidade de configuração manual.

**Atenção:** Arquivos cujo nome contenha espaços ou a palavra "copia" são ignorados pelo agente intencionalmente.

===== Verificar se o agente está sincronizado =====

No **Painel Web**, acesse a tela de **Comunicação** e localize o cliente. Se a data e hora de "última comunicação" for de hoje, o agente está funcionando e sincronizado com o servidor.

Se a última comunicação for de dias atrás, o agente pode estar com problema. Consulte [[ello_backup:solucao_de_problemas|Solução de Problemas]].

===== O arquivo de controle interno =====

Após a primeira execução, o agente cria um arquivo interno de controle que guarda a lista de bases identificadas e as configurações recebidas do servidor. **Este arquivo não deve ser editado manualmente**, pois é gerado e atualizado automaticamente pelo agente.

Se este arquivo estiver ausente ou corrompido, o agente o recria automaticamente ao ser reiniciado.

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

  * [[ello_backup:instalacao_cliente|Instalar o Agente no Windows]]
  * [[ello_backup:painel_web|Usar o Painel Web]]
  * [[ello_backup:solucao_de_problemas|Solução de Problemas]]