Dúvida

Como configurar o Senior Middleware para modo de exibição de instâncias (depuração)?

 

Solução

Importante

• A execução deste procedimento tornará o Senior Middleware indisponível momentaneamente. Execute esse processo em um momento que você não esteja utilizando Senior Middleware;
• O processo descrito nesse artigo pode variar um pouco de acordo com a versão do Windows que você estiver utilizando no seu servidor. Em caso de dúvidas sobre os recursos do Windows, entre em contato com o profissional responsável pelos ambientes Windows da sua empresa;
• A realização dos procedimentos requer acesso ao Windows com usuário administrador;
• Antes de iniciar o passo a passo para realização do processo, verifique o artigo TECNOLOGIA - WebServices - Como funciona o processamento de um WebService pelos sistemas de Tecnologia G5/G6 para você entender como que ocorre o processamento de um WebService. Neste artigo, basicamente você encontrará informações para que as instâncias do Middleware sejam executadas como Aplicativos e não como Serviço, sendo exibidas na sua tela como se fossem instâncias do sistema que você mesmo tenha aberto;
• O procedimento descrito abaixo pode ser realizado em qualquer Servidor do Middleware (caso você possua mais do que um Servidor). No entanto, é importante que você monitore qual Servidor do Middleware a requisição que você deseja acompanhar está sendo executada. Temporariamente, para facilitar o acompanhamento da execução, você pode parar outros servidores de Middleware, mantendo apenas um Servidor ativo, para facilitar o acompanhamento dos processo;
• O procedimento descrito neste artigo se aplica para execução de processos no Middleware, não se aplicando para execuções locais como, por exemplo, execução via MCDebug em Modo Local (para depuração de regras em MCDebug em Modo Local, verifique o artigo TECNOLOGIA - WebServices - Como realizar depuração de regras na execução de um WebService no MCDebug em Modo Local;
• O processo descrito abaixo também permite a coleta de log do SQLMon de um processo executado no Middleware Senior. Para isso, basta você abrir o SQLMon antes de iniciar as instâncias do Middleware (para maiores informações sobre coleta de Log do SQLMon, verifique o artigo TECNOLOGIA - SQLMon - Onde é possível encontrar informações sobre o aplicativo SQLMon para utilização em sistemas com Tecnologia G5 (índice);
• Caso você tenha o sistema em ambiente Cloud Senior, o procedimento descrito neste artigo precisará ser executado em conjunto com um profissional de IT Services. Para isso, registre um ticket para IT Services fazendo essa solicitação e justificando o motivo pelo qual você precisa realizar esse processo.

 

 

Atenção

Este artigo indicará execução de procedimento que posteriormente devem ser desfeitos. É importante que você anote a configuração existente no seu ambiente antes da alteração indicada no artigo, para que posteriormente você possa alterar as parametrizações para os valores originais.

 

 

 

Para iniciar o Senior Middleware em modo de exibição de instâncias (depuração), realize o processo abaixo:

 

1. Verificando configurações do SeniorConfigCenter

 

1.1. Abra o SeniorConfigCenter;

 

1.1.1. Acesse a opção Middleware / Balanceamento de carga;

 

1.1.2. Defina uma quantidade mínima de instâncias para o tipo de instância que atenderá o processo que você deseja monitorar;

 

Importante

Para informações sobre Pre-Load (pre-carregamento) de instâncias, verifique o artigo TECNOLOGIA - Middleware - O que é um Pre-Load (Pre-Carregamento) de instâncias.

 

1.1.3. Clique no botão Avançado da seção Quantidade Máxima de Instâncias:

 

1.1.3.1. Defina os parâmetros Reiniciar instâncias após o uso de memória atingir e Reiniciar instâncias após o tempo de execução atingir com a quantidade 0 (zero).

 

Importante

Anote essas parametrizações antes de modificá-las, pois você deverá retorná-las para os valores anteriores depois dos testes.

 

1.1.2. Salve as alterações;

 

 

 

2. Desinstalando o Serviço do Middleware onde o Gerenciador de Aplicativos (amgr) esteja instalado como Serviço

 

 

2.1. Acesse o Console de Serviços do Windows (services.msc) no Servidor do Middleware;

 

2.1.1. Encontre o Serviço com nome Senior Middleware (ID da instalação: "XX", ID do ambiente: XX). O nome exato irá variar conforme o ID da instalação e o nome do ambiente configurado. Abra as propriedades desse Serviço;

 

2.1.2. Na aba Geral, verifique no parâmetro Caminho do Executável se na linha de comando descrita existe o parâmetro -amgr definido:

Exemplo de linha de comando com parâmetros -svc e -amgr: C:\Senior\SeniorMiddleware.exe -svc -amgr id:senior instid:2326515 /uninstall

 

Importante

Caso haja apenas a definição do parâmetro -svc e não haja definição do parâmetro -amgr, isso significa que o Gerenciador de Aplicativos não está instalado como Serviço no seu ambiente. Desta forma, você pode ir diretamente a execução dos procedimentos do tópico 2 deste artigo.

 

2.1.3. Pare o Serviço. Se necessário, acesse o Gerenciador de Tarefas do Windows e finalize o aplicativo SeniorMiddleware.exe;

 

2.1.4. Copie a linha de comando completa definida no campo Caminho do executável;

 

2.1.5. Acesse a aba Logon das propriedades do Serviço e verifique qual o usuário está definido para execução do Serviço do Middleware;

 

2.2. Acesse o Prompt de Comando do Windows (cmd.exe) com usuário administrador;

 

Importante

Caso você não acesse com usuário administrador, os procedimentos podem não ser realizados adequadamente;

 

2.2.1. Execute a linha de comando que você copiou no tópico 1.1.3. e adicione o parâmetro /uninstall ao final da linha.

Exemplo: C:\Senior\SeniorMiddleware.exe -svc -amgr id:senior instid:2326515 /uninstall

 

Deverá ser exibida a mensagem Service uninstalled successfully.

 

 

 

2.2.2. Edite a linha de comando removendo o parâmetro -amgr e substituindo o parâmetro /uninstall pelo parâmetro /install.

Exemplo: C:\Senior\SeniorMiddleware.exe -svc id:senior instid:2326515 /install

 

2.2.3. Execute a linha de comando editada.

Deverá ser exibida a mensagem Service installed successfully.

 

 

Ao concluir esse processo, o Gerenciador de Aplicativos estará configurado como Aplicação e não como Serviço no seu servidor.

 

 

 

3. Iniciando o Gerenciador de Aplicativos e o Senior Middleware em modo de exibição de instâncias (depuração)

 

3.1. Tenha certeza que o Serviço do Middleware está parado. Se necessário, acesso o Gerenciador de Tarefas do Windows e efetue o fechamento de todos os aplicativos SeniorMiddleware.exe que estiverem na memória;

 

3.2. Execute a linha de comando do Serviço do Middleware, somente com o parâmetro -amgr (o parâmetro -svc não deve estar na linha de comando).

Exemplo: C:\Senior\SeniorMiddleware.exe -amgr id:senior instid:2326515

A execução pode ser realizada pela opção Executar (CTRL + R) do Windows.

 

Será exibida na bandeja do sistema o ícone do Gerenciador de Aplicativos:

 

Observação

Caso você não tenha anotado a linha de comando, execute novamente os tópicos 2.1, 2.1.1. e 2.1.2. desse artigo.

 

 

3.3. Dê dois cliques no ícone do aplicativo e ele será aberto:

 

 

3.3.1. Clique no botão Opções, e em seguida selecione a opção Mostrar:

 

Importante

• Caso você deseje utilizar o SQLMon durante o acompanhamento da execução do processo, é neste momento que você deverá acessar o SQLMon.
• Lembrando que no SQLMon você pode desativar a opção Autoclient Switch para evitar que o SQLMon armazene dados de mais de uma instância que esteja na memória;

 

3.4. Inicie o Serviço do Middleware no Console de Serviços do Windows (services.msc);

 

3.5. Retorne ao Gerenciador de Aplicativos, e acione o botão de atualização para atualizar o status de conexão do Gerenciador de Aplicativos com o Serviço do Middleware:

O status será atualizado para Conectado

 

3.6. Você perceberá que começarão a ser carregadas instâncias do Middleware em tela, conforme exemplos abaixo:

 

 

3.7. Agora você pode executar o processo que deseja monitorar/depurar e verificar a instância efetuando o processamento. Você pode também acompanhar o processamento das instâncias através do SeniorMonitorCenter.

 

 

4. Retornando as parametrizações originais

 

Importante

É extremamente que você retorne as parametrizações originais do Servidor de Middleware depois de efetuar os testes/depuração desejados.

 

Para retornar as parametrizações originais no Servidor do Middleware, execute os passos a seguir:

 

4.1. Pare os Serviços do Middleware e o Gerenciador de Aplicativos. Se necessário, abra o Gerenciador de Tarefas do Windows e pare todos os aplicativos SeniorMiddleware.exe;

 

4.2. Acesse o SeniorConfigCenter e retorne as parametrizações originais realizadas;

 

4.3. Caso você não tenha realizado os passos 2.1.3 ao 2.2.3, então você não precisa fazer nenhuma ação relacionada a reinstalação do Serviço do Middleware, pois o Gerenciador de Aplicativos do seu ambiente já é utilizado como aplicação.

Neste caso, basta você executar os passos abaixo:

 

4.3.1. Inicie o Serviço do Middleware no Console de Serviços do Windows (services.msc);

 

4.3.2. Inicie o Gerenciador de Aplicativos, executando a linha de comando do Serviço do Middleware, somente com o parâmetro -amgr (o parâmetro -svc não deve estar na linha de comando).

Exemplo: C:\Senior\SeniorMiddleware.exe -amgr id:senior instid:2326515.

 

4.4. Caso você tenha realizado os passos 2.1.3 ao 2.2.3, então você precisa desinstalar o Serviço do Middleware e instalá-lo novamente, adicionando o parâmetro -amgr novamente na linha de comando. Para isso, execute os passos abaixo:

 

4.4.1. Acesse o Prompt de Comando (cmd.exe) com usuário administrador;

 

4.4.2. Desinstale o serviço do Middleware executando a linha de comando com o parâmetro /uninstall ao final da linha.

Exemplo: C:\Senior\SeniorMiddleware.exe -svc id:senior instid:2326515 /uninstall

 

Deverá ser exibida a mensagem Service uninstalled successfully.

 

 

4.4.3. Edite a linha de comando adicionando o parâmetro -amgr e substituindo o parâmetro /uninstall pelo parâmetro /install.

Exemplo: C:\Senior\SeniorMiddleware.exe -svc -amgr id:senior instid:2326515 /install

 

Execute a linha de comando editada.

Deverá ser exibida a mensagem Service installed successfully.

 

 

Ao concluir esse processo, o Gerenciador de Aplicativos estará configurado como Serviço novamente.

 

4.4.4. Inicie o Serviço do Middleware novamente.

 

 

 

Observação

Para mais informações sobre os WebServices do Gestão Empresarial | ERP, consulte o artigo ERP - WebServices - Onde é possível encontrar informações diversas sobre processo de integração via WebServices (índice).