> For the complete documentation index, see [llms.txt](https://software-telematica-com.gitbook.io/suricato-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://software-telematica-com.gitbook.io/suricato-docs/central-tecnica/instalacao-e-configuracao-de-servicos/instalacao-e-configuracao-do-suricato-rep.md). # Instalação e Configuração do Suricato REP ## Visão Geral O Suricato-REP é o serviço responsável por sincronizar os dados REP entre a base do Suricato e a base do ConexReP. O sistema utiliza um serviço de monitoramento dedicado para garantir a alta disponibilidade da aplicação principal. Aprenda como realizar a **instalação manual do serviço Suricato REP** no seu sistema operacional. Atualizado para a versão 2.x. ### Pré-requisitos de Instalação * Sistema operacional **Windows 64x** * Suricato REP previamente instalado no diretório padrão * Suricato **3.0** ou superior * **Java 17** ou superior ## Componentes do Sistema O ecossistema é composto por duas aplicações Java principais e seis serviços internos: ### Suricato-REP-Mgr (`Suricato-REP-MGR.jar`) Sua função é monitorar e gerenciar a disponibilidade da aplicação principal. O `Suricato-REP-MGR.jar` é a aplicação Java executada como serviço do Windows, e ao iniciar ela executa um ciclo, que monitora a presença do arquivo de controle Suricato-REP.PID. * **Rotina de Monitoramento:** Ao iniciar, o serviço verifica continuamente a presença do arquivo de controle `Suricato-REP.PID`, e também é responsável por manter o arquivo atualizado. * **Mecanismo de Recuperação:** Se o arquivo `.PID` não for encontrado ou se a sua última atualização tiver ocorrido há mais de 10 minutos, o `Suricato-REP-Mgr` reinicia automaticamente a aplicação principal.
### Suricato-REP (`Suricato-REP.jar`) O Suricato-REP é o serviço de sincronização de dados REP entre a base Suricato e a base ConexReP. * Serviços Internos: * `AfdCollectorService` * `AlarmCollectorService` * `EmployeeSyncService` * `LogCleanService` * `MonitorService` * `PidService` ## Como fazer a Instalação do SuricatoREP Siga os passos abaixo para instalar ou atualizar o serviço no servidor Windows. {% stepper %} {% step %} #### Remover versões anteriores (somente em atualizações) Se você estiver atualizando uma instalação existente, primeiro pare o serviço. Em seguida, acesse a pasta do Suricato REP, abra o Prompt de Comando (CMD) nesse diretório e execute o comando abaixo para remover o serviço: ``` prunsrv64 //DS/suricato_rep ``` Após executar o comando, o serviço será removido.
{% endstep %} {% step %} #### Executar a instalação * Abra o Prompt de Comando (MS-DOS) como Administrador. * Navegue até a pasta da aplicação: `cd "C:\Program Files\Telematica"` * Execute o script de instalação: `install.bat` * Confirme se o serviço `suricato_rep` foi criado com sucesso no Windows.
{% endstep %} {% step %} #### Configurar a conta de Logon * Abra os Serviços do Windows (`services.msc`). * Localize o serviço `suricato_rep` e acesse suas Propriedades. * Na aba Logon, altere a opção para Conta do Sistema Local (*Local System Account*). * Salve as alterações.
{% endstep %} {% endstepper %} ## Resolução de Problemas #### Erro de Incompatibilidade de Versão do Java (`UnsupportedClassVersionError`) Se o ambiente possuir mais de uma versão do Java instalada, o serviço pode tentar utilizar uma versão incompatível. Esse erro é registrado no log `suricato_rep-stderr.*.log`: ``` Apache Commons Daemon procrun stderr initialized. Exception in thread "main" ersionError: br/com/telematica/suricato/rep/manager/* has been compiled by a more recent version of the Java Runtime (class file version 61.0), this version of the Java Runtime only recognizes class file versions up to 52.0 ``` #### Como Corrigir: {% stepper %} {% step %} Acesse a pasta do Suricato REP, abra o Prompt de Comando (CMD) nesse diretório e execute o comando abaixo para remover o serviço: ``` prunmgr.exe //MS//suricato_rep ```
{% endstep %} {% step %} Um ícone do gerenciador será exibido na Barra de Tarefas (próximo ao relógio). Clique com o botão direito no ícone e selecione **Configure**. {% endstep %} {% step %} Acesse a aba Java, e no campo Java Virtual Machine, insira o caminho completo do executável (`jvm.dll`) do Java 17 ou superior.
{% endstep %} {% step %} Clique em **OK** para salvar e reinicie o serviço. {% endstep %} {% endstepper %} ## FAQ – Perguntas Frequentes
O serviço Suricato REP não aparece na lista de serviços do Windows. O que pode ter acontecido? Normalmente isso ocorre quando o Prompt de Comando não foi aberto como Administrador. Feche o MS-DOS, abra novamente com privilégios de administrador e execute o arquivo `.bat` novamente.
Recebo erro ao executar o arquivo install.bat ou INSTALL_SURICATO_REP_OpenJDK.bat. Verifique se o caminho acessado no Prompt de Comando está correto e se o arquivo `.bat` existe no diretório `C:\Program Files\Telematica\Suricato\suricato_rep`. Também confirme se não há bloqueio de antivírus ou permissão de execução.
Qual a diferença entre a instalação manual e a instalação utilizando OpenJDK? A instalação manual utiliza a JVM padrão configurada no sistema. Já a instalação com OpenJDK deve ser usada quando o ambiente foi preparado especificamente para OpenJDK ou quando há incompatibilidade com a JVM padrão.
Posso executar os dois arquivos de instalação no mesmo ambiente? Não. Apenas um método de instalação deve ser utilizado. Executar ambos pode gerar conflitos no serviço ou sobrescrita de configurações.
O nome do serviço aparece diferente do esperado. Isso é um problema? Não. O nome exibido pode variar conforme o método de instalação, mas o nome técnico do serviço deve ser `suricato_rep`. Caso ele exista e inicie corretamente, o funcionamento está adequado.
Preciso reiniciar o servidor após instalar o serviço? Não é obrigatório. Após a criação do serviço, ele pode ser iniciado diretamente pelo Services do Windows.
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://software-telematica-com.gitbook.io/suricato-docs/central-tecnica/instalacao-e-configuracao-de-servicos/instalacao-e-configuracao-do-suricato-rep.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.