Arquivo plugin-cfg.xml

O arquivo plugin-cfg.xml contém informações sobre configuração que determina a forma como o plug-in do servidor da web encaminha solicitações.

WebSphere Application Server tradicional

É possível criar dois tipos de arquivos plugin-cfg.xml: application-centric e topology-centric.

Recurso Reprovado Recurso Reprovado: Topologia central, também chamada de global, a configuração foi descontinuada. Use a configuração centrada em aplicativos ao configurar um novo plug-in de servidor da web e considere redefinir as configurações centradas em topologia existentes para usar a configuração centrada em aplicativos em seu lugar. Para obter informações adicionais, consulte Implementando um Plug-in de Servidor da Web.depfeat

Um arquivo de configuração centrado em aplicativos tem um aplicativo que é mapeado para ambas as definições do servidor da web e do servidor de aplicativos. As mudanças feitas no plug-in usando o console administrativo persistem no arquivo plugin-cfg.xml na geração. A configuração centrada em aplicativos oferece maior flexibilidade e suporte para funções dinâmicas, tais como o Intelligent Management.

Um arquivo centralizado na topologia representa tudo o que é definido no ambiente. Geralmente, esse arquivo plugin-cfg.xml é usado quando você não tem servidores da Web definidos.

Considere as seguintes regras quando desejar atualizar o arquivo plugin-cfg.xml centralizado na topologia:
  • Se o arquivo plugin-cfg.xml existir dentro do diretório app_server_root\dmgr\cells, o processo de geração de plug-in ignorará os valores atualizados do painel Servidor de Aplicativos > Propriedades de Plug-in de Servidor da Web do console administrativo e usará os valores existentes dentro do arquivo XML. Nesse caso, você deverá atualizar manualmente o arquivo XML para que esses valores persistam.
  • Se o arquivo plugin-cfg.xml não existir dentro do diretório app_server_root\dmgr\cells, o processo de geração de plug-in criará o arquivo plugin-cfg.xml. O processo persiste os valores mais recentes que estão configurados no Servidor de Aplicativos > Propriedades de Plug-in do Servidor da Web no console administrativo.
Muitas propriedades de plug-in do servidor da web, tais como RefreshInterval, LogLevel e as propriedades do processador Edge Side Include (ESI), podem ser atualizadas apenas manualmente. Esses valores devem ser mantidos através de cada iteração.
Evitar Problemas Evitar Problemas: Use o console administrativo para configurar essas propriedades para cada definição do servidor da Web. Qualquer mudança manual feita no arquivo de configuração de plug-ins de cada servidor da Web é substituída sempre que o arquivo é novamente gerado.gotcha
Evitar Problemas Evitar Problemas: A configuração de plug-in de topologia central, ou global, foi descontinuada. Use a configuração centrada no aplicativo, conforme a descrição em Implementando um Plug-in de Servidor da Web. Para qualquer configuração de topologia central existente, é possível atualizar o arquivo plugin-cfg.xml global, usando o console administrativo ou executando o comando GenPluginCfg para todos os clusters em uma célula. Entretanto, deve-se excluir o arquivo config/cells/plugin-cfg.xml antes de atualizar o arquivo plugin-cfg.xml global. Se você não excluir o arquivo config/cells/plugin-cfg.xml, somente as novas propriedades e seus valores serão incluídos no arquivo plugin-cfg.xml global. Todas as atualizações nos valores existentes da propriedade do plug-in não serão incluídas no arquivo plugin-cfg.xml global.gotcha
Nota: Como o comando GenPluginCfg é executado dentro de sua própria Java™ Virtual Machine (JVM) em vez de na JVM do WebSphere Application Server, o comando pode não conseguir acessar os outros arquivos de classe. Se você encontrar esse problema ao executar o comando GenPluginCfg, é possível então executar o script httpPluginManagement.py para gerar a configuração de plug-in centralizada em aplicativo. Esse script usa wsadmin para iniciar a geração de plug-in. Para obter informações adicionais, consulte Script httpPluginManagement.py.

Liberty

É possível gerar o arquivo plugin-cfg.xml para seu servidor Liberty ao chamar o MBean WebSphere:name=com.ibm.ws.jmx.mbeans.generatePluginConfig a partir do mesmo SDK Java que o do seu servidor.

Configuração

Esse elemento, que é obrigatório, inicia o arquivo de configuração de plug-ins HTTP.

IgnoreDNSFailures

Especifica se o plug-in ignora falhas de DNS dentro de uma configuração ao iniciar. Quando configurado como true, o plug-in ignora falhas de DNS em uma configuração e inicia com êxito se pelo menos um servidor em cada cluster de servidor puder resolver o nome de host. Qualquer servidor, para o qual o nome do host não pode ser resolvido, é marcado como indisponível para que a configuração continue a existir. Não são feitas tentativas de resolver o nome de host durante o roteamento das solicitações. Se ocorrer uma falha de DNS, será gravada uma mensagem de log no arquivo de log do plug-in e a inicialização do plug-in continuará, em vez de fazer com que o servidor da Web não inicie. O valor padrão é false, o que significa que falhas de DNS farão com que o servidor da Web não inicie.

RefreshInterval

Especifica o intervalo de tempo, em segundos, no qual o plug-in verificará o arquivo de configuração para ser se atualizações ou mudanças ocorreram. O plug-in verifica no arquivo se ocorreram quaisquer modificações desde a última vez que a configuração do plug-in foi carregada.

Em um ambiente de desenvolvimento no qual alterações são frequentes, uma definição mais baixa que a definição padrão de 60 é preferível. Em produção, um valor mais alto do que o padrão é preferível porque as atualizações para a configuração não ocorrerão com tanta freqüência. Se o recarregamento do plug-in falhar por algum motivo, uma mensagem será gravada no arquivo de registro do plug-in e a configuração anterior será utilizada até que o arquivo de configuração do plug-in seja carregado novamente com êxito. Se você não estiver vendo as alterações que fez na configuração de seu plug-in, verifique o arquivo de registro do plug-in para indicações do problema.
Nota: Além disso, no Microsoft, UNIX, e Linux as plataformas, você pode desativar o recarregamento automático definindo RefreshInterval para -1 no plugin-cfg.xml.

ASDisableNagle

Especifica se o usuário deseja desativar o algoritmo de Nagle para a conexão entre o plug-in e o servidor de aplicativos. Por padrão. o algoritmo de Nagle é ativado.

O valor pode ser true ou false.

[Windows]

IISDisableNagle

Especifica se o usuário deseja desativar o algoritmo de Nagle nos Microsoft Internet Information Services (IIS). Por padrão. o algoritmo de Nagle é ativado.

O valor pode ser true ou false.

VHostMatchingCompat

Especifica se o número da porta deverá ser usado para correspondência do host virtual. Especifique um dos seguintes valores:
  • true se a correspondência for feita fisicamente, utilizando o número da porta para a qual o pedido foi recebido.
  • false se a correspondência precisar ser feita logicamente usando o número da porta contido no cabeçalho do host.

