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 solicitudes de contenido dinámico, como servlets, desde aplicaciones web. Los servidores web son necesarios para dirigir el tráfico de los navegadores a 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 está dirigida a un servidor de aplicaciones.

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 de topología de servidor web y la hoja de ruta para obtener instrucciones sobre cómo configurar IBM HTTP Server para IBM i para comunicarse con un servidor de aplicaciones.

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

2. Se correlaciona una aplicación o unos módulos con un servidor web. Si una aplicación que desea utilizar con este servidor web ya está instalada, ésta se correlaciona automáticamente con el 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.
3. El repositorio maestro se actualiza y guarda.

Cuando se configura un plug-in, el archivo de configuración para el plug-in se crea automáticamente. Puede cambiar o ajustar los valores predeterminados para las propiedades en este archivo de configuración. Si cambia alguno de los valores, debe volver a generar el archivo para que los cambios entren en vigor.

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.

1. Utilice el consola de administración 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 crea o se guarda el servidor web
   • Cuando se instala una aplicación
   • Cuando se desinstala una aplicación
   • Cuando se actualiza la definición de host virtual

   Evitar problemas: Cuando se genera por primera vez el archivo de configuración del plug-in, no incluye admin_host en la lista de hosts virtuales. La información sobre cómo permitir que los servidores web accedan a la consola administrativa describe cómo añadirlo a la lista.

   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 de plug-in.
   2. Seleccione Generar automáticamente el archivo de configuración de plug-ino pulse uno o varios de los temas siguientes para configurar manualmente el archivo plugin-cfg.xml :
      Evite problemas: 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.
   3. Pulse Aceptar.
   4. Propagar la configuración del 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.

      Evitar problemas: Si utiliza la función FTP para realizar la copia y la recarga de la configuración falla, compruebe las autorizaciones de archivo en el archivo plugin-cfg.xml y asegúrese de que los usuarios QTMHHTTP, QNOTES y QEJBSVR tienen autorización 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 las autorizaciones, ejecute el siguiente mandato IBM i :

      wrklnk 'plug_in_folder_location/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).

      Si las autorizaciones son incorrectas, emita el siguiente mandato IBM i para cambiar las autorizaciones de archivo a los valores adecuados:

      CHGAUT USER(QEJBSVR QTMHHTTP QNOTES) OBJ('plug_in_folder_location/plugin-cfg.xml') DTAAUT(*RWX)

      El valor ubicación_carpeta_plug_in es la ubicación especificada al transferir el archivo plugin-cfg.xml.
   5. Es posible que tenga que detener el servidor de aplicaciones y, a continuación, iniciar el servidor de aplicaciones para que el servidor web localice el archivo plugin-cfg.xml .
2. Ajuste el servidor web.
   Consulte la página sobre cómo ajustar servidores web para obtener más información.
3. Propagar la configuración del 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 IBM HTTP Server Versión 7 remoto que tiene un servidor de administración de IBM HTTP Server en ejecución.

   Si ninguna de estas condiciones es verdadera, debe copiar manualmente el archivo plugin-cfg.xml a la ubicación de la instalación del servidor web remoto. Copie el archivo plugin-cfg.xml en <app_server_root>/profiles/<profilename>/config/cells/../../nodes/../servers/<webservername> en la ubicación de host del servidor web, que es <PluginInstallRoot>/config/<webservername>/.

   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 manualmente el plugin-cfg.xml de un sistema operativo AIX , es posible que desee utilizar la función RCP de AIX en lugar de la función FTP para copiar el archivo.

4. Copie el archivo del almacén de claves en el directorio del almacén de claves del servidor web.
   Evitar problemas: Este paso es necesario para que el servidor web funcione correctamente.

   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.