# Instalando o GerServ Utilizando o OpenJDK

## Visão Geral

Este módulo orienta a instalação manual do serviço Telemática Gerenciador de Serviços (GerServ) no Windows utilizando o OpenJDK como ambiente Java. 

A configuração estabelece a execução automatizada dos processos do Suricato em segundo plano, independente de logon de usuário no sistema operacional.

## Regra de Negócio

Antes de instalar o serviço, obrigatoriamente devem estar criadas e corretas as seguintes variáveis de ambiente no Windows:

* **JAVA\_HOME:** Deve apontar exatamente para o diretório do OpenJDK instalado.
* **PATH:** Deve conter o caminho de binários do Java atualizado.
* **SURICATO\_HOME:** Diretório raiz da aplicação.
* **SURICATO\_GERSERV\_HOME:** Diretório de serviços do módulo GerServ.

*Sem essas variáveis corretamente configuradas, o serviço não será instalado ou não iniciará corretamente.*

## Como instalar GerServ utilizando o OpenJDK

* Nome: **Telematica Gerenciador Serviços**
* Serviço: **Telematica\_Gerenciador\_Servicos**

#### Passos de instalação:

{% stepper %}
{% step %}
Abra o Prompt de Comando (MS-DOS) como administrador, e acesse o diretório dos serviços executando o comando:

```
cd C:\Program Files\Telematica\Suricato\services\auxs
```

<figure><img src="/files/TZiR1YjAs7IYqyjK8gmb" alt=""><figcaption><p><em>Executar MS Dos Como administrador</em></p></figcaption></figure>

{% hint style="warning" %}
**Atenção:** Antes de criar o serviço do GERSERV é necessário que as variáveis de ambiente (JAVA\_HOME, PATH DO JAVA NO WINDOWS, SURICATO\_HOME e SURICATO\_GERSERV\_HOME) estejam criadas.
{% endhint %}
{% endstep %}

{% step %}
Execute o comando abaixo para realizar a instalação do serviço do GERSERV:

```
InstallGerenciadorProcessos-NT_OpenJDK.bat
```

<figure><img src="/files/KxXNhyo8ennWCUUYqHrd" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Valide se a tela exibe o caminho completo da pasta "services" antes da inicialização automática. Se o caminho aparecer incompleto, o serviço não iniciará.
{% endstep %}

{% step %}
Confirme o encerramento do processo com a mensagem de validação: “Serviço Instalado – OK.”

<figure><img src="/files/lFnQBVUYlD56xnzMFGHQ" alt=""><figcaption><p><em>Telemática_Gerenciador_Serviços</em></p></figcaption></figure>
{% endstep %}
{% endstepper %}

### Soluções para corrigir erro na instalação do serviço do GERSERV

Caso o serviço não seja instalado ou não funcione corretamente:

{% stepper %}
{% step %}
**Ajuste da Variável SURICATO\_GERSERV\_HOME:** Adicione aspas duplas ao caminho completo da variável caso o Windows não reconheça o diretório devido aos espaços no nome das pastas:

```
"C:\Program Files\Telematica\Suricato\Services"
```

<figure><img src="/files/ePIG8UEaF6IFF1e1iGrB" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Reinicialização do Sistema:** Reinicie o Windows sempre que realizar alterações nas variáveis de ambiente para aplicar as novas configurações.
{% endstep %}

{% step %}
**Compatibilidade de Arquitetura:** Caso ocorram falhas ligadas ao Java, valide a arquitetura do OpenJDK (32 ou 64 bits) e atualize as variáveis `JAVA_HOME` e `PATH`.
{% endstep %}
{% endstepper %}

## Glossário

* **OpenJDK:** Versão aberta do Java utilizada pelo serviço GerServ para execução dos processos.
* **Variável de ambiente:** Configuração do sistema Windows que informa caminhos importantes para programas e serviços.
* **Serviço do Windows:** Programa que roda em segundo plano sem precisar de usuário logado.

*(Se preferir, posso reduzir ainda mais este glossário.)*

## FAQ - Perguntas Frequentes

<details>

<summary><strong>Por que preciso do OpenJDK para instalar o GerServ?</strong></summary>

Porque o GerServ é uma aplicação baseada em Java e precisa do OpenJDK para funcionar corretamente como serviço no Windows.

</details>

<details>

<summary><strong>O que acontece se eu não criar as variáveis de ambiente antes?</strong></summary>

O script de instalação pode falhar ou o serviço pode ser instalado, mas não iniciar.

</details>

<details>

<summary><strong>Como sei se a instalação deu certo?</strong></summary>

Você verá a mensagem **“Serviço Instalado – OK.”** e o serviço aparecerá em **services.msc** com o nome *Telematica Gerenciador Serviços*.

</details>

<details>

<summary><strong>Por que às vezes preciso colocar o caminho entre aspas na variável SURICATO_GERSERV_HOME?</strong></summary>

Porque caminhos com espaços (como “Program Files”) às vezes não são reconhecidos corretamente pelo Windows sem aspas.

</details>

<details>

<summary><strong>Preciso reiniciar o computador?</strong></summary>

Somente se você alterar variáveis de ambiente após tentar instalar o serviço.

</details>


---

# Agent Instructions: 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:

```
GET https://software-telematica-com.gitbook.io/suricato-docs/central-tecnica/instalacao-e-configuracao-de-servicos-do-suricato/instalacao-e-configuracao-do-gerserv/instalando-o-gerserv-utilizando-o-openjdk.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.