# Instalação e Configuração do FaceTemplate

## Visão Geral

Este módulo orienta a instalação e a parametrização do FaceTemplate como um serviço nativo do Windows operando em segundo plano. O componente disponibiliza uma API dedicada ao processamento e geração de templates faciais no ecossistema Suricato.

## Regra de Negócio

Para que o FaceTemplate funcione corretamente, é obrigatório atender aos seguintes requisitos:

* **Conformidade de Hardware:** O computador ou servidor deve cumprir integralmente as especificações da tabela de requisitos mínimos.
* **Segurança de Rede:** A porta lógica `60100/TCP` (ou a porta customizada definida no script) deve estar explicitamente liberada nas diretivas do firewall.
* **Status do Componente:** O serviço deve ser registrado com privilégios administrativos e mantido em execução ativa no Windows.

## Como instalar o FaceTemplate

### Requisitos mínimos de Instalação

<table data-header-hidden><thead><tr><th width="201"></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Atributo</strong></td><td><strong>Requisito Obrigatório</strong></td><td><strong>Exemplos / Observações</strong></td></tr><tr><td>Processador (CPU)</td><td>Arquitetura x86-64 (64 bits)</td><td>Processadores Intel ou AMD homologados.</td></tr><tr><td>Extensões Obrigatórias</td><td>AVX, OSXSAVE, AVX2 e FMA3</td><td>Extensões vetoriais habilitadas pelo sistema operacional.</td></tr><tr><td>Processadores Intel</td><td>4ª geração “Haswell” ou mais nova</td><td>Core i-4x em diante, Xeon E3 v3, E5 v3, E7 v3 ou mais novos.</td></tr><tr><td>Processadores AMD</td><td>Excavator (Carrizo/Bristol Ridge) ou qualquer geração Zen em diante</td><td>Ryzen 1000+ ou EPYC 7001+</td></tr><tr><td>Sistema Operacional</td><td>Windows compatível com AVX</td><td>Windows Server 2012 R2 ou mais novo.</td></tr><tr><td>Máquinas Virtuais (VMs)</td><td>O computador físico (host) deve ter AVX2</td><td>O software de virtualização (hypervisor) deve expor AVX/AVX2 para a VM.</td></tr><tr><td>Memória (RAM)</td><td>Mínimo de 2GB</td><td>Capacidade livre dedicada ao serviço.</td></tr><tr><td>Rede e segurança</td><td>Liberar a porta 60100/tcp no firewall</td><td>Configuração obrigatória para permitir a comunicação com a API.</td></tr><tr><td>Software necessário</td><td>PowerShell versão 7.5 ou superior</td><td>Necessário para execução de rotinas acessórias.</td></tr></tbody></table>

### Instalação como Serviço

O FaceTemplate pode ser instalado como um **serviço do Windows**, ou seja, ele será executado automaticamente em segundo plano sempre que o computador iniciar.

#### Sobre o Install.bat

O arquivo **install.bat** foi criado para:

* Instalar automaticamente o FaceTemplate como serviço do Windows;
* Verificar e ajustar o certificado de segurança quando necessário;
* Testar se a API está respondendo corretamente após a instalação.

### Instalação Padrão do Serviço

