====== 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"

<note important>Não deixe nenhum campo em branco. O instalador vai travar se alguma informação estiver faltando.</note>

==== 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 [[ello_backup:painel_web#ativar_um_cliente|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.

<note warning>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.</note>

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

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

  * [[ello_backup:configuracao_cliente|Configurar o Agente]]
  * [[ello_backup:painel_web|Usar o Painel Web]]
  * [[ello_backup:solucao_de_problemas|Solução de Problemas]]