WebSphere Virtual Enterprise, Version 6.1.1
             Sistemas Operacionais: AIX,, HP-UX, Linux, Solaris, Windows ,


Controlando a Geração do Arquivo plugin-cfg.xml

É possível substituir os valores de atributo padrão do arquivo plugin-cfg.xml gerados automaticamente pelo ODR (on demand router).

Os seguintes elementos são formatados como com.ibm.ws.odr.plugincfg.<element>.<attributeName>, em que <element> é o nome da palavra-chave do arquivo de configuração que denota o elemento que contém um atributo, e <attributeName> é o nome do atributo que está localizado dentro desse elemento. Configure os elementos como propriedades de sistemas JVM. Para configurar uma propriedade de sistema JVM no ODR no console administrativo, clique em Servidores > On Demand Routers > on_demand_router > Java e Gerenciamento de Processo > Definição de Processo > Java Virtual Machine > Propriedades Customizadas > Novo.

Configuração

Esse elemento inicia o arquivo de configuração de plug-in. Ele pode incluir um ou mais dos seguintes elementos e atributos.

com.ibm.ws.odr.plugincfg.config.ASDisableNagle
Especifica se o usuário deseja desativar o algoritmo de Nagle da conexão entre o plug-in e o servidor.

O valor padrão é false.

com.ibm.ws.odr.plugincfg.config.AcceptAllContent
Especifica se você poderá ou não incluir conteúdo nos pedidos POST, PUT, GET e HEAD quando um cabeçalho Content-Length ou Transfer-encoding estiver contido no cabeçalho do pedido. É possível especificar um dos valores a seguir para esse atributo:
  • True se o conteúdo for esperado e lido para todos os pedidos
  • False se somente conteúdo deve ser esperado e lido para pedidos POST e PUT.

O valor padrão é false.

com.ibm.ws.odr.plugincfg.config.AppServerPortPreference
Especifica o número da porta que será utilizado para construir URIs para um sendRedirect.

O valor padrão é HostHeader.

com.ibm.ws.odr.plugincfg.config.ChunkedResponse
Especifica se o plug-in agrupará a resposta no cliente quando houver um cabeçalho de resposta Transfer-Encoding : Chunked na resposta.

É possível especificar um dos valores a seguir para esse atributo:

  • True se o plug-in for agrupar a resposta no cliente quando houver um cabeçalho de resposta Transfer-Encoding : Chunked na resposta.
  • False se a resposta for para não agrupar.

O valor padrão é false.

com.ibm.ws.odr.plugincfg.config.IISDisableNagle
Especifica se você deseja desativar o algoritmo de Nagle.

O valor padrão é false.

com.ibm.ws.odr.plugincfg.config.IISPluginPriority
Especifica a prioridade com que o servidor da Web carrega o plug-in. É possível especificar um dos valores a seguir para esse atributo:
  • Alto
  • Médio
  • Baixo

O valor padrão é Alto.

com.ibm.ws.odr.plugincfg.config.IgnoreDNSFailures
Especifica se, ao ser iniciado, o plug-in ignorará falhas de DNS em uma configuração. Quando configurado como true, o plug-in ignorará falhas de DNS em uma configuração e será iniciado com êxito se pelo menos um servidor de cada ServerCluster resolver o nome do host. Todo servidor para o qual o nome do host não tenha sido resolvido é marcado como indisponível durante a configuração. O nome do host não é resolvido posteriormente durante o roteamento dos pedidos. Se ocorrer uma falha de DNS, uma mensagem de log será gravada no arquivo de log do plug-in e a inicialização do plug-in continuará em vez do não início do servidor da Web.

O valor padrão é false.

com.ibm.ws.odr.plugincfg.config.RefreshInterval
O intervalo de tempo, em segundos, em que o plug-in deve verificar se há atualizações ou alterações no arquivo de configuração. O plug-in procura modificações no arquivo ocorridas desde o carregamento da configuração do plug-in.

O valor padrão é 60. Em um ambiente de desenvolvimento em que as alterações são freqüentes, configure o intervalo de tempo para menos de 60 segundos. Na produção, configure um valor mais alto do que o padrão porque as atualizações na configuração não ocorrem com tanta freqüência. Se o recarregamento do plug-in não for bem-sucedido, o arquivo de log do plug-in conterá uma mensagem e a configuração anterior será utilizada até que o arquivo de configuração do plug-in seja recarregado com êxito. Consulte o arquivo de log do plug-in para obter informações adicionais no caso de erro.

com.ibm.ws.odr.plugincfg.config.ResponseChunkSize
O arquivo de plug-in lê o corpo da resposta em blocos de 64 k até que todos os dados da resposta sejam lidos, o que causa problema de desempenho para pedidos cujo corpo de resposta contenha grandes quantidades de dados.

Utilize esse atributo para especificar o tamanho máximo da parte a ser utilizado ao ler o corpo da resposta. Por exemplo, Config ResponseChunkSize="N">, em que N é igual ao tamanho do bloco em kilobytes.

