pluginConfiguration - Plugin do servidor da web (pluginConfiguration)

Propriedades usadas ao gerar o arquivo de configuração de plug-in do servidor da web

NameTypeDefaultDescription
pluginInstallRootstring/opt/IBM/WebSphere/PluginsLocal de instalação do plug-in do servidor da web no sistema de arquivos do host do servidor da web
webserverNamestringwebserver1Nome do servidor da web em que esta configuração será usada. Usado para gerar a localização do arquivo de log do plug-in se esta não estiver especificada explicitamente pelo nome ou diretório do arquivo de log.
webserverPortint
Min: -1

Max: 65535
80Porta HTTP do Servidor da Web
webserverSecurePortint
Min: -1

Max: 65535
443Porta HTTPS do Servidor da Web
sslKeyringLocationstring${pluginInstallRoot}/config/${webserverName}/plugin-key.kdbO caminho completo para o arquivo de conjunto de chaves SSL no host do servidor da web
sslStashfileLocationstring${pluginInstallRoot}/config/${webserverName}/plugin-key.sthO caminho completo para o arquivo stash SSL no host do servidor da web
sslCertlabelstringEspecifica o rótulo do certificado dentro do conjunto de chaves que o plug-in deve usar quando o contêiner de web solicita um certificado de cliente a partir do plug-in.
ipv6PreferredbooleanofalseUsado ao resolver um nome do host do servidor de aplicativos de {null} ou {0}, para preferir o tipo de endereço quando possível
httpEndpointRefUma referência para o elemento de nível httpEndpoint (sequência).defaultHttpEndpointEspecifique o identificador do terminal http a ser incluído no arquivo plugin-cfg.xml gerado. O terminal define o servidor no cluster. O valor padrão é 'defaultHttpEndpoint'.
connectTimeoutUm período de tempo com precisão de segundo5sIdentifica a quantidade máxima de tempo que o servidor de aplicativos deve manter uma conexão com o servidor da web. Especifique um número inteiro positivo seguido por uma unidade de tempo, que pode ser horas (h), minutos (m) ou segundos (s). Por exemplo, especifique 30 segundos como 30s. É possível incluir diversos valores em uma única entrada. Por exemplo, 1m30s é equivalente a 90 segundos.
serverIOTimeoutUm período de tempo com precisão de segundo900sIdentifica a quantidade máxima de tempo que o plug-in do servidor da web aguarda para enviar uma solicitação ou receber uma resposta do servidor de aplicativos. Especifique um número inteiro positivo seguido por uma unidade de tempo, que pode ser horas (h), minutos (m) ou segundos (s). Por exemplo, especifique 30 segundos como 30s. É possível incluir diversos valores em uma única entrada. Por exemplo, 1m30s é equivalente a 90 segundos.
wsServerIOTimeoutUm período de tempo com precisão de segundoIdentifica o intervalo de tempo máximo que o plug-in do servidor da web aguarda para enviar uma solicitação ou receber resposta de um websocket do servidor de aplicativos. Especifique um número inteiro positivo seguido por uma unidade de tempo, que pode ser horas (h), minutos (m) ou segundos (s). Por exemplo, especifique 30 segundos como 30s. É possível incluir diversos valores em uma única entrada. Por exemplo, 1m30s é equivalente a 90 segundos.
wsServerIdleTimeoutUm período de tempo com precisão de segundoIdentifica o intervalo de tempo máximo que o plug-in do servidor da web aguarda para finalizar uma conexão de websocket inativa. Especifique um número inteiro positivo seguido por uma unidade de tempo, que pode ser horas (h), minutos (m) ou segundos (s). Por exemplo, especifique 30 segundos como 30s. É possível incluir diversos valores em uma única entrada. Por exemplo, 1m30s é equivalente a 90 segundos.
extendedHandshakebooleanofalseSe for true, o plugin do servidor da web usará um handshake estendido para determinar se o servidor de aplicativos está em execução.
waitForContinuebooleanofalseSe for false (o valor padrão), o plug-in do servidor da web enviará o cabeçalho "Expect: 100-continue" com solicitações de HTTP que têm um corpo da mensagem. Quando configurado como true, o plug-in do servidor da web enviará o cabeçalho "Expect: 100-continue" com cada solicitação de HTTP. Considere configurar este valor como true se você tiver um firewall entre o servidor da web e o servidor de aplicativos, e eles são sensíveis a novas tentativas de solicitações sem corpo da solicitação.
logFileNameCaminho para um arquivoUm caminho completo para o arquivo de log do plug-in de servidor da web. O componente de diretório já deve existir. Para servidores da web baseados no Apache, um caminho que começa com um caractere de barra vertical é interpretado como um criador de logs externo canalizado. Se especificado, o caminho sobrescreve o logDirLocation.
logDirLocationCaminho para um diretório${pluginInstallRoot}/logs/${webserverName}Descontinuado: identifica o diretório em que o arquivo http_plugin.log está localizado. Consulte o nome do arquivo de log.
serverIOTimeoutRetryint
Min: -1