O valor padrão é false.

AppServerPortPreference

Especifica qual número de porta o servidor de aplicativos usará para criar URIs para um método sendRedirect(). Os seguintes valores podem ser especificados:
  • hostHeader se o número da porta do cabeçalho do host do pedido HTTP que chega tiver de ser utilizado.
  • webserverPort se o número da porta na qual o servidor da Web recebeu a solicitação for utilizado.

O valor padrão é hostHeader.

ResponseChunkSize

Especifica o tamanho máximo da parte a ser usado ao ler o corpo de resposta. Por exemplo,especifique Config ResponseChunkSize="N">, em que N é igual ao tamanho do chunk em kilobytes.

O plug-in lê o corpo de resposta em partes de 64 K até que todos os dados de resposta sejam lidos. Essa abordagem causa um problema de desempenho para pedidos cujo corpo de resposta contém grandes quantidades de dados.

Se o tamanho do conteúdo do corpo de resposta for desconhecido, um tamanho de buffer de N KBs será alocado e o corpo será lido em partes de N KB de tamanho, até que todo o corpo seja lido. Se o comprimento do conteúdo for conhecido, um tamanho de buffer com o comprimento do conteúdo ou N (o que for menor) será usado para ler o corpo de resposta.

O tamanho da parte padrão é de 64 K.

AcceptAllContent

Especifica se os usuários podem incluir conteúdo nas solicitações POST, PUT, GET e HEAD quando um cabeçalho Content-Length ou Transfer-encoding está contido no cabeçalho da solicitação. É possível especificar um dos valores a seguir para esse atributo:
  • True se o conteúdo for esperado e estiver pronto para todas as solicitações
  • False se o conteúdo for esperado e estiver pronto apenas para as solicitações POST e PUT.

O valor padrão é True.

ChunkedResponse

Especifica se o plug-in deve usar partes da resposta ao cliente quando o cabeçalho da resposta Transfer-Encoding: Chunked estiver presente na resposta.

Esse atributo aplica-se apenas aos servidores da web IIS, Oracle iPlanet e Lotus Domino. O IBM® HTTP Server manipula automaticamente as partes da resposta no cliente.

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

  • true se o plug-in deve truncar a resposta ao cliente quando há uma Codificação de Transferência : Cabeçalho da resposta truncado está presente na resposta.
  • false se a resposta não dever ser truncada.

O valor padrão é false.

ESIEnableToPassCookies

Especifica se permitir o encaminhamento de cookies de sessão para WebSphere Application Server ao processar solicitações de inclusão de ESI. Se o valor for configurado como true, essa propriedade customizada será ativada. Se o valor for configurado como false, a propriedade customizada será desativada. Por padrão, o valor é configurado como false.

GetDWLMTable

Especifica se permitir um processo de plug-in recentemente criado para solicitar proativamente uma tabela de partições de WebSphere Application Server antes da manipulação de qualquer solicitação de HTTP. Essa propriedade customizada é utilizada apenas quando o gerenciamento de sessões memória a memória é configurado. Se o valor for configurado como true, essa propriedade customizada será ativada. Se o valor for configurado como false, a propriedade customizada será desativada. Por padrão, o valor é configurado como false.

[IBM i]

OS400ConvertQueryStringToJobCCSID

Especifica se a sequência de consultas para uma solicitação de HTTP é convertida na Página de Códigos de Tarefa do IBM HTTP Server ou na Página 37 de Códigos EBCDIC para processamento interno. O valor padrão é false, significando que a sequência de consultas deve ser convertida para a Página de Códigos 37 EBCDIC.

TrustedProxyEnable

Permite que o plug-in de servidor da Web interaja com os servidores proxy e balanceadores de carga que estão listados para a propriedade customizada TrustedProxyList. Quando essa propriedade é configurada para true, os servidores proxy e os balanceadores de carga nessa lista de proxies confiáveis poderão configurar valores para os cabeçalhos internos $WSRA e $WSRH. O cabeçalho interno $WSRA é o endereço IP do host remoto, que geralmente é o navegador ou um endereço interno obtido pelo Network Address Translation (N.A.T.). O cabeçalho interno $WSRH é o nome de host do host remoto. Estas informações do cabeçalho permitem que o plug-in de servidor da Web interaja com esse servidor proxy ou balanceador de carga específico.

Ao usar esta propriedade customizada, você também deve usar a propriedade customizada TrustedProxyList para especificar uma lista de servidores proxy e balanceadores de carga confiáveis. Além disso, você deve limpar a caixa de opção Remover Cabeçalhos Especiais no painel Roteamento de Pedido no console administrativo. Para obter informações adicionais, consulte a documentação sobre propriedades de roteamento de pedido do plug-in de servidor da Web.

TrustedProxyList

Especifica uma lista delimitada por vírgula de todos os servidores proxy ou balanceadores de carga que têm permissão para efetuar interface com esse plug-in de servidor da Web. Você deve usar essa propriedade com a configuração de propriedade customizada TrustedProxyEnable=true. Se a propriedade customizada TrustedProxyEnable estiver configurada comofalse, essa lista será ignorada.

SSLConsolidate

Especifica se o plug-in de servidor da Web precisa comparar a configuração de cada novo transporte SSL com a configuração de outros transportes SSL já definidos no arquivo de configuração. Ao configurar esta propriedade para true e o plug-in determinar que os valores do keyring e de CertLabel especificados para o novo transporte SSL corresponderem aos valores especificados para um transporte SSL já definido, o plug-in usará o ambiente SSL existente em vez de criar um novo ambiente SSL. A criação de poucos ambientes SSL significa que o plug-in requer menos memória e o tempo de inicialização do plug-in diminui, otimizando assim o ambiente geral de GSkit.

[AIX Solaris HP-UX Linux Windows]

SSLPKCSDriver

Especifica o nome completo do módulo carregável que faz interface com um coprocessador SSL opcional. O nome completo deve incluir o caminho de diretório e o nome do módulo.

[AIX Solaris HP-UX Linux Windows]

SSLPKCSPassword

Especifica a senha para o coprocessador SSL com o qual o módulo, especificado para a propriedade customizada SSLPKCSDriver, está estabelecendo interface.

Se você estiver usando um IBM HTTP Server, poderá usar o programa sslstash para criar um arquivo que contenha essa senha. Nessa situação, você pode especificar o nome completo desse arquivo, em vez da senha real, como o valor para essa propriedade customizada.

Log

Descreve o local e o nível de mensagens de log gravadas pelo plug-in. Se um elemento de log não for especificado no arquivo de configuração, em alguns casos, mensagens de log serão gravadas para o log de erros do servidor da Web.

Por exemplo, você pode especificar a seguinte linha de código:

