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

## Visão Geral

Este tópico descreve os pré-requisitos, o procedimento de instalação física, a parametrização de portas e a validação do serviço `Suricato Client` em estações de trabalho.

Neste manual, você vai aprender sobre a instalação do Suricato Client:

* Quais são os [pré-requisitos](#pre-requisitos-de-instalacao) obrigatórios.
* Como configurar o [parâmetro de biometria](#parametro-suricato-match-on-server) (Match On Server).
* [Como instalar](#como-instalar-o-suricato-client) e validar o funcionamento do Suricato Client.

## Regras de Negócio

Antes de iniciar a instalação e parametrização, observe as seguintes diretrizes:

* **Escopo de Instalação:** O `Suricato Client` deve ser instalado individualmente em cada estação de trabalho que fará uso de periféricos locais.
* **Compatibilidade de Versões:** Certifique-se de utilizar estritamente as versões homologadas do Suricato e do Java Runtime.
* **Persistência de Alterações:** Qualquer mudança na porta de comunicação do serviço exige a reinicialização obrigatória do aplicativo para aplicar as novas configurações.
* **Ordem de Parametrização:** O parâmetro de biometria (*Match On Server*) deve estar configurado antes do início do uso do serviço pelos operadores.

### Pré-Requisitos de Instalação

Valide os requisitos abaixo antes de executar o instalador:

### Suricato

<table data-header-hidden><thead><tr><th width="158.4444580078125"></th><th></th></tr></thead><tbody><tr><td><strong>Suricato 2.9</strong></td><td>Exige a instalação prévia do pacote de biometria por ID pessoa disponível no WebApp.</td></tr><tr><td><strong>Suricato 2.10.6.1</strong></td><td>Versão homologada para compatibilidade padrão.</td></tr><tr><td><strong>Suricato 3.0.0 ou superior</strong></td><td>Obrigatório para a utilização do botão nativo do Suricato Client e telas de configurações gerais.</td></tr></tbody></table>

### Infraestrutura Local

<table data-header-hidden><thead><tr><th width="242.88897705078125"></th><th></th></tr></thead><tbody><tr><td><strong>Java Runtime</strong></td><td>Java 1.8.0 x64 ou superior instalado na estação.</td></tr><tr><td><strong>Sistema Operacional</strong></td><td>Windows 7 ou Windows 10.</td></tr><tr><td><strong>Navegadores Homologados</strong></td><td>Microsoft Edge, Mozilla Firefox ou Google Chrome.</td></tr></tbody></table>

#### Parametrização do Serviço

As configurações de conectividade são realizadas diretamente no arquivo de propriedades do componente.

#### Configuração da Porta de Comunicação

Define a porta local que o `Suricato Client` utilizará para escutar as requisições do navegador.

* Arquivo: `SURICATO-application.properties`
* Parâmetro:

```
server.port=9000
```

{% hint style="warning" %}
**Importante:** Recomenda-se manter a porta padrão `9000`. Caso seja alterada, reinicie o serviço imediatamente.
{% endhint %}

### Parâmetro Suricato Match On Server

Aponta para o serviço centralizador de identificação biométrica.

* Arquivo: `SURICATO-application.properties`
* Parâmetro:

```
SURICATO-mos.url=http://[IP_REDE]:[PORTA]/SURICATO-mos/server/match

EX:  SURICATO-mos.url=http://172.16.4.204:9001/SURICATO-mos/server/match
```

{% hint style="info" %}
**Atenção:** Substitua as variáveis do endereço (`IP_REDE` e `PORTA`) de acordo com as definições da sua infraestrutura de servidores.
{% endhint %}

## Como instalar o Suricato Client

O executável padrão do instalador encontra-se no diretório local do servidor do sistema:

```
C:\Program Files\Telematica\SURICATO\Outros\Suricato-Client\
```

<figure><img src="/files/NZBYiv8CnEzQ0jNGiZYH" alt=""><figcaption><p><em>Diretório - Suricato Cliente</em></p></figcaption></figure>

#### Execução do Passo a Passo

{% stepper %}
{% step %}
Execute o arquivo `Suricato-client.exe` como administrador.
{% endstep %}

{% step %}
Escolha se deseja criar atalho na área de trabalho.
{% endstep %}

{% step %}
Clique em **Próximo**, e depois em **Instalar.**
{% endstep %}

{% step %}
Por padrão (e recomendado), o sistema instala no diretório `C:\`
{% endstep %}

{% step %}
Um atalho será criado, e o Suricato Client será iniciado automaticamente.
{% endstep %}
{% endstepper %}

### Validação do Funcionamento

Ao finalizar o processo, o aplicativo é iniciado automaticamente em segundo plano.

{% stepper %}
{% step %}
**Indicador Visual:** Localize o ícone do `Suricato Client` na bandeja de sistema (*Tray Icon*), próximo ao relógio do Windows.

<figure><img src="/files/vg6Y14wE5SgqMu0qZGNZ" alt=""><figcaption><p><em>Icon - Suricato Cliente</em></p></figcaption></figure>
{% endstep %}

{% step %}
**Diagnóstico:** Clique com o botão direito sobre o ícone para acessar o menu de contexto.&#x20;

Por esta interface é possível checar a versão atual do binário e realizar testes direcionados de leitura nos periféricos conectados.

<figure><img src="/files/XrfKs4HzeR3OXtQ2EbC5" alt=""><figcaption><p><em>Opções Suricato cliente</em></p></figcaption></figure>
{% endstep %}
{% endstepper %}

## FAQ – Perguntas Frequentes

<details>

<summary>Preciso instalar o Suricato Client em todas as máquinas?</summary>

Sim. Cada estação que utilizar dispositivos (biometria, webcam, etc.) precisa do client.

</details>

<details>

<summary>O que acontece se o Suricato Client não estiver instalado?</summary>

O sistema não conseguirá acessar os dispositivos locais.

</details>

<details>

<summary>Posso alterar a porta padrão?</summary>

Sim. Utilize o parâmetro `server.port`, mas reinicie a aplicação após a alteração.

</details>

<details>

<summary>Qual porta devo usar?</summary>

Recomenda-se a porta 9000.

</details>

<details>

<summary>Para que serve o parâmetro SURICATO-mos.url?</summary>

Ele define o endereço do serviço de identificação biométrica.

</details>

<details>

<summary>Como sei se o Suricato Client está funcionando?</summary>

Verifique o ícone ao lado do relógio do Windows e utilize as opções de teste.

</details>

<details>

<summary>Preciso instalar algo além do Suricato Client?</summary>

Sim. Garanta que o Java esteja instalado e que o ambiente atenda aos pré-requisitos.

</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-client.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.