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 do Listener HTTP do Grupo de Execução (Nós SOAP e HTTP)

Selecione os recursos e as propriedades associados aos nós HTTPInput, HTTPReply, SOAPInput, SOAPReply e SOAPAsyncResponse que você deseja alterar.

Para alterar estas propriedades, é necessário especificar o nome do broker e -e seguido pelo nome de um único grupo de execução e -o para especificar o objeto do grupo de execução. Se você especificar -o ExecutionGroup, será possível omitir -e para alterar uma propriedade que se aplica a todos os grupos de execução no broker especificado.

Como todas essas propriedades são definidas no nível do grupo de execução, elas serão aplicadas a todos os nós HTTPInput, HTTPReply, SOAPInput, SOAPReply e SOAPAsyncResponse que forem implementados no grupo de execução especificado.

Por padrão, todos os nós HTTP que você implementa no broker usam o listener do broker inteiro único. Se preferir, será possível alterar a configuração do broker para que todos os grupos de execução usem os listeners integrado nos grupos de execução. Também é possível usar o listener do broker inteiro para alguns grupos de execução e o listener integrado em outros grupos de execução. Para obter informações adicionais sobre estas opções, consulte Listeners HTTP.

Por padrão, todos os nós SOAP que você implementa em um grupo de execução usam o listener integrado. É possível alterar a configuração de alguns ou de todos os grupos de execução para que eles usem o listener do broker inteiro. Para obter informações adicionais sobre estas opções, consulte Listeners HTTP.

Se você desejar que os nós HTTP ou SOAP usem o listener do broker inteiro, consulte Parâmetros do Listener HTTP do Broker Inteiro para obter mais informações sobre como definir essa configuração.

É necessário reiniciar o grupo de execução para que todas as alterações sejam implementadas.

Escolha o ObjectName das seguintes opções:

As seguintes combinações são válidas:

-o ExecutionGroup

As seguintes propriedades e valores são válidos:
-n httpNodesUseEmbeddedListener
Configure o valor como false para fazer com que todos os nós HTTPInput e HTTPReply usem o listener HTTP do broker inteiro, se esse listener estiver ativado. Configure o valor como true para fazer com que todos os nós HTTPInput e HTTPReply que estão implementados no grupo de execução especificado usem o listener do grupo de execução integrado.

Se você tiver desativado o listener HTTP do broker inteiro, todos os nós HTTPInput e HTTPReply usarão o listener integrado, independentemente do valor dessa propriedade.

  • Tipo de valor - Booleano
  • Valor inicial – false
-n soapNodesUseEmbeddedListener
Configure o valor como true para fazer com que todos os nós SOAPInput, SOAPReply e SOAPAsyncResponse usem o listener HTTP integrado. Configure o valor como false para fazer com que todos os nós SOAPInput SOAPReply e SOAPAsyncResponse que estão implementados no grupo de execução especificado usem o listener do broker inteiro, se esse listener estiver ativado.

Se você tiver desativado o listener HTTP do broker inteiro, todos os nós SOAPInput, SOAPReply e SOAPAsyncResponse usarão o listener integrado, independentemente do valor dessa propriedade.

  • Tipo de valor - Booleano
  • Valor inicial -true

-o HTTPConnector

As propriedades e valores a seguir são válidos para HTTPConnector e HTTPSConnector:
-n address
Se o servidor tiver mais de um endereço IP, configure o valor como o endereço IP usado para recebimento na porta 7080. Se essa característica não estiver configurada, a porta 7080 será usada em todos os endereços IP associados ao servidor. No máximo um endereço pode ser especificado.
  • Tipo do valor - cadeia
  • Valor inicial - nulo
-n maxPostSize
Configure o valor como o tamanho máximo de POST (em bytes) que pode ser processado pelo listener do broker inteiro. Configure o valor como 0 para remover o limite.
  • Tipo de valor - inteiro
  • Valor inicial - 2097152 (2 megabytes)
-n acceptCount
Configure o valor como o número máximo de solicitações de conexão de entrada que podem ser enfileiradas. As solicitações recebidas quando esse limite é atingido são rejeitadas.
  • Tipo de valor - inteiro
  • Valor inicial -100
-n compressableMimeTypes
Configure o valor como uma lista de tipos MIME que são aplicáveis para compactação HTTP. Outros tipos MIME não são compactados.
  • Tipo de valor – lista separada por vírgula
  • Valor inicial - text/html,text/xml,text/plain
