Framework - Linha Datasul - TEC - Como gerenciar uma instância PASOE utilizando OEJMX

Tempo aproximado para leitura: 00:02:50 min

Dúvida
Como gerenciar uma instância PASOE utilizando OEJMX?

Ambiente
Framework - Framework (Linha Datasul) - PASOE - A partir do OpenEdge 12

Solução
A ferramenta OEJMX - OpenEdge for Java Management Extensions é uma aplicação de linha de comando que permite o gerenciamento e o monitoramento de uma instância PASOE - Progress Application Service for OpenEdge.

Ela já vem instalada com o PASOE e não requer que seja realizada nenhuma configuração adicional na instância a ser gerenciada, nem mesmo o deploy da aplicação OEManager.war.

Outro benefício é que ela somente pode ser utilizada localmente no servidor da instância PASOE, o que contribui positivamente para a segurança.

Para utilizá-la basta acessar a script PROENV e navegar até o diretório BIN da instância PASOE. No exemplo a seguir listamos os agentes que estão sendo executados na instância Datasul:

C:\totvs\pasoe_datasul\bin>oejmx -R -Q {\"O\":\"PASOE:type=OEManager,name=AgentManager\",\"M\":[\"getAgents\",\"datasul\"]}
{"getAgents":{"agents":[{"agentId":"MlbFimt0RdCq2ws96revug","pid":"5908","state":"AVAILABLE"}]}}

O parâmetro -R indica para que seja exibido apenas o resultado da consulta no formato JSON - JavaScript Object Notation, sem as demais informações que compõem o relatório. Já no parâmetro -Q é informada a query desejada, que neste caso foi o comando getAgents recebendo como parâmetro o nome da aplicação Datasul.

O resultado é retornado pela ferramenta no formado JSON. Para facilitar a leitura deste é possível utilizar um formatador JSON, conforme no exemplo abaixo, onde a mesma consulta foi direcionada para o formatador jq-win64.exe:

O formatador utilizado neste exemplo pode ser baixado no link disponível no item Saiba mais, para os ambientes Windows, Linux e outras plataformas. Basta adicionar o caractere pipe logo após o final da query e referenciar o local e o nome do formatador.

Existem diversas consultas que podem ser utilizadas, uma listagem completa delas também está disponível no item Saiba mais.

Além de consultas de monitoramento também pode ser realizadas operações na instância, como habilitar/desabilitar funções, zerar contadores, etc.

Saiba mais
Consulte também as documentação a seguir:
JQ Json Processor
Principais consultas OEJMX
Sintaxe do comando OEJMX
Documentação completa OEJMX