# Criando SURICATO\_GERSERV\_HOME

## Visão Geral

Este módulo descreve o procedimento de criação e edição manual da variável de ambiente `SURICATO_GERSERV_HOME` no sistema operacional Windows. 

A correta parametrização desta variável é necessária para que o serviço Gerserv localize seus arquivos de execução e inicie de forma adequada.

## Regras de Negócio

* **Escopo da Variável:** O registro deve ser realizado obrigatoriamente sob a seção de Variáveis do Sistema (System Variables), e não nas variáveis de usuário, garantindo o acesso global ao serviço.
* **Integridade do Caminho:** O valor atribuído à variável deve apontar exatamente para o diretório físico onde a pasta de serviços do Gerserv está instalada.
* **Persistência do Registro:** O serviço do Windows não conseguirá mapear os arquivos de dependência e falhará na inicialização se a variável estiver ausente ou incorreta.

## Como criar a Variável de Ambiente manualmente

As variáveis de ambiente são usadas pelo Windows para localizar programas e pastas do sistema. Para acessar essas configurações:

Siga o fluxo de navegação conforme o idioma do seu sistema operacional para acessar a interface de configuração:

* **No Windows em Português:** Acesse Sistema > Configurações Avançadas do Sistema > Variáveis de Ambiente.
* **No Windows em Inglês:** Acesse System > Advanced System Settings > Environment Variables.

Após abrir a janela de configuração, execute as etapas abaixo:

{% stepper %}
{% step %}
Vá até o bloco Variáveis do Sistema (System Variables).
{% endstep %}

{% step %}
Clique no botão **Novo** (New) se a variável não existir, ou selecione-a e clique em **Editar** (Edit) caso já esteja criada.
{% endstep %}

{% step %}
Preencha os campos com os dados exatos de identificação e caminho do seu ambiente:

* **Nome da variável:** `SURICATO_GERSERV_HOME`
* **Valor da variável:** Inserir o caminho completo do diretório da pasta de serviços do Gerserv.

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

{% step %}
Clique em **OK** para salvar as alterações e fechar as janelas do assistente.
{% endstep %}
{% endstepper %}

## FAQ - Perguntas Frequentes

<details>

<summary>Por que essa variável é necessária?</summary>

Porque o Windows usa esse caminho para localizar os arquivos do serviço.

</details>

<details>

<summary>Por que o serviço Gerserv apresenta falha ao localizar seus arquivos essenciais?</summary>

Ausência da variável `SURICATO_GERSERV_HOME` no sistema ou erro de digitação no caminho configurado como valor da variável.

</details>

<details>

<summary>O que ocorre se a variável for criada incorretamente na seção de "Variáveis de Usuário"?</summary>

O serviço do Windows falhará ao iniciar em segundo plano, pois ele roda sob uma conta de sistema que não possui acesso às variáveis restritas de um usuário comum.

</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/criando-suricato_gerserv_home.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.