Se o comprimento do conteúdo do corpo da resposta for desconhecido, um tamanho de buffer de N quilobytes será alocado e o corpo será lido em partes com tamanho de N quilobytes até que todo o corpo seja lido. Se o comprimento do conteúdo for conhecido, um tamanho de buffer do comprimento do conteúdo ou N será utilizado para ler o corpo da resposta.

O tamanho padrão da parte é 64 k.

com.ibm.ws.odr.plugincfg.config.VHostMatchingCompat
Especifica para utilizar o número da porta para correspondência do host virtual. Os seguintes valores podem ser especificados:
  • True para correspondência física, utilizando-se o número da porta no qual o pedido é recebido.
  • False para correspondência lógica, utilizando-se o número da porta contido no cabeçalho do host.

O padrão é false.

com.ibm.ws.odr.plugincfg.config.odrIncludeStopped
Especifica para permitir a inclusão de ODRs interrompidos. Os seguintes valores podem ser especificados:
  • True para inclusão de ODRs interrompidos.
  • False para não inclusão de ODRs interrompidos.

O padrão é false.

com.ibm.ws.odr.plugincfg.config.TrustedProxyEnabled
Especifica os proxies confiáveis. Os seguintes valores podem ser especificados:
  • True para inclusão de proxies confiáveis.
  • False para não inclusão de proxies confiáveis.

O padrão é false.

Log

O log descreve o local e o nível das mensagens de log gravadas pelo plug-in. Se não houver um log especificado no arquivo de configuração, as mensagens de log poderão ser gravadas no log de erros.

com.ibm.ws.odr.plugincfg.log.Name
O caminho completo para o arquivo de log no qual o plug-in gravará mensagens de erro.

O valor padrão é profileRoot/logs/http_plugin.log.

com.ibm.ws.odr.plugincfg.log.LogLevel
O nível de detalhe das mensagens de log gravadas pelo plug-in no log. É possível especificar um dos seguintes valores para esse atributo:
  • Trace. Todas as etapas do processo de pedido são registradas em detalhes.
  • Stats. O servidor selecionado para cada pedido e outras informações de equilíbrio de carga relacionadas ao tratamento do pedido são registrados.
  • Warn. Todas as mensagens de aviso e de erro resultantes do processamento de pedidos anormal são registradas.
  • Error. Somente as mensagens de erro resultantes do processamento de pedidos anormal são registradas.
  • Debug. Todas as etapas críticas executadas no processamento de pedidos são registradas.
  • Detail. Todas as informações sobre pedidos e respostas são registradas.
O valor padrão é Error.
CUIDADO:
Muitas mensagens são registradas no nível de rastreio, o que pode fazer com que o sistema de arquivo fique cheio muito rapidamente. Nunca utilize uma configuração de rastreio em um ambiente que esteja funcionando normalmente, já que afeta o desempenho de forma adversa.

ServerCluster

Esse elemento é um grupo de servidores geralmente configurados para servir os mesmos tipos de pedidos.

No caso mais simples, o cluster contém apenas uma definição de servidor. Quando houver mais de um servidor definido, o plug-in realizará um equilíbrio de carga nos servidores definidos utilizando um algoritmo Round Robin ou Aleatório. O padrão é Round Robin.

com.ibm.ws.odr.plugincfg.cluster.CloneSeparatorChange
Alguns dispositivos interativos não podem manipular o caractere de dois pontos (:) utilizado para separar IDs de clone em conjunto com afinidade de sessão. Esse atributo informa ao plug-in para esperar o caractere de mais (+) como o separador de clone. É necessário alterar as configurações dos servidores para que o servidor também separe IDs de clone com o caractere de mais.

O valor padrão é false.

com.ibm.ws.odr.plugincfg.cluster.LoadBalance
A implementação de Round Robin possui um ponto de partida aleatório. O primeiro servidor é selecionado aleatoriamente e o valor Round Robin é utilizado para selecionar servidores desse ponto em diante. Essa implementação assegura que em servidores da Web baseados em múltiplos processos, todos os processos não sejam iniciados pelo envio do primeiro pedido para o mesmo servidor.

O tipo de equilíbrio de carga padrão é Round Robin.

com.ibm.ws.odr.plugincfg.cluster.PostSizeLimit
O número máximo de bytes de conteúdo de pedido permitidos para que o plug-in tente enviar o pedido para um servidor. Se for recebido um pedido maior que esse tamanho, o plug-in encerrará o pedido.

O valor padrão é -1 byte, que indica que não existe limite para o tamanho da postagem.

com.ibm.ws.odr.plugincfg.cluster.RemoveSpecialHeaders
O plug-in inclui cabeçalhos especiais no pedido antes de redirecioná-lo para o servidor. Esses cabeçalhos armazenam informações sobre o pedido que serão utilizadas pelo aplicativo. Por padrão, o plug-in remove esses cabeçalhos dos pedidos que chegam antes de incluir os cabeçalhos necessários.

O valor padrão é true. Se você configurar o atributo como false, estará introduzindo um risco potencial para a segurança, pois os cabeçalhos de pedidos que chegam não são removidos.

