Instalação e Configuração Orion

---
title: Instalação e Configuração Orion
slug: instalacao-configuracao-orion
sistema: 
  - "Sistemas Teorema -> 00001"
categoria: user_manual
tipo: how-to
publico: "Técnicos de implantação e suporte Teorema"
autor: Andreia Burko Bley
setor: Qualidade
modulo: ""
versao_doc: 01
revisao: Antonio Marcos Zampier
aprovado_em: 08/2023
release: Manuais 2023
versao_pipeline: 2.6.0
keywords: [orion, orion server, instalação, configuração, banco de dados, ftp, serviço windows, auto update]
ultima_revisao: "2026-06-12"
chamado: ""
---

## Visão Geral

O Orion é o servidor de comunicação dos aplicativos móveis Teorema. Ele opera exclusivamente como **serviço do Windows** (não mais como aplicação) e é configurado via interface web. Este documento descreve o processo de instalação do executável baixado do FTP da Teorema e a configuração inicial do servidor, incluindo o apontamento do banco de dados Firebird.

## Baixar e Preparar o Executável

O executável `OrionServer.exe` está disponível no FTP da Teorema.

1. Acesse o FTP da Teorema e baixe o executável do Orion.

   ![Tela inicial do Windows exibindo a janela do executável OrionServer com ícone laranja](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/instalacao-configuracao-orion/instalacao-configuracao-orion-01.png)

