![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
Configuración de servidor web
La configuración de plug-in conlleva configurar el servidor web para utilizar el módulo de plug-in binario que WebSphere Application Server proporciona. La configuración de plug-in incluye también actualizar el archivo de configuración XML de plug-in para reflejar la configuración de servidor de aplicaciones actual. El módulo binario utiliza el archivo XML para ayudar a direccionar las solicitudes de cliente web.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
Consulte las descripciones siguientes de cada archivo.
Archivo de configuración del servidor web
El archivo de configuración del servidor web se instala como parte del servidor web.
La Herramienta de configuración de plug-ins de servidor web
debe volver a configurar el archivo de configuración de un servidor web admitido.
Archivo de plug-in del servidor web binario
Por ejemplo, un módulo de plug-in binario es el archivo mod_was_ap22_http.dll de IBM HTTP Server en la plataforma Windows.
Otro ejemplo de un módulo de plug-in binario
es el programa de servicio QSVTAP20 en la plataforma IBM i.
El archivo de plug-in binario no cambia. Sin embargo, el archivo de configuración del plug-in binario es un archivo XML. El servidor de aplicaciones cambia el archivo de configuración cuando se producen determinados cambios en la configuración de WebSphere Application Server.
El módulo binario lee el archivo XML para ajustar los valores y direccionar las solicitudes al servidor de aplicaciones.
Archivo de configuración del plug-in, plugin-cfg.xml
El archivo de configuración del plug-in es un archivo XML con valores que puede ajustar en la consola administrativa. El archivo enumera todas las aplicaciones instaladas en la definición de servidor web. El módulo binario lee el archivo XML para ajustar los valores y para direccionar las solicitudes al servidor de aplicaciones.
El servidor de aplicaciones autónomo vuelve a generar el archivo plugin-cfg.xml
en el directorio raíz_perfil/config/cells/nombre_célula/nodes/nombre_servidor_web_node/servers/nombre_servidor_web.
La regeneración se produce cada vez que se produce un cambio
en la configuración de servidor de aplicaciones que afecta a las
aplicaciones desplegadas.
El gestor de despliegue vuelve a generar el archivo plugin-cfg.xml
en el directorio raíz_perfil/config/cells/nombre_célula/nodes/nombre_nodo/servers/nombre_servidor_web cada vez que se produce un cambio en
la configuración del servidor de aplicaciones que afecta a las aplicaciones desplegadas en el nodo gestionado.
Si realiza cambios en la configuración de servidor de aplicaciones
que afectan a las aplicaciones desplegadas, vuelva a generar el archivo XML de configuración de plug-in.
Después de la regeneración, propague (copie) el archivo a la máquina del servidor web. El plug-in binario tiene entonces acceso a la copia más actual de su archivo de configuración.
El servicio de configuración del plug-in de servidor web regenera el archivo
plugin-cfg.xml automáticamente después de determinados sucesos que cambian la configuración. El servicio de configuración propaga
automáticamente el archivo plugin-cfg.xml a una máquina de IBM
HTTP Server cuando se vuelve a generar el archivo. Debe copiar manualmente el
archivo en otros servidores web.
En los sistemas IBM i,
el plug-in no se genera automáticamente. Debe volver a generar y propagar el archivo manualmente.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Archivo de configuración del plug-in predeterminado, plugin-cfg.xml
La herramienta de configuración de plug-ins de servidor web crea el archivo plugin-cfg.xml en el directorio raíz_plugins/config/nombre_servidor_web. La herramienta crea el archivo para cada caso de instalación remota.
El archivo predeterminado es un marcador de posición que debe sustituir por el archivo plugin-cfg.xml de la definición de servidor web en el servidor de aplicaciones. El archivo predeterminado es una réplica del archivo que el servidor de aplicaciones crea para un servidor de aplicaciones autónomo predeterminado.
Ejecute el script configurenombre_servidor_web en el directorio raíz_servidor_aplicaciones/bin de la máquina del servidor de aplicaciones para una instalación remota o directamente desde el directorio raíz_plugins/bin para una instalación local. El script crea la definición de servidor web en los archivos de configuración del perfil predeterminado. Para configurar un perfil distinto del predeterminado, edite el script configurenombre_servidor_web. Utilice el parámetro -profileName para identificar un perfil distinto del predeterminado.
Después de que se crea la definición de servidor web, el servicio de configuración de plug-in de servidor web en el servidor de aplicaciones crea el primer archivo plugin-cfg.xml en la definición de servidor web en la máquina del servidor de aplicaciones. Si instala una aplicación, crea un host virtual o realiza cualquier cosa que cambie la configuración, debe propagar el archivo plugin-cfg.xml actualizado de la máquina del servidor de aplicaciones a la máquina del servidor web para sustituir el archivo predeterminado.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Script configurenombre_servidor_web para la definición de servidor web
La herramienta de configuración de plug-ins de servidor web crea el script configurenombre_servidor_web en el directorio raíz_plug-ins/bin/ de la máquina del servidor de aplicaciones web. Si una máquina de un caso remoto se ejecuta en un sistema operativo como AIX o Linux y la otra máquina se ejecuta en Windows, utilice el script creado en el directorio raíz_plug-ins/bin/crossPlatformScripts. El script solo se crea en los casos de instalación remota.
Copie el script de la máquina del servidor web en el directorio raíz_servidor_aplicaciones/bin en una máquina del servidor de aplicaciones remota. No tiene que copiar el script en una instalación local. Ejecute el script para crear una definición de servidor web en la configuración del servidor de aplicaciones.
El problema es un posible conflicto entre un variable de entorno de shell, la variable de entorno WAS_USER_SCRIPT y el perfil predeterminado real. El script siempre funciona respecto al perfil predeterminado. Si se establece la variable de entorno WAS_USER_SCRIPT, sin embargo, surge un conflicto porque el script intenta trabajar en el perfil identificado por la variable.
La variable es fácil de establecer accidentalmente. Emita cualquier mandato desde el directorio raíz_perfil/bin de cualquier perfil y se establecerá la variable para ese perfil.
Si tiene más de un perfil en el sistema, existe la posibilidad de que el perfil predeterminado y el perfil identificado por la variable sean distintos. Si es así, se produce un conflicto y es posible que el script no cree la definición de servidor web en el perfil correcto o puede que no cree la definición de servidor web en absoluto.
Si ya existe una definición de servidor web para un servidor de aplicaciones autónomo, al ejecutar el script no se añade una nueva definición de servidor web. Cada servidor de aplicaciones autónomo puede tener solo una definición de servidor web.
Un nodo gestionado, por otro lado, puede tener varias definiciones de servidor web. El script crea una nueva definición de servidor web a no ser que el nombre del servidor sea el mismo.
![[IBM i]](../images/iseries.gif)
Script de configuración para la definición de servidor web
Al configurar el servidor web con el script configureOs400WebserverDefinition o mediante la interfaz gráfica de usuario de administración de IBM i se crea el script configurenombre_servidor_web en el directorio raíz_plug-ins/bin/ de la máquina del servidor web. El script solo se crea en los casos de instalación remota.
Copie el script de la máquina del servidor web en el directorio raíz_servidor_aplicaciones/bin en la partición de IBM i. Ejecute el script para crear una definición de servidor web en la configuración del servidor de aplicaciones.
Si ya existe una definición de servidor web para un servidor de aplicaciones autónomo, al ejecutar el script no se añade una nueva definición de servidor web. Cada servidor de aplicaciones autónomo puede tener solo una definición de servidor web.
O bien, puede utilizar los script configureOs400WebServerDefinition y removeOs400WebServerDefinition para realizar estas tareas.
Un nodo gestionado, por otro lado, puede tener varias definiciones de servidor web. El script crea una nueva definición de servidor web a no ser que el nombre de servidor web sea el mismo.
Sustitución del archivo de configuración del plug-in por el archivo de la definición de servidor web (propagación)
El archivo predeterminado utiliza valores de parámetro fijos que es posible que no coincidan con los valores de parámetro del archivo real en el servidor de aplicaciones. El archivo predeterminado es solo un marcador de posición.
El archivo no puede reflejar los cambios que se produzcan en la configuración de servidor de aplicaciones. El archivo tampoco puede reflejar los valores no predeterminados que podrían estar en vigor en el servidor de aplicaciones.
El servidor de aplicaciones debe tener los
valores siguientes en el archivo plugin-cfg.xml real. Si es así, el archivo predeterminado puede configurar
satisfactoriamente el módulo de plug-in binario. A continuación, el módulo de plug-in puede comunicarse satisfactoriamente
con el servidor web y con el servidor de aplicaciones.
Supongamos que el servidor de aplicaciones no tiene los
valores siguientes en el archivo plugin-cfg.xml real. En ese caso,
el archivo predeterminado configura el módulo de plug-in binario incorrectamente.
El módulo de plug-in puede comunicarse siempre con el servidor web. Pero
con un archivo de configuración inadecuado, el módulo de plug-in no se puede comunicar
satisfactoriamente con el servidor de aplicaciones.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)