Guia do Usuário — TOTVS Protheus

Guia do Usuário — DeskFlow

Manual completo para administração de ambientes TOTVS Protheus com o Deskflow.

Versão 3.0 · Maio 2026 · TOTVS

1 O que é o Deskflow?

O Deskflow é uma ferramenta de administração web para ambientes TOTVS Protheus. Ele centraliza em um único painel todas as operações que normalmente exigem acesso direto ao servidor: iniciar e parar serviços, editar arquivos INI, promover RPOs, aplicar patches e compilar fontes.

BenefícioDescrição
Acesso centralizadoUma URL, todos os servidores e ambientes
Controle de acessoUsuários e grupos com permissões granulares por topologia e ambiente
Auditoria completaToda operação registrada com usuário, data, origem e resultado
Tempo realStatus dos serviços via WebSocket, sem precisar recarregar a página
Sem cliente instaladoAcesso pelo navegador — Chrome, Edge ou Firefox

Glossário rápido

TermoSignificado
TopologiaConfiguração de servidor TOTVS nomeada (ex: "Produção", "Homologação")
ServiçoProcesso do SO — AppServer, DBAccess — controlado via SCM ou systemctl
AmbienteSeção do appserver.ini (ex: P12_001, UPDATE)
RPORepositório de objetos compilados do Protheus
SourcepathCaminho no servidor onde os arquivos RPO do ambiente residem
PromoçãoCópia do RPO de um ambiente para outro (ex: Homologação → Produção)
PatchArquivo .ptm, .pak ou .upd para atualizar o RPO

2 Requisitos de Acesso

  • Navegador moderno: Chrome, Edge ou Firefox (versões recentes)
  • Endereço (URL) fornecido pelo administrador — padrão: porta 8073
  • Credenciais de usuário (login e senha)
  • Nenhum software adicional precisa ser instalado no computador do usuário

3 Primeiro Acesso — Login

Tela de login do Deskflow
Tela de login — acesse pelo endereço fornecido pelo administrador
Login com credenciais preenchidas
Preencha usuário e senha, clique em Entrar

Passo a passo

  1. Abra o navegador e acesse o endereço fornecido pelo administrador
  2. Preencha o campo Usuário com seu login
  3. Preencha o campo Senha
  4. Clique em Entrar — você será redirecionado ao painel Monitor
Credencial padrão — novo ambiente Em ambiente recém-instalado: usuário admin / senha admin. Altere imediatamente após o primeiro acesso em Administrador → Conta.

Login via Active Directory (AD)

Se a topologia tiver integração AD configurada, o Deskflow autentica usando credenciais de domínio. Preencha o campo Usuário com o login de rede (sem prefixo de domínio).

Sessão e renovação automática

A sessão dura 1 hora e é renovada automaticamente em segundo plano enquanto você usa a aplicação. Se a sessão expirar por inatividade prolongada, você será redirecionado para o login.

4 Visão Geral da Interface

Após o login a interface é dividida em três áreas:

ÁreaLocalizaçãoFunção
Barra SuperiorTopoLogo, nome do usuário, toggle de tema claro/escuro, menu do usuário
Barra LateralEsquerdaNavegação: Home, Fórum, Configuração, Log, Arquiteturas, lista de Topologias
Área de ConteúdoCentro/DireitaPágina ativa — Monitor, Serviços, Config, etc.

Menu do usuário (canto superior direito)

Clicando no nome de usuário no canto superior direito, abre o menu com acesso a: Atualizar App · Conta · Usuários · Grupos · Suporte · Novidades · Sair.

Tema claro / escuro

O botão de lua/sol na barra superior alterna entre tema escuro (padrão) e tema claro. A preferência é salva automaticamente para o próximo acesso.

5 Monitor de Servidor

A tela de Monitor é a página inicial após o login. Exibe o estado dos recursos do servidor em tempo real.

Monitor de servidor — gráficos CPU, RAM e Disco
Monitor — CPU, Memória RAM e Uso de Disco atualizados a cada 30 segundos
GráficoExibe
MemóriaRAM usada vs. total disponível (donut)
Uso de DiscoEspaço usado vs. total (donut)
CPUPorcentagem de uso atual (gauge)

Uso de memória por processo

