GE - Como Fazer - Configuração de aplicação com Broker

Como Fazer > Utilidades/Diversos
Voltar

Revisar a instalação do Magic xpa

O Magic xpa deve estar instalado com o Broker configurado como serviço. Consulte GE - Como Fazer - Instalação do Magic xpa para informações detalhadas da instalação.

Informações para o arquivo adendo do Magic

Para os caminhos exemplificados a seguir, considera-se que a tradução do nome lógico %CIGAM_INSTAL% e o arquivo “magic.ini” constam na pasta C:\CIGAM e a aplicação que está sendo configurada é a CGWeb.

Crie um arquivo “.ini” de adendo com o conteúdo conforme abaixo:

• /[MAGIC_ENV]DeploymentMode=B
• /[MAGIC_ENV]InputPassword=N
• /[MAGIC_ENV]LicenseName=MGENT1
• /[MAGIC_ENV]StartApplication=*C:\CIGAM\CGWeb.ecf
• /[MAGIC_LOGICAL_NAMES]SERVER=S

Estas seriam as configurações básicas para diferenciar o ambiente para o Broker e apenas o caminho do arquivo “.ecf” da aplicação deve ser editado, as demais configurações são fixas. Deve-se conferir se o arquivo de licença do ambiente possui a licença para o Magic Enterprise Server.

Na pasta da instalação do Magic xpa são encontrados os arquivos “mgrb.ini” na quantidade de serviços que foram instalados, relativos à demanda de ambientes entre produção, contingência, homologação e testes.

Em cada arquivo a configuração “BrokerPort” vai possuir uma porta distinta para cada serviço e que é usada nas aplicações web instaladas no IIS, para atender os ambientes. Dentro da área “[APPLICATIONS_LIST]” se deve incluir uma linha com a chamada para a aplicação.

A linha deve possuir o nome da aplicação e apontar para a instalação do Magic xpa, utilizando o adendo que foi criado e o caminho de inicialização referenciando a pasta que contém o arquivo “magic.ini”. Demais parâmetros são fixos e a linha é composta conforme segue:

• CGWeb = C:\CIGAM\xpa\MgxpaRuntime.exe /@C:\CIGAM\adendo.ini,C:\CIGAM,,,1,0

• Observação:
  • Para administração/consultas, como QUERY RT, QUERY APPS e TERM, o solicitante aguarda um período de tempo calculado como o tempo limite do broker * 5, para permitir que o broker lide com consultas muito grandes. Para resolver um erro de tempo limite aplique os seguintes passos:
    • No diretório do broker, aumente o número de mecanismos Magic a serem iniciados (pré-carregados ou carregados automaticamente) na seção APPLICATIONS_LIST do arquivo Mgrb.ini . Você deve reiniciar o broker após modificar o arquivo Mgrb.ini.
    • Edite o arquivo Mgreq.ini na pasta do solicitante (como Scripts no caso de solicitantes da Web) ou o arquivo Magic.ini para executar operações de chamada remota. Configure o valor do Broker Timeout para um valor superior a 10 segundos.
      • Sintaxe: BrokerTimeout = 10 (segundos)
        
        
  • Para o tempo máximo, em segundos, que o solicitante espera que o servidor corporativo conclua a execução de uma solicitação.
    • Se esse tempo limite expirar, o servidor corporativo não interromperá a solicitação. Nesse caso, o solicitante pode continuar sem esperar pela saída.
    • Se o valor for 0, o tempo de execução da tarefa concluída é ilimitado. No entanto, as solicitações ainda podem ser limitadas pelas configurações da pilha do TCP/IP, caso em que o erro retornado será –107 porque a conexão com o servidor corporativo será redefinida pela pilha do TCP/IP. Quando esse tempo limite é definido como um valor diferente de zero e o tempo limite expira, o erro –110 é retornado.
      • Sintaxe: RequesterTimeout = 0
        
        
  • Para o intervalo, em segundos, dentro do qual o intermediário instrui os mecanismos a enviar mensagens ao intermediário.
    • Se o valor for 0, os mecanismos não enviarão as mensagens.
      • Sintaxe: ServerTimeout = 60 (segundos)
        
        
  • Para o tempo, em segundos, que uma operação TCP/IP (conectar/enviar/receber) tentará novamente antes de falhar na operação.
    • Essa configuração no arquivo Mgrb.ini substitui a configuração no arquivo Mgreq.ini para mensagens enviadas pelo intermediário.
    • As mensagens de baixo nível da camada do solicitante genérico ainda usam a configuração do arquivo Mgreq.ini.
      • Sintaxe: CommTimeout = 10

Como conferir o funcionamento do Broker?

É possível validar o funcionamento de cada ambiente que foi preparado com uma chamada de programa que retorne a resposta esperada.

Por um navegador, apontando para a URL contendo a biblioteca de comunicação do Broker e informando os parâmetros APPNAME e PRGNAME para indicar a aplicação CGWeb e o programa WW00003.

Por uma linha de comando, com o aplicativo “MGrqcmdl.exe” da instalação do Magic xpa, informando os mesmos parâmetros acima e o parâmetro PORT para a porta do Broker desejado.

Pelo monitoramento do Broker, com o aplicativo “MgBrokerMonitor.exe” disponível na instalação do Magic xpa.

Através do monitoramento é possivel verificar as requisições que estão sendo executadas, o tempo de retorno de cada uma delas e eventuais falhas na comunicação.

Como conferir o Broker nos serviços do Windows?

Após os testes de acesso devemos confirmar se os serviços do Broker estão configurados para iniciar automaticamente junto com o servidor. O tipo de inicialização deve ser Automático e a credencial de acesso deve dar permissão de abertura da instalação do CIGAM no sistema de arquivos.