pluginConfiguration - Plug-in de servidor web (pluginConfiguration)

Propiedades utilizadas al generar el archivo de configuración de plug-in de servidor web

NameTypeDefaultDescription
pluginInstallRootstring/opt/IBM/WebSphere/PluginsUbicación de instalación del plug-in de servidor web en el sistema de archivos del host de servidor web
webserverNamestringwebserver1Nombre del servidor web en el que se utilizará esta configuración. Se utiliza para generar la ubicación del archivo de registro de plug-in si no se especifica explícitamente mediante nombre o directorio de archivo de registro.
webserverPortint
Min: -1

Max: 65535
80Puerto HTTP de servidor web
webserverSecurePortint
Min: -1

Max: 65535
443Puerto HTTPS de servidor web
sslKeyringLocationstring${pluginInstallRoot}/config/${webserverName}/plugin-key.kdbLa vía de acceso completa al archivo de conjunto de claves SSL en el host de servidor web
sslStashfileLocationstring${pluginInstallRoot}/config/${webserverName}/plugin-key.sthLa vía de acceso completa al archivo de ocultación SSL en el host de servidor web
sslCertlabelstringEspecifica la etiqueta del certificado dentro del conjunto de claves que el plug-in va a utilizar cuando el contenedor web solicita un certificado de cliente del plug-in.
ipv6PreferredbooleanfalseSe utiliza al resolver un nombre de host de servidor de aplicaciones {null} o {0}, para preferir el tipo de dirección, cuando sea posible
httpEndpointRefUna referencia a un elemento httpEndpoint de nivel superior (string).defaultHttpEndpointEspecifique el identificador de los puntos finales http para incluir en el archivo plugin-cfg.xml generado. El punto final define el servidor del clúster. El valor predeterminado es 'defaultHttpEndpoint'.
connectTimeoutUn período de tiempo con precisión de segundos5sIdentifica el periodo máximo de tiempo que el servidor de aplicaciones debe mantener una conexión con el servidor web. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m) o segundos (s). Por ejemplo, especifique 30 segundos como 30s. Puede incluir varios valores en una sola entrada. Por ejemplo, 1m30s es equivalente a 90 segundos.
serverIOTimeoutUn período de tiempo con precisión de segundos900sIdentifica el periodo máximo de tiempo que el plugin del servidor web espera para enviar una solicitud o para recibir una respuesta del servidor de aplicaciones. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m) o segundos (s). Por ejemplo, especifique 30 segundos como 30s. Puede incluir varios valores en una sola entrada. Por ejemplo, 1m30s es equivalente a 90 segundos.
wsServerIOTimeoutUn período de tiempo con precisión de segundosIdentifica la cantidad máxima de tiempo que espera el plugin del servidor web para enviar una solicitud o recibir una respuesta de websocket del servidor de aplicaciones. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m) o segundos (s). Por ejemplo, especifique 30 segundos como 30s. Puede incluir varios valores en una sola entrada. Por ejemplo, 1m30s es equivalente a 90 segundos.
wsServerIdleTimeoutUn período de tiempo con precisión de segundosIdentifica la cantidad máxima de tiempo que el plugin del servidor web espera para terminar una conexión desocupada de websocket. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m) o segundos (s). Por ejemplo, especifique 30 segundos como 30s. Puede incluir varios valores en una sola entrada. Por ejemplo, 1m30s es equivalente a 90 segundos.
extendedHandshakebooleanfalseSi el valor es true, el plugin del servidor web utilizar un reconocimiento de comunicación ampliado si el servidor de aplicaciones se está ejecutando.
waitForContinuebooleanfalseSi es false (el valor predeterminado), el plugin del servidor web, envía la cabecera "Expect: 100-continue" con las solicitudes HTTP que tienen un cuerpo de mensaje. Si se establece en true, el plugin del servidor web envía la cabecera "Expect: 100-continue" con cada solicitud HTTP. Considere definir este valor en true si tiene un cortafuegos entre el servidor web y el servidor de aplicaciones y son sensibles a los reintentos de solicitudes sin cuerpo de solicitud.
logFileNameVía de acceso a un archivoLa vía de acceso completa al archivo de registro de plug-in de servidor web. El componente de directorio debe existir. Para servidores web basados en Apache, una vía de acceso que empieza con un carácter de barra vertical se interpreta como un registrador sincronizado externamente. Si se especifica, la vía de acceso sustituye logDirLocation.
logDirLocationVía de acceso a un directorio${pluginInstallRoot}/logs/${webserverName}En desuso: Identifica el directorio donde se encuentra el archivo http_plugin.log. Vea el nombre de archivo de registro.
serverIOTimeoutRetryint
Min: -1

