Implementación de un plug-in de servidor web

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 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

    [AIX Solaris HP-UX Linux Windows]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][z/OS]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.

    [AIX Solaris HP-UX Linux Windows]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.

    [z/OS]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.

    [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.

    [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 Servidores > Tipos de servidor > WebSphere Application Servers > nombre_servidor > Servicios de administración > Servicio de configuración de plug-in del servidor web y, a continuación, anule la selección de la opción Habilitar proceso automático de configuración del servidor web.

Avoid trouble 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

[IBM i]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][z/OS]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.
  1. [AIX Solaris HP-UX Linux Windows]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.

  2. 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.

  3. 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.
  4. El repositorio maestro se actualiza y guarda.

[AIX Solaris HP-UX Linux Windows][z/OS]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][z/OS]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

  1. 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 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:

    1. Seleccione Servidores > Tipos de servidor > Servidores Web > nombre_servidor_web > Propiedades del plug-in.
    2. 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 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
    3. Pulse Aceptar.
    4. [IBM i]Propague la configuración de plug-in. Para propagar la configuración del plug-in desde la consola administrativa, pulse Servidores > Tipos de servidor > Servidores webnombre_servidor_webPropagar plug-in.

      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 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.
    5. 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.
  2. [AIX Solaris HP-UX Linux Windows][IBM i]Ajuste el servidor web. Consulte la página acerca del ajuste de servidores web para obtener más información.
  3. [AIX Solaris HP-UX Linux Windows][z/OS]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

    [AIX]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.

  4. Copie el archivo del almacén de claves en el directorio del almacén de claves del servidor web.
    Avoid trouble 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.


Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twsv_plugin
File name: twsv_plugin.html