# Instalação e Configuração do Suricato Face

#### Visão Geral

A **Instalação do Suricato Face como Serviço** permite que a aplicação seja executada automaticamente no Windows, garantindo inicialização controlada, monitoramento contínuo e integração adequada com o sistema operacional.

### Regra de Negócio

Para que a instalação do Suricato Face como serviço funcione corretamente, é obrigatório que:

* O serviço **suricato\_face** seja criado no Windows;
* O serviço utilize a permissão de logon como **Conta do Sistema Local**;
* O Java configurado no serviço seja **Java 17 ou superior**;
* O usuário possua permissões de **administrador** no sistema operacional;
* O ambiente não apresente conflito entre versões de Java configuradas no serviço

## Como instalar o Suricato Face como serviço

Descompactar o conteúdo do arquivo **Suricato-Face.zip** no diretório:

```
C:\Program Files\Telematica
```

<figure><img src="/files/aAfjml4POBc9UdWzAe0a" alt=""><figcaption></figcaption></figure>

Abrir o **MS-DOS** como **administrador** e navegar até a pasta da aplicação.

Executar o arquivo:

```
install.bat
```

<figure><img src="/files/QFWGYuNd8qv4LlZbz284" alt=""><figcaption></figcaption></figure>

#### Criação do Serviço

Após a execução do script de instalação:

* O serviço **suricato\_face** deve ser criado no Windows;

<figure><img src="/files/bhYeLrRdPmMWD4lINeFc" alt=""><figcaption></figcaption></figure>

* Ajustar a permissão de logon do serviço para **\[Conta do Sistema Local]**.

<figure><img src="/files/fNieHMNZmuDRC77X70dF" alt=""><figcaption></figcaption></figure>

#### Observação sobre Versões de Java

Caso o ambiente possua **mais de uma versão de Java instalada**, poderá ocorrer erro de incompatibilidade, registrado no arquivo:

```
suricato_face-stderr.*.log
```

Exemplo de erro apresentado no log:

```
2023-08-15 10:27:55 Apache Commons Daemon procrun stderr initialized.
Exception in thread "main" VersionError: br/com/telematica/suricato/face/manager/Bootstrap 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
```

#### Configurando o Java no Serviço

Nesse caso, é necessário configurar manualmente o Java utilizado pelo serviço.

Executar o comando:

```
prunmgr.exe //MS//suricato_face
```

<figure><img src="/files/R0oYLduKvpseEYJ07MIH" alt=""><figcaption></figcaption></figure>

Após executar o comando:

* Será criado um **ícone na bandeja do sistema**, ao lado do relógio;

<figure><img src="/files/BYmgjYbGXlT0HNscEs7y" alt=""><figcaption></figcaption></figure>

* Clique com o **botão direito** no ícone e selecione **Configure**;
* Acesse a aba **Java** e configure o campo **Java Virtual Machine** com o caminho do **Java 17 ou superior**;

<figure><img src="/files/7mtpu3Jqpx6SbwJubdeY" alt=""><figcaption></figcaption></figure>

* Salve as alterações;
* Reinicie o serviço **suricato\_face**.

## Guia Rápido de Uso

Resumo do processo de instalação como serviço:

* Descompactar o **Suricato-Face.zip** em `C:\Program Files\Telematica`;
* Abrir o **Prompt de Comando como administrador**;
* Executar o arquivo `install.bat`;
* Verificar a criação do serviço **suricato\_face**;
* Ajustar o logon para **Conta do Sistema Local**;
* Configurar o Java 17 ou superior, se necessário;
* Reiniciar o serviço.

## Glossário

* **Procrun**: Ferramenta do Apache Commons utilizada para gerenciar aplicações Java como serviços do Windows.
* **stderr**: Arquivo de log que registra erros de execução da aplicação.
* **Java Virtual Machine (JVM)**: Ambiente responsável por executar aplicações Java.

## FAQ – Perguntas Frequentes

<details>

<summary>O serviço foi criado, mas não inicia. O que verificar?</summary>

Verifique o arquivo `suricato_face-stderr.*.log` para identificar erros relacionados à versão do Java.

</details>

<details>

<summary>Qual Java deve ser configurado no serviço?</summary>

Java versão 17 ou superior.

</details>

<details>

<summary>O que significa o erro “class file version 61.0”?</summary>

Indica que a aplicação foi compilada com uma versão mais recente do Java do que a configurada no serviço.

</details>

<details>

<summary>Preciso reinstalar o serviço para trocar o Java?</summary>

Não. Basta configurar o Java correto utilizando o comando `prunmgr.exe`.

</details>

<details>

<summary>Onde configuro o Java usado pelo serviço?</summary>

Na aba **Java**, acessada pelo ícone criado na bandeja do sistema após executar o comando `prunmgr.exe //MS//suricato_face`.

</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-suricato-face.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.