Max: 65535
-1Limita o número de novas tentativas de solicitação após o tempo limite de uma leitura ou de uma gravação. O valor padrão, {-1}, aplica-se sem limites adicionais, de modo que as novas tentativas são limitadas pelo número de servidores disponíveis no cluster. Um valor {0} indica que não deve haver novas tentativas. Esse valor tem o escopo definido para o cluster de servidores e não se aplica às falhas ou tempos limite de conexão devido ao tempo limite de conexão do plug-in de HHTP ou aos tempos limite de soquete.
loadBalanceWeightint20Esse valor é mudado dinamicamente durante o tempo de execução. O peso de um servidor é reduzido cada vez que uma solicitação é designada a esse servidor. Quando todos os pesos para todos os servidores caem para 0 ou para um valor menor, o plug-in de servidor da web reajusta todos os pesos para que eles sejam maiores que 0.
serverRole
  • BACKUP
  • PRIMARY
PRIMARYA função do servidor identifica um servidor como primário ou de backup. Quando os servidores principais estão disponíveis, o plug-in de servidor da web os usa para balanceamento de carga e failover. No entanto, se nenhum dos servidores principais estão disponíveis, o plug-in de servidor da web usa somente os servidores de backup para balanceamento de carga e failover.
BACKUP
Backup
PRIMARY
Primário
ESIEnablebooleanotrueA propriedade ESIEnable ativa o processamento Edge Side Include para armazenar as respostas em cache. Essa propriedade fornece a opção para desativar o ESI no arquivo de configuração do plug-in do servidor da web.
ESIMaxCacheSizeint1024ESIMaxCacheSize é o tamanho máximo do cache que é definido por padrão como 1 MB. Essa propriedade fornece a opção de substituir o valor no arquivo de configuração do plug-in do servidor da web.
ESIInvalidationMonitorbooleanofalseESIInvalidationMonitor especifica se o processador ESI deve receber invalidações do servidor de aplicativos. Essa propriedade fornece a opção de substituir o valor no arquivo de configuração do plug-in do servidor da web.
ESIEnableToPassCookiesbooleanofalseESIEnableToPassCookies permite o encaminhamento de cookies de sessão para o WebSphere Application Server. Essa propriedade fornece a opção de substituir o valor no arquivo de configuração do plug-in do servidor da web.
trustedProxyEnablebooleanoAtiva os proxies confiáveis a serem usados. Quando especificada, essa propriedade substitui o valor no arquivo de configuração de plug-in de servidor da web.
trustedProxyGroupstringUma lista separada por vírgula de proxies confiáveis. Quando especificada, essa propriedade substitui o valor no arquivo de configuração de plug-in de servidor da web.

httpEndpoint

Especifique o identificador do terminal http a ser incluído no arquivo plugin-cfg.xml gerado. O terminal define o servidor no cluster. O valor padrão é 'defaultHttpEndpoint'.

NameTypeDefaultDescription
onError
  • IGNORE
  • WARN
  • FAIL
WARNAção a ser tomada após uma falha para iniciar um terminal.
IGNORE
O servidor não emitirá mensagens de aviso e de erro quando incorrer em um erro de configuração.
WARN
O servidor emitirá mensagens de aviso e de erro quando incorrer em um erro de configuração.
FAIL
O servidor emitirá uma mensagem de aviso ou de erro na primeira ocorrência de erro e, em seguida, irá parar o servidor.
enabledbooleanotrueAlternar a disponibilidade de um terminal. Quando true, este terminal será ativado pelo dispatcher para manipular solicitações de HTTP.
hoststringlocalhostEndereço IP, nome do host do servidor de nomes de domínio (DNS) com sufixo de nome de domínio ou apenas o nome do host DNS, usado por um cliente para solicitar um recurso. Use '*' para todas as interfaces de rede disponíveis.
httpPortint
Min: -1