Ative o toggle Mostrar uso de memória para exibir uma tabela com todos os processos em execução: nome, caminho, PID, memória (MB), CPU% e usuário.

Dica O Monitor é a tela de observabilidade central — ideal para conferir rapidamente se todos os serviços estão no ar antes de começar o dia operacional.

6 Topologias e Serviços

Clique em uma topologia na barra lateral para abrir sua tela de gerenciamento.

Página de serviços da topologia Base Produção
Aba Serviços — lista com status em tempo real (verde = Running, vermelho = Stopped)

Controles de serviço

Cada linha da tabela possui três botões de ação:

BotãoAção
↺Reiniciar o serviço
▶Iniciar o serviço
■Parar o serviço

Para operar todos os serviços da topologia de uma vez use os botões no topo: Iniciar Todos · Parar Todos · Reiniciar.

Visualizando portas TCP

Ative o toggle Mostrar Portas para exibir a porta TCP principal de cada serviço diretamente na tabela.

Serviços com coluna de portas TCP visível
Toggle Mostrar Portas ativado — portas TCP lidas diretamente do arquivo INI em tempo real
Serviços remotos Serviços com formato NomeServico@servidor são controlados remotamente via PowerShell (Windows) ou SSH (Linux) sem necessidade de acesso direto ao servidor remoto.

7 Modo Exclusivo

O Modo Exclusivo é um estado operacional especial usado durante manutenções ou aplicação de patches — ele para os serviços normais e mantém apenas os serviços de patch/manutenção ativos.

Como ativar

  1. Na aba Serviços, clique em Ativar Exclusivo
  2. Confirme a ação no diálogo de confirmação
  3. Os serviços normais são parados; apenas exclusive_mode_services sobem
  4. O botão muda para Desativar Exclusivo em vermelho

Como desativar

  1. Clique em Desativar Exclusivo
  2. Confirme — os serviços normais são reiniciados automaticamente
Dica Combine com o Agendador para ativar/desativar automaticamente em horários programados (manutenções noturnas).

8 Editor de INI

Editor de arquivo INI embutido baseado no Monaco Editor (o mesmo do VS Code), com syntax highlighting e edição direta no servidor.

Editor INI com Monaco Editor mostrando appserver.ini
Editor INI — appserver.ini do P12ProdBroker com syntax highlighting e botões Salvar / Download

Como abrir

Na tabela de serviços, clique no ícone de engrenagem (⚙) na coluna Configuração da linha do serviço desejado.

Recursos

RecursoDescrição
Ctrl+FBusca no arquivo
Ctrl+ZDesfazer
RedimensionávelArraste as bordas do modal para ampliar
MaximizarBotão ⛶ para abrir em tela cheia
DownloadBaixa o INI como arquivo para o computador
SalvarGrava diretamente no servidor após validação
Atenção Alterações no INI entram em vigor somente após reiniciar o serviço correspondente.

9 Ambientes (Environments)

Aba Ambientes com lista de environments e sourcepaths
Aba Ambientes — lista com status, topologia, sourcepath e operações disponíveis

Status de um ambiente

StatusIndicadorSignificado
LiberadoVerdeOperacional — usuários conseguem logar
IndisponívelVermelhoAcesso bloqueado (RPOs prefixados com _)
Somente LeituraAmareloArquivo nao_atualizar.txt presente no sourcepath

Adicionando um ambiente

  1. Clique em + Novo
  2. Selecione o ambiente de origem (modelo)
  3. Informe o nome do novo ambiente
  4. O sistema copia a seção INI, deriva o sourcepath e cria o diretório automaticamente

Botões de operação em lote

Selecione um ou mais ambientes com as caixas de seleção e use os botões no topo: Promover · Comparar · RollBack · Patch · Dicionário · Compilar · Apagar.

10 Promoção de RPO entre Ambientes

Copia o conteúdo RPO de um ambiente de origem para um ambiente de destino.

Modal de promoção de RPO
Modal Promover RPO — selecione topologia e ambiente de origem/destino e o tipo de promoção

Tipos de promoção

TipoO que é copiado
RPO PadrãoConteúdo do sourcepath (RPO principal)
RPO CustomConteúdo do rpocustom (customizações)
Ambossourcepath + rpocustom