com.ibm.ws.odr.plugincfg.cluster.RetryInterval
Um inteiro que especifica o período de tempo que deve decorrer entre o momento em que um servidor é marcado como inativo até o momento em que o plug-in tentará novamente uma conexão.

O valor padrão é 60 segundos.

Server (Servidor)

Esse elemento é uma instância de servidor configurada para manipular pedidos roteados para ela com base nas regras de roteamento da configuração do plug-in. O elemento server corresponde a um servidor de aplicativos em execução na estação de trabalho local ou em uma estação de trabalho remota.

com.ibm.ws.odr.plugincfg.server.ConnectTimeout
Permite que o plug-in execute conexões não bloqueadoras com o servidor de aplicativos, que são benéficas quando o plug-in não consegue entrar em contato com o destino para determinar se a porta está ou não disponível.

Se nenhum valor for especificado, o plug-in executará uma conexão bloqueadora na qual ele espera até que um sistema operacional exceda o tempo limite e permita que o plug-in marque o servidor como indisponível. Um valor maior que 0 especifica o número de segundos que o plug-in aguardará por uma conexão bem-sucedida. Se uma conexão não ocorrer após esse intervalo de tempo, o plug-in marca o servidor como indisponível e prosseguirá com um dos outros servidores definidos no cluster.

O valor padrão é 0.

com.ibm.ws.odr.plugincfg.server.ExtendedHandShake
Utilizado quando um firewall do proxy está entre o plug-in e o servidor de aplicativos. Nesses casos, o plug-in não está efetuando failover, conforme esperado.

O plug-in marca um servidor como parado quando connect() é encerrado. No entanto, quando um firewall do proxy estiver entre o plug-in e o servidor de aplicativos, connect() será bem-sucedido mesmo que o servidor de aplicativos de backend esteja parado. Isso faz com que o plug-in não efetue failover corretamente para outros servidores de aplicativos.

O plug-in contém esse atributo para assegurar que ele seja iniciado antes do envio do pedido.

O valor padrão é false.

com.ibm.ws.odr.plugincfg.server.MaxConnections
Especifica o número máximo de conexões pendentes com um servidor que flui por um processo do servidor da Web em qualquer momento exato.

O valor padrão é configurado como -1.

com.ibm.ws.odr.plugincfg.cluster.WaitForContinue
Especifica se deve ser utilizado o suporte 100 Continue de HTTP 1.1 antes de enviar o conteúdo do pedido ao servidor de aplicativos. O valor padrão é false. O plug-in não aguarda a resposta de 100 Continue do servidor de aplicativos antes de enviar o conteúdo do pedido.

Essa propriedade será ignorada para pedidos POST para impedir que ocorra uma falha se o servidor de aplicativos fechar uma conexão por causa de um tempo limite.

Ative essa função ao configurar o plug-in para funcionar com determinados tipos de firewalls de proxy.

com.ibm.ws.odr.plugincfg.TrustedProxyEnabled

Ativa o plug-in para suporte a servidores proxy confiáveis. Os valores são true ou false.

Propriedade

com.ibm.ws.odr.plugincfg.property.ESIEnable
Utilizado para ativar ou desativar o processador ESI (Edge Side Include). Se o processador ESI estiver desativado, os outros elementos do ESI no arquivo serão ignorados.

O valor padrão é true.

com.ibm.ws.odr.plugincfg.property.ESIMaxCacheSize
Um inteiro especificando, em unidades de 1 K byte, o tamanho máximo do cache. O tamanho máximo padrão do cache é 1024 K bytes (1 megabyte). Se o cache estiver cheio, a primeira entrada a ser despejada do cache será a mais próxima da hora de expiração.
com.ibm.ws.odr.plugincfg.property.ESIInvalidationMonitor
Indica se o processador ESI receberá ou não invalidações do servidor de aplicativos.

O valor padrão é false.

com.ibm.ws.odr.plugincfg.property.https.keyring
Utilize esse elemento para especificar os parâmetros de inicialização quando o protocolo do transporte estiver configurado como HTTPS.

Esse atributo é um nome suportado que é identificado pelo transporte. O valor padrão para o elemento de chaveiro é profileRoot/etc/plugin-key.kdb.

com.ibm.ws.odr.plugincfg.property.https.stashfile
O valor padrão para o arquivo stash é profileRoot/node/etc/plugin-key.sth



Conceitos relacionados
Visão Geral da Priorização do Fluxo de Pedidos
Tarefas relacionadas
Criando e Configurando ODRs
Roteando Pedidos Diretamente de um Servidor da Web para um Servidor de Aplicativos de Backend
Configurando um On Demand Router para Atualizar Dinamicamente a Configuração de Plug-in do Servidor da Web
Tópico de Referência    

Termos de Uso | Feedback

Última atualização: 24/09/2009 14h16min12s EDT
http://publib.boulder.ibm.com/infocenter/wxdinfo/v6r1m1/index.jsp?topic=/com.ibm.websphere.ops.doc/info/odoe_task/rodr_plugin_props.html