Propiedades del plug-in del servidor Web

Utilice esta página para ver o modificar los valores del archivo de configuración del plug-in del servidor web. El archivo de configuración de plug-in, plugin_cfg.xml, proporciona propiedades para establecer la comunicación entre el servidor web y el servidor de aplicaciones.

Para ver esta página de la consola administrativa, pulse Servidores > Tipos de servidor > Servidores web > nombre_servidor_web > Propiedades de plug-in.

En la pestaña Configuración, puede editar los campos. En la pestaña Tiempo de ejecución puede ver solamente la información de sólo lectura.

La pestaña Tiempo de ejecución sólo está disponible cuando este servidor web haya accedido a las aplicaciones en ejecución en los servidores de aplicaciones y haya un archivo http_plugin.log.

Nota: En este tema se hace referencia a uno o más de los archivos de registro del servidor de aplicaciones. Como alternativa recomendada, puede configurar el servidor para que utilice la función de registro HPEL (High Performance Extensible Logging) y la infraestructura de rastreo, en lugar de utilizar los archivos SystemOut.log, SystemErr.log, trace.log y activity.log en sistemas distribuidos y sistemas IBM® i. Puede también utilizar HPEL junto con sus recursos de registro nativos de z/OS. Si utiliza HPEL, puede acceder a toda la información de registro y de rastreo utilizando la herramienta de línea de mandatos LogViewer desde el directorio bin del perfil de servidor. Consulte la información sobre la utilización de HPEL para solucionar problemas de aplicaciones, para obtener más información sobre la utilización de HPEL.

Ignorar anomalías de DNS durante el arranque del servidor web

Especifica si durante el inicio el plug-in ignora los errores DNS de configuración.

Este campo corresponde al elemento IgnoreDNSFailures del archivo plugin-cfg.xml.

Cuando se establece el valor en true, el plug-in ignora los errores de DNS de una configuración y se inicia correctamente si como mínimo un servidor en cada ServerCluster puede resolver el nombre de host. Si no se puede resolver el nombre de host del servidor, se marca como no disponible para la existencia continuada de la configuración. Durante el direccionamiento de las solicitudes no se realizan más intentos de resolver el nombre de host. Si se produce un error de DNS, se graba un mensaje en el archivo de registro del plug-in y el proceso de inicialización del plug-in continúa.

De forma predeterminada, cuando el valor es false, los errores de DNS hacen que el plug-in no se inicialice y que las solicitudes fallen. Sin embargo, el servidor web se inicia.

Información	Valor
Tipo de datos	Serie
String	false

Intervalo de renovación de configuración

Especifica el intervalo de tiempo en segundos en el que el conector debe comprobar el archivo de configuración para ver si se han llevado a cabo actualizaciones o cambios. El plug-in comprueba el archivo para detectar cualquier modificación que se haya producido desde la última vez que se cargó la configuración.

En un entorno de desarrollo en el que se producen modificaciones frecuentemente, se recomienda un valor inferior a 60 segundos que es el valor predeterminado. En un entorno de producción, es preferible utilizar un valor más elevado que el valor predeterminado, puesto que no se realizarán actualizaciones con tanta frecuencia. Si por algún motivo no se puede volver a cargar el plug-in, se graba un mensaje en el archivo de registro y se utiliza la configuración anterior hasta que el archivo de configuración del plug-in se vuelva a cargar correctamente. Si no puede ver los cambios que se han realizado en la configuración del plug-in, hay que consultar el archivo de registro del plug-in para obtener las indicaciones del problema.

Información	Valor
Tipo de datos	Entero
String	60 segundos

Nombre del archivo de configuración del plug-in

Especifica el nombre de archivo del archivo de configuración del plug-in. El servidor de aplicaciones genera el archivo plugin-cfg.xml por omisión. El archivo de configuración identifica aplicaciones, servidores de aplicaciones, clústeres y puertos HTTP para el servidor web. El servidor web utiliza el archivo para acceder a las aplicaciones desplegadas en varios servidores de aplicaciones.

Evite problemas: Este campo está inhabilitado y no se puede cambiar, y el valor se muestra únicamente con fines informativos.gotcha