O que acontece durante a promoção

  1. Sistema adquire bloqueio exclusivo (nenhuma outra operação bloqueante roda em paralelo)
  2. INI de destino é copiado como backup automaticamente
  3. Sourcepath de destino é incrementado (ex: APO0022 → APO0023)
  4. Arquivos RPO são copiados
  5. Chaves sourcepath e rpocustom no INI de destino são atualizadas
  6. Operação é registrada no Log de Ações
Operação bloqueante Promoção, Patch e Atualização de Dicionário não podem rodar simultaneamente. Se outra operação estiver em andamento o sistema retorna erro 429 — aguarde a conclusão.

11 Rollback de Sourcepath

Reverte o sourcepath de um ambiente para uma versão anterior — desfaz uma promoção sem precisar recopiar arquivos.

Modal de RollBack de Ambiente
Modal RollBack de Ambiente — selecione topologia, ambiente e a versão (timestamp) para reverter
Como funciona O rollback apenas muda o ponteiro sourcepath no INI — não exclui arquivos. As versões anteriores permanecem no disco, tornando a operação rápida e segura.

12 Aplicação de Patch

Aplica patches (.ptm, .pak, .upd) diretamente pelo navegador, sem necessidade de acesso ao servidor.

Modal Aplicar Patch
Modal Aplicar Patch — selecione topologia, ambiente e faça upload do(s) arquivo(s) de patch
  1. Selecione a Topologia e o Ambiente destino
  2. Clique em Escolher arquivos — formatos: .ptm, .pak, .upd
  3. Marque Desfragmentar RPO após aplicação se desejado
  4. Clique em Aplicar Patch e acompanhe o log em tempo real
Boa prática Ative o Modo Exclusivo antes de aplicar patches em produção para garantir que nenhum usuário esteja conectado durante o processo.

13 Compilação de Fontes

Compila arquivos de fonte TOTVS (.prw, .tlpp) diretamente pelo Deskflow.

Modal Compilar Fontes
Modal Compilar Fontes — faça upload dos fontes .prw/.tlpp e acompanhe a saída em tempo real
  1. Selecione a Topologia e o Ambiente compilador
  2. Faça upload dos arquivos fonte (.prw / .tlpp)
  3. Marque Desfragmentar RPO após compilação se necessário
  4. Clique em Compilar — a saída completa (incluindo erros) aparece em tempo real

14 Compilação Automática via Git

Integração com repositório Git: faz git pull, detecta arquivos alterados no último commit e compila apenas os fontes modificados.

Configuração de Automação Git
Aba Automação — configure URL do repositório, branch, pasta local e token de acesso

Configuração (administrador)

CampoDescriçãoExemplo
URL do Repositório GitHTTPS ou SSH do repohttps://github.com/org/repo.git
BranchBranch a monitorarmain
Pasta do Projeto Git no ServidorClone local no servidorc:\totvs\
Environment de DestinoAmbiente que receberá a compilaçãoP12_2410
Token de Acesso (PAT)Token GitHub/GitLab para repos privados—

Executando a compilação Git

  1. Verifique que o Git está disponível clicando em Verificar Git
  2. Clique em Compilar do Git
  3. O sistema faz git pull, detecta fontes alterados e compila automaticamente

15 Atualização de Dicionário (UPDDISTR)

Modal de atualização de dicionário
Modal Dicionário — abas Seleção, Credenciais, Processamento e Log
  1. Selecione a Topologia e o Ambiente destino
  2. Faça upload dos arquivos de dicionário (.txt/.sdf) — sdfbra.txt é obrigatório
  3. Clique em Atualizar Dicionário
  4. Acompanhe a execução do UPDDISTR na aba Log
Atenção — acesso exclusivo Execute esta operação fora do horário de uso ou com o ambiente em status Indisponível. O UPDDISTR requer que nenhum usuário esteja conectado ao ambiente durante o processo.

16 Agendador de Tarefas

Programa operações para execução automática em horários e frequências configuráveis.

Aba Scheduler com tarefa de promoção agendada
Aba Scheduler — tarefa "Promover RPO" com status SUCCESS e histórico de execução
Modal Nova Tarefa com opções de agendamento
Modal Nova Tarefa — escolha ação, tipo de agendamento (Repetir / A cada / Uma vez) e configure horário

Tipos de agendamento