-n compression
Configure o valor como off para desativar a compactação, on para compactar dados de texto, force para compactar todos os dados, ou o tamanho mínimo (em bytes) de dados que deve ser recebido, antes de a saída ser compactada. Se a compactação estiver ativada e o comprimento do conteúdo não for conhecido, toda a saída será compactada.
  • Tipo do valor - cadeia
  • Valor inicial - off
-n connectionLinger
Configure o valor como o número de segundos durante os quais os soquetes (usados pelo HTTPConnector) devem permanecer ativos após um encerramento ser iniciado.
  • Tipo de valor - inteiro
  • Valor inicial - padrão JVM
-n connectionTimeout
Configure o valor como o número de milissegundos que o HTTPConnector deve aguardar uma solicitação ser recebida após ele aceitar uma conexão. Configure o valor como -1 para especificar nenhum tempo limite.
  • Tipo de valor - inteiro
  • Valor inicial - 60000
-n maxHttpHeaderSize
Configure o valor como o tamanho máximo (em bytes) que o HTTPListener aceita um cabeçalho de HTTP.
  • Tipo de valor - inteiro
  • Valor inicial - 8192 (8 kilobytes)
-n maxKeepAliveRequests
Configure o valor como o número máximo de solicitações que podem usar uma conexão persistente. Configure o valor como 1 para desativar solicitações keep-alive e forçar a criação de uma nova conexão para cada solicitação. Configure o valor como 0 ou -1 para permitir solicitações ilimitadas.
  • Tipo de valor - inteiro
  • Valor inicial -100
-n maxThreads
Configure o valor como o número máximo de encadeamentos que podem ser criados pelo HTTPConnector.
  • Tipo de valor - inteiro
  • Valor inicial - 200
-n minSpareThreads
Configure o valor como o número mínimo de encadeamentos que devem estar ativos.
  • Tipo de valor - inteiro
  • Valor inicial - 10
-n noCompressionUserAgents
Configure o valor como uma expressão regular que, quando correspondida com o cabeçalho de agente do usuário, desativa a compactação.
  • Tipo do valor - cadeia
  • Valor inicial - nulo
-n restrictedUserAgents
Configure o valor como uma expressão regular que, quando correspondida com o cabeçalho de agente do usuário, desativa o keep-alive.
  • Tipo do valor - cadeia
  • Valor inicial - nulo
-n socketBuffer
Configure o valor como o tamanho (em bytes) do buffer que deve ser utilizado para o armazenamento em buffer da saída do soquete. Configure o valor como -1 para desativar o uso de um buffer.
  • Tipo de valor - inteiro
  • Valor inicial - 9000 (9 kilobytes)
-n tcpNoDelay
Configure o valor como true para enviar os pacotes pequenos imediatamente.
  • Tipo de valor - Booleano
  • Valor inicial -true
-n enableLookups
Configure o valor como true para usar consultas de DNS para retornar o nome do host do cliente remoto. Configure o valor como false para retornar o endereço IP.
  • Tipo de valor - Booleano
  • Valor inicial – false
-n explicitlySetPortNumber
Configure o valor como o número da porta TCP/IP na qual o Connector cria um soquete do servidor e aguarda conexões recebidas.

A configuração deste valor desconecta o recurso de localização automática de portas do conector; esta porta é a única permitida, e o conector falhará ao iniciar se outro programa já tiver utilizado esta porta.

  • Tipo de valor - inteiro
  • Valor inicial - 7800-7842
  • Outros valores válidos - qualquer inteiro no intervalo 0-65536.

É necessário usar o atributo explicitlySetPortNumber, porque o atributo port não funciona mais.

Quando você configura o valor para zero, o sistema ativa o recurso de descoberta de porta automático novamente, iniciando com a última porta usada, que foi salva pelo grupo de execução. É possível alterar a porta padrão que é usada quando a varredura de porta é iniciada, configurando explicitamente um valor no intervalo 7800-7842 e, em seguida, especificando o número da porta como zero.

O valor inicial para HTTPS é 7843 dentro do intervalo 7843-7884.

-n autoRespondHTTPHEADRequests

Use esse valor para especificar se o conector manipula solicitações de HEAD para tráfego HTTP da mesma maneira que o faz para tráfego SOAP. Configure o valor como true para fazer com que o conector retorne uma resposta HTTP 200 OK se a solicitação destinar-se a um URI associado a um fluxo de mensagens.

Configure o valor como false para chamar o fluxo de mensagens se a solicitação destinar-se a um URI associado a um fluxo de mensagens.
Nota: Se a solicitação não destinar-se a um URI associado a um fluxo de mensagens, o conector retornará uma resposta HTTP 404 Not Found.
  • Tipo de valor - booleano
  • Valor inicial – false

-o HTTPSConnector