[AIX Solaris HP-UX Linux Windows][IBM i]
<Log LogLevel="Error" Name="/opt/WebSphere/AppServer60/logs/http_plugin.log"/>
[z/OS]
<Log LogLevel="Error" Name="/log_directory/file_name"/>
  • Nome

    Especifica o caminho completo para o arquivo de log no qual o plug-in grava mensagens de erro. Especifique exatamente um atributo para cada log.

    [AIX Solaris HP-UX Linux Windows][IBM i]Se o arquivo não existir, um será criado. Se ele existir, será aberto no modo Anexar e as mensagens de log de plug-in anteriores permanecerão.

    Para Usuários de Transição Para Usuários de Transição: Um registro de data e hora e o ID do processo não são mais anexados ao nome que é especificado para o arquivo de log do plug-in a partir da Versão 7. Portanto, um único arquivo de log de plug-in do servidor da web é criado ao invés de diversos arquivos de log que são diferenciados por data.trns
  • LogLevel

    Especifica o nível de detalhes das mensagens de log que o plug-in grava no log. Especifique zero ou um dos seguintes valores para cada log.

    Valor do Nível de Log Descrição do Nível de Log
    Rastreio Todas as etapas do processo de pedido são registradas em detalhes.
    Estatísticas O servidor selecionado para cada pedido e outras informações de equilíbrio de carga relacionadas ao tratamento do pedido são registrados.
    Aviso Todas as mensagens de aviso e erro que resultam do processamento de solicitações anormais que são registradas
    Erro Apenas mensagens de erro que resultam do processamento de solicitações anormais são registradas
    Depuração Todas as etapas críticas executadas no processamento de pedidos são registradas.
    Detalhe Todas as informações sobre pedidos e respostas são registradas.

    Se um valor LogLevel não for especificado para o elemento Log, o valor padrão, Erro, será usado.

    [AIX Solaris HP-UX Linux Windows][IBM i]
    Evitar Problemas Evitar Problemas: Tenha cuidado ao definir o nível como Rastreio. Várias mensagens são registradas nesse nível, o que pode consumir rapidamente espaço em disco. Não use uma configuração Rastreio em um ambiente que funciona normalmente, pois isso afeta adversamente o desempenho.gotcha
    [z/OS]
    Evitar Problemas Evitar Problemas: Tenha cuidado ao definir o nível como Rastreio. Várias mensagens são registradas nesse nível, o que pode consumir rapidamente o sistema de arquivos. Não use uma configuração Rastreio em um ambiente que funciona normalmente, pois isso afeta adversamente o desempenho.gotcha

Property Name="esiEnable" Value="true/false"

Ativa ou desativa o processador Edge Side Include (ESI). Se o processador ESI estiver desativado, os outros elementos do ESI nesse arquivo são ignorados.

É possível configurar Value como true ou false. Por padrão, o processador ESI é desativado com seu valor configurado como false.

Property Name="esiMaxCacheSize" Value="integer"

Especifica, em unidades de 1 KB, o tamanho máximo do cache. O tamanho máximo padrão do cache é 1024 KB (1 MB). Se o cache estiver cheio, a primeira entrada excluída do cache será a entrada mais próxima de seu prazo de expiração.

Property Name="ESIInvalidationMonitor" Value="true/false"

Especifica se o processador ESI recebe invalidações do servidor de aplicativos.

É possível configurar Value como true ou false. Por padrão, essa propriedade é definida como false.

Property Name="FIPSEnable" Value="true/false"

Especifica se Federal Information Processing Standard (FIPS) está ativado para fazer conexões Secure Sockets Layer (SSL) com o servidor de aplicativos. Configure essa propriedade como true, se o FIPS estiver ativado no servidor de aplicativos.

É possível configurar o valor Value como true ou false. Por padrão, essa propriedade é definida como false.

Property Name="PluginInstallRoot" Value="C:\IBM\WebSphere\Plugins"

Especifica o caminho da instalação para o plug-in. Essa propriedade será obrigatória se o Global Security Kit (GSKit) estiver sendo usado, pois WebSphere Application Server suporta a instalação local do GSKit em vez de uma instalação global. O valor de atributo é configurado como um caminho completo para a raiz de instalação do plug-in.

Os nomes suportados reconhecidos pelo transporte são keyring, stashfile e password. Por padrão, esta propriedade é configurada como none.

ServerCluster

Especifica um grupo de servidores que são geralmente configurados para atender aos mesmos tipos de solicitações. Especifique um ou mais clusters para cada configuração.

No caso mais simples, o cluster contém apenas uma definição de servidor. No caso no qual mais de um servidor está definido, a carga do plug-in é equilibrada nos servidores definidos usando um algoritmo Round Robin ou aleatório. O algoritmo padrão é Round Robin.

O seguinte código é um exemplo de um elemento ServerCluster.

[AIX Solaris HP-UX Linux Windows][IBM i]
<ServerCluster Name="Servers">
<ClusterAddress Name="ClusterAddr">
<Transport Hostname="192.168.1.2" Port="9080" Protocol="HTTP"/>
<Transport Hostname="192.168.1.2" Port="9443" Protocol="HTTPS">
<Property Name="Keyring" value="c:/WebSphere/AppServer/keys/keyring.kdb"/>
<Property Name="Stashfile" value="c:/WebSphere/AppServer/keys/keyring.sth"/>
</Transport>
</ClusterAddress>
<Server Name="Server1">
<Transport Hostname="192.168.1.3" Port="9080" Protocol="HTTP"/>
<Transport Hostname="192.168.1.3" Port="9443" Protocol="HTTPS">
<Property Name="Keyring" value="c:/WebSphere/AppServer/keys/keyring.kdb"/>
<Property Name="Stashfile" value="c:/WebSphere/AppServer/keys/keyring.sth"/>
</Transport>
</Server>
<Server Name=Server2>
<Transport Hostname="192.168.1.4" Port="9080" Protocol="HTTP"/>
<Transport Hostname="192.168.1.4" Port="9443" Protocol="HTTPS">
<Property Name="Keyring" value="c:/WebSphere/AppServer/keys/keyring.kdb"/>
<Property Name="Stashfile" value="c:/WebSphere/AppServer/keys/keyring.sth"/>
</Transport>
</Server>
<Server Name="Server3">
<Transport Hostname="192.168.1.5" Port="9080" Protocol="HTTP"/>
<Transport Hostname="192.168.1.5" Port="9443" Protocol="HTTPS">
<Property Name="Keyring" value="c:/WebSphere/AppServer/keys/keyring.kdb"/>
<Property Name="Stashfile" value="c:/WebSphere/AppServer/keys/keyring.sth"/>
</Transport>
</Server>
<PrimaryServers>
<Server Name="Server1"/>
<Server Name="Server2"/>
</PrimaryServers>
<BackupServers>
<Server Name="Server3"/>
</BackupServers>
</ServerCluster>
[z/OS]
<ServerCluster CloneSeparatorChange="false"
        LoadBalance="Round Robin" Name="Cluster1"
        PostSizeLimit="10000000" RemoveSpecialHeaders="true" 
        RetryInterval="60">