Max: 65535
-1Limita el número de reintentos de solicitud después de un tiempo de espera excedido de lectura o escritura. El valor predeterminado, {-1}, no aplica límites adicionales, por lo que los reintentos están limitados por el número de servidores disponibles en el clúster. El valor {0} indica que no deben haber reintentos. Este valor va dirigido al clúster de servidores y no se aplica a errores de conexión o tiempos de espera excedidos debido a un tiempo de espera excedido de conexión de plug-in HTTP o tiempos de espera excedidos de socket web.
loadBalanceWeightint20Este valor se modifica de forma dinámica durante el tiempo de ejecución. El peso de un servidor se reduce cada vez que se asigna una solicitud a dicho servidor. Cuando todos los pesos de todos los servidores bajan a 0 o un valor menor, el plugin del servidor web reajusta todos los pesos, de modo que todos sean mayores que 0.
serverRole
  • BACKUP
  • PRIMARY
PRIMARYEl rol de servidor identifica un servidor como primario o de reserva. Cuando están disponibles los servidores primarios, el plugin del servidor web los utiliza para el equilibrio de la carga y la migración tras error. Sin embargo, si ninguno de los servidores primarios no está disponible, el plugin del servidor web solo utiliza los servidores de reserva para el equilibrio de carga y la migración tras error.
BACKUP
Reserva
PRIMARY
Primario
ESIEnablebooleantrueLa propiedad ESIEnable habilita el proceso de Edge Side Include para almacenar en la memoria caché las respuestas. Esta propiedad proporciona la opción para inhabilitar ESI en el archivo de configuración del plug-in de servidor web.
ESIMaxCacheSizeint1024ESIMaxCacheSize es el tamaño máximo de la memoria caché con el valor predeterminado de 1MB. Esta propiedad proporciona la opción para alterar temporalmente el valor en el archivo de configuración de plug-in de servidor web.
ESIInvalidationMonitorbooleanfalseESIInvalidationMonitor especifica si el procesador ESI deberá recibir invalidaciones del servidor de aplicaciones. Esta propiedad proporciona la opción para alterar temporalmente el valor en el archivo de configuración de plug-in de servidor web.
ESIEnableToPassCookiesbooleanfalseESIEnableToPassCookies permite reenviar cookies de sesión a WebSphere Application Server. Esta propiedad proporciona la opción para alterar temporalmente el valor en el archivo de configuración de plug-in de servidor web.
trustedProxyEnablebooleanPermite utilizar proxies de confianza. Cuando se especifica, esta propiedad altera temporalmente el valor en el archivo de configuración de plug-in de servidor web.
trustedProxyGroupstringUna lista separada por comas de proxies de confianza. Cuando se especifica, esta propiedad altera temporalmente el valor en el archivo de configuración de plug-in de servidor web.

httpEndpoint

Especifique el identificador de los puntos finales http para incluir en el archivo plugin-cfg.xml generado. El punto final define el servidor del clúster. El valor predeterminado es 'defaultHttpEndpoint'.

NameTypeDefaultDescription
onError
  • IGNORE
  • WARN
  • FAIL
WARNAcción a realizar después de una anomalía para iniciar un punto final.
IGNORE
El servidor no emitirá mensajes de aviso y error cuando se produzca un error de configuración.
WARN
El servidor emitirá mensajes de aviso y error cuando se produzca un error de configuración.
FAIL
El servidor emitirá un mensaje de aviso o error con el primer error y después se detendrá el servidor.
enabledbooleantrueConmuta la disponibilidad de un punto final. Si tiene el valor true, el asignador activará este punto final para manejar las solicitudes HTTP.
hoststringlocalhostDirección IP, servidor de nombres de dominio (DNS), nombre de host con sufijo de nombre de dominio o sólo el nombre de host DNS utilizados por un cliente para solicitar un recurso. Utilice '*' para todas las interfaces de red disponibles.
httpPortint
Min: -1

