Manual Teorema Atualizador
v01
Orienta a instalação e operação do serviço de atualização automática do Orion Server Horse, abrangendo desde a configuração inicial até o agendamento de atualizações, diagnóstico de falhas e publicação segura de novas versões.
user_manual
public
manual-teorema-atualizador
19
22/10/2026 15:23
· Bernardo
- Título
- Manual Teorema Atualizador
- Slug
- teorema-atualizador
- Sistema(s)
- Teorema Atualizador
- Categoria
- user_manual
- Tipo
- how-to
- Publico
- "Equipe de TI do cliente, que instala e acompanha o atualizador, e equipe de desenvolvimento da Teorema, que publica as versões"
- Keywords
- ["Atualizador do Orion Server", "Orion Server Horse", "OrionServerUpdater.exe", "instalar.bat", "orion2", "manifesto.json", "data_atualizador.log", "chave de assinatura"]
- Autor
- Fabiano Massola
- Setor
- Qualidade
- Modulo
- Teorema Atualizador
- Versão Doc
- 01
- Revisão
- Paulo Bley
- Aprovado em
- Outubro de 2026
- Versão Pipeline
- ia-forja
- Ultima Revisao
- "2026-10-22"
--- title: Manual Teorema Atualizador slug: teorema-atualizador sistema: - Teorema Atualizador categoria: user_manual tipo: how-to publico: "Equipe de TI do cliente, que instala e acompanha o atualizador, e equipe de desenvolvimento da Teorema, que publica as versões" keywords: ["Atualizador do Orion Server", "Orion Server Horse", "OrionServerUpdater.exe", "instalar.bat", "orion2", "manifesto.json", "data_atualizador.log", "chave de assinatura"] autor: Fabiano Massola setor: Qualidade modulo: Teorema Atualizador versao_doc: 01 revisao: Paulo Bley aprovado_em: Outubro de 2026 versao_pipeline: ia-forja ultima_revisao: "2026-10-22" --- ## Visão Geral O **Atualizador do Orion Server** é o serviço do Windows que mantém o Orion Server Horse do cliente no ar e atualizado: vigia o servidor, busca e confere a versão nova, faz a troca com cópia de segurança e volta sozinho à versão anterior quando a versão nova não responde. O conteúdo abrange a **instalação no cliente**, a **janela do atualizador** (atualizar agora, agendar a troca, acompanhar as etapas e copiar o registro para o suporte), o ícone ao lado do relógio e o menu, e a **publicação assinada** de uma versão nova pela Teorema, com a chave de assinatura e a conexão segura que garantem que o cliente só instale o que a Teorema publicou. Inclui também o que fazer quando algo não sai como esperado, os arquivos de apoio e as proteções do próprio Horse. O procedimento está organizado em **22 passos**. - **Público:** equipe de TI do cliente, que instala e acompanha o atualizador, e equipe de desenvolvimento da Teorema, que publica as versões. - **Pré-requisitos:** Orion Server Horse instalado na máquina do cliente; computador ligado no horário agendado; para publicação, acesso à chave de assinatura na máquina da Teorema. - **Quando usar:** instalar o atualizador no cliente, autorizar ou agendar a troca de versão, diagnosticar uma atualização que não deu certo ou publicar uma versão nova do Horse. ## Conteúdo **Como funciona** 1. O Atualizador do Orion Server é um serviço do Windows instalado na pasta do Orion Server… 2. O que ele troca e o que nunca encosta 3. O próprio atualizador se atualiza sozinho, desde a versão 1.0.0.4 **Instalar no cliente** 4. Baixar o atualizador do FTP (protocolo de transferência de arquivos) da Teorema 5. Descompactar o **atualizador orion horse.rar** dentro da **pasta do servidor Orion Server…** 6. Dar duplo clique no `instalar.bat` 7. Cuidados na instalação **A janela do atualizador** 8. Versão nova pronta para instalar 9. Atualização agendada 10. Durante a troca 11. Atualizado e no ar 12. A atualização não deu certo 13. As cores do ícone ao lado do relógio 14. O menu do botão direito no ícone **Publicar uma versão (Teorema)** 15. Compilar o Horse pelo Delphi, na máquina onde fica a chave de assinatura 16. Dar duplo clique no `publicar assinado.bat`, na pasta `Orion Server Horse\Compilado` 17. Copiar os quatro arquivos para a pasta `include\versao_atual` do Horse no servidor da Teorema… 18. Atualizar o próprio orion2 é outra coisa 19. A chave de assinatura fica em `C:\teorema\_secrets\Orion Server Atualizador`, com cópia no… **Quando dá errado** 20. Tudo fica registrado em `Logs\data_atualizador.log`, na pasta do Horse, e aparece também em… 21. Os arquivos .bat da pasta do Horse 22. O Horse também se protege, desde a versão 1.0.0.220 ## Como funciona ### Vigiar o Horse e trocar a versão somente com autorização O Atualizador do Orion Server é um serviço do Windows instalado na pasta do Orion Server Horse, no servidor do cliente. Ele vigia o servidor, procura versão nova e prepara tudo sozinho, mas a troca só acontece com alguém autorizando, na hora ou num horário agendado. 1. Vigia o Horse a cada 30 segundos e o levanta sozinho se ele cair ou se a máquina reiniciar 2. Procura versão nova no servidor da Teorema de hora em hora, ou na hora pelo botão Verificar agora 3. Baixa e confere a versão nova: só aceita o que foi assinado pela Teorema, por conexão segura (HTTPS, protocolo HTTP seguro) 4. Na troca, fecha o Horse, guarda uma cópia do anterior, põe o novo e confere se ele respondeu; a parada leva de 4 a 6 segundos 5. Se a versão nova não responder em 60 segundos, volta sozinho a anterior e não oferece mais aquela versão ### Conferir o que é trocado e o que nunca é alterado 1. Troca apenas o `OrionServerHorse.exe` 2. Não mexe na pasta `includes` (páginas web e relatórios `.fr3` ajustados no cliente), nem em `keys`, `include`, `Logs` e `atualizador.ini` 3. Não mexe no `orion.db`, o banco local do Horse, que fica em `Documentos\Database` 4. Nunca instala versão anterior à que está rodando ### Atualizar o próprio atualizador sozinho, a partir da versão 1.0.0.4 O próprio atualizador se atualiza sozinho, desde a versão 1.0.0.4. A versão nova do atualizador vem junto com a do Horse e entra sem pedir autorização, porque trocar o atualizador não para o Horse. Se a versão nova do atualizador não subir, ele volta sozinho para a anterior em menos de um minuto. ## Instalar no cliente ### Baixar o atualizador do FTP da Teorema 1. Pasta no FTP: **/teorema/tp/google drive/publico/app delphi/servidores/atualizador servidor orion hose** 2. Arquivo: **atualizador orion horse.rar** ### Descompactar o atualizador na pasta do servidor Orion Server Horse Descompactar o **atualizador orion horse.rar** dentro da **pasta do servidor Orion Server Horse** do cliente, ao lado do `OrionServerHorse.exe`. É dali que o atualizador descobre qual servidor ele cuida. Depois de descompactar, a pasta tem: 1. `OrionServerUpdater.exe`, na versão 1.0.0.4 ou posterior (Propriedades, Detalhes, Versão do arquivo) 2. `instalar.bat` 3. `iniciar.bat` 4. `desinstalar.bat` 5. `socorro.bat` ### Executar o instalar.bat para registrar e iniciar o serviço Dar duplo clique no `instalar.bat`. Ele pede a elevação de administrador sozinho, registra o serviço e inicia. Em poucos segundos aparece uma bolinha colorida ao lado do relógio, e um clique nela abre a janela do atualizador. ### Evitar erros na instalação 1. Se já houver um atualizador antigo na pasta, rodar antes o `desinstalar.bat` e só depois copiar o executável novo por cima 2. Não copiar de outra máquina o `atualizador.ini`, o `atualizador-estado.ini` nem o `atualizador-pausado.txt`: o `.ini` nasce sozinho, já apontando para o servidor da Teorema 3. Se o Horse do cliente não usar a porta 9000, ajustar a linha `ping=` do `atualizador.ini` e reiniciar o serviço; sem isso o atualizador acha que o servidor não subiu e desfaz a atualização ## A janela do atualizador ### Abrir a janela e conferir a versão nova pronta para instalar  A janela abre com um clique no ícone ao lado do relógio, no balão de aviso, ou pelo atalho `OrionServerUpdater.exe JANELA`. 1. Versão instalada, no canto do cabeçalho 2. Situação: a versão nova já foi baixada e conferida 3. Etapas da troca, que acendem uma a uma 4. Atualizar agora: faz a troca na hora, com o servidor fora do ar por alguns segundos 5. Agendar: abre os horários rápidos e, no fim, Escolher data e hora 6. Verificar agora: procura versão nova sem esperar a hora cheia ### Acompanhar a atualização agendada  A faixa e a etapa 2 mostram o horário marcado; chegada a hora, a troca começa sozinha, sem ninguém clicar. O computador precisa estar ligado. 1. Cancelar agendamento desfaz o horário marcado ### Acompanhar as etapas durante a troca  As etapas acendem uma a uma: parar o servidor, guardar cópia e trocar o programa, subir o servidor e conferir se está respondendo. Enquanto isso, não se fecha nem se abre o Horse à mão. ### Confirmar a atualização concluída  A troca terminou e o servidor está na versão nova. O resultado fica na tela por 12 horas. ### Tratar uma atualização que não deu certo  A versão nova não respondeu e a anterior foi restaurada sozinha; o servidor está funcionando. Essa versão não é oferecida de novo neste cliente. 1. Mostrar detalhes abre o registro do dia 2. Copiar para o suporte põe na área de transferência a versão, a situação e o registro, prontos para colar na conversa com a Teorema ### Interpretar as cores do ícone ao lado do relógio 1. Verde: servidor no ar e em dia 2. Vermelho: há versão nova esperando, ou o servidor caiu 3. Amarelo: atualizador pausado, não está vigiando nem atualizando 4. Cinza: sem informação recente; o serviço pode estar parado ### Usar o menu do botão direito no ícone 1. Abrir o atualizador: abre a janela 2. Atualizar agora: só aparece quando há versão baixada esperando 3. Sincronizar agora: procura versão nova na hora 4. Pausar e Retomar: para manutenção na máquina; pausado, o atualizador não verifica, não troca e não levanta o servidor, e a pausa não expira sozinha 5. Ocultar até a próxima verificação: some com o ícone, que volta sozinho 6. Encerrar o serviço: para o serviço de verdade ## Publicar uma versão (Teorema) ### Compilar o Horse pelo Delphi, na máquina da chave de assinatura Compilar o Horse pelo Delphi, na máquina onde fica a chave de assinatura. O número da versão só sobe quando o responsável pedir, no máximo uma versão por dia. ### Assinar a publicação com o publicar assinado.bat Dar duplo clique no `publicar assinado.bat`, na pasta `Orion Server Horse\Compilado`. Ele assina a publicação e abre a pasta `Compilado\Publicacao\versao_atual` com quatro arquivos: 1. `OrionServerHorse.exe` 2. `OrionServerUpdater.exe` 3. `manifesto.json` 4. `manifesto.sig` ### Copiar os quatro arquivos para o servidor da Teorema Copiar os quatro arquivos para a pasta `include\versao_atual` do Horse no servidor da Teorema (orion2), por cima dos que estiverem lá. A partir daí, os clientes enxergam a versão nova na verificação seguinte. 1. Para conferir, abrir no navegador: https://orion2.teorema.inf.br/v1/bridge/filesinclude?file=versao_atual/manifesto.json ### Atualizar o orion2 separadamente da publicação Atualizar o próprio orion2 é outra coisa: fechar o Horse de lá, copiar o mesmo `OrionServerHorse.exe` para a pasta principal do Horse e abrir de novo. > ⚠️ **Atenção:** nunca executar o exe que está em `include\versao_atual`, que existe só para ser baixado. > ⚠️ **Atenção:** não publicar pelo orion2: lá não há chave de assinatura, e um manifesto sem assinatura é recusado pelos atualizadores. ### Guardar a chave de assinatura A chave de assinatura fica em `C:\teorema\_secrets\Orion Server Atualizador`, com cópia no pendrive de backup. 1. `assinatura-principal-PRIVADA.xml`: assina toda publicação 2. `assinatura-reserva-PRIVADA.xml`: só se a principal se perder ou vazar > ⚠️ **Atenção:** quem tem a chave privada publica para todos os clientes: nunca levar ao orion2, ao Git ou ao e-mail. ## Quando dá errado ### Consultar o registro e as mensagens mais comuns Tudo fica registrado em `Logs\data_atualizador.log`, na pasta do Horse, e aparece também em Mostrar detalhes, na janela. As mensagens mais comuns: 1. **Servidor estava fora do ar e foi levantado:** o Horse não estava rodando e o serviço subiu; repetindo todo dia, o Horse está caindo por outro motivo 2. **Versão nova baixada e conferida; esperando autorização:** combinar o horário com o cliente e autorizar ou agendar pela janela 3. **A versão nova não subiu; a anterior foi restaurada:** o cliente está no ar na versão anterior; avisar o desenvolvimento 4. **Não foi possível nem atualizar nem restaurar:** o único caso que precisa de alguém na máquina; a pasta `Backup` tem o executável anterior para copiar à mão 5. **Manifesto sem assinatura ou assinatura não confere:** o que está publicado não foi assinado pela Teorema; republicar pelo `publicar assinado.bat` 6. **Endereço sem HTTPS recusado:** corrigir o host do `atualizador.ini` para https://orion2.teorema.inf.br 7. **PAUSADO pelo operador:** alguém pausou e não retomou; retomar pelo menu do ícone ### Usar os arquivos .bat da pasta do Horse Todos pedem a elevação de administrador sozinhos. 1. `instalar.bat`: registra e inicia o serviço 2. `iniciar.bat`: liga o que já está instalado e devolve o início automático 3. `desinstalar.bat`: para o serviço, fecha o ícone e remove o registro 4. `socorro.bat`: emergência, para o serviço e derruba um Horse preso; depois dele, usar o `iniciar.bat` ### Conhecer as proteções do Horse O Horse também se protege, desde a versão 1.0.0.220. 1. Não abre duas vezes na mesma máquina, nem em sessões diferentes do Windows 2. Faz uma cópia por dia do `orion.db` em `Documentos\Database\Backup` e guarda 7 dias 3. Se o `orion.db` estiver danificado ao subir, restaura sozinho a última cópia boa e guarda o arquivo danificado à parte ## Informações do documento > Autor: Fabiano Massola > > Setor: Qualidade > > Módulo: Teorema Atualizador > > Chamado: > > Versão do Sistema: > > Versão do documento: 01 > > Revisão: Paulo Bley > > Aprovado em: Outubro de 2026 --- > 📎 **Arquivos originais:** [Manual_Teorema_Atualizador.docx](https://drive.google.com/uc?export=download&id=1SBL02ogQPaKK9NM5xdcTPaSyOSkV2ruk)
Tags IA:
teorema
atualizador
Prioridade: 7