<Server
CloneID="BA36BEC1EB243D8B000000E4000000030926301B"
            ConnectTimeout="0" ExtendedHandshake="false"
            LoadBalanceWeight="2" MaxConnections="0"
            Name="SY1_ClusterMember1" WaitForContinue="false">
<Transport Hostname="BOSSXXXX.PLEX1.L2.IBM.COM" Port="9084" Protocol="http"/>
<Transport Hostname="BOSSXXXX.PLEX1.L2.IBM.COM" Port="0" Protocol="https">
<Property Name="Keyring" value="safkeyring:///mzjring1/"/>
<Property Name="Stashfile" value=""""/>
<Property Name="certLabel" Value="selfsigned"/>
</Transport>
</Server>
<Server CloneID="BA36BED017FDF40E000000E4000000030926301B"
            ConnectTimeout="0" ExtendedHandshake="false"
            LoadBalanceWeight="2" MaxConnections="0"
            Name="SY1_ClusterMember2" WaitForContinue="false">
<Transport Hostname="BOSSXXXX.PLEX1.L2.IBM.COM" Port="9085" Protocol="http"/>
<Transport Hostname="BOSSXXXX.PLEX1.L2.IBM.COM" Port="0" Protocol="https">
<Property Name="Keyring" value="safkeyring:///mzjring1/">
<Property Name="Stashfile" value=""""/>
<Property Name="certLabel" Value="selfsigned"/>
</Transport>
</Server>
<PrimaryServers>
<Server Name="SY1_ClusterMember1"/>
<Server Name="SY1_ClusterMember2"/>
</PrimaryServers>
</ServerCluster>
Para Usuários de Transição Para Usuários de Transição: O plug-in de servidor da web para o IBM HTTP Server para z/OS, Versão 5.3, usa uma interface SSL diferente da interface SSL usada nas versões desse plug-in anterior à versão 7. As conexões SSL entre o plug-in para o IBM HTTP Server para z/OS, Versão 5.3 e um servidor de aplicativos funciona agora da mesma maneira que as conexões SSL entre um IBM HTTP Server desenvolvido pelo Apache e um servidor de aplicativos. Os valores especificados para os elementos de conjunto de chaves e arquivo stash no arquivo plugin-cfg.xml não são mais ignorados e não são afetados pelo ambiente SSL configurado no IBM HTTP Server para z/OS, Versão 5.3.trns

O pacote z/OS PTF UK35083 inclui a mudança da interface SSL para o z/OS HTTP Server, Versão 5.3, que corresponde a essa mudança de plug-in de servidor da web. Portanto, você deve aplicar esse PTF ao seu sistema antes que a interface SSL do novo plug-in do servidor da Web possa funcionar corretamente.

Você também deve incluir a opção SSLMODE=MULTI no arquivo httpd.conf para o IBM HTTP Server para z/OS, Versão 5.3. A opção SSLMODE=ON não é suportada na Versão 7.0 ou superior.

Se a opção SSLMode multi não for especificada no arquivo httpd.conf ou se você não possuir o pacote z/OS PTF UK35083 aplicado ao sistema, poderá receber a mensagem de erro IMW0584W. Essa mensagem indica que o modo SSL, que é especificado para o Servidor HTTP, não é compatível com o modo SSL para o plug-in de servidor da web usado com o IBM HTTP Server para z/OS, Versão 5.3. Em qualquer uma dessas situações, resultados imprevisíveis poderão ocorrer.

