# Instalação Suricato em SQL

## Visão Geral

Este procedimento descreve a execução dos scripts para criação e atualização do banco de dados SQL Server do Suricato, bem como a validação da conexão no ambiente de produção.

## Regras de Negócio

* [x] A execução dos scripts deve seguir a ordem das pastas (**1 → 2 → 3 → 4**)
* [x] A pasta **1 (criação)** deve ser executada apenas se o banco ainda não existir
* [x] A ordem dos scripts dentro das pastas deve ser respeitada conforme nome dos arquivos
* [x] O serviço **Telematica Suricato** deve estar em execução para utilização do sistema
* [x] O nome da conexão no ambiente de produção deve ser obrigatoriamente **SURICATO**
* [x] Após a execução dos scripts, é obrigatório realizar o teste de conexão

## Execução dos Scripts do Banco

Após finalizar a instalação, execute os scripts de banco de dados.

{% stepper %}
{% step %}
Acesse o diretório:

```
C:\Program Files\Telematica\Suricato\sql
```

{% endstep %}

{% step %}

#### **Pasta 1 –** Criação do Banco

* Execute os scripts na seguinte ordem:
  * SQLSERVER\_LOGIN
  * SURICATO\_MSSQL\_DDL\_1.sql
  * SURICATO\_MSSQL\_DDL\_2.sql
  * SURICATO\_MSSQL\_DML.sql
  * SURICATO\_FROTA.sql
* Caso o banco já exista, esta etapa pode ser ignorada.
  {% endstep %}

{% step %}

#### **Pasta 2 –** Atualização

* Contém scripts para atualização até a versão **2.10.11.69**
* Execute conforme a ordem numérica dos arquivos
  {% endstep %}

{% step %}

#### **Pasta 3 –** Migração para a versão 3.0.0.0

* Realiza a migração para a versão **3.0.0.0**
* Execute somente após a pasta 2
  {% endstep %}

{% step %}

#### **Pasta 4 –** Migração para a versão 3.1.0

* Realiza a migração para a versão **3.1.0**
* Execute somente após a pasta 3
  {% endstep %}
  {% endstepper %}

### Inicialização do Serviço

Após a execução dos scripts:

1. Pressione **Windows + R**
2. Digite: `services.msc` 
3. Localize o serviço **Telematica Suricato**
4. Verifique se está em execução
5. Caso não esteja, clique com o botão direito e selecione **Iniciar**

<figure><img src="/files/sBhorKXADQ2Cg9rKQTVK" alt=""><figcaption><p><em>Serviço "Telemática Suricato"</em></p></figcaption></figure>

### Teste de Conexão – Ambiente de Produção

{% stepper %}
{% step %}

#### Acesso ao sistem

Para criar a conexão com o banco de dados:

* Abra um navegador e acesse o endereço do servidor Suricato: `https://IPdaMaquina/suricato/app/_lib/prod/`

**Exemplo:**

```
https://172.16.14.246/suricato/app/_lib/prod/
```

*<mark style="color:$primary;">**Nota (Versão 3.1):**</mark>* A partir da versão 3.1, o acesso foi simplificado para:\
`https://IPdaMaquina/suricato/prod/`

{% hint style="info" %}
**Atenção:** Verifique se o serviço **Telematica Suricato** está com status **"Em Execução"**. Caso não esteja, inicie o serviço.
{% endhint %}
{% endstep %}

{% step %}

#### Ambiente de Produção

1. Será exibida a tela de acesso ao ambiente de produção.
2. Na tela de autenticação, escreva um email de recuperação, selecione o idioma (pt-br ou en-us) e insira a senha `Tsi123!!` para liberar as opções de configuração.

{% hint style="warning" %}
Sugerimos utilizar a senha padrão do sistema para facilitar manutenções futuras, mas na versão **3.1** o administrador tem liberdade para definir uma senha personalizada.
{% endhint %}

3. Clique em **Entrar**.

<figure><img src="/files/zaVhdQvTrXChuM1K7lr8" alt=""><figcaption><p><em>Conectar ao Ambiente de Produção</em></p></figcaption></figure>
{% endstep %}

