Sugerencias para la resolución de problemas del plug-in del servidor Web

Los temas siguientes le pueden ayudar a diagnosticar problemas con los plug-ins del servidor web.

Si tiene algún problema cuando utiliza el plug-in del servidor web, lleve a cabo estos pasos:

Revise el archivo raíz_plugins/logs/nombre_servidor_web/http_plugin.log para obtener pistas. Consulte los mensajes de error o de aviso de la tabla de referencia de mensajes.
Revise las anotaciones cronológicas de acceso y de error del servidor web para ver si éste tiene algún problema:
- IBM® HTTP Server y Apache: access.log y error.log.
- Servidor Web de Domino: httpd-log y httpd-error.
- Sun Java™ System: access y error.
- IIS de Microsoft: timedatestamp.log.

Si estos archivos no revelan la causa del problema, siga estos pasos adicionales:

Pasos para la determinación de problemas del plug-in

El plug-in proporciona un rastreo de fácil lectura que le sirve de ayuda para averiguar la causa de un problema. Si establece el atributo LogLevel en el archivoconfig/plugin-cfg.xml en Trace, puede seguir el proceso de la solicitud para saber la causa del error.

Nota: si utiliza un sistema de archivos Veritas con el soporte de archivos grandes habilitado, se permiten tamaños de archivo de hasta dos terabytes. En este caso, si establece el atributo LogLevel en el archivo plugin-cfg.xml en LogLevel=Trace, el archivo http_plugin.log puede crecer rápidamente y consumir todo el espacio disponible del sistema de archivos. Por lo tanto, debe establecer el valor del atributo LogLevel en ERROR o DEBUG para impedir una utilización alta de CPU.

En un nivel superior, siga estos pasos.

El plug-in recibe una petición.
El plug-in comprueba las rutas definidas en el archivo plugin-cfg.xml.
Busca el grupo de servidores.
Busca el servidor.
Selecciona el protocolo de transporte, HTTP o HTTPS.
Envía la petición.
Lee la respuesta.
La devuelve al cliente.

Puede ver esto con claridad si lee el rastreo de una petición individual:

En primer lugar, determine si el plug-in se ha cargado en el servidor web correctamente.
- Compruebe que se haya creado el archivo http_plugin.log>.
- Si se ha creado, consúltelo para ver si algún mensaje de error indica algún tipo de anomalía que puede haberse producido durante la inicialización del plug-in. Si no encuentra errores busque en la stanza siguiente, que indica si el plug-in se ha iniciado correctamente. Asegúrese de que las indicaciones de la hora de los mensajes se corresponden con la hora en que ha iniciado el servidor web:
```
[Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: ------------System Information---------- 
[Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: Bld date: Jul  3 2002, 15:35:09 
[Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: Web server: IIS 
[Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: Hostname = SWEETTJ05 
[Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: OS version 4.0, build 1381, 'Service Pack 6' 
[Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: -------------------------------------------- 
```
- Algunos errores comunes son:
  lib_security: loadSecurityLibrary: Failed to load gsk library (No se ha podido cargar la biblioteca gsk)
  No se ha instalado IBM Global Security Kit (GSKit) o se ha instalado la versión incorrecta de GSKit. Para determinar qué situación se ha producido:
  - En una plataforma Windows, busque el archivo gsk8ssl.dll
  - En una plataforma UNIX, busque los archivos libgsk8*.so en el directorio /usr/lib .
  Si no puede encontrar el archivo adecuado, intente volver a instalar el plug-in con la versión correcta de IBM Global Security Kit (GSKit) para ver si esto soluciona el problema.
  ws_transport: transportInitializeSecurity: Keyring wasn't set (el conjunto de claves no se ha establecido)
  
  El transporte HTTPS definido en el archivo de configuración ha finalizado de forma prematura y no contenía las definiciones de propiedades para el conjunto de claves y el archivo stash. Compruebe la sintaxis XML para el número de línea que se proporciona en los mensajes de error que siguen a este para asegurarse de que el elemento de transporte contiene las definiciones del conjunto de claves y de los archivos stash antes de su finalización.
