En este tema se describe cómo implementar un plug-in de servidor web.
El producto funciona con un servidor Web para direccionar
las peticiones de contenido dinámico, como los servlets, desde
aplicaciones Web. Los servidores web son necesarios para dirigir el tráfico entre los navegadores y las aplicaciones que se ejecutan en un servidor de aplicaciones. El plug-in del servidor web utiliza el archivo de configuración XML para determinar si una solicitud es para un servidor de aplicaciones.
Antes de empezar
- Consulte la información sobre cómo elegir un frontal para la topología de WebSphere Application Server.
Este tema ayuda a determinar si se debe configurar un plug-in de servidor web, un servidor proxy o un servidor proxy seguro
para proporcionar afinidad de sesiones, soporte de sustitución por anomalía y equilibrado de carga para la topología de
WebSphere Application Server.
Instale el servidor web si todavía no está instalado.
Avoid trouble: El servidor web
que se proporciona con
IBM® i, ya está instalado en el producto 5761-DG1 para
IBM i V6R1 o 5770-DG1 para
IBM i V7R1.
El servidor web
IBM i se conoce como
IBM HTTP Server para
IBM i.
Este servidor web es distinto del IBM HTTP Server que se proporciona con
WebSphere Application Server, que no se ejecuta en
IBM i.
gotcha
Si desea utilizar el IBM HTTP Server que se proporciona con el producto, consulte la
información sobre la instalación de IBM HTTP Server. De lo contrario, consulte la información de
instalación que se proporciona con el servidor web.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Asegúrese de que el archivo de plug-in adecuado se ha instalado en el servidor web y el script configureweb_server_name se ha ejecutado para crear y configurar la definición del servidor web para este servidor web.
Si utiliza un servidor web de plataforma distribuida, utilice la herramienta de
configuración de plug-ins de servidor web para instalar el archivo de plug-in adecuado en
el servidor web. A continuación, ejecute el script
configurenombre_servidor_web creado por la
herramienta para crear y configurar la definición del servidor web en el repositorio de
configuración de WebSphere.
Si va a utilizar la aplicación IBM HTTP Server
para z/OS con tecnología Apache, que se proporciona
con el producto, consulte la información acerca de la instalación y la configuración del
plug-in de IBM HTTP Server para
WebSphere Application Server en z/OS.
Si va a utilizar IBM HTTP Server Versión 5.3, que se proporciona con el
sistema operativo base z/OS,
consulte la información acerca de la instalación y la configuración del plug-in de
servidor web de IBM HTTP Server para z/OS.
Si utiliza un servidor web de plataforma distribuida con una versión del
producto que se ejecuta en los sistemas operativos z/OS,
utilice una conexión FTP para enviar el plug-in al servidor web y utilice el asistente de instalación
de plug-in para instalar el archivo de plug-in adecuado en el servidor web.
Si está realizando una serie de cambios simultáneos, como la instalación de varias aplicaciones, puede que desee que el servicio de configuración esté inhabilitado hasta que haya realizado el último cambio. De forma predeterminada, el servicio de configuración de plug-in del servidor web está habilitado. Para inhabilitar este servicio, en la consola administrativa pulse y, a continuación, anule la selección de la opción .
Avoid trouble: Si la instalación
utiliza un cortafuegos, asegúrese de configurar el plug-in de servidor web de modo que
utilice un puerto que se haya abierto. Póngase en contacto con el administrador de
seguridad para obtener información sobre cómo obtener un puerto abierto.
gotcha
Acerca de esta tarea
Se instala el archivo de plug-in apropiado.
Además, se crea un perfil http (/QIBM/UserData/WebSphere/Plugins/V85/webserver/profiles/http).
El perfil http se puede utilizar para facilitar la creación de definiciones de servidor web. Consulte el tema sobre la selección de un diagrama y una guía de topología de servidor
web para obtener instrucciones sobre cómo configurar
IBM HTTP Server para
IBM i para que se comunique con un servidor de
aplicaciones.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
Durante el proceso de instalación del plug-in se llevan a cabo los siguientes pasos. Consulte
el mapa de instalación del plug-in para obtener información adicional.
Se crea un nodo. Un nodo no gestionado se crea cuando el servidor web está en un sistema distinto del servidor de aplicaciones. Un nodo no gestionado es un nodo en el que no se ejecuta un agente de
nodo. Con los nodos no gestionados, el producto puede representar servidores que no son servidores de aplicaciones dentro de su topología de configuración.
Esta representación permite
mantener la información de conexión entre estos servidores y los servidores de
aplicaciones. Para obtener más información, consulte el tema sobre la adición, gestión y eliminación de nodos.
- Se crea una definición de servidor web.
Para crear una definición de servidor web
también puede utilizar la consola administrativa o el script ConfigurewebServerDefinition.jacl.
- Se correlaciona una aplicación o unos módulos a un servidor web. Si una aplicación que desea utilizar con este servidor web ya está instalada, ésta se correlaciona automáticamente al servidor web.
Si la aplicación no está instalada, seleccione este servidor web durante el paso "Correlacionar módulos con servidores" del proceso de instalación de la aplicación.
- El repositorio maestro se actualiza y guarda.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Cuando se configura un
plug-in, se crea automáticamente el archivo de configuración para el plug-in. Puede cambiar o ajustar los valores predeterminados para las propiedades de este archivo de configuración. Si cambia alguno de los valores, debe volver a generar el archivo para que los cambios entren en vigor.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
La generación o regeneración del archivo de configuración puede tardar un poco en llevarse a cabo.
Cuando finaliza el proceso, todos los objetos de la célula administrativa
utilizarán los valores más recientes, a los que puede acceder el servidor web. Si el
servidor de aplicaciones está en la misma estación de trabajo física que el servidor web, la
regeneración tarda aproximadamente de 30 a 60 segundos en llevarse a cabo. La
regeneración tarda más si el servidor de aplicaciones y el servidor web se encuentran en
estaciones distintas.
El procedimiento siguiente describe los pasos para actualizar el archivo de configuración de
plug-in, incluida la configuración de SSL y el ajuste de servidor web.
Procedimiento
- Utilice el consola administrativa para cambiar los valores en el archivo de configuración del plug-in.
Al configurar el plug-in del servidor web, debe decidir si desea que la configuración se genere automáticamente en respuesta a un cambio en la configuración. Cuando el servicio de configuración del plug-in
del servidor web está habilitado y se da alguna de estas situaciones, el archivo de configuración de plug-in
se genera automáticamente:
- Cuando se crear o se guarda servidor web.
- Cuando se instala una aplicación.
- Cuando se desinstala una aplicación.
- Cuando se actualiza la definición de host virtual.
Avoid trouble: Cuando se genera el archivo de configuración del plug-in del servidor Web, dicho archivo no incluye
admin_host en la lista de hosts virtuales. En el tema Permitir que los servidores web accedan a la consola
administrativa se describe cómo añadirlo a la lista.
gotcha
Puede utilizar la consola administrativa, o bien emitir el mandato GenPluginCfg para regenerar el archivo plugin-cfg.xml.
Lleve a cabo los pasos siguientes para regenerar el archivo
plugin-cfg.xml utilizando la consola administrativa:
- Seleccione .
- Seleccione Generar automáticamente el archivo de configuración del plug-in o pulse uno o más temas siguientes para configurar manualmente el archivo plugin-cfg.xml:
Avoid trouble: No actualice manualmente el archivo
plugin-cfg.xml. Todas las actualizaciones manuales que se realicen
en un servidor web se alteran temporalmente cada vez que se vuelve a generar el
archivo
plugin-cfg.xml para dicho servidor web.
gotcha
- Pulse Aceptar.
Propague la configuración de plug-in. Para propagar la configuración del plug-in desde la consola administrativa, pulse nombre_servidor_web. Otro método para propagar la configuración del plug-in es ejecutar el mandato GenPluginCfg.
Para obtener más información, consulte la documentación del mandato GenPluginCfg.
No tendrá que propagar la configuración de plug-in, si el servidor web está en la misma máquina
que la versión autónoma asociada del producto. Si la propagación de la configuración de plug-in falla debido a una causa desconocida, debe copiar manualmente el archivo plugin-cfg.xml en la ubicación de la instalación del servidor web remoto.
Avoid trouble: Si utiliza la función
FTP para realizar la copia, y la recarga de la configuración falla, compruebe
los permisos de archivo en el archivo
plugin-cfg.xml y asegúrese de
que los usuarios QTMHHTTP, QNOTES y QEJBSVR tienen la autoridad RWX. Si los permisos no
son correctos, el servidor web no puede acceder a la nueva versión del archivo, lo que
provoca que falle la recarga de la configuración.
Para comprobar los permisos, ejecute el mandato IBM i siguiente:
wrklnk 'ubicación_carpeta_plug_in/plugin-cfg.xml'
A continuación, seleccione la opción 9 para ver los permisos que están asignados a los usuarios (QTMHHTTP, QNOTES y QEJBSVR).
gotcha
Si los permisos no son correctos, emita el mandato
IBM i siguiente para cambiar los permisos de archivo a los valores apropiados:
CHGAUT USER(QEJBSVR QTMHHTTP QNOTES) OBJ('ubicación_carpeta_plug_in/plugin-cfg.xml') DTAAUT(*RWX)
La ubicación_carpeta_plug_in es la ubicación que ha especificado al transferir el archivo plugin-cfg.xml.
- Es posible que tenga que detener el servidor de aplicaciones y después iniciarlo para
permitir que el servidor web localice el archivo plugin-cfg.xml.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Ajuste el servidor web. Consulte la página acerca del ajuste de servidores web para obtener más información.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Propague la configuración de plug-in. El archivo de configuración de plug-in, plugin-cfg.xml, se
propaga automáticamente al servidor web si está habilitado el servicio de configuración
de plug-in del servidor web y se da una de las siguientes situaciones: - El servidor web es un servidor web local, lo que significa que el servidor web se encuentra en la misma estación de trabajo que el servidor de aplicaciones.
- El servidor web es un servidor IBM HTTP Server Versión 7 remoto que tiene un servidor de administración IBM HTTP Server en ejecución.
Si ninguna de estas condiciones es verdadera, debe copiar manualmente el archivo plugin-cfg.xml en la ubicación de la instalación del servidor web remoto. Copie el archivo plugin-cfg.xml del directorio <raíz_servidor_aplicac>/profiles/<nombre_perfil>/config/cells/../../nodes/../servers/<nombre_servidor_web> en ubicación del host del servidor web, que es <raízinstalaciónplugin>/config/<nombre_servidor_web>/.
Importante: Si utiliza la función FTP para copiar el archivo y la recarga de la
configuración falla, compruebe los permisos de archivo en el archivo
plugin-cfg.xml
y asegúrese de que estén establecidos en
rw-r--r--. Si los permisos de archivos no
son correctos, el servidor web no puede acceder a la nueva versión del archivo, por
lo que falla la recarga de la configuración.
Si los permisos de archivos no son
correctos, emita el siguiente mandato para cambiar los permisos de archivos a los
valores correspondientes:
chmod 644 plugin-cfg.xml
La función FTP de AIX no conserva los atributos de archivo. Por lo tanto, si necesita copiar el archivo plugin-cfg.xml manualmente desde un sistema operativo
AIX, quizá prefiera utilizar la función RCP de
AIX en lugar de la función FTP para copiarlo.
La ubicación de instalación del servidor web remoto es la ubicación especificada al crear el nodo para este servidor web.
- Copie el archivo del almacén de claves en el directorio del almacén de claves del servidor web.
Avoid trouble: Este paso es necesario para que el servidor web funcione correctamente.
gotcha
Para obtener instrucciones detalladas sobre cómo copiar el archivo del almacén de claves, lea el tema sobre la configuración del plug-in de servidor web para Secure Sockets Layer.
Resultados
La configuración está completa. Para activar la configuración, detenga y reinicie el servidor web.
Si tiene problemas al reiniciar el servidor web, examine el archivo
http_plugin.log en el
que encontrará información sobre qué parte del archivo
plugin-cfg.xml contiene un error.
El archivo de registro cronológico indica el número de línea en el que se ha producido el
error, junto con otros detalles que podrán ayudarle a diagnosticar la razón por la que el
servidor web no se ha iniciado. A continuación, puede utilizar la consola administrativa para actualizar el archivo
plugin-cfg.xml.
Si las aplicaciones se instalan o
desinstalan con poca frecuencia, que es en general la situación en un entorno de
producción, o si puede admitir el impacto que produce sobre el rendimiento la generación
y distribución del archivo de configuración del plug-in cada vez que se produce alguna de
las acciones enumeradas anteriormente, considere habilitar el servicio de configuración.