Propiedades utilizadas al generar el archivo de configuración de plug-in de servidor web
Name | Type | Default | Description |
---|---|---|---|
pluginInstallRoot | string | /opt/IBM/WebSphere/Plugins | Ubicación de instalación del plug-in de servidor web en el sistema de archivos del host de servidor web |
webserverName | string | webserver1 | Nombre 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. |
webserverPort | int Min: -1 Max: 65535 | 80 | Puerto HTTP de servidor web |
webserverSecurePort | int Min: -1 Max: 65535 | 443 | Puerto HTTPS de servidor web |
sslKeyringLocation | string | ${pluginInstallRoot}/config/${webserverName}/plugin-key.kdb | La vía de acceso completa al archivo de conjunto de claves SSL en el host de servidor web |
sslStashfileLocation | string | ${pluginInstallRoot}/config/${webserverName}/plugin-key.sth | La vía de acceso completa al archivo de ocultación SSL en el host de servidor web |
sslCertlabel | string | Especifica 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. | |
ipv6Preferred | boolean | false | Se utiliza al resolver un nombre de host de servidor de aplicaciones {null} o {0}, para preferir el tipo de dirección, cuando sea posible |
httpEndpointRef | Una referencia a un elemento httpEndpoint de nivel superior (string). | defaultHttpEndpoint | 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'. |
connectTimeout | Un período de tiempo con precisión de segundos | 5s | Identifica 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. |
serverIOTimeout | Un período de tiempo con precisión de segundos | 900s | Identifica 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. |
wsServerIOTimeout | Un período de tiempo con precisión de segundos | Identifica 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. | |
wsServerIdleTimeout | Un período de tiempo con precisión de segundos | Identifica 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. | |
extendedHandshake | boolean | false | Si el valor es true, el plugin del servidor web utilizar un reconocimiento de comunicación ampliado si el servidor de aplicaciones se está ejecutando. |
waitForContinue | boolean | false | Si 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. |
logFileName | Vía de acceso a un archivo | La 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. | |
logDirLocation | Ví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. |
serverIOTimeoutRetry | int Min: -1 Max: 65535 | -1 | Limita 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. |
loadBalanceWeight | int | 20 | Este 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 |
| PRIMARY | El 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 |
ESIEnable | boolean | true | La 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. |
ESIMaxCacheSize | int | 1024 | ESIMaxCacheSize 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. |
ESIInvalidationMonitor | boolean | false | ESIInvalidationMonitor 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. |
ESIEnableToPassCookies | boolean | false | ESIEnableToPassCookies 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. |
trustedProxyEnable | boolean | Permite 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. | |
trustedProxyGroup | string | Una 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. |
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'.
Name | Type | Default | Description |
---|---|---|---|
onError |
| WARN | Acció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. |
enabled | boolean | true | Conmuta la disponibilidad de un punto final. Si tiene el valor true, el asignador activará este punto final para manejar las solicitudes HTTP. |
host | string | localhost | Direcció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. |
httpPort | int Min: -1 Max: 65535 | Puerto utilizado para las solicitudes HTTP de cliente. Utilice -1 para inhabilitar este puerto. | |
httpsPort | int Min: -1 Max: 65535 | Puerto utilizado para las solicitudes HTTP de cliente con SSL (https). Utilice -1 para inhabilitar este puerto. | |
httpOptionsRef | Una referencia a un elemento httpOptions de nivel superior (string). | defaultHttpOptions | Opciones del protocolo HTTP para el punto final. |
sslOptionsRef | Una referencia a un elemento sslOptions de nivel superior (string). | Opciones del protocolo SSL para el punto final. | |
tcpOptionsRef | Una referencia a un elemento tcpOptions de nivel superior (string). | defaultTCPOptions | Opciones del protocolo TCP para el punto final. |
accessLoggingRef | Una referencia a un elemento httpAccessLogging de nivel superior (string). | Configuración de registro de acceso HTTP para el punto final. |
Opciones del protocolo HTTP para el punto final.
Name | Type | Default | Description |
---|---|---|---|
keepAliveEnabled | boolean | true | Habilita 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. |
maxKeepAliveRequests | int Min: -1 | 100 | Nú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. |
persistTimeout | Un período de tiempo con precisión de segundos | 30s | Cantidad 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. |
readTimeout | Un período de tiempo con precisión de segundos | 60s | Cantidad 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. |
writeTimeout | Un período de tiempo con precisión de segundos | 60s | Cantidad 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. |
removeServerHeader | boolean | false | Elimina 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. |
NoCacheCookiesControl | boolean | true | Permite 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. |
AutoDecompression | boolean | true | Especifica si el canal HTTP descomprime automáticamente los datos del cuerpo de solicitud entrantes. |
Opciones del protocolo SSL para el punto final.
Name | Type | Default | Description |
---|---|---|---|
sessionTimeout | Un período de tiempo con precisión de segundos | 1d | Cantidad 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. |
suppressHandshakeErrors | boolean | false | Inhabilita 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. |
sslRef | Una 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. | |
sslSessionTimeout | Un período de tiempo con precisión de milisegundos | 8640ms | El 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. |
Opciones del protocolo TCP para el punto final.
Name | Type | Default | Description |
---|---|---|---|
inactivityTimeout | Un período de tiempo con precisión de milisegundos | 60s | Cantidad 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. |
soReuseAddr | boolean | true | Permite reenlazar de inmediato con un puerto sin un escucha activo. |
addressIncludeList | string | Lista 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. | |
addressExcludeList | string | Lista 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. | |
hostNameIncludeList | string | Lista 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. | |
hostNameExcludeList | string | Lista 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. |
Configuración de registro de acceso HTTP para el punto final.
Name | Type | Default | Description |
---|---|---|---|
enabled | boolean | true | Habilitar el registro de acceso. |
filePath | Vía de acceso a un archivo | ${server.output.dir}/logs/http_access.log | Ví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. |
logFormat | string | %h %u %{t}W "%r" %s %b | Especifica el formato de registro que se utiliza al registrar la información de acceso del cliente. |
maxFileSize | int Min: 0 | 20 | Tamañ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. |
maxFiles | int Min: 0 | 2 | Nú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. |
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.