{% stepper %}
{% step %}
Descompacte o arquivo compactado `FaceTemplate.zip` no diretório padrão: \
`C:\Program Files\Telematica\Suricato\`

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

{% step %}
Clique com o botão direito do mouse sobre o arquivo `install.bat` e selecione a opção Executar como Administrador.

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

{% step %}
Aguarde a automação realizar o registro do serviço, o ajuste do certificado de segurança e a validação de resposta da API.

<figure><img src="/files/CcNQaedifkmqoQzmlCzL" alt=""><figcaption><p><em>Retorno padrão do Sistema</em></p></figcaption></figure>
{% endstep %}
{% endstepper %}

### Instalação Personalizada (Customizada)

Caso você queira alterar a porta ou o nome do serviço:

{% stepper %}
{% step %}
Descompacte o arquivo `FaceTemplate.zip` no mesmo diretório padrão. (`C:\Program Files\Telematica\Suricato\`)

<figure><img src="/files/2SWGA8rdyMgkpVL3xKrx" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}
Abra o arquivo `install.bat` em um editor de texto para modificação.
{% endstep %}

{% step %}
Localize a linha de comando de registro da aplicação: \
`FaceTemplate.exe --install auto --port 60100`
{% endstep %}

{% step %}
Altere os parâmetros conforme os argumentos aceitos pela sintaxe do executável:

<table><thead><tr><th width="185">Opção</th><th>O que faz</th></tr></thead><tbody><tr><td><code>--install auto</code></td><td>Instala o FaceTemplate como serviço do Windows</td></tr><tr><td><code>--uninstall</code></td><td>Remove o serviço FaceTemplate</td></tr><tr><td><code>--name Instance2</code></td><td>(Opcional) Permite dar um nome diferente ao serviço</td></tr><tr><td><code>--port 60100</code></td><td>Define a porta do serviço (obrigatório)</td></tr></tbody></table>
{% endstep %}

{% step %}
Salve o arquivo `install.bat` e execute-o com privilégios de administrador.
{% endstep %}
{% endstepper %}

### Ajuste de Permissão de Logon

Após a instalação:

1. Abra o Gerenciador de Serviços do Windows (`services.msc`).
2. Localize o serviço denominado **TsiFaceService**.
3. Clique com o botão direito sobre ele e acesse as **Propriedades**.
4. Entre na aba **Logon**.
5. Selecione a opção **Conta do Sistema Local**, confirme a alteração e reinicie o serviço.

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

Isso garante que o serviço tenha permissão adequada para rodar no sistema.

### Diagnóstico em Modo Debug e Logs

Caso precise testar ou investigar problemas:

{% stepper %}
{% step %}
Interrompa a execução do serviço TsiFaceService por meio do gerenciador do Windows.
{% endstep %}

{% step %}
Abra o Prompt de Comando (CMD) com privilégios de administrador.
{% endstep %}

{% step %}
Acesse o caminho físico do componente: \
`cd "C:\Program Files\Telematica\Suricato\FaceTemplate"`
{% endstep %}

{% step %}
Execute o programa diretamente no console informando a porta correspondente:\
`FaceTemplate.exe --console --port 60100`
{% endstep %}

{% step %}
O programa será executado diretamente na tela, mostrando mensagens úteis para diagnóstico.

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

### Logs

Os registros de funcionamento e erros ficam no **Visualizador de Eventos do Windows**:

1. Abra o **Visualizador de Eventos**
2. Vá em: **Logs do Windows → Aplicativos**
3. Procure por eventos relacionados a **TsiFaceService**.
4. Aqui você pode ver detalhes de instalação, falhas e funcionamento do serviço.

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

## Glossário

* **API** – Interface que permite que outros sistemas conversem com o FaceTemplate para enviar imagens e receber o template facial.
* **Hypervisor** – Programa que cria e gerencia máquinas virtuais (ex.: VMware, Hyper-V, VirtualBox).

## FAQ - Perguntas Frequentes

<details>

<summary>Preciso instalar o FaceTemplate em qualquer computador?</summary>

Não. Normalmente ele é instalado em um servidor ou máquina dedicada para processamento facial.

</details>

<details>

<summary>O que acontece se a porta 60100 estiver bloqueada?</summary>

O sistema não funcionará, pois outras aplicações não conseguirão se comunicar com o FaceTemplate.

</details>

<details>

<summary>Como sei se o serviço está rodando?</summary>

Abra o Gerenciador de Serviços do Windows e procure por **TsiFaceService**. Ele deve estar como “Em execução”.

</details>

<details>

<summary>Quando devo usar o Modo Debug?</summary>

Quando o serviço não funciona corretamente e você precisa ver mensagens de erro em tempo real.

</details>

<details>

<summary>Posso mudar a porta 60100?</summary>

Sim, editando o arquivo **install.bat** antes da instalaçã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-facetemplate.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.