# Instalação e Configuração do Suricato Matriz de Acesso

## Visão Geral

Este módulo orienta a instalação e parametrização do Suricato Matriz de Acesso para gerenciamento automatizado de grupos de usuários. 

O serviço já é compatível com outros SGBDs de mercado, porém este manual aborda a integração TOTVS; *os tutoriais para as demais plataformas homologadas serão disponibilizados em breve.*

## Regra de Negócio

Para o funcionamento correto do Suricato Matriz de A, é obrigatório atender aos seguintes requisitos:

* **Infraestrutura Prévia:** Ambiente Suricato devidamente instalado e configurado.
* **Variável de Sistema:** Variável de ambiente `SURICATO_TOTVS_HOME` configurada no sistema operacional.
* **Disponibilidade do Serviço**: Serviço SURICATO TOTVS MA ativo e disponível.
* **Parametrização do Aplicativo:** Arquivo `suricato-ma.properties` configurado corretamente.
* **Persistência de Dados:** Arquivo `persistence.xml` configurado com os dados corretos de conexão com o banco de dados.
* **Compatibilidade de SGBD:** Banco de dados homologado (Oracle ou SQL Server).
* **Privilégios de Acesso:** Permissão de administrador para edição de arquivos e instalação de serviços no sistema operacional.
* **Ciclo de Instalação:** Execução do arquivo `.bat` de instalação do serviço.

*Sem o atendimento desses requisitos, a Matriz de Acesso não será executada corretamente.*

## Como Instalar e configurar o SURICATO\_TOTVS\_MA

Localize o diretório da aplicação utilizando como referência o caminho configurado na variável de ambiente:

```
SURICATO_TOTVS_HOME
```

Diretório da aplicação:

```
SURICATO_TOTVS_HOME\SURICATOTotvsMA
```

<figure><img src="/files/qYzM9qGh8U17cZtxI9q3" alt=""><figcaption><p><em>Diretório – Matriz de Acesso</em></p></figcaption></figure>

### Configuração do arquivo suricato-ma.properties

{% stepper %}
{% step %}
Localize o arquivo `suricato-ma.properties` no diretório da aplicação.
{% endstep %}

{% step %}
Abra o arquivo utilizando um editor de texto.

<figure><img src="/files/hRw5oLWZ1AgxpdltNYXl" alt=""><figcaption><p><em>suricato-ma-properties</em></p></figcaption></figure>
{% endstep %}

{% step %}
Verifique os valores dos parâmetros:

* `timeout`
* `ram.clear`
  {% endstep %}

{% step %}
Confirme se os valores estão conforme o padrão de instalação.
{% endstep %}

{% step %}
Caso seja necessário, altere os valores informando o tempo em **minutos**.
{% endstep %}

{% step %}
Salve o arquivo após a alteração.

<figure><img src="/files/0omDckC5AQwfcG7GU1aE" alt=""><figcaption><p><em>suricato-ma-properties</em></p></figcaption></figure>
{% endstep %}
{% endstepper %}

### Configuração do arquivo suricato-ma.jar

Para configurar o arquivo `suricato-ma.jar`, siga os passos abaixo:

{% stepper %}
{% step %}
Localize o arquivo utilizando como referência o caminho:

```
SURICATO_TOTVS_HOME
```

{% endstep %}

{% step %}
Clique com o botão direito sobre o arquivo `SURICATO-ma.jar`.
{% endstep %}

{% step %}
Utilize o **WinRAR** para abrir o arquivo.
{% endstep %}

{% step %}
Navegue até o diretório:  `\META-INF`
{% endstep %}

{% step %}
Localize o arquivo `persistence.xml`.

<figure><img src="/files/zGSVVg9aTPcYUzA4tXOv" alt=""><figcaption><p><em>Exemplo – Configurar Suricato-ma.jar</em></p></figcaption></figure>
{% endstep %}

{% step %}
Edite o arquivo `persistence.xml`.
{% endstep %}

{% step %}
No bloco de código que contém a tag `<properties>`, configure os dados de conexão com o banco de dados do sistema Suricato.