{% step %}

#### Configuração da Conexão

1. Para configurar a conexão, acesse a opção **Editar conexão**.
2. O nome da conexão deve ser obrigatoriamente **SURICATO**.

<div align="center"><figure><img src="/files/8RIHmInKiHcAhUtGEhpX" alt=""><figcaption><p><em>Menu Ambiente de Produção</em></p></figcaption></figure></div>

3. Selecione o banco de dados desejado clicando no ícone correspondente.

<figure><img src="/files/4eioIiJL66Ft6gi3hz0Z" alt=""><figcaption><p><em>Exemplo - Edição de Conexão</em></p></figcaption></figure>

8. Clique em **Testar Conexão**

<figure><img src="/files/b9V63LgmVnJ7a4xUf6O7" alt=""><figcaption><p><em>Banco de Dados</em></p></figcaption></figure>

<figure><img src="/files/nuWGs61k4l5x4tNQYJ2P" alt=""><figcaption><p><em>Conexão realizada com sucesso</em></p></figcaption></figure>
{% endstep %}

{% step %}

#### Verificação do PHP (info.php)

Para validar o funcionamento do ambiente:

1. Acesse:  `https://IP_SERVIDOR/suricato/info.php`
2. Verifique o parâmetro **PHPIniDir**
3. Ele indica qual arquivo `php.ini` está sendo utilizado

<figure><img src="/files/g01FYKQpjtRPi2uQsETh" alt=""><figcaption><p><em>httpd.conf</em></p></figcaption></figure>

<figure><img src="/files/TnRKjKvyLzHJzH6xQAqN" alt=""><figcaption><p><em>info.php</em></p></figcaption></figure>
{% endstep %}

{% step %}

#### Configuração do php.ini

1. Acesse: `C:\Program Files\Telematica\SURICATO\Apache\php\php.ini`
2. Verifique:
   * Caminho das extensões
   * Uso correto de barras (`/` ou `\`)
3. Após alterações, reinicie o serviço **Telematica Suricato**

<figure><img src="/files/d3W6SmNkaYZwvYek1P8P" alt=""><figcaption><p><em>php.ini</em></p></figcaption></figure>

<figure><img src="/files/4eWdaIAe3khyj5aYp2SJ" alt=""><figcaption><p><em>info.php</em></p></figcaption></figure>
{% endstep %}

{% step %}

#### Verificação de Extensões PHP

* No arquivo `php.ini`, verifique se as extensões estão habilitadas
* Linhas sem ponto e vírgula (`;`) indicam que a extensão está ativa

Após reiniciar:

* Acesse novamente o `info.php` para validar

<div align="left"><figure><img src="/files/LZuYKtjJQZnwiKIF8uCX" alt=""><figcaption><p><em>php.ini</em></p></figcaption></figure></div>
{% endstep %}
{% endstepper %}

## FAQ - Perguntas Frequentes

<details>

<summary>Posso pular a pasta 1?</summary>

Sim, caso o banco de dados já exista.

</details>

<details>

<summary>Preciso seguir a ordem dos scripts?</summary>

Sim. A execução fora de ordem pode causar falhas na instalação.

</details>

<details>

<summary>Qual URL devo usar para acessar o sistema?</summary>

* Versões anteriores: `/app/_lib/prod/`
* Versão 3.1+: `/prod/`

</details>

<details>

<summary>O sistema não abre. O que verificar?</summary>

* Serviço **Telematica Suricato**
* Se está em execução

</details>

<details>

<summary>O teste de conexão falhou. O que fazer?</summary>

* Verifique se o banco foi criado corretamente
* Confirme se o serviço está ativo

</details>

<details>

<summary>Para que serve o info.php?</summary>

Permite validar:

* Configuração do PHP
* Extensões carregadas
* Caminho do `php.ini`

</details>

<details>

<summary>Preciso reiniciar o serviço após alterar o php.ini?</summary>

Sim. As alterações só são aplicadas após reinício.

</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-do-suricato/instalacao-do-suricato/instalacao-suricato-em-sql.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.