Max: 65535
Puerto utilizado para las solicitudes HTTP de cliente. Utilice -1 para inhabilitar este puerto.
httpsPortint
Min: -1

Max: 65535
Puerto utilizado para las solicitudes HTTP de cliente con SSL (https). Utilice -1 para inhabilitar este puerto.
httpOptionsRefUna referencia a un elemento httpOptions de nivel superior (string).defaultHttpOptionsOpciones del protocolo HTTP para el punto final.
sslOptionsRefUna referencia a un elemento sslOptions de nivel superior (string).Opciones del protocolo SSL para el punto final.
tcpOptionsRefUna referencia a un elemento tcpOptions de nivel superior (string).defaultTCPOptionsOpciones del protocolo TCP para el punto final.
accessLoggingRefUna referencia a un elemento httpAccessLogging de nivel superior (string).Configuración de registro de acceso HTTP para el punto final.

httpEndpoint > httpOptions

Opciones del protocolo HTTP para el punto final.

NameTypeDefaultDescription
keepAliveEnabledbooleantrueHabilita las conexiones persistentes (estado activo HTTP). Si tienen el valor true, las conexiones se mantendrán activas para ser reutilizadas por varias solicitudes y respuestas secuenciales. Si tienen el valor false, las conexiones se cierran después de enviarse la respuesta.
maxKeepAliveRequestsint
Min: -1
100Número máximo de solicitudes persistentes que se permiten en una única conexión HTTP si están habilitadas las conexiones persistentes. El valor -1 indica ilimitado.
persistTimeoutUn período de tiempo con precisión de segundos30sCantidad de tiempo que un socket puede permanecer desocupado entre solicitudes. Este valor sólo se aplica si están habilitadas las conexiones persistentes. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m) o segundos (s). Por ejemplo, especifique 30 segundos como 30s. Puede incluir varios valores en una sola entrada. Por ejemplo, 1m30s es equivalente a 90 segundos.
readTimeoutUn período de tiempo con precisión de segundos60sCantidad de tiempo que se debe esperar en un socket hasta que se complete una solicitud de lectura después de la primera lectura. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m) o segundos (s). Por ejemplo, especifique 30 segundos como 30s. Puede incluir varios valores en una sola entrada. Por ejemplo, 1m30s es equivalente a 90 segundos.
writeTimeoutUn período de tiempo con precisión de segundos60sCantidad de tiempo que se debe esperar en un socket hasta que se transmita cada parte de los datos de respuesta. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m) o segundos (s). Por ejemplo, especifique 30 segundos como 30s. Puede incluir varios valores en una sola entrada. Por ejemplo, 1m30s es equivalente a 90 segundos.
removeServerHeaderbooleanfalseElimina la información de implementación del servidor de las cabeceras HTTP y también inhabilita la página de bienvenida por omisión del perfil de Liberty.
NoCacheCookiesControlbooleantruePermite al usuario controlar cuando se debe modificar la presencia de una cabecera Set-Cookie con un valor de no-cache coincidente. También se añade la cabecera Expires.
AutoDecompressionbooleantrueEspecifica si el canal HTTP descomprime automáticamente los datos del cuerpo de solicitud entrantes.

httpEndpoint > sslOptions

Opciones del protocolo SSL para el punto final.

