# Configuração de Conexão com o Banco de Dados

## Visão Geral

Este módulo orienta a parametrização e a validação das diretrizes de comunicação entre o Gerenciador de Serviços (GerServ) e o banco de dados (Oracle ou SQL Server). 

O procedimento define a inserção de credenciais, strings de rede e o teste prévio de conectividade antes da inicialização do serviço.

## Regras de Negócio

* **Validação Obrigatória:** A conexão com a base de dados deve ser testada com sucesso antes de efetuar a instalação ou inicialização do serviço.
* **Autenticação Padrão:** O usuário padrão do sistema é `Suricato`. Caso a senha padrão (`suricato`) tenha sido modificada, use a nova credencial corporativa.
* **Dependência de Instância (SQL Server):** O serviço *SQL Server Browser* deve estar obrigatoriamente ativo no servidor do banco de dados caso a integração utilize instâncias nomeadas.
* **Persistência de Dados:** Os parâmetros configurados na interface gráfica só serão gravados no arquivo de propriedades após o acionamento bem-sucedido do comando "Salvar".

## Parametrização e Teste de Conectividade

{% stepper %}
{% step %}
Acesse o diretório de utilitários de serviços: \
`C:\Program Files\Telematica\SURICATO\services\auxs`

<figure><img src="/files/74PY186NnN8Wv636u6DS" alt=""><figcaption><p><em>Diretório Services do Gerenciador</em></p></figcaption></figure>
{% endstep %}

{% step %}
Execute o arquivo de lote para abrir a interface de configuração:

```
configuraDB.bat
```

{% endstep %}

{% step %}
Na interface gráfica aberta, selecione o SGDB correspondente e preencha os campos obrigatórios conforme as especificações de ambiente:
{% endstep %}

{% step %}
**Parâmetros de Conexão por Banco de Dados**

<table data-header-hidden="false" data-header-sticky><thead><tr><th width="229">Parâmetro</th><th>Detalhes para Banco Oracle</th><th width="229">Detalhes para Banco SQL Server</th></tr></thead><tbody><tr><td><strong>Servidor</strong></td><td>Endereço IP ou hostname do servidor Oracle.</td><td>Endereço IP ou hostname do servidor SQL Server.</td></tr><tr><td><strong>SID / Base</strong></td><td>Código identificador (SID) localizado no arquivo <code>listener.ora</code>.</td><td>Nome do Banco de dados cadastrado no SQL Server.</td></tr><tr><td><strong>Instância</strong></td><td>Não aplicável.</td><td>Nome da Instância nomeada (deixe em branco se for instância padrão).</td></tr><tr><td><strong>Porta</strong></td><td>Porta de escuta configurada no <code>tnsnames.ora</code> (padrão: <code>1521</code>).</td><td>Porta de acesso ao servidor SQL Server (padrão: <code>1433</code>).</td></tr><tr><td><strong>Usuário</strong></td><td><code>Suricato</code></td><td><code>Suricato</code></td></tr><tr><td><strong>Senha</strong></td><td>Senha de acesso ao esquema (padrão: <code>suricato</code>).</td><td>Senha de acesso ao banco (padrão: <code>suricato</code>).</td></tr></tbody></table>
{% endstep %}

{% step %}
Clique no botão **Testar**.
{% endstep %}

{% step %}
**Verifique o retorno do sistema:** se a mensagem “Conexão com base de dados efetuada com sucesso” for exibida, clique em Salvar para concluir a gravação dos parâmetros.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**Observação:** O serviço **SQL Server Browser** deve estar ativo para conexões com instância.
{% endhint %}

## Verificação do Arquivo de Propriedades

{% stepper %}
{% step %}
Acesse o diretório de services do Gerenciador:

```
C:\Program Files\Telematica\SURICATO\services\conf
```

{% endstep %}

{% step %}
Abra o arquivo `gerenciador.properties` utilizando um editor de texto (Notepad++ ou Bloco de Notas).
{% endstep %}

{% step %}
Certifique-se de que as chaves de conexão foram populadas corretamente pela ferramenta de diagnóstico:

```
Arquivo: gerenciador.properties
br.com.tsi.gerenciador.bd.url=[URL_GERADA_CONFORME_O_BANCO]
br.com.tsi.gerenciador.bd.usuario=Suricato
br.com.tsi.gerenciador.bd.senha=[HASH_DA_SENHA_CRIPTOGRAFADA]
```

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

#### Parâmetros (exemplo)

* **Oracle:** servidor, SID, porta (padrão 1521), usuário (suricato), senha
* **SQL Server:** servidor, base, instância (se houver), porta (1433), usuário (suricato), senha

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

Verifique que `SQL Server Browser` esteja ativo para conexões por instância.

## FAQ - Perguntas Frequentes

<details>

<summary>O botão "Salvar" permanece desabilitado ou gera erro.</summary>

O botão "Testar" não foi acionado ou o teste de comunicação com o banco de dados falhou.

</details>

<details>

<summary>Erro de conexão com instância nomeada no SQL Server.</summary>

O serviço SQL Server Browser está parado no servidor de banco de dados ou a porta UDP 1434 está bloqueada.

</details>

<details>

<summary>O arquivo gerenciador.properties exibe a senha em texto limpo.</summary>

Comportamento incorreto; o script configuraDB.bat deve criptografar a senha automaticamente ao salvar com sucesso.

</details>

<details>

<summary>Onde localizar o SID correto para o ambiente Oracle?</summary>

O parâmetro deve ser extraído diretamente das diretivas do arquivo listener.ora hospedado no servidor Oracle.

</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-gerserv/configuracao-de-conexao-com-o-banco-de-dados.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.