# Instalação do ConexX Middleware

## Visão Geral

O ConexX Middleware é o componente responsável por intermediar e traduzir as mensagens recebidas do ConexX Driver, encaminhando-as corretamente para os sistemas parceiros.

Durante a instalação, são definidos: Idioma do serviço, Nome do serviço, Nome do aplicativo e Diretório de instalação no sistema operacional.

**Clique sobre o que precisa aprender:**

* [Como instalar o ConexX\_Middleware](/suricato-docs/conex/conexx-e-xt/conexx-ou-xt-middleware/instalacao-do-conexx-middleware.md#como-instalar-o-conexx_middleware)
* [Configuração do ConexX\_Middleware](/suricato-docs/conex/conexx-e-xt/conexx-ou-xt-middleware/configuracao-do-conexx-middleware.md)
* [Testando o ambiente](/suricato-docs/conex/conexx-e-xt/conexx-ou-xt-middleware/testando-o-ambiente-do-conexx-middleware.md)
* [Como desinstalar ConexX\_Middleware](/suricato-docs/conex/conexx-e-xt/conexx-ou-xt-middleware/desinstalacao-do-conexx-middleware.md)

## Como instalar o ConexX\_Middleware

{% stepper %}
{% step %}
Execute o arquivo **`ConexXMiddlewareService-Installer.exe`**.\
Ao iniciar o instalador, selecione o **idioma do instalador** e prossiga com a instalação.

<figure><img src="/files/yrfou80pTrfVJ60tuoVX" alt=""><figcaption><p><em>Tela – Instalador ConexX_MiddleWare</em></p></figcaption></figure>
{% endstep %}

{% step %}
Defina o **Nome do Serviço** e o **Nome do Aplicativo do serviço**.

* Por padrão, o nome será **CONEXX-MIDDLEWARE**.
* Os nomes podem ser alterados para atender às necessidades do cliente.
* É possível possuir **mais de um ConexX\_MIDDLEWARE por máquina**, desde que os nomes sejam diferentes.

<figure><img src="/files/64ckq7iZladWWxBHniCn" alt=""><figcaption><p><em>Tela – Instalador ConexX_MiddleWare</em></p></figcaption></figure>
{% endstep %}

{% step %}
Defina o **Local de Instalação do ConexX\_Middleware**.

* Por padrão, o sistema sugere o caminho:\
  **C:\Telematica\TSI-ConexXMiddleware**
* Recomenda-se que o ConexX\_Middleware fique na **mesma pasta do ConexX**.

<figure><img src="/files/8zEg0l4iGdlUsIPAax0e" alt=""><figcaption><p><em>Tela – Instalador ConexX_MiddleWare</em></p></figcaption></figure>
{% endstep %}

{% step %}
Ao selecionar o local de instalação, será iniciada automaticamente a **extração dos arquivos** e a **instalação do serviço**.

<figure><img src="/files/sx5ozNpuQb6CuVSspXO3" alt=""><figcaption><p><em>Tela – Instalador ConexX_MiddleWare</em></p></figcaption></figure>
{% endstep %}

{% step %}
Ao final da extração, será exibida a mensagem indicando o **término da instalação**.

<figure><img src="/files/bFzfwQf6mbpj6bE42SHL" alt=""><figcaption><p><em>Tela – Instalador ConexX_MiddleWare</em></p></figcaption></figure>
{% endstep %}

{% step %}
Acesse o menu **Serviços** do sistema operacional e verifique se o **Serviço do ConexX\_Middleware** está sendo executado.

<figure><img src="/files/lgAxSg9t0WbutNTYJssK" alt=""><figcaption><p><em>Tela – Serviço ConexX_MiddleWare</em></p></figcaption></figure>
{% endstep %}
{% endstepper %}

## FAQ – Perguntas Frequentes

<details>

<summary>Posso alterar o local de instalação sugerido pelo sistema?</summary>

Sim. O caminho padrão é apenas uma sugestão. Você pode escolher outro diretório, desde que tenha permissão de acesso e ele seja compatível com o ambiente.

</details>

<details>

<summary>Por que o sistema recomenda instalar o ConexX_Middleware na mesma pasta do ConexX?</summary>

Porque isso facilita a comunicação entre os componentes, a manutenção do sistema e possíveis atualizações ou diagnósticos.

</details>

<details>

<summary>O que acontece se o ConexX_Middleware for instalado em uma pasta diferente do ConexX?</summary>

O sistema pode continuar funcionando, porém podem ser necessárias configurações adicionais para garantir a correta comunicação entre os módulos.

</details>

<details>

<summary>É obrigatório usar o caminho padrão <code>C:\Telematica\TSI-ConexXMiddleware</code>?</summary>

Não. Esse é apenas o caminho recomendado pelo sistema para padronização, mas não é obrigatório.

</details>

<details>

<summary>Existe alguma restrição de permissão ou segurança para o local de instalação?</summary>

Sim. O diretório escolhido deve permitir leitura e escrita pelo sistema e pelos serviços do ConexX\_Middleware, evitando pastas com restrições do Windows.

</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/conex/conexx-e-xt/conexx-ou-xt-middleware/instalacao-do-conexx-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.