📌 Resumo
A partir da Release 12.1.2510, a configuração da Porta Multiprotocolo passa a ser obrigatória para inicialização e operação dos ambientes TOTVS Protheus, exceto em ambientes de PDV — Ponto de Venda.
Essa mudança tem como objetivo melhorar a comunicação entre serviços, reforçar a segurança das conexões de rede e padronizar a configuração dos ambientes Protheus.
A obrigatoriedade foi publicada pela TOTVS para o produto TOTVS Framework, linha Protheus, módulo Configurador, função CFGX38.
🎯 Aplicabilidade
Este artigo se aplica a ambientes:
TOTVS Protheus;
Release 12.1.2510 ou superior;
Ambientes com arquivo appserver.ini;
Serviços REST;
WebApp;
Configurador;
Integrações dependentes da comunicação do Application Server.
⚠️ Exceção
Ambientes de PDV — Ponto de Venda permanecem isentos dessa obrigatoriedade nesta versão, conforme orientação da TOTVS.
🔄 O que muda na Release 12.1.2510?
Antes da Release 12.1.2510, a ausência da configuração da Porta Multiprotocolo podia não impedir a inicialização do ambiente.
A partir da Release 12.1.2510, caso o ambiente Protheus seja iniciado sem a configuração obrigatória, o acesso poderá ser bloqueado, exibindo a seguinte mensagem:
Porta Multiprotocolo - Não foi possível identificar a configuração do ambiente. Entre em contato com o Administrador do sistema!
Essa mensagem indica que o ambiente não conseguiu identificar corretamente a configuração necessária no arquivo appserver.ini.
⚙️ Configuração necessária no AppServer.ini
Para adequar o ambiente Protheus à obrigatoriedade da Porta Multiprotocolo, deve-se revisar o arquivo appserver.ini do serviço correspondente.
🧩 Seção [DRIVERS]
Inclua ou valide a seguinte chave:
[DRIVERS] MultiProtocolPort=1
🧩 Seção [GENERAL]
Inclua ou valide a chave app_environment, informando o nome do ambiente que será habilitado no REST:
[GENERAL] app_environment=NOME_DO_AMBIENTE
Exemplo:
[GENERAL] app_environment=PRODUCAO
A TOTVS orienta que a configuração seja validada diretamente no arquivo appserver.ini antes da atualização ou inicialização do ambiente em versão igual ou superior à 12.1.2510.
📝 Passo a passo recomendado
1. 🔎 Identificar o serviço Protheus
Localize o serviço Protheus que será atualizado ou iniciado na Release 12.1.2510.
Verifique se o serviço possui arquivo appserver.ini próprio ou se compartilha configuração com outros serviços.
2. 💾 Realizar backup do AppServer.ini
Antes de qualquer ajuste, gere uma cópia de segurança do arquivo atual.
Sugestão de nomenclatura:
appserver_backup_antes_multiprotocolo.ini
3. 🧩 Validar a seção [DRIVERS]
Abra o arquivo appserver.ini e localize a seção:
[DRIVERS]
Caso a chave não exista, inclua:
MultiProtocolPort=1
4. 🧩 Validar a seção [GENERAL]
Localize a seção:
[GENERAL]
Inclua ou revise a chave:
app_environment=NOME_DO_AMBIENTE
O nome informado deve representar corretamente o ambiente habilitado no REST, como por exemplo:
app_environment=PRODUCAO
ou
app_environment=HOMOLOGACAO
5. 🔁 Reiniciar o serviço
Após salvar o arquivo, reinicie o serviço Protheus correspondente.
Em seguida, valide:
Inicialização do serviço;
Acesso ao ambiente;
Acesso ao Configurador;
Comunicação REST, quando aplicável;
Rotinas dependentes do ambiente configurado.
🚨 Erros comuns
1. ❌ Chave MultiProtocolPort ausente
Quando a chave não está configurada, o ambiente pode impedir o acesso após atualização para release igual ou superior à 12.1.2510.
Correção:
[DRIVERS] MultiProtocolPort=1
2. ❌ Chave app_environment não configurada
Mesmo com a Porta Multiprotocolo habilitada, a ausência da chave app_environment pode impedir que o ambiente seja identificado corretamente.
Correção:
[GENERAL] app_environment=NOME_DO_AMBIENTE
3. ⚠️ Nome de ambiente incorreto
Caso o nome informado em app_environment não corresponda ao ambiente configurado, o serviço poderá apresentar falhas de identificação.
Exemplo incorreto:
app_environment=PROD
quando o ambiente correto seria:
app_environment=PRODUCAO
4. ⚠️ Ajuste realizado no AppServer.ini errado
Ambientes Protheus podem possuir múltiplos serviços e arquivos de configuração.
Antes de reiniciar, confirme se o arquivo alterado corresponde ao serviço correto.
✅ Recomendações preventivas
Antes de aplicar a Release 12.1.2510 ou superior, recomenda-se:
Revisar todos os arquivos appserver.ini dos ambientes Protheus;
Validar Produção, Homologação, Desenvolvimento e serviços auxiliares;
Confirmar se a chave MultiProtocolPort=1 está configurada;
Confirmar se a chave app_environment está preenchida corretamente;
Realizar backup dos arquivos antes da alteração;
Testar a inicialização dos serviços em ambiente de Homologação;
Registrar evidências da configuração aplicada;
Planejar janela técnica para aplicação em Produção.
❓ FAQ
A Porta Multiprotocolo será obrigatória para todos os ambientes Protheus?
Sim. A partir da Release 12.1.2510, a configuração passa a ser obrigatória para os ambientes Protheus, com exceção dos ambientes de PDV nesta versão.
Essa configuração deve ser feita antes da atualização?
Sim. O recomendado é revisar e ajustar o appserver.ini antes da atualização ou antes da primeira inicialização do ambiente na Release 12.1.2510.
O ambiente pode parar de acessar se a configuração não estiver correta?
Sim. Caso o serviço seja iniciado em versão igual ou superior à 12.1.2510 sem a configuração adequada, o sistema poderá impedir o acesso e apresentar mensagem de não conformidade.
A configuração se aplica ao ambiente de Homologação?
Sim. A configuração deve ser validada em todos os ambientes Protheus aplicáveis, incluindo Homologação, Produção, Desenvolvimento e demais serviços.
Preciso reiniciar o serviço após alterar o AppServer.ini?
Sim. Após alterar o arquivo appserver.ini, o serviço Protheus correspondente deve ser reiniciado para carregar a nova configuração.
🧭 Conclusão
A obrigatoriedade da Porta Multiprotocolo na Release 12.1.2510 exige atenção dos administradores e consultores responsáveis por ambientes TOTVS Protheus.
A adequação preventiva do appserver.ini reduz riscos de indisponibilidade, evita falhas de acesso após atualização e mantém o ambiente alinhado às novas exigências técnicas do TOTVS Framework.
Na Mastersiga Consultoria, essa orientação reforça nosso compromisso com excelência, inovação e conectividade na sustentação de ambientes TOTVS.
📚 Referências
TOTVS TDN — DFRM1-37254 DT Obrigatoriedade da Porta Multiprotocolo – Release 12.1.2510
TOTVS TDN — Configurando Porta Multi Protocolo para múltiplos ambientes
TOTVS TDN — DFRM1-35373 DT REST MPP, porta única para mais de um ambiente
🏷️ Categoria sugerida
Framework / Protheus / Application Server
🔖 Tags sugeridas
Protheus, TOTVS Framework, Release 12.1.2510, Porta Multiprotocolo, AppServer.ini, MultiProtocolPort, app_environment, Configurador, CFGX38
✍️ Assinatura
Fabrizio Augusto Ventavolo
Consultor Especialista TOTVS – Mastersiga
E-mail: [email protected]
Telefone: (11) 4735-4049
“Conectamos tecnologia, processos e pessoas para acelerar resultados com excelência em sistemas TOTVS.”