Guia completo para instalar e configurar o Deskflow em seu ambiente
Verifique se seu sistema atende aos requisitos mínimos antes da instalação
Windows Server instalado e configurado
Arquitetura x64 obrigatória
Mínimo: 4 cores
Recomendado: 8 cores ou mais
Arquitetura x64
Mínimo: 8 GB
Recomendado: 16 GB ou mais
Para melhor performance
Pré-requisito: Protheus instalado
Ambiente funcionando corretamente
Deskflow atua como ferramenta de suporte
Arquivos .ini: Padrão UTF-8
Comum nas versões recentes
Appserver.ini configurado
Administrador: Necessário para instalação
Acesso entre servidores configurado
Para serviços @servidor remotos
Baixe a versão mais recente para Windows
Arquivo verificado e livre de vírus
Última atualização: Setembro 2025
Baixe o instalador e escolha o diretório adequado
Recomendado: D:\deskflow\
Evite: \Arquivos de Programas\
Motivo: Facilita acesso aos arquivos
Configure as portas durante a instalação
Porta Principal: 5000
Porta Secundária: 8073
Se ocupada: Altere durante setup
Recomendação: Mantenha padrão se disponível
Defina as credenciais de acesso ao sistema
Usuário: admin
Senha: msadm
⚠️ IMPORTANTE: Altere a senha após primeiro acesso
Complete a instalação e acesse o sistema
http://localhost:8073Definição: Processo de atualização de um ambiente de produção com uma nova versão compilada.
Environment base: ATUALIZAR
D:\TOTVS\Protheus\apo\atualizar
Environment de produção: PROD01
D:\TOTVS\Protheus\apo\apo01
1. Cria pasta versionada: D:\TOTVS\Protheus\apo\apo01\001
2. Copia conteúdo de atualizar para nova pasta
3. Atualiza arquivos .ini automaticamente
4. Próximas promoções: pastas 002, 003, etc.
⚠️ Importante: Após alteração do RPO, todos os usuários conectados devem fazer novo login e serviços REST/JOBs precisam ser reiniciados.
Definição: Conjunto organizado de serviços e Environments do seu ambiente Protheus.
Produção: Todos os serviços Protheus em produção
Teste: Todos os serviços Protheus em teste
DbAccess: Serviço do Dbaccess
TSS Produção: TSS da Produção
TSS Teste: TSS da Teste
💡 Dica: Um mesmo serviço pode estar em múltiplas topologias (ex: "Produção" e "Jobs").
O Deskflow vem com uma configuração de exemplo que deve ser personalizada para seu ambiente específico. Os nomes são ilustrativos e devem ser alterados.
⚠️ Importante: A topologia que receberá comandos de "Promover RPO" e "Aplicar Patch" deve conter todos os serviços cujos arquivos .ini precisam ser atualizados.
Preencha com todos os serviços que serão controlados na topologia
Clique em "Salvar" ao finalizar
Preencha os caminhos completos dos arquivos .ini dos appserver
Estes arquivos serão gerenciados pelo Deskflow
Permite edição e versionamento automático das pastas do RPO
Associe cada Environment a uma quantidade máxima de cópias
Define quantas versões serão mantidas em arquivo após promoções
Exemplo: Manter últimas 5 versões de backup
Arquivo principal de configuração, localizado no diretório de instalação.
[setup]
tenant_code = 999999
tenant_name = Deskflow Demonstracao
tenant_authorization = 999999
tenant_logo = C:/nginx/nginx_deploy/deskflow-logo.png
app_port = 5000
db_path = C:/nginx_deploy/deskflow/data
| Parâmetro | Descrição | Exemplo |
|---|---|---|
tenant_code |
Código de Cliente Deskflow | 999999 |
tenant_name |
Nome descritivo para aparecer no Deskflow | Empresa ABC - Producao |
tenant_logo |
Caminho para o arquivo de logo | D:/deskflow/assets/logo.png |
app_port |
Porta de comunicação da aplicação | 5000 |
db_path |
Caminho para o diretório de dados | D:/deskflow/data |
Após qualquer modificação no arquivo deskflow.ini, é necessário reiniciar o serviço do Deskflow para que as alterações tenham efeito.
Para habilitar a aplicação de patches, configure um binário dedicado:
1. Crie pasta: \patch_apply\ no mesmo nível dos appservers
Exemplo: Se existe D:\TOTVS\Protheus\bin\appserver1
Crie: D:\TOTVS\Protheus\bin\patch_apply
2. Copie: Todo o conjunto de arquivos do appserver para esta pasta
No appserver.ini da pasta patch_apply:
PATCH_APPLY
sourcepath=D:\TOTVS\Protheus\apo\patch_apply\apo001\
1. RPO de origem é copiado para pasta dedicada
2. Patch é aplicado
3. Se bem-sucedido, RPO de origem é promovido para nova versão com patch aplicado
Faça backup dos arquivos .ini antes da primeira configuração. O Deskflow faz backup automático a cada alteração, mas por prudência, faça backup manual na primeira vez.
Após promoções de RPO, todos os usuários conectados devem fazer novo login. Comunique à equipe sobre a necessidade de reconexão.
Serviços appserver REST e JOBs precisam ser reiniciados após alterações de RPO. Planeje janelas de manutenção adequadas.
Acompanhe logs durante aplicações de patch e verifique permissões de acesso entre servidores regularmente.
Problema: "Acesso negado durante a instalação"
Solução: Execute o instalador como administrador e desative temporariamente o antivírus
Problema: "Não foi possível conectar ao servidor Protheus"
Solução: Verifique firewall, portas liberadas e configurações de rede
Problema: "Sistema executando lentamente"
Solução: Verifique requisitos de hardware e feche aplicações desnecessárias
Nossa equipe está pronta para ajudar na instalação e configuração