![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
Intelligent Management: Controlando a Geração do Arquivo plug-in-cfg.xml
É possível substituir os valores de atributo padrão do arquivo plug-in-cfg.xml gerados automaticamente pelo On Demand Router (ODR).
Os elementos a seguir são formatados como com.ibm.ws.odr.plug-incfg.<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 localizado nesse elemento. Configure os elementos como propriedades de sistemas JVM. Para configurar uma propriedade de sistema de JVM no ODR no console administrativo, clique em
.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.plug-incfg.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.plug-incfg.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 tiver que ser esperado e lido por todas as solicitações.
- False se o conteúdo tiver que ser esperado e lido somente por solicitações POST e PUT.
O valor padrão é false.
O valor padrão é true.
- com.ibm.ws.odr.plug-incfg.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.plug-incfg.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 tiver de particionar a resposta para o cliente em uma Codificação de Transferência : Cabeçalho de resposta particionada está presente na resposta.
- false se a resposta não dever ser truncada.
O valor padrão é false.
- com.ibm.ws.odr.plug-incfg.config.IISDisableNagle
- Especifica se você deseja desativar o algoritmo de Nagle.
O valor padrão é false.
- com.ibm.ws.odr.plug-incfg.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.plug-incfg.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.plug-incfg.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
verifica quaisquer modificações no arquivo que ocorreram desde que a configuração
de plug-in foi carregada.
O valor padrão é 60. Em um ambiente de desenvolvimento em que as alterações são frequentes, 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 frequê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 se ocorrer um erro.
- com.ibm.ws.odr.plug-incfg.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 chunk 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.plug-incfg.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.plug-incfg.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.plug-incfg.config.TrustedProxyEnable
- 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. Os proxies confiáveis são coletados dos proxies de segurança confiáveis definidos na página do console administrativo
.
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.plug-incfg.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_plug-in.log.
- com.ibm.ws.odr.plug-incfg.log.LogLevel
- O nível de detalhe das mensagens de log gravadas pelo plug-in no
log. É possível especificar um dos valores a seguir para esse
atributo:
- Trace. Todas as etapas no processo de solicitação são regradas em detalhe.
- Stats. O servidor selecionado para cada solicitação e outras informações de balanceamento de carga relacionadas à manipulação de solicitações são registrados.
- Warn. Todas as mensagens de aviso e erro resultantes do processamento de solicitação anormal são registradas.
- Error. Somente as mensagens de erro resultantes do processamento de solicitação 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 é Erro.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.plug-incfg.cluster.CloneSeparatorChange
- Alguns dispositivos disseminados não podem manipular o caractere dois-pontos (:) que
é usado para separar IDs de clone em conjunto com a 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.plug-incfg.cluster.LoadBalance
- A implementação de Round Robin possui um ponto inicial
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.plug-incfg.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.plug-incfg.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.plug-incfg.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
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.plug-incfg.server.ServerIOTimeout
- Ativa o plug-in para configurar um valor de tempo limite, em segundos, para o envio de solicitações para a leitura de respostas do servidor. Quando selecionar um valor para este atributo, considere o seguinte:
- Poderá demorar vários minutos para um servidor processar uma solicitação. Configurando um valor muito baixo para o atributo ServerIOTimeout pode fazer com que o plug-in envie para o cliente uma falsa resposta de erro do servidor.
- Se um valor não estiver configurado, o plug-in usará o valor padrão para gravar solicitações no servidor e para ler respostas do servidor até que a conexão TCP atinja o tempo limite. O valor padrão é 900.
- Nota: Para versões mais antigas do produto, o valor padrão é 0. Se o plug-in usar um valor de tempo limite padrão de 0, poderá ocorrer um erro.
Para obter mais informações sobre como configurar o atributo ServerIOTimeout, consulte a nota técnica de configuração do plug-in de servidor da web.
- com.ibm.ws.odr.plug-incfg.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.plug-incfg.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.plug-incfg.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.plug-incfg.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.
Property
- com.ibm.ws.odr.plug-incfg.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.plug-incfg.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 é 1024K 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.plug-incfg.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.plug-incfg.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/plug-in-key.kdb.
- com.ibm.ws.odr.plug-incfg.property.https.stashfile
- O valor padrão para o arquivo stash é profileRoot/node/etc/plug-in-key.sth
- com.ibm.ws.odr.plug-incfg.property.PluginInstallRoot
- Especifica o caminho de instalação para o plug-in. O valor padrão é "". Configure o valor, no entanto, como o caminho completo da raiz da instalação do plug-in ou a propriedade não será exibida no arquivo plug-in-cfg.xml.
Considerações sobre a Geração do Arquivo plug-in-cfg.xml
- Desative a geração automática. Configure a propriedade customizada da célula ODCPluginCfgDisabled_<genDefID> como true.
- Para gerar um novo plug-in, execute este comando:
em que:<WAS_HOME>/bin/wsadmin.sh -lang jython -f <WAS_HOME>/bin/manageODC.py generateHAPluginCfgs <generationDefinitionIDs> <nodeName> <serverName>
- generationDefinitionIDs
- é uma lista separada por vírgulas de IDs do HAPluginCfgGeneration no formato ODCPluginCfg_<genDef>.
- nodeName
- é o nome do nó que executa a geração.
- serverName
- é o nome do processo que executa a geração. Qualquer processo aumentado do Intelligent Management pode gerar a configuração HAPluginCfgs on demand, exceto para processos XDAGENT. Por exemplo:
<WAS_HOME>/bin/wsadmin.sh -lang jython -f <WAS_HOME>/bin/manageODC.py generateHAPluginCfgs ODCPluginCfg_1,ODCPluginCfg_2 dmgrNodeName dmgr
ODCPluginCfgMinGenerationDelay = 10
As definições de HAPluginCfgGeneration configuradas são geradas novamente no máximo a cada 10 minutos. Se o gerador receber notificação para reconstruir o plug-inCfgs, ele atrasará a geração do plug-inCfgs gravado nos últimos 10 minutos.Para limitar a frequência com que um arquivo plug-in-cfg.xml gerado pelo ODR é gerado novamente, configure a propriedade JVM com.ibm.ws.odr.plug-incfg.minGenerationDelay para um valor que represente o tempo em minutos entre as gerações possíveis e, em seguida, inicie o ODR.
Por padrão, o valor do peso do tempo de execução estático configurado é usado para incluir processos ODR interrompidos em um arquivo plug-in-cfg.xml gerado.
- Para o HAPluginCfgGenerator, configure a propriedade customizada da célula ODCPluginCfgOdrIncludeStoppedStatic para false.
- Para os arquivos plug-in-cfg.xml gerados pelo ODR, configure a propriedade JVM com.ibm.ws.odr.plug-incfg.odrIncludeStoppedStatic como false e, em seguida, inicie o ODR.