# Instalação e Configuração do Serviço Middleware

## Visão Geral

A **Instalação do Serviço Middleware** permite registrar o **Suricato Middleware** como um serviço do Windows, garantindo que ele seja iniciado automaticamente junto ao sistema operacional e funcione de forma contínua.

Este procedimento pode ser realizado de forma manual, utilizando scripts de instalação, com duas possibilidades:

* Instalação padrão do serviço Middleware.
* Instalação do serviço Middleware utilizando **OpenJDK**.

A seguir, estão descritos os passos necessários para cada cenário.

## Regra de Negócio

Para que a instalação do serviço Middleware seja realizada corretamente, é obrigatório atender aos seguintes requisitos:

* O usuário deve possuir **permissões de administrador** no sistema operacional.
* O serviço será registrado com o nome **SURICATO-MIDDLEWARE**.
* O diretório padrão do Middleware deve existir no caminho informado.
* Para instalação via OpenJDK, o ambiente correspondente deve estar disponível.

## Como instalar o Serviço Middleware

#### Identificação do serviço

* **Nome**: Suricato Middleware
* **Serviço**: SURICATO-MIDDLEWARE

#### Passo a passo

1. Abra o **MS-DOS** como administrador.
2. Acesse o diretório do Suricato Middleware utilizando o comando:

cd `C:\Program Files\Telematica\Suricato\SuricatoMiddleware`

<figure><img src="/files/fbbWzD9ABnnLjeBLkTQU" alt=""><figcaption><p><em>Prompt MS-DOS – Pasta Middleware</em></p></figcaption></figure>

3. Execute o comando abaixo para criar o serviço do Middleware:  `install.bat`

<figure><img src="/files/i6AfghNhUUB7fMACsJGN" alt=""><figcaption><p><em>Prompt MS-DOS Instalação</em></p></figcaption></figure>

## Como instalar o Serviço Middleware utilizando OpenJDK

#### Identificação do serviço

* **Nome**: Suricato Middleware
* **Serviço**: SURICATO-MIDDLEWARE

#### Passo a passo

1. Abra o **MS-DOS** como administrador.
2. Acesse o diretório do Suricato Middleware utilizando o comando:

cd `C:\Program Files\Telematica\Suricato\SuricatoMiddleware`

<figure><img src="/files/ktMrkM2cdPhKR0br6KiK" alt=""><figcaption><p><em>Prompt MS-DOS – Pasta Middleware</em></p></figcaption></figure>

3. Execute o comando abaixo para criar o serviço do Middleware utilizando OpenJDK: `INSTALL_MIDDLEWARE_OpenJDK.bat`

<figure><img src="/files/VWo9WDJY7hyVRz9r4XF1" alt=""><figcaption><p><em>Prompt MS-DOS – Instalação</em></p></figcaption></figure>

## Como desinstalar o serviço Middleware

Para remover o serviço do **Middleware**, siga os passos abaixo:

1. **Abra o Prompt de Comando (MS-DOS)**
   * No Windows, clique em **Iniciar**, digite `cmd`.
   * Clique com o botão direito em **Prompt de Comando** e selecione **Executar como administrador**.
2. **Acesse o diretório do ConexX**\
   No Prompt de Comando, navegue até a pasta onde o Conex/Middleware está instalado.\
   Exemplo:

   ```
   cd C:\Telematica\TSI-ConexX
   ```
3. **Execute o comando de desinstalação**\
   Digite o comando abaixo e pressione **Enter**:

   ```
   uninstall.bat
   ```

<figure><img src="/files/yYCo7POgM7ZM5eCB4vv7" alt=""><figcaption><p><em>Prompt MS-DOS Desinstalação</em></p></figcaption></figure>

4. **Aguarde a finalização**\
   O sistema irá remover automaticamente o serviço do Middleware.\
   Após a conclusão, o serviço não aparecerá mais na lista de serviços do Windows.

## Guia Rápido de Uso

* Abrir o MS-DOS como administrador.
* Acessar o diretório do Middleware.
* Executar:
  * `install.bat` (instalação padrão), ou
  * `INSTALL_MIDDLEWARE_OpenJDK.bat` (instalação via OpenJDK).

## Glossário

* **MS-DOS**: Interface de linha de comando do Windows utilizada para execução de comandos.
* **OpenJDK**: Implementação open source do Java Development Kit utilizada para execução de aplicações Java.

## FAQ – Perguntas Frequentes

<details>

<summary>Qual a diferença entre a instalação padrão e a instalação com OpenJDK?</summary>

A diferença está no ambiente Java utilizado. A opção com OpenJDK é indicada quando o Middleware deve utilizar essa implementação específica do Java.

</details>

<details>

<summary>O serviço não aparece após a execução do comando. O que verificar?</summary>

Verifique se o MS-DOS foi aberto como administrador e se o comando foi executado no diretório correto.

</details>

<details>

<summary>Posso executar os arquivos .bat com duplo clique?</summary>

Não é recomendado. A instalação deve ser feita pelo **MS-DOS como administrador** para garantir o registro correto do serviço.

</details>

<details>

<summary>Como confirmar se o serviço foi instalado corretamente?</summary>

Acesse o **Gerenciador de Serviços do Windows** e verifique se o serviço **SURICATO-MIDDLEWARE** está listado.

</details>

<details>

<summary>O serviço é iniciado automaticamente após a instalação?</summary>

Após a criação, o serviço poderá ser configurado para inicialização automática conforme as políticas do servidor.

</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-servico-middleware.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.