Si prefiere otra ubicación, debe volver a ejecutar la herramienta de configuración de plug-in (pct) para definir la ubicación nueva y ejecutar el script nuevo configureWebserver que se genera con el proceso de instalación en la máquina de WebSphere Application Server.

Si selecciona un plug-in del servidor web durante la instalación, el programa instalador configura el servidor web para que identifique la ubicación del archivo plugin-cfg.xml, si es posible. De forma predeterminada, el archivo de configuración de plug-ins se instalará en el directorio raíz_plugins/config/nombre_servidor_web.

El programa instalador añade una directiva a la configuración de servidor web que especifica la ubicación de un archivo plugin-cfg.xml.

En los servidores web remotos, debe copiar el archivo desde el directorio local donde está instalado el servidor de aplicaciones a la máquina remota. Esto se conoce como propagación del archivo de configuración del plug-in. Si utiliza IBM HTTP Server V6.1 o superior para el servidor web, WebSphere Application Server puede propagar automáticamente el archivo de configuración del plug-in a las máquinas remotas siempre que haya un mecanismo de transporte HTTP en funcionamiento para propagar el archivo.

Puede pulsar Ver para visualizar una copia del archivo de configuración del plug-in.

Información	Valor
Tipo de datos	Serie
String	plugin-cfg.xml

Generar automáticamente el archivo de configuración del plug-in

Para generar automáticamente un archivo de configuración del plug-in en un servidor web remoto:

Este campo debe estar seleccionado.
El servidor de configuración de plug-in debe estar habilitado.

Si el servicio de configuración del plug-in está habilitado, se genera automáticamente un archivo de configuración del plug-in para un servidor web siempre que:

El administrador de WebSphere Application Server define el nuevo servidor web.
Se despliega una aplicación en un servidor de aplicaciones.
Se desinstalará una aplicación.
Se actualiza y se guarda una definición de host virtual.

De forma predeterminada, este campo está seleccionado. Deseleccione el recuadro de selección si desea generar manualmente un archivo de configuración del plug-in para este servidor web.

Importante: Cuando se genera el archivo de configuración de plug-in del servidor Web, dicho archivo no incluye admin_host en la lista de hosts virtuales. El artículo del Information Center "Permitir que los servidores web accedan a la consola administrativa" describe cómo se añade admin_host a la lista de hosts virtuales.

Propagar automáticamente el archivo de configuración del plug-in

Especifica si desea o no que el servidor de aplicaciones propague automáticamente una copia de un archivo de configuración de plug-in modificado a un servidor web:

Este campo debe estar seleccionado.
El servidor de configuración de plug-in debe estar habilitado.
En entornos de Network Deployment, debe haber un agente de nodo de WebSphere Application Server en el nodo que aloja el servidor web asociado al archivo de configuración del plug-in modificado.

De forma predeterminada, este campo está seleccionado.

Nota: El archivo de configuración del plug-in sólo se puede propagar automáticamente a un servidor web remoto si dicho servidor web es un servidor web IBM HTTP Server V6.1 o superior y se está ejecutando su servidor de administración.

Puesto que el servicio de configuración de plug-in se ejecuta en segundo plano y no va ligado a la consola de administración, la consola de administración no puede mostrar los resultados de la propagación automática.

[AIX Solaris HP-UX Linux Windows] En el caso de plataformas distribuidas, puede comprobar los mensajes relacionados en el archivo SystemOut.log del gestor de despliegue para verificar que la propagación automática se ha realizado correctamente.

[z/OS] Para la plataforma z/OS, puede comprobar los mensajes relacionados en el registro TSO JOB para verificar que se haya completado correctamente la propagación automática.

Nombre del archivo de almacén de claves del plug-in

Especifica el nombre de archivo y la vía de acceso de directorio plenamente cualificada que contiene los anillos de claves de seguridad que utiliza el plug-in del servidor Web para solicitudes HTTPS. Este archivo reside en el servidor web que está asociado a este plug-in de servidor web. Después de especificar el nombre de archivo y la vía de acceso de directorio plenamente cualificada del archivo de base de datos, puede:

Pulse Gestionar claves y certificados para actualizar este archivo.
Pulse Copiar en directorio de almacén de claves de servidor web para añadir una copia de este archivo al directorio del almacén de claves para el servidor web.

Información	Valor
Tipo de datos	Serie
Default	ninguno

Nombre de archivo y directorio de la configuración del plug-in

Especifica la vía de acceso plenamente cualificada de la copia del servidor web del archivo de configuración del plug-in de servidor web. Esta vía de acceso es el nombre del archivo y su ubicación en la máquina en la que se ejecuta el servidor web.

Evite problemas: Este campo está inhabilitado y no se puede cambiar, y el valor se muestra únicamente con fines informativos.gotcha

Nombre de archivo y directorio del almacén de claves del plug-in

Especifica la vía de acceso plenamente cualificada de la copia del servidor web del archivo de base de datos que contiene sus anillos de claves de seguridad. Esta vía de acceso es el nombre del archivo y su ubicación en la máquina en la que se ejecuta el servidor web.

Evite problemas: Este campo está inhabilitado y no se puede cambiar, y el valor se muestra únicamente con fines informativos.gotcha

Registro cronológico del plug-in

Especifica la ubicación y el nombre del archivo http_plugin.log. También especifica el ámbito de los mensajes del archivo de registro.

En el archivo de registro se describe la ubicación y el nivel de los mensajes de registro que graba el plug-in. Si en el archivo de configuración no se ha especificado un archivo de registro, en algunos casos, los mensajes de anotación cronológica se graban en el archivo de registro cronológico de errores del servidor web.

En una plataforma distribuida, si el archivo de registro no existe, se creará. Si el archivo de registro ya existe se abrirá en modalidad de archivo adjunto y los mensajes del archivo de registro del plug-in anterior permanecerán.

Nombre del archivo de registro: Vía de acceso plenamente cualificada al archivo de registro en el que el plug-in grabará los mensajes de error.

Información	Valor
Tipo de datos	Serie
String	`raíz_plugins`/logs/`nombre_servidor_web`/http_plugin.log Especifica la vía de acceso de archivo del archivo http_plugin.log.

Nivel de anotación cronológica: el nivel de información detallada de los mensajes del archivo de registro que el conector debe grabar en el archivo de registro. Puede especificar uno de los valores siguientes para este atributo:

Trace. Todos los pasos del proceso de solicitud se anotan cronológicamente con detalle.
Stats. Se anota cronológicamente el servidor seleccionado para cada solicitud y otra información de balance de carga relativa a la gestión de solicitudes.
Warn. Se anotan cronológicamente todos los mensajes de error que se producen de procesos de solicitud anormales.
Error. Sólo se anotan cronológicamente los mensajes de error que se producen de procesos de solicitud anormales.
Debug. Todos los pasos críticos realizados en las solicitudes de proceso se anotan cronológicamente.
Detail. Toda la información acerca de las solicitudes y respuestas se anotan cronológicamente.

Si no se especifica un nivel de anotación cronológica, se utiliza el valor predeterminado Error.

Tenga cuidado al establecer el nivel a Rastreo. Hay muchos mensajes anotados cronológicamente en este nivel, de modo que el espacio de disco/sistema de archivos se puede llenar muy rápidamente. El valor Rastreo nunca debe utilizarse nunca un valor de Trace en entornos que funcionen con normalidad, ya que afecta desfavorablemente al rendimiento.

Importante: Si el servidor web y un plug-in de servidor web se ejecutan en un sistema AIX, HP-UX, Linux o Solaris y cambia el nivel de registro en el archivo plugin-cfg.xml, este cambio no se aplicará dinámicamente. Debe reiniciar el servidor web para que aplique el cambio. Por ejemplo en Solaris, si no reinicia el servidor web, aparecerá el siguiente mensaje de error en el archivo Raíz_Plugin/logs/http_plugin.log:

ERROR: ws_config_parser:handleLogEnd: Failed to open log file
'/opt/IBM/WebSphere/Plugin/logs/sunwebserver/http_plugin.log', OS

Información	Valor
Tipo de datos	Serie
String	Error

Nombre de archivo: uwsv_plugin_props.html