Atualização de Versão do Teorema

---
title: Atualização de Versão do Teorema
slug: atualizacao-versao-teorema-3
sistema:
  - "Sistemas Teorema -> 00001"
categoria: user_manual
tipo: how-to
publico: "Suporte técnico Teorema (operação cloud)"
keywords:
  - atualização
  - versão
  - cloud
  - backup
  - firebird
  - gbak
  - atualizador
  - pós-versão
  - WinSCP
  - PuTTY
  - IBExpert
versao_pipeline: 2.7.0
ultima_revisao: "2026-06-13"
chamado: ""
aprovado_em: ""
release: ""
autor: ""
setor: ""
modulo: ""
---

## Visão Geral

Procedimento para atualizar a versão do Teorema em ambientes cloud. O processo envolve parar
serviços do cliente, derrubas sessões ativas no banco de dados, executar backup e restore com
o `gbak`, aplicar o script de correção da base via IBExpert, rodar o atualizador de versão e,
por fim, executar as atualizações pós-versão pelo módulo Administrador.

## Parar o Servidor de Notas e a Conexão Fênix

Antes de qualquer alteração, pare o servidor de notas do cliente para evitar conflitos durante
a atualização. Se o cliente possuir site integrado, interrompa também a conexão Fênix, que
faz a ligação entre a base de dados e o site.

![Servidor de Notas Teorema com status "Servidor está Online" e seta indicando o botão Parar](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/atualizacao-versao-teorema-3/atualizacao-versao-teorema-3-02.png)

![Fênix 2 — tela de log com lista de processos executados com sucesso e botão Finalizar destacado](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/atualizacao-versao-teorema-3/atualizacao-versao-teorema-3-03.png)

## Derrubar Usuários Conectados pelo Módulo Administrador

Na pasta do servidor cloud files (`\\10.254.80.5\T:\Teorema`), abra o `administrador.exe`
fazendo login com o usuário "Teorema". Em seguida, encerre as sessões de todos os usuários
ainda conectados ao banco do cliente.

![Módulo Administrador — tela de login com campo Usuário preenchido como "001 teorema" e botão Login](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/atualizacao-versao-teorema-3/atualizacao-versao-teorema-3-04.png)

Siga os passos abaixo para encerrar as sessões:

1. No menu **Administrador**, acesse **C – Configuração e Registro**.

![Menu Administrador expandido com opção "C - Configuração e Registro" destacada](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/atualizacao-versao-teorema-3/atualizacao-versao-teorema-3-05.png)

2. Na aba **Usuários Logados**, selecione cada sessão ativa (exceto o usuário `teorema` ADM,
   que é o seu próprio acesso) e clique em **Encerrar sessão**.

![Tela Configuração do Registro — aba "Usuários Logados" mostrando lista de sessões com colunas Sessão, Usuário e Módulo; botão "Encerrar sessão" e indicações "SELECIONAR O USUÁRIO" e "ENCERRAR A SESSÃO"](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/atualizacao-versao-teorema-3/atualizacao-versao-teorema-3-06.png)

Repita o procedimento para todos os usuários conectados, exceto o `teorema` ADM.

## Localizar a Base de Dados do Cliente via PuTTY

Conecte-se ao servidor via `putty.exe` (executável disponível na área de trabalho do servidor)
para identificar o diretório da base de dados do cliente.

**1.** Selecione o servidor onde a base de dados está hospedada e clique em **Open**.

![PuTTY Configuration — campo Host Name preenchido com 10.254.80.11, porta 22, tipo de conexão SSH; sessão salva "11" selecionada](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/atualizacao-versao-teorema-3/atualizacao-versao-teorema-3-07.png)

**2.** Faça login com as credenciais de administrador do servidor para obter acesso aos
diretórios.

![Terminal PuTTY — prompts "login as: marcio" e "marcio@10.254.80.11's password:"](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/atualizacao-versao-teorema-3/atualizacao-versao-teorema-3-08.png)

**3.** Navegue até a pasta da base de dados do cliente. No exemplo abaixo, o cliente é
`arrazo`:

![Terminal PuTTY — comandos "cd /home/bds", "cd arrazo/" e listagem dos arquivos: teorema_2211.fbk, teorema_arrazo.fbk, teorema_arrazo_22112021.fdb, teorema_arrazo.fdb](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/atualizacao-versao-teorema-3/atualizacao-versao-teorema-3-09.png)

## Gerar Backup e Restaurar a Base de Dados

Com o diretório localizado, execute o backup e o restore usando o `gbak` do Firebird.

**Backup** — nomeie o arquivo com a data atual da movimentação:

```
sudo /opt/firebird/bin/gbak -backup -g -z -l teorema_arrazo.fdb -USER SYSDBA -PAS masterkey teorema_2211.fbk -v
```

**Restore** — restaure o backup gerando um novo arquivo `.fdb`:

```
sudo /opt/firebird/bin/gbak -R -REP teorema_2211.fbk -USER SYSDBA -PAS masterkey teorema_2211.fdb -bu 1500 -p 4096 -use_all_space -v
```

**Permissão** — aplique permissão no arquivo gerado (substitua `teorema_dataatual.fdb` pelo
nome real com a data):

```
sudo chmod 777 teorema_dataatual.fdb
```

## Renomear a Base Atual e Atualizar os Executáveis

**1.** Via `winscp.exe`, renomeie o arquivo da base em uso para a data de execução.

![WinSCP conectado ao servidor 10.254.80.11 — painel remoto exibindo pasta /home/bds/arrazo/ com arquivos teorema_arrazo.fdb (Base atual) e teorema_arrazo_22112021.fdb (Base renomeada)](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/atualizacao-versao-teorema-3/atualizacao-versao-teorema-3-10.png)

