Migração Clientes Local para Cloud
v2.12.0-r
Orienta o processo passo a passo para migrar clientes de ambiente local para infraestrutura cloud, incluindo procedimentos iniciais, desconexão de usuários, transferência de dados e certificados.
user_manual
public
migracao-clientes-local-para-cloud
|
Sistemas Teorema -> 00001
23
14/06/2026 16:19
· Bernardo
- Título
- Migração Clientes Local para Cloud
- Slug
- migracao-clientes-local-cloud
- Sistema(s)
- "Sistemas Teorema -> 00001"
- Categoria
- user_manual
- Tipo
- how-to
- Publico
- "Equipe de implantação Teorema"
- Autor
- Andreia B. Bley
- Setor
- Qualidade
- Modulo
- ""
- Keywords
- migração cloud local banco de dados firebird servidor de notas WinSCP PuTTY middleware
- Aprovado em
- 08/03/2022
- Release
- ""
- Versão Pipeline
- 2.7.0
- Chamado
- ""
- Ultima Revisao
- "2026-06-13"
--- title: Migração Clientes Local para Cloud slug: migracao-clientes-local-cloud sistema: - "Sistemas Teorema -> 00001" categoria: user_manual tipo: how-to publico: "Equipe de implantação Teorema" autor: Andreia B. Bley setor: Qualidade modulo: "" keywords: - migração - cloud - local - banco de dados - firebird - servidor de notas - WinSCP - PuTTY - middleware aprovado_em: 08/03/2022 release: "" versao_pipeline: 2.7.0 chamado: "" ultima_revisao: "2026-06-13" --- ## Visão Geral Descreve o processo de migração do banco de dados e do servidor de notas de um cliente do ambiente local (on-premises) para o servidor cloud Teorema. O procedimento cobre desde a parada dos serviços locais até a inicialização e validação do servidor de notas no cloud. ## Procedimentos iniciais Antes de iniciar a migração, pare os serviços locais do cliente: 1. No aplicativo **Arrazo** (servidor de notas local), acesse a aba **Log**, confirme que o servidor está online e clique em **Parar** para interromper o serviço.  2. Caso o cliente possua site integrado, acesse o aplicativo **Fênix 2** e clique em **Finalizar** para encerrar a conexão Fênix que liga a base de dados ao site.  ## Derrubar usuários conectados ao banco 3. Abra o módulo **administrador.exe**, faça login com o usuário `teorema` (senha padrão) e acesse a tela de administração.  4. No menu **Administrador**, selecione a opção **C - Configuração e Registro**.  5. Na tela **Configuração do Registro**, clique em **Usuários logados**, selecione cada sessão ativa (exceto o usuário teorema ADM) e clique em **Encerrar sessão**. Repita para todos os usuários conectados.  ## Enviar a base de dados e certificados para o cloud 6. Compacte e envie para o servidor cloud os seguintes itens do ambiente local: - Base de dados: `C:\teorema\windados\teorema.fdb` - Certificados do servidor de notas: `C:\teorema\javaapp\server\certificates\client` ## Criar diretório no servidor via PuTTY 7. Abra o **PuTTY**, informe o endereço IP e a porta **22** do servidor de destino e clique em **Open** para iniciar a sessão SSH.  8. Autentique-se com o login e a senha do administrador para obter acesso ao terminal do servidor.  9. No terminal, crie o diretório da empresa e conceda permissão de acesso: ```bash sudo mkdir nome_da_empresa sudo chmod 777 nome_da_empresa ```  ## Transferir a base de dados via WinSCP 10. Abra o **WinSCP**, conecte-se ao servidor de dados, localize o arquivo `TEOREMA.FDB` na pasta local do cliente (painel esquerdo) e faça o upload para a pasta do cliente no servidor (painel direito).  ## Executar backup e restore do banco no servidor 11. Pelo PuTTY, execute o backup do banco de dados do cliente: ```bash sudo /opt/firebird/bin/gbak -backup -g -z -l teorema_nomecliente.fdb -USER SYSDBA -PAS masterkey teorema_nomecliente.fbk -v ``` 12. Com o backup criado, execute o restore: ```bash sudo /opt/firebird/bin/gbak -R -REP teorema_nomecliente.fbk -USER SYSDBA -PAS masterkey teorema_nomecliente.fdb -bu 1500 -p 4096 -use_all_space -v ``` 13. Conceda permissão no banco de dados gerado: ```bash sudo chmod 777 teorema_dataatual.fdb ``` ## Configurar o teorema.ini dos usuários 14. Verifique a pasta do cliente no servidor, abra o arquivo `teorema.ini` de cada usuário e ajuste o direcionamento de banco, caminhos de relatórios e grids conforme o novo ambiente cloud. ![Arquivo teorema.ini aberto no Notepad; seção [Direcionamento de Banco] com entradas Pitágoras e WS_TEOREMA destacadas em amarelo apontando para endereço cloud; seções [Backup], [Direcionamento de Relatorios] com Path Crystal e [Direcionamento de Grids] com Path Grids também destacadas](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/migracao-clientes-local-cloud/migracao-clientes-local-cloud-10.png) ## Configurar o servidor de notas no middleware 15. Verifique na planilha de portas do middleware qual porta está disponível. A porta do novo cliente deve ser definida 20 números acima da última porta utilizada. | Empresa | IP | Porta | |---|---|---| | ODAIRK | 10.254.80.54 | 7020 | | VENDAMAQ | 10.254.80.54 | 7040 | | EXPRESSIVA | 10.254.80.19 | 7070 | | CAMM | 10.254.80.53 | 8000 | | JACITEX | 10.254.80.53 | 8020 | 16. No servidor middleware (conectado via WinSCP), acesse `/home/teorema/Teorema/javaapp`, copie a pasta **Server_Raiz** e renomeie a cópia com o nome da empresa do cliente.  17. Abra o arquivo `inicia_servidor.sh` e edite o caminho do diretório e o identificador da empresa nas linhas de `cd` e `java -jar`.  18. Abra o arquivo `server.ini` e edite as tags `PORT` e `ADDRESS` com a porta definida na planilha e o caminho do banco de dados no servidor. ![Arquivo server.ini aberto no editor; seção [SERVER_CONFIG] com CORE=WILDFLY; campo PORT=8020 destacado em amarelo; seção [DATA_BASE] com ADDRESS=10.254.80.24:/home/bds/jacitex/teorema_jacitex.fdb destacado em amarelo](https://teorema-spaces.nyc3.digitaloceanspaces.com/base_conhecimento/2023-arquivo/migracao-clientes-local-cloud/migracao-clientes-local-cloud-14.png) 19. Verifique o atalho `.desktop` do servidor na área de trabalho do middleware: os campos `Icon`, `Name` e `Exec` devem apontar para o diretório da empresa recém-configurado.  > **Nota:** Inicie o servidor pelo atalho e verifique os logs. Se o servidor iniciar sem erros, a configuração foi concluída com sucesso. ## Informações do documento > Autor: Andreia B. Bley > Setor: Qualidade > Módulo: > Chamado: > Versão do Sistema: > Versão do documento: 01 > Revisão: Gustavo Detoni > Aprovado em: 08/03/2022 --- > 📎 **Arquivos originais:** [manual migração clientes local para cloud.docx](https://drive.google.com/uc?export=download&id=1bqdear86lXceiIF31E44uxSjmYeJbFcI) · [manual migração clientes local para cloud.pdf](https://drive.google.com/uc?export=download&id=1uwYdry3sQvR4VBvycLxIQYgcOnDv0ayx)
Tags IA:
2023
anteriores
clientes
cloud
docx
junho
local
manuais
migracao
migracao-clientes-local-cloud
Prioridade: 7