Max: 65535
A porta usada para solicitações de HTTP do cliente. Use -1 para desativar esta porta.
httpsPortint
Min: -1

Max: 65535
A porta usada para solicitações de HTTP do cliente protegidas com SSL (https). Use -1 para desativar esta porta.
httpOptionsRefUma referência para o elemento de nível httpOptions (sequência).defaultHttpOptionsOpções do protocolo HTTP para o terminal.
sslOptionsRefUma referência para o elemento de nível sslOptions (sequência).Opções do protocolo SSL para o terminal.
tcpOptionsRefUma referência para o elemento de nível tcpOptions (sequência).defaultTCPOptionsOpções do protocolo TCP para o terminal.
accessLoggingRefUma referência para o elemento de nível httpAccessLogging (sequência).Configuração de criação de log de acesso para o terminal.

httpEndpoint > httpOptions

Opções do protocolo HTTP para o terminal.

NameTypeDefaultDescription
keepAliveEnabledbooleanotrueAtiva as conexões persistentes (keep-alive de HTTP). Se true, as conexões são mantidas ativas para reutilização por diversas solicitações e respostas sequenciais. Se false, as conexões são encerradas após a resposta ser enviada.
maxKeepAliveRequestsint
Min: -1
100Número máximo de solicitações persistentes que são permitidas em uma única conexão HTTP se conexões persistentes estão ativadas. Um valor igual a -1 significa ilimitado.
persistTimeoutUm período de tempo com precisão de segundo30sQuantidade de tempo que um soquete terá permissão para permanecer inativo entre solicitações. Esta configuração se aplica apenas se conexões persistentes são ativadas. Especifique um número inteiro positivo seguido por uma unidade de tempo, que pode ser horas (h), minutos (m) ou segundos (s). Por exemplo, especifique 30 segundos como 30s. É possível incluir diversos valores em uma única entrada. Por exemplo, 1m30s é equivalente a 90 segundos.
readTimeoutUm período de tempo com precisão de segundo60sQuantidade de tempo a esperar pela conclusão de uma solicitação de leitura em um soquete após a primeira leitura ocorrer. Especifique um número inteiro positivo seguido por uma unidade de tempo, que pode ser horas (h), minutos (m) ou segundos (s). Por exemplo, especifique 30 segundos como 30s. É possível incluir diversos valores em uma única entrada. Por exemplo, 1m30s é equivalente a 90 segundos.
writeTimeoutUm período de tempo com precisão de segundo60sQuantidade de tempo a esperar em um soquete para cada parte dos dados de resposta serem transmitidos. Especifique um número inteiro positivo seguido por uma unidade de tempo, que pode ser horas (h), minutos (m) ou segundos (s). Por exemplo, especifique 30 segundos como 30s. É possível incluir diversos valores em uma única entrada. Por exemplo, 1m30s é equivalente a 90 segundos.
removeServerHeaderbooleanofalseRemove informações de implementação do servidor de cabeçalhos de HTTP e também desativa a página de boas-vindas do perfil padrão do Liberty.
NoCacheCookiesControlbooleanotruePermite que o usuário controle se a presença de um cabeçalho Set-Cookie deve ou não atualizar o cabeçalho Cache-Control com um valor que não é de cache correspondente. Esse valor também inclui o cabeçalho Expires.
AutoDecompressionbooleanotrueEspecifica se o Canal HTTP automaticamente descompacta dados do corpo da solicitação de entrada.

httpEndpoint > sslOptions

Opções do protocolo SSL para o terminal.

