A release 12.1.2510 do Protheus traz uma mudança importante na configuração do ambiente: a Porta Multiprotocolo passa a ser obrigatória para a inicialização e operação dos ambientes Protheus.
A regra vale para os ambientes Protheus em geral, com uma exceção: os ambientes de PDV permanecem isentos dessa obrigatoriedade nesta versão.
Por isso, empresas que estão planejando a atualização para a 12.1.2510 devem revisar o arquivo appserver.ini antes da migração. Afinal, uma configuração inadequada pode impedir o acesso ao ambiente após a atualização.
O que é a Porta Multiprotocolo no Protheus?
A Porta Multiprotocolo no Protheus permite concentrar diferentes formas de comunicação entre o Application Server e os componentes do sistema em uma porta unificada.
A arquitetura pode atender, por exemplo, conexões do SmartClient, SmartClient WebApp e serviços REST. Além disso, a configuração também oferece suporte à comunicação segura por SSL. A TOTVS destaca ainda benefícios como simplificação da configuração, segurança dos dados e maior praticidade para ambientes em Cloud.
Dessa forma, a Porta Multiprotocolo ajuda a padronizar a comunicação entre diferentes componentes do ambiente Protheus.
O que muda na release 12.1.2510?
Até a chegada da 12.1.2510, a empresa podia encontrar ambientes sem a Porta Multiprotocolo habilitada.
A partir dessa release, porém, a TOTVS torna essa configuração obrigatória para a inicialização e operação do ambiente, exceto nos ambientes de PDV.
Consequentemente, o administrador precisa revisar o appserver.ini antes de iniciar o ambiente na nova release.
Caso o sistema não identifique a configuração necessária, o Protheus pode apresentar a seguinte mensagem:
“Porta Multiprotocolo – Não foi possível identificar a configuração do ambiente. Entre em contato com o Administrador do sistema!”
A própria Central de Atendimento da TOTVS confirma esse comportamento para ambientes na release 12.1.2510.
Como configurar a Porta Multiprotocolo no Protheus?
A configuração envolve principalmente as seções [DRIVERS] e [GENERAL] do arquivo appserver.ini.
Configure a seção [DRIVERS]
Na seção [DRIVERS], a configuração deve habilitar a Porta Multiprotocolo:
[DRIVERS]MultiProtocolPort=1
Esse parâmetro informa ao Application Server que o ambiente utilizará a Porta Multiprotocolo.
Configure a seção [GENERAL]
Na seção [GENERAL], informe o ambiente que será habilitado para o REST:
[GENERAL]app_environment=NOME_DO_AMBIENTE
Por exemplo:
[GENERAL]app_environment=PRODUCAO
O nome precisa corresponder ao ambiente configurado no servidor.
Portanto, não basta apenas habilitar MultiProtocolPort=1. Também é importante conferir o app_environment para garantir que o Application Server consiga identificar corretamente o ambiente.
A Porta Multiprotocolo utiliza SSL?
Sim. A arquitetura da Porta Multiprotocolo possui suporte à comunicação segura por SSL e a conexão SSL fica ativa por padrão em determinados cenários da porta.
Essa característica contribui para proteger a comunicação entre o Application Server e os componentes conectados ao ambiente.
Além disso, empresas que utilizam acessos externos por IP, hostname ou URL precisam avaliar a configuração dos certificados digitais de acordo com o cenário do ambiente.
Por isso, a preparação para a 12.1.2510 não deve considerar apenas a existência da chave MultiProtocolPort. A equipe responsável também precisa analisar as configurações de segurança e os certificados utilizados.
Quais componentes podem utilizar a Porta Multiprotocolo?
A Porta Multiprotocolo surgiu para concentrar diferentes tipos de comunicação em uma estrutura unificada.
Entre os componentes que podem utilizar essa arquitetura estão:
- SmartClient;
- SmartClient Electron;
- SmartClient WebApp;
- serviços REST;
- aplicações que utilizam TWebEngine;
- aplicações baseadas em PO UI/THF.
Essa centralização facilita a arquitetura do ambiente e, ao mesmo tempo, amplia as possibilidades de integração entre os componentes do Protheus.
O que verificar antes de atualizar para a 12.1.2510?
Antes da migração, vale incluir a Porta Multiprotocolo no checklist técnico do ambiente.
1. Revise o AppServer.ini
Primeiramente, localize o appserver.ini utilizado pelo serviço que será atualizado.
Depois, confira as seções [DRIVERS] e [GENERAL].
2. Confirme o MultiProtocolPort
Verifique se a configuração está definida como:
MultiProtocolPort=1
3. Confira o App_Environment
Na seção [GENERAL], confirme se o app_environment aponta para o ambiente correto.
4. Avalie o SSL e os certificados
Além disso, verifique se o ambiente utiliza comunicação segura e se os certificados necessários estão configurados corretamente.
5. Teste antes da produção
Por fim, faça a validação em homologação antes de aplicar a mudança no ambiente produtivo.
Dessa maneira, sua equipe consegue identificar eventuais problemas de configuração antes da atualização definitiva.
E se o ambiente não utilizar a Porta Multiprotocolo?
A documentação da TOTVS informa que a Porta Multiprotocolo não deve ser desabilitada, pois algumas aplicações podem não funcionar corretamente.
Entretanto, para releases e cenários em que a configuração ainda permite essa opção, existem parâmetros específicos no appserver.ini.
A partir da 12.1.2510, porém, a própria TOTVS estabelece a obrigatoriedade da Porta Multiprotocolo, com exceção dos ambientes de PDV nesta versão.
Portanto, não é recomendável simplesmente desativar a configuração para contornar uma dificuldade. O ideal é identificar a causa e adequar o ambiente à nova arquitetura.
Podemos te apoiar!
Precisa de ajuda com essas mudanças? Conte com a nossa equipe através de uma consultoria.
CLIQUE AQUI e entre em contato! Será um prazer te ajudar em mais um desafio
