> 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-e-funcionalidades/instalacao-e-configuracao-do-suricato-placa.md).

# 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.1.0 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>

## Componentes do Sistema

#### Suricato-Placa-Mgr

O **Suricato-Placa-Mgr** é a aplicação JAR (Java) responsável pelo monitoramento da aplicação principal **Suricato-Placa.JAR**.

O **Suricato-Placa-Mgr.JAR** é instalado como um serviço do Windows e, ao iniciar, executa uma rotina em ciclo que monitora a presença do arquivo de controle **Suricato-Placa.PID**.

Se o arquivo **Suricato-Placa.PID** não existir, o **Suricato-Placa-Mgr** inicia uma nova instância da aplicação principal **Suricato-Placa.JAR**.

A aplicação **Suricato-Placa.JAR** é responsável por criar o arquivo **Suricato-Placa.PID**.

Após iniciar a aplicação principal e criar o arquivo PID, o **Suricato-Placa-Mgr** permanece em ciclo, monitorando sua existência e sua validade de 10 minutos.

A aplicação **Suricato-Placa.JAR** é responsável por manter o arquivo atualizado.

Caso o arquivo **Suricato-Placa.PID** não exista ou esteja vencido, o **Suricato-Placa-Mgr** recria uma nova instância da aplicação principal **Suricato-Placa.JAR**.

<figure><img src="https://235558800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjphwa3C6HguhCU8RfNQR%2Fuploads%2FTk0QJp4wfMF76EahBYXF%2Fimage.png?alt=media&amp;token=bf50011c-7bd6-464a-a8b3-75c69963e760" alt=""><figcaption></figcaption></figure>

#### Suricato-Placa

O **Suricato-Placa** é a aplicação JAR (Java) responsável por executar a regra de negócio para o sincronismo de placas.

O processo de sincronismo é executado exclusivamente para equipamentos do modelo **75 – Hikvision TCM403**.

<figure><img src="https://235558800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjphwa3C6HguhCU8RfNQR%2Fuploads%2FVizj0HyzcHrWkrO6okaZ%2Fimage.png?alt=media&amp;token=e5073110-6956-4746-86db-69687c2fc41c" alt=""><figcaption></figcaption></figure>

## 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="https://235558800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjphwa3C6HguhCU8RfNQR%2Fuploads%2F8fNEFl4aF9u121nwbRXt%2Fimage.png?alt=media&amp;token=3ba93388-eb63-404f-a0b9-8dd7e5b63e3e" alt=""><figcaption></figcaption></figure>
{% endstep %}

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

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

<figure><img src="https://235558800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjphwa3C6HguhCU8RfNQR%2Fuploads%2F8cJvtllnb2ybPETADvFx%2Fimage.png?alt=media&amp;token=04167503-a4d7-4419-bda5-ba2c0f05786f" 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
```

### 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`

<figure><img src="https://235558800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjphwa3C6HguhCU8RfNQR%2Fuploads%2FLT6Bqyi80wTBhlbjAUjH%2Fimage.png?alt=media&amp;token=e756e1ed-e275-4ac7-bc06-fa9c5250ccd4" alt=""><figcaption></figcaption></figure>
{% 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.**

<figure><img src="https://235558800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fjphwa3C6HguhCU8RfNQR%2Fuploads%2FwuCCtVrcAy6wafRzUp1H%2Fimage.png?alt=media&amp;token=84ce34e7-2a5c-47fb-a0f6-7f20f71e53cc" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Salve** as configurações e **reinicie o serviço**.
{% 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
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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://software-telematica-com.gitbook.io/suricato-docs/central-tecnica/instalacao-e-configuracao-de-servicos-e-funcionalidades/instalacao-e-configuracao-do-suricato-placa.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.