É 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:
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