Para os plug-ins do servidor da web do IBM HTTP Server para z/OS, Versão 5.3 e do IBM HTTP Server on z/OS desenvolvido pelo Apache:
  • Se você usar um arquivo kdb com um arquivo stash no Sistema de Arquivo Hierárquico (HFS), especifique os elementos Property Name=keyring e Property Name=stashfile, como mostrado no exemplo anterior.
    Evitar Problemas Evitar Problemas: O formato dos valores especificados para esses elementos é diferente do que foi especificado em versões anteriores do produto.gotcha
  • Se você usar um conjunto de chaves System Authorization Facility (SAF), em vez de um arquivo kdb, deverá criar as seguintes duas propriedades de plug-in customizadas a partir do console administrativo:
    KeyringLocation
    Especifique o local do diretório do conjunto de chaves SAF como o valor para esta propriedade. Ao salvar esta mudança na configuração, esse local de diretório se torna o valor da propriedade do conjunto de chaves no arquivo plugin-cfg.xml.
    StashfileLocation
    Especifique """"(null) como o valor para esta propriedade. Ao salvar esta mudança na configuração, """"(null) se torna o valor da propriedade stashfile no arquivo plugin-cfg.xml

    Consulte Propriedades de Configuração do Plug-in do Servidor da Web para obter instruções sobre como criar KeyringLocation e StashfileLocation a partir do console administrativo.

    Use o seguinte exemplo para o conjunto de chaves SAF:
    <Transport Hostname="appserver.example.com" Port="9443" Protocol="https">
    <Property name="keyring" value="safkeyring:///SAF_keyring_name"/>
    <Property Name="stashfile" value=""""/>
    </Transport>
  • Nome

    Especifica o nome lógico ou administrativo que será usado para este grupo de servidores. Especifique um atributo para cada ServerCluster.

  • LoadBalance

    Os seguintes valores podem ser especificados para este atributo:

    Round Robin

    Aleatório

    A implementação de Round Robin possui um ponto inicial aleatório. O primeiro servidor de aplicativos será selecionado aleatoriamente. Round Robin será utilizado para selecionar servidores de aplicativos daí em diante. Essa implementação garante que em diversos servidores da web baseados no processo, todos os processos não são iniciados enviando a primeira solicitação ao mesmo Servidor de Aplicativos.

    A implementação Random também possui um ponto inicial aleatório. No entanto, com essa implementação, todos os servidores subsequentes também são selecionados aleatoriamente. Portanto, o mesmo servidor pode ser selecionado repetidamente, enquanto outros servidores permanecem inativos.

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

  • IgnoreAffinityRequests

    Especifica se o plug-in ignora o número de pedidos de afinidade feitos para um servidor ao selecionar os servidores com base no algoritmo Round Robin. Especifique zero ou um atributo para cada ServerCluster. O valor é true ou false. Se o valor for configurado para false, o número de pedidos de afinidade feitos também será considerado no processo de seleção do servidor.

    O valor padrão é false, o que significa que o número de solicitações de afinidade feitas é usado no algoritmo Round Robin.

    Para Usuários de Transição Para Usuários de Transição: Para os usuários em transição: Esta é uma mudança em relação às versões anteriores do produto. O valor padrão é true nas versões anteriores do WebSphere Application Server.trns
  • RetryInterval

    Especifica um valor de número inteiro para a duração de tempo decorrida a partir da hora em que um servidor é marcado como inativo até a hora em que o plug-in tenta uma conexão novamente. O padrão é 60 segundos. Especifique zero ou um atributo para cada ServerCluster.

  • RemoveSpecialHeaders

    O plug-in inclui cabeçalhos especiais no pedido antes que ele seja redirecionado para o servidor de aplicativos. Esses cabeçalhos armazenam informações sobre a solicitação usada pelo aplicativo. Por padrão, o plug-in remove esses cabeçalhos das solicitações recebidas antes de incluir os cabeçalhos que o plug-in deve incluir. Especifique zero ou um atributo para cada ServerCluster.

    O valor pode ser true ou false. Definir o atributo como false introduz um risco de segurança potencial por não remover cabeçalhos de pedidos de entrada.

  • CloneSeparatorChange

    Informa ao plug-in para esperar o caractere mais (+) como o separador de clone. 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. É preciso alterar as configurações dos servidores de aplicativos de modo que um servidor de aplicativos também separe IDs de clone com o caractere de mais. Especifique zero ou um atributo para cada ServerCluster.

    O valor pode ser true ou false.

  • PostSizeLimit

    O número máximo de blocos de KBs (1024 byte) do conteúdo da solicitação permitido para que o plug-in tente enviar a solicitação para um servidor de aplicativos. Se for recebido um pedido maior que esse tamanho, o plug-in falhará o pedido. O valor padrão é -1 byte, o que indica que não há limite para o tamanho da postagem. Especifique zero ou um atributo para cada ServerCluster.

  • PostBufferSize

    Especifica, em KBs, o tamanho máximo do buffer usado quando o conteúdo de uma solicitação de HTTP é lido. Se o servidor de aplicativos que recebe inicialmente uma solicitação não puder processar essa solicitação, os dados contidos nesse buffer serão enviados para outro servidor de aplicativos. Ele tentará então fazer com que o servidor de aplicativos processe a solicitação. É possível configurar essa opção como zero, se não desejar que as solicitações que possuem conteúdo sejam armazenadas em buffer e, em seguida, tentadas novamente.

    Esta opção aprimora a disponibilidade do plug-in. Quando essa opção estiver configurada como um valor diferente de zero, os pacotes pendentes que contêm uma carga útil serão reenviados, se o servidor de aplicativos selecionado não responder.

    Tipicamente, as solicitações POST e PUT transportam uma carga útil, mas outras solicitações também poderão transportar uma carga útil. Mesmo que uma solicitação POST ou PUT não tenha uma carga útil, ela será tentada, se o valor especificado para essa opção não for zero.

    O valor padrão é 0. Especifique zero ou um atributo para cada ServerCluster.

  • ServerIOTimeoutRetry

    Especifica um limite para o número de vezes que o plug-in de HTTP tentar novamente uma solicitação de HTTP que tenha atingido o tempo limite, devido ao ServerIOTimeout. O valor padrão, -1, indica que nenhum limite adicional se aplica ao número de novas tentativas. Um valor 0 indica que não há novas tentativas. As novas tentativas não sempre limitadas pelo número de servidores disponíveis no cluster.

    Importante: Esta diretiva não se aplica às falhas de conexão ou aos tempos limites, devido ao plug-in de HTTP ConnectTimeout.
  • Servidor
    Especifica uma instância do WebSphere Application Server que está configurada para manipular solicitações roteadas para ela, com base nas regras de configuração de plug-in. O servidor corresponde a um servidor de aplicativos em execução na máquina local ou em uma máquina remota. Especifique zero ou um atributo para cada ServerCluster.
    • Nome

      Especifica o nome administrativo ou lógico do servidor. Especifique exatamente um atributo para cada Server.

    • CloneID

      Se esse ID exclusivo estiver presente no cabeçalho de cookie de HTTP de uma solicitação, ou se a URL estiver usando a regravação de URL, o plug-in roteará a solicitação para este servidor específico, desde que todas as outras regras de roteamento sejam atendidas. Se um CloneID não estiver especificado no servidor, a afinidade de sessão não será ativada para esse servidor. Pode haver zero ou um atributo para cada Server.

      Esse atributo é usado com a afinidade de sessão. Quando este atributo é definido, o plug-in verifica o cabeçalho do cookie ou URL de entrada quanto a JSESSIONID. Se JSESSIONID for localizado, o plug-in procurará por um ou mais IDs de clone. Se forem localizados IDs de clone e for feita uma correspondência ao valor especificado para esse atributo então, o pedido será enviado a esse servidor em vez de ser utilizado o equilíbrio de carga pelo cluster.

      Boas Práticas Boas Práticas: Se você não estiver usando a afinidade de sessão, remova esses IDs de clone da configuração, pois existe processamento de solicitação incluído no plug-in quando esses valores são configurados. Se os IDs de clone não estiverem no plug-in, assume-se que a afinidade de sessão não esteja ativada, e a solicitação terá balanceamento de carga no cluster.bprac
    • WaitForContinue

      Especifica se usar o suporte HTTP 1.1 100 Continue antes de enviar o conteúdo da solicitação para o servidor de aplicativos. Os valores de atributos possíveis são true ou false. O valor padrão é false; o plug-in não aguarda pela resposta 100 Continue do servidor de aplicativos antes de enviar o conteúdo da solicitação, pois ela é uma ocorrência de desempenho. Especifique zero ou um atributo para cada Server.

      Essa propriedade será ignorada para solicitações POST, para evitar uma falha de ocorrência se o servidor de aplicativos fechar uma conexão devido a um tempo limite keep-alive.

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

    • LoadBalanceWeight

      Especifica o peso associado a este servidor quando o plug-in executa um balanceamento de carga Round Robin com peso. Especifique zero ou um atributo para cada Server. O valor inicial de um servidor pode ser qualquer inteiro entre 0 e 20. No entanto, especifique zero apenas para um servidor que não esteja executando.

      O valor LoadBalanceWeight para cada servidor é diminuído para cada solicitação processada por esse servidor. Depois que o peso de um determinado servidor em um cluster de servidores chega a zero, apenas os pedidos com afinidade de sessão são roteados para esse servidor. Quando todos os servidores no cluster atingirem um peso zero, os pesos de todos os servidores no cluster serão reconfigurados e o algoritmo reiniciará.

      Boas Práticas Boas Práticas: Quando um servidor não estiver executando, configure o peso desse servidor para zero. O plug-in poderá, então, redefinir os pesos dos servidores que ainda estão em execução e manter o equilíbrio de carga adequado.bprac
    • ConnectTimeout

      Ativa o plug-in para executar conexões não bloqueadoras com o servidor de aplicativos. As conexões não bloqueadoras são benéficas quando o plug-in é incapaz de entrar em contato com o destino para determinar se a porta está ou não disponível. Especifique zero ou um atributo para cada Server.

      Se um valor ConnectTimeout não for especificado ou configurado como 0, o plug-in executará uma conexão de bloqueio na qual o plug-in permanece até que um sistema operacional atinja o tempo limite (mais de 2 minutos, dependendo da plataforma) e permitirá que o plug-in marque o servidor como indisponível. Um valor 0 faz com que o plug-in execute uma conexão de bloqueio. Um valor maior do que 0 especifica o número de segundos que o plug-in deve aguardar por uma conexão bem-sucedida. Se uma conexão não ocorrer após esse intervalo de tempo, o plug-in marcará o servidor como indisponível e executará failover em um dos outros servidores definidos no cluster.

      O valor padrão é 5.

    • ExtendedHandshake

      É usado quando um firewall proxy está entre o plug-in e o servidor de aplicativos. Nesses casos, o plug-in não está efetuando failover, conforme esperado. Especifique zero ou um atributo para cada Server.

      O plug-in marca um servidor como inativo quando o método connect() falha. No entanto, quando um firewall proxy está entre o plug-in e o servidor de aplicativos, o método connect() será bem-sucedido, apesar de o servidor de aplicativos de backend estar inativo. Isso faz com que o plug-in não efetue failover corretamente para outros servidores de aplicativos.

      O plug-in executa algum protocolo de reconhecimento com o servidor de aplicativos para assegurar que ele tenha iniciado antes de enviar o pedido. Esse cenário ativa o plug-in para failover no caso de inatividade do servidor de aplicativos.

      O valor pode ser true ou false.

    • MaxConnections

      Especifica o número máximo de conexões pendentes para um servidor de aplicativos que podem fluir por um processo do servidor da Web a qualquer momento. Especifique um elemento para cada Server.

      Por exemplo, no seguinte cenário:
      • O servidor de aplicativos está entre cinco nós que estão executando um IBM HTTP Server.
      • Cada nó inicia dois processos.
      • O atributo MaxConnections está definido para 50.

      Nesse exemplo, o servidor de aplicativos poderia obter até 500 conexões. Multiplique o número de nós, 5, pelo número de processos, 2, e depois multiplique esse número pelo número especificado para o atributo MaxConnections, 50, para um total de 500 conexões.

      [z/OS]Esse atributo não é necessário no sistema operacional z/OS. O controlador do z/OS que funciona com o Workload Manager (WLM), manipula novas conexões dinamicamente.

      Por padrão, MaxConnections está definido para -1. Se esse atributo estiver configurado para zero ou -1, não haverá limite para o número de conexões pendentes para servidores de aplicativos.

    • Transport

      Especifica o transporte para solicitações de leitura e gravação para uma determinada instância do WebSphere Application Server. O transporte fornece as informações necessárias para determinar o local do servidor de aplicativos para o qual a solicitação é enviada. O plug-in não pode reconhecer quando vários transportes estão definidos para usar o mesmo protocolo. O transporte que o plug-in seleciona não pode ser predito. O plug-in sempre seleciona o primeiro transporte que ele encontra em seu processamento. Especifique um ou mais elementos para cada Server.

      É possível configurar o servidor para ter um transporte não seguro e um que use SSL. Nessa configuração, uma correspondência do protocolo de solicitação recebida é executada para determinar o transporte adequado para usar ao enviar a solicitação para o servidor de aplicativos.

      • Nome do Host

        Especifica o nome de host ou endereço IP da máquina na qual a instância do WebSphere Application Server está executando. Existe exatamente um atributo para cada Transport.

      • Porta

        Especifica a porta na qual a instância do WebSphere Application Server está atendendo. Existe exatamente um atributo para cada Transport.

      • Protocolo

        Especifica o protocolo para usar ao se comunicar usando este transporte -- HTTP ou HTTPS. Existe exatamente um atributo para cada Transport.

    • Property
      Especifique zero, um ou mais elementos para cada Transport. Quando o protocolo do transporte é configurado para HTTPS, use esse elemento para fornecer os diversos parâmetros de inicialização, como senha, conjunto de chaves e arquivo stash. Por exemplo, a parte do arquivo plugin-cfg.xml que contém esses elementos pode se assemelhar ao seguinte código:
      <Transport Hostname="192.168.1.2" Port="9443" Protocol="HTTPS">
      <Property Name="keyring" value="c:/WebSphere/AppServer/keys/keyring.kdb"/>
      <Property Name="stashfile" value="c:/WebSphere/AppServer/keys/keyring.sth"/>
      <Property Name="password" value="WebAS"/>
      • Nome

        Especifica o nome da propriedade que está sendo definida. Os nomes suportados reconhecidos pelo transporte são keyring, stashfile e password.

        Evitar Problemas Evitar Problemas: O único nome que pode ser especificado para o plug-in de HTTP do WebSphere para z/OS é senha. Se você especificar keyring e stashfile, eles serão ignorados.gotcha
        Especifique exatamente um atributo para cada Property.
      • Valor

        Especifica o valor da propriedade que está sendo definida. Especifique exatamente um atributo para cada Property.

    • ServerIOTimeout

      Permite que o plug-in configure um valor de tempo limite, em segundos, para enviar solicitações e ler respostas do servidor de aplicativos.

      Se você configurar o atributo ServerIOTimeout como um valor positivo, esta tentativa de contactar o servidor será encerrada quando ocorrer o tempo limite. No entanto, o servidor não é considerado indisponível e futuras solicitações ainda serão enviadas para o servidor no qual ocorreu o tempo limite indisponível.

      Se você configurar o atributo ServerIOTimeout para um valor negativo, o servidor será considerado indisponível sempre que ocorrer um tempo limite e nenhuma solicitação futura será enviada para o servidor no qual ocorreu o tempo limite.

      Se um valor não estiver configurado para o atributo ServerIOTimeout, o plug-in, por padrão, usará a E/S bloqueada para gravar as solicitações no, e ler as respostas a partir do, servidor de aplicativos sem atingir o tempo limite da conexão TCP. Por exemplo, é possível especificar a seguinte configuração:

      <Server Name="server1" ServerIOTimeout=300>

      Neste caso, se um servidor de aplicativos parar de responder a pedidos, o plug-in esperará 300 segundos (5 minutos) antes de expirar a conexão TCP. Configurar o atributo ServerIOTimeout para um valor razoável permitirá que o plug-in atinja o tempo limite de conexão mais brevemente e transfira solicitações para outro servidor de aplicativos quando possível.

      Ao selecionar um valor para esse atributo, lembre-se de que, às vezes, isso pode levar alguns minutos até que um servidor de aplicativos processe uma solicitação. A configuração do valor muito baixo do atributo ServerIOTimeout pode fazer com que o plug-in envie uma resposta de erro de servidor falsa ao cliente.

      O valor padrão é 900, que é equivalente a 15 minutos.

      Evitar Problemas Evitar Problemas: O ServerIOTimeout limita a quantia de tempo que o plug-in aguarda até que cada operação de leitura ou gravação seja retornada. O ServerIOTimeout não representa um tempo limite para a solicitação geral.gotcha

      Para obter recomendações adicionais sobre como configurar o atributo ServerIOTimeout, consulte a nota técnica de configuração do plug-in do servidor da web no webite de Suporte da IBM.

    Nem todas as solicitações e respostas de leitura no servidor de aplicativos exigem as mesmas regras para atingir o tempo limite do ServerIOTimeout, ServerIOTimeoutRetry, e Extended Handshake / 100 Continue. Nem toda a URL se comporta da mesma forma e, quando processada, pode haver a necessidade de atingir mais rápido o tempo limite de uma solicitação, ou não repetir uma solicitação para cada servidor. É possível designar URLs específicas que usarão um ServerIOTimeout modificado, ServerIOTimeoutRetry ou tempo limite abreviado para ExtendedHandshake ou 100-Continues. Outras URLs (não tão modificadas) continuam a usar os valores especificados dentro do arquivo Plugin-cfg.xml.

    Para designar uma URL para o processamento deste tempo limite modificado, modifique o arquivo httpd.conf usando as diretivas SetEnvIf. Como as propriedades disponíveis no arquivo Plugin-cfg.xml, o websphere-serveriotimeout e o websphere-serveriotimeoutretry podem aceitar os mesmos valores. É possível configurar o WebSphere-shorten-handshake apenas para um "1". Isto informará o plug-in para usar o valor ConnectTimeout como o tempo de espera para respostas ExtendedHandshake ou 100-Continue. Por exemplo,
    SetEnvIf Request_URI "\.jsp$" websphere-serveriotimeout=10
    SetEnvIf Request_URI "\.jsp$" websphere-serveriotimeoutretry=-1
    SetEnvIf Request_URI "\.jsp$" websphere-shorten-handshake=1
  • wsServerIOTimeout

    Esse atributo configura um valor de tempo limite, em segundos, para ações pendentes de leitura e gravação entre o plug-in de servidor da web e um aplicativo WebSocket. Quando o valor especificado é excedido, os recursos mantidos por um servidor de aplicativos não respondente são liberados.

    O valor padrão é 30 segundos.

  • wsServerIdleTimeout

    Esse atributo configura um valor de tempo limite, em segundos, em que uma conexão entre o plug-in de servidor da web e um aplicativo WebSocket pode permanecer inativa. Quando o valor especificado é excedido, recursos mantidos pelo servidor de aplicativos são liberados.

    O valor padrão é 900 segundos.

  • ClusterAddress

    Um ClusterAddress é como um elemento de servidor no qual é possível especificar os mesmos atributos e elementos de um elemento do servidor. A diferença é que você pode definir apenas um deles em um ServerCluster. Utilize um ClusterAddress quando não quiser que o plug-in execute nenhum tipo de equilíbrio de carga porque já existe algum tipo de equilibrador de carga entre o plug-in e o servidor de aplicativos.

    Evitar Problemas Evitar Problemas: Se você incluir uma tag ClusterAddress, deverá incluir o atributo Name nessa tag. O plug-in usa o atributo Name para associar o endereço do cluster com o host e porta corretos. Se você não especificar o atributo Name, o plug-in designará ao endereço de cluster o nome especificado para o servidor que está usando o mesmo host e porta.
    <ClusterAddress Name="MyClusterAddr">
    <Transport Hostname="192.168.1.2" Port="9080" Protocol="HTTP"/>
    <Transport Hostname="192.168.1.2" Port="9443" Protocol="HTTPS">
    </ClusterAddress>
    gotcha

    Se for recebido um pedido que não tenha a afinidade estabelecida, o plug-in o roteará para o endereço do cluster, quando definido. Se a afinidade tiver sido estabelecida, o plug-in roteará o pedido diretamente para o clone, ignorando completamente o endereço do cluster. Se nenhum endereço de cluster estiver definido para o cluster do servidor, a carga do plug-in é balanceada pelos servidores na lista de servidores primários.

    Poder haver zero ou um elemento para cada ServerCluster.

  • PrimaryServers

    Especifica uma lista de servidores à qual o plug-in roteia os pedidos para esse cluster. Se não for especificada uma lista de servidores primários, o plug-in roteia os pedidos para os servidores definidos para o cluster de servidores. Especifique zero ou um atributo para cada ServerCluster.

  • BackupServers

    Especifica uma lista de servidores para os quais solicitações são enviadas se todos os servidores especificados na lista de servidores primários estiverem indisponíveis. O plug-in não faz balanceamento de carga nos servidores de backup, mas atravessam a lista em ordem até que nenhum servidor permaneça na lista ou até que uma solicitação seja enviada com êxito e uma resposta seja recebida de um servidor de aplicativos. Especifique zero ou um atributo para cada ServerCluster.

VirtualHostGroup

Especifica um grupo de nomes de hosts virtuais especificados no cabeçalho de host de HTTP. Use essa propriedade para agrupar definições de hosts virtuais configuradas para manipular tipos de solicitações semelhantes.

O seguinte exemplo mostra um elemento VirtualHostGroup e os elementos e atributos associados:

<VirtualHostGroup Name="Hosts">
<VirtualHost Name="www.x.com"/>
<VirtualHost Name="www.x.com:443"/>
<VirtualHost Name="*:8080"/>
<VirtualHost Name="www.x.com:*"/>
<VirtualHost Name="*:*"/>
</VirtualHostGroup>

UriGroup

Especifica um grupo de URIs que são especificados na linha de solicitação de HTTP. O mesmo servidor de aplicativos deve ser capaz de tratar dos URIs. A rota compara o URI recebido com os URIs no grupo para determinar se o servidor de aplicativos manipulada a solicitação.

O seguinte exemplo mostra um elemento UriGroup e os elementos e atributos associados:

<UriGroup Name="Uris">
<Uri Name="/servlet/snoop/">
<Uri Name="/webapp/*/">
<Uri Name="*.jsp/">
</UriGroup>
  • Nome

    Especifica o nome lógico ou administrativo para este grupo de URIs. Especifique exatamente um atributo para cada UriGroup.

  • Uri

    Especifica o caminho virtual para o recurso que é atendido pelo WebSphere Application Server. Cada URI especifica as URLs recebidas que o servidor de aplicativos precisa para manipular. Pode-se utilizar um caractere curinga nessas definições. Pode haver um ou mais atributos para cada UriGroup.

    • Nome

      Especifica a sequência real para especificar na linha de solicitação de HTTP para corresponder com êxito a esse URI. Pode-se utilizar um caractere curinga na definição do URI. É possível especificar regras como *.jsp ou /servlet/* para que sejam manipuladas por WebSphere Application Server. Ao montar seu aplicativo, se você especificar Entrega de Arquivos Ativada, então, apenas um URI curinga será gerado para o aplicativo da web, independente de quaisquer mapeamentos de servlet explícitos. Se você especificar Servir Servlets pelo Nome de Classe, a seguinte URI será gerada: <Uri Name="Web_application_URI/servlet/*">

      Existe exatamente um atributo para cada URI.

    • AffinityCookie

      Especifica o nome do cookie que o plug-in usa ao tentar determinar se a solicitação recebida tem afinidade de sessão. O valor padrão é JSESSIONID.

      Consulte a descrição do atributo CloneID para obter informações adicionais sobre a afinidade da sessão.

      Pode haver zero ou um atributo para cada URI.

    • AffinityURLIdentifier

      Especifica o nome do identificador que o plug-in usa ao tentar determinar se a solicitação recebida tem afinidade especificada no URL para um determinado clone. O valor padrão é jsessionid.

      Consulte a descrição do atributo CloneID para obter informações adicionais sobre a afinidade da sessão.

      Pode haver zero ou um atributo para cada URI.

Route

Especifica uma regra de roteamento de solicitação pela qual o plug-in determinará se uma solicitação recebida deve ser manipulada pelo WebSphere Application Server.

Uma definição de rota é o elemento central da configuração do plug-in. Especifica como o plug-in manipula solicitações, com base em determinadas características da solicitação. A definição de rota contém os outros elementos principais: um ServerCluster obrigatório e um VirtualHostGroup, UriGroup ou ambos.

Usando as informações definidas em VirtualHostGroup e UriGroup para roteamento, o plug-in determina se a solicitação recebida para o servidor da Web é enviada para o elemento ServerCluster definido nesse roteamento.

Veja o seguinte exemplo deste elemento:

<Route VirtualHostGroup="Hosts" UriGroup="Uris" ServerCluster="servers"/>
  • VirtualHostGroup

    Especifica o grupo de hosts virtuais usados na determinação de rota. O cabeçalho do host recebido e a porta do servidor são correspondidos para determinar se essa solicitação é manipulada pelo servidor de aplicativos.

    É possível omitir essa propriedade a partir da definição de rota. Se ela não estiver presente, cada solicitação corresponderá durante a parte de correspondência do host virtual de determinação de rota.

    Poderá haver zero ou um atributo para cada Rota.

  • UriGroup

    Especifica o grupo de URIs para usar para determinar a rota. Selecione zero ou um grupo para cada Route. O URI recebido para a solicitação é correspondido com os URIs definidos nesse grupo para determinar se essa solicitação é manipulada pelo servidor de aplicativos.

    É possível omitir essa propriedade a partir da definição de rota. Se ela não estiver presente, cada solicitação corresponderá durante a parte de correspondência do URI de determinação de rota.

  • ServerCluster

    Especifica o cluster que recebe as solicitações que corresponderam com êxito à rota. Selecione exatamente um cluster para cada Route.

    O cluster é usado para manipular essa solicitação. Se a correspondência do URI e do host virtual for bem-sucedida para essa rota, a solicitação será enviada para um dos servidores definidos nesse cluster.

RequestMetrics

Usado para determinar se métricas de solicitação estão ativadas e como filtrar as solicitações com base no protocolo da Internet (IP) e nos filtros de Identificadores Uniformes de Recursos (URI) quando as métricas de solicitação são ativadas.

Veja o seguinte exemplo deste elemento:

<RequestMetrics armEnabled="false"  loggingEnabled="true"
			rmEnabled="false" traceLevel="PERF_DEBUG">
  • armEnabled

    Especifica se o agente ARM 4 está ativado no plug-in. Quando ele estiver configurado como true, o agente ARM 4 será chamado.

    Evitar Problemas Evitar Problemas: Para i servidor da Web SunOne (iPlanet), a seguinte diretiva deverá ser incluída no arquivo obj.conf para ativar o suporte ARM 4:
    AddLog fn="as_term" 
    Se essa diretiva não estiver incluída, o procedimento arm_stop nunca será chamado.gotcha

    Selecione zero ou um atributo para RequestMetrics

  • loggingEnabled

    Especifica se o log das métricas de solicitação está ativada no plug-in. Quando estiver configurado como true e traceLevel não estiver configurado como NONE, o tempo de resposta da solicitação e outras informações sobre ela serão registrados. Quando definido como false, não haverá nenhum registro de pedido. O valor de loggingEnabled depende do valor especificado para a propriedade de sistema, com.ibm.websphere.pmi.reqmetrics.loggingEnabled. Quando a propriedade do sistema não está presente, loggingEnable é definido como true. Especifique exatamente um atributo para RequestMetrics.

  • rmEnabled

    Especifica se as métricas de solicitação estão ativadas no plug-in. Quando estiver configurado como true, o plug-in, métricas de solicitação, inspecionará e registrará o registro de rastreio da solicitação no arquivo de log de plug-in. Essa ação é executada se um pedido transmitir os filtros. Quando esse atributo estiver configurado como false, o restante dos atributos das métricas de solicitação será ignorado. Especifique exatamente um atributo para RequestMetrics.

  • traceLevel

    Indica quanta informação está registrada quando o atributo rmEnabled está configurado como true. Quando esse atributo é definido como NONE, nenhum registro de pedido é executado. Quando esse atributo não estiver configurado como NONE, e loggingEnabled estiver configurado como true, o tempo de resposta da solicitação e outras informações sobre ela serão registrados após sua conclusão. Especifique exatamente um atributo para RequestMetrics.

  • filters

    Quando rmEnabled for true, os filtros controlam quais pedidos serão rastreados. Especifique zero, um ou dois atributos para RequestMetrics.

    • enable

      Quando enable for true, o tipo de filtro estará ativado e os pedidos deverão passar pelo filtro. Especifique exatamente um atributo para cada Filter.

    • type

      Há dois tipos de filtros: SOURCE_IP (por exemplo, endereço IP do cliente) e URI. Para o tipo de filtro SOURCE_IP, os pedidos são filtrados com base em um endereço IP conhecido. É possível especificar uma máscara para um endereço IP utilizando o asterisco (*). Se o asterisco for utilizado, o asterisco deve sempre ser o último caractere da máscara, por exemplo, 127.0.0.*, 127.0.*, 127*. Por motivos de desempenho, o padrão compara caractere por caractere, até que um asterisco seja localizado no filtro, uma diferença ocorra ou seja constatado que os filtros são uma correspondência exata.

      Para o tipo de filtro URI, os pedidos são filtrados com base no URI do pedido HTTP de entrada. As regras para correspondência de padrões são as mesmas que para a correspondência de filtros de endereço SOURCE_IP.

      Se a URI e os filtros do endereço IP do cliente estiverem ativados, as métricas de solicitação requererão uma correspondência para os dois tipos de filtro. Se nenhum estiver ativado, todos os pedidos serão considerados como uma correspondência.

      Existe exatamente um atributo para cada Filter.

    • filterValues

      Especifica as informações de filtro detalhadas. Especifique um ou vários atributos para cada filtro.

      • value

        Especifica o valor do filtro para o tipo de filtro correspondente. Esse valor pode ser um endereço IP ou um URI. Especifique exatamente um atributo para cada filterValue.


Ícone que indica o tipo de tópico Tópico de Referência



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwsv_plugincfg
Nome do arquivo: rwsv_plugincfg.html