2. Abra o Explorador de Arquivos e navegue até `C:\` para acessar a pasta **Teorema**.

   ![Windows Explorer com a pasta Teorema destacada em C:\](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/instalacao-configuracao-orion/instalacao-configuracao-orion-02.png)

3. Dentro de `C:\Teorema`, clique com o botão direito em área vazia e selecione **Novo** para criar uma nova pasta.

   ![Windows Explorer em C:\Teorema com menu de contexto aberto, opção Novo destacada](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/instalacao-configuracao-orion/instalacao-configuracao-orion-03.png)

4. Nomeie a nova pasta como **Servidor Orion**. Manter o executável em pasta separada é necessário para o correto funcionamento do serviço.

   ![Windows Explorer em C:\Teorema com a pasta Servidor Orion recém-criada listada](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/instalacao-configuracao-orion/instalacao-configuracao-orion-04.png)

5. Mova o arquivo `OrionServer.exe` para a pasta `C:\Teorema\Servidor Orion`.

   ![Windows Explorer mostrando o executável OrionServer sendo movido para a pasta Servidor Orion com tooltip "Mover para Servidor Orion"](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/instalacao-configuracao-orion/instalacao-configuracao-orion-05.png)

6. Confirme que o arquivo `OrionServer.exe` está dentro de `C:\Teorema\Servidor Orion`.

   ![Windows Explorer em C:\Teorema\Servidor Orion com o arquivo OrionServer.exe listado, tipo Aplicativo, 9.952 KB](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/instalacao-configuracao-orion/instalacao-configuracao-orion-06.png)

## Instalar o Serviço do Orion

7. Dê um duplo clique em `OrionServer.exe`. A pasta passará a exibir os arquivos gerados pela instalação (`Logs`, `install.bat`, `OrionServer.exe`).

   ![Windows Explorer em C:\Teorema\Servidor Orion com os arquivos Logs, install.bat e OrionServer.exe listados após duplo clique](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/instalacao-configuracao-orion/instalacao-configuracao-orion-07.png)

8. Uma janela do Prompt de Comando será aberta executando o instalador. Aguarde a conclusão — o terminal exibe a mensagem `Aguardando 9 segundos, pressione CTRL+C para sair...`.

   ![Prompt de Comando exibindo a mensagem de aguardo de 9 segundos durante a instalação do serviço Orion](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/instalacao-configuracao-orion/instalacao-configuracao-orion-08.png)

9. Ao concluir, o serviço **OrionServer** será instalado e iniciado automaticamente. É possível verificá-lo no painel **Serviços** do Windows (`services.msc`).

   ![Gerenciador de Serviços do Windows com o serviço OrionServer listado e iniciado, ao lado do painel do Explorador de Arquivos em C:\Teorema\Servidor Orion](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/instalacao-configuracao-orion/instalacao-configuracao-orion-09.png)

> **Nota:** O instalador propositalmente utiliza uma versão anterior à versão oficial mais recente para acionar o mecanismo de auto-atualização descrito no próximo passo.

## Atualizar o Orion Automaticamente

10. O Gerenciador de Serviços exibe a versão instalada, que é intencionalmente uma versão anterior à atual.

    ![Gerenciador de Serviços do Windows com o serviço OrionServer listado em versão anterior à atual](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/instalacao-configuracao-orion/instalacao-configuracao-orion-10.png)

11. O sistema verifica automaticamente a versão instalada, detecta que existe uma versão mais recente e inicia o **auto update**. O Gerenciador de Serviços exibe a atualização em andamento.

    ![Gerenciador de Serviços do Windows exibindo o processo de auto update do OrionServer em andamento](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/instalacao-configuracao-orion/instalacao-configuracao-orion-11.png)

> **Nota:** Sempre que a Teorema lançar uma nova versão do Orion, os clientes com o servidor em funcionamento receberão a atualização automaticamente. O serviço verifica periodicamente a existência de novas versões e as aplica sem intervenção manual.

## Verificar o Funcionamento do Orion

12. Para confirmar que o Orion está em execução, abra um navegador e acesse `localhost:9035` (porta padrão). A tela de login do Orion Server será exibida.

    ![Tela de login do Orion Server no navegador com campos Senha e botão LOGIN PAINEL](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/instalacao-configuracao-orion/instalacao-configuracao-orion-12.png)

## Configurar o Orion

### Informar o CNPJ do Cliente

13. Após o login, o sistema exibe a tela inicial de configuração do Orion Server solicitando o CNPJ da empresa.

    ![Tela inicial do Orion Server com mensagem de boas-vindas e campo para informar o CNPJ, botão Pesquisar](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/instalacao-configuracao-orion/instalacao-configuracao-orion-13.png)

14. Digite o CNPJ do cliente no campo indicado e clique em **Pesquisar**.

    ![Tela do Orion Server com CNPJ preenchido no campo de pesquisa e botão Pesquisar destacado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/instalacao-configuracao-orion/instalacao-configuracao-orion-14.png)

15. O sistema valida o CNPJ informado. Se o CNPJ pertencer a um cliente cadastrado, o Dashboard do Orion Server será carregado, exibindo os totalizadores: Requisições Solicitadas, Banco de Dados, Celulares Registrados e Sistemas Disponíveis.

    > **Nota:** Se o CNPJ informado não estiver vinculado a um cliente, o sistema exibirá uma mensagem de erro.

    ![Dashboard do Orion Server com totalizadores: Requisições Solicitadas, Banco de Dados, Celulares Registrados e Sistemas Disponíveis; gráfico Sales Statics e menu lateral com Dashboard, Configuracao, Bancos de Dados](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/instalacao-configuracao-orion/instalacao-configuracao-orion-15.png)

### Apontar o Banco de Dados

16. No menu lateral, clique em **Bancos de Dados** para acessar o apontamento do banco de dados.

    ![Dashboard do Orion Server com o item Bancos de Dados destacado no menu lateral](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/instalacao-configuracao-orion/instalacao-configuracao-orion-16.png)

17. A tela **Banco de dados** exibe a seção "Listagem de Bancos" vazia. Clique em **Adicionar Novo** para registrar o primeiro banco de dados.

    ![Tela Banco de dados do Orion Server com a listagem vazia e botões Remover Banco e Adicionar Novo; botão Adicionar Novo destacado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/instalacao-configuracao-orion/instalacao-configuracao-orion-17.png)

18. Preencha o formulário **Adicionar novo banco de dados** com os seguintes campos e clique em **Solicitar Cadastro**:

    - **Nº Banco:** geralmente `1` refere-se ao banco oficial.
    - **Alias:** nome de identificação (ex.: `Teorema`).
    - **IP Banco:** se o banco de dados estiver em servidor Linux, informe o IP da máquina Linux (ex.: `192.168.0.123`). Se o Orion estiver no mesmo servidor do banco, use `localhost`.
    - **Caminho:** caminho completo do arquivo do banco de dados Firebird (ex.: `c:\Teorema\Bases\Bases 2.5\teorema_banco.fdb`).

    ![Formulário Adicionar novo banco de dados com campos Nº Banco, Alias, IP Banco e Caminho preenchidos; botão Solicitar Cadastro](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/instalacao-configuracao-orion/instalacao-configuracao-orion-18.png)

19. Se os dados estiverem corretos, o sistema exibe a mensagem de confirmação **Tudo Certo! Banco de dados configurado com sucesso**.

    ![Modal de confirmação do Orion Server com ícone de check verde e mensagem "Tudo Certo! Banco de dados configurado com sucesso", botão OK](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/instalacao-configuracao-orion/instalacao-configuracao-orion-19.png)

20. De volta à listagem, o banco de dados adicionado aparece com ID, Banco Nº, Alias, Identificação, Caminho e Status **Ativo**. É possível apontar um ou vários bancos de dados; no aplicativo móvel, o usuário selecionará qual banco utilizar.

    ![Tela Banco de dados do Orion Server com o banco cadastrado listado: Alias Teorema, Caminho c:\Teorema\Bases\Bases 2.5\teorema_banco.fdb, Status Ativo](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/instalacao-configuracao-orion/instalacao-configuracao-orion-20.png)

### Configurar Caminho de Anexos

21. Para aplicativos que realizam upload de fotos (como o Teorema Service para Ordem de Serviço), acesse **Configuracao** no menu lateral. Na tela **Configuração Servidor Orion**, altere o **Caminho Anexos** para o diretório desejado e clique em **Salvar**.

    - O campo **Token Server** não deve ser alterado.
    - O campo **Documento Empresa** corresponde ao CNPJ da empresa.

    ![Tela Configuração Servidor Orion com o valor do Token Server ocultado e os campos Documento Empresa e Caminho Anexos preenchidos; checkbox Condições e botão Salvar](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2024-versoes/instalacao-configuracao-orion/instalacao-configuracao-orion-21.png)

> ⚠️ **Atenção:** A configuração do Caminho Anexos é necessária apenas para aplicativos que fazem upload de fotos.

## Informações do documento

> Autor: Andreia Burko Bley
> Setor: Qualidade
> Módulo:
> Chamado:
> Versão do Sistema:
> Versão do documento: 01
> Revisão: Antonio Marcos Zampier
> Aprovado em: 08/2023

---

> 📎 **Arquivos originais:** [Manual Instalação e Configuração Orion.docx](https://drive.google.com/uc?export=download&id=1BiTcWXCLBSN1DpIPqHYvlH6rKDKmvBpx) · [Manual Instalação e Configuração Orion.pdf](https://drive.google.com/uc?export=download&id=1BjouxU2HxV9Yt7FJo_EQP-wVEUNnx6_W)