TipoUsoExemplo
RepetirDiário em horário fixoTodo dia útil às 02:00
A cadaIntervalo em minutos/horasA cada 30 minutos
Uma vezData e hora específica15/06/2026 às 03:00

Ações agendáveis

  • Iniciar / Parar / Reiniciar serviço
  • Ativar / Desativar Modo Exclusivo
  • Promover RPO entre ambientes
  • Aplicar Patch
  • Compilar fontes
  • Executar script no servidor
  • Chamar endpoint HTTP

17 Log de Operações

Trilha de auditoria completa de todas as operações realizadas no Deskflow.

Log de Ações com tabela de auditoria completa
Log de Ações — paginado, com filtros por coluna. Cada linha registra usuário, topologia, serviço, ação e resultado
ColunaDescrição
ResultadoSuccess ou Error
Dt Início / Hr InícioMomento exato do início da operação
UsuárioQuem executou
Topologia da AçãoTopologia afetada
ServiçoServiço ou operação (ex: Source Compilation)
AçãoDescrição da operação (ex: Compile, Start Service)
Top.Origem / PatchAmbiente ou arquivo de origem

Busca por palavra-chave (aba Logs)

Dentro de cada topologia, a aba Logs permite buscar texto nos logs de serviço diretamente nos arquivos do servidor.

Busca por palavra-chave nos logs
Aba Logs — campo de busca por palavra-chave nos arquivos de log dos serviços

18 Fórum Interno

Canal de comunicação em tempo real entre usuários do Deskflow — útil para coordenação durante janelas de manutenção.

Fórum interno do Deskflow
Fórum — mensagens em tempo real via WebSocket. Admins podem excluir mensagens.

Digite a mensagem no campo inferior e pressione Enter ou clique Enviar. As mensagens aparecem imediatamente para todos os usuários conectados.

19 Download de Arquivos

Baixe arquivos do servidor (logs, configurações, backups) diretamente pelo navegador — sem necessidade de FTP ou SSH.

Aba Arquivos com pastas compartilhadas e artefatos para download
Aba Arquivos — Pastas Compartilhadas (com Upload) e Artefatos para Download

Clique no nome de um artefato para expandi-lo e ver os botões Visualizar (abre inline) e Download (baixa para o computador).

21 Arquiteturas — Múltiplas Instâncias

Uma Arquitetura é um registro que aponta para outra instância Deskflow em outro servidor. Com duas ou mais arquiteturas cadastradas, a barra lateral exibe um seletor que permite navegar entre instâncias com um clique.

Modal de gerenciamento de arquiteturas
Modal Arquiteturas — lista de instâncias Deskflow cadastradas e formulário para adicionar nova

Caso de uso típico

Empresa com dois sistemas: Protheus em srv-protheus:8073 e Logix em srv-logix:8073. Com ambas as instâncias cadastradas em cada servidor, o usuário vê o seletor na sidebar e alterna entre elas sem digitar outra URL.

Configurando (administrador)

  1. Acesse Configuração → botão Arquiteturas
  2. Clique em + Adicionar, informe Descrição e URL
  3. Repita o mesmo cadastro em todas as instâncias que participam do grupo
Sessão independente Cada instância Deskflow mantém sua própria sessão. Ao navegar para outra instância pode ser necessário fazer login novamente naquele servidor.

22 Configuração do Sistema (admin)

Tela de configuração — aba Geral
Tela de Configuração — lista de topologias à esquerda, abas de edição à direita

A tela de Configuração possui as seguintes abas para cada topologia:

Aba Services

Config aba Services — lista de serviços com Descobrir
Aba Services — adicione serviços manualmente ou use Descobrir para listar todos os serviços do servidor automaticamente

Aba Environments

Config aba Environments
Aba Environments — gerencie a lista de ambientes com botões Adicionar, Descobrir (lê seções INI) e Verificar (versionamento)

Aba Arquivos (INI Paths)

Config aba Arquivos com caminhos INI validados
Aba Arquivos — caminhos dos arquivos appserver.ini gerenciados. Ícone ✓ verde = arquivo acessível no servidor
AbaConteúdo
GeralNome da topologia, timeouts, configuração AD
CompiladorINI e serviço AppServer usado para compilações
ServicesLista de serviços gerenciados (com Descobrir)
EnvironmentsLista de ambientes (com Adicionar / Descobrir / Verificar)
ArquivosCaminhos INI + pastas compartilhadas + artefatos download
LinksURLs rápidos exibidos na aba Links da topologia
AutomaçãoConfiguração Git Auto-Compile