**2.** Copie os executáveis e o arquivo `relatorios.7zip` da versão atual para a pasta do
cliente em `T:\Teorema\<cliente>` (pasta `teorema_files`). Antes de substituir, crie uma
cópia dos relatórios existentes como segurança. Em seguida, extraia o `relatorios.7z`
selecionando **7-Zip > Extrair para \relatorios**.

![Explorer mostrando pasta tp > google drive > publico > relatorios com arquivo relatorios.7z de 87.862 KB](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/atualizacao-versao-teorema-3/atualizacao-versao-teorema-3-11.png)

![Explorer mostrando pasta T:\Teorema\Arrazo com executáveis administrador.exe, atualizador.exe, faturamento.exe, arquivo relatorios.7z e subpastas Javaapp, relatorios, relatorios - Copy, SPED, users](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/atualizacao-versao-teorema-3/atualizacao-versao-teorema-3-12.png)

## Ajustar a Conexão no IBExpert e Executar o Script de Correção

**1.** Abra o `ibexpert.exe` (disponível em `T:\Teorema\`) e configure a conexão para a base
restaurada (`teorema_dataatual.fdb`). Se a base não estiver na lista, clone o registro de
outra base e ajuste os dados (servidor, caminho do arquivo e alias).

![IBExpert — janela Database Properties com servidor 10.254.80.11, caminho /home/bds/monolite/teorema_monolite0312.fdb, alias Monolite, User Name SYSDBA e campo Password preenchido (mascarado)](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/atualizacao-versao-teorema-3/atualizacao-versao-teorema-3-13.png)

**2.** Conecte-se à base com o usuário `SYSDBA` e senha `masterkey`. Acesse o **Script
Executive** (Ctrl+F12), abra o script localizado em
`I:\teorema\tp\google drive\publico\uteis\script_correcao_banco_20.06-21.05.txt` e execute-o.

![Explorer mostrando o arquivo script_correcao_banco_20.06-21.05.txt na pasta uteis](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/atualizacao-versao-teorema-3/atualizacao-versao-teorema-3-14.png)

![Bloco de Notas com o início do script: "execute block as declare variable iSequencia integer; declare variable iContem integer; begin select count(rdb$field_name)"](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/atualizacao-versao-teorema-3/atualizacao-versao-teorema-3-15.png)

![IBExpert Script Executive com o script carregado — trecho destacado consultando rdb$relation_name = 'TEO_USUARIOS_LOG' e rdb$field_name = 'CHAVE'; botão Run Script (F9) na barra de ferramentas](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/atualizacao-versao-teorema-3/atualizacao-versao-teorema-3-16.png)

## Executar o Atualizador de Versão

Na pasta do cliente, transfira o executável `atualizador.exe`. Antes de abri-lo, edite o
arquivo `teorema.ini` do usuário `teorema`, alterando o caminho da base do arquivo em uso
para o arquivo com a data atual. Com o `teorema.ini` ajustado, abra o `atualizador.exe` — ele
realizará a atualização do banco restaurado para a versão atual.

![Tela do Atualizador Teorema — Versão Atual 20.06a, Versão a ser Atualizada 21.05a; diálogo de confirmação "O Sistema executará agora a atualização da base de dados. Deseja Continuar com a ATUALIZAÇÃO?" com botões Sim e Não; rodapé indica BD: 10.254.80.5:/home/bds/montema/teorema_montema0912.fdb](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/atualizacao-versao-teorema-3/atualizacao-versao-teorema-3-17.png)

## Executar as Atualizações Pós-Versão

No `administrador.exe`, acesse **Administrador > H – Atualizações Pós Versão**.

![Menu Administrador expandido com a opção "H - Atualizações Pós Versão" destacada](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/atualizacao-versao-teorema-3/atualizacao-versao-teorema-3-18.png)

Se a atualização estiver correta, todas as linhas serão confirmadas com situação **Atualizado**.

![Tela Atualização Pós Versão — lista de atualizações de procedures e correções (PAT_CONTABIL_ESTOQUE_CCUS, PAT_FISCAL_CONHECIMENTO, PAT_FISCAL, entre outras) todas com situação "Atualizado"](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/atualizacao-versao-teorema-3/atualizacao-versao-teorema-3-19.png)

## Finalizar: Renomear a Base e Reativar os Serviços

**1.** Via WinSCP, renomeie o banco restaurado (`teorema_dataatual.fdb`) para o nome de
produção do cliente (`teorema_cliente.fdb`), tornando-o acessível novamente aos usuários.

![WinSCP — painel remoto exibindo pasta /home/bds/magnolia/ com arquivos teorema_2211.fbk, teorema_magnolia.fbk, teorema_magnolia.fdb (selecionado) e teorema_magnolia_old2211.fdb](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/atualizacao-versao-teorema-3/atualizacao-versao-teorema-3-20.png)

**2.** Edite novamente o `teorema.ini` do usuário `teorema` para apontar para a base que o
cliente passará a utilizar.

**3.** Teste os executáveis, ative o servidor de notas do cliente e verifique o funcionamento
do sistema.

---

## Informações do documento

> Autor:
> Setor:
> Módulo:
> Chamado:
> Versão do Sistema:
> Versão do documento:
> Revisão: 2026-06-13
> Aprovado em:

---

> 📎 **Arquivos originais:** [atualização de versão do teorema.docx](https://drive.google.com/uc?export=download&id=17FURUKJ4VE3KVFxYkQ1bgKhxYBvb8nwK) · [manual de uso do ftp.pdf](https://drive.google.com/uc?export=download&id=1AHka0hyJT1KbUh16gr01CffXZWuqV_oz)