NameTypeDefaultDescription
sessionTimeoutUm período de tempo com precisão de segundo1dQuantidade de tempo a aguardar pela conclusão de uma solicitação de leitura ou gravação em um soquete. Este valor é substituído pelos tempos limites específicos do protocolo. Especifique um número inteiro positivo seguido por uma unidade de tempo, que pode ser horas (h), minutos (m) ou segundos (s). Por exemplo, especifique 30 segundos como 30s. É possível incluir diversos valores em uma única entrada. Por exemplo, 1m30s é equivalente a 90 segundos.
suppressHandshakeErrorsbooleanofalseDesative a criação de log de erros de handshake SSL. Os erros de handshake SSL podem ocorrer durante operação normal; no entanto, essas mensagens podem ser úteis quando o SSL está se comportando inesperadamente.
sslRefUma referência para o elemento de nível ssl (sequência).O repertório de configuração de SSL padrão. O valor padrão é defaultSSLSettings.
sslSessionTimeoutUm período de tempo com precisão de milissegundo8640msO limite do tempo limite para uma sessão SSL que é estabelecida pelo canal SSL. Especifique um número inteiro positivo seguido por uma unidade de tempo, que pode ser horas (h), minutos (m), segundos (s) ou milissegundos (ms). Por exemplo, especifique 500 milissegundos como 500 ms. É possível incluir diversos valores em uma única entrada. Por exemplo, 1s500ms é equivalente a 1,5 segundos.

httpEndpoint > tcpOptions

Opções do protocolo TCP para o terminal.

NameTypeDefaultDescription
inactivityTimeoutUm período de tempo com precisão de milissegundo60sQuantidade de tempo a aguardar pela conclusão de uma solicitação de leitura ou gravação em um soquete. Este valor é substituído pelos tempos limites específicos do protocolo. Especifique um número inteiro positivo seguido por uma unidade de tempo, que pode ser horas (h), minutos (m), segundos (s) ou milissegundos (ms). Por exemplo, especifique 500 milissegundos como 500 ms. É possível incluir diversos valores em uma única entrada. Por exemplo, 1s500ms é equivalente a 1,5 segundos.
soReuseAddrbooleanotrueAtiva a religação imediata para uma porta sem listener ativo.
addressIncludeListstringUma lista separada por vírgula de endereços que têm permissão para fazer conexões de entrada nesse endpoint. É possível especificar endereços IPv4 ou IPv6. Todos os valores em um endereço IPv4 ou IPv6 devem ser representados por um número ou por um caractere curinga de asterisco.
addressExcludeListstringUma lista separada por vírgula de endereços que não têm permissão para fazer conexões de entrada nesse endpoint. É possível especificar endereços IPv4 ou IPv6. Todos os valores em um endereço IPv4 ou IPv6 devem ser representados por um número ou por um caractere curinga de asterisco.
hostNameIncludeListstringUma lista separada por vírgula de nomes de host que têm permissão para fazer conexões de entrada nesse endpoint. Os nomes do host não tem distinção entre maiúsculas e minúsculas e podem começar com um asterisco, que é usado como um caractere curinga. No entanto, os asteriscos não podem estar em outro lugar no nome do host. Por exemplo, *.abc.com é válido, mas *.abc.* não é válido.
hostNameExcludeListstringUma lista separada por vírgula de nomes de host que não têm permissão para fazer conexões de entrada nesse endpoint. Os nomes do host não tem distinção entre maiúsculas e minúsculas e podem começar com um asterisco, que é usado como um caractere curinga. No entanto, os asteriscos não podem estar em outro lugar no nome do host. Por exemplo, *.abc.com é válido, mas *.abc.* não é válido.

httpEndpoint > accessLogging

Configuração de criação de log de acesso para o terminal.

NameTypeDefaultDescription
enabledbooleanotrueAtivar log de acesso..
filePathCaminho para um arquivo${server.output.dir}/logs/http_access.logCaminho do diretório e nome do arquivo de log de acesso. As substituições de variável padrão, como ${server.output.dir}, podem ser usadas ao especificar o caminho do diretório.
logFormatstring%h %u %{t}W "%r" %s %bEspecifica o formato de log que é usado ao registrar informações de acesso de cliente no log.
maxFileSizeint
Min: 0
20Tamanho máximo de um arquivo de log, em megabytes, antes de ser substituído; um valor igual a 0 significa sem limite.
maxFilesint
Min: 0
2Número máximo de arquivos de log que serão mantidos, antes que o arquivo mais antigo seja removido; um valor igual a 0 significa sem limite.

extraConfigProperties

Propriedades adicionais a serem incluídas no elemento Config no arquivo de configuração de plug-in gerado. Essas propriedades podem ser especificadas pelo suporte IBM para modificar o comportamento do plug-in do servidor da web.