WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

Parâmetros de Configuração do Servlet do Proxy

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:

Opções Gerais

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.

Opções de Informações

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.

Opções de ReplyToQ e QMgr

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.

Opções de Conexão SSL

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.

Opções de conexão de MQ

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.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:29:02


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | ac69430_