NameTypeDefaultDescription
sessionTimeoutUn período de tiempo con precisión de segundos1dCantidad de tiempo que se debe esperar a que una solicitud de lectura o escritura se complete en un socket. Este valor se sustituye por tiempos de espera específicos de protocolo. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m) o segundos (s). Por ejemplo, especifique 30 segundos como 30s. Puede incluir varios valores en una sola entrada. Por ejemplo, 1m30s es equivalente a 90 segundos.
suppressHandshakeErrorsbooleanfalseInhabilita el registro de errores de reconocimiento de comunicación SSL. Los errores de reconocimiento de comunicación SSL se pueden producir durante el funcionamiento normal, pero estos mensajes pueden resultar de utilidad si SSL no se comporta de forma esperada.
sslRefUna referencia a un elemento ssl de nivel superior (string).El repertorio de configuración SSL por omisión. El valor por omisión es defaultSSLSettings.
sslSessionTimeoutUn período de tiempo con precisión de milisegundos8640msEl límite de tiempo de espera de una sesión SSL establecida por el canal SSL. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m), segundos (s) o milisegundos (ms). Por ejemplo, especifique 500 milisegundos como 500ms. Puede incluir varios valores en una sola entrada. Por ejemplo, 1s500ms es equivalente a 1,5 segundos.

httpEndpoint > tcpOptions

Opciones del protocolo TCP para el punto final.

NameTypeDefaultDescription
inactivityTimeoutUn período de tiempo con precisión de milisegundos60sCantidad de tiempo que se debe esperar a que una solicitud de lectura o escritura se complete en un socket. Este valor se sustituye por tiempos de espera específicos de protocolo. Especifica un entero positivo seguido de una unidad de tiempo, que puede ser horas (h), minutos (m), segundos (s) o milisegundos (ms). Por ejemplo, especifique 500 milisegundos como 500ms. Puede incluir varios valores en una sola entrada. Por ejemplo, 1s500ms es equivalente a 1,5 segundos.
soReuseAddrbooleantruePermite reenlazar de inmediato con un puerto sin un escucha activo.
addressIncludeListstringLista de direcciones separadas por comas que están autorizadas para realizar conexiones de entrada en este punto final. Puede especificar direcciones IPv4 o IPv6. Todos los valores de una dirección IPv4 o IPv6 deben estar representados por un número o por un carácter comodín de tipo asterisco.
addressExcludeListstringLista de direcciones separadas por comas que no están autorizadas para realizar conexiones de entrada en este punto final. Puede especificar direcciones IPv4 o IPv6. Todos los valores de una dirección IPv4 o IPv6 deben estar representados por un número o por un carácter comodín de tipo asterisco.
hostNameIncludeListstringLista de nombres de host separados por comas que están autorizados para realizar conexiones de entrada en este punto final. Los nombres de host no distinguen entre mayúsculas y minúsculas y pueden empezar por un asterisco, que se utiliza como carácter comodín. Pero, no puede haber asteriscos en ninguna otra posición en el nombre de host. Por ejemplo, *.abc.com es válido, pero *.abc.* no es válido.
hostNameExcludeListstringLista de nombres de host separados por comas que no están autorizados para realizar conexiones de entrada en este punto final. Los nombres de host no distinguen entre mayúsculas y minúsculas y pueden empezar por un asterisco, que se utiliza como carácter comodín. Pero, no puede haber asteriscos en ninguna otra posición en el nombre de host. Por ejemplo, *.abc.com es válido, pero *.abc.* no es válido.

httpEndpoint > accessLogging

Configuración de registro de acceso HTTP para el punto final.

NameTypeDefaultDescription
enabledbooleantrueHabilitar el registro de acceso.
filePathVía de acceso a un archivo${server.output.dir}/logs/http_access.logVía de acceso y nombre de directorio del archivo de registro de acceso. Las sustituciones de variables estándar, como ${server.output.dir}, se pueden utilizar al especificar la vía de acceso del directorio.
logFormatstring%h %u %{t}W "%r" %s %bEspecifica el formato de registro que se utiliza al registrar la información de acceso del cliente.
maxFileSizeint
Min: 0
20Tamaño máximo de un archivo de registro, en megabytes, antes de que se retrotraiga; un valor 0 significa que no hay ningún límite.
maxFilesint
Min: 0
2Número máximo que se mantendrá de archivos de registro, antes de que se elimine el archivo más antiguo; un valor 0 significa que no hay ningún límite.

extraConfigProperties

Propiedades adicionales que se van a añadir al elemento Config en el archivo de configuración del plug-in generado. Estas propiedades las puede especificar el soporte de IBM para modificar el comportamiento en el plug-in de servidor web.