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

## Visão Geral

Este procedimento descreve os requisitos necessários, o processo de instalação e a validação do **Suricato Placa**.

Também são abordados cenários comuns de erro relacionados à incompatibilidade de versões do Java e como solucioná-los.

Ao final deste processo, o serviço **suricato\_Placa** deverá estar ativo, utilizando a versão correta do Java e apto para execução do sincronismo de placas.

## Regras de Negócio

Antes de iniciar e durante a instalação, observe as seguintes diretrizes técnicas:

* **Requisito de Runtime:** Utilize obrigatoriamente Java 17 ou superior.
* **Versão Mínima do Sistema:** Certifique-se de que a versão do Suricato seja 3.0.0.6 ou superior.
* **Versão Mínima do Player:** Certifique-se de que a versão do Suricato-Player seja 2.0.11.131 ou superior.
* **Criação de Serviço:** O serviço `suricato_Placa` deve ser criado durante a instalação.
* **Permissões do Windows:** O serviço deve estar configurado com permissão de logon como Conta do Sistema Local.
* **Múltiplas Instalações Java:** Em ambientes com múltiplas versões de Java, é necessário configurar manualmente qual versão o serviço utilizará.
* **Análise de Falhas:** O erro de incompatibilidade de Java será registrado no arquivo `suricato_Placa-stderr.*.log`.

### Pré-Requisitos

Antes de iniciar a instalação, verifique se o ambiente atende aos seguintes requisitos:

<table><thead><tr><th width="252.33331298828125">Aplicações</th><th>Versão compatível</th></tr></thead><tbody><tr><td><strong>Suricato</strong></td><td>3.0.0.6 ou superior</td></tr><tr><td><strong>Java</strong></td><td>17 ou superior</td></tr><tr><td><strong>Suricato-Player (SuriPlayer)</strong></td><td>2.0.11.131 ou superior</td></tr></tbody></table>

## Como instalar o Suricato Placa

Siga os passos abaixo para realizar a instalação:

{% stepper %}
{% step %}
**Descompacte** o conteúdo do arquivo `Suricato-Placa.zip` no diretório local do Suricato
{% endstep %}

{% step %}
**Abra o MS-DOS como administrador** e navegue até a pasta da aplicação
{% endstep %}

{% step %}
**Execute** o arquivo:   `install.bat`
{% endstep %}

{% step %}
**Verifique** se o serviço foi criado:

* Nome do serviço: **suricato\_Placa**

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

{% step %}
Ajuste a permissão de logon do serviço:

* Configure para **\[Conta do Sistema Local]**

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

## Erros Comuns

Caso o ambiente possua mais de uma versão do Java instalada, pode ocorrer erro de incompatibilidade. Esse erro será registrado no arquivo:

```
suricato_Placa-stderr.*.log
```

Exemplo de erro:

```
2023-08-15 10:27:55 Apache Commons Daemon procrun stderr initialized.
Exception in thread "main" ... 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
```

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

### Solução

Nessa situação, é necessário configurar manualmente o Java utilizado pelo serviço:

{% stepper %}
{% step %}
Execute o comando:   `prunmgr.exe //MS//suricato_placa`
{% endstep %}

{% step %}
Será criado um ícone na barra do sistema **(tray icon)**, ao lado do relógio.
{% endstep %}

{% step %}
Clique com o botão direito sobre o ícone e selecione **Configure.**
{% endstep %}

{% step %}
Acesse a aba **Java**, e configure o campo **Java Virtual Machine** com o caminho do **Java 17 ou superior.**
{% endstep %}

{% step %}
Salve as configurações e reinicie o serviço.

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

## FAQ – Perguntas Frequentes

<details>

<summary>O que acontece se eu não tiver o Java 17 instalado?</summary>

A aplicação não será executada corretamente e poderá apresentar erro de incompatibilidade de versão.

</details>

<details>

<summary>Como sei se o serviço foi instalado corretamente?</summary>

Verifique se o serviço **suricato\_Placa** foi criado após a execução do `install.bat`.

</details>

<details>

<summary>Qual conta devo utilizar no logon do serviço?</summary>

O serviço deve ser configurado com a opção **Conta do Sistema Local**.

</details>

<details>

<summary>Tenho mais de uma versão do Java instalada. Isso pode causar problema?</summary>

Sim. Pode ocorrer erro de incompatibilidade, pois o serviço pode utilizar uma versão incorreta do Java.

</details>

<details>

<summary>Onde encontro o erro de incompatibilidade do Java?</summary>

O erro será registrado no arquivo:\
**suricato\_Placa-stderr.\*.log**

</details>

<details>

<summary>Como corrigir erro de versão do Java?</summary>

Execute o comando:

```
prunmgr.exe //MS//suricato_placa
```

Depois:

* Abra o **Configure** pelo ícone na bandeja
* Acesse a aba **Java**
* Configure o caminho do **Java 17 ou superior**
* Salve e reinicie 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-suricato-placa.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.