As propriedades listadas para HTTPConnector também são válidas para HTTPSConnector. As propriedades e os valores adicionais a seguir são válidos para o HTTPSConnector:

As seguintes propriedades e valores adicionais são válidos:
Dica: Os valores válidos para keystoreType, sslProtocol, sslSessionTimeout e ciphers são específicos da implementação JSSE. Estes valores estão na documentação do provedor JSSE. Para obter uma lista das plataformas que usam IBM® Java™, consulte o Apêndice A do Guia IBM JSSE2 em: http://www.ibm.com/developerworks/java/jdk/security/60/secguides/jsse2Docs/JSSE2RefGuide.html.
-n algorithm
Configure o valor como o algoritmo de codificação de certificado a ser utilizado.
  • Tipo do valor - cadeia
  • Valor inicial -
    • Solaris platformHP-UX platformSunX509 em Solaris e HP-UX
    • AIX platformz/OS platformLinux platformWindows platformIbmX509 em outros sistemas (AIX, Linux, Windows, z/OS)
-n clientAuth
Configure o valor como true se um certificado SSL válido deve ser recebido do cliente antes que uma conexão possa ser aceita.
  • Tipo de valor - Booleano
  • Valor inicial – false
-n keystoreFile
Configure o valor como o caminho e o nome do arquivo keystore no qual o certificado do servidor é armazenado.
  • Tipo do valor - cadeia
  • Valor inicial - padrão da plataforma
-n keystorePass
Configure o valor como a senha que é utilizada para acessar o certificado do servidor no arquivo keystore. O valor pode ser uma senha em texto simples ou, se o valor for prefixado com "brokerKeystore::", a senha será o valor nomeado que é configurado pelo comando mqsisetdbparms.
  • Tipo do valor - cadeia
  • Valor inicial - changeit
-n keystoreType
Configure o valor como o tipo de arquivo keystore utilizado.
  • Tipo do valor - cadeia
  • Valor inicial - JKS
-n truststoreFile
Configure o valor como o caminho e o nome do arquivo de armazenamento confiável.
  • Tipo do valor - cadeia
  • Valor inicial - padrão da plataforma
-n truststorePass
Configure o valor como a senha utilizada para acessar o arquivo de armazenamento confiável. O valor pode ser uma senha em texto simples ou, se o valor for prefixado com "brokerTruststore::", a senha será o valor nomeado que é configurado pelo comando mqsisetdbparms.
  • Tipo do valor - cadeia
  • Valor inicial - changeit
-n truststoreType
Configure o valor como o tipo de arquivo de armazenamento confiável usado.
  • Tipo do valor - cadeia
  • Valor inicial - JKS
-n sslProtocol
Configure o valor como a versão do protocolo SSL a ser usado.
  • Tipo do valor - cadeia
  • Valor Inicial - TLS
-n ciphers
Configure o valor como uma lista das cifras de criptografia que podem ser utilizadas. Se nenhum valor for configurado, qualquer cifra disponível será usada. O cliente envia uma lista de códigos por ordem de prioridade. O servidor seleciona o primeiro código aceitável na lista. Se nenhum dos códigos da lista for adequado, o servidor retornará um alerta de falha de handshake e fechará a conexão.
  • Tipo de valor – lista separada por vírgula
  • Valor inicial - nulo
-n keyAlias
Configure o valor como o alias fornecido ao certificado do servidor no keystore. Por padrão, a primeira chave no keystore é usada.
  • Tipo do valor - cadeia
  • Valor inicial - nulo
-n keypass
Configure o valor como a senha que é utilizada para acessar o certificado do servidor no arquivo keystore. O valor pode ser uma senha em texto simples ou, se o valor for prefixado com "brokerKeystore::keypass", a senha será o valor nomeado que é configurado pelo comando mqsisetdbparms.
  • Tipo do valor - cadeia
  • Valor inicial - changeit
-n sessionCacheSize
Configure o valor como o número máximo de sessões permitidas no Cache de sessão SSL. Essas sessões em cache estão disponíveis para renegociação de sessão SSL.
  • Tipo de valor - inteiro
  • Valor inicial -100
sslSessionTimeout
Configure o valor como o tempo (em segundos) permitido para que uma sessão SSL seja concluída. O valor é configurado no SSLSessionContext para SSLSessions criadas pelo HTTPConnector.
  • Tipo de valor - inteiro
  • Valor inicial - 86400 (24 horas)
  • Outros valores válidos - qualquer número inteiro positivo, 0 significa que não há tempo limite

Consulte o Comando mqsichangeproperties para obter exemplos de como alterar parâmetros.

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:30:06


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