- Si no se ha creado el archivo http_plugin.log, compruebe las anotaciones cronológicas de error del servidor web para ver si se ha anotado cronológicamente algún mensaje de error relacionado con el plug-in que indique que el plug-in no se ha podido cargar. Generalmente, puede deberse a que se ha configurado incorrectamente el plug-in en el entorno del servidor web. Consulte la documentación para configurar el servidor web que está utilizando con el plug-in de servidor web.
Determine si hay problemas de conexión de red con el plug-in y los diferentes servidores de aplicaciones definidos en la configuración. Cuando éste sea el caso, generalmente verá el mensaje siguiente:
```
La conexión a nombre_host:número_puerto ha fallado (código de error):mensaje de error(número de puerto de puerto local)
```
Esto puede suceder por diferentes razones:
- Ejecute PING para las máquinas para asegurarse de que están conectadas correctamente a la red. Si no se puede ejecutar ping en las máquinas, no hay modo de que el plug-in se ponga en contacto con las mismas. Las razones posibles de este problema son:
  - Las políticas de cortafuegos que limitan el tráfico desde el plug-in al servidor de aplicaciones.
  - Las máquinas no están en la misma red.
- Si puede ejecutar PING para las máquinas entonces la causa más probable del problema es que el puerto no esté activo. Es posible que el puerto no esté activo debido a que el servidor de aplicaciones o el clúster no se ha iniciado o a que el servidor de aplicaciones ha concluido por algún motivo. Para confirmar que sea este el problema, puede intentar ejecutar manualmente telnet en el puerto en que falla la conexión. Si no puede ejecutar telnet en el puerto, significa que el servidor de aplicaciones no está activo y es necesario resolver este problema para que el plug-in pueda conectarse correctamente.
Determine si hay otra actividad en las máquinas en las que están instalados los servidores que impida que el servidor dé servicio a una petición. Compruebe el uso del procesador según la medición del Gestor de Tareas, el ID del procesador, o cualquier otra herramienta externa para ver si:
- No es como se esperaba.
- Es irregular en lugar de constante.
- Muestra que se ha añadido recientemente un miembro al clúster que no está utilizándose.
- Muestra que se ha arreglado un miembro que daba problemas pero no está utilizándose.
Consulte en la consola administrativa el estado del servidor.
Compruebe la consola administrativa para asegurarse de que el servidor de aplicaciones se ha iniciado. Consulte la consola administrativa para ver los mensajes de error o consulte los registros de JVM.
En la consola administrativa, seleccione el servidor de aplicaciones que da problemas y visualice sus aplicaciones instaladas para comprobar que se han iniciado.

Si ninguno de estos pasos soluciona el problema:

Para problemas específicos que pueden hacer que las páginas web y su contenido no se visualicen, consulteEl recurso web (archivo JSP, servlet, archivo html, imagen, etc.) no se mostrará en la documentación.
Compruebe si el problema se ha identificado y documentado utilizando los enlaces de Diagnóstico y arreglo de problemas: recursos de aprendizaje.
Si no ve un problema que se parezca al suyo, o si la información proporcionada no resuelve el problema, póngase en contacto con el soporte de IBM para obtener más ayuda.

Cambio en el comportamiento cuando el servidor web utiliza un transporte inseguro

Si tiene transportes seguros y no seguros definidos, y un transporte seguro no se puede obtener debido a un error del sistema, el plug-in de servidor web utiliza un transporte inseguro. Éste es el comportamiento predeterminado.

Este comportamiento se ha modificado en WebSphere Application Server Versión 8.5.5. Si se produce una anomalía del sistema cuando se intenta una conexión segura, y hay un transporte inseguro, el plug-in de servidor web no utiliza ese transporte. Se notifica al administrador la existencia del problema y puede solucionarlo utilizando conexiones seguras.

El administrador tiene 3 opciones disponibles para solucionar este problema:

Corregir el problema de SSL de modo que el transporte HTTPS esté disponible (es la opción recomendada).
Eliminar los transportes HTTPS si no se utiliza SSL y volver a generar el plug-in.
Establecer UseInsecure=true en el archivo plugin-cfg.xml para volver al comportamiento predeterminado anterior.

Si prefiere volver al comportamiento predeterminado anterior, puede habilitarlo estableciendo una propiedad personalizada en la consola administrativa. Seleccione Servidor web > <nombre_servidor_web> > Propiedades de plug-in > Propiedades personalizadasy, a continuación, establezca UseInsecure en true.

Para obtener la información actual disponible en el soporte de IBM sobre problemas conocidos y su resolución, consulte los temas siguientes en la página de soporte de IBM . Antes de abrir un PMR, revise estas páginas porque contienen documentos que pueden ahorrarle tiempo en la recopilación de información necesaria para resolver un problema.

También puede encontrar útiles los temas siguientes en la página de soporte de IBM :