23 Gerenciamento de Usuários (admin)

Página de gerenciamento de usuários
Página Usuários — lista com username, nome completo, grupo, email e empresa

Perfis disponíveis

PerfilCapacidades
adminAcesso total: configurações, usuários, grupos, todas as topologias
userAcesso limitado pelas permissões do grupo ao qual pertence

Para criar um usuário: clique em + Novo, preencha os campos e salve. O campo Grupo determina quais topologias e ambientes o usuário poderá acessar.

24 Gerenciamento de Grupos e Permissões (admin)

Página de grupos
Página Grupos — cada grupo tem botões Alterar, Acessos e Excluir

Clique em Acessos para abrir a matriz de permissões do grupo:

Modal de acessos com matriz de permissões
Modal Acessos — três colunas: Topologias (Acessa + Controla Serviços), Ambientes por topologia, e Permissões por ambiente

Estrutura de permissões

Clique em uma topologia para ver seus ambientes. Clique em um ambiente para configurar suas permissões (Promover, Compilar, etc.).

Exemplo prático Para um analista que pode operar serviços apenas em Homologação: crie um grupo "Suporte HML", ative "Acessa" + "Controla Serviços" apenas para a topologia Homologação, selecione os ambientes permitidos e atribua o usuário a este grupo.

25 Perfil do Usuário

Acesse via Administrador → Conta (menu superior direito).

CampoDescrição
UsernameLogin (somente leitura)
NomeNome de exibição na interface
GrupoGrupo de permissões associado
e-mailEndereço de e-mail
EmpresaEmpresa ou setor
Senha / ConfirmeDeixe em branco para não alterar a senha

Clique em Gravar para salvar as alterações.

Senhas seguras O Deskflow armazena senhas com criptografia bcrypt — nem o administrador consegue ver sua senha atual. Para trocar, preencha os campos Senha e Confirme com a nova senha desejada.

26 Suporte e Atualização

Acesse via Administrador → Suporte.

Informações de Suporte com versão e licença
Informações de Suporte — versão backend/frontend, status e validade da licença, dados do cliente
AçãoDescrição
Renovar LicençaSolicita renovação automática da licença ao servidor TOTVS
Download LogBaixa o arquivo de log da aplicação Deskflow para diagnóstico
Atualizar Backend (Beta)Atualiza apenas o backend para a versão beta (sem reiniciar nginx)
Atualizar AppAtualiza Deskflow completo — binário + frontend (serviços reiniciam)
Aviso — atualização completa Atualizar App causa interrupção breve (~10–30 segundos) enquanto os serviços reiniciam. Avise os usuários antes de executar em horário de uso.

27 Perguntas Frequentes

Não consigo ver a topologia X na sidebar
Verifique com o administrador se seu usuário foi adicionado a um grupo com permissão para aquela topologia (Grupos → Acessos → toggle "Acessa").
O serviço aparece como parado mas estava rodando
O status é atualizado a cada 30 segundos. Aguarde um ciclo ou clique em Reiniciar para forçar a consulta imediata.
A operação de promoção/patch retornou erro 429
Outra operação bloqueante (promoção, patch ou dicionário) está em andamento. Aguarde a conclusão antes de tentar novamente.
Esqueci minha senha
Contate o administrador para que ele redefina sua senha em Usuários → Alterar.
A compilação falhou mas não vejo o erro
Role o painel de log até o final — erros do AppServer aparecem nas últimas linhas. Procure por "Error", "Erro" ou "Failed".
O seletor de Arquiteturas não aparece na sidebar
O seletor só é exibido quando 2 ou mais arquiteturas estão cadastradas. Com 0 ou 1, a seção fica oculta. Peça ao admin para cadastrar todas as instâncias em Configuração → Arquiteturas.
Selecionei outra arquitetura e precisei fazer login de novo
Cada instância Deskflow mantém sua própria sessão independente. Se ainda não tiver feito login naquele servidor, será necessário autenticar.
Como saber quem fez uma determinada operação?
Acesse Log de Ações (menu lateral) e use os filtros de coluna para encontrar a operação por data, topologia ou tipo de ação.