Para poder implementar o sevlet proxy web.xml no contêiner do servlet, você deverá configurá-lo com os seguintes parâmetros de inicialização para o ambiente do broker ao qual o servlet se conecta.
Este tópico contém as seguintes seções:
Nome do Parâmetro | Valor Padrão | Descrição |
---|---|---|
brokerName | * (detecção automática dos dados de configuração para o broker) |
nome do broker ou “*” Use este parâmetro para configurar o nome usado para mensagens de erro; o valor é detectado automaticamente se configurado como "*"'. Configure um valor se vários brokers estiverem sendo colocados em proxy e um único nome for necessário para mensagens de erro. |
configFilePath | /var/mqsi/components/MB8BROKER/config/wsplugin6.conf |
caminho completo para arquivo de configuração Se o broker de proxy for local, configure este parâmetro no arquivo wsplugin6.conf (para nós HTTP) ou no soapplugin6.conf (para nós SOAP) para o broker. Este arquivo é usado apenas quando o parâmetro useQueueManagerDataInsteadOfConfigFile é configurado como em branco. O arquivo de configuração pode ser usado apenas quando o servlet proxy está em execução no mesmo servidor que o broker e ele possui acesso ao arquivo. No Windows, o arquivo é armazenado em C:\install_dir\config\wsplugin.conf or C:\Documents and Settings\All Users\IBM\MQSI\components\broker_ name\config\wsplugin6.conf. No Linux e no UNIX, o arquivo é armazenado em /var/mqsi/config/wsplugin.conf ou em /var/mqsi/components/broker_ name/config/wsplugin6.conf. |
useFastpathBindingsConnection | falso |
true ou false Faz com que o servlet se conecte no modo fastpath, se estiver usando um gerenciador de filas locais. |
traceFileName | caminho completo para o arquivo de rastreio Especifique o local e o nome do arquivo de rastreio. Se este parâmetro não for especificado, o rastreio será enviado para stdout. |
|
turnTraceOn | 0 |
0, 1 ou 2 Configure 0 para nenhum rastreio, 1 para rastreio normal ou 2 para rastreio de depuração. |
Nome do Parâmetro | Valor Padrão | Descrição |
---|---|---|
enableStatusPage (WebSphere® Message Broker Versão 6.1 FP 4 ou posterior) |
falso |
true ou false Alterna a exibição da página de status. Quando true, a página está visível em http://hostname:port/proxy_context/messagebroker/httpproxy/statuspage |
enableInfoHeaders (WebSphere Message Broker Versão 6.1 FP 4 ou posterior) |
falso |
true ou false Faz com que o servlet inclua cabeçalhos extras na resposta. Estes cabeçalhos são: X-WMB-Broker-Name X-WMB-QM-Name X-WMB-MQ-URL-CorrelId e contêm detalhes da configuração usada para essa mensagem. |
Nome do Parâmetro | Valor Padrão | Descrição |
---|---|---|
useClusterMode | falso |
true ou false Configure como true se o servlet for necessário para colocar informações da fila de resposta e do gerenciador de filas no MQMD de mensagens enviadas para permitir que o broker responda ao gerenciador de filas correto em um cluster. |
clusterModeQueueManagerName | SOME_OTHER_ QUEUE_MANAGER |
nome do gerenciador de filas Nome do gerenciador de filas para MQCONN e ReplyToQMgr iniciais. |
clusterModeReplyToQ | OUR.REPLYTO.QUEUE |
nome da fila de resposta Nome da fila na qual atender. |
Nome do Parâmetro | Valor Padrão | Descrição |
---|---|---|
useSecuredChannel | falso |
true ou false Configure o valor de useSecuredChannel como true se SSL estiver configurado no MQ Channel. Se estiver configurado como true, o servlet tentará estabelecer uma conexão segura com o MQ Channel usando os valores de parâmetros keyStore, keyStorePassword, trustStore, trustStorePassword e cipherSuite. |
keyStore | caminho completo para o arquivo keystore O caminho completo para o arquivo keystore, que é do tipo "JKS". Por exemplo, no Windows: C:\\Program Files\\IBM\\MQSI\\keystore.jks No Linux e UNIX: /var/mqsi/keystore.jks |
|
keyStorePassword | changeit |
A senha para o arquivo keystore. |
trustStore | caminho completo para o arquivo de armazenamento confiável O caminho completo para o arquivo de armazenamento confiável, que é do tipo "JKS".Por exemplo, no Windows: C:\\Program Files\\IBM\\MQSI\\truststore.jks No Linux e UNIX: /var/mqsi/truststore.jks Esse campo será obrigatório se useSecuredChannel estiver configurado como true. |
|
trustStorePassword | changeit |
A senha para o arquivo de armazenamento confiável. |
cipherSuite | O tipo de criptografia configurado no MQ Channel. Por exemplo: SSL_RSA_WITH_NULL_MD5 Esse campo será obrigatório se useSecuredChannel estiver configurado como true. |
Nome do Parâmetro | Valor Padrão | Descrição |
---|---|---|
useClientMode | falso |
true ou false Use o cliente do WebSphere MQ (true) ou conexão de ligações (false). Normalmente, useQueueManagerDataInsteadOfConfigFile também seria configurado com o gerenciador de filas do broker se este parâmetro for configurado como true. |
clientModeHostname | localhost |
nome do host ou endereço IP Nome do host ou IP para o Gerenciador de Filas. |
clientModeChannelName | SYSTEM.DEF. SVRCONN |
Nome do canal SVRCONN do WebSphere MQ O nome do SVRCONN do WebSphere MQ a usar. |
clientModePortNumber | 1414 |
número da porta Número da porta listener do WebSphere MQ. |
clientModeConnectRetryCount (WebSphere Message Broker Versão 6.1 FP 4 ou posterior) |
1 |
integer Número de vezes para tentar novamente a chamada de conexão do WebSphere MQ. Use este parâmetro nos casos em que um dispatcher de rede ou balanceador de carga está sendo usado para distribuir trabalho para um conjunto de gerenciadores de filas e um falha. Uma nova conexão pode falhar na primeira vez, mas ser bem-sucedida na segunda vez. A contagem de novas tentativas deve ser configurada com um número alto para fornecer a maior chance de êxito. |
useQueueManagerDataInsteadOfConfigFile | nome do gerenciador de filas, “*” ou em branco Nome do gerenciador de filas, ‘*' (proxy remoto) ou em branco para nenhum (proxy local). Esta opção faz com que o servlet leia dados de endereço da Web de uma fila e evite a necessidade de um arquivo de configuração estar acessível a partir do servlet. |
|
sleepBeforeGet | 0 |
tempo em segundos Tempo de suspensão em segundos. Este valor faz com que o servlet aguarde antes de emitir um MQGET para obter uma mensagem de resposta do broker. |
disconnectBeforeSleep | verdadeiro |
true ou false Para liberar o identificador do WebSphere MQ durante a suspensão. Útil para manter o número de conexões do WebSphere MQ simultâneas inativas. |
reconnectActiveLinksAge (WebSphere Message Broker Versão 6.1 FP 4 ou posterior) |
-1 |
tempo em segundos, 0 ou -1 Se configurado com um número maior que zero, este parâmetro faz com que as conexões do WebSphere MQ sejam desconectadas e reconectadas se tiverem ficado inativas, devido aos baixos volumes de tráfego, por mais do que o número de segundos especificado. Configurar isto como -1 evita esta reconexão. Configurar como 0 faz com que todas as conexões sejam usadas apenas uma vez. Este parâmetro é de uso mais frequente se a conexão com o WebSphere MQ for através de um firewall que fecha conexões após um período de inatividade. Configurar este parâmetro com um valor menos que o tempo limite de firewall pode impedir os clientes de receberem erros do WebSphere MQ 2009 (conexão interrompida). |
testConnectionBeforeReuse (WebSphere Message Broker Versão 6.1 FP 4 ou posterior) |
falso |
true ou false Se configurado como true, o servlet tenta um MQINQ antes de fazer a MQPUT da mensagem de dados HTTP. Todos os problemas com uma conexão do cliente WebSphere MQ em cache são detectados nesse ponto e uma nova conexão é estabelecida para MQPUT dos dados reais (e MQGET da resposta). Este parâmetro causa tráfego de rede extra significativo e deve ser usado apenas se problemas tiverem sido vistos em conexões descartadas, os quais geralmente são vistos como erros do WebSphere MQ 2009, indicando interrupção da conexão. |
maximumConnectionAge (WebSphere Message Broker Versão 6.1 FP 6 ou posterior) |
-1 |
tempo em segundos, 0 ou -1 Se configurado com um número maior que zero, este parâmetro faz com que conexões WebSphere MQ sejam desconectadas e reconectadas se forem mais antigas do que o número especificado de segundos. Configurar este parâmetro como -1 impede estas reconexões; configurar este parâmetro como 0 faz com que todas as conexões sejam usadas apenas uma vez. Este parâmetro é mais usado, se as mudanças frequentes nos parâmetros de conexão do WebSphere MQ são esperadas devido a reimplementações dos fluxos do WebSphere Message Broker e você requer que o ProxyServlet reflita estas mudanças dentro do número de segundos especificado. |
É possível definir um ou mais mapeamentos que são suportados pelo servlet proxy. Estes mapeamentos são usados pelo contêiner do servlet para filtrar pedidos de endereço da Web antes de executar a instância correta do servlet de proxy.
Os mapeamentos são os caminhos /node_url_path descritos em Servlet do Proxy HTTP; Componente de Endereços da Web (/url_path=/context_root/node_url_path).
É possível definir um /node_url_path igual a "/*" para aceitar caminhos de endereço da Web semelhantes a este exemplo: /HTTPMyBrkServletProxy/your_value.