<figure><img src="/files/KF5O6GfbwWg6cewi92zs" alt=""><figcaption><p><em>Exemplo - Configurar Suricato-ma.jar</em></p></figcaption></figure>
{% endstep %}
{% endstepper %}

### Configurando persistence.xml – Oracle

Configure os seguintes parâmetros:

{% stepper %}
{% step %}
**Driver:** \
`<property name="javax.persistence.jdbc.driver" value="oracle.jdbc.OracleDriver" />`
{% endstep %}

{% step %}
**URL:** \
`<property name="javax.persistence.jdbc.url" value="jdbc:oracle:thin:@172.16.14.15:1521/PDBORCL" />`
{% endstep %}

{% step %}
**Hibernate:**\
`<property name="hibernate.dialect" value="org.hibernate.dialect.Oracle10gDialect"/>`
{% endstep %}

{% step %}
**Usuário:**\
`<property name="javax.persistence.jdbc.user" value="suricato" />`
{% endstep %}

{% step %}
**Senha:** \
`<property name="javax.persistence.jdbc.password" value="suricato" />`

<figure><img src="/files/LvbYwrgK6nWn2B5YpvmB" alt=""><figcaption><p><em>Configurando – persistence Oracle</em></p></figcaption></figure>
{% endstep %}
{% endstepper %}

### Configurando persistence.xml – SQL Server

Configure os seguintes parâmetros:

{% stepper %}
{% step %}
**Driver:** \
`<property name="javax.persistence.jdbc.driver" value="com.microsoft.sqlserver.jdbc.SQLServerDriver" />`
{% endstep %}

{% step %}
**URL:** \
`<property name="javax.persistence.jdbc.url" value="jdbc:sqlserver://172.16.14.236;databaseName=suricato;" />`
{% endstep %}

{% step %}
**Usuário:**\
`<property name="javax.persistence.jdbc.user" value="suricato" />`
{% endstep %}

{% step %}
**Senha:** \
`<property name="javax.persistence.jdbc.password" value="suricato" />`

<figure><img src="/files/5gXQ2iKi6fGhs59tzpBZ" alt=""><figcaption><p><em>Configurando – persistence SQL</em></p></figcaption></figure>
{% endstep %}
{% endstepper %}

### Instalação do Serviço

Após finalizar a configuração do arquivo `persistence.xml`:

{% stepper %}
{% step %}
Localize o arquivo `.bat` de instalação no diretório da aplicação.
{% endstep %}

{% step %}
Execute o arquivo `.bat` para instalar o serviço de Matriz de Acesso.

<figure><img src="/files/kFgiJ0UCk44SsqkT8QoF" alt=""><figcaption><p><em>Instalando – Matriz de Acesso</em></p></figcaption></figure>
{% endstep %}
{% endstepper %}

<a href="/pages/4L4UzocaMDatCLBGEGhG" class="button primary">Clique aqui e aprenda Configuração Coringa de Conexão com Banco de Dados - SQL</a>

## Glossário

* **Matriz de Acesso:** Recurso responsável por vincular automaticamente colaboradores a grupos de acesso com base em regras definidas.&#x20;
* **Hibernate Dialect:** Configuração que define como o Hibernate se comunica com um tipo específico de banco de dados.

### FAQ – Perguntas Frequentes

<details>

<summary>O serviço não inicia após a instalação. O que verificar?</summary>

Verifique se o arquivo `persistence.xml` está corretamente configurado e se o banco está acessível.

</details>

<details>

<summary>Posso utilizar Oracle ou SQL Server?</summary>

Sim. O sistema suporta ambos, desde que a configuração seja realizada corretamente.

</details>

<details>

<summary>É obrigatório usar o WinRAR para editar o JAR?</summary>

Sim, conforme procedimento descrito, o WinRAR é utilizado para acessar e editar o conteúdo do arquivo JAR.

</details>

<details>

<summary>O que acontece se o timeout estiver configurado incorretamente?</summary>

O serviço pode apresentar lentidão ou falhas no processamento da Matriz de Acesso.

</details>

<details>

<summary>Preciso reiniciar o serviço após alterar as configurações?</summary>

Sim. Sempre que houver alteração nos arquivos de configuração, o serviço deve ser reinstalado ou reiniciado.

</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-matriz-de-acesso.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.